文件转微信

将任意格式的文件（PDF、Word、Excel、PPT、图片、音频、网页等）一站式转换为精美的微信公众号文章，并发布到草稿箱。

面向用户的承诺

支持如下请求形式：

• “把这个 PDF 发到我的微信公众号”
• “帮我把这个 PPT 转成公众号文章”
• “把这个 Excel 报表发布到微信”
• “把这张图片变成微信文章”
• “把这段音频转成公众号文章”
• “把这个网页内容发到我的公众号”

直接返回已发布的草稿（位于微信草稿箱中），而非仅提供方案或预览。

与 anything-to-wechat 的区别

当用户提供 anything-to-wechat 不原生支持的文件类型（如 PPTX、XLSX、图片、音频、EPUB、ZIP）时，请使用本技能。

首次配置

1. 安装 Python 依赖

python -m pip install markitdown markdown beautifulsoup4 requests

2. 安装配套技能

本技能依赖 anything-to-wechat 技能中的 publish_to_wechat.py。请通过 ClawHub 安装：

clawhub install anything-to-wechat

3. 配置微信凭证

你需要一个具备 API 权限的微信服务号或订阅号（需开通开发者权限）。

获取凭证步骤：

1. 登录 https://mp.weixin.qq.com/
2. 进入：设置与开发 → 基本配置
3. 复制你的 AppID，并重置或查看 AppSecret
4. 将你服务器的公网 IP 添加至 IP白名单

设置环境变量（推荐方式）：

在 macOS / Linux 上 —— 将以下内容添加至 ~/.bashrc 或 ~/.zshrc：

export WECHAT_APP_ID="your_appid_here"
export WECHAT_APP_SECRET="your_appsecret_here"

在 Windows 上 —— 使用 PowerShell 执行：

[Environment]::SetEnvironmentVariable("WECHAT_APP_ID", "your_appid_here", "User")
[Environment]::SetEnvironmentVariable("WECHAT_APP_SECRET", "your_appsecret_here", "User")

未设置环境变量？ 发布脚本会在首次运行时交互式提示 —— 只需按提示粘贴 AppID 和 AppSecret 即可。

4. 验证配置

python -c "from markitdown import MarkItDown; print('markitdown OK')"
python -c "import markdown; print('markdown OK')"

前置依赖

工作流程

阶段 1：收集输入

若用户尚未提供源文件，请使用 AskUserQuestion 主动询问：

Question: "请提供你想发布到微信公众号的文件"
Options:
  - "提供文件路径" (PDF, DOCX, PPTX, XLSX, images, audio, etc.)
  - "粘贴 URL" (web page or YouTube video)
  - "选择文件夹" (batch convert)

若用户已提供文件路径或 URL，则跳过此步，直接进入下一阶段。

阶段 2：文件转 Markdown

重要：务必全程使用 UTF-8 编码。 Windows 控制台默认编码为 GBK，会导致中文乱码。请在 Python 中对所有文件 I/O 显式指定 encoding='utf-8'，并在控制台输出前调用 sys.stdout.reconfigure(encoding='utf-8')。

首选方式：markitdown pip 包（免费、无需 API Key、始终可用）

python -c "
import sys; sys.stdout.reconfigure(encoding='utf-8')
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert(r'')
with open(r'/article.md', 'w', encoding='utf-8') as f:
    f.write(result.text_content)
print('Done, length:', len(result.text_content))
"

备选方式：all-to-markdown 技能（如已安装）

bash "/scripts/run.sh" "" -o "/article.md"

回退方式：markdown-anything（云端 API，需 MDA_API_TOKEN）

MDA_API_TOKEN="" bash "/scripts/convert.sh" "" > "/article.md"

转换完成后：以 encoding='utf-8' 读取 Markdown 输出；检查其结构（标题层级、表格、图片、代码块等），用于指导后续 HTML 生成风格。

阶段 3：生成兼容微信的 HTML

两种实现方式，请根据内容复杂度选择：

方式 A：使用 md_to_wechat_html.py（快速、适合结构化文档）—— 推荐首选

python "/scripts/md_to_wechat_html.py" 
  --input "/article.md" 
  --output "/wechat_article.html" 
  --title ""

该脚本将 Markdown 直接转换为适配微信的内联样式 HTML，并内置 Clockless 设计规范，无需额外 CSS 内联步骤。

方式 B：使用 html-anything（设计更丰富，适合复杂内容）

1. 加载 html-anything 技能。
2. 将 Markdown 内容作为源输入。
3. 遵循 html-anything 工作流，并严格遵守微信兼容规则（仅允许内联样式、浅色背景、禁用 CSS 变量、最大宽度 680px、系统字体）。
4. 再运行 anything-to-wechat 提供的转换脚本：

python "/scripts/convert_for_wechat.py" 
  --input "/wechat_article.html" 
  --output "/wechat_article_final.html"

选择指南：

• PPTX、XLSX、数据密集型内容 → 方式 A（结构清晰、表格友好）
• 长篇议论文、研究报告、叙事性内容 → 方式 B（视觉表现力更强）
• 图片、音频转录文本 → 方式 A（布局简洁）

阶段 4：生成封面图

使用 ImageGen 工具，基于文章主题与核心内容生成提示词（prompt）。

• 保存为 wechat_cover.png 至 workspace 目录。
• 尺寸要求：1024x768（符合微信封面图 4:3 比例）。
• 确保视觉吸引力强、信息传达明确。

阶段 5：发布至微信草稿箱

重要：Windows 系统下，请使用 Python subprocess 传递环境变量。
set VAR=val && python ... 在 Windows CMD 中不可靠。

跨平台推荐方式：

python -c "
import os, subprocess, sys
os.environ['WECHAT_APP_ID'] = ''
os.environ['WECHAT_APP_SECRET'] = ''
result = subprocess.run([
    sys.executable,
    r'/scripts/publish_to_wechat.py',
    '--file', r'/wechat_article.html',
    '--title', '',
    '--cover', r'/wechat_cover.png',
    '--digest', ''
], capture_output=True, text=True, encoding='utf-8')
print(result.stdout)
print(result.stderr)
"

或已在系统中设置了环境变量：

python "/scripts/publish_to_wechat.py" 
  --file "/wechat_article.html" 
  --title "" 
  --cover "/wechat_cover.png" 
  --digest ""

凭证说明：publish_to_wechat.py 从 WECHAT_APP_ID / WECHAT_APP_SECRET 环境变量读取凭证。若未设置，脚本将交互式提示，用户只需粘贴 AppID 和 AppSecret 即可。

阶段 6：确认与交付

成功发布后，报告 Media ID 并附上微信公众平台链接：https://mp.weixin.qq.com/。

向用户明确告知：“文章已发送到你的微信公众号草稿箱，请登录微信公众平台审核后一键发布。”

微信 HTML 兼容性规范

与 anything-to-wechat 完全一致：

• 仅允许内联样式（禁止