dsh-intercom

DSH 网页插件：顶层会话(父代理)之间的通信中心——在线会话列表(含工作区)、对话式私聊面板、协作群(对话群)、以及一组模型可调用工具(intercom_*),让对话在需要时自动协调其他对话(请求帮助、并行合作、延续工作)。已发布至 dsh-plugin 主题。

A DeepSeek Harness web plugin: a communication center between TOP-LEVEL conversations — live conversation list with workspaces, a chat-style messaging panel, coordination groups (对话群), and intercom_* model tools for autonomous cross-conversation cooperation (asking for help, parallel work, continuing work).

功能

能力	说明
通信中心面板	侧栏「通信中心」入口(图标+文字)与会话头图标按钮;聊天式双栏:左侧会话/群聊 Tab,右侧消息气泡流 + 底部输入框;唤醒/介入两种投递模式;DSH 主题色深浅色自适应
顶层会话列表	只列 agents.roots()(父代理),含标题、忙碌/空闲状态、工作区路径;子代理不进入本视图
对话间消息	空闲目标唤醒即开工,忙碌目标排队不打断;介入(steer)需显式选择;限频(10 条/分钟/目标)+ 唤醒预算(3 次/人工输入重置)防消息风暴;来源定型包装防提示注入
协作群(对话群)	自动群「协作中的对话」收集通信流量成员;可建显式群、增删成员、广播到全员、合并阅读群记录;群数据经 storage-domain 持久化,重启不丢
模型工具 ×11	intercom_list_conversations / intercom_send / intercom_ask(发+有界等待回复)/ intercom_check_replies / intercom_read_conversation(冷会话可读,延续工作)/ intercom_collect(并行汇总)/ intercom_spawn_conversation(创建子代理)/ intercom_create_group / intercom_broadcast / intercom_list_groups / intercom_read_group
边界隔离	intercom 只服务顶层会话之间;父↔子代理通信完全交给内置 send_message/list_agents,本插件不拦截、不越权;跨工作区投递默认拒绝

安装

把本仓库集成到你的 DeepSeek Harness 源码工作区(按源码方式安装):

1. 将 packages/host/intercom 与 packages/client/ui-intercom 两个目录复制到工作区的 packages/host/ 与 packages/client/ 下;
2. 在工作区根目录执行 git apply install.patch(含 api-remotes 挂载、web-app 组合注册、根 tsconfig 引用与 paths 映射;如版本有出入请对照补丁手工合并);
3. 安装与构建:

pnpm install
pnpm exec tsc -b tsconfig.host.json
pnpm exec tsc -b tsconfig.client.json
pnpm --filter @deepseek-ai/dsh-host-intercom bundle
pnpm --filter @deepseek-ai/dsh-client-ui-intercom bundle
pnpm --filter @deepseek-ai/dsh-api-remotes bundle

4. 重启后台(例如 pnpm dsh web),刷新页面后即可在侧栏底部看到「通信中心」入口。

两个包的 lib/ 产物(含 typert 契约与客户端 module-loader 包)已随仓库附带,通常无需重新生成;若安装后修改了 src/,务必重跑第 3 步并重新构建前端。

工作原理

• Host Remote:@deepseek-ai/dsh-host-intercom 以 Typert Remote 服务(ctx.remote.intercom)暴露 9 个方法(list/groups/send/broadcast/readConversation/readGroup/createGroup/addMember/removeMember),客户端经 api-remotes 挂载调用;同名服务类在宿主侧注册 11 个 intercom_* 模型工具。
• 投递:空闲目标 agent.followup(唤醒开工),忙碌目标 agent.inject(排队),steer 显式介入;消息来源 kind:'plugin' + form:'relay' + senderSessionId 并包装「来自会话X」提示。
• 群持久化:storage-domain 全局槽保存全部群(含自动群),启动时加载;信箱不落盘——历史记录永远以会话日志为准,面板实时读回。
• UI:客户端 dsh.client 元数据 + web-app 组合行挂载;面板注册于 shell.overlay,入口注册于 sidebar.footer.action 与 conversation.session.header.actions。

要求

• DeepSeek Harness 源码工作区(本插件按 0.1.0-rc.5 版结构集成)
• Node.js 22+、pnpm

相关项目(双向互链)

• dsh-plugin-suite — 定制插件套件(局部 fork),含 dsh-restart-plugin 与 dsh-careful-full-access 的累计补丁,一次性安装全部功能;
• dsh-restart-plugin — 一键关闭后台服务 / 刷新前端(保留热插件);
• deepseek-harness — 官方上游。

License

MIT