EthanYoQ/AI-Novel-Writer

面向AI长篇小说创作的桌面工作台。它把“前提 → 角色 → 世界观 → 章节蓝图 → 草稿 → 审稿 → 修稿 → 定稿”组织为一条可追溯的创作流程；模型由你自行配置，项目资料留在你的电脑上。

下载桌面版（Windows / macOS） · 安装 DeepSeek Harness Web 插件

DeepSeek Harness 插件提示： 0.1.0 预览版目前冻结维护，短期不扩展功能；它的能力不足桌面软件版的 10%，不能替代桌面版。需要完整项目树、批量工作流、成熟编辑器或自动审校时，请使用上方的桌面版。

1.2.0-Preview

• 大纲和蓝图支持分批生成与中断恢复，可设置每章目标字数。
• 续写下一章时带入上一章全文，短章补写时带入本章全文。
• 人物管理支持更多角色和关系。发现新人物时，可新建、关联已有角色或暂不处理。
• 旧项目导入和备份恢复会创建新版副本，保留原项目。可备份完整项目归档。

• 写作 Skill 可独立安装，并按规划、正文、审稿或润色阶段分别使用。
• 故事线视图展示主线和支线进度，并可跳到对应章节依据。
• 规划资料可导入项目，让蓝图和后续写作使用同一套设定。
• 角色表接收蓝图中明确确认的新角色，并持续记录角色状态。
• 中文长篇工作流串联蓝图、草稿、审稿、修订和定稿。
• Windows 和 macOS 均可查看并启动适合本机的更新。

1.0.0 的多草稿保存、旧请求覆盖、来源恢复、导出与安装检查修复继续保留。本次更新见 1.2.0-Preview 更新内容。正式安装包以 GitHub Release 为准。

除了 Windows 与 macOS 桌面版，本仓库还保留 @ethanyoq/dsh-ai-novel-writer 0.1.0 开发预览。该插件目前冻结维护，短期不扩展功能。DeepSeek Harness 的 V2 工作台是刻意收敛的早期 MVP，当前能力不足桌面软件版的 10%；它不读取桌面版 .vela 项目，也不能替代桌面版的项目树、批量工作流、成熟编辑器或自动审校。

V2 只提供人工审核的最小创作链：项目设置 → 故事架构 → 人物设定 → 全书纲要 → 逐章蓝图 → 逐章正文。模型生成的待审核建议到达 Proposal 收件箱后，会先填入右侧工作台的本地编辑表单，供人工查看和修改；只有用户明确审核并应用 Proposal，权威项目状态才会改变。

该插件不属于桌面版正式 Release，但已发布为独立 npm 包，拥有独立锁文件、CI 和 MIT 许可；仓库根目录仍为 GPL-3.0 桌面应用。将它安装到 DeepSeek Harness 的 web profile：

dsh plugin --profile web add @ethanyoq/dsh-ai-novel-writer
dsh --profile web

源码开发、固定 tarball 安装和 Windows 含空格路径限制由插件安装指南单独维护，根 README 不复制这些易变化的维护者步骤。

启动 Web 后，打开“小说工作台”，安装 “AI 小说作家 V2” Preset；随后新建会话并选择该 Preset。V2 的 AI 起草结果会先回填到右侧工作台的本地编辑表单，供人工修改和审核；点击应用 Proposal 才会写入项目。完整功能、项目格式、验证范围和卸载方式见插件说明。不要使用 dsh plugin add github:EthanYoQ/AI-Novel-Writer：仓库根包是桌面应用，不是可激活的 DSH bundle。

AI 小说作家不是内置模型服务，也不是在线小说平台。它提供的是创作编排层：保存项目状态、组织提示词与上下文、管理章节蓝图和草稿版本，并把生成、审稿和修稿串起来。

你可以接入本地或云端模型；软件不会替你提供或托管模型额度。长篇创作时，系统会围绕当前章节蓝图、相关角色资料、世界观、历史摘要和可选参考文风组织上下文，而不是把整本小说塞进一次聊天记录。

flowchart LR
  A[创作前提] --> B[角色与世界观]
  B --> C[情节大纲与章节蓝图]
  C --> D[章节草稿]
  D --> E[审稿报告]
  E --> F[修稿与定稿]
  F --> G[下一章的项目上下文]

生成情节大纲时，可在「AI 生成架构」中明确填写本次章节范围；超过 20 章的项目默认从第 1–20 章开始。完成一批后可从下一章继续；若生成中断且保留了有效断点，可从原断点恢复。如果已修改原大纲或参与生成的源设定与指导，旧断点不会直接接到新内容上，需要重新生成相应范围。

目前支持两类调用协议：

• OpenAI-compatible：适用于 OpenAI、DeepSeek、Ollama、NovelAI 预设及其他兼容 Chat Completions 的服务。
• Gemini 原生协议：适用于 Google Gemini 兼容端点。

“自定义 API”指的是在上述协议范围内自定义地址、模型标识和凭据；它不是任意 HTTP 协议或可执行脚本编辑器。Anthropic、Azure、KoboldAI 原生协议等不同接口需要单独的适配器，不能仅靠替换 URL 保证兼容。

推荐通过 Ollama 的 OpenAI-compatible 服务接入：

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

软件本身不提供模型账号、云端生成服务或运营消息推送。联网更新检查只读取公开 GitHub Release；用户可手动检查，也可在发现更新后暂缓提醒。

正式版使用 Windows NSIS 安装程序：

ai-novel-writer-setup-<版本号>.exe

1. 只从 GitHub Releases 下载正式安装包。
2. 安装程序更新应用本身，不应删除小说项目、角色卡或已有设置；仍建议在升级前自行备份重要作品。
3. 安装后可在欢迎页使用“检查更新”；应用启动后也会按每日一次的成功检查频率静默检查。发现正式更新时先提示，只有用户点击“下载更新”后才开始下载；下载完成后再提供“立即重启更新 / 稍后”的选择。
4. 旧版便携 ZIP 不能自行获得首个更新器版本，需要手动安装一次正式安装包；后续不再维护新的便携 ZIP。

当前安装程序尚未进行代码签名。Windows 可能显示发布者或信誉提示；请确认下载页面属于本项目的官方 GitHub Release 后再继续。

从 GitHub Releases 下载与你的 Mac 架构对应的安装包：

ai-novel-writer-mac-arm64-<版本号>-installer.dmg
ai-novel-writer-mac-x64-<版本号>-installer.dmg

1. arm64 适用于 Apple Silicon Mac（M1、M2、M3、M4 等）；x64 适用于 Intel Mac。
2. 将 DMG 中的应用拖入“应用程序”文件夹后启动。应用可以检查 GitHub 最新正式版并显示提醒，但不会在 macOS 内下载或替换程序；更新操作只打开官方 Release 页面，由用户手动下载对应架构的后续版本。
3. 两个安装包均为 ad-hoc 签名，且均未使用 Developer ID 签名或公证。若 Gatekeeper 阻止打开，请确认来源是本项目的官方 GitHub Release，然后在 Finder 中按住 Control 点击应用并选择“打开”，或在“系统设置 → 隐私与安全性”中允许打开。

• 不承诺任意第三方 API 都能仅靠 URL 和 Key 接入；只保证已实现协议与预设范围内的行为。
• 不替代作者的创意、事实核查或版权判断；AI 输出需要作者审阅。
• 不提供在线发布、阅读社区或云端模型账号。
• 正式安装包由 GitHub Actions 云端构建；Windows、macOS ARM64 与 macOS x64 会各自通过资格检查后，才会进入同一个 GitHub Release。

文档权威层级、ADR、调研、Agent 规则和任务交接入口见 docs/README.md。DeepSeek Harness 插件拥有独立的插件说明，不作为桌面版行为的来源。

GPL-3.0