serverchan-notify

功能

• 订阅 DSH 会话事件流（ctx.on("session/event", …)）。
• 每个回答回合结束（turn/end，无论 completed / error / blocked / max-tokens / aborted）推送一条 Markdown 通知到 Server酱3 → 你的微信。通知内容：对话标题、模型、项目目录、Git 分支、回合状态、完成时间、会话 ID，以及最新一段回复正文（超过 16000 字符自动截断）。
• agent 向你提问时也推送。 出现 ask_user_question 工具调用，就意味着 agent 已经阻塞、在等人回答——这是最不该漏掉的情形，因此单独推一条：带上每个问题的 header、正文、选项及其说明。用 notifyQuestions: false 关闭。
• fire-and-forget：推送失败只记一条警告日志，绝不阻塞或中断 agent 主循环。
• 默认跳过子代理会话，避免被内部子任务刷屏。

🔐 本仓库不含任何 SendKey。 key 一律来自环境变量、文件或插件配置，绝不写入源码。

环境要求

• DeepSeek Harness (DSH) —— 已在 0.1.1-rc.2 与 0.1.2-rc.1 上验证（@deepseek-ai/cordis ^4.0.1）。插件按运行时 harness 实际暴露的访问器读取会话日志，因此两条 API 线都支持。
• Node.js ≥ 18
• 一个 Server酱3 SendKey（https://sct.ftqq.com/ 免费注册）

快速开始

1. 获取 SendKey

登录 https://sct.ftqq.com/，打开「SendKey」页签复制你的 key，形如 sctp<数字>txxxx…。插件会自动推导专属推送域名（https://<数字>.push.ft07.com/send/<key>.send）；不带通道号的旧式 key 则使用通用域名 https://sctapi.ftqq.com/<key>.send。

2. 保存 key（推荐）

mkdir -p ~/.dsh/secrets
echo '你的SendKey' > ~/.dsh/secrets/serverchan_sendkey
chmod 600 ~/.dsh/secrets/serverchan_sendkey

3. 挂载插件

编辑 DSH 的补丁层并重启 harness：

# 全局（所有 profile 生效，等价于 codex 的全局 hooks.json）：
#   $DSH_HOME/cordis.patch.yml   （默认 ~/.dsh/cordis.patch.yml）
# 单 profile：
#   $DSH_HOME/profiles/<name>/cordis.patch.yml

- insert:
    - id: serverchan-notify
      name: 'dsh-serverchan-notify'
      config:
        sendkeyFile: '~/.dsh/secrets/serverchan_sendkey'

插件行只在启动时解析——改完配置后必须重启 harness 进程。

安装插件包

本包声明了 dsh.bundle manifest，通过 npm 一条命令安装：

# 推荐
dsh plugin --profile web add dsh-serverchan-notify

# 固定版本
dsh plugin --profile web add dsh-serverchan-notify@1.0.2

# GitHub monorepo 回退
dsh plugin --profile web add 'github:nickhelion/dsh-plugins#main&path:/packages/serverchan-notify'

# 本地开发
git clone https://github.com/nickhelion/dsh-plugins.git
dsh plugin --profile web add "$PWD/dsh-plugins/packages/serverchan-notify"

包内自带的 cordis.patch.yml 以全默认配置插入插件行；如需覆盖某个选项，在自己的补丁层里按行 id serverchan-notify 重写即可。

SendKey 解析顺序

取第一个非空值，优先级从高到低：

配置项

通知示例

回合结束：

DSH 完成：<对话标题>

• 对话标题：…
• 模型：deepseek-official / deepseek-v4-pro
• 项目目录：/home/you/project
• Git 分支：main
• 回合状态：完成
• 完成时间：2026-08-18T21:00:00.000Z
• 会话 ID：session-12

DSH 最新回复

……最新一段模型回复……

agent 正在等你回答：

DSH 提问：<对话标题>

• 对话标题：…
• 模型：deepseek-official / deepseek-v4-pro
• 项目目录：/home/you/project
• Git 分支：main
• 提问时间：2026-08-18T21:05:00.000Z
• 会话 ID：session-12

DSH 正在等待你的回答

1. 选择模式

要按哪条路径继续？

• 直接改（推荐） — 小步快跑
• 先出方案 — 多一轮评审

2. 改动范围

• README
• 测试 > 该问题可多选

常见问题

开发

npm install        # 安装 devDependencies（cordis），供冒烟测试使用
npm test           # 冒烟测试——fetch 打桩，不真实推送
REPORT=1 npm test  # 冒烟测试 + 打印组装好的报文
npm run test:live  # 按配置的 key 真实推送一条测试通知

仓库结构

lib/index.js      插件入口——事件订阅、报文组装、HTTP 推送（回合结束 + agent 提问）
test-send.mjs     独立真实推送脚本（key 解析顺序与插件一致）
smoke-test.mjs    cordis 进程内冒烟测试（fetch 打桩）
package.json      包元数据 + npm scripts
README.md         英文文档
README.zh-CN.md   中文文档

参与贡献

请向统一的 nickhelion/dsh-plugins monorepo 提交 PR。两条底线规则：

1. 绝不提交 SendKey（或任何机器绝对路径）——key 只能经环境变量 / 文件 / 配置进入。
2. 事件监听器必须保持不抛异常、fire-and-forget——通知绝不能影响 harness 主流程。

License

MIT