mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-16 13:03:31 +08:00
f1c5f86b80
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
62 lines
2.0 KiB
Markdown
62 lines
2.0 KiB
Markdown
# 微信接入
|
||
|
||
> 微信 Adapter 的接入教程。微信不需要手动填写 Bot Token，在桌面端扫码确认后即可绑定。
|
||
|
||
## 适用场景
|
||
|
||
微信方案适合个人私聊远程使用。当前实现支持文本聊天、图片附件理解、项目选择、状态查看、停止生成和权限审批。
|
||
|
||
## 1. 在桌面端扫码绑定
|
||
|
||
打开桌面端 `设置 -> IM 接入 -> 微信`：
|
||
|
||
1. 点击「扫码绑定」
|
||
2. 使用微信扫描页面里的二维码
|
||
3. 在微信中确认
|
||
4. 页面显示绑定成功后，桌面端会重启 IM adapter sidecar
|
||
|
||
扫码成功后，桌面端会把微信返回的账号凭据写入 `~/.claude/adapters.json` 的 `wechat` 配置，并把扫码用户加入 `pairedUsers`。
|
||
|
||
## 2. 发送消息
|
||
|
||
绑定后，直接在微信里发送自然语言消息即可。
|
||
|
||
如果没有配置默认项目，Adapter 会先返回最近项目列表，回复编号后再开始会话。
|
||
|
||
## 支持的命令
|
||
|
||
- `/projects` — 切换项目，重新显示最近项目列表
|
||
- `/status` — 查看当前会话的项目、模型和运行状态
|
||
- `/clear` — 清空当前会话上下文，保留项目绑定
|
||
- `/new` — 清空当前 chat 绑定的 session，并重新选择项目
|
||
- `/help` — 显示当前可用命令
|
||
- `/stop` — 向当前 session 发送 `stop_generation`
|
||
- `/allow <requestId>` — 允许一次权限请求
|
||
- `/always <requestId>` — 永久允许同类权限请求
|
||
- `/deny <requestId>` — 拒绝一次权限请求
|
||
|
||
## 解绑
|
||
|
||
在桌面端 `设置 -> IM 接入` 的「已配对用户」列表里点击微信用户右侧的「解绑」。
|
||
|
||
解绑会清空微信账号凭据和已配对用户，并重启 adapter sidecar。解绑后需要重新扫码才能继续使用。
|
||
|
||
## 本地开发启动
|
||
|
||
```bash
|
||
cd adapters
|
||
bun install
|
||
bun run wechat
|
||
```
|
||
|
||
可选环境变量：
|
||
|
||
```bash
|
||
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"
|
||
```
|
||
|
||
正常桌面端使用不需要手动设置这些环境变量，扫码绑定会写入本地配置。
|