dsh-shared-kb

团队共享知识库：你的电脑当 Hub，其他人只装一个插件、粘一个邀请码。素材统一按 inbox-triage 规范整理，所有人的 AI 都能检索。

你的电脑（Hub，文件都在这）                成员 A / B / C / D 的 DSH
┌────────────────────────────┐           ┌──────────────────────────┐
│  hub.js · 8787             │◀── HTTP ──│ 侧栏「共享知识库」        │
│  raw/ + docs/ + 搜索 + 成员 │           │ 上传 / 搜索 / 阅读        │
│  管理：成员、删除、统计     │           │ 模型工具 skb_*            │
└────────────────────────────┘           └──────────────────────────┘

• Hub 零第三方依赖，node hub.js 就能跑；数据就在你的电脑上。
• 每人一个令牌，文档自动署名；你是管理员，可增删成员、轮换令牌、删除任何文档/素材。
• 上传的文本会调用上传者自己的模型，按你的 inbox-triage 规范整理（十类、≤10 字总结、置信度、2~4 条要点、sha256 查重）；失败进「待整理」，agent 可补做。
• 随插件自动安装 4 个技能：shared-kb（团队版收件箱）+ 你原来的 long-dialogue-knowledge、controversy-analysis、idea-synthesis。

一、你：在自己的电脑上启动 Hub

需要 Node.js 20+；这台电脑装过 DSH 的话通常已经带了 Node。

双击启动（推荐）

• 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

把 http://<局域网IP>:8787 换成其他成员真能访问的地址：同一个 Wi-Fi 用局域网 IP，异地用 Tailscale / 内网穿透。不要把 8787 直接暴露到公网，令牌就是全部权限。

二、成员：装插件 → 粘邀请码

两步，没有配置文件、没有命令行。

1. 装插件

三种方式，任选其一：

• 市场（上架后）：在 dshmarket 里搜「共享知识库」安装。
• GitHub：插件页「添加 / 安装」粘贴 github:kunjienie50-creator/dsh-shared-kb。
• Hub 直连：粘贴 http://<你的Hub地址>:8787/install/dsh-shared-kb-0.2.0.tgz。

装完按提示重启 DSH。

2. 粘邀请码

打开侧栏的书本图标「共享知识库」→ 把管理员发的邀请码（skb1.…）粘进去 → 连接。

邀请码里包含 Hub 地址、令牌和你的名字，所以只此一处。

三、你：管理员操作

侧栏「共享知识库」→ 右上角 管理：

能做什么	说明
看概览	文档数、待整理数、成员数、占用空间、分类分布
加成员	填名字 → 生成邀请码 → 复制发给对方（微信即可）
移除成员	立即失去访问；不能移除自己，至少保留一个管理员
换令牌	旧令牌立刻失效，重新生成邀请码
设对外地址	邀请码里用的地址，必须是成员能访问的 Hub 地址
删文档	任何人的文档都能删（带历史版本）
清理素材	「标记无用」记原因，或删除未成文的原始素材
统计	按十类看分布

管理员也可以在对话里让 AI 调 skb_admin 做同样的事。

四、成员日常怎么用

• 收东西：把文件拖进「共享知识库」页面，或直接对 AI 说「把这个存进团队库」。截图、发票、名片、合同、PDF、一段文字都行。
• 查东西：页面搜索，或直接问 AI（它会先 skb_search）。
• 整理待整理：说「把待整理的整理一下」，AI 会按规范补做。
• 成文：长对话、争议、灵感分别用对应的三个技能，产出后说「存进团队库」。

五、规范化规则（来自你的 inbox-triage）

• 分类只取十类之一 + 99_待分类；判据是「将来拿它干什么」。
• summary ≤10 字、能独立看懂，像文件名；禁用「关于」「一张」「截图」「其他」「杂项」。
• points 2~4 条短句，可带 - [ ] 待办。
• confidence 高/中/低；拿不准进 99_待分类 并写低。
• 同一 sha256 只存一份，重复上传直接返回已有文档。
• 原件（raw）不可变；正文只写提取内容，不编造。

规则细节在 skills/shared-kb/，随插件自动装到 ~/.dsh/skills/。

六、工具

工具	作用
skb_search	检索（可按分类）
skb_read	读全文
skb_list	列最近 / 按分类、标签
skb_upload	上传原件，返回 rawId、预览、是否重复
skb_commit	写入整理后的文档（唯一成文入口）
skb_inbox	列待整理
skb_read_raw	读待整理素材
skb_status	连接状态、角色、数量
skb_admin	管理员：统计、成员、删除/跳过

七、备份与维护

• 备份：整个数据目录打包即可（~/.dsh-shared-kb，含 config.json、docs/、raw/）。
• 成员管理也可以在命令行：--add-member、--remove-member、--rotate、--list-members。
• 改库名：node hub.js --data <目录> --rename "新名字"。
• 升级：替换 hub.js 等文件后重启 Hub；插件在各自 DSH 里重新安装同版本即可。

八、限制

• 适合 5~20 人；单进程文件存储，上千篇后建议换 SQLite FTS5。
• 目前自动整理只处理纯文本；PDF/Word/扫描件由 agent 先用 office/OCR 技能转文本再入库。
• 没有实时协同编辑；并发靠「新建 + 冲突显式标注」，不覆盖。