Article Writer - AI 驱动的智能写作系统

🚀 专注公众号/自媒体文章创作的 AI 智能写作助手

在 Claude、Cursor、Gemini 等 AI 助手中直接使用斜杠命令，系统化创作高质量文章

✨ 核心特性

🎯 核心理念）⭐

AI不是代笔，而是你的写作伙伴

核心洞察：无论AI生成多少字，本质都是冰冷、套话、假细节。真实的内容只能来自人的亲身经历。

AI的5个致命伤：缺温度、缺个性、缺地域性、缺真实细节、缺思想

我们的目标：帮用户写出AI永远写不出的真实

多模式写作系统 (v0.10.0)：

根据文章类型和时间预算，选择合适的写作模式：

| 模式 | AI 角色 | AI 生成 | 时间投入 | AI 检测率 | 质量 | 适用场景 | |-----|---------|---------|---------|----------|------|---------| | 🎓 教练模式 | 教练（提问引导） | 0% | 3-4小时 | <15% | ⭐⭐⭐⭐⭐ | 产品评测、个人体验 | | ⚡ 快速模式 | 助手（生成初稿） | 100% | 1-2小时 | 25-40% | ⭐⭐⭐ | 论文解读、技术总结 | | 🔄 混合模式 | 协作者（写框架） | 40% | 2-3小时 | 18-25% | ⭐⭐⭐⭐ | 教程、案例分析 |

关键特性：

• 📝 智能推荐 - 根据文章主题自动推荐最合适的模式
• 🎯 自由选择 - 用户可根据时间和质量要求选择任何模式
• 💎 教练模式保留 - 追求极致真实性的用户仍可使用原有教练模式
• ⚡ 效率优先 - 快速模式支持 1-2 小时完成信息整理型文章

关键引用：

"编辑只要稍微过一下细，一眼就能分辨出来。" - 来自《AI写作的致命伤》

教练模式详细设计 → | 多模式系统设计 →

💻 现有功能

• 📚 斜杠命令 - 在 Claude、Gemini、Cursor、Windsurf 等 13 个 AI 助手中直接使用
• 🎯 九步写作流程 - 从选题到发布的完整创作流程
• 🤖 智能审校 - 三遍审校机制，降低 AI 味至 30% 以下
• 📁 工作区管理 - 公众号/视频/通用三种工作区，自动适配规则
• 💎 素材库系统 - 导入个人动态(即刻/微博)，融入真实素材
• 🕷️ 文档爬虫 - 自动爬取技术文档建立知识库，支持网页/PDF/动态页面
• 🎨 微信格式化 - 基于 doocs/md，一键格式化为微信公众号样式
• ⚙️ 交互式配置器 - 可视化样式定制，预设管理，三种配置方式
• 🔄 跨平台 - 支持 13 个 AI 工具，Windows/Mac/Linux 全平台
• 🔌 插件系统 - AI 检测、素材导入等可扩展功能

🚀 快速开始

1. 安装

npm install -g article-writer-cn

可选功能（按需安装）：

# 如需动态页面爬虫（SPA 网站）
npm install -g puppeteer

# 如需 PDF 文档爬取
npm install -g pdf-parse

# 如需云存储图床
npm install -g ali-oss              # 阿里云 OSS
npm install -g @aws-sdk/client-s3   # AWS S3
npm install -g cos-nodejs-sdk-v5    # 腾讯云 COS
npm install -g qiniu                # 七牛云

2. 初始化项目

# 基本用法
content init my-article

# 指定工作区类型
content init my-article --workspace wechat    # 公众号
content init my-article --workspace video     # 视频脚本
content init my-article --workspace general   # 通用内容

# 指定 AI 平台
content init my-article --ai claude    # Claude Code
content init my-article --ai gemini    # Gemini CLI
content init my-article --ai cursor    # Cursor

3. 开始创作

在 AI 助手中使用斜杠命令：

# 命令格式因平台而异
/specify           # 大多数平台
/content.specify   # Claude Code
/content:specify   # Gemini CLI
/content-specify   # Codex CLI

完整写作流程（11步）：

阶段1: 准备
1. /specify        → 定义创作需求（自动识别文章类型，推荐写作模式）
2. /topic          → 选题讨论（提示推荐模式，用户可自由选择）

阶段2: 收集
3. /research       → 信息搜索与调研 🕷️ 支持文档爬取
4. /collect        → 搜索个人素材库（教练/混合模式必需）
5. /extract        → 提取真实经历 ⭐（教练/混合模式必需）

阶段3: 写作
6. /write          → 多模式写作 ⭐ 三选一：
   🎓 教练模式：AI提问 → 你写 → AI检查（追求极致真实）
   ⚡ 快速模式：AI生成初稿 → 你审校（快速产出）
   🔄 混合模式：AI写框架 → 你填核心（平衡质量和效率）

阶段4: 检查
7. /authentic      → 5维真实性检查 ⭐（温度/个性/细节/思想）
8. /review         → 三遍审校（内容/风格/细节）

阶段5: 发布
9. /images         → 配图建议
10. /check         → 发布前检查
11. /publish       → 发布指南

辅助命令（随时可用）：
- /hint            → 表达思路提示
- /expand          → 快速扩展素材

核心特点：

• 🎯 多模式选择：根据文章类型和时间预算选择合适模式
• 🎓 教练模式（PRD-08）：AI提问，人写，AI检查（AI检测率 < 15%）
• ⚡ 快速模式（PRD-09）：AI生成初稿，快速产出（AI检测率 25-40%）
• 🔄 混合模式（PRD-09）：AI写框架，人填核心（AI检测率 18-25%）
• 📝 智能推荐：自动分析文章类型，推荐最合适模式

📊 完整架构流程图 - 查看九步写作流程、素材库系统、三遍审校机制、工作区管理等完整架构

🕷️ 文档爬虫增强 (v0.5.0 新增)

/research 命令现在支持自动爬取完整文档站：

# 在 AI 助手中直接使用
/research "Vue 3 官方文档" --url https://vuejs.org/guide/

自动完成:

• 🔄 爬取 200+ 页文档
• 📂 智能分类（入门/API/示例等）
• 📝 转换为 Markdown 格式
• 💾 永久保存到知识库

写作时自动引用:
AI 会直接读取知识库中的 Markdown 文件，查找准确的技术信息，大幅减少错误和编造。

详见：文档爬虫指南 | 使用示例

📚 斜杠命令

命名空间说明

| AI 平台 | 命令格式 | 示例 | |---------|----------|------| | Claude Code | /content.命令名 | /content.write | | Gemini CLI | /content:命令名 | /content:write | | Codex CLI | /content-命令名 | /content-write | | 其他平台 | /命令名 | /write |

💡 下表使用通用格式，实际使用时请根据您的 AI 平台添加相应前缀

核心命令列表

| 命令 | 描述 | 何时使用 | |------|------|----------| | /specify | 定义需求 | 项目开始，记录创作目标 | | /topic | 选题讨论 | 需要确定文章方向 | | /research | 信息搜索 | 需要调研资料 | | /collect | 素材收集 | 需要个人真实案例 | | /write | 撰写初稿 | 开始正式写作 | | /review | 三遍审校 | 初稿完成后降 AI 味 | | /images | 配图建议 | 需要文章配图 | | /check | 发布检查 | 发布前最后检查 | | /publish | 发布指南 | 准备发布到平台 |

工作区系统

| 工作区 | 特点 | 适用场景 | |--------|------|----------| | wechat | AI味<30%，段落<150字，敏感词检测 | 公众号文章 | | video | AI味<20%，高度口语化，分镜标注 | 视频脚本/短视频 | | general | 灵活配置，SEO优化 | 博客/知乎/Medium |

my-article/
├── .content/              # 配置与脚本
│   ├── memory/            # 写作记忆
│   ├── scripts/           # 支持脚本
│   └── templates/         # 命令模板
├── .claude/commands/      # Claude 命令
├── .cursor/commands/      # Cursor 命令
│   ... (支持 13 个平台)
├── workspaces/            # 工作区
│   ├── wechat/            # 公众号工作区
│   │   └── articles/      # 文章输出
│   ├── video/             # 视频工作区
│   └── general/           # 通用工作区
├── materials/             # 个人素材库
│   ├── raw/               # 原始数据(即刻/微博导出)
│   ├── indexed/           # 主题索引
│   └── archive/           # 历史文章
├── _briefs/               # 需求文档
└── _knowledge_base/       # 调研结果

🔌 插件系统

已实现插件

1. AI 味自检插件 (ai-detector/)

• 功能: 利用 AI 自身能力检测文章的 AI 生成痕迹
• 命令: /ai-check [文件路径]
• 检测维度: 词汇(30分)、结构(30分)、情感(20分)、口语化(20分)
• 集成: /audit style 自动调用

2. 素材导入插件 (materials-import/)

• 功能: 导入社交媒体数据(即刻/微博/Twitter)
• 命令: /import-materials <source> <file>
• 支持格式: CSV, JSON, Markdown
• 输出: 自动分类索引到 materials/indexed/

🤖 支持的 AI 助手

| AI 工具 | 说明 | 状态 | |---------|------|------| | Claude Code | Anthropic 的 AI 助手 | ✅ 推荐 | | Cursor | AI 代码编辑器 | ✅ 完整支持 | | Gemini CLI | Google 的 AI 助手 | ✅ 完整支持 | | Windsurf | Codeium 的 AI 编辑器 | ✅ 完整支持 | | Roo Code | AI 编程助手 | ✅ 完整支持 | | GitHub Copilot | GitHub 的 AI 编程助手 | ✅ 完整支持 | | Qwen Code | 阿里通义千问代码助手 | ✅ 完整支持 | | OpenCode | 开源 AI 编程工具 | ✅ 完整支持 | | Codex CLI | AI 编程助手 | ✅ 完整支持 | | Kilo Code | AI 编程工具 | ✅ 完整支持 | | Auggie CLI | AI 开发助手 | ✅ 完整支持 | | CodeBuddy | AI 编程伙伴 | ✅ 完整支持 | | Amazon Q Developer | AWS 的 AI 开发助手 | ✅ 完整支持 |

💡 使用 content init --all 可以同时为所有 AI 工具生成配置

🛠️ CLI 命令

content init [name]

content init my-article [选项]

常用选项：

• --here - 在当前目录初始化
• --workspace <type> - 选择工作区类型(wechat/video/general)
• --ai <type> - 选择 AI 平台(claude/gemini/cursor等)
• --all - 生成所有 AI 平台配置

示例用法

# 在当前目录初始化公众号项目
content init --here --workspace wechat

# 为 Claude Code 用户初始化
content init my-article --ai claude

# 同时支持所有平台
content init my-article --all

💡 使用场景

公众号文章 (wechat 工作区)

content init my-wechat-article --workspace wechat

• ✅ 段落自动控制在 150 字以内
• ✅ AI 味目标 < 30%
• ✅ 自动敏感词检测
• ✅ 配图建议(900×500px)
• ✅ 一键格式化为微信样式(v0.4.0)

视频脚本 (video 工作区)

content init my-video-script --workspace video

• ✅ 高度口语化(AI 味 < 20%)
• ✅ 时长计算(1分钟≈150-180字)
• ✅ Hook 设计(前 3 秒抓人)
• ✅ 分镜标注格式

通用内容 (general 工作区)

content init my-blog --workspace general

• ✅ 灵活配置
• ✅ SEO 优化选项
• ✅ 多平台适配

🎯 核心创新

1. 真实驱动工作流⭐

核心理念：AI是教练和参考书，不是代笔

关键洞察：

就像从100个塑料苹果里挑"最好的"，挑出来的还是塑料。

无论AI生成多少字，本质都是：冰冷、套话、假细节。

工作流：

真实经历（素材库）→ AI教练（提问/引导）→ 人自己写 → AI检查 → 真实文章
                                     ↑
                           AI只给思路，不写内容

核心机制：

• 📝 AI作为教练 - 提问引导，不生成可用内容
• 💎 强制真实经历 - 80%内容必须来自个人素材库
• 🔍 5维真实检查 - 温度、个性、地域性、真实细节、思想深度
• 🚫 防止AI越界 - 严格禁止AI生成可直接使用的段落

预期效果：

• AI检测率：50%+ → <25%（↓50%）
• 真实性：来自亲身经历，编辑无法识别
• 用户认同："这是我写的"（不是"AI帮我写的"）

详细设计文档 →

2. 个人素材库系统

不同于传统 AI 写作"完全生成"，通过搜索用户的真实经历(即刻动态、历史文章)并融入新文章：

• 真实性 - 案例、观点都是真实的
• 个性化 - 文风、态度符合本人
• 降 AI 味 - 真实细节替代 AI 编造

3. 选题讨论机制

AI 不直接生成文章，而是先提供 3-4 个选题方向：

• 每个方向含标题、角度、大纲、工作量评估
• 用户选择后再执行，避免方向错误
• 增强协作感和掌控感

4. 三遍审校机制

系统化降低 AI 检测率(目标<30%)：

• 第一遍(内容): 事实、逻辑、结构
• 第二遍(风格): 删套话、拆 AI 句式、加真实细节
• 第三遍(细节): 标点、排版、节奏

📖 与 Novel Writer 的关系

Article Writer 基于 Novel Writer 的成熟架构开发，保留其核心优势：

• ✅ 斜杠命令系统
• ✅ 跨平台支持(13 个 AI 工具)
• ✅ 插件系统
• ✅ 反 AI 检测规范

但将核心流程从"小说创作"改造为"文章写作"，特别针对公众号、视频脚本等短内容创作场景。

📈 版本历史

v0.10.0 (最新) 🎯 多模式写作系统

• ✅ 三种写作模式：教练模式（追求真实）、快速模式（快速产出）、混合模式（平衡）
• ✅ 智能推荐：根据文章类型自动推荐最合适的模式
• ✅ 完全保留教练模式：PRD-08 教练模式完整保留，无任何改动
• ✅ 灵活选择：用户可根据时间和质量要求自由选择模式
• 详见 PRD-09 | 实施总结

v0.9.3 - 图床系统 + PowerShell 支持

• ✅ 支持多云厂商图床（阿里云/腾讯云/七牛云/AWS S3）+ Base64 内嵌
• ✅ Codex CLI 自动安装支持
• ✅ PowerShell 格式化脚本

v0.9.0 - 真实驱动完整实现

• ✅ 完整的11步真实驱动写作流程
• ✅ 3个核心新命令：/extract、/authentic、/hint
• ✅ /write 改为教练模式（逻辑完全重写）
• 详见 PRD-08

更多历史版本 → 查看 完整更新日志

🌐 项目矩阵

WordFlowLab 围绕 AI 辅助写作展开多维度探索，采用不同方法论和技术栈的开源项目组合：

内容创作系列

| 项目 | 内容类型 | 核心流程 | 适用场景 | |------|---------|----------|----------| | Article-Writer 🆕 | 文章/脚本 | 九步写作流程，工作区管理 | 公众号/视频脚本/自媒体，降低 AI 味 | | Novel-Writer ⭐ | 小说创作 | 七步方法论，追踪系统 | 长篇小说创作，跨 13 个 AI 工具 | | Novel-Writer-OpenSpec | 小说创作 | OpenSpec 规格分离 | 需要规格化管理和团队协作 | | Novel-Writer-Skills | 小说创作 | Agent Skills 集成 | 专为 Claude Code 深度优化 |

工具实现系列

| 项目 | 类型 | 技术基础 | 说明 | |------|------|----------|------| | WriteFlow | CLI 工具 | 模仿 Claude Code 架构 | 独立 CLI，为技术型作家设计 | | NovelWeave | VSCode 扩展 | Fork: Cline → Roo Code → Kilo Code | 可视化编辑器，星尘织梦 |

技术演进路径

内容创作分支:
  Novel-Writer (小说主线) ──┬─→ Novel-Writer-Skills (Claude Code 专版)
                          ├─→ Novel-Writer-OpenSpec (OpenSpec 探索版)
                          └─→ Article-Writer (文章/脚本分支) 🆕

独立工具分支:
  WriteFlow (CLI 独立版)
  NovelWeave (VSCode 扩展版)

选择建议

根据您的创作需求选择合适的工具：

| 创作需求 | 推荐项目 | 理由 | |---------|---------|------| | 📱 公众号文章 | Article-Writer | 九步流程，段落控制，敏感词检测 | | 🎬 视频脚本 | Article-Writer | 口语化优化，时长计算，Hook 设计 | | 📖 长篇小说 | Novel-Writer | 七步方法论，多线索追踪 | | 🌟 新手入门 | NovelWeave | 可视化编辑器，VSCode 扩展 | | 💻 Claude Code 用户 | Novel-Writer-Skills | Agent Skills 深度集成 | | 📋 规格化管理 | Novel-Writer-OpenSpec | OpenSpec 方法论 | | 🚀 技术探索 | WriteFlow | CLI 工具开发 |

快速决策：

• 写公众号/自媒体 → Article-Writer（降低 AI 味，段落控制）
• 拍视频/写脚本 → Article-Writer（口语化，分镜标注）
• 写长篇小说 → Novel-Writer（情节追踪，角色管理）
• 用 Claude Code → Novel-Writer-Skills（深度集成）
• 完全新手 → NovelWeave（可视化最友好）

💡 多矩阵、多方法论组合开源：探索 AI 写作的不同可能性，欢迎根据需求选择合适的工具！

🤝 贡献

欢迎提交 Issue 和 Pull Request！

项目地址：https://github.com/wordflowlab/article-writer

📄 许可证

MIT License

🙏 致谢

本项目基于 Novel Writer 设计，并参考了 Spec Kit 的 Slash Commands 理念，特此感谢！

Article Writer - 让 AI 成为你的写作伙伴！ ✨📝

欢迎加入AI 写作群聊