Saltar al contenido principal
D

dsh-session-hub

duo121/dsh-session-hub

🐳 Complemento de centro de sesiones para DSH.

Instalar

dsh plugin --profile web add github:duo121/dsh-session-hub

README

dsh-session-hub

dsh-session-hub:跨会话消息、协作专家、自动回执

DSH 会话中心插件:一个 session 工具,读会话清单、逐轮摘要、完整对话,并按 id 新建、改名、发消息、中断、归档、置顶其他会话;会话头部显示协作专家往来指示;消息可要求自动回执。

无需修改 DSH 源码,安装即用。

效果

一次跨会话协作的完整流程:在输入框 @ 一个会话 → 当前智能体把消息真正发过去 → 对方收到并看到来源 → 对方的回复作为回执自动带回。

注意区分:@ 一个会话是读取对方的对话快照作为上下文(只读,对方不会被唤醒);真正把消息发过去、让对方开始干活的是 session 工具的 action=send。

完整流程

跨会话协作流程

① 在输入框 @ 目标会话

输入 @ 会弹出会话选择器,选中后以会话引用的形式插入输入框。

@ 选择会话

② 消息发过去,进入对方会话

session 工具的调用与投递结果出现在会话轨迹里。

session 工具调用

③ 对方看到的来源标注

接收方会话里,消息首行是发送方的会话引用,一眼看出不是用户本人发的。

接收方看到的来源标注

④ 头部协作专家往来指示

会话头部与「N 个子智能体」并列显示「N 个协作专家」。空闲时是协作图标,有协作会话运行中时换成转圈(与 DSH 子智能体/后台任务一致,二者互斥)。

空闲态:协作图标 + 计数 运行态:转圈 + 计数

悬停展开往来列表:按最近往来时间倒序,每行显示方向(→ 我发出的 / ← 我收到的)、标题、相对时间与状态,点击跳转,归档会话保留并标注。

协作专家列表

功能

功能说明
会话浏览列表(标题、轮数、来源、归档/置顶)、逐轮摘要、完整对话文本,按关键词搜正文
会话写操作新建(可同时命名)、改名、发消息、中断、归档、取消归档、置顶、取消置顶
协作专家指示头部显示「N 个协作专家」,悬停列出往来会话(方向、标题、最近往来、状态),点击跳转
自动回执send 传 receipt: true,目标会话这一轮自然结束时,最终回复自动发回本会话
发送方标注消息正文首行是发送方的会话引用标签

安装

# 1. 放到本地插件目录(或任意位置)
cp -R dsh-session-hub ~/.dsh-local-plugins/

# 2. 在 profile 的 package.json 挂载
{
  "dependencies": {
    "@local/dsh-session-hub": "link:~/.dsh-local-plugins/dsh-session-hub"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@local/dsh-session-hub"
      ]
    }
  }
}

重启 dsh web 生效。

本仓库的 package.json 用公开包名 dsh-session-hub;本地挂载时请把 name、cordis.patch.yml 里的包名、以及 client.js 顶部的模块 id 统一改成你实际使用的包名(本地习惯用 @local/dsh-session-hub)。三者必须一致,否则客户端插件会加载失败。

session 工具速查

参数作用
(不传 action)只读:列会话清单;传 session_id 看逐轮摘要;再传 mode(summary/dialog/full)看全文
action=create新建会话(title 可同时命名,cwd 指定工作目录)
action=rename改名(content 即新标题)
action=send发消息(content 必填;receipt: true 要求自动回执;跨工作目录需显式传 cwd)
action=interrupt中断目标当前轮(保留队列)
action=archive / unarchive归档 / 取消归档(归档运行中会话需 confirm: true)
action=pin / unpin置顶 / 取消置顶

安全约束

  • 不能给子智能体会话发消息(子会话由 subagent 路由持有)。
  • 归档会话必须先取消归档才能发消息。
  • 发消息默认只允许同一工作目录,跨目录要显式传 cwd。
  • 不能发给自己:自己不是自己的协作专家,send 到本会话会被直接拒绝,也不计入协作专家列表。
  • A→B→A 回环自动拒绝;同一对会话的自动回执每次进程生命周期只回一次(防循环,进程内账本,重启重置)。

已知限制

  • 循环防护账本是进程内的,宿主重启后同一对会话可再回执一次。
  • receipt 的自动回执只覆盖目标「正常结束」的轮次;被中断或报错的轮次不回执。
  • 归档会话无法直接打开:DSH 对已归档会话不保留会话引用(is released),插件改为标注「已归档」并在点击时提示先取消归档,不会擅自改动你的归档状态。

目录结构

dsh-session-hub/
├── index.js          # session 工具 + 协作专家投影 + 自动回执
├── client.js          # 头部协作专家指示(计数 + 悬停列表)
├── package.json       # 清单(exports、dsh.client 配置)
├── cordis.patch.yml   # bundle 挂载声明
├── locale/            # zh / en 词典
├── docs/
│   ├── DETAIL.md      # 插件详情(英文)
│   ├── DETAIL.zh.md   # 插件详情(中文)
│   └── screenshots/   # 文档截图
└── icon.svg

联系与交流

用的时候遇到问题、有想法想聊,或者想看看别人怎么用,都欢迎来交流。

  • 微信:jianduo1(加我时说一声 dsh-session-hub,方便我备注)
  • 智能体交流群:加微信后我拉你进群,一起聊 DSH 插件、跨会话协作这些玩法
  • 提问题 / 提需求:Issues,欢迎 PR

License

MIT

Plugins relacionados