# WeWrite — 公众号文章全流程 AI Skill

> 来源: https://github.com/oaker-io/wewrite
> 研究日期: 2026-05-04

## 项目定位

**一句话搞定公众号文章**：从热点抓取 → 选题 → 写作 → SEO → 视觉 AI → 排版 → 微信草稿箱推送

兼容 **Claude Code** 和 **OpenClaw** 的 skill 格式。

## 核心能力

| 能力 | 实现 |
|------|------|
| 热点抓取 | 微博 + 头条 + 百度实时热搜（`fetch_hotspots.py`） |
| SEO 评分 | 百度 + 360 搜索量化评分（`seo_keywords.py`） |
| 选题生成 | 10 选题 × 3 维度评分 + 历史去重 |
| 素材采集 | WebSearch 真实数据/引述/案例（不编造） |
| 框架生成 | 7 套写作骨架（痛点/故事/清单/对比/热点解读/纯观点/复盘） |
| 内容增强 | 按框架类型自动匹配策略 |
| 文章写作 | 真实信息锚定 + 风格注入 + 编辑锚点 |
| SEO 优化 | 标题策略/摘要/关键词/标签 |
| AI 配图 | 封面 3 创意 + 内文 3-6 配图（9 provider 自动 fallback） |
| 排版发布 | 16+ 主题 + 微信兼容修复 + 暗黑模式 |
| 效果复盘 | 微信数据分析 API 回填 |
| 风格飞轮 | 学习用户修改，越用越像用户 |
| 范文风格库 | SICO 式 few-shot，从已发布文章提取风格指纹 |

## 5 套写作人格（Writing Persona）

| 人格 | 适合 | 风格 |
|------|------|------|
| midnight-friend | 个人号/自媒体 | 极度口语化、高自我怀疑、第一人称 |
| warm-editor | 生活/文化/情感 | 温暖叙事、故事嵌套数据 |
| industry-observer | 行业媒体/分析 | 中性分析、数据先行、稳中带刺 |
| sharp-journalist | 新闻/评论 | 犀利简洁、数据驱动、强观点 |
| cold-analyst | 财经/投研 | 冷静克制、逻辑链条、风险意识强 |

## 16+ 排版主题

| 类别 | 主题 |
|------|------|
| 通用 | professional-clean（默认）、minimal、newspaper |
| 科技 | tech-modern、bytedance、github |
| 文艺 | warm-editorial、sspai、ink、elegant-rose |
| 商务 | bold-navy、minimal-gold、bold-green |
| 风格 | bauhaus、focus-red、midnight |

全部支持微信暗黑模式。

## 微信自动修复

| 问题 | 自动修复 |
|------|----------|
| 外链被屏蔽 | 转上标编号脚注 + 文末参考链接 |
| 中英混排无间距 | CJK-Latin 自动加空格 |
| 加粗标点渲染异常 | 标点移到 `</strong>` 外 |
| 原生列表不稳定 | `<ul>/<ol>` 转样式化 `<section>` |
| 暗黑模式颜色反转 | 注入 `data-darkmode-*` 属性 |
| `<style>` 被剥离 | 所有 CSS 内联注入 |

## 安装

### OpenClaw
```bash
git clone --depth 1 https://github.com/oaker-io/wewrite.git ~/.openclaw/skills/wewrite
cd ~/.openclaw/skills/wewrite && pip install -r requirements.txt
cp config.example.yaml config.yaml
```

### Claude Code
```bash
git clone --depth 1 https://github.com/oaker-io/wewrite.git ~/.claude/skills/wewrite
cd ~/.claude/skills/wewrite && pip install -r requirements.txt
```

## 配置

```yaml
# config.yaml
# 微信公众号 appid/secret（推送需要）
# 图片 API key（生图需要）
# 不配也能用——自动降级为本地 HTML + 输出图片提示词
```

## 使用方式

```
你：写一篇公众号文章
你：写一篇关于 AI Agent 的公众号文章
你：交互模式，写一篇关于效率工具的推文
你：帮我润色一下刚才那篇
你：学习我的修改 → 飞轮学习
你：看看有什么主题 → 主题画廊
你：换成 sspai 主题 → 切换主题
你：检查一下 → 生成报告 + 质量自检
你：导入范文 → 建立风格库
```

## 目录结构

```
wewrite/
├── SKILL.md              # 主管道（Step 1-8）
├── config.example.yaml   # API 配置模板
├── style.example.yaml    # 风格配置模板
├── scripts/              # 数据采集 + 诊断 + 构建
│   ├── fetch_hotspots.py # 多平台热点抓取
│   ├── seo_keywords.py   # SEO 关键词分析
│   ├── humanness_score.py # 文章质量打分（11项检测）
│   ├── extract_exemplar.py # 范文风格提取
│   ├── learn_theme.py    # 从公众号文章 URL 提取排版主题
│   └── fetch_article.py  # 从公众号 URL 提取正文为 Markdown
├── toolkit/              # Markdown → 微信工具链
│   ├── cli.py            # CLI（preview / publish / gallery）
│   ├── converter.py      # Markdown → 内联样式 HTML
│   ├── publisher.py      # 微信草稿箱 API + 小绿书图片帖
│   ├── image_gen.py      # AI 图片生成（9 provider）
│   └── themes/           # 16+ 排版主题
├── personas/             # 5 套写作人格预设
├── references/           # Agent 按需加载的参考文档
└── output/               # 生成的文章
```

## 与 OpenClaw 的关系

- 兼容 OpenClaw skill 格式，有专门的 `dist/openclaw/` 构建
- 可安装到 `~/.openclaw/skills/wewrite`
- 需要配置微信公众号 appid/secret（我们已有：`wxdbcccdac8e7c97be`）
- 图片 API 可用百炼 qwen-image-2.0

## 核心设计理念

**不是"骗过 AI 检测"，而是写出值得读的文章**：
1. 内容增强 — 按框架类型自动执行不同策略
2. 素材采集 — 真实数据锚定，不编造
3. 编辑锚点 — 在 2-3 个关键位置标记"在这里加一句你自己的话"
4. 学习飞轮 — 每次编辑后学习，下次更接近用户风格
5. 范文风格库 — 导入已发布文章，写作时注入风格指纹

## MIT 许可证