前言¶
在 DSH 里做智能体或长期协作时，常见做法是各自把对话摘要、文档片段放在本机技能或私有目录里。检索口径不一致、重复上传、谁写了什么难以追溯，跨成员对齐成本偏高。DeepSeek Harness 社区插件 dsh-shared-kb（维护者 kunjienie50-creator，分类：记忆）把「库」收拢到管理员本机上的一个 Hub：成员只装插件、粘贴邀请码，上传与检索走同一套 inbox-triage 规范，AI 侧通过 skb_* 工具按摘要→目录→全文的顺序取数。下面介绍它的定位、能力与启用方式；安装命令与字段均来自项目 README 与 package.json（当前版本 0.3.0，许可证 MIT）。
这是什么¶
一句话：你的电脑当 Hub（hub.js，默认端口 8787），团队成员在 DSH 侧栏「共享知识库」连上邀请码即可共享素材与成文文档；数据落在 Hub 机器的数据目录（默认 ~/.dsh-shared-kb），Hub 本身零第三方依赖，node hub.js 即可运行。
与「每人各存各的、靠拷贝同步」相比，这里统一了整理规则、署名、去重（sha256）和管理员审计；与向量 RAG 方案相比，作者有意采用字段加权与 skb_recall / skb_search(compact) 分层检索，以保持 Hub 单进程、无 embedding 依赖（README 第八节说明了取舍）。
目录页：skillhub.cn 插件页
源码：GitHub kunjienie50-creator/dsh-shared-kb
核心功能¶
Hub 与成员模型¶
- 管理员在本机启动 Hub，管理成员、轮换令牌、删除文档/素材、查看统计；成员凭邀请码（形如
skb1.…，内含 Hub 地址、令牌与名字）连接。 - 每人一个令牌，文档自动署名；管理员不可移除自己，至少保留一名管理员。
- 上传文本会调用上传者自己的模型按 inbox-triage 整理（十类分类、≤10 字 summary、置信度、2~4 条要点）；失败进入「待整理」，可由 agent 补做。同一 sha256 只存一份。
DSH 侧栏与私有库¶
- 侧栏书本图标「共享知识库」：拖拽或上传素材、搜索、阅读、筛选（分类、上传者、重要性、团队/私有/全部）。
- 私有库：选择「仅自己可见」或写入本机
~/.dsh/shared-kb-private，不上传 Hub；检索时可一并命中并标注私有。 - 重要资料置顶：标重要须手写推荐语（≥10 字），全员顶部提醒；读过全文后才能自行取消置顶。
- 收藏夹、评论与 @、历史版本对比、批量下载/删除、每周简报：与账号相关能力按 README 描述在页面与工具中提供。
随插件安装的技能¶
安装后自动带上 4 个技能：shared-kb（团队版收件箱），以及 long-dialogue-knowledge、controversy-analysis、idea-synthesis，用于长对话、争议、灵感类成文后再「存进团队库」。
模型工具（节选）¶
| 工具 | 作用 |
|---|---|
skb_recall |
按主题一次取多篇摘要与要点（优先使用） |
skb_search |
检索；compact=true 仅目录 |
skb_read |
读全文；读团队文档会记「已读」 |
skb_upload / skb_commit |
上传原件与成文（commit 为唯一成文入口） |
skb_admin |
管理员：成员、删文档、统计等 |
完整列表见 README「六、工具」。
安装与启用¶
插件在 DSH ≥ 0.2.0、Node.js ≥ 20 环境下使用；Hub 建议在装过 DSH 的机器上运行。安装插件前请自行查看源码与 MIT 许可证；插件与 Hub 以当前用户/进程权限读写本机目录，勿将 8787 端口无防护暴露公网（令牌即全部权限）。
1. 管理员：启动 Hub¶
双击启动（推荐）
- macOS：
install/启动知识库.command - Windows：
install/启动知识库.bat
首次输入管理员名字后，会打印成员访问地址与插件安装地址；关闭窗口即停止服务。
或命令行
node hub.js --data ~/.dsh-shared-kb --add-member 你的名字 --admin --url http://<这台电脑的局域网IP>:8787
node hub.js --data ~/.dsh-shared-kb --port 8787 --host 0.0.0.0 --url http://<局域网IP>:8787
将 URL 换成成员实际能访问的地址：同 Wi-Fi 用局域网 IP，异地可用 Tailscale 或内网穿透；README 明确不建议把 8787 直接暴露公网。
2. 成员：安装插件¶
三种方式任选其一（装完按提示重启 DSH）：
- 市场（上架后）：在 dshmarket 搜索「共享知识库」。
- GitHub：在插件页「添加 / 安装」粘贴：
github:kunjienie50-creator/dsh-shared-kb
- Hub 直连：粘贴 Hub 提供的安装包地址，例如：
http://<你的Hub地址>:8787/install/dsh-shared-kb-0.3.0.tgz
3. 成员：连接¶
打开侧栏「共享知识库」→ 粘贴管理员发放的邀请码 → 连接。无需额外配置文件或命令行。
典型用法¶
收素材与成文¶
- 在「共享知识库」页面拖入文件或点「上传素材」；或对 AI 说「把这个存进团队库」。
- 上传前选择 团队共享 或 仅自己可见；可勾选「先不整理」直接进待整理（不消耗模型），之后再点「整理」或让 AI「把待整理的整理一下」。
- 长对话、争议、灵感分别用随插件安装的三个技能产出内容，再指令「存进团队库」。
查资料（页面与对话）¶
- 页面内搜索，或筛选分类、上传者、重要性等。
- 对话中 AI 宜先
skb_recall，不够再skb_search，最后skb_read读全文。
管理员日常¶
侧栏「共享知识库」→ 右上角 管理：概览、加成员（生成邀请码）、移除成员、轮换令牌、设置对外地址、删文档、清理素材、分类统计；亦可在对话中调用 skb_admin。
备份时打包 Hub 数据目录（含 config.json、state.json、docs/、comments/、raw/）；各成员私有库在各自 ~/.dsh/shared-kb-private，需分别备份。
适用场景与注意¶
适合：小规模团队（README 建议约 5~20 人）在同一 Harness 生态下共享规范化的知识条目，管理员能接受在本机常驻 Hub。
限制（来自 README）
- 单进程文件存储；上千篇后作者建议考虑 SQLite FTS5 等方案。
- 自动整理主要针对纯文本；PDF/Word/扫描件需先用 office/OCR 类技能转文本再入库。
- 无实时协同编辑；并发修改靠版本与冲突提示，不互相覆盖。
- 检索不做向量库；规模在几十到几百篇时作者认为现有分层工具链更省依赖、对精确串更稳。
DSH 社区目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系；插件 star 数随仓库变化，撰写时 GitHub 显示为 0。
结尾¶
dsh-shared-kb 把团队知识收拢到管理员本机 Hub，用邀请码降低成员接入成本，用 inbox-triage 与 skb_* 工具统一整理与检索路径；需要 centralized 备份与权限时，由管理员在 Hub 与侧栏管理中完成。
