dsh-xchat — 跨会话知识桥

DSH 插件：实现对话间的相互通信。在一个对话中需要另一个会话的知识时，在目标会话名下原生拉起一个继承该会话完整记忆的 fork 子代理，向它询问关键信息并取回回复；信息不够可反复追问；用完结束并归档删除子代理。

单插件结构，无需任何预设：

| 组件 | 位置 | 职责 | |---|---|---| | 静态 client 包 | lib/client.js + cordis.patch.yml | @ 会话候选菜单（任意位置触发、主题自适应）、拖拽会话到聊天窗、设置面板 | | 静态 host 插件 | lib/host.js（profile 层，inject 声明硬依赖） | xchat_query 工具（start/ask/stop），全局注册，任意会话可用 |

为什么 xchat_query 能放在 profile 层而不是必须预设：Cordis 插件激活是服务可用性驱动的。lib/host.js 在 inject 中声明 tools/subagents/sessionQuery/agents/agentPresets 硬依赖，插件会等待这些服务就绪后再 apply，因此 profile 层即可拿到它们并向全局 tools 注册（同 dsh-mcp-client 的做法）。

功能

1. @ 会话候选（客户端）

• 任意位置触发：行首/空格后的 @ 走原生输入触发菜单；紧跟字母/汉字/数字（如 你好@）由自绘菜单接管
• 候选来自 client sessions.list，显示真实标题 + 状态；子代理会话被过滤（防止误选引发链式派生）
• 选中插入 @会话名 ，Esc 关闭，点击外部关闭
• 从侧边栏拖拽会话到聊天窗自动变成 @会话名

2. xchat_query 工具（profile 全局）

| action | 行为 | |---|---| | start | 解析 @会话名/\会话名 → 目标会话不 live 时 agents.resume 恢复 → subagents.startContinuable({ provider: 'fork' }) 拉起继承目标会话完整记忆的子代理 → 等待其整理回复 | | ask | subagents.followup 向同一子代理追问（保持记忆） | | stop | 打断当前 turn（interrupt）+ 归档删除子代理（可回收站还原） |

设计要点：

• 每个调用方会话对同一目标各分配一个同级专用子代理（callerId + targetId 归属）
• 目标解析排除所有子代理（含 xchat:*），杜绝链式派生
• 每次 start 前全局限定清理孤儿（30 秒限流）：进程重启后遗留的 xchat:* 子代理会被自动归档
• 子代理创建后自动命名 xchat:<目标名>，便于识别与过滤

3. 设置面板（原生设置界面新增「XChat」tab）

• 设置 → XChat：显示工具注册状态与活跃子代理数
• 可配置：enabled（xchat_query 开关）、menuEnabled（@ 菜单开关）、autoCleanup（孤儿自动清理）、waitTimeoutMs（等待回复超时）、子代理模型（auto 继承目标会话 / custom 指定 provider+model）
• 配置持久化到 $DSH_HOME/xchat-config.json，host 经 Typert remote（xchat 服务）读写

安装

⚠️ 依赖安装（必须）：host 半依赖 @deepseek-ai/dsh-typert-protocol。包目录必须能解析它，否则 dsh web 启动即崩（ERR_MODULE_NOT_FOUND）。

cd C:\Users\22320\Desktop\dsh_WS\dsh-plugins\dsh-xchat
npm install          # 生成 node_modules（含 @deepseek-ai/dsh-typert-protocol）

• link 部署：依赖从包目录的 node_modules 解析 → 必须先 npm install。
• 复制部署：把包目录（连同 node_modules）复制到 profile node_modules。

1. 安装包到 profile：

   # 复制（或 link）到 web profile 的 node_modules
   Copy-Item -Recurse C:\Users\22320\Desktop\dsh_WS\dsh-plugins\dsh-xchat C:\Users\22320\.dsh\profiles\web\node_modules\dsh-xchat

   或 link（推荐，改代码即时生效）：

   # 在 profile 目录执行
   pnpm link C:\Users\22320\Desktop\dsh_WS\dsh-plugins\dsh-xchat

2. 在 C:\Users\22320\.dsh\profiles\web\cordis.patch.yml 添加：

   - insert:
       - id: xchat
         name: dsh-xchat

3. 重启 dsh web。设置面板在 设置 → XChat（client 改动刷新页面即可）。

使用

• 输入框任意位置输入 @ → 选择会话 → 发送，例如：

  参考 @会话名 问一下它之前讨论的关键结论

• 模型会调用 xchat_query：start（拉起记忆子代理并询问）→ ask（追问）→ stop（结束并归档删除）

已知限制

• 子代理创建在目标会话名下（父 = 目标会话，继承其完整记忆）；stop 归档后可回收站还原。

源码

• lib/client.js：@ 菜单（候选过滤子代理、拖拽、自绘菜单）、设置面板（settings.section 注册 + Typert remote 描述符 $mount）
• lib/host.js：xchat_query 实现（profile 全局注册；inject 硬依赖等待服务就绪）、xchat Typert 服务（getStatus/getConfig/listModels/setConfig）