goldiacogitative647/claude-plugin-weixin/configure

/weixin:configure — WeChat Channel Setup

Manages WeChat iLink Bot login and credential storage. Credentials live in ~/.claude/channels/weixin/credentials.json.

Arguments passed: $ARGUMENTS

Dispatch on arguments

No args — status and guidance

Read both state files and give the user a complete picture:

1. Credentials — check ~/.claude/channels/weixin/credentials.json for

token and baseUrl. Show set/not-set; if set, show token first 6 chars masked.

1. Access — read ~/.claude/channels/weixin/access.json (missing file

= defaults: dmPolicy: "pairing", empty allowlist). Show:

• DM policy and what it means
• Allowed senders: count and list
• Pending pairings: count with codes and sender IDs

1. What next — concrete next step based on state:

• No credentials → "Run `/weixin:configure login` to scan QR code and connect."
• Credentials set, nobody allowed → "Send a message to the bot on WeChat. It replies with a code; approve with `/weixin:access pair <code>`."
• Credentials set, someone allowed → "Ready. Message the bot on WeChat to reach the assistant."

login — QR code login

This is a TWO-STEP process. The scripts are in the plugin install directory. Find the plugin root by looking for the login-qr.ts file:

~/.claude/plugins/cache/m1heng-plugins/weixin/*/login-qr.ts

Use ls to resolve the wildcard and get the actual path.

Step 1: Fetch and display QR code

bun <plugin-root>/login-qr.ts

This script:

• Fetches a QR code from https://ilinkai.weixin.qq.com/
• Renders it in the terminal using npx qrcode-terminal
• Shows the direct link (user can open in WeChat)
• Outputs JSON as the last line: {"qrcode":"...","url":"..."}

Wait for the user after showing the QR code. Tell them: "用微信扫描二维码，或在微信中打开上面的链接。扫码完成后告诉我。"

Extract the qrcode value from the last line of output — you'll need it for step 2.

Step 2: Poll for scan result

After the user says they've scanned (or just proceed after showing the QR):

bun <plugin-root>/login-poll.ts <qrcode>

This script polls the WeChat API for scan status. It outputs one line:

• scaned — user scanned, waiting for confirmation on phone
• expired — QR expired (exit code 1). Offer to re-run step 1.
• timeout — timed out (exit code 1). Offer to re-run step 1.
• {"token":"...","baseUrl":"...","accountId":"...","userId":"..."} — success!

Credentials saved and scanner added to allowlist. (exit code 0)

On success, tell the user:

• "✅ 微信连接成功！"
• Credentials saved, user added to allowlist
• "重启 Claude Code 会话以启用微信频道"

On scaned, tell the user "已扫码，请在微信上点击确认..." and note the poll script is still running.

clear — remove credentials

Delete ~/.claude/channels/weixin/credentials.json.

baseurl <url> — set custom API base URL

For testing or alternative iLink endpoints. Read existing credentials.json, update baseUrl, write back.

Implementation notes

• The channels dir might not exist if the server hasn't run yet. Missing file

= not configured, not an error.

• The server reads credentials.json once at boot. Credential changes need a

session restart. Say so after saving.

• access.json is re-read on every inbound message — policy changes via

/weixin:access take effect immediately, no restart.

• Default API base URL is https://ilinkai.weixin.qq.com/.
• The QR code URL is a WeChat mini-program link. It works when scanned with

WeChat's QR scanner OR when opened in WeChat's built-in browser.