wechat-tietu-draft Skill

微信公众号贴图类型草稿创建自动化工具。

🎯 如何激活本技能

在OpenClaw对话中使用以下任一触发词：

主要触发词

• 创建贴图草稿 - 最常用的触发方式
• 发布贴图草稿 - 常用触发方式
• 贴图草稿 - 简洁触发
• 微信公众号贴图 - 描述性触发
• 贴图类型草稿 - 明确类型触发

使用示例

用户：创建贴图草稿
助手：好的，我将为您创建微信公众号贴图类型草稿。请确保Chrome浏览器已打开并已登录微信公众号...

技能概述

本技能专门用于创建微信公众号的贴图类型草稿，这是一种简化界面的草稿类型，特别适合：

贴图草稿的特点

1. 界面简化 - 只有标题和正文两个输入框，没有作者、摘要等复杂字段
2. 操作快速 - 填写简单，保存迅速
3. 适合图文 - 特别适合图片为主、文字为辅的内容

什么时候使用本技能？

• ✅ 创建图片为主的公众号内容（配图文章、图片集等）
• ✅ 需要快速创建简单草稿（不想填写太多信息）
• ✅ 制作图文混排内容（图片+简短文字说明）
• ❌ 创建正式的长篇文章（请使用普通草稿技能）
• ❌ 需要作者、摘要等完整信息（请使用普通草稿技能）

核心功能

版本说明

本技能提供统一的文件输入版本，通过 skill_main.py 统一入口进行管理。

输入文件格式说明

• 文件类型：仅接受 .txt 文本文件，UTF-8 编码。
• 内容规则：
  • 第 1 行：作为标题（可选）。若为空或过长，则整篇视为正文。
  • 第 2 行及以后：全部视为正文（含空行、作者行、日期行等）。标题与正文之间可有任意空行或说明行，无需改成「严格第一行标题 + 其余行正文」。
• 符合要求的文件：满足「.txt」「UTF-8」「正文非空」即可；第 1 行后有空行或作者信息等均属正常，技能会照常处理。

主要工作流程

统一入口版本工作流程 (skill_main.py)：

1. 自动环境检测 - 检查Chrome状态和登录状态
2. 智能流程选择 - 根据当前状态选择最合适的执行路径
3. 状态感知执行 - 环境就绪时直接创建，未就绪时引导用户
4. 完整结果反馈 - 显示保存成功或提供问题解决方案

技术特点

• 快速保存验证 - 采用方案C优化，保存后800毫秒即开始检查
• 智能错误处理 - 自动检测常见问题并提供明确指导
• 用户友好交互 - 清晰的提示和进度显示
• 严格文件验证 - 只接受.txt文件，不做格式转换
• 严格环境检查 - 必须使用CDP模式，检测失败时明确提示用户

严格的环境要求

本技能严格使用CDP模式，不会在检测失败时静默切换到其他方式：

检查条件：

1. ✅ Chrome 必须在技能使用的 CDP 端口运行（默认 19222，与常见教程 9222 错开；可用 --port 改）
2. ✅ 必须已登录微信公众号
3. ✅ 必须在微信公众号页面

检测失败时的行为：

• ❌ 不会静默切换到其他浏览器工具
• ✅ 会明确提示用户问题所在
• ✅ 会提供详细的解决步骤
• ✅ 会优雅地终止任务

使用方式

推荐：统一入口 skill_main.py

skill_main.py 是本技能唯一推荐入口（创建草稿勿直接运行 wechat_tietu_draft.py）。

macOS / Linux

• 从 .txt 创建贴图草稿：

python3 skill_main.py --file 文章.txt 2>&1 | tee skill_main.log

• 指定 Chrome 调试端口（默认 19222；若需与他人共用 9222 可显式 --port 9222）：

python3 skill_main.py --file 文章.txt --port 19222 2>&1 | tee skill_main.log

Windows（PowerShell，同上）

python skill_main.py --file 文章.txt 2>&1 | Tee-Object -FilePath skill_main.log

（若使用 Git Bash，可与 macOS 相同，用 python3 与 tee。）

说明：子进程写草稿时的详细日志仍会落在同目录下的 skill.log；skill_main.log 记录的是入口脚本自身在终端上的输出（含等待登录等提示）。

统一入口脚本的特点：

• ✅ 自动环境检测 - 检查Chrome状态和登录状态
• ✅ 状态感知流程 - 根据当前状态选择最合适的执行路径
• ✅ 统一错误处理 - 提供明确的错误信息和解决建议
• ✅ 用户友好交互 - 清晰的提示和进度显示
• ✅ 完整工作流 - 从环境启动到草稿创建的全流程管理

辅助说明

Chrome 启动已内置在 skill_main.py --file：环境不足时会自动释放当前默认端口（默认 19222，若需）并拉起带 --remote-debugging-port=… 的 Chrome；环境检测在创建草稿流程中自动完成，无需单独自检命令。
登录前截图：进入「等待登录 / 就绪」后、自动轮询前，会对当前调试 Chrome 里优先选中的公众号相关标签页截一张 PNG，默认写入技能目录 mp_login_screenshot.png（已 .gitignore）。CDP WebSocket 一律 proxy=None 直连本机，避免 VPN 的 SOCKS 误伤本地调试口。

使用前准备

必要条件

• ✅ Chrome浏览器 - 必须使用Google Chrome（不能使用其他浏览器）
• ✅ Python环境 - Python 3.7或更高版本
• ✅ 微信公众号账号 - 需要有可登录的公众号

快速检查

运行以下命令检查环境是否就绪：

# 检查Python版本
python3 --version

# 检查Chrome是否安装
which google-chrome  # Linux/Mac
where chrome        # Windows

# 安装必要依赖（只需一次）
pip install websockets

常见问题与解决

问题1：显示"代理错误"或"SOCKS错误"

可能原因：VPN或网络代理干扰 解决方法：

1. 完全关闭VPN软件
2. 检查系统网络设置，确保没有代理
3. 重新运行技能 ⚠️ 不要尝试安装python-socks等库，这无法解决问题

问题2：技能没有反应

可能原因：Chrome浏览器未打开或未登录 解决方法：

1. 手动打开Chrome浏览器
2. 访问 https://mp.weixin.qq.com 并扫码登录
3. 重新使用触发词激活技能

问题3：保存失败或超时

可能原因：网络不稳定或页面未加载完成 解决方法：

1. 检查网络连接是否稳定
2. 手动刷新微信公众号页面
3. 等待页面完全加载后再试

典型失败场景与建议

• 报错含 SOCKS / python-socks / proxy
  可能原因：系统开了 VPN 或全局代理。
  建议：关闭 VPN/代理后重试，不要改技能代码或装 python-socks。

• Chrome 已开但检测不到公众号页
  可能原因：未用本技能指定的调试端口、或未打开 mp.weixin.qq.com。
  建议：用 --port 指定端口，或在技能拉起的 Chrome 里打开公众号并扫码。

• 等待超时（长时间未检测到登录）
  可能原因：未扫码、或扫码后会话被踢出/过期。
  建议：在技能使用的 Chrome 窗口内重新扫码，保持页面在公众号首页或草稿相关页。

• 草稿创建失败 / 退出码非 0
  可能原因：页面结构变化、网络中断、或公众号风控。
  建议：查看 skill.log 最后几行；刷新公众号页后重试；必要时检查页面元素是否变更。

快速检查步骤

如果遇到问题，按顺序检查：

1. ✅ Chrome是否已打开？
2. ✅ 是否已登录微信公众号？
3. ✅ VPN是否已关闭？
4. ✅ 网络连接是否正常？
5. ✅ 微信公众号页面是否能正常访问？

文件结构

wechat-tietu-draft/
├── skill_main.py              # 统一入口（含 Chrome 启动 + 环境检测 + 调子进程）
├── wechat_tietu_draft.py      # 由 skill_main 子进程调用，勿直接运行
├── examples/                        # 示例目录
│   └── sample_tietu.txt             # 贴图内容示例（纯文本）
├── requirements.txt                 # Python 依赖
├── SKILL.md                         # 本技能说明
├── skill.log                        # 运行日志（执行时生成，可忽略）

许可证

MIT License

支持

如有问题，请查看：

1. 本文件中的「常见问题与解决」「故障排除」章节
2. examples/sample_tietu.txt 示例文件
3. 运行日志 skill.log（执行技能后生成）

维护者说明

• 默认 CDP 端口：19222（与常见教程 9222 错开，可用 --port 覆盖）。等待登录最长秒数可通过环境变量 TIETU_MAX_WAIT 覆盖（默认 300）。
• 入口与子进程：用户仅需运行 skill_main.py --file <文章.txt>；skill_main.py 负责环境检测、Chrome 启动、等待就绪，再以子进程调用 wechat_tietu_draft.py 执行实际草稿写入。勿直接运行 wechat_tietu_draft.py。
• OpenClaw 集成：推荐调用方式为传入 .txt 文件路径并执行 python3 skill_main.py --file <路径>；技能会输出可解析的 STAGE: 行（如 CHROME_STARTED、LOGIN_CONFIRMED、DRAFT_CREATED_OK、DRAFT_FAILED、LOGIN_TIMEOUT）便于上游汇总状态。

未来计划

• 多账号 / 多 Chrome Profile 支持（当前为单端口单实例）。
• 微信公众号页面结构若改版，可能需更新元素选择器。

提示: 微信公众号页面结构可能变化，如遇到问题请检查元素选择器是否需要更新。