docs: rebuild documentation site with React

2026-10-10 11:53:10 +08:00 · 2026-07-23 20:46:33 +08:00
parent f70fa017ef
commit c2fd674662
93 changed files with 10808 additions and 6902 deletions
@@ -0,0 +1,94 @@
+# WeChat Integration
+
+The WeChat adapter binds a bot account by QR code, then authorizes individual private-chat users through pairing or an allowlist.
+
+It supports text, transcribed voice content, image and file attachments, project selection, status, stop, and text-based permission approval. Group chats are not supported.
+
+## Bind the WeChat bot account
+
+Open **Settings → IM Integration → WeChat**:
+
+1. Select **Scan to bind**.
+2. Scan the QR code with WeChat.
+3. Confirm the login in WeChat.
+4. Wait for Desktop to show the bound state.
+5. Save the configuration.
+
+Desktop stores the returned `accountId`, `botToken`, `baseUrl`, and `userId` in the `wechat` section of `~/.claude/adapters.json`, then restarts the adapter sidecar.
+
+Binding credentials does not authorize every WeChat user.
+
+## Authorize a user
+
+Generate a pairing code at the top of **IM Integration**, then send the six-character code to the bound bot in a private chat.
+
+The code:
+
+- expires after 60 minutes;
+- can be used once;
+- is replaced immediately when a new code is generated;
+- is rate limited after repeated failures.
+
+Known WeChat user IDs can instead be entered in `Allowed Users`.
+
+## Projects and sessions
+
+With a default project configured, the first accepted message creates or resumes a session in that directory.
+
+Without a default project, the adapter returns recent projects. Reply with a number, project name, or absolute path. The resulting chat-to-session mapping is stored in `~/.claude/adapter-sessions.json`.
+
+Use `/new` to choose another project and start a new session.
+
+## Commands
+
+- `/help` or `帮助`
+- `/status` or `状态`
+- `/projects` or `项目列表`
+- `/new` or `新会话`
+- `/new <number, project name, or absolute path>`
+- `/clear` or `清空`
+- `/stop` or `停止`
+
+## Permission approval
+
+Reply to the text approval message with:
+
+- `/allow <requestId>` — allow once
+- `/always <requestId>` — persist the matching approval
+- `/deny <requestId>` — deny
+
+The adapter sends the response back to the pending Desktop session.
+
+## Attachments and replies
+
+- WeChat messages are received through long polling.
+- Long text is split into platform-sized messages.
+- Images enter model input as inline images.
+- Other files are downloaded to a local temporary path for the session.
+- Shared attachment size limits are enforced.
+
+## Unbind
+
+Unbinding the WeChat account clears its credentials and platform authorization lists. Removing one paired user only revokes that user.
+
+## Development
+
+Packaged Desktop starts the sidecar automatically. For source development:
+
+```bash
+cd adapters
+bun install
+bun run wechat
+```
+
+Optional overrides:
+
+```bash
+export WECHAT_ACCOUNT_ID="..."
+export WECHAT_BOT_TOKEN="..."
+export WECHAT_BASE_URL="https://ilinkai.weixin.qq.com"
+export WECHAT_USER_ID="..."
+export ADAPTER_SERVER_URL="ws://127.0.0.1:3456"
+```
+
+If messages are rejected, confirm that Desktop is running, the account is bound, the sender is paired or allowlisted, and both adapter state files are writable.