EthanYoQ/AI-Novel-Writer · 上手攻略

  • 仓库：EthanYoQ/AI-Novel-Writer
  • 链接：https://github.com/EthanYoQ/AI-Novel-Writer
  • 分类：AI 写作 · 创意工具
  • 作者：Jay
  • 更新：2026-10-11

§0 速览

是什么： 面向中文 AI 长篇小说创作的本地优先桌面工作台，把「灵感 → 角色/世界观 → 大纲/章节蓝图 → 草稿 → 审稿 → 修稿 → 定稿」串成完整可控的创作流程；支持 Windows/macOS（Intel + Apple Silicon），可接入本地 Ollama 或云端模型。

解决什么问题： 通用大模型聊天工具无法维持长篇小说的世界观和角色一致性，且缺少结构化的创作流程管理；AI-Novel-Writer 通过项目化的上下文管理和分阶段工作流解决这一问题。

当前版本： v1.2.1-Preview（2026-10-11 最新）；DSH 插件（0.1.0）目前冻结维护，⚠️ 插件能力不足桌面版 10%，不代表完整功能。

§1 是什么 / 解决什么问题

AI-Novel-Writer 不是内置模型服务，也不是在线小说平台。它提供的是创作编排层：管理项目状态、上下文组织、章节蓝图和草稿版本，把生成、审稿、修稿串接起来。模型由用户自行配置（本地或云端）。

创作流程（6 阶段）

创作前提 → 角色与世界观众 → 情节大纲与章节蓝图
  → 章节草稿 → 审稿报告 → 修稿与定稿 → 下一章项目上下文

每个阶段都有独立的上下文组织：生成章节时，软件围绕当前章节蓝图、相关角色资料、世界观、历史摘要等组织提示词上下文，而非把整本小说塞进一次对话。

项目核心资产

  • 角色卡：维护角色关系、状态；蓝图中确认的新角色自动登记到角色表
  • 世界观：规划资料可导入项目
  • 章节蓝图：每章具体计划（发生什么、埋什么钩子），可分批生成，支持中断恢复
  • 草稿/审稿/定稿：版本化管理，章节生成时带入上一章全文（续写）或本章全文（补写）
  • 剧情树：主线/支线进度可视化，支持跳转到对应章节依据

支持的模型协议

协议 适用端点
OpenAI-compatible OpenAI / DeepSeek / Ollama / NovelAI / 其他兼容 Chat Completions 的服务
Gemini 原生协议 Google Gemini 兼容端点

⚠️ Anthropic、Azure、KoboldAI 等不同接口需要单独适配器，不能仅靠替换 URL 兼容。

本地 Ollama 配置示例

Provider: Ollama（本地）或自定义
Protocol: OpenAI-compatible
Base URL: http://127.0.0.1:11434/v1
API Key: 可留空；或填任意本地占位值
Model: 你的 Ollama 模型名，例如 qwen3:14b

§2 快速安装

下载桌面版（推荐）

从 GitHub Releases 下载正式安装包：

Windows（NSIS 安装程序）： - ai-novel-writer-setup-<版本号>.exe - ⚠️ 安装程序未签名；Windows 可能提示发布者警告，请在确认下载来自官方 Release 页面后再继续

macOS： - Apple Silicon（M1/M2/M3/M4）：ai-novel-writer-mac-arm64-<版本号>-installer.dmg - Intel Mac：ai-novel-writer-mac-x64-<版本号>-installer.dmg - ⚠️ 两个安装包均为 ad-hoc 签名，未获 Developer ID 签名或 Apple 公证；Gatekeeper 阻止时按住 Control 点击应用选择「打开」，或在系统设置中允许

⚠️ 不要从非 GitHub Release 渠道下载安装包；软件不提供自动公证，来源不明安装包存在安全风险。

安装后配置 Ollama

  1. 安装 Ollama
  2. 下载模型：ollama pull qwen3:14b（或你偏好的中文模型）
  3. 启动 Ollama 服务（默认 localhost:11434）
  4. 打开 AI-Novel-Writer → 模型配置 → 选择 Ollama / OpenAI-compatible → 填入 http://127.0.0.1:11434/v1

DeepSeek Harness 插件（⚠️ 仅预览，功能受限）

插件 0.1.0 目前冻结维护，能力不足桌面版 10%，不适合替代桌面版使用。

如仍想体验（不推荐）：

# 安装插件
dsh plugin --profile web add @ethanyoq/dsh-ai-novel-writer
dsh --profile web
# 启动后打开「小说工作台」，安装「AI 小说作家 V2」Preset

⚠️ 插件不等于桌面版；不要用 dsh plugin add github:EthanYoQ/AI-Novel-Writer（仓库根是桌面应用，不是 DSH bundle）。

§3 核心用法

新建项目

  1. 启动应用 → 新建项目
  2. 配置项目基本信息（项目名称、简介）
  3. 配置模型（Ollama 或云端）
  4. 按流程依次创建：创作前提 → 角色/世界观 → 情节大纲 → 章节蓝图

章节创作

  • 生成蓝图：设置每章目标字数，批量生成章节蓝图，支持 1–10 章并发；中断后可从断点恢复
  • 续写：生成下一章时自动带入上一章全文；短章补写时带入本章全文
  • 审稿：生成结构化审稿报告，以报告作为修稿输入
  • 批量创作：可设置 1–10 章批量任务，支持暂停/取消；后处理失败会停止后续章节

⚠️ 生成失败但已有可见正文时，正文保存在当前项目的「恢复候选」中；候选不是正式草稿，源蓝图或草稿变化后不可继续。

写作 Skills

可按创作阶段（规划/正文/审稿/润色）分别绑定补充写作方法并定制中英文创作指导。语言、输出结构和工具协议仍受隐藏合同保护（⚠️ 指应用内部提示词隔离机制）。

数据存储

  • 项目、角色卡、蓝图、草稿、定稿：本地 SQLite 数据库，项目目录内
  • 导入的参考资料：本地项目范围，不外传
  • API Key / 模型配置：~/.vela/models.json，⚠️ 请保护本机账户，不要分享该文件
  • 应用偏好 / 更新设置：~/.vela/config.json

§4 典型适用场景

  • 中文网络小说作者：需要 AI 辅助规划大纲、生成章节、管理长篇世界观一致性的独立作者
  • 本地优先的隐私写作者：不想把小说内容发送给任何云服务；本地 Ollama 即可工作
  • 批量章节创作：需要一次生成多章草稿并统一审稿的流水线作业
  • 中英文双语创作：应用支持中英文界面，可绑定不同语言模型

⚠️ AI 输出需要作者审阅；软件不替代作者的创意判断、事实核查或版权责任。

§5 坑与注意

  1. DSH 插件 ≠ 桌面版：插件 0.1.0 冻结维护，能力极弱；不要误以为插件体验等同于完整软件。
  2. v0.9.1 曾因 Windows 发布资格检查失败被撤回：v0.9.1 版本号永久不再使用，如有安装请等待 v0.9.2。
  3. 未签名安装包：Windows / macOS 均无代码签名，会触发系统安全警告，属正常现象但需确认下载来源。
  4. 不承诺任意第三方 API 兼容：只保证已实现协议（OpenAI-compatible / Gemini）范围内的行为，其他接口需要单独适配器。
  5. Ollama 模型须与写作风格匹配：建议用支持长上下文（≥32K）的模型；短上下文模型处理章节续写时可能丢失前期信息。
  6. macOS ARM64 vs x64：Apple Silicon Mac 必须用 arm64 版本，Intel Mac 用 x64 版本，用错架构会安装失败。
  7. 生成失败恢复候选不是草稿：生成中断后的正文保存在恢复候选中，只有用户手动写入草稿才算正式内容。
  8. 文风控制不会自动改写：定稿不会自动应用项目文风配置，需要手动运行文风分析或导入仿写指南。

§6 与同类对比

AI-Novel-Writer Sudowrite Novelcrafter Inkfluence AI
许可 GPL-3.0 开源 订阅（$22/月） 订阅 订阅（$9.99/月）
本地优先 ✅ Ollama 支持 ❌ ❌ ❌
中文长篇优化 ✅ 原生中文 UI/工作流 一般 一般 英文为主
多章节批量创作 ✅ 1–10章并发 ✅ ✅ ✅
审稿/修稿 ✅ 结构化审稿报告 ✅ ✅ ✅
AI Agent 支持 MCP 插件（预览） ❌ ❌ ❌
最新版本 v1.2.1-Preview — — —
成熟度 中期开发（v1.x） 成熟商业 成熟商业 成熟商业

§7 一句话结论

AI-Novel-Writer 是本地优先的中文长篇 AI 小说创作工具，工作流完整、上下文管理清晰，适合独立作者批量生产；注意 DSH 插件能力极弱勿替代桌面版，且安装包未签名属正常现象。

数据来源：GitHub README (fetch 2026-10-11) · Releases v1.2.1-Preview (fetch 2026-10-11) · X (Twitter) 社媒讨论 · 插件安装指南