架构 / Architecture

目录结构 / Directory Structure

novels/
└── {booktitleslug}{book_uid}/
└── runs/
└── {run_id}/
├── 0-config/ # 配置层
├── 1-outline/ # 大纲层
├── 2-planning/ # 规划层
├── 3-world/ # 世界观层
├── 4-state/ # 运行时状态 (7面板)
├── drafts/ # 草稿层
├── chapters/ # 最终章节
├── anchors/ # 锚点
├── logs/ # 日志
├── archive/ # 归档
└── final/ # 最终输出

阶段参考 / Phase Reference

阶段6: 写作循环 (核心) / Phase 6: Writing Loop (Core)

确认流程 / Confirmation Flow

[生成大纲] → 用户确认 → [生成正文] → QC评分 → 用户确认 → [下一章]

QC 评分标准

配置 / Configuration

0-book-config.json

json
{
version: 2.1.0,
book: {
title: 书名,
titleslug: bookslug,
bookuid: 8charhash,
genre: 都市灵异,
targetwordcount: 100000,
chaptertargetwords: 2500
},
generation: {
model: moonshot/kimi-k2.5,
mode: manual,
max_attempts: 3,
auto_threshold: 85,
autorescueenabled: true
}
}

OpenClaw 集成 / OpenClaw Integration

模型说明

重要: 这个 skill 不硬编码任何模型。当 OpenClaw 调用此 skill 时，自动使用 OpenClaw 当前配置的模型。

函数入口

python
from scripts.v2.openclawentry import runskill, getrequiredconfirmations

获取某阶段需要确认的内容

Returns: [每章正文生成后确认, 每章评分确认]

运行 skill - 模型由 OpenClaw 自动提供

oc_context 参数

OpenClaw 会自动传入 oc_context 参数，包含：

• - modelcall - 调用当前模型的方法
• modelname - 当前模型名称（可选）
• generate - 备选方法（可选）

开发 / Development

模块结构 / Module Structure

scripts/v2/
├── init.py
├── utils.py # ID生成、slug、路径
├── atomic_io.py # 原子写入、快照
├── workspace.py # 目录管理
├── config_manager.py # 配置I/O
├── state_manager.py # 7面板
├── prompt_registry.py # 模板注册表
├── prompt_assembly.py # 提示词构建
├── price_table.py # 费率表管理
├── resume_manager.py # 断点续传、锁管理
├── phase_runner.py # 阶段1-5
├── writing_loop.py # 阶段6
├── safety_mechanisms.py # 阶段7-9
├── cli.py # CLI入口
└── openclaw_entry.py # OpenClaw入口 (v2.1新增)

版本历史 / Version History

v2.1.0 (2026-02-16)

• - ✅ 每个阶段人工确认机制
• ✅ OpenClaw 函数入口
• ✅ 接入真实模型 API
• ✅ 修复 Windows 兼容性
• ✅ 完善中文文档

v2.0.0 (2026-02-11)

• - 初始版本
• 9阶段流水线
• 7状态面板
• 多视角QC

许可证 / License

MIT License