local-rag-wiki

面向 AI 代理的仓库本地 RAG wiki：一个按仓库的 MCP 知识服务（对 Markdown wiki 笔记进行受控的搜索/读取/写入），外加一个将其接入你的代理工具的安装程序。运行该服务需要 Docker。

快速开始（推荐）

在首次代理会话前预拉取服务镜像，以避免冷启动延迟：

docker pull ihorleleka/project-rag-wiki:latest

Related MCP server: hw_rag_mcp

安装

在你的仓库根目录运行：

npx github:ihorleleka/Local-Rag-Wiki install .

这会搭建受管的 .agents/ 运行器、AGENTS.md 策略部分、用于 DeepSeek Harness（.dsh/mcp.servers.yml）、Claude Code、Codex、VS Code 和 OpenCode 的 MCP 配置，以及一个 wiki/ 文件夹。这些集成是附加的：安装 DSH 支持不会移除或替换其他 harness 配置。然后，当你的代理客户端连接时，MCP 服务会按仓库自动启动。建议在全新环境中运行代理之前预拉取镜像（见上文）。

DeepSeek Harness

将原生 DSH 捆绑包安装到你使用的配置文件中（通常是 web）：

dsh plugin --profile web add github:ihorleleka/Local-Rag-Wiki

重启该 DSH 配置文件，将已安装的仓库作为其工作区打开，并启动一个会话。在 agent/created 时，该捆绑包使用代理的实际工作区（包括自定义的 --agents-dir）来挂载 DSH 官方的 @deepseek-ai/dsh-mcp-client，启动受管的 MCP 运行器，重新连接它，发现其工具，并注册可预测的 mcp__wiki-manager__* 工具。即使命名空间是稳定的，客户端仍保持代理作用域。运行器会像对其他 harness 一样，启动或附加到该仓库的 Docker 服务。

它还为该工作区挂载了一个标记门控的 Cordis 召回协调器：agent/session-start 播种重复主题提示；agent/pre-step 使用本地状态，然后仅对实质性提示执行有界 wiki 检索——首先 wiki_search depth="abstract"（L0），然后匹配 depth="packet" 上下文（L1）。它标记证据，并将完整的 L2 wiki_read 决策留给模型。session/event 记录助手摘要，而 agent/turn-stopping 和 session/flush 修剪并持久化状态。召回按工作区缓存并进行在途去重；L1 数据包受到速率限制，冷启动有 90 秒的有界配额，状态更新排队并进行原子替换。在带有 wiki-kit 安装标记的仓库之外，不使用任何状态或 wiki 进程。

生成的 .dsh/mcp.servers.yml 仍然是工作区配置的替代方案；建议使用配置文件捆绑包，而不是同时运行两个桥接，因为那会创建到同一仓库服务的两个 MCP 连接。AGENTS.md 仍然是可移植的策略层。

.agents/hooks/ 和 .claude/settings.local.json 钩子是 Claude Code 特有的。DSH 生命周期拦截应属于受信任的 Host/Profile Cordis 插件，而不是项目本地的钩子清单。有关工作区配置边界，请参阅 .dsh/README.md。

更新

安装后，从仓库内部刷新受管文件——无需 npx：

.agents\update-wiki-kit.cmd --force

sh .agents/update-wiki-kit.sh --force

生命周期

npx github:ihorleleka/Local-Rag-Wiki status .
npx github:ihorleleka/Local-Rag-Wiki restart .
npx github:ihorleleka/Local-Rag-Wiki doctor . --live

start .、stop . 和 pull . 以相同方式可用。仓库容器独立于各个代理客户端而持久存在。

工作原理

• 此包是安装程序：它在消费仓库中搭建并维护 .agents/ 运行器和 MCP 配置。

• kb-service/ 是运行器按仓库启动的 Docker 化 MCP 知识服务。它通过 POST /mcp/（默认回环）提供 wiki_search、wiki_read、wiki_list、wiki_tree、wiki_schema_report、wiki_write、wiki_capture、wiki_delete 和 wiki_rename，并具有哈希保护的写入。wiki_search 支持分层检索（depth=abstract|packet）以及 path_prefix 目录范围。

版本控制

安装程序和 kb-service 使用相同的 Git 标签（X.Y.Z 或 vX.Y.Z）。发布自动化：

• tag-version-verify.yml

• docker-release.yml

许可证

MIT（参见 kb-service/LICENSE）。