Merchant tools 接入文档Markdown 原文

CC Connect 接入 IM 通知

先阅读通用通知接入。通过 CC Connect 的发送命令,把通知直接发到已连接的会话,不调用 Claude Code 等模型处理。

配置步骤

  1. 确认 CC Connect 正在运行、IM 通道可用,并取得用户确认的项目名及准确会话标识。不要根据邮箱或展示名称猜会话 ID。
  2. 下载并检查通用接收器源码,在 CC Connect 所在机器用 Python 3.10+ 运行。将独立签名密钥保存为服务环境变量 PREMSIR_NOTIFICATION_SECRET
  3. 使用固定命令作为发送器:
python3 receiver.py --state /path/to/private/premsir-notifications.sqlite3 -- \
  cc-connect send --project '<PROJECT>' --session '<SESSION_KEY>' --stdin
  1. 接收器默认监听 127.0.0.1:8787/notifications。通过已有 HTTPS 反向代理或隧道提供公网地址,再调用 set_notification_subscription 登记。
  2. 调用 test_notification_subscription,核对目标 IM 收到提醒。将接收器纳入现有服务管理,确保它和 CC Connect 持续运行。

通知内容通过标准输入传给固定命令,不作为 shell 脚本执行。接收器校验签名和请求时效,保存去重记录;发送命令失败时返回 503,让 Premsir 重试。状态文件只保存事件 ID 和时间,不存通知正文。

兼容性

核对日期:2026-09-10。CC Connect 发送命令源码支持 --project--session--stdin,通过本机 socket 的 /send 调用发消息。先核对安装版本的 cc-connect send --help;缺少这些参数时不要使用 Agent 对话入口替代直发。

这个接收器不会安装或重启用户的 CC Connect。实际 IM 支持和主动消息限制由 CC Connect 与 IM 平台决定。