dsh-mail-command
快速跳转：前置要求 · 安装 · 配置 · 兼容性 · 遇到问题 · 相关插件
用邮件指挥 DeepSeek Harness：回复一封通知邮件，就能让正在跑的任务继续或停止，正文可以写具体要求。
它是 dsh-qq-mail-notify 的附属插件——那个负责发信，这个负责收信。必须两个都装；原因和两者的实际关系只在下面的「前置要求」里说一次，别处不再复述。
前置要求
本插件必须搭配 dsh-qq-mail-notify 一起使用，单独装它没有任何效果。
原因很直接：它自己不发送任何邮件。一次性口令是随通知邮件一起发出去的，你回复的也是那封邮件。没有发信侧，你的收件箱里就不会出现带口令的邮件，也就没有东西可以回复，整个功能等于不存在。
依赖是一边倒的：通知插件可以单独用（纯提醒，不装本插件也完整）；本插件单独装则完全空转。代码上两者互不 import、走 cordis 服务协作，所以升级其中一个不必同步另一个——但功能上本插件离不开通知插件。
正确用法是两个都装：
dsh plugin --profile desktop add github:yashua233/dsh-qq-mail-notify
dsh plugin --profile desktop add github:yashua233/dsh-mail-command
装好后在通知插件的设置里填好发件邮箱与 SMTP 授权码（本插件复用同一份凭据），发一封测试邮件确认能收到，再回复它试试。
它解决什么问题
任务跑到一半因为额度不足停住，你充完钱还得回到电脑前重新说一遍；或者一个任务明显跑偏了，你只能等它结束。装上这个插件之后：
- 通知邮件里带上一次性口令；
- 你直接在手机上回复那封邮件，写「继续」，任务接着跑；
- 写「停止」，当前这一轮立刻中断；
- 写「继续，但把测试也跑一遍」，这句话原样成为给 agent 的新输入。
安装
# 从 GitHub
dsh plugin --profile desktop add github:yashua233/dsh-mail-command
# 本地目录
dsh plugin --profile desktop add link:/path/to/dsh-mail-command
desktop 是桌面端默认的 profile 名，用你自己的那个（~/.dsh/profiles/ 下能看到的目录名）。装完重启一次生效。
建议与通知插件一起装：
dsh plugin --profile desktop add github:yashua233/dsh-qq-mail-notify
怎么用
-
装好并重启，确认 dsh-qq-mail-notify 已经配好发件邮箱和 SMTP 授权码（同一套凭据本插件复用）；
-
之后每次通知邮件末尾都会附上：
可用指令（直接回复本邮件，保留主题里的 [CONT:AB12CD34]）：
· 继续 —— 正文写要继续做的事；只写「继续」就按原计划接着干
· 停止 —— 正文写「停止」或 stop，立刻中断当前这一轮
-
回复那封邮件即可。主题里的口令要保留（邮件客户端默认会保留），正文写你要它做什么。
指令怎么判定
| 你回的正文 | 结果 |
|---|
| 空 | 按原计划继续 |
继续 | 继续 |
停止 / stop / 取消 | 停止当前轮 |
停止，剩下的别改了 | 停止（后半句记进日志） |
继续，但把测试也跑一遍 | 继续，要求 = 整句原文 |
把 README 补完再提交 | 继续，要求 = 这句 |
引用区（> 开头的行、-----原始邮件----- 之后的内容）会自动剥掉，不会被当成指令的一部分。
收件节奏（三段自适应）
刚发出通知时你最可能就在手机旁边，所以前 10 分钟查得勤；越往后越稀疏；超过 30 分钟基本不会回了，干脆停下，等下一封邮件发出时再被唤醒。
| 字段 | 默认 | 说明 |
|---|
fastWindowMs | 600000 | 快速窗口长度（10 分钟） |
fastIntervalMs | 5000 | 快速窗口内每隔多久查一次（5 秒） |
slowIntervalMs | 600000 | 超过快速窗口后每隔多久查一次（10 分钟） |
stopAfterMs | 1800000 | 超过这个时间就暂停检测（30 分钟），新邮件发出时自动唤醒 |
想更快可以调小 fastIntervalMs（比如 2000），但 QQ 邮箱有 IMAP 频率限制，设太小会被重连。mail_command action=status 会告诉你当前处于哪一档。
安全设计
为什么必须带口令：SMTP 的发件人地址是可以伪造的。如果只按 From 判断，任何知道你邮箱的人伪造一封「继续」就能让 agent 跑起来——而 agent 有完全的文件权限。所以：
- 口令随邮件主题发出，长度 8 位、一次性、命中即作废；
- 同一个对话共用一个口令：只要那串还没被回复过，后续通知继续复用它，所以同一会话的邮件里带的是同一个口令；
- 口令存活 30 分钟（
tokenTtlMs），并且每发一封通知就重新计时——回复最近收到的那封一定来得及；
- 校验顺序是「发件人必须在允许列表内」且「口令存在、未被用过、未过期」，三条同时成立才动作；
- 口令落盘（
$DSH_HOME/mail-command-tokens.json），DSH 重启后仍可用，不必重新发信。
配置
复用发件插件的凭据，不需要重复填。自己的可选项写在 $DSH_HOME/mail-command.json：
| 字段 | 默认 | 说明 |
|---|
enabled | true | 总开关；关掉后不再轮询收件 |
traceImap | false | 打开后把 IMAP 收发过程打进日志，排障用 |
旧配置里的 intervalMs 已被移除，留着不会有任何作用——实际节奏看上面那三个 fastWindowMs / fastIntervalMs / slowIntervalMs / stopAfterMs。
| host / port | imap.qq.com / 993 | IMAP 服务器，端口即隐式 TLS。不填时按 user 的域名自动推断服务商（QQ / 腾讯企业邮 / 163 / 126 / yeah / Gmail / Outlook），认不出的域名保持 QQ 默认 |
| tokenTtlMs | 1800000 | 口令存活期（30 分钟）。每发一封通知都会把计时重置，所以「回复最近那封」总是有效 |
| user / authCode | 取自通知插件 | 想用另一个邮箱收信时才需要填 |
邮箱凭据默认从 $DSH_HOME/qq-mail-notify.json 读；单独配了 user / authCode 就以自己的为准。服务商同上：主机没配过时按邮箱域名推断，QQ 是默认，认不出的域名不猜。
它是怎么让任务继续的
DSH 的 agent 有一个待处理队列：next-turn 是「等下一轮处理」的输入，next-step 是「等下一个步骤」的输入。往 next-turn 追加一条消息再唤醒驱动，效果等同于用户在界面里发了这条消息。
停止走的是 agent.cancel()：清空待处理队列 + 中止当前 turn 的 AbortController，和你在界面上点停止是同一条路径。
这两处用的是 DSH 内部结构（不是公开 API），所以我把它单独做成插件——将来宿主换了实现，只需要更新这一个插件，不影响通知那一半。
和通知插件的关系
dsh-qq-mail-notify ──发信──▶ 你的邮箱
│ │
│ issueToken(sessionId) │ 你回复
▼ ▼
dsh-mail-command ◀────── 收信、校验口令、注入指令
通知插件通过 cordis 服务 mailCommand 拿到口令；取不到服务时它照常发信，只是邮件里没有口令，回复也就不触发任何动作。两个插件谁都不 import 对方。
兼容性
- 只声明实测过的那个版本：
0.2.1-rc.5。package.json 里 dshTarget 和 dsh.compatibility.dsh 都是它，没有范围。
- 为什么不写成
>=x <y：DSH 还在开发者预览，官方明确说会有破坏性变更，跨一个小版本（0.2.1 → 0.2.2）就可能装不上或行为不对。写范围等于替你赌那些版本，我不赌。
- 想装在别的版本上：把
dsh.compatibility.dsh 改成你手上的版本再试。能跑是运气，跑不动是常态——反馈时请带上版本号。
遇到问题
按这个顺序自查，基本能自己定位：
# 1. 看收件状态：开关、IMAP 地址、待用口令数、最近一次错误
mail_command action=status
# 2. 不想等轮询，立刻拉一次收件箱
mail_command action=check
# 3. 纯逻辑自检（口令、指令解析、引用剥离、服务商推断），不联网
& "$env:DSH_HOME\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe" `
scripts\selfcheck.mjs
status 里的 lastError 非空就是它，直接看那一行；待用口令 一直是 0，说明发信侧没取到 mailCommand 服务——先确认通知插件也装了、且版本没落后。
还是不行就提 issue：https://github.com/yashua233/dsh-mail-command/issues。走 issue 而不是私信，后面遇到同样问题的人能搜到。
带上这几样，能省好几轮来回：
- DSH 版本；本插件版本（
package.json 的 version）；
mail_command action=status 的完整输出（口令是打码的，可以贴）；- 你回复的那封邮件主题里
[CONT:xxxxxxxx] 那一段（口令本身不用给）；
- 报错原文或截图，以及「你做了什么、期望什么、实际是什么」。
授权码、完整邮箱地址、token 请先打码。
审批回信（配合通知插件，默认关闭）
除了「继续 / 停止」，它还能回答「工具在等你授权」：
- 通知插件里打开
approvalMailEnabled 后，审批请求会发一封带独立口令的邮件；
- 回信只认同向表态：
允许 / 同意 / ok / 1 → 这次放行；拒绝 / no / 2 → 这次拒绝；
- 认不出来按「没回」处理——继续等，超时后把决定权交回界面。这里刻意不猜：审批放行的是有副作用的操作，猜错代价太大；
- 审批口令和「继续」口令存在两张独立的表里，同一个会话可以各有一个，不会串味（不会出现「回一封同意被当成继续干活」）；
- 等待上限不超过口令存活期（30 分钟）。
超时、请求被中止、回信看不懂时，本插件不替任何人做决定，一律交回界面。
相关插件
三个插件互不 import，都靠 cordis 服务协作，可以任意组合安装；唯一的功能依赖是「本插件需要通知插件在场」。
隐私
不联网（除了连你自己的 IMAP 服务器），不收集任何数据。邮件原文不落盘，解析完即丢；口令与它对应的会话 id 记在 $DSH_HOME/mail-command-tokens.json（明文、仅本机、30 分钟后自动作废），除此之外不保留任何邮件内容。
许可证
MIT，见 LICENSE。
