|
|
@@ -0,0 +1,100 @@
|
|
|
+# Webnovel Writer
|
|
|
+
|
|
|
+[](LICENSE)
|
|
|
+[](https://www.python.org/)
|
|
|
+
|
|
|
+基于 Claude Code 的长篇网文辅助创作工具，解决 AI 写作中的"遗忘"和"幻觉"问题，支持 200 万字量级连载。
|
|
|
+
|
|
|
+## 核心特性
|
|
|
+
|
|
|
+| 特性 | 说明 |
|
|
|
+|------|------|
|
|
|
+| **防幻觉三定律** | 大纲即法律 / 设定即物理 / 发明需识别 |
|
|
|
+| **双 Agent 架构** | Context Agent (读) + Data Agent (写) |
|
|
|
+| **纯正文写作** | 无需 XML 标签，AI 自动提取实体 |
|
|
|
+| **5 维并行审查** | 爽点、一致性、节奏、人设、连贯性 |
|
|
|
+| **Strand Weave 节奏** | Quest/Fire/Constellation 三线平衡 |
|
|
|
+| **Git 原子备份** | 每章自动提交，支持按章回滚 |
|
|
|
+
|
|
|
+## 快速开始
|
|
|
+
|
|
|
+```bash
|
|
|
+# 1. 安装到项目
|
|
|
+cd your-novel-project
|
|
|
+git clone https://github.com/xxx/webnovel-writer.git .claude
|
|
|
+
|
|
|
+# 2. 初始化项目
|
|
|
+/webnovel-init
|
|
|
+
|
|
|
+# 3. 规划大纲
|
|
|
+/webnovel-plan 1
|
|
|
+
|
|
|
+# 4. 开始创作
|
|
|
+/webnovel-write 1
|
|
|
+```
|
|
|
+
|
|
|
+## 命令速查
|
|
|
+
|
|
|
+| 命令 | 说明 |
|
|
|
+|------|------|
|
|
|
+| `/webnovel-init` | 初始化项目结构 |
|
|
|
+| `/webnovel-plan [卷号]` | 生成详细大纲 |
|
|
|
+| `/webnovel-write [章号]` | 创作章节 (3000-5000字) |
|
|
|
+| `/webnovel-review [范围]` | 质量审查 |
|
|
|
+| `/webnovel-query [关键词]` | 检索设定 |
|
|
|
+| `/webnovel-resume` | 恢复中断任务 |
|
|
|
+
|
|
|
+## 项目结构
|
|
|
+
|
|
|
+```
|
|
|
+your-novel-project/
|
|
|
+├── .claude/ # 插件目录
|
|
|
+│ ├── agents/ # 8 个专职 Agent
|
|
|
+│ ├── skills/ # 6 个 Skill
|
|
|
+│ │ ├── webnovel-init/
|
|
|
+│ │ ├── webnovel-plan/
|
|
|
+│ │ ├── webnovel-write/
|
|
|
+│ │ ├── webnovel-review/
|
|
|
+│ │ ├── webnovel-query/
|
|
|
+│ │ └── webnovel-resume/
|
|
|
+│ ├── scripts/ # Python 脚本
|
|
|
+│ ├── references/ # 写作指南
|
|
|
+│ ├── genres/ # 题材参考
|
|
|
+│ └── templates/ # 题材模板
|
|
|
+├── .webnovel/ # 运行时数据
|
|
|
+│ ├── state.json # 权威状态
|
|
|
+│ ├── index.db # 索引数据库
|
|
|
+│ └── vectors.db # RAG 向量库
|
|
|
+├── 正文/ # 章节文件
|
|
|
+├── 大纲/ # 卷纲/章纲
|
|
|
+└── 设定集/ # 世界观/角色/力量体系
|
|
|
+```
|
|
|
+
|
|
|
+## RAG 系统
|
|
|
+
|
|
|
+混合检索系统，支持语义搜索历史场景：
|
|
|
+
|
|
|
+| 组件 | 提供商 | 模型 |
|
|
|
+|-----|-------|------|
|
|
|
+| Embedding | ModelScope | Qwen/Qwen3-Embedding-8B |
|
|
|
+| Rerank | Jina AI | jina-reranker-v3 |
|
|
|
+
|
|
|
+**配置环境变量**：
|
|
|
+```bash
|
|
|
+export EMBED_API_KEY="your-modelscope-token"
|
|
|
+export RERANK_API_KEY="your-jina-api-key"
|
|
|
+```
|
|
|
+
|
|
|
+**使用方式**：
|
|
|
+- Context Agent 自动调用 RAG 检索相关历史场景
|
|
|
+- Data Agent 自动将章节场景向量化存入数据库
|
|
|
+
|
|
|
+## License
|
|
|
+
|
|
|
+GPL v3 - 详见 [LICENSE](LICENSE)
|
|
|
+
|
|
|
+## 致谢
|
|
|
+
|
|
|
+本项目使用 **Claude Code + Gemini CLI + Codex** 配合 Vibe Coding 方式开发。
|
|
|
+
|
|
|
+灵感来源：[Linux.do 帖子](https://linux.do/t/topic/1397944/49)
|
lingfengQAQ