Qoder + Server酱:Quest 任务完成微信通知

效果:Qoder Quest 模式跑完开发任务时,自动调用 Server酱 推送微信通知,离开工位也能及时收到结果。

前置条件

  • 获取 Server酱 SendKey:获取 SendKey(30 秒获取教程)
  • 安装并配置 Qoder IDE 或 Qoder CLI
  • 将 SendKey 配置为系统环境变量 SERVERCHAN_SENDKEY,切勿写入项目代码或规则文件中

配置步骤

复制以下 curl 命令,根据你的使用方式选择接入途径:

curl -sS -X POST "https://sctapi.ftqq.com/${SERVERCHAN_SENDKEY}.send" -d "title=Qoder任务完成" --data-urlencode "desp=Quest任务已结束,请查看结果"

方式一:CLI Hook(推荐 CLI 用户使用)

Qoder CLI 支持 Stop 等事件钩子。在 ~/.qoder/settings.json 或项目 .qoder/settings.json 中,为 Stop 事件配置执行上述 curl 命令(具体 JSON 键名以 Qoder CLI 官方文档为准)。任务停止时将自动触发推送。

方式二:项目规则(推荐 IDE 用户使用)

在项目的 .qoder/rules 目录下创建规则文件,触发类型选择 Always Apply(自动附加到所有请求),在规则中写入:当 Quest 任务完成后,执行上述 curl 命令。规则文件会随 Git 共享,注意不要在规则中硬编码 SendKey。

方式三:对话指令

在 Quest 对话中直接输入指令,例如:“完成后用 curl 调 Server酱 通知我”,Qoder 会在任务结束时自主执行 curl 命令。

完整示例

以下为 .qoder/rules 目录下的 Always Apply 规则示例(文件扩展名以应用内实际显示为准):

当你完成当前 Quest 任务后,请执行以下命令通知用户:
curl -sS -X POST "https://sctapi.ftqq.com/${SERVERCHAN_SENDKEY}.send" -d "title=Qoder任务完成" --data-urlencode "desp=任务已结束,请回工位查看结果"

常见问题

额度怎么算?

Server酱免费版每天有 5 条额度,每分钟上限 50 条;订阅会员目前特价最低 3 元/月,一天最多可发 1000 条(价格详情)。

消息没收到怎么办?

请确认系统环境变量 SERVERCHAN_SENDKEY 是否生效,并检查 Qoder 终端是否允许执行了 curl 命令。也可参考常见问题与排查

频率限制会影响推送吗?

会。每分钟上限为 50 条。

SendKey 写进项目文件安全吗?

不安全。务必将 SendKey 设置为系统环境变量 SERVERCHAN_SENDKEY,通过 ${SERVERCHAN_SENDKEY} 引用,不要硬编码到规则或配置文件中。

相关集成

懒人方案:把这段话复制给你的 AI 助手

把下面这段文字原样粘贴给 Claude Code、Cursor 或任何 AI 编程助手,它就会替你完成 Server酱 的接入:

请帮我把 Server酱 微信通知接入到我当前的项目/工具中:
1. API:POST https://sctapi.ftqq.com/{SendKey}.send,参数 title(必填,不能含换行)、desp(正文,支持 Markdown,可选);成功时返回 JSON 的 code 为 0。
2. 如果我的 SendKey 以 sctp 开头,则改用 https://{uid}.push.ft07.com/send/{SendKey}.send,uid 是 SendKey 中 sctp 与 t 之间的数字。
3. SendKey 从环境变量 SERVERCHAN_SENDKEY 读取;如果没有,提醒我到 https://sct.ftqq.com 免费获取(每天 5 条额度)。
4. 安全要求:不要把 SendKey 硬编码进代码、不要打印到日志、不要提交到 git。
5. 频率约定:任务结束发 1 条结果摘要即可,批量任务合并成一条,不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。