OpenNovel Workspace (.workspace)

这是用户的实际创作区。项目启动后，Noma 系统在此目录下管理所有创作数据。

目录结构

.workspace/
├── .claude/                  # Claude Code 项目配置
│   ├── settings.json         # 项目级设置
│   └── commands.md           # 项目命令
├── .noma/                    # Noma 系统数据目录
│   ├── state.json            # 项目状态
│   ├── index.db              # SQLite 数据库
│   ├── vectors.db            # 向量数据库
│   └── ledger.json           # 账本数据
├── 正文/                      # 小说正文
│   └── 第0001章-标题.md
├── 大纲/                      # 章节大纲
│   └── 第0001章-标题.md
├── 设定集/                     # 世界观设定
│   ├── 角色/
│   ├── 地点/
│   ├── 势力/
│   └── 物品/
└── 输出/                      # AI 生成内容
    └── draft/

初始化

首次创建项目时，运行:

noma init --title "小说标题" --genre "xuanhuan"

状态管理

state.json: 包含进度、主角状态、节奏追踪
index.db: 包含实体、别名、关系、章节索引
ledger.json: 包含资产、负债、Hook 池

与系统目录的关联

noma/                          # 系统定义（不修改）
├── openspec/                  # ← 关联 → .workspace/.noma/genesis_contract.json
├── core_engine/               # ← 关联 → .workspace/.noma/state.json
├── agents/                    # ← 工作时调用
└── matrices/                  # ← 写作时引用

.workspace/                    # 用户创作区（实际修改）
└── 正文/                      # ← AI 写入的目标

工作流

规划: Planner agents 读取 noma/openspec/ 和 matrices/
写作: Writer agents 输出到 .workspace/输出/
审查: Checker agents 检查 .workspace/正文/
确认: 用户审核后移动到 .workspace/正文/