剑的 AI 实验室
← 竞技场动态
内容创作与自媒体实验记录进行中

isjiamu/gzh-design-skill

gzh-design-skill 本机安装与一次完整排版运行

本机克隆 gzh-design-skill，完成组件库检查、官方样例合规、故意失败路径、实验室样例与预览页生成。

查看 GitHub 原项目 ↗进入作者的家

实验田正式路线

这项项目没有绕过实验田。

01种子区 · 已发现Trending 线索、GitHub 仓库和项目库档案已经绑定。
02种子区 · 已核验固定提交，核对 README、许可、版本、外部服务和数据边界。
03播种区 · 已实测8 次工作记录保留环境、命令、退出码、失败和修复。
04收成区 · 已产出3 项成果与同一实验绑定，阶段状态仍为进行中。
05收获记 · 已公开公开实验页、竞技场摘要与多平台发布证据回到同一条记录。

正文

这份记录

# 实验报告 · gzh-design-skill（2026-09-07） - run_id: v31-prod-20260907T1646 - experiment_id: 8374091e-2535-454d-94ed-639e35e1cdc3 - 仓库: https://github.com/isjiamu/gzh-design-skill - 环境: Python 3.9.6；git clone --depth 1；技能目录复制到本机 skills-install ## 目标 验证本机能否安装该公众号排版 Skill，并跑通校验脚本：官方样例合规、故意坏样例失败、自备片段合规、预览页生成。 ## 过程与结果 | 工作 | 命令/动作 | 结果 | |------|-----------|------| | 克隆 | git clone isjiamu/gzh-design-skill | 成功，含 SKILL.md / scripts / references / assets | | 主题源头检查 | scripts/component_lint.py | ERROR×0；WARN×2（dashed 边框提示） | | 官方样例校验 | validate_gzh_html.py archive/gallery-v1/hongbai.html | 完全合规，span leaf 94 处 | | 失败路径 | 写入含 style/div/class 的坏 HTML 再校验 | ERROR×3：style 过滤、div 改写、class 剥离 | | 实验室样例 | 自 gallery 片段生成 lab-sample-gzh.html 再校验 | 完全合规，span leaf 69 处 | | 预览 | wrap_preview.py → lab-sample-preview.html | 生成带「复制」按钮的预览页 | ## 未做 / 边界 - 未在 Claude/Codex 会话内走完整「选题→读主题库→逐段装配」交互式排版；本轮证据侧重**安装与校验闭环**。 - 未登录微信公众号编辑器做真机粘贴；「可粘贴」依据校验脚本规则。 - 未测主题生成器、docx/PDF 输入归一化全链路。 ## 结论 本机可以取得仓库与校验工具；官方样例与实验室样例可通过合规检查；故意违规 HTML 会被脚本挡住。适合作为「写完 Markdown 后如何稳定变成公众号可用 HTML」的工具候选，但完整 Agent 排版流程仍需在真实 Agent 会话中再跑一遍。

01 · 问题

我想解决什么

Markdown 写完后粘进公众号常乱版，需要可重复的排版与合规检查。

02 · 过程

我是怎样做的

clone → component_lint → validate gallery → intentional fail → lab sample → wrap_preview；六次播种记录。

03 · 结果

实际发生了什么

ERROR×0 主题库；官方与实验室样例完全合规；坏样例 ERROR×3；预览页可生成。

05 · 最终评价

这次实验的结论

脚本层安装与校验闭环成立；交互式全自动装配与真机公众号粘贴未测。

实验日志时间线

这项实验是怎样一步步做出来的。

  1. 01
    克隆仓库与目录核验

    克隆仓库与目录核验 ``` Cloning into 'gzh-design-skill'... ``` 本地录屏: w1-clone.mp4 (12.0s)

    01-clone-and-tree.png
    01-clone-and-tree.png
    08-skill-frontmatter.png
    08-skill-frontmatter.png
    成果-lab-sample-gzh-合规HTML.htmlHTML · 14 KB · 打开或下载实验室合规 HTML 样例（validate 通过）
  2. 02
    component_lint 主题库源头检查

    component_lint 主题库源头检查 ``` 📐 组件库源头检查：11 个库 ── theme-moyu-green ── ⚠️ 四周虚线框 border:…dashed（正文强调请用左竖条；仅居中的素材占位块可用 dashed） ── theme-olive-journal ── ⚠️ 四周虚线框 border:…dashed（正文强调请用左竖条；仅居中的素材占位块可用 dashed） 汇总：9/11 个库干净，ERROR×0，WARN×2 ``` 本地录屏: w2-lint.mp4 (12.0s)

    02-component-lint.png
    02-component-lint.png
    01-clone-and-tree.png
    01-clone-and-tree.png
    成果-lab-sample-preview-带复制按钮.htmlHTML · 17 KB · 打开或下载带复制按钮的预览页 HTML
  3. 03
    validate_gzh_html 官方 gallery 样例合规

    validate_gzh_html 官方 gallery 样例合规 ``` 📋 公众号 HTML 合规校验: /Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-07/03-experiment/v31-prod-20260907T1646/workdir/gzh-design-skill/archive/gallery-v1/hongbai.html span leaf 包裹: 94 处 ✅ 完全合规，可直接粘贴到公众号编辑器 ``` 本地录屏: w3-validate-ok.mp4 (12.0s)

    03-validate-gallery.png
    03-validate-gallery.png
    07-sample-article-md.png
    07-sample-article-md.png
    成果-实验报告.mdMD · 2 KB · 打开或下载本轮实验报告全文
  4. 04
    故意无效 HTML 校验失败路径

    故意无效 HTML 校验失败路径 ``` 📋 公众号 HTML 合规校验: /Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-07/03-experiment/v31-prod-20260907T1646/harvest/bad-sample.html span leaf 包裹: 0 处 ❌ ERROR ×3（必须修复，否则粘贴后失效）: • <style> 标签会被过滤，样式必须内联（命中 1 处） • <div> 会被改写，请用 <section>（命中 2 处） • class 属性会被剥离，请用内联 style（命中 1 处） ``` 本地录屏: w4-validate-fail.mp4 (12.0s)

    04-validate-fail-path.png
    04-validate-fail-path.png
    03-validate-gallery.png
    03-validate-gallery.png
    成果-长文章.mdMD · 8 KB · 打开或下载本轮长文章全文
  5. 05
    实验室样例 HTML 校验通过

    实验室样例 HTML 校验通过 ``` 📋 公众号 HTML 合规校验: /Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-07/03-experiment/v31-prod-20260907T1646/harvest/lab-sample-gzh.html span leaf 包裹: 69 处 ✅ 完全合规，可直接粘贴到公众号编辑器 ``` 本地录屏: w5-lab-sample.mp4 (12.0s)

    05-lab-sample-validate.png
    05-lab-sample-validate.png
    07-sample-article-md.png
    07-sample-article-md.png
  6. 06
    wrap_preview 生成可复制预览页

    wrap_preview 生成可复制预览页 ``` ✓ 已生成带「复制」按钮的预览页: /Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-07/03-experiment/v31-prod-20260907T1646/harvest/lab-sample-preview.html 用浏览器打开它，点右上角「复制到公众号」，再去公众号编辑器 Ctrl/⌘+V 粘贴。 exit=0 ``` 本地录屏: w6-preview.mp4 (12.0s)

    06-wrap-preview.png
    06-wrap-preview.png
    05-lab-sample-validate.png
    05-lab-sample-validate.png
  7. 07
    收成区15项媒体证据

    流程五 YouTube 视频资源15类画面对照上传（harvest/media15）。对照表见实验目录 15项证据对照表.json。

  8. 08
    i欧哦iu

    i u为i哦

    实验日志图片
    实验日志图片
    实验日志图片

收成区 · 与本实验绑定

报告、长文、视频材料和下载包都从上面的日志长出来。

“已产出”表示内容和文件已经形成，不代表核心 3D 界面的端到端验收已经通过。本实验仍保留为“进行中”。

实验报告 · 已准备

实验报告 · gzh-design-skill（2026-09-07）

# 实验报告 · gzh-design-skill（2026-09-07） - run_id: v31-prod-20260907T1646 - experiment_id: 8374091e-2535-454d-94ed-639e35e1cdc3 - 仓库: https://github.com/isjiamu/gzh-design-skill - 环境: Python 3.9.6；git clone --depth 1；技能目录复制到本机 skills-install ## 目标 验证本机能否安装该公众号排版 Skill，并跑通校验脚本：官方样例合规、故意坏样例失败、自备片段合规、预览页生成。 ## 过程与结果 | 工作 | 命令/动作 | 结果 | |------|-----------|------| | 克隆 | git clone isjiamu/gzh-design-skill | 成功，含 SKILL.md / scripts / references / assets | | 主题源头检查 | scripts/component_lint.py | ERROR×0；WARN×2（dashed 边框提示） | | 官方样例校验 | validate_gzh_html.py archive/gallery-v1/hongbai.html | 完全合规，span leaf 94 处 | | 失败路径 | 写入含 style/div/class 的坏 HTML 再校验 | ERROR×3：style 过滤、div 改写、class 剥离 | | 实验室样例 | 自 gallery 片段生成 lab-sample-gzh.html 再校验 | 完全合规，span leaf 69 处 | | 预览 | wrap_preview.py → lab-sample-preview.html | 生成带「复制」按钮的预览页 | ## 未做 / 边界 - 未在 Claude/Codex 会话内走完整「选题→读主题库→逐段装配」交互式排版；本轮证据侧重**安装与校验闭环**。 - 未登录微信公众号编辑器做真机粘贴；「可粘贴」依据校验脚本规则。 - 未测主题生成器、docx/PDF 输入归一化全链路。 ## 结论 本机可以取得仓库与校验工具；官方样例与实验室样例可通过合规检查；故意违规 HTML 会被脚本挡住。适合作为「写完 Markdown 后如何稳定变成公众号可用 HTML」的工具候选，但完整 Agent 排版流程仍需在真实 Agent 会话中再跑一遍。

长文章 · 已准备

把 Markdown 稳稳送进公众号：gzh-design-skill 本机实测

# 把 Markdown 稳稳送进公众号：gzh-design-skill 本机实测 **日期：** 2026-09-07（CST） **run：** v31-prod-20260907T1646 **项目：** [isjiamu/gzh-design-skill](https://github.com/isjiamu/gzh-design-skill) ## 导语 写公众号的人往往卡在最后一公里：正文在 Markdown 里结构清楚，一进微信编辑器，样式被吃掉，代码折行，主题不统一，只能手工修。开源项目 gzh-design-skill 把这件事定义成「给 Agent 用的排版技能」——从主题组件库生成内联样式的 HTML，并用脚本做合规检查。剑的 AI 实验室在 2026 年 9 月 7 日把它装到本机，跑通了克隆、主题库检查、官方样例校验、失败样例对照、自备输出与预览页生成。下文按正式记录写清边界、步骤、结果与读者可执行含义，不保证阅读量，也不把未做的交互式全自动排版写成已完成。 ## 一、项目定位与使用边界 gzh-design-skill 面向 Claude Code、Codex、Cursor 等代理环境。它的主线不是生成普通网页或幻灯片，而是：**把文章（Markdown 为主，也可经规则归一化的 docx/pdf/纯文本）转成适合粘贴进微信公众号编辑器的 HTML 片段**。主题来自仓库 `references/` 下的组件库（摸鱼绿、红白、石墨极简、留白禅意、摸鱼票据、橄榄手记等），通用能力包括代码块、图片与 GIF、章节编号、关键词标记、引言卡与目录。校验脚本 `validate_gzh_html.py` 检查平台容易过滤的写法（例如外置 style、div、class），要求正文以 section 等可接受结构与内联样式交付。 本实验的结论范围仅限：本机取得源码、运行检查与校验、对官方与自备 HTML 给出通过/失败证据。未登录公众号后台做真机粘贴；未在完整 Agent 对话中走「自动选题 + 逐组件装配」全流程；未评价内容质量或传播效果。 ## 二、安装与取得方式 官方形态是 **Agent Skill 目录**，不是单一 pip 包名。本次步骤： 1. `git clone --depth 1 https://github.com/isjiamu/gzh-design-skill.git` 2. 确认根目录存在 `SKILL.md`、`scripts/`（含 `component_lint.py`、`validate_gzh_html.py`、`wrap_preview.py`）、`references/`、`assets/sample-article.md` 3. 将技能目录复制到本机实验用的 `skills-install/gzh-design`，便于 Agent 侧加载 4. 运行环境记录：Python 3.9.6 安装本身不要求云端 API Key。若要在 Claude/Codex 里「一键排版」，需要对应 Agent 能读取 SKILL 与主题 Markdown；那是下一层集成，与本次脚本层证据分开记录。 ## 三、运行记录 ### 3.1 主题库源头检查 命令：`python3 scripts/component_lint.py` 结果：11 个库汇总 **ERROR×0**；2 处 WARN，提示部分主题存在四周虚线框（dashed）用法，文档建议正文强调改用左竖条。对「能不能继续排版」而言，错误为零，可以进入校验。 ### 3.2 官方 gallery 样例：通过 对 `archive/gallery-v1/hongbai.html` 运行 `validate_gzh_html.py`。输出为**完全合规**，并统计到多处 `span leaf` 包裹。含义：按项目规则，这份样例属于「可直接粘贴」的类别（仍以公众号编辑器实际行为为最终环境，本机未做登录粘贴）。 ### 3.3 故意失败路径：拦住违规标签 写入仅含 `<div class>` 与 `<style>` 的短 HTML 再校验。脚本报 **ERROR×3**：style 会被过滤、div 会被改写、class 会被剥离。这条路径的价值是负面证据——工具会明确指出「为什么粘贴后样式可能丢光」，而不是静默给出一份看起来像成功的文件。 ### 3.4 实验室样例与预览页 从官方 gallery 片段生成 `lab-sample-gzh.html`，再次校验为完全合规。再运行 `wrap_preview.py`，得到带「复制」按钮的 `lab-sample-preview.html`，可在浏览器打开后复制富文本。试验田时间线写入六次工作（克隆、lint、官方通过、失败路径、样例通过、预览），每条含文字、至少两张图与一段短视频；本地录屏总时长约 72 秒，满足播种阶段「可剪辑素材不少于一分钟」的底线。 ## 四、未通过与未测试 - **交互式全自动排版**：SKILL 要求读 theme-index、按题材确认主题、读两份组件库、按配方装配。本轮未在 Agent 会话中逐步执行该决策链，故不能宣称「已经自动排出任意新文章的终稿」。 - **真机公众号粘贴**：未使用微信公众号账号验证剪贴板结果。 - **docx/PDF 输入**：未跑 `extract_docx.py` 与 PDF 归一化全流程。 - **主题生成器**：未根据描述或参考图生成新主题。 上述空白不影响已完成的脚本层结论，但读者若只关心「Agent 一句话排完全文」，仍需自行在 Agent 里按 SKILL 再跑。 ## 五、对读者的可执行含义 1. **先确认本机能跑校验。** 克隆后对官方 `hongbai.html` 跑 `validate_gzh_html.py`，若你的环境同样报完全合规，说明工具链可用。 2. **用失败样例建立预期。** 自己造一份带 style/div/class 的 HTML，应看到明确 ERROR；若没有，说明你可能跑错脚本或文件。 3. **把「主题审美」和「平台合规」分开。** 主题库解决版式语言；校验脚本解决平台过滤。两者都过，才接近「粘贴少返工」。 4. **需要完整排版时，按 SKILL 在 Agent 里做。** 脚本层证明规则可检查；装配层依赖 Agent 读库与结构解析。 ## 六、结论 在 2026-09-07 的本机条件下，gzh-design-skill 可以稳定取得，主题库检查无错误阻断，官方样例与实验室样例可通过合规校验，故意违规 HTML 会被拒绝，并可以生成带复制按钮的预览页。它适合作为公众号长文生产链路中的**排版与合规环节**来试验；传播效果、真机粘贴与全自动 Agent 装配仍属未测或未完项。 剑的 AI 实验室会把可核验的安装与运行记录留在试验田，方便对照仓库继续迭代。不把未测项写成已验证，也不把工具能力说成内容一定爆款。 --- ## 七、与常见替代做法的对照（基于本次证据） 不少人仍用「编辑器里直接调」或「从网页复制带格式文本」。前者费时且难复现同一主题；后者常夹带外置样式与 class，正好落在本次失败样例指出的过滤点上。gzh-design-skill 的路径是：主题组件库提供版式语言，校验脚本提供平台规则的可执行检查。本次证据支持的是后半段「检查」与「样例合规」，以及仓库可安装；前半段「任意新文自动装配」仍要靠 Agent 按 SKILL 执行。 对已经在用 Claude Code / Cursor 写稿的人，把它放进 skills 目录的成本主要是克隆与路径配置。对只想命令行验收的人，不启动 Agent 也能用两个 Python 脚本完成 lint 与 validate，这降低了「先确认工具是否值得接入工作流」的门槛。 ## 八、最小复现清单（读者可照做） 1. 克隆 `https://github.com/isjiamu/gzh-design-skill`。 2. 进入仓库，执行 `python3 scripts/component_lint.py`，确认 ERROR 为 0。 3. 执行 `python3 scripts/validate_gzh_html.py archive/gallery-v1/hongbai.html`，确认出现「完全合规」。 4. 自建一份含 `<style>` 或 `class=` 的短 HTML，再跑同一校验，确认出现 ERROR。 5. （可选）对合规 HTML 运行 `wrap_preview.py`，浏览器打开预览页尝试复制。 6. 若需要完整排版，在 Agent 中加载 SKILL，按主题索引选择主题并装配，再以校验脚本收口。 完成 1–4 步，即与本次实验室的脚本层结论对齐。若第 3 步失败，优先检查 Python 版本与文件路径，而不是先改文章内容。 **附录（机器标识）** experiment_id=`8374091e-2535-454d-94ed-639e35e1cdc3`；产物目录 `outputs/2026-09-07/03-experiment/v31-prod-20260907T1646/`。

视频制作包 · 已准备

视频制作包 · gzh-design-skill（待用户审 29s 测片）

run_id: v31-prod-20260907T1646 experiment_id: 8374091e-2535-454d-94ed-639e35e1cdc3 音频锁定: Desktop/gzh-design-skil.aifc + YouTube口播稿 当前状态: 29s 测片制作中，用户验收前不发布。 片头: Pexels 免版权实拍（情景配画） 中段: 本机校验实拍 片尾: 收成区真页（填齐后录）