Skip to content
Back to search

wechat-article-pipeline

把定稿Markdown和本地配图生成公众号兼容内联HTML、图片内嵌稳定版、复制预览、390px手机长截图及完整性和隐私报告。适用于公众号文章定稿后的排版、检查和交付;不负责改稿,也不会在未经确认时创建公众号草稿。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/davinci-seven--wechat-article-pipeline/badge.svg)](/listings/davinci-seven--wechat-article-pipeline)

HTML

<a href="/listings/davinci-seven--wechat-article-pipeline"><img src="/api/listings/davinci-seven--wechat-article-pipeline/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 164 lines
  1. ---
  2. name: wechat-article-pipeline
  3. description: 把定稿Markdown和本地配图生成公众号兼容内联HTML、图片内嵌稳定版、复制预览、390px手机长截图及完整性和隐私报告。适用于公众号文章定稿后的排版、检查和交付;不负责改稿,也不会在未经确认时创建公众号草稿。
  4. ---
  5. # 公众号文章排版
  6. 把已经定稿的Markdown和本地配图交给本仓库现有脚本处理,输出可复制到公众号的HTML、手机预览和可核对的报告。
  7. 如果用户明确只要一个能粘贴进公众号的 HTML,不要长截图和检查报告,用 `tools/paste_wechat.py`,不要走下面的完整流水线。用法见 README 的「一键粘贴模式」。
  8. ## 输入
  9. - 一份定稿Markdown
  10. - Markdown引用的全部本地图片
  11. - 可选主题;未指定时使用`olive-journal`
  12. - 可选输出目录;不得把产物写回或覆盖原稿
  13. 如果文章目录里有多份Markdown,先请用户明确指定。不得自行猜测哪份是定稿。
  14. ## 必守规则
  15. - 不改正文,不改写、缩写、合并或重排任何段落。
  16. - 不调整图片顺序和图注。
  17. - 不覆盖原稿。运行前后计算原稿SHA256;不一致立即停止。
  18. - 先检查全部本地图片。缺少任意一张,立即停止并列出缺失项,不继续生成残缺结果。
  19. - 只有实际执行过且拿到结果的检查才能写“通过”。无法运行的检查标为“未运行”,并说明原因。
  20. - HTML正文只扫描隐私,不自动改写。JSON、Markdown和日志可用现有清理脚本处理本机路径。
  21. - 未经用户明确确认,不创建公众号草稿,不调用发布接口。
  22. - 不调用`md2wechat convert`二次渲染已经生成的HTML。
  23. ## 执行
  24. 先定位仓库根目录、定稿Markdown和图片,再选择当前系统对应的入口。
  25. ### Windows
  26. 优先调用仓库现有的一键脚本:
  27. ```powershell
  28. .\tools\公众号排版.ps1 -ArticleDir "F:\文章\我的文章" -Markdown "终稿.md" -OpenPreview
  29. ```
  30. 路径必须加引号。中文目录、空格和括号在不加引号时会被拆开,`<`和`>`在PowerShell里还是重定向符,直接写占位尖括号会报语法错误。
  31. 只有用户指定主题时才追加`-Theme moyu-green`(可选值用`-ListThemes`查看)。脚本失败后保留真实错误,不绕过图片、HTML或隐私检查。
  32. 该脚本已包含全部8个步骤,含长截图。未安装Playwright时第6步会告警并把`screenshot_status`标为“未运行”,其余步骤照常完成。
  33. ### 非Windows或ChatGPT代码执行环境
  34. 调用仓库现有脚本完成同一条流水线,不另写一套渲染器:
  35. 1. 计算原稿SHA256,并解析Markdown中的本地图片引用。
  36. 2. 确认图片全部存在;缺图立即停止。
  37. 3. 调用`tools/render_wechat.py`生成公众号兼容内联HTML、图片内嵌发布稳定版、390px手机截图页、图片证据表和完整性数据。
  38. 4. 使用已安装的gzh-design脚本校验组件和HTML,并用其`wrap_preview.py`生成带一键复制按钮的预览页。
  39. 5. 调用`tools/capture_mobile_screenshot.py`在390px视口截取完整长图,超高页面由脚本自行分段拼接。没有浏览器或截图能力时,把长截图标为“未运行”,不得用截图页代替并声称完成。
  40. 6. 再次计算原稿SHA256,确认原稿未变化。
  41. 7. 调用`tools/sanitize_public_output.py`生成隐私报告。HTML只扫描,不改写;报告里的警告需要人工判断。
  42. 完整命令如下。把`ARTICLE`、`LAYOUT`、`GZH`三个变量换成实际路径即可,其余原样执行:
  43. ```bash
  44. ARTICLE="/path/to/我的文章" # 文章目录
  45. LAYOUT="$ARTICLE/公众号排版" # 产物目录,不要写回原稿目录之外
  46. GZH="$HOME/.codex/skills/gzh-design" # 已安装的gzh-design
  47. # 1. 渲染:正文HTML、发布稳定版、手机截图页、图片证据表、完整性数据
  48. python tools/render_wechat.py \
  49. --markdown "$ARTICLE/终稿.md" \
  50. --output-root "$LAYOUT" \
  51. --theme olive-journal
  52. # 渲染器按主题决定文件名,从报告里读,不要自己拼。
  53. # 路径通过sys.argv传入,不要拼进Python字符串,否则Windows路径的反斜杠会被当转义符。
  54. read_field() {
  55. python -c "import json,sys;print(json.load(open(sys.argv[1],encoding='utf-8'))[sys.argv[2]])" \
  56. "$LAYOUT/source-integrity.json" "$1"
  57. }
  58. CLEAN=$(read_field clean_html)
  59. STABLE=$(read_field stable_html)
  60. MOBILE=$(read_field mobile_screenshot_page)
  61. PREVIEW="${STABLE/_发布稳定版.html/_预览.html}"
  62. # 2. 组件与HTML校验,退出码非0即为不合规
  63. python "$GZH/scripts/component_lint.py" "$GZH"
  64. python "$GZH/scripts/validate_gzh_html.py" "$CLEAN"
  65. python "$GZH/scripts/validate_gzh_html.py" "$STABLE"
  66. # 3. 带一键复制按钮的预览页
  67. python "$GZH/scripts/wrap_preview.py" "$STABLE" "$PREVIEW"
  68. # 4. 390px手机端完整长截图(需要Playwright)
  69. python tools/capture_mobile_screenshot.py \
  70. --page "$MOBILE" \
  71. --output "$LAYOUT/output/终稿_390px_手机长截图.png"
  72. # 5. 清理本机路径并检查敏感信息
  73. python tools/sanitize_public_output.py \
  74. --article-dir "$ARTICLE" \
  75. --layout-root "$LAYOUT"
  76. ```
  77. 第4步的退出码含义:`0`成功,`2`手机截图页不存在,`3`未安装Playwright,`4`浏览器执行失败。返回`3`时先尝试`pip install playwright && python -m playwright install chromium`;仍然不行就把长截图标为“未运行”,不得用手机截图页HTML冒充长截图。
  78. `tools/stitch_screenshot.py`用于已经手动分段截好图、需要拼接的场合;走上面第4步时不需要它,脚本内部会自行处理超高页面的分段拼接。
  79. 后续校验、预览包装和截图必须依据当前环境中的实际脚本位置执行,不得伪造命令输出。
  80. ## 验收
  81. 至少核对并如实汇报:
  82. - 公众号兼容内联HTML
  83. - 图片内嵌的发布稳定版HTML
  84. - 带一键复制按钮的预览页
  85. - 390px手机端预览和完整长截图
  86. - 图片证据表,且顺序、路径和图注与原稿一致
  87. - 原稿运行前后SHA256及`source_unchanged`结果
  88. - HTML校验的实际结果
  89. - `privacy-audit.json`中的错误和警告
  90. - 未运行的检查及原因
  91. - ChatGPT环境中的轻量Preview和完整一键复制HTML是否都已交付,并且身份标注清楚
  92. 任何必需检查失败时,不把整套任务写成“已完成”。先返回失败位置、真实输出和可执行的下一步。
  93. ## ChatGPT双交付
  94. 当执行环境是ChatGPT,并且已经生成带“一键复制到公众号”按钮的完整预览HTML时,最终必须同时交付以下两份HTML,不能互相替代。
  95. ### ChatGPT截图预览
  96. 在最终回复中额外提供一个HTML代码块,供ChatGPT直接切换Preview、小窗或全屏查看和截图。
  97. - 输出完整可运行的HTML文档,包括`<!doctype html>`、顶部工具栏、预览容器和复制按钮。
  98. - 视觉主题与正式预览保持一致,至少展示标题、开头正文和代表性内容。
  99. - 为控制回复体积,可以只保留代表性图片、缩略图或少量内容;不要把数MB的data URI塞进聊天回复。
  100. - 在页面工具栏和回复说明中明确标记“轻量预览,非全文”。复制按钮也要提示复制的是预览片段,不能让用户误以为已经复制完整文章。
  101. - 不得把这份轻量HTML记作完整文章、发布稳定版或公众号终审文件。
  102. - 如果当前客户端没有HTML Preview入口,仍保留这份代码块,并以完整HTML附件作为可用回退。
  103. ### 公众号一键复制HTML
  104. 同时提供可下载的完整预览HTML,作为真实复制到公众号编辑器和发布前终审的唯一来源。
  105. - 保留全部正文、图片顺序、alt文本和图注。
  106. - 使用已经校验的发布稳定版正文;图片优先内嵌为data URI,避免依赖本地路径。
  107. - 保留顶部工具栏和“一键复制到公众号”按钮,按钮只复制完整正文容器,不复制工具栏或提示文字。
  108. - 不得为了生成轻量Preview而删减或覆盖这份完整HTML。
  109. - 没有实际测试复制按钮时,标为“未测试”,不能声称复制成功。
  110. 最终回复必须用这两个固定名称区分产物:
  111. - `ChatGPT截图预览`:聊天内轻量Preview,用于查看和截图,不是全文。
  112. - `公众号一键复制HTML`:完整文章,用于真实复制和发布前终审。
  113. 不要因为已经提供完整HTML下载附件,就省略ChatGPT环境中的轻量Preview代码块;也不要只给轻量Preview而漏掉完整HTML附件。
  114. ## 发布边界
  115. 默认只生成本地文件,不登录公众号、不上传素材、不创建草稿。只有用户在看到本次产物后明确要求创建公众号草稿,才进入单独的发布步骤;即使进入发布步骤,也直接使用已生成HTML,不调用`md2wechat convert`。
  116. 安装方法见[docs/skill-install.md](docs/skill-install.md),日常参数和输出说明见[README.md](README.md)。
README.md · README · 243 lines
  1. # wechat-article-pipeline
  2. **Markdown+本地配图,一键生成公众号兼容HTML、复制预览、390px手机长截图和完整性报告。**
  3. 面向Windows,也适合直接交给ChatGPT、Claude或Codex执行。
  4. - 不改原稿
  5. - 不自动发布
  6. - 不把本机绝对路径写进公开报告
  7. - 图片缺失或HTML校验失败时直接停止
  8. | 我现在要做什么 | 直接看这里 |
  9. | --- | --- |
  10. | 只要一个能粘贴进公众号的 HTML | [一键粘贴模式](#一键粘贴模式) |
  11. | 在Windows电脑上一键排版 | [快速开始](#最快开始) |
  12. | 安装成Skill交给Codex执行 | [安装成Skill](docs/skill-install.md) |
  13. | 把文章直接丢给ChatGPT处理 | [AI执行提示词](docs/agent-prompt.md) |
  14. | 安装运行环境 | [Windows安装](docs/windows-install.md) |
  15. | 查看项目来源和分工 | [致谢与项目边界](docs/credits.md) |
  16. | 发布前检查隐私 | [公开前脱敏检查](docs/privacy-check.md) |
  17. ## 一键粘贴模式
  18. 只想把定稿贴进公众号时用这个。一条命令生成一个 HTML:手机宽度的预览,标题单独一颗「复制标题」,正文一颗「复制正文」。不跑长截图,不写证据表和隐私报告,也不需要 gzh-design 或 Playwright。Windows 和 Linux 都可以,只用 Python 标准库。手机浏览器也能点。
  19. ```bash
  20. python tools/paste_wechat.py --md 文章.md --theme navy-gazette -o out/
  21. ```
  22. 有封面时加上 `--cover assets/封面.jpg`,或在文首写 `cover:`。封面只出现在页面上,不进正文。
  23. ```powershell
  24. python tools\paste_wechat.py --md 文章.md --theme navy-gazette -o out\
  25. ```
  26. 用浏览器打开生成的 HTML。先点「复制标题」,填进公众号标题框;再点「复制正文」,粘到正文。文中的图嵌在正文里,会跟着过去。页面上的步骤是:复制标题 → 打开公众号后台新建图文,填进标题框 → 复制正文 → 粘贴到正文 → 检查图片 → 发表。
  27. ```text
  28. out/
  29. ├─ 文章.html
  30. └─ images/
  31. ├─ 封面.jpg
  32. ├─ 01-配图.png
  33. └─ 02-配图.jpg
  34. ```
  35. `images` 是备用原图。只有粘贴后缺了图才用。说明见[图片粘贴](docs/paste-images.md)。
  36. 同一篇 demo 文章的五套版式示例在 [examples/paste-examples](examples/paste-examples)。主题怎么加,见[主题](docs/themes.md)。
  37. 下面的完整流水线还在,需要长截图和检查报告时用那个。
  38. ## 安装成Skill
  39. 想让Codex按固定规则接手定稿后的排版,直接看[安装成Skill](docs/skill-install.md)。仓库根目录的`SKILL.md`已经写好Windows和非Windows两套执行路径,也写死了不改正文、不动图片顺序、缺图停止和未经确认不创建公众号草稿这些边界。
  40. ## 最终效果
  41. GitHub不能直接运行仓库里的本地HTML,所以这里放一张预览页的示意图(不是demo文章的实拍)。实际生成后,点右上角按钮,再到公众号编辑器里`Ctrl+V`即可。
  42. <img src="docs/preview-copy-button-screenshot.svg" width="1000" alt="带复制到公众号按钮的预览页截图">
  43. 仓库里也保留了一张390px手机端完整长截图:
  44. <img src="examples/demo-article/sample-output/output/终稿_390px_手机长截图.png" width="390" alt="390px手机端完整长截图">
  45. 示例的[Markdown原稿](examples/demo-article/终稿.md)和[完整输出目录](examples/demo-article/sample-output/)都在仓库里,可以直接对照输入和输出。
  46. ## 最快开始
  47. 准备好Windows、Python和gzh-design后,在仓库目录运行:
  48. ```powershell
  49. .\tools\公众号排版.ps1 -ArticleDir .\examples\demo-article -OpenPreview
  50. ```
  51. 脚本会依次完成:
  52. 1. 检查Markdown里的本地图片
  53. 2. 生成公众号兼容的内联HTML
  54. 3. 生成图片内嵌的发布稳定版
  55. 4. 校验gzh-design组件库和最终HTML
  56. 5. 生成带复制按钮的浏览器预览
  57. 6. 在390px视口截取完整长截图(需要Playwright,未安装时标记为“未运行”)
  58. 7. 确认原始Markdown没有被修改
  59. 8. 清理报告中的本机路径并检查常见敏感信息
  60. 也可以把文章目录直接拖到`tools\公众号排版.bat`上。
  61. ## 直接交给ChatGPT
  62. 不在自己的电脑前,也不需要远程回去开Codex。
  63. 把定稿Markdown、全部配图,以及`tools/render_wechat.py`和`tools/sanitize_public_output.py`上传给支持代码执行的ChatGPT、Claude或Codex,再复制这里的现成提示词:
  64. **[docs/agent-prompt.md](docs/agent-prompt.md)**
  65. 能拿到:干净正文HTML、图片内嵌的发布稳定版、390px手机截图页、图片证据表、原稿哈希、正文顺序校验和隐私报告。
  66. 拿不到:gzh-design 那份 HTML 合规校验,以及 390px 长截图(需要 Playwright)。带复制按钮的页面可以用本仓库的 `tools/paste_wechat.py`,不用 gzh-design;完整流水线里的预览页仍来自 gzh-design。把 gzh-design 的 `scripts/` 一并上传,可以补上校验和那份预览页。
  67. 边界和完整说明见[AI执行提示词](docs/agent-prompt.md)。
  68. ## 新文章怎么用
  69. 新建一个文章目录,把Markdown和配图放进去:
  70. ```text
  71. 我的文章/
  72. ├─ 终稿.md
  73. └─ assets/
  74. ├─ 配图1.png
  75. └─ 配图2.jpg
  76. ```
  77. 运行:
  78. ```powershell
  79. .\tools\公众号排版.ps1 -ArticleDir .\我的文章 -OpenPreview
  80. ```
  81. 目录里有多个Markdown时,通过`-Markdown`指定:
  82. ```powershell
  83. .\tools\公众号排版.ps1 `
  84. -ArticleDir .\我的文章 `
  85. -Markdown 文章终稿.md `
  86. -OpenPreview
  87. ```
  88. 脚本不会覆盖原始Markdown,只会在文章目录下新增`公众号排版`文件夹。
  89. ## 输出文件
  90. | 文件 | 用途 |
  91. | --- | --- |
  92. | `output\*_排版_*.html` | 干净正文HTML,全部使用内联样式 |
  93. | `output\*_发布稳定版.html` | 图片转成data URI,不依赖本地路径 |
  94. | `output\*_预览.html` | 带“复制到公众号”按钮的浏览器预览 |
  95. | `output\*_手机截图页.html` | 无悬浮工具栏的390px视觉检查页 |
  96. | `图片证据表.md` | 图片顺序、路径、所属章节和用途 |
  97. | `手机端结构脚本.md` | 手机端结构和排版检查基线 |
  98. | `source-integrity.json` | 原稿哈希、正文顺序和图片完整性信息 |
  99. | `image-map.json` | 后续上传公众号素材时使用的图片映射 |
  100. | `validation\` | 组件库、HTML校验和截图日志 |
  101. | `workflow-result.json` | 本次运行结果摘要 |
  102. | `privacy-audit.json` | 路径清理和敏感信息检查结果 |
  103. `tools/stitch_screenshot.py`可以把浏览器分段截图拼成一张390px手机端完整长图。
  104. ## 支持哪些Markdown语法
  105. 渲染器只实现公众号排版实际用得上的子集。遇到不支持的语法会直接报错停下并指出行号,不会默默把星号或大于号留在正文里。
  106. 支持:一到三级标题、段落、有序和无序列表(单层)、代码块、行内代码、粗体、斜体、删除线、链接、引用块、表格(含列对齐)、分隔线、独占一行的图片。
  107. 不支持,遇到即停:行内图片(图片必须独占一行)、嵌套列表、四级及以下标题、直接写在Markdown里的HTML标签。
  108. 确实需要降级渲染时,加`--allow-unsupported`明确接受,结果里会记录降级了哪些行。
  109. ## 主题
  110. ```powershell
  111. .\tools\公众号排版.ps1 -ArticleDir .\我的文章 -Theme red-white
  112. python tools\paste_wechat.py --list-themes
  113. ```
  114. 原来的六套共用一个文章结构,主要换颜色和字号:
  115. ![六套主题对比](docs/theme-gallery.png)
  116. | 主题 | 标识 | 适合内容 |
  117. | --- | --- | --- |
  118. | 橄榄手记 | `olive-journal` | 内刊手记、深度评测、案例复盘,默认主题 |
  119. | 摸鱼绿 | `moyu-green` | 教程、测评、清单、工具盘点 |
  120. | 红白色系 | `red-white` | 深度分析、观点和强调型内容 |
  121. | 石墨极简风 | `graphite-minimal` | 设计、科技评论和专业内容 |
  122. | 留白禅意风 | `zen-whitespace` | 随笔、生活方式和低密度内容 |
  123. | 摸鱼票据风 | `moyu-ticket` | 测评、工具对比和清单类内容 |
  124. 另外五套是独立版式,刊头和骨架固定,不跟文章变。示例是同一篇 demo 文章:
  125. ![五套版式](docs/layout-theme-gallery.png)
  126. | 主题 | 标识 | 刊头示例 | 样子 |
  127. | --- | --- | --- | --- |
  128. | 桃粉手记 | `peach-diary` | 桃粉手记 | 奶油桃粉,日记,行距松 |
  129. | 海军公报 | `navy-gazette` | 海军公报 | 大字、海军蓝,重点用黄框 |
  130. | 深绿备忘 | `green-memo` | 深绿备忘 | 灰纸、深绿,像一份备忘 |
  131. | 泛黄档案 | `sepia-archive` | 泛黄档案 | 泛黄色、宋体,引用做成原文框 |
  132. | 暖灶食谱 | `harvest-kitchen` | 暖灶食谱 | 暖绿配橙,图片和步骤更显眼 |
  133. 再加一套版式时,放一份 `themes/*.json` 就行,字段说明见[主题](docs/themes.md)。
  134. 需要 gzh-design 原生的完整主题组件体系,可以直接查看 [gzh-design](https://github.com/isjiamu/gzh-design-skill)。
  135. ## 安全边界
  136. 这套工作流默认遵守4条规则:
  137. 1. **不覆盖原始Markdown。** 运行前后分别计算SHA256,不一致就停止。
  138. 2. **不自动发布。** 创建公众号草稿必须由用户明确确认。
  139. 3. **不二次渲染。** 不调用`md2wechat convert`重新排版,避免破坏已经生成的内联样式。
  140. 4. **不公开本机路径。** 输出报告会把文章目录、用户目录等绝对路径替换成占位符,并检查常见Token、私钥、邮箱、UUID和IP残留。
  141. 公众号AppID和AppSecret只应保存在本地环境变量或安全配置中,不应写进Markdown、HTML、日志或Git仓库。
  142. ## 安装
  143. 完整步骤见[Windows安装](docs/windows-install.md)。
  144. 基础环境:
  145. - Windows 10或Windows 11
  146. - Python 3.10+
  147. - PowerShell 5.1或PowerShell 7
  148. - Pillow
  149. - Playwright,可选,仅长截图需要
  150. - [gzh-design](https://github.com/isjiamu/gzh-design-skill)
  151. ## 这个仓库负责什么
  152. 这个仓库没有把所有能力重新实现一遍,而是把公众号HTML生成、手机端检查和发布前准备整理成一条适合Windows日常使用的流程。本仓库不含任何自动上传或建草稿的代码。
  153. 它补充了:
  154. - PowerShell一键脚本和BAT拖拽入口
  155. - 原稿SHA256和正文顺序完整性校验
  156. - 图片存在性检查、图片证据表和图片映射表
  157. - 图片内嵌的发布稳定版HTML
  158. - 六套通用主题,外加五套独立版式
  159. - 不依赖 gzh-design 的一键粘贴 HTML
  160. - 390px手机端QA和长截图拼接
  161. - 公开前路径清理与敏感信息检查
  162. - “不发布、不覆盖、不二次渲染”的安全边界
  163. 依赖项目、作者和具体分工见[致谢与项目边界](docs/credits.md)。
  164. ## License
  165. 本仓库自有代码采用MIT License,见[LICENSE](LICENSE)。
  166. gzh-design 采用 AGPL-3.0,本仓库不含也不重新分发它的源码,只在运行时以独立进程调用其命令行脚本。详见[致谢与项目边界](docs/credits.md#许可说明)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.