使用 DeepSeek Harness 写作工作台（v8）？
本分支保留 Claude Code 版（v6），安装方式与 v8 不同。
一个跑在 Claude Code 上的长篇网文创作插件。从初始化设定、规划卷纲，到写章、审查、沉淀记忆、查询状态，再到一个只读的可视化面板——整条创作流程都给你串好了。
它想解决的其实就一件事：让 AI 写到几百章，依然记得住设定、接得住伏笔、守得住大纲。
一句话定位：这是一套面向长篇连载的一致性系统，不是写完就忘的一次性生成器。
版本导览（2026-10-06 更新）
原 v7 设计公示（Discussions #118）所征集的反馈仍是 v8 设计的重要输入；v7 的 CLI 形态经评估后不再发布，下一代改以 dsh 插件形态开发，v8 公开产品源码、运行技能和使用教程；内部开发讨论与私人创作资料不属于公开内容。v6/v8 安装方式不同，尚无经过验证的旧书仓直接迁移方案。
为什么需要它
长篇创作最难的不是写出第一章，而是写到第 80 章、第 200 章以后仍然保持：
角色动机不漂移
战力、时间线、地点和世界规则不互相打架
伏笔有登记、有推进、有回收
爽点、感情线、世界观扩展保持节奏
每章写完后事实会沉淀到可检索的状态系统
这套系统做的事，就是把上面这些“必须记住、不能写崩”的约束，变成 Claude Code 会自动执行的步骤：动笔前先查资料，写完后把新发生的事实记下来、做一致性审查，再把最新状态同步进检索索引、章节摘要、长期记忆和 Dashboard。它不只是“会写”，而是边写边攒。
核心能力
系统长什么样
v6.0.0 的默认主链叫 Story System，几个关键角色：
.story-system/：唯一的事实源头，动笔前的“合同”和写完后的“提交”都存在这里accepted 的
CHAPTER_COMMIT：一章写完，新事实从这里入账.webnovel/state.json、index.db、summaries/、memory_scratchpad.json：都是从主链派生出来的只读视图，供查询和展示用.webnovel/projection_log.jsonl：投影执行日志，用来定位 state/index/summary/memory/vector 哪一路没同步project-status、doctor、preflight和 Dashboard 会把主链与运行状态直接摆出来，哪里不对一眼就能看到
快速开始
1. 安装插件
通过 Claude Code Marketplace 安装：
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 依赖
python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt3. 初始化一本书
在 Claude Code 中输入：
/webnovel-init初始化完成后会创建书项目目录，包含：
project-root/
├── .story-system/ # 合同、章节提交和事件审计
├── .webnovel/ # 状态、索引、摘要、备份和长期记忆
├── 正文/ # 章节正文
├── 大纲/ # 总纲、卷纲、时间线和章纲
├── 设定集/ # 世界观、角色、力量体系等设定
└── 审查报告/ # 章节审查报告
4. 配置 RAG
进入书项目根目录，把 .env.example 复制为 .env 并填写 API Key：
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没填 Embedding Key 也能用——系统会自动退回 BM25 关键词检索，只是语义召回会弱一些。Embedding 和 Rerank 都可以换成任何兼容 OpenAI 格式的接口。
5. 开始规划和写作
/webnovel-plan 1 # 规划第 1 卷
/webnovel-write 1 # 写第 1 章
/webnovel-review 1-5 # 审查第 1-5 章
/webnovel-query 伏笔 # 查询项目状态6. 打开可视化面板
/webnovel-dashboardDashboard 是个只读面板，能看项目状态、实体关系图、章节内容、伏笔和追读力数据。前端是预先打包好的，跟着插件一起发，本地不用跑 npm build。
写章工作流
/webnovel-write 不是把活儿丢给模型生成一次就完事，而是一条带关卡的完整流水线：
预检项目根、占位符和 Story System 健康状态
刷新本章 runtime contract
调用
context-agent生成写作任务书根据任务书起草正文
调用
reviewer做多维审查，blocking issue 不通过则阻断润色、排版、Anti-AI 终检
调用
data-agent提取事实生成
CHAPTER_COMMIT，驱动 state、index、summary、memory、vector 投影执行章节级备份
这么设计，是为了把“怎么写”和“写了什么”分开：文笔和节奏可以放开发挥，但发生过的事实必须登记、过审、存档，不能含糊。
最终报告怎么看
/webnovel-init、/webnovel-plan、/webnovel-write 和 /webnovel-review 结束时都会给一份面向作者的最终报告，不直接把内部 JSON、traceback 或长命令日志甩出来。报告先给一句总状态：
已完成：目标产物和关键校验都通过，可以进入下一步。
部分完成：主要产物已保留，但有跳过项、自动处理项或待确认的小尾巴。
需要你处理：系统已经停在安全位置，需要你决定创作方向、事实取舍、是否覆盖文件或如何处理 blocking 问题。
未完成：关键产物没有可信生成，按报告里的恢复建议重跑或排查。
下面固定三段：一是产生的文件与完成情况，二是过程中遇到的问题与异常耗时，三是下一步建议。系统自动处理过的事也会写出来，比如投影失败后已补跑成功；只有不可恢复故障才会提示查看 .webnovel/logs/run_last.log。
执行过程中只会看到少量进度提示，告诉你当前在做什么、会产生什么；只有创作方向、事实一致性、文件覆盖风险或 blocking issue 需要裁决时才会问你。重复执行同一条 /webnovel-write 章号 时，系统会先检查可信断点，尽量从失败点继续，不重写已经可信完成的正文、审查、提交或备份。
内置题材
内置 37 个中文网文题材模板，也支持把几个题材揉在一起写。下面只列一部分：
完整列表见 题材模板文档。
命令速查
Claude Code Skill 命令
CLI 入口
所有命令行工具统一从 scripts/webnovel.py 进入：
python -X utf8 "<CLAUDE_PLUGIN_ROOT>/scripts/webnovel.py" --project-root "<PROJECT_ROOT>" <子命令> [参数]常用子命令：
更多命令见 命令详解。
文档导航
开发与测试
克隆仓库后安装依赖：
python -m pip install -r requirements.txt
python -m pip install -r webnovel-writer/scripts/requirements.txt运行测试：
python -m pytestDashboard 前端位于 webnovel-writer/dashboard/frontend/，发布版已经包含 dist/ 构建产物。开发前端时可单独进入该目录执行：
npm install
npm run dev排查问题
优先执行预检：
python -X utf8 "<CLAUDE_PLUGIN_ROOT>/scripts/webnovel.py" --project-root "<PROJECT_ROOT>" preflight
python -X utf8 "<CLAUDE_PLUGIN_ROOT>/scripts/webnovel.py" --project-root "<PROJECT_ROOT>" doctor --format text重点查看：
story_runtime.mainline_ready是否为 true.story-system/commits/chapter_XXX.commit.json是否存在且 acceptedprojection_status是否全部为done或skippedindex.db、summaries/、memory_scratchpad.json是否正常生成RAG API Key 是否已写入书项目根目录的
.env
更多运维说明见 项目结构与运维。
贡献
欢迎提 Issue 和 PR。最好用仓库里自带的模板，把复现步骤、环境信息、影响范围和验证方式填一下，也记得先给隐私信息脱敏。
建议流程：
git checkout -b feature/your-feature
git commit -m "feat: add your feature"
git push origin feature/your-feature适合贡献的方向：
新题材模板和题材规则
更强的章节审查维度
Dashboard 信息架构和可视化
RAG 检索、实体消歧、长期记忆
Windows/macOS/Linux 兼容性问题
文档、示例项目和新手教程
更新简介
开源协议
本项目使用 GPL v3 协议。
Star 历史
致谢
本项目使用 Claude Code、Gemini CLI 与 Codex 配合 Vibe Coding 方式开发。
灵感来源：Linux.do 帖子
感谢 oh-story-claudecode 提供拆文流程参考。
项目地址：https://github.com/lingfengQAQ/webnovel-writer
7.4k stars
Watchers
34 watching