lingfengQAQ/webnovel-writer
GitHub: lingfengQAQ/webnovel-writer
基于 Claude Code 的长篇网文辅助创作系统，通过 RAG 解决 AI 写作的遗忘与幻觉问题，支持两百万字量级连载。
Stars: 945 | Forks: 206
# Webnovel Writer
[](LICENSE)
[](https://www.python.org/)
[](https://claude.ai/claude-code)
## 项目简单介绍
`Webnovel Writer` 是基于 Claude Code 的长篇网文创作系统，目标是降低 AI 写作中的“遗忘”和“幻觉”，支持长周期连载创作。
详细文档已拆分到 `docs/`：
- 架构与模块：`docs/architecture.md`
- 命令详解：`docs/commands.md`
- RAG 与配置：`docs/rag-and-config.md`
- 题材模板：`docs/genres.md`
- 运维与恢复：`docs/operations.md`
- 文档导航：`docs/README.md`
## 快速开始
### 1) 安装插件（官方 Marketplace）
claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user
### 2) 安装 Python 依赖
python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt
说明：该入口会同时安装核心写作链路与 Dashboard 依赖。
### 3) 初始化小说项目
在 Claude Code 中执行：
/webnovel-init
说明：`/webnovel-init` 会在当前 Workspace 下按书名创建 `PROJECT_ROOT`（子目录），并在 `workspace/.claude/.webnovel-current-project` 写入当前项目指针。
### 4) 配置 RAG 环境（必做）
进入初始化后的书项目根目录，创建 `.env`：
cp .env.example .env
最小配置示例：
EMBED_BASE_URL=https://api-inference.modelscope.cn/v1
EMBED_MODEL=Qwen/Qwen3-Embedding-8B
EMBED_API_KEY=your_embed_api_key
RERANK_BASE_URL=https://api.jina.ai/v1
RERANK_MODEL=jina-reranker-v3
RERANK_API_KEY=your_rerank_api_key
### 5) 开始使用
/webnovel-plan 1
/webnovel-write 1
/webnovel-review 1-5
### 6) 启动可视化面板（可选）
/webnovel-dashboard
说明：
- Dashboard 为只读面板（项目状态、实体图谱、章节/大纲浏览、追读力查看）。
- 前端构建产物已随插件发布，使用者无需本地 `npm build`。
### 7) Agent 模型设置（可选）
本项目所有内置 Agent 默认配置为：
model: inherit
表示子 Agent 继承当前 Claude 会话所用模型。
如果要单独给某个 Agent 指定模型，编辑对应文件（`webnovel-writer/agents/*.md`）的 frontmatter，例如：
---
name: context-agent
description: ...
tools: Read, Grep, Bash
model: sonnet
---
常见可选值：`inherit` / `sonnet` / `opus` / `haiku`（以 Claude Code 当前支持为准）。
## 更新简介
| 版本 | 说明 |
|------|------|
| **v5.5.0 (当前)** | 新增只读可视化 Dashboard Skill（`/webnovel-dashboard`）与实时刷新能力；支持插件目录启动与预构建前端分发 |
| **v5.4.4** | 引入官方 Plugin Marketplace 安装机制；统一修复 Skills/Agents/References 的 CLI 调用（`CLAUDE_PLUGIN_ROOT` 单路径，透传命令统一 `--`） |
| **v5.4.3** | 增强智能 RAG 上下文辅助（`auto/graph_hybrid` 回退 BM25） |
| **v5.3** | 引入追读力系统（Hook / Cool-point / 微兑现 / 债务追踪） |
## 开源协议
本项目使用 `GPL v3` 协议，详见 `LICENSE`。
## 致谢
本项目使用 **Claude Code + Gemini CLI + Codex** 配合 Vibe Coding 方式开发。
灵感来源：[Linux.do 帖子](https://linux.do/t/topic/1397944/49)
## 贡献
欢迎提交 Issue 和 PR：
git checkout -b feature/your-feature
git commit -m "feat: add your feature"
git push origin feature/your-feature
标签：AI写作, Claude Code, DLL 劫持, Python, RAG, 内容生成, 写作辅助, 向量数据库, 大语言模型, 小说生成, 幻觉抑制, 无后门, 智能创作, 检索增强生成, 网文创作, 网文连载, 自动写作, 记忆管理, 逆向工具, 长文本处理