dsh-llm-wiki DSH 插件

本插件是薄适配层，通过 DSH 的 subprocess 服务调用 DSH-Wiki 引擎 CLI，暴露 7 个工具供 agent 使用。所有检索和编译逻辑由引擎负责，插件本身零运行时依赖（纯 ESM，无构建步骤）。需要 Node ≥ 18 和 Python ≥ 3.10。

developer-tools skills-workflows

如何安装 dsh-llm-wiki DSH 插件

dsh plugin --profile web add @detpecca/dsh-llm-wiki

复制不会执行命令。安装 dsh-llm-wiki DSH 插件前请核对仓库和版本。

dsh-llm-wiki DSH 插件数据来源

dsh-llm-wiki DSH 插件快照日期：2026年8月16日

discovered

dsh-llm-wiki DSH 插件能做什么

wiki_search：结构化信号检索，支持 CJK 分词，返回加权命中（页名、别名、标签、摘要、正文）。
wiki_read：按 wiki 路径批量读页，支持跟随 [[wikilink]]，返回页面内容或缺失/错误提示。
wiki_stats：获取页面/分类/digest/错误本条目统计。
wiki_validate：运行 4 类确定性结构校验（悬空链接、不完整页面、畸形来源引用、索引不一致）。
wiki_fix：确定性修复（重建索引、补双向回链）无需 LLM；启用 finalize 后追加 LLM 修复轮与错误本验证。
wiki_errorbook：只读查看错误本，包含 id、状态、类型、页面、发生次数等。
wiki_ingest：将源文本通过算法 1 全流程编译入库（需要 LLM key）。

dsh-llm-wiki DSH 插件适合哪些场景

让 agent 把一篇新笔记收录进知识库，然后自动校验结构是否健康。
询问 agent 知识库中关于某个主题的信息，并获取相关页面的内容。
让 agent 检查知识库结构问题并自动修复，最后再验证一次。
查看错误本中最近记录的错误，了解哪些问题反复出现。

dsh-llm-wiki DSH 插件适合谁

使用 DeepSeek Harness 并希望 agent 能直接管理 LLM-Wiki 个人知识库的用户。
使用 LLM-Wiki 进行结构化知识检索，需要 agent 驱动维护的开发者和研究人员。

dsh-llm-wiki DSH 插件的限制

需要 Python ≥ 3.10 并单独安装 DSH-Wiki 引擎（pip install git+https://github.com/detpecca/DSH-Wiki.git）。
wiki_ingest 和 wiki_fix finalize 需要 OpenAI 兼容 API key（通过配置或环境变量设置）。
插件是薄适配层，核心逻辑完全依赖 DSH-Wiki 引擎 CLI，无离线回退。
子进程输出有上限（stdout 2MB、stderr 200KB），大规模操作可能被截断。

dsh-llm-wiki DSH 插件的仓库 README 摘录

以下文字摘自 dsh-llm-wiki DSH 插件的上游仓库 detpecca/dsh-llm-wiki 的 README，版权归原作者，仅作引用。

DeepSeek Harness 插件：让 agent 直接管理 **LLM-Wiki** 个人知识库——检索、阅读、统计、校验、修复、错误本、入库，共 7 个工具。 `@detpecca/dsh-llm-wiki` 是一个**薄适配层**，不重复实现任何检索/编译逻辑： ``` DSH agent ──调用工具──▶ 本插件（ToolDefinition × 7） │ ctx.subprocess.spawn ▼ python -m llm_wiki --wiki <路径> <子命令> --json │ ▼ DSH-Wiki 引擎（检索打分 / 算法 1 编译 / 校验修复的唯一权威） │ ▼ 你的 Wiki 目录 ``` - 每个工具通过 DSH 的 `subprocess` 服务调用 [DSH-Wiki](https://github.com/detpecca/DSH-Wiki) 引擎 CLI 的 `--json` 通道； - Wiki 自己的**结构化信号检索**（页名/别名/标签/摘要加权打分）和**论文算法 1 编译流程**保持唯一权威； - 插件本体**零运行时依赖**（纯 ESM，无构建步骤），Node ≥ 18。 ## 前置要求 1. 已安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh` 命令可用，或有其仓库 checkout）； 2. Python ≥ 3.10（供引擎使用）； 3. （可选）一个 OpenAI 兼容的 LLM API key——只有 `wiki_ingest` 和 `wiki_fix {finalize:true}` 需要。 ## 🚀 快速开始 **两条命令，不需要克隆任何仓库。** ### 1. 安装 Python 引擎（DSH-Wiki） ```bash pip install git+https://github.com/detpecca/DSH-Wiki.git # 唯一运行时依赖是 pyyaml ``` ### 2. 安装本插件 ```bash dsh plugin --profile web add @detpecca/dsh-llm-wiki ``` > 还没发布 npm 时

阅读完整 README仓库许可: MIT

dsh-llm-wiki DSH 插件常见问题

如何安装 dsh-llm-wiki 插件？

先安装 Python 引擎：pip install git+https://github.com/detpecca/DSH-Wiki.git。然后安装插件：dsh plugin --profile web add @detpecca/dsh-llm-wiki。如果尚未发布到 npm，请使用：dsh plugin --profile web add github:detpecca/dsh-llm-wiki。安装后在 cordis.patch.yml 中配置知识库路径。

所有工具都需要 API key 吗？

不需要，只有 wiki_ingest 和 wiki_fix 的 finalize:true 模式需要 OpenAI 兼容的 API key。检索、阅读、统计、校验、错误本和基础修复都不需要 key。可以通过 cordis.patch.yml 或环境变量（LLM_WIKI_API_KEY 等）配置 key。

遇到 'No module named llm_wiki' 错误怎么办？

这表示 DSH-Wiki 引擎没有安装在 pythonPath 指定的 Python 解释器中。请确保在正确的 Python 环境中执行了 pip install git+https://github.com/detpecca/DSH-Wiki.git。错误信息中也会包含相关提示。

如何让插件指向我已有的 wiki 目录？

编辑 DSH 配置目录（通常是 ~/.dsh/profiles/<名称>/cordis.patch.yml）中的 cordis.patch.yml 文件。添加一个 id 为 llm-wiki 的条目，将 wikiPath 设置为 wiki 根目录的绝对路径（包含 index.md 的目录）。修改后重启 DSH 生效。

可以用插件修复 wiki 的结构问题吗？

可以。先调用 wiki_validate 检测问题，然后调用 wiki_fix 进行确定性修复（重建索引、补双向链接）。如果问题仍然存在，可以启用 finalize:true 进行更深入的 LLM 辅助修复（需要 API key）。修复后再运行 wiki_validate 确认。