> ## Documentation Index
> Fetch the complete documentation index at: https://ai-novel-writing-assistant.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装下载

> 桌面版下载与安装、首次启动、数据位置、更新与备份、源码运行

## 桌面版（推荐）

普通写作使用桌面版,无需安装 Node.js、pnpm 或手动启动服务端。点下面对应系统直接下载 **v0.8.1**：

> [card] [Windows 安装版（推荐）](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/releases/download/v0.8.1/Biz-Novel-Studio-0.8.1-setup-x64.exe)
>
> 约 141 MB · 适合长期使用，支持应用内更新

> [card] [Windows 便携版](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/releases/download/v0.8.1/Biz-Novel-Studio-0.8.1-portable-x64.exe)
>
> 约 141 MB · 免安装，数据跟随程序目录

> [card] [macOS（Apple Silicon）](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/releases/download/v0.8.1/Biz-Novel-Studio-0.8.1-mac-arm64.dmg)
>
> 约 189 MB · M 系列芯片

> [card] [macOS（Intel）](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/releases/download/v0.8.1/Biz-Novel-Studio-0.8.1-mac-x64.dmg)
>
> 约 193 MB · Intel 芯片

> [card] [Linux（AppImage）](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/releases/download/v0.8.1/Biz-Novel-Studio-0.8.1-linux-x86_64.AppImage)
>
> 约 214 MB · x86\_64，赋予执行权限后直接运行

> [card] [所有版本与更新说明](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/releases/latest)
>
> 在 GitHub Releases 查看最新版本和历史版本

> [!TIP]
>
> 不确定 Mac 是哪种芯片：点左上角苹果菜单 → 关于本机，「芯片」一栏显示 Apple M1/M2/M3/M4 就选 arm64，显示 Intel 就选 x64。

## 各平台安装步骤

> [tab] Windows
>
> **安装版**
>
> 1. 双击 `setup-x64.exe`，按向导操作。可以自定义安装目录，默认创建桌面和开始菜单快捷方式。
> 2. 如果出现「Windows 已保护你的电脑」提示，点 **更多信息 → 仍要运行**。
> 3. 安装完成后会自动启动。
>
> **便携版**
>
> 把 `portable-x64.exe` 放进一个单独的文件夹再运行。数据会保存在同目录下的 `<程序名>-data` 文件夹中，移动时连同这个文件夹一起复制。

> [tab] macOS
>
> 1. 双击 `.dmg`，把 Biz Novel Studio 拖进「应用程序」。
> 2. 首次打开如果被系统拦截，到 **系统设置 → 隐私与安全性**，在下方找到被阻止的应用，点 **仍要打开**。
> 3. 如果提示「已损坏，无法打开」，在终端执行下面的命令后重新打开：
>
> ```bash theme={null}
> xattr -dr com.apple.quarantine "/Applications/Biz Novel Studio.app"
> ```
>
> 当前 Mac 安装包未做 Apple 签名与公证，所以首次打开需要手动放行。

> [tab] Linux
>
> ```bash theme={null}
> chmod +x Biz-Novel-Studio-*-linux-x86_64.AppImage
> ./Biz-Novel-Studio-*-linux-x86_64.AppImage
> ```
>
> 部分发行版运行 AppImage 需要先安装 FUSE（例如 Ubuntu 22.04 及以上安装 `libfuse2`）。

## 首次启动

桌面版启动时会先拉起本地服务，再进入工作台。启动页依次显示「启动本地引擎 → 加载工作区 → 已就绪」，通常几秒到十几秒。

进入工作台后，如果还没有可用的文本模型，会自动弹出 **快捷配置**。填好 API Key、地址和模型并通过检测后，就可以开始创作。详细流程见 [创作向导](https://ai-novel-writing-assistant.mintlify.site/onboarding.md)。

> [!WARNING]
>
> 启动页停在「启动受阻」时，先点页面上的日志入口查看原因。常见原因是杀毒软件拦截了本地服务，或上一次进程没有完全退出。完全退出应用后重新打开，仍失败可保存日志包到 [Issues](https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant/issues) 反馈。

## 数据保存在哪里

小说、章节、设定、任务记录和本地数据库都保存在本机，不会上传到项目服务器（调用模型时，相关内容会发给你配置的模型供应商）。

| 版本 | 默认数据目录 |
| - | - |
| Windows 安装版 | `%LOCALAPPDATA%\AI-Novel-Writing-Assistant-v2` |
| Windows 便携版 | 程序所在目录下的 `<程序名>-data` |
| macOS | `~/Library/Application Support/AI-Novel-Writing-Assistant-v2` |
| Linux | `~/.AI-Novel-Writing-Assistant-v2` |

日志在数据目录下的 `logs` 文件夹。卸载 Windows 安装版**不会**删除数据目录，重装后数据仍在。

## 更新

| 版本 | 怎样更新 |
| - | - |
| Windows 安装版 | 启动时自动检查新版本。点顶部栏的版本号打开「版本与更新」，可以手动 **检查更新**，下载完成后点 **重启安装** |
| Windows 便携版 | 不支持应用内更新。下载新版便携包替换旧程序，保留 `-data` 文件夹 |
| macOS | 不支持应用内更新。下载新版 `.dmg` 覆盖安装，数据不受影响 |

## 备份与迁移

长篇创作的数据很重要，建议定期备份：

1. 完全退出应用（确认没有正在运行的生成任务）。
2. 复制整个数据目录到安全位置。
3. 重要作品另外导出一份正文。

迁移到新电脑时，在新电脑安装同一或更新版本，首次启动前把备份的数据目录放回对应位置即可。

> [!WARNING]
>
> 不要在应用运行时复制或替换数据库，也不要在没有备份的情况下删除数据目录。

## 手机端

目前没有手机 App，手机应用商店里搜不到官方安装包。手机上想用，可以在浏览器里访问你自己在电脑或服务器上部署的 Web 版界面；正式写作仍推荐桌面版，屏幕和操作都更合适。

## 源码运行（开发者）

环境要求：

| 项目 | 要求 |
| - | - |
| Node.js | `^20.19.0 \|\| ^22.12.0 \|\| >=24.0.0` |
| pnpm | `>=10.6.0`（仓库声明使用 `pnpm@10.6.0`） |
| 文本模型 | 至少一组可用 API 配置，可在启动后填写 |
| 数据库 | 默认本地 SQLite；可通过服务端配置使用 PostgreSQL |
| 知识库检索 | 可选 Qdrant 与 Embedding 模型，不是首次写作的前置条件 |

```bash theme={null}
git clone https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant.git
cd AI-Novel-Writing-Assistant
pnpm install
cp server/.env.example server/.env   # Windows PowerShell 用 Copy-Item
pnpm dev
```

前端默认为 `http://localhost:5173`，服务端为 `http://localhost:3000`。`server/.env` 中确认 `DIRECTOR_NEXT_ENABLED=true`（开放 V2 选择）；尚未配置 Qdrant 时设置 `RAG_ENABLED=false` 先跑通创作。启动后打开系统设置，配置并测试模型（见 [模型配置](https://ai-novel-writing-assistant.mintlify.site/model-configuration.md)）。

## 下一步

> [card] [创作向导](https://ai-novel-writing-assistant.mintlify.site/onboarding.md)
>
> 完成快捷配置，从一句灵感走到第一章

> [card] [常见问题](https://ai-novel-writing-assistant.mintlify.site/faq.md)
>
> 安装、模型、任务暂停等问题的处理方法


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.