wechat-setup
/wechat-setup
First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or
- Author
- Canlah-AI ↗
- Repository
- wechat-sales-copilot ↗
- Licence
- Apache-2.0
- Last repository change
- 31.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 31.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or
Triggers from the description
Original author description
First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or
How it works
- 1. Build and run the doctor
- 2. Permissions (only the user can grant these)
- 3. Config
- 4. Calibrate the window
- 5. First send, to yourself
- Keeping it healthy
SKILL.md preview
--- name: wechat-setup description: First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or campaigns (wechat-outreach). --- Read `../shared/RULES.md` first. # Set up and check ## 1. Build and run the doctor ```bash ./install.sh # builds bin/wxctl and bin/ocr, installs Pillow + openpyxl, creates config.toml python3 -m wxmac.doctor # read-only checklist with the fix for each failing item ``` Fix items top to bottom; rerun the doctor after each. ## 2. Permissions (only the user can grant these) Grants belong to the app that runs the commands (Terminal, iTerm, or the app hosting Claude Code), not to the scripts. Tell the user exactly where to click; you cannot do it for them: | Permission | Where | Needed for | |---|---|---| | Accessibility | System Settings → Privacy & Security → Accessibility → turn on the terminal app | keys and clicks | | Screen Recording | System Settings → Privacy & Security → Screen Recording → turn on the terminal app | reading the screen | | Full Disk Access (optional) | System Settings → Privacy & Security → Full Disk Access → turn on the terminal app | replies, opt-outs from replies | After granting, the terminal app must be restarted. Without Screen Recording, screenshots come back as the desktop only and every name "does not match": that is the commonest first failure. ## 3. Config `~/Library/Application Support/wechat-sales-copilot/config.toml` (created from `config.example.toml`). Ask the user for: their name as contacts know them, company, one-line description, a few facts drafts may use, who buys from them, what their WeChat tags mean. Fill `[persona]` and `[classify]`. Set `[ui] language` to the WeChat interface language: `en` is tested; with `zh`, sending is tested but contacts capture is **unverified** (say so; run `python3 -m wxmac.doctor --ocr` to confirm the language on screen). Leave `[pacing]` at the defaults unless the user insists. ## 4. Calibrate the window ```bash bin/wxctl fit # main window to the top-left, 1300 wide, full height bin/wxctl windows # any extra window titles are popped-out chats: bin/wxctl close-window "<title>" ``` The layout constants in `wxmac/wx_send.py` (`LIST_RIGHT`, `INPUT_TOP`, `PHONE_ICON`) assume this default layout. ## 5. First send, to yourself ```bash python3 -m wxmac.wx_send "File Transfer" "setup test" --dry-run python3 -m wxmac.wx_send "File Transfer" "setup test" ``` Both must print `dry-run` then `sent`. On a Chinese interface the chat is "文件传输助手". If it aborts, read the `reason` and `docs/pitfalls.md`, and look at the newest screenshot in the data dir's `shots/`. ## Keeping it healthy - The screen must stay unlocked while sending. The sender acts only when the user is away from the keyboard, so a short screen-saver delay plus "require password immediately" will lock it mid-run. Tell the user the trade-off; changing lock settings is their call. - After a WeChat update, rerun the doctor and the File Transfer test before any campaign.
Versions
The database has no other skills named wechat-setup.
Database snapshot: 13.11.2026 · package version 2305a54b6497 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100wechat-send
Send one WeChat message from the user's own WeChat for Mac to one person or one group - text, optionally followed by a picture or any file - or just open a chat to check it is the right one. Every step is verified on screen (search result in a chat section, chat header, text… - 95wechat-ops
Keep WeChat for Mac in a state the scripts can drive - see what is on screen, list, resize and close WeChat windows, handle a locked screen, a logout or a WeChat update, and use the low-level wxctl primitives. Use for "WeChat window is wrong", "what is on the WeChat screen",… - 100wechat-send-file
Send a file or image to WeChat via TeamMCP. Use when the user wants to send a file, image, or document to WeChat. - 100wechat-send-image
Send an image or screenshot to WeChat. Use when the user wants to send a picture, screenshot, or photo to WeChat. - 100wechat
在本地查询、导出微信 4.1+ 聊天记录为 AI 可读文本 —— 支持双人会话、群聊、以及按消息量排名的重要联系人排名。当用户想导出、搜索或分析自己的微信聊天记录,或为其他 skill(前任.skill / 同事.skill 等)准备聊天记录原材料时使用。 - 100wechat-send
用户在桌面微信里给某个群或个人发一条消息、不想自己动手点的时候使用。通过 Win32 截图/点击/剪贴板脚本操作微信客户端:恢复窗口 → 窗口截图量坐标 → 搜索会话 → 核对标题(群名带人数) → 输入内容(中文走剪贴板) → 点「发送」→ 截图确认气泡。同义说法:给群里发个消息、在XX群发一下、微信回他一句、发微信消息、微信自动发消息、桌面微信自动化、Windows 微信自动化、微信群发消息、微信定时发送。