dsh-knowledge

dsh-knowledge 是面向 DeepSeek Harness 的知识库插件。它不修改 DSH Agent Loop，同一个插件既能使用本地 SQLite，也能连接远程中央知识库。

当前版本提供可部署的多知识库、按需检索工具、本地与远程中央服务、文档型 Web 管理台，以及全局回写策略与安全直写协调：

• 回答完成后同步调用 DSH 当前模型判断是否产生知识，并在回答下方显示逐库回写结果。
• 知识标题、正文、自然语言标签和提取理由默认跟随本轮用户语言；代码、命令和技术标识保持原样。
• 回写结果只作为 UI 状态展示，在下一次模型请求前会被移除，不占用会话上下文。
• 全局“严谨 / 主动”回写策略保存在权威知识库服务中；远程客户端自动跟随中央设置。严谨模式不限制候选数量，而是以长期价值和较高置信度为门槛，接受用户明确陈述以及带具体来源的可靠调研结论。
• 可创建多个知识库，分别设定说明、默认标签和提取要求。
• 每个知识库可选择专用回写模型；未设定时跟随当前会话模型。
• 项目和会话挂载；会话默认继承项目，也可独立覆盖或关闭。
• 每个挂载支持仅召回、审核写入、直接写入，以及包含/排除标签和额外提取要求。
• create / update / conflict / skip 文档变更决策；同一主题的多项发现先合并为一篇 Markdown 文档，直写模式自动写入普通结果，冲突仍进入人工审核。
• 直接写入由服务端原子协调：兼容的同主题内容合并并保留版本，完全重复直接跳过，疑似矛盾保护原条目并转入审核。
• 未挂载知识库时，不召回、不提取、不回写。
• 全局与项目范围，以及偏好、事实、决策、流程、经验五类知识。
• SQLite WAL、FTS5 全文搜索、原子事务、完整版本历史和幂等提取任务。
• 回答前通过 DSH 官方提示组装接口提供有界的挂载库地图，并自动召回最多 3 条达到相关性门槛的摘要；不自动注入完整文档。模型可继续按“knowledge_base_search 找库 → knowledge_search 搜索指定库 → knowledge_read 读取文档”的顺序核对完整内容。
• 可写挂载同时向模型声明 knowledge_write：更新已有知识必须使用搜索得到的签名 handle，新建知识必须指定当前可写挂载；工具内部完成本地/远程路由，并沿用审核、直写、去重、合并和冲突保护。
• 用户明确要求时，模型可调用 knowledge_base_create 和 knowledge_base_update 创建或修改知识库；工具内部跟随当前 Provider 自动写入本地 SQLite 或远程中央服务，模型不传也不猜存储位置。
• 创建或修改工具不会自动挂载知识库，也不会回退、双写或同步到另一端；结果会明确返回实际写入的 local 或 remote。
• 搜索和读取由服务端按当前会话挂载、项目范围及包含/排除标签强制限权，读取句柄带签名且仅限当前会话。
• 本地与远程 Provider 使用同一接口；远程模式不做隐式双向同步。
• DSH“设置 → 插件”提供“知识库连接”卡片，可选择本地来源或填写中央服务地址和只写客户端令牌，保存后实时验证并切换 Provider。
• Bearer Token 仅保存 SHA-256 摘要，支持 read / propose / write / admin 权限及吊销。
• 认证 HTTP API，可作为其他 DSH 客户端和未来桌面端的中央知识库。
• 笔记软件式双栏文档界面：左侧以“知识库 → 文档”树形目录浏览和新建，右侧支持 Markdown 编辑与安全预览；已有文档默认预览，新建文档默认编辑。
• 每个生效主题对应一篇真实 Markdown 文档；相似知识作为章节或增量内容写入同一文档。创建、改名、保存、归档和删除会同步 SQLite、全文索引、版本历史与物理文件。
• 知识库管理拆分为“知识库”和“项目与会话挂载”两个工作区；支持按名称、描述、标签和模型即时搜索，避免知识库较多时逐张翻找。
• 随插件安装的响应式 Web 管理台，覆盖概览、文档树与编辑器、AI 候选审核和客户端令牌管理。
• DSH 浏览器端插件：在左侧工作区下方显示“知识库”，并在当前页面内打开管理面板。
• 明暗主题、键盘操作、窄屏布局以及不依赖颜色的状态标签。

安装

从 npm 安装正式版：

dsh plugin --profile web add @lemoncat7/dsh-knowledge

安装包含文档型知识库、主题聚合和新管理界面的 0.8 预览版：

dsh plugin --profile web add @lemoncat7/dsh-knowledge@next

需要固定本次预览版本时：

dsh plugin --profile web add @lemoncat7/[email protected]

也可以从 GitHub Releases 下载对应版本的完整预构建包后安装：

dsh plugin --profile web add ./lemoncat7-dsh-knowledge-0.8.0-alpha.10.tgz

卸载：

dsh plugin --profile web remove @lemoncat7/dsh-knowledge

插件是标准 DSH profile bundle：package.json 的 dsh.bundle.patch 指向 cordis.patch.yml。安装后不需要单独运行知识库容器。

安装或更新后请重启对应的 DSH profile。Web 版重启命令：

pnpm dsh web

DSH 插件商店

本仓库符合 DSH 社区目录的安装要求：声明了 dsh.bundle、发布了 npm 预构建包，并使用 GitHub dsh-plugin Topic。目录收录完成后，可在 DSH 的插件市场搜索 dsh-knowledge 或“知识库”，安装源为 @lemoncat7/dsh-knowledge。

插件商店的数据来自 awesome-dsh-plugin.com，不是单靠 npm 标签自动生成。若商店尚未刷新，可先使用上面的 npm 命令安装。

本地模式

默认配置使用 DSH 持久目录中的 SQLite 文件：

- id: knowledge
  name: '@lemoncat7/dsh-knowledge'
  config:
    backend: local
    databasePath: !!js dshHomePath('knowledge/knowledge.sqlite')
    extractionEnabled: true
    defaultScope: project
    autoRecallLimit: 3
    autoRecallMinScore: 0.2
    recallMaxChars: 5000
    exposeApi: false
    exposeWeb: true

本地管理台默认开启。它使用独立的同源管理接口，不要求开放远程 API，也不要求输入访问令牌；侧栏“知识库”安装后即可使用。任何能访问 DSH Web 的用户都具有本地管理权限，因此把 DSH 暴露到公网时，应继续使用反向代理登录保护整个 DSH 站点。

提取模型默认沿用刚完成回答的 provider/model。可在单个知识库中设置专用回写模型；以下全局配置仅作为兼容性后备：

…