843645440/wechat-skill/wechat-inline-visuals

微信公众号原生信息模块

从 article.md 提取 0—3 个语义模块，再由流水线固定渲染器把正文和模块一次写入 article.html。最终模块是公众号正文 HTML，不是 PNG。

输入

必须同时取得：

• 最终 article.md。
• 本轮已固定的主题标识。

先读 references/plan-schema.md 与 references/plan-shell-coerce.md。theme-component-map.md 仅保留为旧组件对应关系参考，流水线不再要求 Agent 按它手工组装 HTML。

工作流

被 wechat-content-pipeline 调用时，本 Skill 只负责一次生成 inline-visuals.json；随后立即交还 pipeline_runtime.py finish。不要自行运行校验器或渲染器，因为统一运行器会机械完成校验、降级和排版。下面的校验与渲染步骤只用于单独调用本 Skill 的场景。

1. 从文章已有内容识别最值得扫读的结构。优先顺序为：核心影响对象、清晰二元对比、真实流程、已核实数据。
2. 只在内容自然成立时选 1—3 个模块；没有合适内容时输出空 modules，不得为凑数量制造结构。

正文已经用 Markdown 表格或列表清楚表达的一组信息不得再次包装成对比、指标或观点模块。

1. 只尝试一次，写入 inline-visuals.json。顶层必须且只能包含 version（固定为 1）、theme（与本轮固定主题完全一致）、modules（0—3 项）。空计划也必须写成：

{"version": 1, "theme": "<SELECTED_THEME>", "modules": []}

禁止只写 {"modules": []} 或漏掉 version/theme。每个模块记录原文锚点和原文证据。placement.after_text 必须直接复制所在章节中一段短、连续、唯一的原文，不得概括改写；优先取完整短句或能唯一定位的半句。evidence 同样复制原文连续片段。正文含 **、__、反引号、==、++ 或 <u> 等行内 Markdown 时，计划里使用读者可见的纯文本；校验器与渲染器必须使用同一套“仅移除行内标记、保留文字和标点”的规范化规则，不能因排版标记误判，也不能退化为模糊语义匹配。运行：

python3 <SKILL_ROOT>/scripts/validate_plan.py \
  --plan <WORK_DIR>/inline-visuals.json \
  --article <WORK_DIR>/article.md \
  --theme-index <PROJECT_ROOT>/references/theme-index.md \
  --degrade-on-error --fallback-theme <SELECTED_THEME>

1. 校验失败时接受脚本生成的当前主题空计划，不修改字段、不重新提取、不重试。若降级原因是“锚点/证据不是原文”，维护时先区分真正改写与 Markdown 标记误杀；后者应修校验器并加回归测试，而不是放宽为模糊匹配。具体案例和测试要点见 references/anchor-normalization.md。
2. 调用 wechat-content-pipeline/scripts/render_article.py，由固定组件按 placement.after_heading 和 placement.after_text 一次完成正文与模块排版。不得手工复制主题组件，不得为当前文章新写 Python、HTML 模板或二次插入脚本。
3. 渲染器若发现插入异常，会把计划降级为空并保留完整纯正文 HTML；记录降级原因后继续。最后运行根目录的 validate_gzh_html.py，ERROR、WARNING、占位符必须全部清零。

提取边界

• insight：2—4 个受影响对象、成本承担者或关键判断。
• comparison：两个对象或阶段在同一维度下的真实差异。
• process：正文明确支持的 3—5 个连续环节。
• metrics：2—4 个正文中已核实的数据；没有可靠数字时改用 insight。

字段名硬坑（曾整包降级）

• 顶层只能是 version / theme / modules；空计划也必须三字段齐全。
• insight.items：label + text（不是 title/name）。
• `process.steps`：`label` + `text`。禁止 `name` 或 `title`。 写 name 会触发 包含未知字段：name，校验失败后 modules 被清空。
• comparison：left/right 各含 heading + items[]。
• metrics：条目用 value + label + 可选 note；value 必须原样出现在正文。
• 完整示例见 references/plan-schema.md。写 plan 前对照 schema，不要凭记忆猜键名。

同篇不要重复模块类型，不要连续插入两个模块，不要把标题、导读或结尾 CTA 重新包装成模块。 表格由正文渲染器直接按当前主题处理，不新增 table 信息块类型。

硬性限制

• 不新增事实、数字、公司表述、人物、引用、因果关系或作者经历。
• 不把推测压缩成事实，不删除“可能”“短期内”“仍取决于”等限制条件。
• 模块内容只能来自 article.md 正文已有信息，不引入正文之外的来源材料。
• 不生成正文 PNG、SVG 文件或截图，不调用 Agnes、Baoyu 或任何图片模型。
• 输出必须遵守根排版 Skill 的微信红线：内联样式、<span leaf="">、无 class、无 <style>、无 Grid 和复杂定位。

完成标准

inline-visuals.json 是通过校验的计划或明确降级后的空计划；文章原文完整保留；最终 article.html 严格校验为零错误、零警告。记录 module_count、kinds 和 degraded。计划或插入失败只降级一次，不阻塞草稿流程。