yoyume374/dsh-agent-mail ↗★ 1

dsh-agent-mail

DSH 会话之间的 agent 邮件:发信即唤醒对方(离线会话也会先加载),回信按线程在会话上方「邮件」页签查看

패키지
dsh-agent-mail
호환성
미검증
Harness peer 범위
*
Cordis peer 범위
~4.0.4
버전
0.3.8
라이선스
MIT
최근 업데이트
2026. 11. 15.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:yoyume374/dsh-agent-mail

dsh-agent-mail — DSH 会话之间的 agent 邮件

给另一个会话的 agent 发一封信,它会被直接唤醒:在线的立刻开一轮,没打开的会话也会先加载再唤醒。对方读完可以马上回信,你在会话上方的「邮件」页签里按线程看全部往来。

  • 自动唤醒:发信即触发,不需要切换会话、不需要手动转发;离线会话同样会被拉起。
  • 线程视图:「邮件」页签按往来分卡,标出方向、回复的是哪封、对方读没读。
  • 可调策略:唤醒开关、离线唤醒、限流、容量都在插件页改,立即生效。

怎么工作

  1. 写入邮箱:agent_mail_send 追加到 /mailbox.jsonl(默认 ~/.dsh/agent-mail)。
  2. 唤醒(默认开,核心):宿主用 agent.followup 让收件方开一轮;对方没打开时先经 sessionController.resolveAgent 加载会话再唤醒(返回 resumed: true)。唤醒在聊天里只是一行默认折叠的「收到任务消息」,点开才看到通知原文。
  3. 读信:收件方用 agent_mail_read 取正文。每轮系统提示词里另有一节 agent-mail,只列未读的 id / 发件人 / 主题,读完为空;正文不作为聊天消息出现。
  4. 页签:客户端在 conversation.view 注册「邮件」页,经 /api 的 agentMail 命名空间读同一个邮箱。按线程分卡,标出「→ 发出 / ← 收到」、回复的是哪封、以及「已发出 / agent 已读 / agent 未读」。对象名用会话标题(侧边栏可改名的那个),取不到才退化成工作区目录名、会话 id。
  5. 已读只由 agent 决定:页签展开正文不会标已读,只有 agent_mail_read / agent_mail_ack 才算;没有「全部已读」按钮。
sequenceDiagram
  participant A as 会话 A(发送方)
  participant M as mailbox.jsonl
  participant D as DSH 宿主
  participant B as 会话 B(接收方)
  participant T as 「邮件」页签
  A->>M: agent_mail_send 写入
  M->>D: 每轮系统提示词里的未读摘要
  D->>B: followup 唤醒(在线,或离线先加载)
  B->>B: agent_mail_read → 处理任务
  B->>M: 回信(replyTo 延续线程)
  M-->>T: 线程视图,peek 不改已读

整条链路是「落盘 → 唤醒 → 读信 → 回信」:对方不需要你先转发,也不等你把它点开。

工具

工具作用
agent_mail_send发信;replyTo 延续线程;wake 覆盖本次是否唤醒
agent_mail_list列收件箱 / 已发件(默认 20,最多 200)
agent_mail_read读正文并标已读(只能读发给本会话的)
agent_mail_ack批量标已读,不打印正文
agent_mail_peers可投递的会话:在线在前,带 lastActivityAt
agent_mail_wait同轮等一封新邮件,事件驱动,默认 60s、上限 280s;不改已读

等回信

  • 首选:发完就结束本轮。 对方回信会唤醒你开新一轮,零等待、不占工具调用。
  • 必须同轮拿到答复时用 agent_mail_wait:对方一发信立刻返回(不是轮询),开始等之前会先看已有未读,所以「回信已落盘才调 wait」也不会白等。
  • 顺序:用户主任务优先,邮件排在当前步骤之后;例外是这一步正被这封回信阻塞,那就直接处理。判据是「是否被阻塞」,不是「谁优先」。
  • 纯邮件轮只回一行摘要,不贴回执、不复述正文;只有当这封邮件是当前任务的一部分时才展开说明。

设置

两个入口改同一份设置:① 侧栏 插件 → 已安装插件 → dsh-agent-mail → 点行标题 agent-mail(标题变可点、右侧出现 ›);② 「邮件」页签右上角 设置。改完立即生效、不用重启,存在 /settings.json,优先于 profile 配置;单项「用配置值」或「全部恢复配置值」可清除覆盖。

配置项默认含义
wakeOnSendtrue发信后是否唤醒收件方;单次可用 wake:false
wakeOfflinetrue收件方没打开时先加载会话再唤醒;关掉则只投递
ratePerMinute6同一对会话每分钟最多几封
ratePerSessionMinute20单个会话每分钟最多收几封
maxDepth5回复链最深几层,超过要求 agent 先问用户
maxMailbox500每会话保留几封,先丢最老的已读
bodyLimit8000单封正文最大字符数
promptPreview5提示词摘要里最多列几封未读
dataDir/agent-mail邮箱目录

也可以直接写 profile 的 cordis.patch.yml(改完需重启):

- id: agent-mail
  config:
    wakeOnSend: false
    ratePerMinute: 10

边界

  • 代价:唤醒意味着对方自己开一轮、读信、可能回信,全程无人工确认,会消耗 token。
  • 防互刷:maxDepth + 每分钟限流兜底;要彻底静默就把 wakeOnSend 关掉,需要时单次 wake:true。没有每小时唤醒上限。
  • 离线:未打开的会话会被 sessionController.resolveAgent 加载后唤醒(返回 resumed: true);已归档会话仍需先恢复。对方在跑长任务时,唤醒排在当前轮之后。
  • 来源信封:read / wait 的正文包在 【agent 邮件 · 来自 名称(会话id) · 时间 · id=…】 里。历史被压缩后结构化来源会丢,提示词要求压缩时保留来源与 id;邮箱原件 mailbox.jsonl 永久保留,随时可重读。

兼容性

在 DSH 0.2.2-rc.3 + desktop profile(Windows) 上验证。依赖的是 DSH 内部接口:宿主侧的 ctx.tools / ctx.systemPrompt / sessionController / sessionQuery,客户端槽位 conversation.view、plugins.row.config,以及 TypertRemoteService 的 @Remote。DSH 升级可能改动它们,插件不一定自动跟随;升级 DSH 后先跑一遍单测与 smoke,再实际收发一封邮件确认。

安装

dsh plugin --profile desktop add "file:/dsh-agent-mail"

装完重启 DSH(关掉再打开):宿主插件、页签、配置入口都在进程启动时装配,只刷新页面不保证换到新 bundle。

本地改代码必须 remove + add:file: 依赖是拷贝进 profile 的,直接 add 是 no-op。

dsh plugin --profile desktop remove dsh-agent-mail
dsh plugin --profile desktop add "file:/dsh-agent-mail"

确认拷贝已换新:对比本目录与 ~/.dsh/profiles/desktop/node_modules/dsh-agent-mail/lib/client.js 的 md5sum。

安装别人的仓库:克隆后把克隆目录加进 profile 即可(不要把仓库放进 DSH 安装目录,升级会删除):

git clone https://github.com/yoyume374/dsh-agent-mail.git
dsh plugin --profile desktop add "file:/dsh-agent-mail"

页签若显示「当前视图没有会话身份」,说明 conversation.view 的 inject(sessionId) 没拿到会话 id:先确认拷贝是最新,再刷新页面。

测试

node --test test/store.test.mjs test/schema.test.mjs test/service.test.mjs test/settings.test.mjs

覆盖邮箱读写与裁剪、回复链深度、限流、设置覆盖层、schema 方言、RPC 服务层。沙箱 smoke 需要 DSH 的宿主桩,不在本仓库内(开发环境的工作区根 .smoke/plugin):cp dsh-agent-mail/lib/*.js .smoke/plugin/lib/ && cd .smoke/plugin && node smoke.mjs,另覆盖唤醒通知形状、离线唤醒、wakeOffline 开关与会话标题。

许可证

MIT,见 LICENSE。