jwangkun 鲲鹏公众号 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），4 张。--fig-prompts控制在 2 - 封面渲染必须用 chrome channel（本机自带 chromium 缺失）。
- 平台白名单外的标签会被引擎拦截；插图脚本已按白名单输出 section/img。