Vergil-long/dsh-email-notify

dsh-email-notify

简体中文 · English

version
license
deps
dsh-plugin

DeepSeek Harness（DSH）的邮件通知插件：人不在电脑前时，让 harness 发邮件叫你回来。

- 任务完成 —— 含出错、被中止
- 工具等待授权 —— 任务卡在等你点「允许」
- 助手等你回答 —— 邮件里带问题和选项

发不发由会话页头的「离开模式」按钮决定：出门前点一下，回来再点一下。
零依赖、纯本地发信，QQ / 163 / Gmail / Outlook / 自建 SMTP 都行。设置全在 DSH 的设置界面里，不用命令行、不用手改 JSON。

安装

dsh plugin --profile web add github:Vergil-long/dsh-email-notify

然后三步：

1. 重启 DSH 桌面应用（退出时会连后端一起重启）
2. 打开 设置 → 邮件通知，填邮箱账号和授权码。QQ 邮箱已预置服务器端口，只需去网页版邮箱开「IMAP/SMTP 服务」拿一个 16 位授权码（不是登录密码）
3. 到会话页头点开「离开模式」——0.4.0 起默认关着，不点开一封都不会发

Windows 上也可以双击仓库里的 安装邮件通知.cmd；从本地目录装用
dsh plugin --profile web add link:/绝对路径/dsh-email-notify（路径不要带空格，否则 pnpm 会报
ERR_PNPM_SPEC_NOT_SUPPORTED）。卸载：node scripts/install.mjs --uninstall。

升级：node scripts/update-all.mjs（或双击 更新并修复.cmd），一次做完"同步插件代码 + 打桌面外壳误报补丁"。

离开模式

页头最右侧的按钮是总闸：

| 按钮状态 | 行为 |
| --- | --- |
| 离开模式：开 | 勾选的通知发生就发邮件，不管你在不在看界面 |
| 离开模式：关（默认） | 一封都不发 |
| 离开模式：自动（按钮变灰） | 高级设置里开了「自动模式」：回到旧行为，判定"不在看界面"才发 |

为什么不让插件自动猜人在不在：它只能看到窗口有没有焦点，而"人走了、窗口还开着"恰恰是最常见的情况——
那时自动判定会以为你还在看，你在外面一封都收不到。所以把决定权交回给人，状态记在配置里、重启后保持。

邮件长什么样

标题和正文都是可编辑模板，15 个占位符（{会话} {状态} {摘要} {用时}……），设置界面里带实时预览。
默认模板很短，适合在手机上扫一眼：

工作区：F:\Space For AI work\harness
会话：继续邮件通知插件工作
状态：已完成
离开模式：开

这封邮件由 dsh-email-notify 发送

「等你回答」的邮件会展开问题和选项，回到窗口作答任务才继续。

设置

基础页只有两个框：邮箱账号、授权码。SMTP 服务器、通知时机、限流、自动模式这些都在
「高级设置 ▸」二级页里，默认值开箱即用。配置存在 ~/.dsh/dsh-email-notify/config.json，
授权码只留在本机、读回界面时永远为空。

完整字段说明、模板占位符全表、环境变量方式：docs/配置参考.md

常见问题

| 现象 | 说明 |
| --- | --- |
| 装完一封邮件都没有 | 离开模式默认关。到会话页头点开它 |
| 535 报错 | QQ 邮箱要用 16 位授权码，不是登录密码 |
| 日志里「配置未完成，跳过发信」 | 设置里还有没填的，面板顶部会列出缺什么 |
| 邮件主题没有任务名 | 0.3.0 起显示左侧列表里的会话名；显示「（未命名会话）」说明标题还没生成 |
| 邮件里出现 {会话} 原文 | 宿主半侧还是旧版。跑 node scripts/verify-live.mjs 确认后同步并重启 |
| 其他 | 见 docs/测试与排查.md |

文档

- 配置参考 —— 两级设置、模板占位符全表、config.json、环境变量
- 设计与架构 —— 为什么不信外壳的 DOM 通知、代码结构、宿主端 HTTP 接口、设计取舍
- 测试与排查 —— 8 套自检怎么跑、现场核验、完整故障对照表
- 修外壳误报通知 —— 独立于本插件可用的一键补丁
- 更新记录

License

MIT。项目由 Vergil-long 与 DeepSeek Harness 结对完成：需求与取舍由人定，编码、测试与文档由 AI 写。