DeepSeek Harness 插件：Tencent Agent Mail 工作台

前言¶

DeepSeek Harness (DSH) 采用插件化架构。对于需要在 Web 界面中集成邮件系统的开发者，hun1315/tencent-agent-mail-dsh-plugin 提供了一个基于腾讯 Agent Mail (agent.qq.com) 的全屏工作台解决方案。该插件允许用户在 DSH 内直接进行邮件轮询、入库、分类和 LLM 整理，无需跳转外部网页。

核心功能¶

该插件主要提供以下能力：
1. 实时收信与入库：DSH 在线期间每 60 秒（可配）后台轮询 Agently 邮箱，新邮件自动入库本地 JSON 存储。
2. 本地分类与 LLM 整理：支持 5 类规则分类（发票、排班表、工作流、指令任务、收件箱）。新邮件可由配置的 OpenAI 兼容模型进行摘要和结构化抽取（如发票金额、排班周期）。
3. 全屏工作台 UI：提供日期分组列表、详情滑出面板、本地搜索、ESC 分级关闭等交互。
4. 附件与归档：支持附件下载并打开（自动刷新授权），支持归档（软删除）与回收站恢复，发件记录独立分类。
5. 邮箱记忆：每封邮件的摘要自动追加至 memory/default.md。
6. 邮件遥控（命令通道）：通过白名单邮箱发送含特定关键词的邮件，可触发 DSH 执行任务并回信。

安装与启用¶

该插件依赖 Node.js >= 18。
1. 安装并登录 Agently CLI：

   npm install -g @tencent-qqmail/agently-cli
   agently login

2. 配置 LLM 凭据：
   创建 ~/.dsh/dsh-mailbox/credentials 文件，内容如下：

   {
     "base_url": "https://<your-endpoint>/v1",
     "api_key": "<your-key>",
     "model": "<model-name>"
   }

3. 安装插件：

   dsh plugin --profile web add github:<you>/dsh-mailbox

4. 初始化：
   安装后需在 DSH 对话框中完成 LLM Key 绑定等初始化步骤，插件默认通过 npm root -g 探测 agently-cli 入口。

注意事项¶

• 环境要求：Windows 优先，Linux/macOS 理论可用但未完整验证。必须安装 Node.js >= 18。
• 安全性：邮件正文被视为不可信输入，仅进行纯文本渲染，绝不执行。凭据存储在本地 ~/.dsh/dsh-mailbox/credentials.json，不提交至仓库。
• 非即插即用：安装后需在 DSH 对话框绑定 LLM Key，并编辑 ~/.dsh/dsh-mailbox/settings 配置白名单和轮询间隔等参数。

结语¶

该插件将腾讯 Agent 邮箱的收发与管理能力深度集成到 DeepSeek Harness 的工作流中，特别适合需要通过 LLM 自动整理邮件、或通过邮件遥控 Agent 的开发者。完整配置文档可参考 GitHub 仓库。