guanrentang-writer

GitHub 作者 LeoYeAI/openclaw-master-skills v1.4.0

观仁堂中医公众号文章生成器。写文章 + 自动配图一体化。当用户说"写文章"、"帮我写一篇"、"公众号文章"时自动触发。支持随机选题和固定主题（古法熏蒸推广、放假通知），生成符合观仁堂风格的中医养生文章，并自动配图。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install github:LeoYeAI~openclaw-master-skills~guanrentang-writer

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/github%3ALeoYeAI~openclaw-master-skills~guanrentang-writer/file -o guanrentang-writer.md

# 观仁堂中医公众号文章生成器

**一站式完成**：选题 → 写文章 → 配图 → 输出成品

## 配置

| 配置项 | 默认值 | 说明 |
|-------|--------|------|
| `output_dir` | `{当前工作目录}/articles` | 文章输出目录 |
| `api_key` | 见下方优先级 | 智谱 API Key |
| `skill_dir` | `~/.claude/skills/guanrentang-writer` | Skill 安装目录 |

### 输出目录设置

**方式一：使用默认路径**
- 不指定时，自动输出到 `{当前工作目录}/articles/`

**方式二：用户指定路径**
- 对话中说 "输出到 ~/Desktop/my-article" 或 "保存到 ./output"
- AI 会使用用户指定的路径

### API Key 配置优先级

1. 环境变量 `ZHIPU_API_KEY`
2. `{skill_dir}/.env` 文件中的 `ZHIPU_API_KEY`

### 首次使用配置

**步骤 1**：获取智谱 API Key
- 访问 [智谱开放平台](https://open.bigmodel.cn/) 注册并获取 API Key

**步骤 2**：选择配置方式（二选一）

| 方式 | 命令 | 说明 |
|-----|------|------|
| **方式一：环境变量** | 在 `~/.zshrc` 或 `~/.bashrc` 中添加 `export ZHIPU_API_KEY=your_key` | 全局可用，适合多个项目 |
| **方式二：.env 文件** | 在 skill 目录下创建 `.env` 文件，内容为 `ZHIPU_API_KEY=your_key` | 仅此 skill 使用，已加入 .gitignore |

> **执行前检查**：如果未配置 API Key，应提示用户选择上述方式之一配置后再继续

## 固定素材

公众号文章开头和结尾需要固定图片（存放在 `{skill_dir}/assets/` 目录）：

| 文件名 | 用途 | 说明 |
|-------|------|------|
| `header-decorative.jpg` | 开头装饰图 | 文章开头装饰性图片 |
| `gufa-xunzheng-cover.jpg` | 古法熏蒸封面 | 古法熏蒸推广文章专用封面图 |
| `holiday-notice-cover.jpg` | 放假通知封面 | 放假通知文章专用封面图 |
| `ending-thanks.jpg` | 感谢图 | "您点的每个赞，我都认真当成了喜欢" + 中国传统元素 |
| `ending-divider.jpg` | 分隔装饰图 | 感谢图后的装饰性分隔图 |
| `ending-follow.png` | 关注引导图 | "关注我们" 引导图 |
| `ending-qrcode.jpg` | 二维码图 | "微信扫一扫 关注该公众号" + 公众号二维码 |

> **首次使用**：需要将这些图片放入 `{skill_dir}/assets/` 目录

## 公众号图片尺寸规范

| 位置 | 推荐尺寸 | 比例 | GLM-Image size | 备注 |
|------|---------|------|----------------|------|
| 正文配图 | 1080×810 px | 4:3 | `1472x1088` | AI 生成 |
| 食疗图 | 1080×1080 px | 1:1 | `1280x1280` | AI 生成 |
| 开头装饰图 | - | - | - | **固定素材** |
| 结尾系列图 | - | - | - | **固定素材**（4张） |

> **注意**：GLM-Image 尺寸需为 32 的整数倍，范围 512-2048

## 使用方式

| 用户说 | 效果 |
|-------|------|
| "帮我写一篇文章" | 自动选题，输出到默认目录 |
| "写个春季养生的" | 指定主题，输出到默认目录 |
| "随机写一篇" | 随机选题，输出到默认目录 |
| "古法熏蒸" / "写个熏蒸广告" | 固定主题：古法熏蒸推广文章 |
| "放假通知" / "写个放假通知" | 固定主题：放假通知（仅正文图片，用户提供） |
| "输出到 ~/Desktop" | 使用指定输出目录 |
| "保存到 ./my-articles" | 使用相对路径 |
| "只写文章" | 写文章但不配图（草稿模式） |

---

## 执行流程

### Step 1: 选题

1. 用户说"古法熏蒸"/"熏蒸广告" → **固定主题：古法熏蒸推广**
2. 用户说"放假通知"/"假期通知" → **固定主题：放假通知**
3. 用户指定其他主题 → 使用指定主题
4. 用户未指定 → 根据当前月份/节气自动选择（参考 STYLE.md 主题库）
5. 用户说"随机" → 从主题库随机选

**生成文件名**：使用日期前缀 + 文章标题（中文）
- 格式：`YYYY-MM-DD-文章标题.md`
- 例：`2026-03-22-清明养生：养肝明目，踏青防过敏.md`
- 例：`2026-03-19-回南天祛湿大作战.md`
- 图片目录：`images/文章标题/`（不带日期前缀）

### Step 2: 创建输出目录

```bash
# 创建文章和图片目录
mkdir -p "${OUTPUT_DIR}/images/${ARTICLE_TITLE}/"

# 复制固定素材到输出目录
cp -r "${SKILL_DIR}/assets" "${OUTPUT_DIR}/"
```

> **注意**：`SKILL_DIR` 默认为 `~/.claude/skills/guanrentang-writer`

### Step 3: 写文章 + 智能标记配图位置

按照 `STYLE.md` 中的风格撰写文章：
- 字数：1000-1500 字
- 结构：开头 → 原理 → 分点实操 → 注意事项 → 结尾
- 必须包含：中医理论 + 食疗方 + 穴位/注意事项
- 固定结尾语："您点的每个赞，我都认真当成了喜欢"

**智能配图规则**（根据文章内容自动判断）：

| 配图位置 | 触发条件 | 处理方式 |
|---------|---------|----------|
| **开头装饰** | 必有 | **固定素材**：header-decorative.jpg |
| **原理配图** | 有"中医认为"/理论段落 | AI 生成：根据理论内容（如"肝主疏泄"→肝脏示意） |
| **实操配图** | 每个实操要点后 | AI 生成：根据要点内容（穴位→穴位图，食疗→食材图） |
| **食疗特写** | 有具体食疗方 | AI 生成：食疗方名称 + 主要食材 |
| **结尾图** | 必有 | **固定素材**：使用已复制的 `assets/` 目录图片 |

**配图数量控制**：
- 1000 字文章：3-4 张 AI 图 + 1 张开头 + 4 张结尾 = 8-9 张
- 1200 字文章：4-5 张 AI 图 + 1 张开头 + 4 张结尾 = 9-10 张
- 1500 字文章：5-6 张 AI 图 + 1 张开头 + 4 张结尾 = 10-11 张

**文章中标记图片位置**（使用 .jpg/.png 格式）：

```markdown
![开头装饰](./assets/header-decorative.jpg)

## 正文开头
...

![配图：{图片内容描述}](./images/{文章标题}/content-1.jpg)

## 理论原理
...

![配图：{图片内容描述}](./images/{文章标题}/content-2.jpg)

## 食疗方推荐
...

![食疗：{食疗方名称}](./images/{文章标题}/recipe.jpg)

您点的每个赞，我都认真当成了喜欢

![结尾：感谢](./assets/ending-thanks.jpg)

![结尾：分隔](./assets/ending-divider.jpg)

![结尾：关注](./assets/ending-follow.png)

![结尾：二维码](./assets/ending-qrcode.jpg)
```

> **重要**：
> - 内容配图（配图、食疗）使用 AI 生成，alt 文本描述图片内容用于生成 Prompt
> - 开头和结尾图使用固定素材，路径为 `./assets/`（相对于文章目录）
> - 图片不需要 `<center>` 标签，在微信编辑器中手动居中即可

### Step 4: 保存文章草稿

保存文章到 `${OUTPUT_DIR}/YYYY-MM-DD-{文章标题}.md`

- 文件名格式：日期前缀 + 文章标题（中文）
- 图片目录：`images/{文章标题}/`（不带日期前缀）

### Step 5: 自动生成配图

**执行时机**：文章写完并保存后，立即开始配图

**自动化流程**：

1. **解析文章**：提取所有 `![类型：描述](路径)` 格式的图片标记
2. **生成 Prompt**：根据图片类型和描述自动生成 Prompt
3. **调用 API**：依次生成每张图片
4. **下载保存**：下载到对应路径
5. **更新进度**：每完成一张报告进度

**Prompt 自动生成规则**：

```
图片标记格式：
- 开头装饰：![开头装饰](路径) → 跳过（固定素材）
- 配图：![配图：描述](路径) → 使用内容模板 + 描述内容
- 食疗：![食疗：名称](路径) → 使用食疗模板 + 食疗方名称
- 结尾：![结尾：感谢/分隔/关注/二维码](路径) → 跳过（已复制固定素材）

类型识别：
- 开头装饰 → 跳过（使用 ./assets/header-decorative.jpg）
- 配图 → AI 生成
- 食疗 → AI 生成
- 结尾：感谢 → 跳过（使用 ./assets/ending-thanks.jpg）
- 结尾：分隔 → 跳过（使用 ./assets/ending-divider.jpg）
- 结尾：关注 → 跳过（使用 ./assets/ending-follow.png）
- 结尾：二维码 → 跳过（使用 ./assets/ending-qrcode.jpg）
```

**API 配置**：

| 配置项 | 值 |
|-------|-----|
| Endpoint | `https://open.bigmodel.cn/api/paas/v4/images/generations` |
| Model | `glm-image` |
| API Key | 优先级：环境变量 `ZHIPU_API_KEY` > `{skill_dir}/.env` |

**Prompt 模板**：

| 图片类型 | 尺寸 | Prompt 模板 |
|---------|------|------------|
| 配图 | `1472x1088` | `中医养生插画，{描述内容}，新中式水墨插画风格，中国传统色（黛青、朱砂、米白），淡雅晕染效果，留白构图，温暖治愈氛围，适合微信公众号配图` |
| 食疗 | `1280x1280` | `中式养生美食摄影，{食疗方名称}，陶瓷或木质器皿盛放，点缀中药材装饰，清新淡雅，养生氛围，暖色调，高清细节` |

**生成命令**（curl）：

```bash
# 1. 调用 API 生成图片
RESPONSE=$(curl -s -X POST "https://open.bigmodel.cn/api/paas/v4/images/generations" \
  -H "Authorization: Bearer $ZHIPU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-image",
    "prompt": "中医养生插画，春季养肝疏肝示意图，新中式水墨插画风格，中国传统色（黛青、朱砂、米白），淡雅晕染效果，留白构图，温暖治愈氛围，适合微信公众号配图",
    "size": "1472x1088"
  }')

# 2. 提取图片 URL
IMAGE_URL=$(echo "$RESPONSE" | jq -r '.data[0].url')

# 3. 下载图片到本地
curl -s -o "${OUTPUT_DIR}/images/${ARTICLE_TITLE}/content-1.jpg" "$IMAGE_URL"
```

**错误处理**：

| 错误类型 | 处理方式 |
|---------|---------|
| API 429 限流 | 等待 5 秒后重试，最多 2 次 |
| API 其他错误 | 记录错误，跳过此图，继续下一张 |
| 下载失败 | 重试 1 次，仍失败则跳过 |

**间隔要求**：每张图片之间间隔 2 秒，避免触发限流

**进度报告**：

```
🎨 配图进度：1/5 开头装饰（固定素材）✓
🎨 配图进度：2/5 肝脏示意 ✓
🎨 配图进度：3/5 枸杞菊花茶 ✓
🎨 配图进度：4/5 太冲穴 ✓
🎨 配图进度：5/5 结尾图（固定素材）✓
```

### Step 6: 输出结果

```
✅ 文章已完成！

📄 文章: ${OUTPUT_DIR}/{文章标题}.md
🖼️ 配图: X/Y 张成功
📁 图片: ${OUTPUT_DIR}/images/{文章标题}/
📁 素材: ${OUTPUT_DIR}/assets/

📊 统计: XXX 字，X 个标题
```

---

## 完整执行示例

```bash
# 1. 设置变量
SKILL_DIR="$HOME/.claude/skills/guanrentang-writer"
OUTPUT_DIR="${OUTPUT_DIR:-./articles}"
ARTICLE_TITLE="春季养肝全攻略"

# 2. 读取 API Key（优先级：环境变量 > skill 目录 .env）
if [ -z "$ZHIPU_API_KEY" ] && [ -f "$SKILL_DIR/.env" ]; then
  source "$SKILL_DIR/.env"
fi

# 3. 检查 API Key 是否配置
if [ -z "$ZHIPU_API_KEY" ]; then
  echo "❌ 未配置 ZHIPU_API_KEY"
  echo "请在 $SKILL_DIR/.env 中配置："
  echo "  ZHIPU_API_KEY=your_api_key_here"
  exit 1
fi

# 4. 创建目录
mkdir -p "${OUTPUT_DIR}/images/${ARTICLE_TITLE}/"

# 5. 复制固定素材到输出目录
cp -r "$SKILL_DIR/assets" "${OUTPUT_DIR}/"

# 6. 生成第一张配图（示例：春季养肝示意图）
curl -s -X POST "https://open.bigmodel.cn/api/paas/v4/images/generations" \
  -H "Authorization: Bearer $ZHIPU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-image","prompt":"中医养生插画，春季养肝疏肝示意图，肝脏与人体气机运行，新中式水墨插画风格，中国传统色（黛青、朱砂、米白），淡雅晕染效果，留白构图，温暖治愈氛围","size":"1472x1088"}' \
  | jq -r '.data[0].url' \
  | xargs -I {} curl -s -o "${OUTPUT_DIR}/images/${ARTICLE_TITLE}/content-1.jpg" "{}"

# 7. 等待 2 秒
sleep 2

# 8. 生成下一张图...
```

---

## 注意事项

1. 每张图片生成约需 10-20 秒，整篇文章配图约需 1-2 分钟
2. 如果配图失败，仍然输出文章，但提示"配图部分失败"
3. 文件名和目录名可使用中文，但建议避免特殊字符
4. 图片不需要 `<center>` 标签，复制到微信编辑器后手动居中即可

---

## 文件结构

```
{skill_dir}/
├── SKILL.md          # 本文件（执行指南）
├── STYLE.md          # 写作风格指南 + 主题库
├── .env              # API Key（不提交）
├── .gitignore
└── assets/           # 固定素材目录
    ├── header-decorative.jpg    # 开头装饰图
    ├── gufa-xunzheng-cover.jpg  # 古法熏蒸专用封面
    ├── holiday-notice-cover.jpg # 放假通知专用封面
    ├── ending-thanks.jpg        # 感谢图（普通文章用）
    ├── ending-divider.jpg       # 分隔装饰图
    ├── ending-follow.png        # 关注引导图
    └── ending-qrcode.jpg        # 二维码图

{output_dir}/
├── {文章标题}.md      # 生成的文章
├── images/
│   └── {文章标题}/   # 文章配图（AI 生成）
│       ├── content-1.jpg
│       ├── content-2.jpg
│       └── ...
└── assets/           # 复制的固定素材
    ├── header-decorative.jpg
    ├── gufa-xunzheng-cover.jpg
    ├── holiday-notice-cover.jpg
    ├── ending-thanks.jpg
    ├