kunpeng-gzh-skills

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 先修文章格式再重跑。
• 生图慢（每张 3060s），--fig-prompts 控制在 24 张。
• 封面渲染必须用 chrome channel（本机自带 chromium 缺失）。
• 平台白名单外的标签会被引擎拦截；插图脚本已按白名单输出 section/img。