English · 한국어 · 日本語 · 中文 · Español · Français · Deutsch · Português
**像构建软件一样构建书籍。** 一个多阶段流水线，将长篇知识——书籍、RFC、白皮书、设计文档、技术指南——转化为结构化的产物，而非孤立的提示词。从空白页到可发布的 EPUB/PDF。 `Phase 0: Onboarding → Phase 1: Ideation → Phase 2: Outlining → Phase 3: Drafting → Phase 4: Editing → Phase 5: Publishing`
## 为什么选择 Velith？
使用原始 LLM 提示写书会导致章节脱节、文体不一致、缺乏结构。Velith 提供**先计划后执行的流水线** — 写作前验证，每个阶段把控质量，在整个手稿中保持连贯性。
## 基准测试
流水线对非结构化输入的处理效果 — [亲自尝试 →](https://huggingface.co/spaces/epicsaga/Velith)
| 指标 | 原始输入 | Velith 流水线处理后 |
|------|---------|---------------------|
| 结构评分 | 2–4 / 10 | 6–9 / 10 |
| 冗余率 | 20–45% n-gram 重叠 | 合并后 < 10% |
| AI 糟糕内容标记 | 每千词 6–20 个 | 由 style-doctor 检测并删除 |
| 章节层级 | 无 | 检测后添加交叉引用并映射 |
| 连贯性评分 | 0.3–1.5 / 10 | 通过章节重构改善 |
| | 功能 | 重要原因 |
|--|------|----------|
| 📋 | 6阶段流水线 | 每个阶段验证后再推进 — 无需返工 |
| 📖 | 7种体裁模板 | 小说、非虚构、技术书、剧本、诗歌、游戏脚本、学术（+ genre-creator自定义） |
| 🤖 | 8个专业智能体 | 架构、起草、场景生成、连贯性、文体、封面、插图、营销 |
| ✏️ | 5阶段编辑 | 评估 → 内容编辑 → 行文编辑 → 校对 → 终校 |
| 🔄 | 随时恢复 | 跳过已完成章节，从中断处继续 |
| 📦 | EPUB、PDF、MOBI、TXT、Markdown | 通过 Pandoc + Calibre 生成可出版文件 |
## 一个流水线，多种产物
Velith 以图书流水线的形式发布，但同样的 6 个阶段适用于**任何长篇结构化知识**。产出物是 300 页的小说还是 12 页的 RFC 都不重要——先规划后执行的流程、质量关卡和 agent 完全一致。
| 产出物 | 体裁技能 | 典型输出 |
|----------|-------------|----------------|
| 小说 / 故事 | `book-fiction` | EPUB / PDF / MOBI |
| 非虚构图书 | `book-nonfiction` | EPUB / PDF |
| RFC / 设计文档 | `book-technical` | Markdown / PDF |
| 白皮书 / 研究报告 | `book-academic` | PDF（引用） |
| 课程材料 / 教程 | `book-technical` | EPUB / PDF |
| 游戏剧本 / 世界观设定 | `book-game` | Markdown / EPUB |
## 对比
| | Velith | 原始提示 | Notion AI | Jasper / Sudowrite | Scrivener |
|--|-----------|-------------|-----------|-------------------|-----------|
| 结构验证 | 阶段关卡流水线 | 无 | 无 | 基础模板 | 手动 |
| 跨章节连贯性 | 专属智能体 | 手动 | 无 | 有限 | 手动 |
| AI 糟糕内容检测 | 内置（style-doctor） | 无 | 无 | 无 | 无 |
| 体裁感知 | 8种体裁系统 + 自定义 | 取决于提示 | 无 | 以小说为主 | 无 |
| 输出格式 | EPUB、PDF、MOBI、TXT、Markdown | 复制粘贴 | Markdown / PDF | DOCX，有限 | DOCX、PDF |
| 质量关卡 | 每个阶段 | 无 | 无 | 无 | 无 |
| 所需条件 | Claude Code、Codex CLI、Agy、Cursor、Cline 或 Aider | 任意 LLM | Notion 订阅 | 订阅 | 许可证 |
| 完全控制 | 提示级别 | 完全 | 黑盒 | 黑盒 | 完全 |
## 安装
### Claude Code
```bash
# 添加 epicsagas 市场（首次）
claude plugin marketplace add epicsagas
# 安装 velith
claude plugin install velith@epicsagas
```
**前提条件:** 已安装并通过身份验证的 [Claude Code](https://claude.ai/code) CLI。
### Codex CLI (OpenAI)
```bash
codex plugin marketplace add epicsagas/plugins
```
**前提条件:** 已安装 [Codex CLI](https://github.com/openai/codex) 并配置 OpenAI API 密钥。
### Agy (Antigravity)
```bash
agy plugin install https://github.com/epicsagas/Velith
```
Agy 会自动从仓库根目录发现技能和代理。无需额外配置。
**前提条件:** 已安装并配置 [Agy](https://antigravity.google/docs/cli-install)。
### Cursor
Velith 在 `.cursor/rules/` 中提供上下文规则，使 Cursor 的代理能够完全了解出版流程、体裁模式和编辑标准。在 Cursor 中打开项目时，规则会自动加载。
**前提条件:** 已安装 [Cursor](https://cursor.sh)。
### Cline
Velith 在仓库根目录提供 `.clinerules` 项目级指令。在项目目录中工作时，Cline 会自动读取。
**前提条件:** VS Code 或 JetBrains 中已安装 [Cline](https://github.com/cline/cline) 扩展。
### Aider
Velith 在 `CONVENTIONS.md` 中提供写作规范，通过 `.aider.conf.yml` 自动加载。
```bash
aider # CONVENTIONS.md 自动加载
```
**前提条件:** 已安装 [Aider](https://aider.chat) 并配置 API 密钥。
## 快速开始
```bash
# 开始新的图书项目
> /book-init
# 自动检测当前阶段并继续
> /loom
```
插件将引导您完成以下流程:
1. **Onboarding** — 体裁、受众、语言、源材料、风格指南
2. **Ideation** — 市场调研、概念提炼、竞争书目
3. **Outlining** — 包含规格、依赖关系、交叉引用的完整章节大纲
4. **Drafting** — 通过并行子智能体逐章生成
5. **Editing** — 5阶段流水线：评估 → 内容编辑 → 行文编辑 → 校对 → 终校
6. **Publishing** — EPUB/PDF/MOBI 转换、元数据、营销计划
## 技能
| 技能 | 阶段 | 描述 |
|------|------|------|
| `/loom` | 路由 | 自动检测阶段并路由 |
| `/book-init` | 0 | 开始新图书项目 — 体裁、受众、风格指南 |
| `/book-ideation` | 1 | 概念生成和验证、竞争分析 |
| `/book-outline` | 2 | 创建章节大纲（含依赖关系） |
| `/book-draft` | 3 | 起草章节（全部/特定/恢复，并行智能体） |
| `/book-edit` | 4 | 5阶段编辑流水线 |
| `/book-publish` | 5 | EPUB/PDF/MOBI转换、封面、营销 |
| `/book-illustrate` | 3-5 | 内页插图 — 场景提取、风格一致的提示词、布局方案 |
| `/book-status` | — | 终端仪表盘 + `--ui` 浏览器仪表盘 |
| `/book-fiction` | — | 小说模式（15节拍、Snowflake、角色设定集） |
| `/book-nonfiction` | — | 非虚构模式（问题解决、证据层级） |
| `/book-technical` | — | 技术书模式（概念梯度、代码、实验） |
| `/book-screenplay` | — | 剧本模式（三幕结构、对话、A/B故事线） |
| `/book-poetry` | — | 诗歌模式（体裁、意象、诗节结构） |
| `/book-game` | — | 游戏脚本模式（任务树、分支、世界观设定集） |
| `/book-academic` | — | 学术模式（IMRAD、文献综述、论证链） |
| `/book-genre-creator` | — | 体裁选择指南及自定义体裁创建向导 |
## 智能体
| 智能体 | 角色 |
|--------|------|
| `book-architect` | 验证结构、为大纲评分、检查节奏 |
| `chapter-writer` | 使用体裁模板生成章节草稿 |
| `continuity-editor` | 跨章节一致性（术语、引用、时间线） |
| `style-doctor` | 文体/语调一致性、AI 糟糕内容检测 |
| `scene-generator` | 使用 GMC+RDD 结构进行场景级分析（仅小说） |
| `cover-designer` | 封面概念 + Midjourney/DALL-E 图像提示 |
| `illustrator` | 内页插图 — 场景提取、风格指南、提示词生成 |
| `marketing-expert` | 读者画像、渠道策略、12周上市日历 |
## 可视化仪表盘
`/book-status --ui` 在浏览器中打开基于 Svelte 的进度仪表盘。仪表盘每 5 秒自动刷新:
- 6阶段流水线追踪器（Onboarding → Ideation → Outlining → Drafting → Editing → Publishing）
- 8个智能体状态卡片（book-architect、chapter-writer、continuity-editor、cover-designer、illustrator、marketing-expert、scene-generator、style-doctor）
- 章节大纲、草稿表和5阶段编辑看板
- 输出文件状态（EPUB/PDF/MOBI/TXT/MD）及发布清单
- 项目设置和命令参考
仪表盘从每个项目的 `status.json` 文件动态读取。预构建的 `dist/` 已内置 — 插件用户无需构建步骤。
本地开发环境运行:
```bash
cd dashboard
npm install
npm run dev # http://localhost:5173
npm run build # 重新构建 dist/
```
## 设计原则
- **先计划后执行** — 先写大纲，验证后再写作
- **幂等性** — 跳过已完成章节，从中断处恢复
- **Token 高效** — 基于摘要的上下文，而非全文
- **体裁感知** — 每种体裁有不同的结构、模板和验证
- **质量关卡** — 每个阶段必须通过标准才能继续
## 外部依赖
用于 EPUB/PDF 输出（Phase 5）:
```bash
brew install pandoc # EPUB/PDF 转换
brew install texlive # 支持 CJK/中文的 PDF
brew install --cask calibre # MOBI（Kindle）转换 — 可选
```
### 故障排除