feat: initial commit

2026-06-23 20:29:02 +08:00
commit ea8f6066c4
217 changed files with 60754 additions and 0 deletions
@@ -0,0 +1,62 @@
+# 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/
+```
+
+## 初始化
+
+首次创建项目时，运行:
+
+```bash
+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 写入的目标
+```
+
+## 工作流
+
+1. **规划**: Planner agents 读取 `noma/openspec/` 和 `matrices/`
+2. **写作**: Writer agents 输出到 `.workspace/输出/`
+3. **审查**: Checker agents 检查 `.workspace/正文/`
+4. **确认**: 用户审核后移动到 `.workspace/正文/`