cc-haha/docs/im/wechat.md
程序员阿江(Relakkes) f1c5f86b80 feat: keep IM permission approvals consistent
DingTalk can receive interactive card callbacks, but the card UI still depends on a published template, so the adapter now supports a template-backed card path with text commands as the reliable fallback. Telegram and WeChat use the same allow-once, allow-always, and deny semantics so manual authorization behaves the same across platforms.

Constraint: DingTalk button rendering requires an operator-provided interactive card template id
Rejected: Treat the existing AI streaming card template as a permission card | it cannot guarantee visible action buttons
Confidence: high
Scope-risk: moderate
Directive: Do not remove the text approval fallback unless DingTalk card template provisioning is guaranteed
Tested: bun test adapters/common/__tests__/permission.test.ts adapters/dingtalk/__tests__/permission-card.test.ts adapters/telegram/__tests__/telegram.test.ts adapters/common/__tests__/config.test.ts src/server/__tests__/adapters.test.ts
Tested: bunx tsc -p adapters/tsconfig.json --noEmit
Tested: bun run check:adapters
Tested: cd desktop && bun run build
Tested: bun run check:server
Tested: bun run check:docs
Tested: git diff --check
Not-tested: bun run quality:pr is blocked by existing CLI core approval policy; see artifacts/quality-runs/2026-05-03T13-19-56-232Z/report.md
2026-05-04 19:03:36 +08:00

2.0 KiB
Raw Blame History

微信接入

微信 Adapter 的接入教程。微信不需要手动填写 Bot Token在桌面端扫码确认后即可绑定。

适用场景

微信方案适合个人私聊远程使用。当前实现支持文本聊天、图片附件理解、项目选择、状态查看、停止生成和权限审批。

1. 在桌面端扫码绑定

打开桌面端 设置 -> IM 接入 -> 微信

  1. 点击「扫码绑定」
  2. 使用微信扫描页面里的二维码
  3. 在微信中确认
  4. 页面显示绑定成功后,桌面端会重启 IM adapter sidecar

扫码成功后,桌面端会把微信返回的账号凭据写入 ~/.claude/adapters.jsonwechat 配置,并把扫码用户加入 pairedUsers

2. 发送消息

绑定后,直接在微信里发送自然语言消息即可。

如果没有配置默认项目Adapter 会先返回最近项目列表,回复编号后再开始会话。

支持的命令

  • /projects — 切换项目,重新显示最近项目列表
  • /status — 查看当前会话的项目、模型和运行状态
  • /clear — 清空当前会话上下文,保留项目绑定
  • /new — 清空当前 chat 绑定的 session并重新选择项目
  • /help — 显示当前可用命令
  • /stop — 向当前 session 发送 stop_generation
  • /allow <requestId> — 允许一次权限请求
  • /always <requestId> — 永久允许同类权限请求
  • /deny <requestId> — 拒绝一次权限请求

解绑

在桌面端 设置 -> IM 接入 的「已配对用户」列表里点击微信用户右侧的「解绑」。

解绑会清空微信账号凭据和已配对用户,并重启 adapter sidecar。解绑后需要重新扫码才能继续使用。

本地开发启动

cd adapters
bun install
bun run wechat

可选环境变量:

export WECHAT_ACCOUNT_ID="..."
export WECHAT_BOT_TOKEN="..."
export WECHAT_BASE_URL="https://ilinkai.weixin.qq.com"
export ADAPTER_SERVER_URL="ws://127.0.0.1:3456"

正常桌面端使用不需要手动设置这些环境变量,扫码绑定会写入本地配置。