# WeWrite

公众号文章全流程 AI Skill —— 从热点抓取到草稿箱推送，一句话搞定。

兼容 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 和 [OpenClaw](https://github.com/anthropics/openclaw) 的 skill 格式。安装后说「写一篇公众号文章」即可触发完整流程。

## 它能做什么

```
"写一篇公众号文章"
  → 抓热点 → 选题评分 → 素材采集 → 框架选择
  → 写作（真实信息锚定 + 7层去AI痕迹 + 编辑锚点）
  → SEO优化 → AI配图 → 微信排版 → 推送草稿箱
```

首次使用时会引导你设置公众号风格，之后每次只需一句话。生成的文章带有 2-3 个编辑锚点——花 3-5 分钟加入你自己的话，文章就会从"AI 初稿"变成"你的作品"。

## 核心能力

| 能力 | 说明 | 实现 |
|------|------|------|
| 热点抓取 | 微博 + 头条 + 百度实时热搜 | `scripts/fetch_hotspots.py` |
| SEO 评分 | 百度 + 360 搜索量化评分 | `scripts/seo_keywords.py` |
| 选题生成 | 10 选题 × 3 维度评分 + 历史去重 | `references/topic-selection.md` |
| 素材采集 | WebSearch 真实数据/引述/案例 | SKILL.md Step 3b |
| 框架生成 | 5 套写作骨架（痛点/故事/清单/对比/热点） | `references/frameworks.md` |
| 文章写作 | 真实信息锚定 + 7 层去 AI + 编辑锚点 | `references/writing-guide.md` |
| SEO 优化 | 标题策略 / 摘要 / 关键词 / 标签 | `references/seo-rules.md` |
| 视觉 AI | 封面 3 创意 + 内文 3-6 配图 | `toolkit/image_gen.py` |
| 排版发布 | 16 主题 + 微信兼容修复 + 暗黑模式 | `toolkit/cli.py` |
| 效果复盘 | 微信数据分析 API 回填阅读数据 | `references/effect-review.md` |
| 风格飞轮 | 学习你的修改，越用越像你 | `references/learn-edits.md` |

## 关于 AI 检测

WeWrite 生成的是**高质量初稿**，不是"骗过检测器的文本"。

我们实测过朱雀 AI：纯 AI 生成的内容无论表面技巧多好，底层 token 分布仍然是 AI 的。但如果你在文章的编辑锚点位置加入 3-5 句自己的话，检测通过率会显著提升。

WeWrite 的策略是让你的编辑成本最低：
1. **素材采集**：自动搜索真实数据/引述/案例，锚定在文章中（不编造）
2. **7 层写作规范**：从词汇、句法、密度、连贯性、情绪等维度制造"人味"
3. **编辑锚点**：在 2-3 个关键位置标记"在这里加一句你自己的话"
4. **学习飞轮**：每次你编辑后说"学习我的修改"，下次初稿更接近你的风格

## 排版引擎

### 16 个主题

```bash
# 浏览器内预览所有主题（并排对比 + 一键复制）
python3 toolkit/cli.py gallery

# 列出主题名称
python3 toolkit/cli.py themes
```

| 类别 | 主题 |
|------|------|
| 通用 | `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 内联注入 |

### 容器语法

````markdown
:::dialogue
你好，请问这个功能怎么用？
> 很简单，直接在 Markdown 里写就行。
:::

:::timeline
**2024 Q1** 立项启动
**2024 Q3** MVP 上线
:::

:::callout tip
提示框，支持 tip / warning / info / danger。
:::

:::quote
好的排版不是让读者注意到设计，而是让读者忘记设计。
:::
````

## 安装

```bash
git clone https://github.com/oaker-io/wewrite.git
cd wewrite
pip install -r requirements.txt
```

### 挂载为 Skill

**Claude Code**：`cp -r wewrite ~/.claude/skills/wewrite`

**OpenClaw**：`cp -r wewrite /path/to/openclaw/skills/wewrite`

### 配置（可选）

```bash
cp config.example.yaml config.yaml
```

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

## 快速开始

```
你：写一篇公众号文章
你：写一篇关于 AI Agent 的公众号文章
你：交互模式，写一篇关于效率工具的推文
你：帮我润色一下刚才那篇
你：学习我的修改                  → 飞轮学习
你：看看有什么主题                → 主题画廊
你：换成 sspai 主题               → 切换主题
你：看看文章数据怎么样            → 效果复盘
```

## 目录结构

```
wewrite/
├── SKILL.md                  # 主管道（273行，Step 1-8）
├── config.example.yaml       # API 配置模板
├── style.example.yaml        # 风格配置模板
├── writing-config.example.yaml # 写作参数模板（可用 optimize loop 调优）
├── requirements.txt
│
├── scripts/                  # 数据采集 + 优化
│   ├── fetch_hotspots.py       # 多平台热点抓取
│   ├── seo_keywords.py         # SEO 关键词分析
│   ├── fetch_stats.py          # 微信文章数据回填
│   ├── build_playbook.py       # 从历史文章生成 Playbook
│   ├── learn_edits.py          # 学习人工修改
│   ├── humanness_score.py      # 文章"人味"打分器（客观 checklist + LLM 判官）
│   └── optimize_loop.py        # autoresearch 风格迭代优化框架
│
├── toolkit/                  # Markdown → 微信工具链
│   ├── cli.py                  # CLI（preview / publish / gallery / themes）
│   ├── converter.py            # Markdown → 内联样式 HTML + 微信兼容修复
│   ├── theme.py                # YAML 主题引擎
│   ├── publisher.py            # 微信草稿箱 API
│   ├── wechat_api.py           # access_token / 图片上传
│   ├── image_gen.py            # AI 图片生成（doubao / OpenAI）
│   └── themes/                 # 16 套排版主题（含暗黑模式）
│
├── references/               # Agent 按需加载
│   ├── writing-guide.md        # 写作规范 + 7 层去 AI 痕迹 + 自检清单
│   ├── frameworks.md           # 5 种写作框架
│   ├── topic-selection.md      # 选题评估规则
│   ├── seo-rules.md            # 微信 SEO 规则
│   ├── visual-prompts.md       # 视觉 AI 提示词规范
│   ├── wechat-constraints.md   # 微信平台限制 + 自动修复
│   ├── style-template.md       # 风格配置字段 + 16 主题列表
│   ├── onboard.md              # 首次设置流程
│   ├── learn-edits.md          # 学习飞轮流程
│   └── effect-review.md        # 效果复盘流程
│
├── output/                   # 生成的文章
├── corpus/                   # 历史语料（可选）
└── lessons/                  # 修改记录（自动生成）
```

运行时自动生成（不入 git）：`style.yaml`、`history.yaml`、`playbook.md`、`writing-config.yaml`

## 工作流程

```
Step 1  环境检查 + 加载风格（不存在则 Onboard）
  ↓
Step 2  热点抓取 → 历史去重 + SEO → 选题
  ↓
Step 3  框架选择 → 素材采集（WebSearch 真实数据）
  ↓
Step 4  维度随机化 → 写作（7层规范 + 真实素材锚定 + 编辑锚点）
  ↓
Step 5  SEO 优化 → 去 AI 逐层验证（9 项自检）
  ↓
Step 6  视觉 AI（封面 + 内文配图）
  ↓
Step 7  排版 + 发布（16 主题 + 微信兼容修复）
  ↓
Step 8  写入历史 → 回复用户（含编辑建议 + 飞轮提示）
```

默认全自动。说"交互模式"可在选题/框架/配图处暂停确认。

## 优化循环（实验性）

借鉴 [autoresearch](https://github.com/karpathy/autoresearch) 的 change→score→keep/rollback 模式，WeWrite 提供写作参数自动调优框架：

```bash
# 对一篇文章打分（客观 checklist + 主观 LLM 判官）
python3 scripts/humanness_score.py article.md --verbose

# 迭代优化写作参数
python3 scripts/optimize_loop.py --topic "AI Agent" --iterations 10
```

框架开源，但优化后的 `writing-config.yaml` 不入 git——每个用户跑出自己的最优参数。

## Toolkit 独立使用

```bash
# Markdown → 微信 HTML
python3 toolkit/cli.py preview article.md --theme sspai

# 主题画廊
python3 toolkit/cli.py gallery

# 发布草稿箱
python3 toolkit/cli.py publish article.md --cover cover.png --title "标题"

# 抓热点
python3 scripts/fetch_hotspots.py --limit 20

# SEO 分析
python3 scripts/seo_keywords.py --json "AI大模型" "科技股"
```

## License

MIT