# book-editorial-suite

**Repository Path**: oxtop/book-editorial-suite

## Basic Information

- **Project Name**: book-editorial-suite
- **Description**: 跨 AI 的图书策划、事实核验、中文润色与出版质检流水线，内置 Skills，支持 Codex、Claude Code、Cursor、Gemini CLI、Copilot、Windsurf、Cline 与 Roo Code
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-01
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Book Editorial Suite

一个可移植、可恢复、跨 AI 的图书策划、审校、事实核验、中文润色和出版质检系统。

它不是一段需要用户反复复制的提示词，也不只属于 Codex。仓库内置完整工作流、专业 Skills、项目模板、质量门和确定性检查脚本。用户在支持文件读取与工具执行的 AI 环境中打开书稿目录，直接描述需求即可。

## 支持的 AI 环境

| 平台 | 自动入口 |
|---|---|
| Codex | `AGENTS.md`、`CODEX.md`、可选 Codex 插件 |
| Claude Code | `CLAUDE.md`、`.claude/skills/` |
| Cursor | `AGENTS.md`、`.cursor/rules/` |
| Gemini CLI | `GEMINI.md` |
| GitHub Copilot / Copilot CLI | `AGENTS.md`、`.github/copilot-instructions.md` |
| Windsurf | `AGENTS.md`、`.windsurf/rules/`、兼容 `.windsurfrules` |
| Cline | `AGENTS.md`、`.clinerules/` |
| Roo Code | `AGENTS.md`、`.roo/rules/` |
| 其他文件型 AI Agent | 读取 `AGENT_GUIDE.md` |

所有入口只负责把 Agent 路由到同一个 `AGENT_GUIDE.md`，不会形成八套互相漂移的工作流。

## 从 Gitee 获取

```bash
git clone https://gitee.com/oxtop/book-editorial-suite.git
cd book-editorial-suite
```

也可以从 Releases 下载完整分发包：

```text
https://gitee.com/oxtop/book-editorial-suite/releases
```

## 用法一：注入已有书稿目录（推荐）

```bash
python3 install.py --target "/你的/书稿目录"
```

安装器会在目标目录中加入：

- 各主流 AI 的自动入口；
- `.book-editorial/skills/`：完整内置 Skills；
- `.book-pipeline/pipeline.json`：声明式阶段与质量门；
- `book-project.md`：该书的读者、体例、术语、证据和出版配置；
- `EDITORIAL_GUIDE.md`：项目运行契约；
- 检查点、评审、编辑输出和决策记录目录。

已有文件默认不会覆盖。确实需要更新生成文件时才使用：

```bash
python3 install.py --target "/你的/书稿目录" --migrate
```

迁移前预览：

```bash
python3 install.py --target "/你的/书稿目录" --migrate --dry-run
```

`--migrate` 会备份并更新受管运行时、平台入口、编辑指南和流水线，同时保留 `book-project.md` 与决策记录。只有明确需要替换项目模板时才使用 `--force`。

然后用任一支持的平台打开该书稿目录，直接说：

```text
帮我分析这本书，给出优化方案。
```

```text
先核验第四章的高风险事实，再按原作者语气逐节优化。
```

```text
检查整本书是否达到出版交付标准。
```

用户不需要输入 Skill 名称。

## 用法二：直接在仓库中工作

把书稿和参考资料放入克隆后的仓库，使用任一支持的 AI Agent 打开仓库即可。根目录平台入口会自动加载共享工作流。

## 用法三：安装 Codex 插件

```bash
python3 install.py --codex-plugin
```

安装器会注册本地 Codex marketplace，并打开 `Book Editorial Suite` 插件页面。Codex 插件只是跨平台系统的一个适配器。

## 内置 Skills

| Skill | 作用 |
|---|---|
| `book-editorial-pipeline` | 全流程编排、工件生命周期、检查点与质量门 |
| `book-development` | 图书定位、目录、章节与出版材料 |
| `source-research` | 事实核验、引文审计、多源研究综合 |
| `academic-writing` | 学术、技术和教材型表达 |
| `critical-review` | 论证、方法、证据和出版质量审读 |
| `humanizer-zh` | 保留作者声音的中文自然化 |
| `publication-qa` | DOCX/PDF、图表公式、引用和渲染质检 |

工作流会根据自然语言请求自动路由这些 Skills。

## 工作流

全书阶段：

```text
intake → inventory → evidence → architecture
→ chapter_revision → reconciliation → production_qa → delivery
```

逐章阶段：

```text
原文基线与SHA-256 → 代表性小节样稿 → 用户确认声音与强度
→ 分节事实核验 → 结构与内容增强 → 表达与声音修订
→ 分节保留检查 → 整章候选稿 → 质量门 → 批准稿
```

样稿和工作稿不能提前标记为通过；整章指标不能掩盖小节内容损失；用户认为原稿更好时必须回退。

v2.1 起，这些规则由 `chapter_state.py` 强制执行。任何 P0 均返回 `BLOCKED`，不能因达到评审轮次上限而自动放行。

## 运行要求

- 基础运行：Python 3.10+，无需第三方 Python 包。
- 事实核验：所用 AI 环境需要联网搜索或等价研究工具。
- DOCX/PDF：所用 AI 环境需要相应文档读写和渲染能力。
- 缺少某项能力时，Agent 必须明确降级，不能伪造核验、修订痕迹或视觉 QA。

## 架构

```text
平台入口
  → AGENT_GUIDE.md
    → 项目配置 + pipeline.json
      → 主流水线 Skill
        → 内置专业 Skills
          → 平台可用工具 + 确定性脚本
            → 评审工件 + 检查点 + 人工确认
```

架构说明见 [PROJECT_CONTEXT.md](PROJECT_CONTEXT.md)，Skill 索引见 [skills/INDEX.md](skills/INDEX.md)。

## 版本与来源

- 当前版本：`2.1.0`
- 更新记录：[CHANGELOG.md](CHANGELOG.md)
- 安装包校验：[RELEASE_CHECKSUMS.txt](RELEASE_CHECKSUMS.txt)
- 方法与第三方来源：[THIRD_PARTY_NOTICES.md](plugins/book-editorial-suite/THIRD_PARTY_NOTICES.md)

仓库不包含示例书稿、用户项目数据、API Key 或访问令牌。