知枢 KnowHub：DSH 全局知识中心与项目长期记忆

前言¶

智能体开发中，项目知识散落在代码注释、文档、会议记录与长期记忆里，检索困难、版本不可追溯、难以复用。DSH 插件生态以「一切皆插件」为理念，本插件提供全局知识中心与项目长期记忆，把项目知识与长期记忆沉淀成可检索、可审核、可追溯、可备份的知识库，并在 DSH 会话中按工作区作用域自动注入或按需检索。

是什么¶

知枢 KnowHub（dsh-knowhub）是 DSH 的全局知识中心与项目长期记忆插件。由 Mw-HbCK 维护，分类为「记忆」，GitHub 1 star。它将项目知识与长期记忆整理成可检索、可审核、可追溯、可备份的知识库，并在 DSH 会话中按工作区作用域自动注入或按需检索。

核心功能¶

知识库与作用域¶

用户级知识库（跨工作区共享）与工作区级知识库（仅当前项目可见）；检索与上下文注入按工作区作用域隔离，审核队列与知识库列表覆盖本地全部知识库。
每个知识库可绑定不同的模型与生成策略（economy / balanced / quality），初始化、提炼、增量都使用库绑定的模型。
创建后可修改名称、模型与策略，不影响已有知识与版本历史；编辑配置里可先「测试模型」确认该模型当前可调通。
模型输出被截断（推理模型把 token 预算消耗在思考过程）时，任务会自动加倍预算重试一次；仍失败会明确提示换用非推理模型或调高「模型使用策略」。

Repo Wiki 与增量更新¶

一键扫描工作区，生成项目概览、架构、模块等 Wiki 候选。
内容哈希 + Git 检出双重判据驱动增量更新：只对受影响的知识生成更新候选，并记录每次检查点与变更清单。
已批准的知识不会被流水线静默覆盖，写入类更新一律先成为待审核候选。

长期记忆与知识卡片¶

七类知识：Wiki、记忆、偏好、决策、约定、问题、待办。
每条知识带来源清单、验证态（observed / inferred / assumed / unverified）、版本历史与审核日志。
Agent 可在会话中通过工具提议新知识；也可开启自动提炼，在回合结束后把有价值的结论沉淀为候选。

检索与上下文注入¶

SQLite FTS5 trigram 中文全文检索，1–2 字短词自动回退 LIKE；支持标签过滤（AND、最多 6 个）、类型/状态/知识库过滤与分页加载。
同一内容的结果按哈希合并，并提示重复来源。
会话系统提示按作用域注入已批准知识摘要，可分别关闭全局记忆与项目记忆，并限制摘要字符数与标题数。

审核与版本¶

待审核队列分候选、冲突、草稿、过时四类，覆盖本地全部知识库（用户级 + 各工作区），真实计数、关键字/类型/来源筛选与排序。
支持单条与批量审批（单次最多 50 条）、编辑后批准、冲突人工合并。
候选与冲突提供文档对比页：绿色新增、红色删除，行内词元高亮，统一视图与并排视图，改动处导航。
版本历史可查看、对比与恢复，恢复同样以新版本追加，可回退。

备份与维护¶

gzip 备份、恢复前预览、破坏性操作前自动创建恢复点；恢复是合并语义，不删除当前已有的知识。
存储位置迁移：预检 → 自动备份 → 计数校验 → 切换指针，回滚只需删除指针文件。
环境诊断：运行时、存储、工作区、模型、SQLite FTS5 与工具注册状态。

导入导出¶

单篇或整库导出 Markdown（带元数据头），可读可改，可进 Git。
Markdown 导入支持粘贴或选择文件，一律先落为草稿，同名知识跳过不覆盖。

面板¶

DSH 内嵌的中文知识中心：Repo Wiki / 知识卡片 / 记忆 / 知识库四个页签，加上待审核 / 检索 / 设置三个整页入口。
配色全部读取 DSH 主题 token，跟随浅色 / 深色 / 跟随系统。
知识正文使用内置零依赖 Markdown 渲染，可切换「渲染 / 源码」。

安装与启用¶

环境要求¶

DSH 0.2.x（需含 web 面板 bundle，用于知识中心界面）
Node.js ^22.19 或 >=24
一个已在 profile 中注册的 provider / model，初始化、提炼与增量会调用它

从 npm 安装¶

dsh plugin --profile knowhub add dsh-knowhub
dsh --profile knowhub --port 29961 --no-open

安装会写入 profile 依赖；请确认 profile 的 package.json 中 dsh.profile.bundles 包含 dsh-knowhub。启动日志会打印面板地址（含一次性 token）：http://127.0.0.1:29961/?token=...

从本地 tarball 或源码目录安装¶

# tarball
& dsh plugin --profile knowhub add .\dsh-knowhub-0.8.8.tgz

# 开发期：软链到源码目录，构建后重启即生效
cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\knowhub\node_modules\dsh-knowhub" "C:\path\to\KnowHub"

配置模型¶

知识库需要模型才能生成 Wiki。在 profile 的 cordis.patch.yml 中注册默认模型：

- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: <provider-id>
    model: <model-id>

创建知识库时，面板会列出宿主 /models 返回的可用模型，选中后绑定到该库。

典型用法¶

新建知识库：左侧栏「知枢」→「知识库」→「+ 新建」，选择生效范围（用户级 / 工作区级）、模型与策略。
初始化 Wiki：在知识库详情点「初始化」，扫描工作区并生成候选草稿。
审核：右上「待审核」里逐条或批量审批；内容有改动可用「编辑后批准」，冲突可人工合并。
增量更新：初始化完成后点「增量更新」，只对变更文件影响到的知识生成候选。
记忆与卡片：会话中由 Agent 工具提议，或开启自动提炼；结果都在待审核里确认。
检索与注入：右上「检索」按关键词或标签查找；「设置」里控制注入开关与摘要预算。

适用场景与注意¶

适合需要将项目知识沉淀为长期记忆、希望对知识进行审核与版本控制、需要在 DSH 会话中自动注入知识摘要的开发者。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。插件禁用或卸载不删除用户知识。

短结尾¶

知枢 KnowHub 提供从扫描、审核、检索到注入的全链路知识管理能力，适合需要长期沉淀项目知识并与 DSH 会话深度集成的场景。

目录页：https://www.skillhub.cn/plugins/Mw-HbCK/dsh-knowhub
GitHub：https://github.com/Mw-HbCK/dsh-knowhub