# Kunpeng Gzh Skills

> 鲲鹏Talk 专属微信公众号文章全流程生产 Skill（完全自包含，内置排版引擎与生图模块，不依赖任何其他 skill）。把用户发来的任何内容/主题/素材/链接，一站式产出可直接复制粘贴到微信公众号编辑器的成品：撰写文章 → 摸鱼绿排版 → 瑞士风封面（21:9 头图 + 1:1 分享卡）→ GPT Image 2 按章节生成配图 → 自动插图（封面+配图 base64 内嵌到对应位置）→ 打开预览页。用户说「写公众号 / 生成公众号文章 / 公众号排版 / 鲲鹏公众号 / 帮我写一篇公众号」时使用；用户发内容要求出公众号文章时优先走本 Skill 全流程。

- Skill: `jwangkun/kunpeng-gzh-skills` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add jwangkun/kunpeng-gzh-skills`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jwangkun/kunpeng-gzh-skills/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jwangkun (https://skillmd.com/u/jwangkun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/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
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` 控制在 2~4 张。
- 封面渲染必须用 chrome channel（本机自带 chromium 缺失）。
- 平台白名单外的标签会被引擎拦截；插图脚本已按白名单输出 section/img。