专家团队群聊 wangshouyong/dsh-im

dsh-im · 专家团队

DSH（DeepSeek Harness）插件：把多个角色拉进同一个群或私聊，让它们各自带着人设、岗位和工具协作。
模型与调用全部走宿主 ctx.llm（或原生 session），插件不直连任何网关、不保存任何密钥。

版本 0.1.0 · Node ≥ 20 · MIT · 开发中（数据格式与接口仍可能变化）

这是什么

DSH 侧栏里出现的「专家团队」面板：新建角色（人设 / 岗位 / 模型 / 工具白名单）、拉群、私聊、@ 点名、看任务板。

它不是「多开几个对话框」：角色发言要过发言权仲裁，上下文按摘要 / 事实 / 共识分层投喂，每次发言留下可核验的回执与指标，角色调工具的过程能看到执行轨迹。

界面

截图来自开发预览与测试群（内存假模型 / 测试角色），仅作界面示意。

群聊：三栏布局——左会话列表，中聊天流（按日期分组的消息 + 底部等待发言/输入框），右成员列表（岗位、活跃度、执行记录）。

群聊界面

私聊：单角色小窗，右侧显示角色信息（人设 / 职责 / 模型 / 可用工具 / 活跃度 / 禁言 / 主动私聊开关）。

私聊界面

角色编辑：人设、岗位、模型（只能选 DSH 已配置的模型）、可用工具（内置能力 + 宿主来源组 / 单工具授权）。

角色编辑

功能

- 群聊与私聊：建群 / 邀请 / 关联工作区；DM；@ 点名；模型回复里自带的「某某：」前缀会兜底剥离；附件（图片 ≤8MB、文件 ≤20MB，可粘贴/拖拽）。
- 发言权仲裁：点名独占 > 回复对象 > 职责命中 > 活跃度补位；wait 只停本轮、不插话；默认串行地板（并发发言关闭）。
- 上下文与记忆：分层摘要（L1 旧消息压缩 + L2 不可压缩事实）、窗口预算按模型 contextWindow 分配（群级按最小成员窗口统一压）、角色状态快照（承诺 / 待办 / 决定 / 立场）、按需检索（默认 shadow：算但不进 prompt）。
- 可寻址记忆层：消息索引投影（派生字段，不复制正文）+ claim 弱状态（active / superseded / raw）+ 可见性谓词表；模型侧有 memory_search / memory_expand 两个记忆工具（只返回句柄，正文按需展开，两者同权）；默认 shadow，需显式开启才注入 prompt。
- 事实与共识：规则 + LLM 双路抽取事实、哈希幂等、supersede / retract、任务板归档不复活；共识层自动生成并带生命周期状态，prompt 只注入仍然有效的条目。
- 工具与能力：内置五能力 read / search / write / check / memory（没有 shell）；宿主第三方工具（浏览器、MCP 等）按「来源组 + 单工具」显式授权，默认不授予、未授权一律硬拒绝；run_check 只跑本仓 vitest / tsc，参数白名单、不经 shell、60s 超时、并发与排队有上限。
- 原生 session（默认开）：每个「角色 × 群」一个 DSH 原生会话，角色因此能真实调工具、保留自己的会话记忆；授权或工具可见性变化时重建会话；空闲 30 分钟释放。宿主缺 ctx.agents / tools.register / tools.guard 任一能力时整体回退 ctx.llm，不会半残运行。
- 可观测：执行轨迹（工具步骤与结果摘要）、两阶段回执（intent / outcome + 规范化双 hash + basedOnSeq）、metrics.jsonl 指标、失败 turn 可导出的复现包、黄金回放测试。
- 稳定性：模型调用 120s 超时并透出失败码、Origin 同源校验、请求体 2MB 上限、坏 state.json 清洗、数据根发现与失败可见（加载 / 保存失败明确报错，而不是把错误吞成「空团队」）。
- 界面：三栏 IM（左会话 / 中聊天 / 右成员·任务板·候选·执行）、深色主题、@ 高亮、按日期分组的消息时间、角色头像（预设 / 上传）、窄窗降级；插件 CSS 全部作用域到 .dsh-im-root，不污染宿主样式。

安装

方式一：从源码接入（推荐，当前唯一可验证方式）

git clone https://github.com/wangshouyong/dsh-im.git
cd dsh-im
npm install
npm run build
dsh plugin --profile desktop add ./
dsh --profile desktop

重启后侧栏出现「专家团队」。新建角色时选 DSH 设置里已经配好的模型（和输入框旁的选择器同一份目录）。

开发调试：

npm run dev # 开发预览：内置内存假模型，不联网（默认 5173 端口）
npm test # 单测
npm run gate # 提交前门禁：typecheck + 测试 + build + 打包内容校验

方式二：从 Release 包安装

在 Releases 下载对应版本的构建包（含 dist/、lib/client.js、cordis.patch.yml、dsh-plugin.json），解压后：

dsh plugin --profile desktop add <解压后的目录>

从 npm 安装

尚未发布到 npm（发布后更新到这里）。当前请用上面两种方式。

配置

- 模型：全部来自 DSH 设置里已配置的 provider / model；插件不写死地址、密钥或网关，也不换组——解析不到就报错让你重选。
- 工具授权：角色编辑器里按「内置能力 → 宿主来源组 → 单工具」勾选；默认全不授予。契约见 docs/TOOL-GRANTS.md。
- 数据根：面板标题旁「工作区」下拉可切换 / 注册工作区；数据按 DSH 工作区分别存放（见下节）。
- 环境变量（全部可选）：

| 变量 | 默认 | 作用 |
| DSH_IM_NATIVE_SESSION | 开 | 设 0 整段关闭原生 session，退回 ctx.llm |
| DSH_IM_NATIVE_TTL_MS | 30 分钟 | 原生会话空闲多久释放 |
| DSH_IM_NATIVE_PROVIDER | 空 | 覆盖原生 session 的 provider（排查用） |
| DSH_IM_NATIVE_TOOL_ALLOW | 空 | 整表覆盖工具授权（仅排查；guard 仍拒绝名单外工具） |
| DSH_IM_NATIVE_ARCHIVE | 空 | 设 live 时用 stopActivity:false 试归档 |
| DSH_IM_TURN_BUDGET_MS | 240000 | 单轮工具循环总时长预算（防挂死） |
| DSH_IM_MAX_TOOL_ROUNDS | 50 | 单轮工具循环硬顶（仅防死循环） |
| DSH_IM_ROOTS_FILE | ~/.dsh-im/known-roots.json | 「用过的数据根」清单文件 |
| DSH_IM_DEV_ROOT | 进程 cwd | dev 预览的 state 根 |
| DSH_IM_CALIBRATION_MODE | 影子（只观测） | 设 calibrated 才把 usage 校准系数用于预算换算 |

- 实验开关（浏览器控制台，刷新生效）：localStorage['dsh-im:retrieval']（off / shadow / on）控制按需检索是否进 prompt；localStorage['dsh-im:memory'] 控制记忆层句柄是否注入。两者默认 shadow，只写回执、不改行为。

数据与隐私

数据按 DSH 工作区存放，位于 <工作区>/.dsh-im/：

.dsh-im/
├ state.json 角色、会话、消息、事实投影（当前读路径） ├ calibration-samples.jsonl token 校准样本（每轮实测 usage，用于把 token 预算换算成字符预算） └ groups/<threadId>/ 每个群 / 私聊一个目录 ├ events.jsonl 只追加的事件日志（"唯一事实源"的演进方向） ├ facts.json 事实物化投影 ├ receipts.jsonl 每次发言的 intent / outcome 回执 ├ metrics.jsonl 指标（llm_call / stale / floor_round / extraction / summary 等） ├ sync.json 摘要 / 事实推进边界 ├ index.json 记忆索引投影（默认诊断模式不落盘，开启后才有） ├ attachments/ 本群附件 └ 纪要/ 角色写进群工作区的文档（纪要 / 草案 / 验收标准）

- 角色只能读写自己群的 groups/<threadId>/；.dsh-im 其余内容（state.json、别的群）对角色禁读。
- 插件自身不收集遥测、不直连模型网关（源码中没有外部 API 地址或密钥）。
- 注意：群消息会进入该角色模型的上下文；如果给角色授权了第三方 MCP / 浏览器工具，相关内容会交给对应工具处理，是否合规需自行评估。

开发与测试

- 提交前门禁：npm run gate（= typecheck → test → build → verify:tarball），一条命令跑完；CI 在 GitHub Actions windows-latest 上跑同一串（.github/workflows/ci.yml）。
- 发布包校验：npm run verify:pack（prepublishOnly 会自动跑）——断言运行时产物齐全、发布包里没有开发材料、dsh-plugin.json 与 package.json 版本一致。
- 测试分层：src/core 纯函数单测 · src/host 集成测试 · src/client 组件测试 · 黄金回放（行为变化要显式更新 GOLDEN）· 记忆层 fixture ground truth（test/fixtures/memory/）· 活体测试（默认 skip，需要 DSH 正在运行）。
- 架构约束：src/core 不 import 任何 @deepseek-ai/*，可脱离宿主单测；宿主能力只从 src/host 进入。
- 代码地图：

src/core/ 领域层（群 / 仲裁 / 事实 / 共识 / 摘要 / 检索 / 记忆 / 回执 / 指标，纯函数为主） src/host/ DSH Host 入口（/api/im 路由、ctx.llm、原生 session、工具执行、记忆索引） src/client/ 客户端 UI（三栏 IM、模型选择器、角色编辑器、头像、样式作用域） src/dsh/ 面板挂载入口 src/dev/ 开发预览（vite + 内存假模型） scripts/ 构建与校验脚本

项目状态与已知限制（如实）

- 0.1.0，开发中：数据格式、接口、UI 都可能变。
- 原生 session 是默认路径，但仍是需要门禁守着的链路：依赖宿主提供 ctx.agents + tools.register / tools.guard；缺能力时整体回退 ctx.llm。它不是"稳定 API"，宿主升级后可能要跟着改。
- 实验特性默认 shadow：按需检索、记忆层句柄注入、token 校准都先只观测（写进回执/样本），要显式开开关才改变行为。
- 记忆层仍在推进：索引、claim、可见性、句柄协议、search/expand 工具已落地，但注入默认关闭。
- 并发发言默认关闭（串行地板）。
- 目前只在 Windows 上的 DSH Desktop 实测通过，其它平台未验证。
- 没有遥测 / 崩溃上报：排查依赖本机 metrics.jsonl、receipts.jsonl 和宿主日志。
- 单测全绿 ≠ 所有模型、所有平台都验证过；活体测试默认跳过，需要单独跑。
- 设计约束见 docs/DESIGN.md。

关于开发方式（如实说明）

本项目采用 AI 辅助开发：代码、测试与文档由作者与 AI 编程助手（DeepSeek Harness 会话）协作产出，架构取舍、验收标准与最终发布决定由作者负责。仓库不会把 AI 协作包装成「完全手写」。

文档

- docs/DESIGN.md：架构、模块边界、数据模型与关键设计约束
- docs/TOOL-GRANTS.md：工具授权契约（来源组 / 单工具 / 记忆可见性）
- LICENSE：MIT

许可证

MIT