# swing-wechat 微信公众号工具：用户操作手册

把 Word、PDF、图片、链接或零散文字交给 AI，它会帮助完成公众号正文、配图、排版和草稿推送。

日常使用只需要记住一个入口：`swing-wechat-workflow`。

## 让 Agent 帮你安装

在 Codex、Claude Code、Cursor、Trae 或其他能够读取网页的 Agent 中输入：

```text
帮我安装 swing-wechat 的 Skills：
https://tiny-wings.com/docs/swing-wechat/install-guide.md
```

Agent 会读取安装手册、安装完整的 7 个配套 Skill，并验证结果。

## 手动安装

推荐在专门的公众号资料目录中运行：

```powershell
npx skills add "https://tiny-wings.com" --skill swing-wechat-workflow swing-wechat-env-config swing-wechat-secret-config swing-wechat-markdown swing-wechat-html swing-wechat-layout swing-wechat-publish
```

需要在电脑的任何目录使用时执行全局安装：

```powershell
npx skills add "https://tiny-wings.com" -g --skill swing-wechat-workflow swing-wechat-env-config swing-wechat-secret-config swing-wechat-markdown swing-wechat-html swing-wechat-layout swing-wechat-publish
```

## 开始制作文章

把资料交给 AI 后说：

```text
请使用 swing-wechat-workflow，把这些资料制作成抟微科技公众号文章。
```

也可以直接说：

```text
把这份 Word 和图片整理成三河序公众号文章，生成完整预览后再决定是否推送草稿。
```

## 工作流程

```text
确认目标公众号与品牌画像
  -> 选择极速生成或高质量生成
  -> 环境与账号预检
  -> 生成大纲和正文
  -> 选择生图方式
  -> 生成并确认封面与正文配图
  -> 生成微信公众号 HTML 排版
  -> 查看完整成品
  -> 明确确认后创建草稿
```

## 两种生成模式

| 模式 | 处理方式 | 适合场景 |
|---|---|---|
| 极速生成 | 自动采用推荐标题、正文、配图和排版，最后查看完整成品 | 时间紧、资料和要求明确 |
| 高质量生成 | 逐步确认大纲、正文、真实图片候选和排版预览 | 正式发布、重点文章、需要精细调整 |

无论使用哪种模式，都不会自动推送草稿或正式发布。

## 两种生图方式

首次真正需要生成图片时，AI 会询问一次：

| 选项 | 说明 |
|---|---|
| swing-wechat 内置生图（默认） | 使用内置的专业封面、文章插图、信息图和关系图生成链路；只按需安装当前文章需要的依赖 |
| 当前 Agent ImgGen | 使用当前 AI 工具自身提供的系统级图片生成能力，例如 Codex 的 `$imagegen` |

本篇文章的预览图、最终图和重新生成会沿用同一选择。所选能力不可用时，AI 会说明问题并询问是否切换，不会静默更换。

## 账号与安全

- `tiny-wings`：抟微科技 Tiny Wings。
- `sanhe-xu`：三河序 SANHEXU 青稞酒。

每个公众号使用自己的 AppID 和 AppSecret。首次需要推送草稿时，AI 会引导在本地终端隐藏输入。不要把 AppSecret 发到 AI 聊天、群聊、邮件或文章文件中。

只有明确回复“确认推送草稿”后，AI 才会写入微信公众号草稿箱。工作流不会自动正式发布，最终发布仍需登录微信公众平台人工完成。