启航公众号排版
把已经定稿的 Markdown 转成“航的杂谈地图”统一排版。个人样式目录是配置;发布前预览是只读质检页,不是调样式工作台。
When To Use
- 用户要求使用自己的公众号排版,而不是
grace、simple等通用主题。 - Markdown 已完成,需要生成正式 HTML 或继续进入草稿箱。
- 需要核对预览和草稿箱是否使用同一套字号、间距、标题、引用和图片规则。
Core Rule
本技能只拥有视觉排版,不拥有正文和配图判断。不得改写句子、标题层级、引用内容、图片顺序或 05.5-visual-plan.md;发布仍由 baoyu-post-to-wechat 负责。
How To Apply
- 接受任意已定稿 Markdown;在完整公众号项目中通常是
06-final.md。 - 检查图片路径和 frontmatter,再用主题
qihang-editorial、默认主色#2447D8调用baoyu-markdown-to-html生成同名 HTML。 - 用
scripts/build-publish-preview.ts从正式 HTML 生成同目录的06-final.preview.html,只读检查 677px 与 375px 阅读宽度、断图、层级和横向溢出。 - 进入草稿箱前必须查看这份发布前预览;用户已经明确授权“直接进草稿箱”时,可以省略再次确认,但不能省略预览与技术检查。
- 发布时把同一 Markdown 交给
baoyu-post-to-wechat。正式 HTML 和发布 HTML 均调用scripts/qihang-layout.ts,不得各维护一份 CSS。 - 若进入草稿箱,在发布回执中记录主题、主色、图片数、预览检查和草稿结果。
Personal Style Rule
assets/qihang-style-catalog.json是个人组件样式与默认值真源;只服务正式渲染,不向预览页提供交互控制。- 默认发布样式:H1 刊头双线、H2 编号底线、H3 荧光底线、引用居中金句、重点标签主色强调、有序列表双位编号、无序列表圆角对勾、表格极简横线。
- 可切换备选:H1 居中细线、H2 居中栏目、引用衬线大引语。
- 未确认的组件效果、主题实验、字体滑杆和间距滑杆不进入目录。
Interface
- 接受:已定稿 Markdown、可选主色、文章内本地图片。
- 产生:微信兼容 HTML 与只读发布前预览;完整发布任务中可继续产生草稿箱回执。
- 可接上游:任何能交付定稿 Markdown 的写作或组装技能。
- 可接下游:人工浏览检查;发布任务中,预览检查通过后再接
baoyu-post-to-wechat。
何时不该用
- 正文尚未定稿:交给
public-account-writing-style。 - 需要判断是否配图、画面形式或画内文案:交给
editorial-visual-storytelling。 - 只生成封面、漫画、信息图或图解:调用对应视觉技能。
- 只执行 API 或浏览器发布:交给
baoyu-post-to-wechat。
References
references/layout-contract.md- 主题真源、组件职责和验收标准。references/publish-preview.md- 发布前只读预览页的边界、用法和停止条件。references/provenance.md- 外部项目启发、许可证边界和独立实现说明。
运行依赖
- 个人主题渲染和发布前预览脚本需要
bun,没有 Bun 时使用npx -y bun。 - 正式 Markdown 转 HTML 还需要同一 Mode 中可用的
baoyu-markdown-to-html;进入草稿箱时再使用baoyu-post-to-wechat的浏览器或 API 运行条件。 - 缺少发布依赖不影响生成和检查本地 HTML;必须停在本地预览,不声称已经进入草稿箱。
完成标准
- 只接收已经定稿的 Markdown;排版过程不得擅自改写正文、补观点或制造新事实。
- 正式 HTML 与发布前预览必须来自同一份样式真源,标题、引用、列表、表格、图片和重点标记均能在微信编辑器约束下稳定呈现。
- 所有本地图片已解析并可见,图片顺序、题注和正文引用一致;缺图时明确指出位置,不用空白装饰假装完成。
- 发布前预览必须完成可读性、溢出、图片加载、移动端节奏和微信兼容性检查;不依赖会被公众号过滤的脚本或动效维持核心表达。
- 只有用户明确授权进入草稿箱时才调用发布能力;未授权时停在可检查的 HTML 与只读预览。
- 在 Mode 内调用与独立调用执行相同标准;无法满足的项目必须说明缺口与影响,不得伪造完成。