会话互聊 KeFan-J/dsh-chat-link

dsh-chat-link · 会话联动

DeepSeek Harness (DSH) 多会话对等互聊插件 —— 让任意两个会话像 IM 一样直接对话，输入框打 @ 就能把消息发给另一个会话，对方会被自动唤醒并处理。

✨ 它解决什么问题

DSH 本身只有「会话内」的多代理协作（subagent 父子关系）。dsh-chat-link 补齐了缺失的一环：对等的、跨会话的实时对话。

- 会话 A 在输入框打 @B 帮我查一下今天的任务 → 会话 B 被自动唤醒，把消息作为任务处理；
- B 回复时 A 又被唤醒 —— 两个会话真正互聊，不需要人当传话筒；
- 消息持久化在本地文件（~/.dsh/chat-link/），重启 DSH 不丢。

🚀 功能特性

1. @ 会话引用（像调用技能一样）

- 输入框直接打 @ → 弹出系统原生选择菜单（会话名 + 在线/未读状态，支持过滤）；
- 选中后输入框里出现蓝色 chip 标签（@会话名）—— 和 DSH 的技能引用/斜杠命令同一套机制；
- 发送时 chip 自动投影为 @会话名 内容，由 Agent 转发给目标会话。

2. 唤醒投递

- 目标会话在线 → 通过 DSH 原生 agent.send(message, 'next-turn', true) 立即唤醒处理；
- 目标未打开 → 消息存在消息板，3 秒轮询兜底补投，对方打开会话即收到。

3. 原生质感收件箱

- 侧边栏「⇄ 会话联动」入口（DOM 注入，与 dsh-ssh / 任务看板同款机制，React 重渲染自愈）；
- 点击后接管中间主内容区（非浮层），与 DSH 设计系统一致（--dsw- 主题变量，跟随皮肤）；
- 未读消息卡片 + 会话列表双栏；点击任意消息/会话直接跳转到对应会话；
- 打开会话自动清除未读红点；未读数在侧边栏入口实时角标。

4. 五个模型工具（所有会话可用）

| 工具 | 用途 |
| chat_link_send | 给指定会话发送联动消息（名称 / sessionId / 前缀寻址） |
| chat_link_inbox | 查看并领取本会话未读联动消息 |
| chat_link_history | 查看本会话的联动消息往来 |
| chat_link_roster | 列出全部联动会话（名称/在线/未读） |
| chat_link_register | 给本会话设置自定义联动名称 |

5. 命名实时同步

- 联动名称实时派生自会话标题 —— 在工作区重命名会话，联动列表自动更新；
- chat_link_register 可设置自定义名称（优先于标题）。

📦 安装

🚀 一键安装（推荐）

bash -c "$(curl -fsSL https://raw.githubusercontent.com/KeFan-J/dsh-chat-link/main/install.sh)"

脚本自动完成：克隆代码 → 安装依赖 → 挂载到 DSH web profile。完成后只需重启 DSH（Ctrl+C → npx @deepseek-ai/dsh web）并强制刷新浏览器（Cmd+Shift+R）。

自定义安装目录：bash -c "$(curl -fsSL <上面的URL>)" - /path/to/dir 更新插件：重新执行一键安装命令即可（自动 git pull）。

手动安装

前置要求

- DeepSeek Harness 0.1.0-rc.6（npx @deepseek-ai/dsh web 启动的 Web GUI）
- Node.js ≥ 22、pnpm（corepack enable 或 npm i -g pnpm）

步骤

1. 克隆本仓库
git clone https://github.com/KeFan-J/dsh-chat-link.git
cd dsh-chat-link

2. 安装依赖（仅 @deepseek-ai/dsh-tools）
pnpm install

3. 挂载到 DSH web profile（bundle 机制，自动加入插件层）
dsh plugin --profile web add link:$(pwd)

4. 重启 DSH 终端 Ctrl+C → 重新运行 npx @deepseek-ai/dsh web

5. 浏览器强制刷新页面（Cmd+Shift+R）

注：DSH 通过 ~/.dsh/vendor/plugins/ 加载插件。若你使用 vendor 目录部署模式，更新代码后需同步：
cp -r lib ~/.dsh/vendor/plugins/dsh-chat-link/

🎮 使用

方式一：输入框 @（推荐）

1. 在任意会话的输入框打 @；
2. 从菜单选择目标会话（或继续输入过滤）；
3. 输入内容并发送 —— 消息自动转发，对方被唤醒；
4. 对方回复时，你也会被唤醒（侧边栏入口出现未读角标）。

方式二：收件箱面板

点击侧边栏底部「⇄ 会话联动」：
- 查看未读消息，点击跳转到来源会话；
- 会话列表点击跳转；「复制」按钮一键复制 @名称；
- 「全部已读」清空未读。

方式三：直接跟 Agent 说

用 chat_link_roster 看看有哪些会话给「XXX」发条消息说：……

🏗️ 架构

┌─────────────────────────────── 宿主进程 (Host) ───────────────────────────────┐ │ lib/index.js │ │ ├─ 消息板: ~/.dsh/chat-link/messages.jsonl + identity.json（磁盘持久化） │ │ ├─ 5 个模型工具（全局注册，所有会话可调） │ │ ├─ 唤醒投递: agent.send(msg, 'next-turn', true) + 3s 轮询补投 │ │ ├─ 会话打开即已读（agent/session-start） │ │ └─ HTTP 路由: /api/dsh-chat-link/state · /mark-read │ └──────────────────────────────────────────────────────────────────────────────┘ ▲ fetch / 事件 ┌─────────────────────────────── 浏览器 (Client) ───────────────────────────────┐ │ lib/client.js（ModuleLoader bundle） │ │ ├─ '@' 输入触发器（框架标准 inputTriggers 协议，chip 引用） │ │ ├─ 侧边栏入口（DOM 注入 + MutationObserver 自愈） │ │ ├─ 收件箱面板（接管中间主内容区，--dsw- 皮肤变量） │ │ └─ 与 dsh-ssh / 任务看板互斥（dsh-panel-activate 事件） │ └──────────────────────────────────────────────────────────────────────────────┘

🔒 数据与隐私

- 所有数据仅存本机 ~/.dsh/chat-link/（消息板 + 会话身份映射）；
- 无任何云端依赖、无遥测、无外部请求；
- 卸载插件（dsh plugin --profile web remove @linxin666/dsh-chat-link）不影响历史会话。

🧩 兼容与依赖

- 依赖 @deepseek-ai/dsh-tools@^0.1.0-rc.6（运行时）;
- 通过 DSH 标准 bundle 机制挂载（dsh.bundle.patch + dsh.client 声明），无需修改 DSH 源码；
- 与其他全家桶插件（dsh-ssh、任务看板、Git 图谱等）互不干扰。

📄 License

MIT © Jinkefan

Made for the DeepSeek Harness plugin community.