zkcoi
63da7e2d3c
- 移除 project_locator.py 中硬编码的默认目录名 (noma-project) - 更新文档明确说明项目可以在任意位置创建 - 修复 FIXES.md 中的硬编码路径示例 - 新增 CHANGELOG.md 记录变更历史
NovelMaster (Noma) 5.0 - OpenNovel Workspace
融合"欲望心理学引擎"与"硬状态基建"的人机协同小说 IDE
项目介绍
NovelMaster (Noma) 是基于 Claude Code 的长篇网文创作系统，目标是降低 AI 写作中的"遗忘"和"幻觉"，支持长周期连载创作。它是 OpenNovel Workspace (ONW) 架构的实现。
详细文档已拆分到 docs/。
快速开始
1) 安装插件
claude plugin marketplace add dadizk/novelmaster --scope user
claude plugin install novelmaster@novelmaster-marketplace --scope user
2) 安装依赖
Windows PowerShell:
python -m pip install -r requirements.txt
Linux/macOS Bash:
python -m pip install -r requirements.txt
3) 初始化项目
PowerShell:
/noma-init
Bash:
/noma-init
4) 配置 RAG 环境
创建 .env 文件：
EMBED_BASE_URL=https://api-inference.modelscope.cn/v1
EMBED_MODEL=Qwen/Qwen3-Embedding-8B
EMBED_API_KEY=your_key
5) 开始使用
PowerShell:
/noma-plan 1 # 规划大纲
/noma-write 1 # 写第 1 章
/noma-review 1 # 审查章节
Bash:
/noma-plan 1 # 规划大纲
/noma-write 1 # 写第 1 章
/noma-review 1 # 审查章节
💡 PowerShell 用户注意: 如果遇到路径问题，请使用正斜杠
/或双反斜杠\\分隔路径。
项目结构
noma/
├── .claude/ # Claude Code 配置
│ ├── settings.json
│ └── commands.md
├── .claude-plugin/ # 插件元数据
│ ├── plugin.json
│ └── marketplace.json
│
├── skills/ # 技能模块
│ ├── noma-init/ # 初始化
│ ├── noma-plan/ # 规划
│ ├── noma-write/ # 写作
│ ├── noma-review/ # 审查
│ ├── noma-resume/ # 恢复
│ ├── noma-query/ # 查询
│ ├── noma-learn/ # 学习
│ └── noma-dashboard/ # 可视化面板
│
├── openspec/ # 数据标准
│ ├── genesis_contract.json
│ └── project.md
│
├── core_engine/ # 核心引擎
│ ├── state_manager/ # 状态管理
│ ├── memory_rag/ # 记忆 RAG
│ └── configurators/ # IDE 适配器
│
├── agents/ # Agent 矩阵
│ ├── planners/ # 规划器
│ ├── writers/ # 写作器
│ ├── checkers/ # 审查器
│ └── catchup_agent.py
│
├── matrices/ # 心理学武器库
│ ├── catharsis_models/ # 爽感模型
│ ├── genres/ # 题材库
│ └── shared/ # 共享参考
│
├── interfaces/ # 人机界面
│ └── web_dashboard/
│
├── scripts/ # 数据模块
│ ├── data_modules/
│ └── noma.py
│
├── references/ # 共享引用
│
└── docs/ # 文档
核心特性
- 欲望沙盒 - 定义核心欲望和伦理边界
- 多维爽感路由 - 禁忌僭越、降维打击、认知闭环
- 元叙事开关 - 一键关闭物理连贯性校验
- 意图漂移仲裁 - 热补丁处理设定修改冲突
CLI 命令
/noma-init --title "标题" --genre "xuanhuan"
/noma-plan --chapters 100
/noma-write --chapter 1
/noma-review --chapter 1
/noma-query state
/noma-resume
/noma-dashboard
题材支持
| 题材 | 目录 |
|---|---|
| 玄幻/修仙 | xuanhuan/ |
| 都市 | realistic/ |
| 甜宠 | dog-blood-romance/ |
| 历史 | period-drama/ |
| 悬疑 | rules-mystery/ |
| 知乎文 | zhihu-short/ |
文档
- docs/architecture.md - 架构说明
- docs/commands.md - 命令详解
- docs/rag-and-config.md - RAG 配置
- docs/genres.md - 题材模板
- docs/openspec.md - OpenSpec 结构
- docs/core_engine.md - CoreEngine 结构
- docs/matrices.md - Matrices 结构
- docs/interfaces.md - Interfaces 结构
- docs/agents.md - Agents 结构
许可证
GPL-3.0