tomevault-io 微信公众号自定义主题应用工具 (WeChat Custom Theme Applier)
这是一个专门为 AI Agent 设计的技能，用于将本地生成的自定义 CSS 主题应用到 Markdown 文章中。它支持通过 wenyan-cli 进行本地预览、主题注册以及一键推送到微信公众号草稿箱。
前置要求
- 环境配置：必须设置
WECHAT_APP_ID和WECHAT_APP_SECRET环境变量。 - 依赖工具：已安装
wenyan-cli(pnpm add -g @wenyan-md/cli)。 - 必要文件：本地已存在 Markdown 文件 (
.md) 和 CSS 主题文件 (.css)。
核心能力
- 本地测试渲染：在发布前验证 CSS 样式的正确性。
- 一键发布草稿：直接应用本地 CSS 将文章推送到公众号草稿箱。
- 主题持久化：将优秀的自定义主题注册到
wenyan-cli主题库中，方便后续调用。
AI Agent 指令指南：工作流 SOP
当用户要求“应用生成的 xxx.css 并发布 yyy.md”时，Agent 必须 遵循以下标准操作流程：
Step 1: 测试渲染 (Render Test) [强制]
在正式发布前，必须先进行模拟渲染，以确保 CSS 语法正确且文件路径有效。
- 命令：
wenyan render -f <markdown_file_path> -c <css_file_path> - 验证：如果输出包含
<div id="wenyan">的 HTML 字符串且无报错，则说明正常。
Step 2: 正式发布 (Publish to Draft)
测试通过后，使用该 CSS 文件将文章推送到微信公众号草稿箱。
- 命令：
wenyan publish -f <markdown_file_path> -c <css_file_path> - 可选参数：
--no-mac-style：禁用代码块 Mac 风格窗口。-h <highlight_theme>：指定代码高亮主题（如atom-one-dark）。
Step 3: 注册主题 (Register Theme) [按需]
如果用户表示需要长期使用该主题，应将其注册到本地主题库。
- 命令：
wenyan theme --add --name <theme_name> --path <css_file_path> - 后续调用：注册后可直接使用
-t <theme_name>参数发布。
故障排除 (Agent 专用)
- 文件不存在：检查
ENOENT报错，确认 Markdown 或 CSS 文件路径是否正确。 - 样式未生效：检查 CSS 选择器是否缺少
#wenyan前缀。 - 凭证错误：如果微信 API 返回
invalid credential，提示用户检查WECHAT_APP_ID和WECHAT_APP_SECRET环境变量。
Source: caol64/wenyan-cli — distributed by TomeVault.