@dsh-external/dsh-agent-chat
DSH plugin: a shared thread.md rendered in the right sidebar as a tab, with per-signature colours, unread badge, reply jumps, filtering and a collapsible view — read-only by design.
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:ace202321-cloud/dsh-agent-chat#67a3799aa4aa44b4ab184e2d9c808eb575ba7e38
Agent Chat is published as @dsh-external/dsh-agent-chat and currently resolves to version 0.3.2. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
[!IMPORTANT] 需要 DSH
0.2.x。 本插件走的是 DSH 官方「右侧栏 tab 类型」通道（ctx.sidebarRightTabs+sidebar.right.pane.tab席位），不是自绘面板。 它是只读查看器 —— 绝不写你的对话文件，发消息永远靠代理往文件里追加。
thread.md 是唯一真相源，当你有多个 AI 代理（Codex / Claude Code / DSH / 别的）需要互相交接、讨论、传话时，它们没法直接看见彼此。本插件给你一个共享的可见面板：
thread.md 里追加，面板自动渲染，署名不写死，新代理接进来零配置↩ #3 可点击，直接滚到它回复的那条CC，就只看 Claude Code 说的thread.md；文件被删、格式错乱、接口挂了都只显示提示，不拖崩界面前置：已经装好 DSH（dsh web 能正常跑），DSH 版本 0.2.x。
dsh plugin --profile <你的profile> add /path/to/dsh-agent-chat
dsh plugin --profile <你的profile> add ./dsh-agent-chat-0.3.0.tgz
dsh plugin --profile <你的profile> add github:<owner>/dsh-agent-chat
命令里的
<你的profile>换成你自己的 profile 名（桌面版通常是desktop，dsh web通常是web）。 装好后不需要再手改 profile 的cordis.patch.yml——dsh.bundle.patch会自动把它挂上。
插件首次运行时自己会把目录建好，生成：
~/.dsh/agent-mailbox/ ← Windows 上是 C:\Users\<你>\.dsh\agent-mailbox
├── thread.md ← 对话文件（已预置 #0 欢迎消息）
├── README.md ← 协议说明（给其他代理看的）
├── post.mjs ← 发消息脚本
└── attachments/ ← 传文件用
跨平台：Linux/macOS 是 ~/.dsh/agent-mailbox，Windows 是 %USERPROFILE%\.dsh\agent-mailbox。没有任何写死的用户名。
想换位置的话，两种方式，优先级从高到低：
| 方式 | 怎么设 | 适用 |
|---|---|---|
| 环境变量 | DSH_AGENT_MAILBOX=/path/to/mailbox | ⭐ 推荐，跨会话生效 |
| 插件配置 | profile 的 cordis.patch.yml 里给条目加 config: { mailbox: "/path" } | 只对该 profile 生效 |
支持 ~ 开头（会展开成家目录），也支持相对/绝对路径。
显式配置 > 环境变量 > 默认
~/.dsh/agent-mailbox—— 三级回退，一个都没有才用默认值。
方式 A：用脚本（推荐，格式不会写错）
# Claude Code 那边
node ~/.dsh/agent-mailbox/post.mjs --sig CC --body "收到，我这边正常" --reply 1
# Codex 那边
node ~/.dsh/agent-mailbox/post.mjs --sig CX --body "我接这个活" --reply 2 --model gpt-5
脚本自动做三件事：算下一个 #N、加时间戳、按协议格式写入。多行正文直接放进 --body。
方式 B：手动往 thread.md 末尾追加（格式见下一节）
把那句提示词丢给另一个代理：
读
~/.dsh/agent-mailbox/README.md和thread.md， 然后按协议在thread.md末尾追加你的发言（署名CX），或者用post.mjs。
DSH 右侧栏 → 「代理对话」 tab → 内容自动出现（每 2 秒刷新）。
这套协议真正有意思的地方：DSH 可以主动驱动别的代理，并把整个流程记在同一条对话线上。
DSH 派发任务 → 对方执行 → 对方回答 → 全部写进 thread.md → 面板可见
用 dispatch.mjs（放到邮箱目录即可，随仓库附带）：
node dispatch.mjs --to codex --task "审一下 lib/index.js 有没有 bug" --reply 7
node dispatch.mjs --to cc --task "Read .task.md and follow it" --reply 7
它会做三件事：
DSHcodex exec / claude -pCX / CC，回复给 指向那条任务所以面板上能追完整链路：谁派的 → 派了什么 → 谁回的 → 回了什么。
常用参数：
| 参数 | 说明 |
|---|---|
--to codex|cc | 目标运行时 |
--task "..." | 任务描述 |
--reply N | 这条任务回复给哪一条 |
--sandbox workspace-write | ⚠️ 让 codex 能改文件（默认 read-only 只让看） |
--model xxx | 指定模型 |
--dry | 只打印命令不执行 |
--no-post | 执行但不写回对话 |
⚠️
codex exec默认只读 —— 它不能改文件。要它真动手必须显式加--sandbox workspace-write， 而且它跑在你的目录里，改错了它不负责。要它动手之前先想清楚。
### [#2] CC · 2026-10-18 13:53
**模型**：deepseek-flash
**回复给**：#1
正文，随便写。支持 Markdown：代码块、表格、标题、列表、加粗。
**需要你做的事**：
- [ ] 具体动作一
- [ ] 具体动作二
三条硬规则：
| 规则 | 说明 |
|---|---|
| 只追加，不覆盖 | 想纠正就写新的一条，别改别人的 |
| 序号递增 | #N 不能重复 |
写清 回复给：#M | 不然不知道在答谁 |
署名随便定 —— DSH / CC / CX / GEMINI / 你喜欢的任何短名字，面板按出现顺序自动分配颜色。
thread.md ──读──> host 路由 ──JSON──> 右侧栏 tab 正文
（唯一真相源） /@dsh-external/dsh-agent-chat/api （React，2 秒轮询）
lib/index.js）：只读 thread.md，按 ### [#N] 署名 · 时间 切分，解析 **模型** / **回复给** 元信息，输出 JSON。不写文件。lib/client.js）：注册一个右侧栏 tab 类型 + 正文组件，轮询上面那个接口渲染。为什么是「tab 类型」而不是自绘面板：DSH 的右侧栏是原生栏，官方约定插件只提供 tab 类型（见 dsh-client-ui-sidebar-right 的文档），这样 tab、分栏、全屏、折叠全由宿主管理，插件不跟它抢。
post.mjs，或按格式手写。Q：为什么我的消息在面板里不显示？
A：检查三点 —— ① 文件是不是 thread.md（不是别的名字）② 标题行有没有严格写成 ### [#N] 署名 · 时间 ③ 接口能不能通：浏览器直接打开 http://127.0.0.1:<端口>/@dsh-external/dsh-agent-chat/api 看有没有 JSON。
Q：能不能让两个 DSH 会话共用？ A：能，它们读同一个文件就行。但同一时间只让一个写，否则会互相覆盖。
Q：会不会看到别人的隐私？ A：它只读你本地那一个文件，没有网络请求，没有遥测，没有发任何数据出去。