Wxsender
这个 skill 用于操作本地 wxsender CLI。主职责是按用户明确要求即时发送微信;次职责是在发送前后查询状态、排障,或维护联系人搜索结果位次。
任务分流
- 即时发送文本:
send-text --contact <联系人> --message <文本> - 即时发送图片或文件:
send-file --contact <联系人> --file <本地路径> - 演练发送:在
send-text或send-file后追加--dry-run - 查询与排障:
history、status --json、config --json、contact --list --json - 联系人位次管理:
contact --set <联系人> --search-index <N>
调用规则
- 命令默认在 skill 根目录执行,统一入口是
python3 scripts/wxsender_cli.py ...。 - 真实发送必须来自用户明确要求;用户要求发送文本、图片或文件时,直接调用
send-text或send-file。 - 联系人、文本内容、附件路径缺失或有歧义时必须先追问;不要猜测联系人、附件路径或消息正文。
- 不得改写、润色、补全用户要发送的消息内容。
--force只能在用户明确要求强制发送或绕过限频时使用。--search-index <N>表示微信搜索后用于选择目标结果的 1-based 搜索结果位次;第 1 个结果执行 0 次Down,第 N 个结果执行 N-1 次Down。- 未显式传入
--search-index时,CLI 会读取contact --set保存的位置;联系人未配置时会报错。 history始终输出 JSON;status、config、contact --list需要结构化解析时显式使用--json。--dry-run只用于流程演练,不用于验证真实 GUI 环境、依赖、窗口状态或限频结果。- 不要把真实发送自动降级成
--dry-run。 - 状态文件默认落在
./.state/state.db。
参考资料
- 命令映射与即时发送示例:见 references/command-map.md
- 发送前需要确认的信息与
dry-run语义:见 references/safety-and-preflight.md - 发送失败与限频排障:见 references/troubleshooting.md