# CC Connect 接入 IM 通知

先阅读[通用通知接入](./notifications.html)。通过 CC Connect 的发送命令，把通知直接发到已连接的会话，不调用 Claude Code 等模型处理。

## 配置步骤

1. 确认 CC Connect 正在运行、IM 通道可用，并取得用户确认的项目名及准确会话标识。不要根据邮箱或展示名称猜会话 ID。
2. 下载并检查[通用接收器源码](./adapters/receiver.py)，在 CC Connect 所在机器用 Python 3.10+ 运行。将独立签名密钥保存为服务环境变量 `PREMSIR_NOTIFICATION_SECRET`。
3. 使用固定命令作为发送器：

```bash
python3 receiver.py --state /path/to/private/premsir-notifications.sqlite3 -- \
  cc-connect send --project '<PROJECT>' --session '<SESSION_KEY>' --stdin
```

4. 接收器默认监听 `127.0.0.1:8787/notifications`。通过已有 HTTPS 反向代理或隧道提供公网地址，再调用 `set_notification_subscription` 登记。
5. 调用 `test_notification_subscription`，核对目标 IM 收到提醒。将接收器纳入现有服务管理，确保它和 CC Connect 持续运行。

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

## 兼容性

核对日期：2026-09-10。[CC Connect 发送命令源码](https://github.com/chenhg5/cc-connect/blob/main/cmd/cc-connect/send.go)支持 `--project`、`--session` 和 `--stdin`，通过本机 socket 的 `/send` 调用发消息。先核对安装版本的 `cc-connect send --help`；缺少这些参数时不要使用 Agent 对话入口替代直发。

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