| name | kunpeng-gzh-skills |
| description | 鲲鹏Talk 专属微信公众号文章全流程生产 Skill（完全自包含，内置排版引擎与生图模块，不依赖任何其他 skill）。把用户发来的任何内容/主题/素材/链接，一站式产出可直接复制粘贴到微信公众号编辑器的成品：撰写文章 → 摸鱼绿排版 → 瑞士风封面（21:9 头图 + 1:1 分享卡）→ GPT Image 2 按章节生成配图 → 自动插图（封面+配图 base64 内嵌到对应位置）→ 打开预览页。用户说「写公众号 / 生成公众号文章 / 公众号排版 / 鲲鹏公众号 / 帮我写一篇公众号」时使用；用户发内容要求出公众号文章时优先走本 Skill 全流程。 |
| version | 2.0.0 |
| metadata | {"owner":"鲲鹏Talk","home":"https://github.com/jwangkun/kunpeng-gzh-skills"} |
鲲鹏公众号 Skills（kunpeng-gzh-skills）
端到端公众号文章生产线：内容 → 文章 → 排版 → 封面 → 配图 → 自动插图 → 一键复制。
本 Skill 完全自包含：排版引擎（scripts/gzh_typeset/）、封面渲染、生图模块（直连 OpenAI Images API）全部内置，安装本 Skill 即可使用，无需安装其他任何 skill。
分工总表（用户已确认，自动执行）
| 环节 | 用什么 |
|---|
| 写文章 | 主 LLM 直接撰写（本 Skill 格式规范） |
| 排版 | 内置排版引擎（摸鱼绿 #0BA36A 默认，石墨极简备选） |
| 封面 | scripts/cover.py 瑞士风（2100×900 + 1080×1080，颜色随主题） |
| 配图 | scripts/img_gen.py 直连 new-api 反代 GPT Image 2 |
| 插图 | scripts/insert_images.py（封面插顶部、章节配图插标题后，base64 内嵌） |
| 交付 | open 预览页，用户一键复制；封面文件单独供发布设置 |
前置：环境与密钥
- 脚本路径：
scripts/（kunpeng-gzh.sh 一键流水线）。
- 运行依赖：Python 3（封面渲染另需 Playwright + Chrome，详见 README）。
- 生图密钥：
~/.config/kunpeng-gzh/secrets.env（本地，不提交 git / 不打包）。
- 若该文件缺失：提示用户提供 new-api Key，写入 secrets.env，并提醒不要外泄。
标准工作流（每次执行）
1. 收集输入
- 用户发的内容可能是：一句话主题、素材文本、链接、文档、口述要点。
- 先消化输入，明确：文章主题、核心信息点、是否需要配图、目标读者。
2. 撰写文章
- 按
references/article-format.md 规范写 Markdown，存为 article-gzh.md（工作目录 = 输出目录）。
- 硬性要求：无 frontmatter、h2 不编号、结尾「我是鲲鹏Talk，…」签名 + CTA。
- 署名一律「鲲鹏Talk」，简介「热衷于分享 AI 工具与开发经验」；绝不擅自起名。
- 先给用户一份文章大纲确认（可选，除非用户要求直接出）。
3. 规划配图（默认 2~4 张）
- 为每个拟插图的章节写生图提示词（扁平插画 / 简约信息图 / 科技感，与摸鱼绿协调）。
- 配图插入位置 = 章节标题（脚本自动定位）。
4. 一键跑流水线
bash <skill>/scripts/kunpeng-gzh.sh \
--md <工作目录>/article-gzh.md \
--title "文章标题" \
--summary "一句话摘要" \
--tags "DeepSeek,Codex,教程" \
--fig-prompts "今天发生了什么=提示词1;避坑指南=提示词2" \
--outdir <工作目录>
- 脚本自动执行：排版 → 封面 → 生图 → 插图 →
open 预览页。
- 不需要正文配图时去掉
--fig-prompts；不插封面用 --no-cover。
5. 校验与交付
- 检查脚本输出：0 ERROR / 0 WARNING；预览页已自动打开。
- 交付清单（都在工作目录）：
article-gzh.md：源稿article-gzh-final.html：最终可粘贴正文（封面+配图已 base64 内嵌，复制即用）article-gzh-preview.html：预览页（带「复制到公众号」按钮）cover-wide.png / cover-square.png：发布时设置封面用figs/：正文配图原图
- 回复用户时用 Markdown 绝对路径展示封面图与预览图。
避坑
- 排版引擎只在
report.ok 为 True 且 0 ERROR 时交付；有 ERROR 先修文章格式再重跑。
- 生图慢（每张 30
60s），--fig-prompts 控制在 24 张。
- 封面渲染必须用 chrome channel（本机自带 chromium 缺失）。
- 平台白名单外的标签会被引擎拦截；插图脚本已按白名单输出 section/img。
