EthanYoQ/AI-Novel-Writer#dsh-ai-novel-writer

AI 小说作家 / AI Novel Writer

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

下载最新 Windows 与 macOS ARM64 安装包

v0.8.4 生成可靠性与创作策略

v0.8.4 修复了写作流程中的三项关键可靠性边界：

• #92 流式草稿预览：章节写作在生成尚未结束时即可显示已接受的正文预览；跨分片思考标记、取消、失败、裁剪拒绝和终态后的迟到事件不会污染草稿。
• #99 OpenAI-compatible 端点：保留用户填写的端点路径前缀，普通与流式请求使用同一解析规则，不再对带路径地址硬插 /v1。
• #101 创作策略与推理覆盖：创作策略属于小说项目，模型覆盖属于模型配置；界面显示请求偏好到实际生效值的映射。未知自定义端点不会猜测或发送供应商私有推理字段，原始推理不会成为章节正文或长期小说记忆。

同一个 Release 使用五项资产合同：ai-novel-writer-setup-0.8.4.exe、ai-novel-writer-setup-0.8.4.exe.blockmap、latest.yml、ai-novel-writer-mac-arm64-0.8.4-installer.dmg 与 ai-novel-writer-mac-arm64-0.8.4-installer.dmg.sha256。

新增额外支持DeepSeek Harness 插件版（开发预览）

除了 Windows 与 macOS 桌面版，本仓库还在 插件目录 维护 @ethanyoq/dsh-ai-novel-writer 0.1.0 开发预览。它把项目设置、人物设定、故事蓝图、章节蓝图和章节正文带入 DeepSeek Harness Web，并通过对话中的单文件审批卡片逐项保存；插件使用独立的 Harness 小说项目格式，不读取桌面版 .vela 项目。

该插件尚未进入桌面版正式 Release，也未发布到 npm。它是独立 pnpm workspace，拥有独立锁文件、CI 和 MIT 许可；仓库根目录仍为 GPL-3.0 桌面应用。从源码安装时进入插件目录执行：

git clone https://github.com/EthanYoQ/AI-Novel-Writer.git
cd AI-Novel-Writer/plugins/dsh-ai-novel-writer
pnpm install
pnpm run build
dsh plugin --profile web add .
dsh --profile web

如需安装一份不随源码目录继续变化的构建产物，可先打包再安装：

pnpm pack --pack-destination ../../.runtime/.cache
cd ../..
dsh plugin --profile web add ./.runtime/.cache/ethanyoq-dsh-ai-novel-writer-0.1.0.tgz
dsh --profile web

启动 Web 后，打开“小说工作台”，安装“AI 小说作家”Preset；随后新建会话并选择该 Preset。模型生成的修改会在对话中显示 Harness 原生审批，点击一次“允许一次”后才会写入磁盘并回填工作台。完整功能、项目格式、验证范围和卸载方式见插件说明。不要使用 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[下一章的项目上下文]

界面预览

核心能力

模型配置

目前支持两类调用协议：

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

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

Ollama

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

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

向量模型也应使用 /v1。不要把 Base URL 写成 http://127.0.0.1:11434/api：/api 是 Ollama 的原生接口路径，不是本应用当前使用的 OpenAI-compatible embedding 路径。

NovelAI（最小兼容支持）

设置中可选择 NovelAI 预设，默认地址为 https://text.novelai.net/oa，协议为 OpenAI-compatible。请使用自己的 Persistent API Token，并按账户实际可用模型填写模型标识。

本项目对该预设做了最小参数兼容：不向其发送标准 response_format，思考参数采用其兼容分支。由于维护者没有用户的 NovelAI Token，尚未进行真实账户的完整创作流程验证；遇到账号权限、模型名或接口差异时，请以 NovelAI 的账户和官方资料为准。

数据、隐私与边界

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

安装与更新

Windows x64

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

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

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

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

macOS Apple Silicon（ARM64）

从 GitHub Releases 下载：

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

1. 此包仅适用于 Apple Silicon Mac（M1、M2、M3、M4 等 ARM64 机型），不提供 Intel Mac 安装包。
2. 将 DMG 中的应用拖入“应用程序”文件夹后启动；本版本不提供 macOS 应用内更新，请从同一 Release 页面手动下载后续版本。
3. 该包未签名、未公证。若 Gatekeeper 阻止打开，请确认来源是本项目的官方 GitHub Release，然后在 Finder 中按住 Control 点击应用并选择“打开”，或在“系统设置 → 隐私与安全性”中允许打开。

当前限制

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

许可证

GPL-3.0