# swing-wechat 微信公众号 Skills：Agent 安装手册

用户把本手册 URL 交给你并要求安装 swing-wechat 后，请直接完成安装和验证，不要只复述命令。

## 安装目标

安装完整的微信公众号内容生产工作流。日常使用入口是 `swing-wechat-workflow`，其余 Skill 是配套组件，必须一起安装。

本次只安装或更新 Skill：

- 不索取或配置微信公众号 AppID、AppSecret。
- 不预装 Baoyu 视觉 Skill。
- 用户实际进入图片生成节点并选择“swing-wechat 内置生图”后，由工作流按当前图片类型补装最小依赖集。

## 1. 确定安装范围

默认执行项目局部安装：在用户当前的公众号资料目录中安装。当前目录不适合保存公众号正文、图片和 HTML，且用户没有指定目录时，只询问一次目标目录。

只有用户明确要求“全局安装”或“任何目录都能使用”时，才执行全局安装。

## 2. 检查环境

```powershell
node --version
npx --version
```

任一命令不可用时，协助用户安装 Node.js LTS，完成后再继续。

## 3. 安装全部 Skill

### 项目局部安装（默认）

在选定的公众号资料目录运行：

```powershell
npx -y 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 -y
```

### 全局安装

仅在用户明确选择全局安装时运行：

```powershell
npx -y 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 -y
```

遇到已安装版本时，使用安装器提供的更新或覆盖流程，不要手工删除用户的 Skill 目录。

## 4. 验证

项目局部安装：

```powershell
npx -y skills list --json
```

全局安装：

```powershell
npx -y skills list -g --json
```

确认结果同时包含：

```text
swing-wechat-workflow
swing-wechat-env-config
swing-wechat-secret-config
swing-wechat-markdown
swing-wechat-html
swing-wechat-layout
swing-wechat-publish
```

缺少任意一项都不算完成。补装缺失项后重新验证。

## 5. 向用户报告

安装成功后，简短报告：

- 项目局部安装或全局安装。
- 实际安装目录。
- 7 个 Skill 的验证结果。
- 当前任务若未刷新技能索引，需要新建任务或重启 AI 工具。

告诉用户日常可以这样开始：

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

实际进入图片生成节点时，工作流会询问：

- `swing-wechat 内置生图`：使用公众号工作流内置的专业视觉链路，并按需安装最小依赖集。
- `当前 Agent ImgGen`：使用当前 AI 工具自身的系统级图片生成能力。

## 安全边界

- 不得在聊天中收集 AppSecret。
- 首次需要推送草稿时，由 `swing-wechat-workflow` 引导用户在本地终端隐藏输入。
- 只有用户查看完整成品并明确回复“确认推送草稿”后才能创建草稿。
- 不得自动正式发布微信公众号文章。