Skip to content
Back to search

dsh-session-messaging

DeepSeek Harness plugin: let top-level sessions find, message, and spawn each other (session_list / session_send_message / session_create) · 支持一句话让 DSH 自动安装

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tonyzdev--dsh-session-messaging/badge.svg)](/listings/tonyzdev--dsh-session-messaging)

HTML

<a href="/listings/tonyzdev--dsh-session-messaging"><img src="/api/listings/tonyzdev--dsh-session-messaging/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**需要**:DeepSeek Harness `0.2.0+`(已在 macOS 版 `0.2.1-rc.5` 上实测)。插件本身不调用模型,不需要额外的 API key。

方式一:发一句话让 DSH 自己安装(推荐)

把下面这句话直接复制发给任意 DSH 会话,agent 会自动识别桌面端或网页端完成安装并热加载:

请帮我在当前 DSH profile 安装插件 https://github.com/tonyzdev/dsh-session-messaging:若有 plugin_manager 工具请直接调用 install_bundle 安装并启用;否则读取当前 profile 名(bash 为 $DSH_PROFILE,PowerShell 为 $env:DSH_PROFILE;为 desktop 时调用 app.asar 同级 runtime/cli/bin 下的 dsh 或 dsh.cmd,其他情况用 PATH 中的 dsh,受沙箱限制时申请全盘权限审批)执行 dsh plugin --profile <profile> add github:tonyzdev/dsh-session-messaging,不要手改配置文件或重启宿主。

方式二:在「插件」页手动安装

在 Harness 侧栏打开 **插件 → 添加插件**,填入下面的仓库地址,点击 **安装** 后再点 **立即启用** 即可使用(若聊天里的转发气泡样式尚未出现,按 `⌘R` / `Ctrl+R` 刷新页面):

https://github.com/tonyzdev/dsh-session-messaging

> [!IMPORTANT] > 安装时请填入上面的完整 GitHub 仓库地址,**不要**输入不带前缀的 `dsh-session-messaging`(npm 上同名无前缀包由其他作者维护;本插件安装后的包名为 `@tonyzdev/dsh-session-messaging`)。

<details> <summary><b>用命令行安装、离线包安装或移除</b></summary>

<br>

**网页端(`dsh web`)**:

dsh plugin --profile web add github:tonyzdev/dsh-session-messaging

**桌面端(DSH Desktop,支持在应用运行时首次热装)**:

macOS:

DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$DSH" plugin --profile desktop add github:tonyzdev/dsh-session-messaging

Windows(PowerShell):

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:tonyzdev/dsh-session-messaging

> 注意:在装有 DSH Desktop 的电脑上如果运行 `--profile web`,插件只会装进 `profiles/web`,不会出现在桌面端界面里;桌面端请使用上面的内置 CLI 指向 `--profile desktop`,或直接在界面「插件 → 添加插件」中安装。

**预打包 Release `.tgz` 直装(无需拉取完整 Git 仓库)**:

dsh plugin --profile web add https://github.com/tonyzdev/dsh-session-messaging/releases/download/v0.3.2/tonyzdev-dsh-session-messaging-0.3.2.tgz

**本地开发(以链接方式安装,改代码直接作用于该副本)**:

git clone https://github.com/tonyzdev/dsh-session-messaging ~/.dsh/local-plugins/dsh-session-messaging
"$DSH" plugin --profile desktop add link:$HOME/.dsh/local-plugins/dsh-session-messaging

**移除**:在「插件」页卸载,或运行:

"$DSH" plugin --profile desktop remove @tonyzdev/dsh-session-messaging

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 213 lines
  1. <div align="center">
  2. <img src="icon.svg" width="88" alt="">
  3. # dsh-session-messaging
  4. **让会话之间互相发消息** —— 一个会话可以找到另一个会话、给它发消息,或者新开一个会话交代任务;对方用同样的方式回复。
  5. <img src="https://img.shields.io/badge/DeepSeek_Harness-社区插件-4d6bfe?style=flat-square" alt="DeepSeek Harness 社区插件">
  6. <img src="https://img.shields.io/badge/DSH-0.2.0%2B-4d6bfe?style=flat-square" alt="支持 DSH 0.2.0+">
  7. <img src="https://img.shields.io/badge/新增工具-3_个-4d6bfe?style=flat-square" alt="新增 3 个工具">
  8. <img src="https://img.shields.io/badge/license-MIT-555?style=flat-square" alt="MIT 许可证">
  9. **中文** · [English](README.en.md)
  10. [功能](#功能) · [安装](#安装) · [用法](#用法) · [设置](#设置) · [工作原理](#工作原理) · [已知限制](#已知限制)
  11. </div>
  12. <br>
  13. [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 社区插件。DSH 自带的消息通道都要求双方有关系:`send_message` 只在直接父子 agent 之间传递,Agent Teams 只在同一个 Team 的成员之间传递,侧栏里两个普通会话之间没有路。装上本插件后,每个顶层会话多了三个工具:找会话、发消息、开新会话。收到的消息会标明来自哪个会话,对方可以用同一个工具回复。
  14. <p align="center">
  15. <img src="docs/demo.gif" width="932" alt="会话「整理发布说明」让 agent 去问会话「修复登录超时」;对方收到一条标着「来自会话「整理发布说明」」的消息,用同一个工具回复,回复回到原会话">
  16. </p>
  17. <p align="center"><sub>「整理发布说明」里的 agent 用 <code>session_list</code> 找到「修复登录超时」,用 <code>session_send_message</code> 发出问题。对方被唤醒并回复,回复又唤醒了原会话。</sub></p>
  18. ## 功能
  19. - 🔎 **找会话** — `session_list` 按最近活跃列出可以发消息的会话:id、运行中 / 空闲、标题。默认只看当前工作区,也可以列出全部工作区或按标题搜索。
  20. - ✉️ **发消息** — `session_send_message` 把消息送到另一个会话:正在运行的会话在下一步读到,空闲的会话立即开始新一轮,已存储(未加载)的会话先恢复再处理。
  21. - 🆕 **开新会话** — `session_create` 在侧栏新开一个带标题的会话,用你的消息开始第一轮。新会话独立干活,看不到发起方的对话;消息里让它回报,它就会回报。
  22. - 🏷️ **标明来源** — 收到的消息显示为用户侧气泡,上方写着「来自会话「标题」」。模型看到的是一行来源说明:哪个会话、由对方的 agent 而不是用户撰写、怎么回复。
  23. - 🔁 **不会互相客套** — 来源说明提醒对方不要只为确认收到而回复,两个会话不会来回说「收到」「好的」停不下来。
  24. - 🛡️ **有边界** — 不能发给自己、子 agent 会话或已归档的会话;单条消息上限 64 KB;每个会话每次运行最多开 10 个新会话;子 agent 看不到这三个工具。
  25. ## 安装
  26. **需要**:DeepSeek Harness `0.2.0+`(已在 macOS 版 `0.2.1-rc.5` 上实测)。插件本身不调用模型,不需要额外的 API key。
  27. ### 方式一:发一句话让 DSH 自己安装(推荐)
  28. 把下面这句话直接复制发给任意 DSH 会话,agent 会自动识别桌面端或网页端完成安装并热加载:
  29. ```text
  30. 请帮我在当前 DSH profile 安装插件 https://github.com/tonyzdev/dsh-session-messaging:若有 plugin_manager 工具请直接调用 install_bundle 安装并启用;否则读取当前 profile 名(bash 为 $DSH_PROFILE,PowerShell 为 $env:DSH_PROFILE;为 desktop 时调用 app.asar 同级 runtime/cli/bin 下的 dsh 或 dsh.cmd,其他情况用 PATH 中的 dsh,受沙箱限制时申请全盘权限审批)执行 dsh plugin --profile <profile> add github:tonyzdev/dsh-session-messaging,不要手改配置文件或重启宿主。
  31. ```
  32. ### 方式二:在「插件」页手动安装
  33. 在 Harness 侧栏打开 **插件 → 添加插件**,填入下面的仓库地址,点击 **安装** 后再点 **立即启用** 即可使用(若聊天里的转发气泡样式尚未出现,按 `⌘R` / `Ctrl+R` 刷新页面):
  34. ```text
  35. https://github.com/tonyzdev/dsh-session-messaging
  36. ```
  37. > [!IMPORTANT]
  38. > 安装时请填入上面的完整 GitHub 仓库地址,**不要**输入不带前缀的 `dsh-session-messaging`(npm 上同名无前缀包由其他作者维护;本插件安装后的包名为 `@tonyzdev/dsh-session-messaging`)。
  39. <details>
  40. <summary><b>用命令行安装、离线包安装或移除</b></summary>
  41. <br>
  42. **网页端(`dsh web`)**:
  43. ```sh
  44. dsh plugin --profile web add github:tonyzdev/dsh-session-messaging
  45. ```
  46. **桌面端(DSH Desktop,支持在应用运行时首次热装)**:
  47. macOS:
  48. ```sh
  49. DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
  50. "$DSH" plugin --profile desktop add github:tonyzdev/dsh-session-messaging
  51. ```
  52. Windows(PowerShell):
  53. ```powershell
  54. & "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:tonyzdev/dsh-session-messaging
  55. ```
  56. > 注意:在装有 DSH Desktop 的电脑上如果运行 `--profile web`,插件只会装进 `profiles/web`,不会出现在桌面端界面里;桌面端请使用上面的内置 CLI 指向 `--profile desktop`,或直接在界面「插件 → 添加插件」中安装。
  57. **预打包 Release `.tgz` 直装(无需拉取完整 Git 仓库)**:
  58. ```sh
  59. dsh plugin --profile web add https://github.com/tonyzdev/dsh-session-messaging/releases/download/v0.3.2/tonyzdev-dsh-session-messaging-0.3.2.tgz
  60. ```
  61. **本地开发(以链接方式安装,改代码直接作用于该副本)**:
  62. ```sh
  63. git clone https://github.com/tonyzdev/dsh-session-messaging ~/.dsh/local-plugins/dsh-session-messaging
  64. "$DSH" plugin --profile desktop add link:$HOME/.dsh/local-plugins/dsh-session-messaging
  65. ```
  66. **移除**:在「插件」页卸载,或运行:
  67. ```sh
  68. "$DSH" plugin --profile desktop remove @tonyzdev/dsh-session-messaging
  69. ```
  70. </details>
  71. ## 用法
  72. 不用记工具名,直接告诉 agent 要做什么:
  73. > 问问「修复登录超时」那个会话:bug 修好了吗?改了什么?
  74. >
  75. > 告诉「前端重构」那个会话:接口字段 `user_id` 改名为 `uid` 了。
  76. >
  77. > 开一个新会话,让它把这条修复写进 CHANGELOG.md,写完告诉我。
  78. <p align="center">
  79. <img src="docs/create.gif" width="932" alt="会话「整理发布说明」用 session_create 新开会话「写 CHANGELOG 登录超时修复」;新会话写好 CHANGELOG.md 后回报「已写入」,原会话收到结果">
  80. <br>
  81. <sub>新开的会话出现在侧栏,带着任务开工;写完后用 <code>session_send_message</code> 回报,原会话收到结果。</sub>
  82. </p>
  83. | 工具 | 参数 | 作用 |
  84. | --- | --- | --- |
  85. | `session_list` | `query?` `all_workspaces?` `limit?` | 按最近活跃列出可以发消息的顶层会话 |
  86. | `session_send_message` | `session_id` `message` `delivery?` | 发消息;`delivery: "queue"` 等对方这一轮结束后再开新一轮 |
  87. | `session_create` | `title` `message` `workspace?` | 新开会话并用消息开始第一轮;`workspace` 填 `session_list` 显示的绝对路径 |
  88. 工具只返回送达确认,不返回对方的回答;回答会作为一条新消息回到发送方会话。
  89. ## 设置
  90. | 字段 | 默认值 | 说明 |
  91. | --- | :---: | --- |
  92. | `crossWorkspace` | `true` | 是否允许列出其他工作区的会话、给它们发消息、在其他工作区新开会话;`false` 只限当前工作区 |
  93. | `maxMessageBytes` | `65536` | 单条消息的大小上限,包括来源说明 |
  94. | `listLimit` | `20` | `session_list` 默认返回的条数,最多 100 |
  95. | `createLimit` | `10` | 一个会话在一次运行内最多新开的会话数 |
  96. > [!TIP]
  97. > 要改的话,在 profile 的补丁文件(桌面版是 `~/.dsh/profiles/desktop/cordis.patch.yml`)里加一行,只写要改的字段,没写的用默认值:
  98. >
  99. > ```yaml
  100. > - id: session-messaging
  101. > config:
  102. > crossWorkspace: false
  103. > ```
  104. >
  105. > 保存后生效;如果没有生效,重启 DeepSeek Harness。
  106. ## 工作原理
  107. ```mermaid
  108. sequenceDiagram
  109. participant A as 会话 A
  110. participant P as 本插件
  111. participant B as 会话 B
  112. A->>P: session_send_message(B, 问题)
  113. P->>B: 转发消息,标明来自会话 A
  114. Note over B: 运行中:下一步读到<br/>空闲:开始新一轮<br/>已存储:先恢复
  115. B->>P: session_send_message(A, 回复)
  116. P->>A: 转发消息,标明来自会话 B
  117. ```
  118. <p align="center"><sub>转发的消息写进对方的会话日志;模型看到来源说明,界面显示带来源标注的气泡。</sub></p>
  119. | 文件 | 位置 | 作用 |
  120. | --- | :---: | --- |
  121. | `lib/index.js` | Host | 三个工具、消息转发、对子 agent 隐藏工具 |
  122. | `lib/client.js` | 浏览器 | 把转发的消息画成用户侧气泡,并标注来源会话 |
  123. | `cordis.patch.yml` | 补丁 | 插件行和默认配置 |
  124. | `locale/*.json`、`icon.svg` | 元数据 | 「插件」页显示的名称、描述和图标 |
  125. <details>
  126. <summary><b>实现细节</b></summary>
  127. <br>
  128. - 发消息走 `sessionController.resolveAgent`,与网页端发送 prompt 是同一条路径,必要时从存储冷恢复会话。消息带 DSH 内置的转发来源 `{ kind: 'agent-message', form: 'relay', senderSessionId }`,写进对方的会话日志。
  129. - 开新会话走 `sessionController.create({ workspaceId })`,也就是网页端「新对话」的路径;在第一轮开始前先改好标题,因为转发的消息不会触发 DSH 的自动起标题。
  130. - 两者都在 `withoutInitiator` 里执行:对方是独立的顶层会话,不算发送方这一轮发起的子任务。
  131. - 来源说明以空行结尾,因为相邻的文本块到模型那里会直接拼接在一起。
  132. - 子 agent 在 `agent/created` 时通过 `agent.ctx.tools.restrict({ deny })` 隐藏这三个工具:它们无法通过这条通道收到回复。
  133. - 浏览器端覆盖 Chat 的 `turn-trigger` 渲染器,只接管本插件转发的消息,复用 DSH 自带的 `conversation.chat.user.content` 气泡;目标、定时任务、子 agent 等其他触发消息仍用 DSH 自带的卡片。只改显示,模型收到的内容不变。
  134. </details>
  135. ## 已知限制
  136. > [!CAUTION]
  137. > **被唤醒或新开的会话按它自己的设置运行。** 新开的会话使用默认模型和默认审批策略(实测为 `ask`),不继承发起会话的设置。它如果需要审批,审批请求会停在那个会话里,可能没人在看。
  138. - 只在顶层会话之间通信;子 agent 和 Team 成员仍用 DSH 自带的 `send_message`。
  139. - 「送达」只代表对方的收件箱接受了消息,不代表已经处理;没有重试、去重或已读回执。
  140. - 对方正在运行时收到的消息会并入它这一轮,模型能收到,但不会显示成气泡。只有唤醒会话的消息显示为气泡。
  141. - 气泡里不渲染 Markdown,也不折叠很长的消息。
  142. - 发消息没有频率限制,防止来回客套靠的是来源说明里的提示。`createLimit` 存在内存里,插件重新加载或重启后清零,也不限制「A 开 B、B 再开 C」这样的链条。
  143. - `session_create` 设的标题像手动改名一样被固定,DSH 之后不会再自动改标题。
  144. ## 开发
  145. ```sh
  146. node --test test/*.test.js
  147. ```
  148. 测试用模拟的 Harness 上下文覆盖投递、开新会话、各种拒绝路径、列表过滤、对子 agent 隐藏工具,以及浏览器端能否解析 Host 写出的来源说明(两边改动不同步会在这里失败)。
  149. > [!NOTE]
  150. > 修改 `lib/index.js` 后,在「插件」页把本插件关掉再打开即可加载新代码,不用重启;修改 `lib/client.js` 后需要重新安装并刷新页面。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.