公众号排版引擎·专业版3.0配图版

概述

公众号排版引擎 Pro 1.4.0（本地待验收）

把一篇已经写好的中文母稿，变成真正接近发布状态的公众号图文成稿。

默认先免费排好你的手机首屏，再决定要不要做完整篇。 用户也可选“直接制作整篇”，但这不是免费直出：先展示实时价格及宿主模型/生图可能消耗的积分，明确同意并在线核验付款后才制作全文。首屏可复制使用；不继续也可以留下。免费指免本 Skill 任务费，宿主模型仍可能消耗积分。

付款与积分红线

• 面向用户只显示“先免费预览一小段”与“直接制作整篇（先确认价格并付款）”；不得把后者写成“直接交付全部”。
• 完整分析、全文重排、完整图片计划、任何 ImageGen 调用及完整 HTML 生成之前，必须运行 python scripts/pay_gate.py verify 在线核验原订单。只相信本地 payment-state.json 或用户口头称已付款均不够。
• 付款前不得生成完整 publishing.html、publish-workbench.html，不得自写脚本绕过受控构建入口。支付工具不可用、核验失败或取消时停止，不改用“先生成再补付款”。
• 免费阶段不调用 ImageGen。付款在线核验后，首次生图前还要说明预计张数、用途和可能额外消耗的宿主积分，得到明确同意；否则使用纯文字、授权原图或确定性信息图。付款不等于授权无限次生图。
• 本地门禁能减少正常路径误绕过，但通用 Agent 理论上仍可自写文件；不得宣称本 Skill 的收费“技术上无法绕过”。

它不只是换字体、套模板或在文末堆几张图片，而是先判断文章在讲什么、读者下一眼应该看哪里、哪些段落需要真实证据、哪些概念适合用图片解释，再完成文字、图片、图注、来源和行动区的整体阅读节奏。

最终可以得到什么

• 无脚本、可编辑文字、图片已经穿插到正确位置的安全浅色 publishing.html，不依赖深色背景承载浅色文字。
• 默认打开、带“复制标题”“复制到公众号（正文）”和纯文字回退的 publish-workbench.html。作者栏在公众号后台单独填写。
• 无脚本的 publishing.html 作为公众号正文源与回退资产，不作为用户默认打开的主成品。
• 用户图片、AI生成图片和数据图组成的图片资产包。
• article-image-manifest.json：记录图片作用、位置、来源、alt、图注和生成披露。
• 版式说明、图片授权与生成清单、兼容检查报告。
• 当前环境允许时完成桌面与390像素手机浏览器验收。

以下三张为已部署的既有案例图，展示预览、图片和复制工作台的交付形式；它们不是 V1.4 五种构图的固定模板。新版效果以本次真实文章首屏与最终成稿为准。

先选风格与配图，同一篇也能形成不同阅读气质

付款前可先看到接近完整成品的手机首屏

完整成品默认打开复制工作台

案例用于展示能力范围，不承诺逐像素复制示例或第三方作品。正文、图片和视觉语言会根据本次内容重新组织。

五种配图策略

• 纯文字排版：不强行配图，使用克制的编辑排版、引用和信息层级。
• 使用已有图片：整理用户已有照片、截图、图表和品牌素材。
• 信息图：关系、步骤、对比和数据使用确定性 HTML 或图表，不让图片模型猜文字和数字。
• AI 编辑插画：仅在付款和积分确认后调用宿主 ImageGen，生成非证据类编辑插画或氛围图。
• 图文混合：真实证据优先、确定性信息图解释结构，AI只补视觉记忆点；并非默认必须生图。

用户不需要为本 Skill 单独配置模型或 API Key。用户选择AI插画/混合后，先检测其当前环境里真实可用的 ImageGen；可用也不自动批量调用，须先确认张数与可能消耗的宿主积分。不可用时降级为授权原图、确定性信息图或纯排版，不假装已经生成；支付网关不接收文章正文，也不代用户生图。

开始前确认

至少获取：

• 正文、Markdown或已授权公开内容。
• 目标读者与读完后希望发生的动作。
• 是否需要图片，以及选择五种图片模式中的哪一种。
• 用户图片的来源、授权、人物隐私与是否允许裁切。
• 必须保留的品牌色、Logo、署名、二维码或栏目元素。

需求不明确时只询问会改变结果的问题。首次预览前用一次简短的全中文选择确认“视觉方向＋配图策略”，默认推荐项放第一位并说明理由；除五种预设外，必须允许用户自己描述风格或给参考。用户看到的配图选项必须是“纯文字排版、使用我提供的图片、信息图、AI 编辑插画、图文混合”；内部英文代码只进入数据文件，不得直接暴露在选择框。用户说“直接做”时展示“已为你选择：视觉方向＋配图策略”与改选入口，然后进入报价付款，不能生成全文。内容类型判断读取 [content-archetypes.md](references/content-archetypes.md)；视觉选择读取 [style-families.md](references/style-families.md)；用户提供参考链接或截图时读取 [reference-layout-audit.md](references/reference-layout-audit.md)。

内容与视觉路由

内容类型决定信息顺序和图片角色，视觉 family 决定字体、留白、颜色、边框和图注方式，两者不要混为固定模板。

• 教程与工具：真实截图、步骤和结果优先。
• 知识与方法：解释图、关系图和章节记忆点优先。
• 财经、政策、健康和数据：证据、口径、来源与风险优先；AI图不得冒充证据。
• 人物、品牌和活动：已授权人物、现场和产品素材优先。
• 旅行、生活和文化：图片可以主导节奏，但仍保留实用信息与出处。

视觉决策读取 [editorial-contract-v1.4.md](references/editorial-contract-v1.4.md)、[style-families.md](references/style-families.md)、[variation-matrix.md](references/variation-matrix.md)、[layout-grammar.md](references/layout-grammar.md) 与 [component-grammar.md](references/component-grammar.md)。组件按语义选择，每篇只使用必要的种类，不把气泡、卡片和贴纸当作装饰堆叠。视觉线索不能只剩文字清单：文章确有“目标、边界、证据”等不同任务时，首屏与全文可用内置许可 PNG 图标做三项导览；流程和分层分别用确定性的 path、tiers 图解，不调用 ImageGen。无对应语义或用户明确要无图标时不要硬塞图标。五个预设的首屏和全文分别使用不同构图；用户自定义风格保留其原话与参考的抽象设计要点，生成安全视觉契约，不强塞进某个现成模板。

V1.4 的首屏和付费全文共用同一 style_profile、custom_style（如有）及 style_digest。首屏由 scripts/editorial_preview_renderer.py 渲染；正式完整稿优先由 scripts/render_full_article.py 按文章结构渲染。旧版 scripts/wechat_safe_html.py 的统一重着色只用于老稿事故恢复；V1.4 成稿保留经过浅底、高对比度与安全标签检查的内联版式。用户明确要求预设之外的风格且组合语法仍无法表达时，可原创制作安全内联 draft.html，但仍须经过相同视觉契约与安全验证，不承诺逐像素复刻参考。

正式生成流程

路线 A：先免费生成真实手机首屏

1. 读取本次授权正文，判断文章类型、目标、视觉方向、配图策略和预计图片数量。没有文章内容时先索取，不用固定案例冒充用户效果。
2. 向用户展示五种视觉方向、自定义入口和配图策略；选择结果、智能推荐理由和选择方式写入预览契约。自定义方向必须提供 custom_style 并通过 scripts/editorial_style_contract.py 校验。
3. 按 [free-first-screen.md](references/free-first-screen.md) 选择标题、导语和一个有独立价值的正文小节，再加入一个与正文语义匹配的真实成品组件，生成 first-screen-preview.json。如本篇确有三条不同的阅读线索，增加 visual_cues；不要把之前用户认可的有用图标在新版自动清零。其余部分只列2至10个后续小节标题，不生成隐藏全文。
4. 运行并实际打开预览：

python scripts/build_first_screen_preview.py first-screen-preview.json --html first-screen-preview-v1.html --receipt first-screen-receipt-v1.json

1. 检查桌面和390像素手机宽度，测试“复制首屏”“换风格/配图”“按此完成整篇”。用户可免费提出一次同首屏小调，限标题层级、内容密度、成品组件、配图策略或色彩。
2. 用户说“按这个完成整篇”即可进入实时报价，不强迫填写满意度表。用户不继续时不创建订单，也不收回首屏。

首屏必须真正展示完整篇会延续的标题层级、正文节奏和成品组件，不接受“配图位置预演”或空框。首屏可使用用户授权图片；不调用宿主 ImageGen。用户选择 AI 插画时，先用确定性信息图或纯排版组件展示真实首屏，付款及积分确认后再生图。不得把AI示意图标为真实截图或证据。首屏HTML不包含完整发布HTML和完整复制工作台。

路线 B：直接制作整篇也必须先付款

用户不想等预览时，不生成免费首屏；仅确认文章、中文视觉方向和配图模式，然后实时报价。用户确认价格及宿主积分风险后使用 pay_gate.py start --direct-full --confirm，取得 402 并调用支付工具。只有原订单在线核验成功才开始分析全文、生成图片和成稿。不得把“直接制作”理解成跳过付费。

两条路线的价格均以 SkillHub 当前公开单次调用价格为准。一次任务包含1篇不超过30,000字、最多30张用户图片、图文排版、复制预览、完整检查及一次同范围小幅调整；AI生图默认0张，有明确同意后先只生成1张样片，再确认是否扩展，不能默认批量生成3至6张。

原订单核验成功后生成

1. 先运行 python scripts/pay_gate.py verify --input-file <任务文件> --state-file payment-state.json。未返回 SUCCESS 不得进行下面任一步。
2. 保留原文事实、立场、数字、引文和标题逻辑，输出 layout-brief。
3. 建立图片计划；有图片时读取 [image-workflow.md](references/image-workflow.md) 和 [image-manifest-schema.md](references/image-manifest-schema.md)。选择AI编辑插画或混合配图时还必须读取 [image-art-direction.md](references/image-art-direction.md)。
4. 真实截图、照片、数据图和用户授权素材先进入 manifest；AI只补有明确解释或节奏价值的图片。
5. 当前宿主有图片生成工具且用户另行同意张数与积分时，先写只含一张 status=planned AI 图和 ai_budget 的图片清单，运行 python scripts/validate_image_manifest.py article-image-manifest.json；未通过就不调用 ImageGen。通过后才生成一张关键图；检查通过、用户愿意继续并将 first_sample_approved=true 后才扩展同组图片。失败图片只做一次针对性修正，仍不合格就降级。
6. 检查乱码、错误文字、伪造界面、错误数据、人物/产品变化、清晰度和比例。AI图不能标记为证据。纯方法论优先结构信息图，禁止用三张近似抽象科技光圈充数。
7. 把审核通过的图片插入对应段落，保持图片、图注、来源和解释相邻。
8. 把全文的原话、段落、证据、步骤、图片与可复制附录整理为 article-layout.json。首屏采用的 visual_cues 若仍适用须沿用；有真实顺序或权限分层时可使用 path、tiers 形成中段视觉节奏，结尾确有对照原则时可用 grid 收束。优先由受控 render_full_article.py 生成同一风格的 draft.html；特殊自定义风格可以原创制作安全内联稿，但必须带相同的风格标识与摘要。不得把深色底浅色字的浏览器效果直接称为公众号可用。通过受控复制构建器生成 publishing.html 与工作台，不得自写另一个工作台构建器。
9. 运行：

python scripts/render_full_article.py article-layout.json draft.html --input-file <任务文件> --payment-state payment-state.json --style-contract <首屏JSON或直接制作的视觉契约JSON>
python scripts/validate_image_manifest.py article-image-manifest.json --article draft.html
python scripts/build_copyable_preview.py draft.html publish-workbench.html --safe-html publishing.html --input-file <任务文件> --payment-state payment-state.json --style-contract <同一视觉契约JSON> --style-profile <内部视觉代码> --title <文章标题> --image-manifest article-image-manifest.json --inline-local-images
python scripts/validate_official_account_html.py publishing.html --image-manifest article-image-manifest.json

仅当用户自定义诉求确实不能由结构化渲染器表达时，可在同一订单核验成功后手工制作带 V1.4 风格标识的原创安全内联 draft.html，并跳过上述 render_full_article.py 一行；后续视觉契约核对、复制构建、图片检查和公众号草稿验收不得省略。

1. 默认打开 publish-workbench.html，检查桌面与390像素手机宽度；点击“复制标题”“复制到公众号（正文）”“复制纯文字”，本地粘贴只核验剪贴板边界，不能宣称通过公众号编辑器。
2. 按 [wechat-image-paste-compatibility.md](references/wechat-image-paste-compatibility.md) 分别标记浏览器预览、剪贴板写入、公众号编辑器粘贴。第三层未实测就提醒用户在不发布的草稿里检查颜色、图片、标题和作者；用户自行测试，不代替其登录或创建草稿。

图片使用规则

• 短文通常0至3张，普通长文3至6张，教程、旅行和活动等强图文内容6至10张；以信息价值为准，不机械按段落插图。
• 上述是内容需要时的上限参考，不是默认生图张数。调用 ImageGen 前单独说明预计张数和宿主积分风险；只获准1张就不能连续生成3张。
• AI生成图适合解释、章节记忆和氛围，不适合冒充软件截图、新闻现场、客户结果、医学证据或数据证明。
• 默认不采用与正文无关的蓝色光隧道、发光圆环、伪AI界面或多张构图雷同的泛科技图；每张图必须能指出对应段落及不可用确定性信息图替代的原因。
• 文字、数字、Logo、二维码和关键标签优先用HTML或真实素材，不依赖图片模型生成准确文字。
• 每张图必须有用途、alt、可选图注、来源说明、事实角色与审核状态。
• 不未经同意把用户图片或生成图片上传到公开图床，不使用会过期的临时签名URL作为发布地址。

一键复制的真实边界

复制工作台输出的是安全浅色、关键文字显式深色的富文本；V1.4 保留通过安全检查的风格化内联样式，而不是统一重着色。工作台尝试把可用图片一起写入剪贴板；浏览器复制成功不等于微信公众号已保留颜色和图片。标题、作者是独立字段，不能假装复制正文会自动填写。

交付必须同时保留：

1. 完整图文浏览器预览。
2. 一键复制富文本。
3. 独立图片资产与编号位置清单，作为平台不接受整篇图片复制时的回退。

未完成真实公众号编辑器粘贴测试时，明确写“待平台实测”，不能声称已经可直接发布。

Pay Skill X402 操作契约

付费前置检查

• 当前 Agent 不能调用 weixinpay_pay 时停止正式任务，不生成付费结果。
• 先请求以下服务状态，读取SkillHub实时价格、币种、平台版本和可用性：

GET https://api.superzixuan.com/v1/pay/skills/official-account-layout-engine-pro

• available 不为 true、价格无法核验或币种不是 CNY 时停止，不使用本地旧价继续收款。
• 首次使用新的 request_id、本次摘要和当前已验证的支付协议版本 skill_version=1.3.1 请求唯一业务接口；这是支付网关协议版本，不表示排版成品仍为 V1.3.1。网关改版前不要擅自改此值；请求正文只含ID、哈希和版本，不向支付网关发送文章正文：

POST https://api.superzixuan.com/v1/pay/skills/official-account-layout-engine-pro

执行：

python scripts/pay_gate.py quote --output quote.json
# 路线 A：已经实际展示免费首屏，且用户同意实时报价
python scripts/pay_gate.py start --input-file <任务文件> --preview first-screen-preview.json --receipt first-screen-receipt-v1.json --html first-screen-preview-v1.html --quote-file quote.json --state-file payment-state.json --preview-seen --confirm
# 路线 B：用户跳过首屏、直接付费制作整篇；必须同意实时报价
python scripts/pay_gate.py start --input-file <任务文件> --quote-file quote.json --state-file payment-state.json --direct-full --confirm

• 首次响应必须是 HTTP 402 Payment Required，并同时取得 WeixinPay-Required 与 X-Out-Trade-No。缺少任一字段就停止。
• 向用户展示服务端响应的金额与币种；只有用户明确授权后，才调用 weixinpay_pay(paymentCode=<WeixinPay-Required>)。

支付成功后必须重试

支付工具返回成功后，必须使用原 request_id、原 input_digest、原支付码和原订单号重试同一接口。请求 Header 携带：

WeixinPay-Required: <原支付码>
X-Out-Trade-No: <原 out_trade_no>

执行：

python scripts/pay_gate.py retry --input-file <任务文件> --state-file payment-state.json
python scripts/pay_gate.py verify --input-file <任务文件> --state-file payment-state.json

只有接口返回 HTTP 200、code=SUCCESS 且查单 trade_state=SUCCESS 才进入完整生成。构建工作台时脚本再次在线复核原订单；本地状态不能代替。用户口头声明、支付工具单独返回或新建第二笔订单都不能替代查单成功。

幂等与支付异常处理

• 同一任务重试保持原 request_id、摘要、支付码、订单号和状态文件；网络结果未知时不得换状态文件另开订单。
• PAYMENT_NOT_COMPLETED：等待或重试原订单，不交付。
• INPUT_CHANGED、IDEMPOTENCY_CONFLICT：停止并核对任务，不复用旧付款。
• 用户取消、支付失败、结果未知、工具不可用或缺少Header：立即停止。
• HTML、图片或复制验证失败：修复同一已支付任务，不重复扣费。

完整结果完成后运行 python scripts/pay_gate.py complete --input-file <任务文件> --state-file payment-state.json --output-html publishing.html --workbench-html publish-workbench.html 在线复核并记录正文与复制工作台双哈希。缺少复制按钮、选中正文入口或复制根节点时不得标记交付。该记录不能替代公众号粘贴验收。

完整字段与脚本命令见 [pay-skill-runtime.md](references/pay-skill-runtime.md)。

质量与安全边界

• publishing.html 不能包含 script、iframe、表单、外部样式表、绝对定位、本机绝对路径、Cookie、私有链接或临时签名URL；不能有浅色字依赖深背景的排版。正式复制工作台强制转成安全浅色。
• publish-workbench.html 可以包含复制与图片管理脚本，但复制根节点只能是文章正文，工具栏和图片台账不能进入公众号内容。
• 不复制参考文章的原文、图片、Logo、署名、专属组件或逐像素版式。
• 不伪造图片授权、AI生成状态、粘贴结果或发布结果。
• 不把用户口头声称付款当成成功，不在 Skill 包中保存商户密钥、Token、支付码或订单凭据。
• 验证失败时交付失败证据和修复建议，不把局部预览称为完整成品。