# webnovel-write
**Repository Path**: mindyleelyyAI/webnovel-write
## Basic Information
- **Project Name**: webnovel-write
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 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）
```bash
claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user
```
> 仅当前项目生效时，将 `--scope user` 改为 `--scope project`。
### 2) 安装 Python 依赖
```bash
python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt
```
说明：该入口会同时安装核心写作链路与 Dashboard 依赖。
### 3) 初始化小说项目
在 Claude Code 中执行：
```bash
/webnovel-init
```
说明：`/webnovel-init` 会在当前 Workspace 下按书名创建 `PROJECT_ROOT`（子目录），并在 `workspace/.claude/.webnovel-current-project` 写入当前项目指针。
### 4) 配置 RAG 环境（必做）
进入初始化后的书项目根目录，创建 `.env`：
```bash
cp .env.example .env
```
最小配置示例：
```bash
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) 开始使用
```bash
/webnovel-plan 1
/webnovel-write 1
/webnovel-review 1-5
```
如需排查本地 CLI / 插件目录 / 项目根解析问题，可直接运行统一预检：
```bash
python -X utf8 "/scripts/webnovel.py" --project-root "" preflight
```
### 6) 启动可视化面板（可选）
```bash
/webnovel-dashboard
```
说明：
- Dashboard 为只读面板（项目状态、实体图谱、章节/大纲浏览、追读力查看）。
- 前端构建产物已随插件发布，使用者无需本地 `npm build`。
### 7) Agent 模型设置（可选）
本项目所有内置 Agent 默认配置为：
```yaml
model: inherit
```
表示子 Agent 继承当前 Claude 会话所用模型。
如果要单独给某个 Agent 指定模型，编辑对应文件（`webnovel-writer/agents/*.md`）的 frontmatter，例如：
```yaml
---
name: context-agent
description: ...
tools: Read, Grep, Bash
model: sonnet
---
```
常见可选值：`inherit` / `sonnet` / `opus` / `haiku`（以 Claude Code 当前支持为准）。
## 更新简介
| 版本 | 说明 |
|------|------|
| **v5.5.4 (当前)** | 补齐写作链提示词强约束（流程硬约束、中文思维写作约束、Step 职责边界）；统一中文化审查/润色/Agent 报告文案；清理文档内部版本号与版本历史，降低与插件发版版本混淆。 |
| **v5.5.3** | 新增统一 `preflight` 预检命令；写作链 CLI 示例统一为 UTF-8 运行方式，收口文档中的长 shell 预检片段并降低 Windows 终端乱码风险。 |
| **v5.5.2** | 支持将详细大纲中的章节名同步到正文文件名；修复 workflow_manager 在无参 find_project_root monkeypatch 下的兼容性问题。 |
| **v5.5.1** | 修复卷级单文件大纲在上下文快照中的章节提取问题；补齐命令文档中遗漏的 `/webnovel-dashboard` 与 `/webnovel-learn`。 |
| **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 / 微兑现 / 债务追踪） |
## 插件发版
推荐使用 GitHub Actions 的 `Plugin Release` 工作流统一发版：
1. 先在本地同步版本信息：
```bash
python -X utf8 webnovel-writer/scripts/sync_plugin_version.py --version 5.5.4 --release-notes "本次版本说明"
```
2. 提交并推送版本变更（`README.md`、`plugin.json`、`marketplace.json`）。
3. 打开仓库的 Actions 页面，选择 `Plugin Release`。
4. 输入与当前仓库元数据一致的 `version`（例如 `5.5.4`）和用于 GitHub Release 的 `release_notes`。
5. 工作流会执行以下动作：
- 校验 `plugin.json`、`marketplace.json` 与 README 当前版本已经一致
- 校验当前版本与输入的 `version` 一致
- 创建并推送 `vX.Y.Z` Tag
- 创建同名 GitHub Release
日常开发中，`Plugin Version Check` 会在 Push / PR 时自动校验版本信息是否一致。
## 开源协议
本项目使用 `GPL v3` 协议，详见 `LICENSE`。
## Star 历史
[](https://star-history.com/#lingfengQAQ/webnovel-writer&Date)
## 致谢
本项目使用 **Claude Code + Gemini CLI + Codex** 配合 Vibe Coding 方式开发。
灵感来源：[Linux.do 帖子](https://linux.do/t/topic/1397944/49)
## 贡献
欢迎提交 Issue 和 PR：
```bash
git checkout -b feature/your-feature
git commit -m "feat: add your feature"
git push origin feature/your-feature
```