ihorleleka/Local-Rag-Wiki

local-rag-wiki

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

快速开始（推荐）

在首次智能体会话之前预先拉取服务镜像，以避免冷启动
延迟：

docker pull ihorleleka/project-rag-wiki:latest

安装

在你的仓库根目录下运行：

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

这会搭建受管控的 .agents/ 运行器、AGENTS.md 策略部分、
DSH 工作区资产（.dsh/mcp.servers.yml 及其作用域内的 MCP 桥接）、Claude
Code、Codex、VS Code 和 OpenCode，外加一个 wiki/ 文件夹。DSH 桥接保留在
.dsh/ 下；它绝不会作为仓库根目录下的
.dsh-mcp-client.js 安装。这些集成是增量式的。当配置好的智能体客户端连接时，
MCP 服务会按仓库启动。在全新环境中运行智能体之前，建议预先拉取镜像
（见上文）。

DeepSeek Harness

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

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

重启该 DSH 配置文件，将一个已安装的仓库作为其工作区打开，并
启动一个会话。在 DSH 原生的 agent/created / agent/session-start
生命周期中，该包会读取活动工作区的 .dsh/mcp.servers.yml，
根据受管控的安装标记验证其 wiki-manager 条目，通过 DSH 的子进程服务解析
配置的 node 可执行文件，并通过 agent.ctx 挂载
桥接。它绝不使用 process.execPath，因为在 DSH Desktop 中那是
Electron 可执行文件。初始发现会在
模型请求组装之前完成，从而在该智能体的工具作用域上暴露稳定的原生
mcp__wiki-manager__* 工具。相同的命名空间
可以在不同的智能体作用域中共存，而不会在会话之间泄漏工具。

作用域内的桥接源码以 .dsh/.dsh-mcp-client.js 形式交付（绝不在
仓库根目录下），并遵循 DSH 的 MCP 传输、重连、工具 schema 和
执行流水线。规范配置路径是 .dsh/mcp.servers.yml；仅当规范文件不存在时，
才接受旧版的 dsh/mcp.servers.yml。
DSH 核心不会自动加载此文件——受信任的配置文件包才是它的加载器。
不要为同一服务器添加第二个全局 MCP 客户端。

该包还会针对实质性的、直接的用户提示，每轮执行一次有界的 wiki 召回。工具结果、插件上下文、委托的控制消息
以及后续的工具循环步骤不会触发召回。在作用域内的桥接
就绪后，agent/pre-step 会通过 DSH 现有的工具
注册表派发 wiki_search——先是 depth="abstract"（L0），然后是匹配的 depth="packet" 上下文
（L1）。它不会启动第二个运行器。召回按工作区缓存，并对进行中的请求去重，L1 数据包受速率限制，而完整的 L2 wiki_read
仍由模型主导。注入式召回是按轮次限定作用域的；当该轮次停止时，
其载荷会被一个小的过期标记替换，因此它无法累积或
在后续轮次中静默地起支配作用。

受治理的 wiki 及其 MCP 搜索是唯一的 DSH 记忆路径；该 bundle
不会捕获本地提示历史。Claude Code 通过其 MCP 配置连接到同一个 runner，
而不使用仓库提示历史钩子。有关工作区边界，请参见
.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 . 也以相同方式可用。该仓库
容器独立于各个 agent 客户端而持久存在。

工作原理

- 此包是安装器：它在消费方仓库中搭建并维护 .agents/
runner 和 MCP 配置。
- kb-service/ 是 runner 按仓库启动的 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）。