dsh-agentmail
Verified@zt8989/dsh-agentmail · v0.3.1 · MIT · Web UI
Agent Mail for DeepSeek Harness: send and receive email through the agently-cli QQ Agent mailbox, embedding session/thread markers so replies are routed back to the right DSH Session.
Install
dsh plugin add @zt8989/dsh-agentmail Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-agentmail — DeepSeek Harness 的 Agent Mail 插件
English | 简体中文
一个 DeepSeek Harness 插件:让智能体通过 QQ Agent Mail 邮箱(基于
agently-cli)收发邮件,把来信路由回
拥有该线程的 DSH 会话,并把不认识的会话交给指定的兜底会话(未配置时忽略)。
各项设置可在 Web 界面的配置页里修改。
功能
- 智能体工具:
agentmail_send— 发送邮件;主题自动嵌入session/thread标记。agentmail_list— 列出某个文件夹(inbox/sent/trash/spam)。agentmail_read— 读取完整邮件;HTML 正文渲染为干净的 Markdown。agentmail_search— 按关键词搜索。agentmail_reply— 回复邮件(保留标记)。agentmail_poll— 立即检查收件箱并路由新邮件。
- 轮询器 — 每隔
pollIntervalMs列出收件箱未读邮件,逐封读取新邮件、解析标记, 并通过agent.followup(...)把内容投递进绑定的 DSH 会话(唤醒智能体)。匹配不到 任何活动会话的来信会交给配置好的兜底会话;没有配置兜底会话时,这类邮件留在 收件箱里被忽略。 - 配置页 — 设置 → Agent 邮箱 是一整页配置;同一个页面也挂在
Plugins → Agent Mail 的插件行上(行上的配置入口),两处改的是同一份设置。
可设兜底会话、发件人过滤、投递、轮询与连接参数;兜底会话从可搜索的会话列表里选
(按标题或 id 过滤),不用手抄会话 id。修改先暂存,点 保存 才写入,日常使用不必手改
cordis.patch.yml。 - HTML → Markdown — QQ/Foxmail 的 HTML 正文被渲染为紧凑的 Markdown
(
html.js,基于 turndown):签名/报告块(data-xmail_bot_mail_report)整体移除, Foxmail 的 border-left/mail_quote引用壳变成>引用,微小图标/追踪像素被丢弃, 其余图片变成[图片]占位,表格渲染为管道表格。PLAIN 与 MARKDOWN 正文原样透传。 - 缺失 CLI 提示 — 当
agently-cli无法执行时,所有工具(含轮询器)返回官方安装 文档指引(https://agent.qq.com/doc/cli-setup.md),而不是裸的 ENOENT 报错,智能体 可以据此引导用户完成安装。
会话 / 线程标记
发送邮件时,主题末尾会追加:
Subject: Quarterly report [AM:s=<session>|t=<thread>]
s— 会话归属:DSH 会话 id(或你指定的稳定 key)。t— 智能体为本轮对话选择的线程(主题)。
回复会保留标记(邮件客户端在主题里保留 Re: …),因此轮询器能把
(session, thread) 解析回同一个 DSH 会话。映射表持久化在 state.json,
即使主题被编辑、标记只存活在摘要里,重启后路由依然有效。
前提条件
安装并授权
agently-cli(一次即可):npm install -g @tencent-qqmail/agently-cli agently-cli auth login # 交互式 OAuth 授权 agently-cli +me # 验证邮箱地址把插件安装进某个 profile:
dsh plugin --profile web add @zt8989/dsh-agentmail任意 profile 名均可(这里以
web为例);--profile <name>在首次使用时自动 初始化。如果 CLI 缺失,工具会返回上面的安装提示。
打包
发布的包是一个自包含的单文件 bundle(dist/index.js):turndown
(HTML→Markdown)在 prepublishOnly 阶段经 esbuild 内联,因此运行时零依赖。
bundle 在运行时导入 DSH 宿主包(@deepseek-ai/cordis、@deepseek-ai/dsh-llm、
@deepseek-ai/dsh-tools);它们有意不声明为 peerDependencies——从宿主自身的
安装里解析(registry 上的同名包并不相干),声明它们会导致 npm arborist 崩溃。
源码在 index.js + html.js;npm run build 重新生成 bundle。
配置
在侧边栏打开 Plugins,选中 @zt8989/dsh-agentmail,在 agentmail 行上点
配置。配置页会写入 profile 的 cordis.patch.yml;也可以手动写入同样的值:
- id: agentmail
config:
fallbackSessionId: "session-…" # 未知会话的兜底会话;留空表示忽略
pollIntervalMs: 60000 # 0 关闭后台轮询
routeOnlyFrom: [] # 例如 ["[email protected]"] 只自动路由这些发件人
cliPath: agently-cli # 不在 PATH 上时用绝对路径
statePath: "" # 默认 <DSH_HOME>/agentmail/state.json
markRead: true # 已路由的邮件移出收件箱
兜底会话 id 就是会话菜单里复制的那个 id。投递到兜底会话的邮件在正文里标明是 「未知会话」,且不会建立线程绑定:该会话恢复后,它自己的线程依然路由回它自己。
说明
- 发送/回复使用
--confirmed,不会被交互式确认提示卡住。 - 附件可直接用 CLI 发送;本插件聚焦会话/线程路由工作流。