القائمة
将 Markdown 文章转换为微信公众号可用的内联样式 HTML，支持多主题切换、结构化组件和 SVG 开场动画。用于公众号排版、文章 HTML 生成、替代不稳定外部排版服务。默认纯净排版,加 --components 启用 Agent 智能改写(组件+开场动画)。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/zjp1997720/zhijian-skills --skill wechat-stylerيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Install, audit, repair, and manage Codex custom model Providers and model catalogs backed by a loopback CLIProxyAPI or Codex Router. Use whenever the user asks to add, remove, upgrade, restore, or diagnose third-party models in Codex or the Codex desktop model picker; mentions Grok, OpenCode Go, DeepSeek, Gemini, GLM Coding Plan, GLM-5.3, subscription-backed CLI models, custom model_provider, model_catalog_json, or Codex Fast mode; or wants the same local proxy models synchronized between Codex and WorkBuddy. Preserve unrelated Codex configuration and credentials. Isolated profile is the default Windows path.
Install, audit, repair, and manage a loopback-only CLIProxyAPI bridge that registers subscription-backed Codex, Grok, Antigravity/Gemini, GLM Coding Plan, or newly added CLI models in WorkBuddy. Use whenever the user asks to connect a local CLI or agent model to WorkBuddy, install CLIProxyAPI, add GLM-5.3 from a Coding Plan key, add or repair a WorkBuddy custom model, preserve image/tool/reasoning/Fast capabilities, onboard another CLI provider, or diagnose a WorkBuddy model that stopped working. This Skill is macOS-first and should be used even when the user names only the model or says their local WorkBuddy API has expired.
从 WorkBuddy、Claude Code 或其他本地 Agent 无头调用 Codex App Server，创建可见、命名、持久的 Codex Thread，并执行继续追问、状态查询、结果取回、取消和打开。用于复杂研究、跨项目取材、章节审校、确定性工程或重要决策；一次性格式检查和无需保留上下文的小提取继续用 codex exec --ephemeral，Codex 内部组队不走本 Skill。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | wechat-styler |
| slug | wechat-styler |
| displayName | WeChat Styler |
| version | 1.9.0 |
| description | 将 Markdown 文章转换为微信公众号可用的内联样式 HTML，支持多主题切换、结构化组件和 SVG 开场动画。用于公众号排版、文章 HTML 生成、替代不稳定外部排版服务。默认纯净排版,加 --components 启用 Agent 智能改写(组件+开场动画)。 |
| summary | Markdown → 公众号 HTML，多主题 + 组件 + SVG 开场动画。 |
| tags | ["wechat","markdown","html","publishing","design"] |
| license | MIT |
将 Markdown 文章转换为优雅的公众号 HTML，支持多主题切换、结构化组件和 SVG 开场动画。
# 默认模式（纯净排版，无组件无动画）
/wechat-styler path/to/article.md
/wechat-styler path/to/article.md --theme kami
# 组件模式（Agent 智能改写 + 开场动画 + 8 种结构化表达）
/wechat-styler path/to/article.md --components
# 丰富组件模式（仅在用户明确要求“激进一点 / 多用组件”时启用）
/wechat-styler path/to/article.md --components --component-density rich
# 批量转换
/wechat-styler "articles/*.md" --theme kami
# 输出到指定路径
/wechat-styler path/to/article.md --output path/to/output.html
两种模式：
--components）：Agent 分析文章结构，智能改写 Markdown，自动加开场动画。生成前向用户确认。组件密度由 Agent 改写层控制，不传时保持 standard：
| 密度 | 触发方式 | 结构组件预算 |
|---|---|---|
restrained | 用户说“克制、少组件、轻排版” | 2-4 个 |
standard | 默认 | 3-6 个 |
rich | 用户说“激进一点、丰富一点、多用组件” | 7-12 个；超过 8000 字可到 14 个 |
普通图片、正文引用和行内高亮不计入结构组件预算。密度只改变组件候选数量，不放宽防重复、卡片短文本和微信兼容规则。
| 主题 | 命令 | 风格 | 适用场景 |
|---|---|---|---|
| zhijian（默认） | --theme zhijian | 暖纸感 × 顾问可信度 | 智见AI 品牌内容 |
| kami | --theme kami | 纸感编辑排版 | 深度文章、商业分析 |
| magazine-ink | --theme magazine-ink | 墨水经典杂志 | 通用杂志内页 |
| magazine-indigo | --theme magazine-indigo | 靛蓝研究风 | 技术研究、深度调研 |
| magazine-forest | --theme magazine-forest | 森林田野笔记 | 非虚构、自然叙事 |
| elegant | --theme elegant | 优雅复古 | 商业案例、知识分享 |
| modern | --theme modern | 现代简约 | 科技产品、教程 |
| minimal | --theme minimal | 极简主义 | 哲学思考、个人随笔 |
主题详情、YAML 参数、扩展指南见 references/theme-guide.md。
用户只给文件路径和主题，Agent 直接调用 convert.mjs 转换，不做 Markdown 改写。
--components）Agent 不直接调用 convert，先执行 5 步智能改写流程：
写作层前置硬门：先检查段落密度
WeChat Styler 不负责把拥挤长段自动切开。段落边界属于写作语义，渲染器按标点拆段会破坏作者节奏。组件改写前先运行：
npm run qa:density -- /absolute/path/to/article.md --strict
如果失败，停止排版，回到上游 Markdown 按事实、判断、机制、例子、边界和行动的切换点拆段。不要用缩小字号、放大行高或增加组件掩盖正文阅读墙。
第 1 步：分析文章结构
读完整篇 Markdown，识别适合用组件呈现的内容（表格→对比卡片、流程→步骤块、金句→金句块等）。只改写确实适合的内容，并按 component-density 执行预算；未指定时使用 standard 的 3-6 个。详见 references/component-guide.md。
⛔ 防重复硬规则：金句块/提示块/警告块的核心原则是替换原文，不是追加。如果原文已经把同样的意思说清楚了，不要在原文后面追加组件重复一遍。正确做法是删掉原文的概括句，只保留视觉权重更高的组件；或者原文已完整表达时不加组件。生成前必须全文扫描确认无重复。
⛔ 围栏格式硬规则：:::compare / :::flow / :::timeline 必须独占一行，前后留空行。紧跟正文的 :::compare 不会被解析，会以原始 markdown 显示。
第 2 步：提取开场动画参数
从文章内容推断标题（frontmatter.title）、副标题（核心观点一句话）、标签（3个以内关键词），并选择模板（见下）。
第 3 步：向用户确认
组件改写计划:
• 开场动画(typewriter): 标题「初识 WorkBuddy」/ 副标题「...」/ 标签: ...
• 「专家对比表」→ 对比卡片
• 「Ask/Plan/Craft」→ 对比卡片
• 「用好 WorkBuddy 的核心」→ 金句块
确认后开始生成?
第 4 步：生成前检查（必做）
调用 convert 之前，必须对改写后的 Markdown 逐条检查 references/component-guide.md 的「生成前检查清单」：
:::compare / :::flow 围栏是否独占一行第 5 步：生成
在内存中改写 Markdown（不改原文件），然后调用 convert：
node scripts/convert.mjs /tmp/rewritten.md --theme zhijian --components \
--strict-density \
--cover --cover-template typewriter \
--cover-title "..." --cover-subtitle "..." --cover-tags "..."
--components 启用时自动包含 --cover（开场动画）。
生成 HTML 后，zhijian 主题必须执行移动端视觉检查：
npm run qa:mobile -- /absolute/path/to/article.html \
--expect-zhijian --strict-image-uniqueness \
--screenshot /tmp/article-mobile.png
检查项包括 390px 视口横向溢出、坏图、图片 URL 异常重复、引用符号与首行同段对齐、引用是否误用左侧竖线、H2 暖陶色层级。失败时先修排版，再注入公众号。
convert.mjs 默认会打印段落密度软门报告；正式发布候选必须传 --strict-density。该门自动阻止明显的阅读墙；连续超短段只提醒人工检查，不能仅凭数量判失败。渲染器不自动修改正文。
--components 模式自动包含开场动画。SVG SMIL 动画只在首次加载时播放，因此只做开场，其他位置用静态组件。
| 模板 | 参数值 | 气质 | 适配 |
|---|---|---|---|
| 墨韵开篇 | ink-wash (默认) | 仪式感·墨点晕染 | 方法论、品牌、课程 |
| 打字机流 | typewriter | 极客感·逐字打字·光标跟随 | 技术教程、工具介绍 |
| 画卷展开 | scroll-painting | 叙事感·双横线·渐入佳境 | 案例、复盘、故事 |
| 聚焦聚光灯 | spotlight | 判断感·聚光·标题缩放 | 观点、评测、趋势 |
| 极简白描 | minimal-sketch | 克制·留白·呼吸圆点 | 随笔、思考、感悟 |
Agent 选定模板后，在确认环节明确告知用户："我选了 X 模板，因为文章有 Y 特征，你可以换。" 不确定时默认 ink-wash。
模板设计原则和踩坑清单见 references/svg-animation-design.md。
微信编辑器的粘贴过滤器会剥离 <animate> 标签。当前稳定路径是用 OpenCLI 直接操作 DOM：
export OPENCLI_PROFILE="<your-opencli-profile>"
export WX_EDITOR_URL="https://mp.weixin.qq.com/..."
node scripts/inject-to-wechat.mjs article_wechat.html
发布后端选择规则： Codex 内置 Chrome 只有在公众号编辑页允许 DOM 访问和写入时才可能成为注入后端。当前 Chrome Browser 安全策略会在 mp.weixin.qq.com/cgi-bin/appmsg 拒绝页面访问，并明确禁止通过 CDP 绕过，因此不能用来注入或验证 SVG 动画。遇到该策略拦截时直接使用 OpenCLI；不得改走 CDP、其他浏览器自动化或间接脚本规避。未来只有在同一编辑页完成“只读探测 → 正文写入 → <animate> 回读 → 草稿保存”四项实测后，才能调整默认后端。
稳定发布模式：
node scripts/inject-to-wechat.mjs article_wechat.html \
--reuse-current \
--title "公众号标题" \
--summary "转发摘要" \
--sync-cover-from-body \
--cover-file /path/to/local-cover.jpg \
--save-draft \
--report /tmp/wechat-publish-report.json
--cover-file 是推荐的明确封面入口：已有封面时会替换为指定文件；没有封面时会自动打开图片库、上传本地封面、选择素材，并依次完成“下一步”和裁剪确认。只使用 --sync-cover-from-body 且不传文件时，才会优先沿用已有封面或从正文选择第一张图。本地封面建议使用 2.35:1，超过 180KB 时在 macOS 自动压成适合页面注入的 JPEG。
注入器会轮询定位正文编辑区，避开标题 ProseMirror；同步标题、摘要；自动压缩超过 2MB 的远程图片；等待微信完成图片转存；把 mmbiz.qlogo.cn、mmbiz.qpic.cn 和 wx.qlogo.cn 都视为微信已接管的图片；保存后通过“出现新的 appmsgid”或“已有 appmsgid + 本次保存提示/历史变更”确认草稿，并验证 SVG、动画、图片和正文首尾。history 等页面字段缺失时会归一化为空数组，不再触发脚本异常。
发布命令应始终带 --report。成功报告包含 cover.strategy、图片状态和保存证据；任何阶段失败也会写入 mode: "failed"、phase、脱敏后的错误、只读现场状态与可直接执行的恢复动作。使用 --verify-only --reuse-current 可以只读检查已经打开的草稿。
详细流程见 references/opencli-injection.md。
--components 模式启用 8 种结构化表达。默认模式下组件语法优雅降级成普通 markdown。
| 组件 | 语法 | 适用场景 |
|---|---|---|
| 金句块 | > **核心观点** | 文章核心论点 |
| 轻量标记 | ==关键词== | 正文关键词强调（底部细线） |
| 提示块 | > [!NOTE] 内容 | 补充说明、技术旁注 |
| 警告块 | > [!WARNING] 内容 | 注意事项、踩坑提醒 |
| 步骤序号 | 1. [step] 动作 | 操作流程、动作清单 |
| 流程卡片 | :::flow 围栏 | 阶段流程 |
| 对比卡片 | :::compare 围栏 | 方案 A vs B vs C |
| 时间线 | :::timeline 围栏 | 演进历程、项目复盘 |
完整语法示例和设计原则见 references/component-guide.md。
设计原则： 克制优于装饰 · 颜色从主题取 · 横向卡片 flex:1 等分优先 overflow 兜底 · 矩阵对比保留 table · 卡片内容要短 · 默认沉默
| 参数 | 说明 | 默认值 |
|---|---|---|
--theme | 主题名称 | zhijian |
--font-size | 正文字号（px） | 主题默认 |
--line-height | 行高 | 主题默认 |
--accent-color | 强调色 | 主题默认 |
--background-color | 背景色（solid hex） | 主题默认 |
--max-width | 内容最大宽度（px） | 640 |
--output | 输出文件路径 | <input>_wechat.html |
--components | 启用组件模式（智能改写+动画+组件） | false |
--component-density | Agent 改写层组件密度：restrained / standard / rich，不传给 convert.mjs | standard |
--strict-density | 段落密度失败时停止生成；正式发布候选必传 | false |
--cover | 生成开场动画（--components 自动包含） | false |
--cover-template | 开场动画模板 | ink-wash |
--cover-title | 开场动画主标题 | 从 frontmatter.title 取 |
--cover-subtitle | 开场动画副标题 | 从 frontmatter.summary 取 |
--cover-tags | 开场动画标签(逗号分隔) | 无 |
zhijian 当前视觉基线为 editorial-weighted-2026-07：H2/H3 使用仓耳今楷优先栈，正文使用思源宋体 VF 15px / 450 / 1.68，图注和元信息使用思源黑体 13px。大鹏已确认 15px 在手机端阅读更舒服；450 字重补回纸面阅读的稳定感。字号只控制显示尺度，不能替代内容层的段落修复。建议：
写作时图床还没准备好？在 Markdown 里写占位符，convert 会渲染成居中虚线灰框：
【插入:文章开头的视频截图】
只支持独占一行的 【插入:xxx】（全角方括号）。
path/to/article.md → 输出：path/to/article_wechat.htmlvalidate.mjs 软门校验（不阻断，打印报告）兼容硬规则详情见 references/wechat-compatibility.md。
| 文件 | 内容 |
|---|---|
references/theme-guide.md | 8 主题完整配置、Renderer Presets、扩展指南、技术实现 |
references/component-guide.md | 8 种结构化表达的语法示例、设计原则与智能改写规则 |
references/svg-animation-design.md | 5 模板设计原则、技术约束、11 条踩坑清单 |
references/wechat-compatibility.md | 公众号兼容硬规则（ERROR/WARN 详情） |
references/opencli-injection.md | OpenCLI 注入流程、浏览器能力边界、前置条件与故障恢复 |
references/zhijian-theme-baseline.md | Zhijian 主题版本对照、样式锁与移动端视觉基线 |
版本： 1.9.0 · 作者： 大鹏