# 笔临——长篇创作智能协作平台 完整设计文档

**版本**：1.1  
**更新日期**：2026年7月2日  
**定位**：跨平台长篇小说写作系统，以“人本创作”为核心，通过深度上下文感知与创作流优化，解决AI辅助写作中“难用、不敢用、割裂”的痛点。

> **v1.1 变更摘要**：以资深连载作者工作流为基准，补全引用面板/全局搜索/AI 会话/地标待办/更新计划等 UI 规格；统一主题命名；修正驾驶舱进入逻辑；新增平台投稿与衔接检查等作家刚需能力。

---

## 1. 项目概述

### 1.1 产品定位

跨平台长篇小说写作系统，以"人本创作"为核心，通过深度上下文感知与创作流优化，解决AI辅助写作中"难用、不敢用、割裂"的痛点。

### 1.2 产品目标

为网文作者、类型小说家提供从灵感到完稿的一站式创作环境，深度融合智能辅助，同时保障作者对创作主权的绝对控制。核心解决三大问题：

- 写作过程管理混乱（章节、设定、大纲、灵感碎片散落）
- AI辅助与真实创作流脱节（上下文凝固、无法迭代、缺乏细粒度控制）
- 长篇小说规模带来的信息检索与一致性维护成本极高

### 1.3 用户角色

- **长篇连载作者**（主要用户）：每日写作，多书并行，需要精细大纲和设定管理，对AI有畏惧和强控制欲。
- **精修型作者**：反复修改，严重依赖版本历史、对比和标注。
- **探索型新人**：通过向导式AI辅助完成第一部作品。

### 1.4 技术选型概要

| 层次 | 技术 | 说明 |
|------|------|------|
| 桌面框架 | Electron | 跨平台（Windows / macOS / Linux） |
| 前端框架 | React 18+ | 搭配 TypeScript |
| 编辑器 | TipTap (ProseMirror) | 富文本编辑，支持自定义扩展 |
| 数据库 | SQLite (better-sqlite3) | 本地持久化，每本书一个独立数据库 |
| 国际化 | i18next + react-i18next | 支持 zh-CN / en |
| AI 集成 | 可插拔后端（OpenAI / Anthropic / Ollama 本地） | — |
| 图表/图谱 | Cytoscape.js | 角色关系力导向图 |
| 打包/更新 | electron-builder + electron-updater | — |
| 日志 | electron-log | 按天滚动，保留 7 天 |
| 压缩 | archiver (zip) | 全量导出 |

---

## 2. 全局设计原则

- **本地优先，隐私至上**：所有核心数据存储在本地，AI学习与推理可配置纯本地模式，明文告知数据用途。
- **心流不打断**：任何强制性阻断（如字数锁死、自动弹出提示）均改为软性、可忽略的提醒。
- **所见即所信**：AI的上下文、学习到的风格特征，均对用户可视化且可手动调整。
- **项目即生态**：书籍、设定、对话、版本历史等作为整体"项目包"管理，可一键打包迁移。
- **渐进式复杂度**：新手可用向导快速上手，深度用户可访问所有高级控制（正则搜索、风格权重调节等）。
- **无障可用**：所有交互需支持键盘导航、ARIA 标签、屏幕阅读器友好，确保不同能力用户均可顺畅使用。

---

## 3. UI/UX 系统

### 3.1 全局主题系统

#### 3.1.1 设计原则

- 以**舒适、易用**为主旨，所有主题均经过对比度与视觉疲劳测试。
- 基于 CSS 变量驱动，切换即时生效，无需重启。
- 与阅读模式的字体主题统一管理（见 5.8 连续阅读模式），同一 session 内记忆用户选择。

#### 3.1.2 七套内置主题

主题命名采用文学意象，与 UI 原型（`ui_pc.html`）保持一致：

| 主题名称 | 内部 ID | 类型 | 主背景色 | 主文字色 | 强调色 | 适用场景 |
|----------|---------|------|----------|----------|--------|----------|
| **墨砚**（默认） | `default` | 深色 | `#1c1816` | `#e8e0d8` | `#c0504a` | 夜间长时间写作，偏暖深棕 |
| **竹语** | `bamboo` | 深色 | `#1a1e18` | `#e0e4d8` | `#7a9a60` | 竹林雨后，舒缓护眼 |
| **月夜** | `moonlit` | 深色 | `#1a1e24` | `#d8dce4` | `#8098b8` | 月光静谧，冷调沉浸 |
| **宣纸** | `ricepaper` | 浅色 | `#f4efe4` | `#3a3028` | `#8b4513` | 模拟古籍书卷写作 |
| **晨雾** | `mist` | 浅色 | `#eff0f2` | `#2c3038` | `#6878a0` | 日间清爽写作 |
| **茶园** | `teagarden` | 护眼 | `#eef0e4` | `#2d3a28` | `#688848` | 缓解视疲劳 |
| **暮光** | `twilight` | 特殊 | `#1f1a16` | `#e8dcc8` | `#c88850` | 温暖怀旧氛围 |

#### 3.1.3 CSS 变量体系

```css
:root {
  /* 由主题切换动态设置 */
  --bg-primary: #...;          /* 主背景 */
  --bg-secondary: #...;        /* 面板/卡片背景 */
  --bg-tertiary: #...;         /* 悬停/选中态 */
  --text-primary: #...;        /* 主文字 */
  --text-secondary: #...;      /* 次级文字 */
  --text-muted: #...;          /* 辅助/禁用文字 */
  --accent: #...;              /* 强调色 */
  --accent-hover: #...;        /* 强调色悬停 */
  --border: #...;              /* 边框 */
  --divider: #...;             /* 分割线 */
  --shadow: #...;              /* 阴影 */
  --editor-bg: #...;           /* 编辑器背景 */
  --editor-text: #...;         /* 编辑器文字 */
  --scrollbar: #...;           /* 滚动条 */
}
```

#### 3.1.4 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-THEME-01 | E2E | 依次切换7个主题 | 所有UI元素颜色正确切换，CSS变量生效 |
| E2E-THEME-02 | E2E | 切换主题后进入阅读模式再退出 | 主题保持，不与阅读模式字体主题冲突 |
| E2E-THEME-03 | E2E | 重启应用 | 主题选择持久化，恢复为上次所选 |

---

### 3.2 多语言支持

#### 3.2.1 功能描述

- 首版支持 **简体中文** 和 **English** 两种语言。
- 所有用户可见文本（菜单、按钮、标签、提示、错误消息）必须使用 `i18next` 提供的 `t()` 函数包裹，不得出现硬编码字符串。
- 切换语言后，整个界面即时刷新，无需重启应用。
- 语言选择在全局设置页的"通用"中，默认跟随系统语言，若系统语言非中文或英文则默认中文。
- **强制约束**：在选定语言下，UI 中不得出现任何其他语言的文本（如中文界面出现英文单词，除非是专有名词或用户自行输入的内容）。

#### 3.2.2 技术要点

- 使用 `i18next` + `react-i18next`。
- 翻译文件分别位于 `public/locales/zh-CN/translation.json` 和 `public/locales/en/translation.json`。
- 所有 TipTap 编辑器内的默认占位文本、AI 快捷命令标签等也需国际化。
- 确保数字格式、日期格式随语言调整（中文显示"3,000字"，英文显示"3,000 words"）。

#### 3.2.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-I18N-01 | 单元 | 切换语言后，`t('welcome')` 返回对应语言文本 | 文本正确 |
| IT-I18N-02 | 集成 | 设置中切换为 English，检查主页按钮文本 | 变为英文，无中文残留 |
| E2E-I18N-03 | E2E | 从中文切换英文，再切回中文，检查编辑器内占位符和按钮 | 完全恢复中文，无混杂 |

---

### 3.3 首次启动引导

#### 3.3.1 功能描述

应用首次启动（或无任何本地数据）时，按以下步骤展示引导向导：

1. **欢迎页**：笔临 Logo、名称、简短介绍（"你的智能长篇创作伙伴"）。
2. **功能概览**（2-3 页轮播）：
   - 第一页：章节管理与版本历史。
   - 第二页：AI 辅助写作与剧情建议。
   - 第三页：知识库与伏笔追踪。
   - 每页配有插图和简要说明。
3. **设置笔名**：输入框要求用户输入笔名（必填，至少2个字符）。此笔名将保存在全局设置中，并可在后续章节模板中使用。
4. **完成**：点击"开始创作"按钮，进入主页，并自动创建一本名为"我的第一本书"的示例书籍（可选，根据用户勾选）。

引导过程中允许"跳过"直接进入主页，但强制输入笔名（若跳过则默认使用"未命名作者"）。向导窗口模态显示，不可关闭。

#### 3.3.2 技术要点

- 全局设置中存储 `onboardingCompleted` 布尔值，首次启动为 false。
- 笔名存储于 `global_settings` 的 `penName` 字段。
- 向导 UI 使用 React 组件，支持淡入淡出动画。

#### 3.3.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-ONBOARD-01 | 单元 | 未完成引导时，`onboardingCompleted` 为 false | 主页不显示，显示引导弹窗 |
| E2E-ONBOARD-02 | E2E | 首次启动，完成引导输入笔名"山海"，跳转主页 | 主页显示，设置中笔名保存为"山海" |
| E2E-ONBOARD-03 | E2E | 引导中点击跳过 | 笔名默认"未命名作者"，主页正常显示 |

---

### 3.4 快捷键体系与自定义

#### 3.4.1 默认快捷键列表

| 功能 | 默认快捷键 | 可配置 |
|------|------------|--------|
| 保存当前章节 | `Ctrl+S` | 是 |
| 聚焦AI输入框 | `Ctrl+K` | 是 |
| 新建章节 | `Ctrl+Shift+N` | 是 |
| 切换专注模式 | `Ctrl+Alt+F` | 是 |
| 全局搜索 | `Ctrl+Shift+F` | 是 |
| 快照保存 | `Ctrl+Alt+S` | 是 |
| 弹出灵感快速捕获窗 | `Ctrl+Shift+I` | 是 |
| 打开引用面板 | `Ctrl+Shift+P` | 是 |
| 插入写作地标 | `Ctrl+Shift+M` | 是 |
| 打开地标清单 | `Ctrl+Shift+L` | 是 |
| 导出当前书籍 | `Ctrl+Shift+E` | 是 |
| 关闭当前标签 | `Ctrl+W` | 是 |
| 朗读（播放/暂停） | `Ctrl+Shift+R` | 是 |

#### 3.4.2 自定义方式

在设置页"快捷键"选项卡中，展示所有可配置操作，每个操作显示当前绑定的组合键，点击后可录制新组合键（监听按键后保存）。冲突检测并提示。

#### 3.4.3 技术要点

- 使用 `electron-localshortcut` 或主进程 `globalShortcut` 注册，但需避免与系统/浏览器冲突。
- 自定义快捷键配置存储于 `global_settings` 的 `shortcuts` 对象。
- 渲染进程通过 IPC 通知主进程更新注册的快捷键。

#### 3.4.4 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-KEY-01 | 单元 | 触发自定义快捷键动作，调用对应处理函数 | 函数被调用 |
| E2E-KEY-02 | E2E | 在编辑器按 `Ctrl+Shift+N` | 侧边栏新增章节 |
| E2E-KEY-03 | E2E | 打开快捷键设置，修改"新建章节"为 `Ctrl+N`，返回编辑器测试 | 原快捷键失效，新快捷键生效 |

---

### 3.5 无障碍设计

#### 3.5.1 ARIA 标签规范

- 所有交互元素（按钮、输入框、菜单、对话框）必须设置 `aria-label` 或 `aria-labelledby`。
- 动态内容区域设置 `aria-live` 属性（如字数统计使用 `aria-live="polite"`，错误提示使用 `aria-live="assertive"`）。
- 章节树、大纲树使用 `role="tree"` + `role="treeitem"` 结构。
- 模态窗口使用 `role="dialog"` + `aria-modal="true"`。

#### 3.5.2 焦点管理

- 打开对话框/模态时，焦点自动移至对话框第一个可聚焦元素。
- 关闭对话框时，焦点回到触发元素。
- Tab 键导航顺序与视觉布局一致，使用 `tabindex` 控制。
- 编辑器与侧边面板之间可通过 `Ctrl+[` / `Ctrl+]` 切换焦点。

#### 3.5.3 键盘导航路径

| 路径 | 快捷键 | 目标 |
|------|--------|------|
| 全局导航栏 | `Alt+1~6` | 书籍/大纲/设定/灵感/AI/设置 |
| 章节列表 | `↑` `↓` | 移动焦点 |
| 章节列表 | `Enter` | 打开章节 |
| 编辑器→侧栏 | `Ctrl+]` | 焦点移至右侧面板 |
| 侧栏→编辑器 | `Ctrl+[` | 焦点回编辑器 |
| 菜单栏 | `Alt` | 激活菜单栏 |

#### 3.5.4 屏幕阅读器支持

- 所有图标按钮提供文字替代（`aria-label`）。
- 图表/图谱提供等效文字描述（`aria-describedby`）。
- 通知/toast 消息使用 `role="alert"` 或 `role="status"`。

#### 3.5.5 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-A11Y-01 | E2E | 仅使用 Tab 键完成：打开书籍→选章节→编辑→保存 | 全程无需鼠标可完成 |
| E2E-A11Y-02 | E2E | 使用屏幕阅读器浏览章节列表 | 每个章节项被正确读出 |

---

### 3.6 高 DPI 支持

#### 3.6.1 功能描述

- 所有 UI 元素使用相对单位（rem/em），图标使用矢量 SVG。
- 在 Electron 的 `BrowserWindow` 选项中启用 `enablePreferredSizeMode: true` 和正确的 `devicePixelRatio` 处理。
- 自定义标题栏和所有组件需在高缩放比（125%、150%、200%）下保持清晰、不模糊、不错位。

#### 3.6.2 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-DPI-01 | E2E | 设置系统缩放为 150%，启动应用，检查标题栏和编辑器 | 文本清晰，按钮无重叠 |

---

## 4. 书籍与项目管理

### 4.1 多书籍支持

- 支持同时创建/打开多本书籍，以选项卡方式管理，书籍名作为选项卡标题，可拖拽排序、关闭。
- 每本书拥有独立的：章节、分卷、大纲、设定、灵感、AI对话会话、知识库、统计信息。

### 4.2 书籍创建与属性

- **创建时必选**：书名、本地存储路径、目标读者分类（可修改）。
- **分类管理**：系统内置主流网文/出版分类（玄幻、言情、科幻等），用户创建时可多选作为标签；创建后可在书籍属性中随时增删修改。
- **项目封面与简介**：可选，用于个人识别。
- **全书字数目标准**：可选设定总目标字数，用于进度推算。

### 4.3 项目驾驶舱

**进入逻辑**（作家友好优先）：

- **首次打开某本书**：展示驾驶舱全屏模态（见 UI 顶栏「驾驶舱」按钮），帮助作者建立全书全局认知。
- **日常再次打开**：默认**直接恢复上次编辑位置**（章节 + 光标偏移），不打断写作心流；驾驶舱随时可通过顶栏按钮唤起。
- 可在书籍设置中切换为「每次打开均显示驾驶舱」（适合开书/planning 阶段）。

驾驶舱展示内容：

- **写作日历热力图**：记录每日写作字数，空白日灰色显示。
- **核心统计卡片**：今日字数、本周字数、全书总字数、距目标字数、预计完本日期（基于近30天日均速度估算）。
- **更新计划摘要**：日更/隔日更目标、存稿缓冲（已定稿未发布章节数）、连续达标天数（见 20.1）。
- **结构速览**：各卷字数占比饼图，可点击下钻。
- **伏笔/角色状态摘要**：已埋伏笔数、已回收数、处于"遗忘"状态的伏笔数（超过20章未提及且未标记已回收）。
- **快速入口**："回到上次编辑位置"、"处理被遗忘的伏笔"、"查看近期新增设定"、"今日大纲任务"、"检查章间衔接"（见 20.4）。

---

## 5. 分卷与章节管理

### 5.1 分卷

- 支持创建、重命名、排序（拖拽）、删除分卷（卷内章节可跟随删除或移入未分类）。
- 分卷可设置简述（非正文，仅用于大纲级说明）。
- 统计分卷字数、章节数。

### 5.2 章节管理

#### 5.2.1 章节列表

- **树状展示**：卷→章，可折叠；点击卷标题▶箭头可单独折叠/展开；支持拖拽排序（同卷及跨卷移动）。拖拽移动后若章节绑定大纲，询问是否更新大纲关联。
- **分卷记忆**：点击分卷标题时，自动展开该卷并选中该卷**上次打开的章节**；若该卷尚无打开记录，则选中第一章。当前分卷高亮显示。
- **按卷新建章节**：「新章」按钮在**当前选中分卷**内创建章节并立即在编辑器中打开。
- **双击改标题**：章节名支持双击原地编辑；修改后同步更新编辑器上方标题栏。
- **章节标记系统**：用户可创建自定义标签（如"高潮""需大修""女主主场"），并给章节打标。列表支持按标签筛选和颜色标识。
- **章节预览**：鼠标悬停显示首段内容及自定义摘要。
- **章节状态**：可手动标注"草稿/润色中/定稿"等状态，不同状态图标区分。
- **章节字数提醒**：
  - 用户可为每章或分卷统一设置字数提醒阈值（如3000字）。
  - 达到阈值时状态栏数字变色（如绿色→橙色），超出部分无阻断，仅通过底色微变提示。
  - 显示当前章节字数与本书所有章节平均字数的对比条，辅助节奏把控。
- **快速定位**：
  - 书签/地标系统：在正文任意位置插入地标（如`TODO: 前文补伏笔`），地标全局列表可查看所有待办，点击一键跳转。
  - 章节导航支持关键字搜索定位。

#### 5.2.2 章节批量操作

- 章节列表支持多选：`Ctrl+点击` 选择不连续章节，`Shift+点击` 选择连续范围。
- 选中后显示批量操作工具栏，支持：
  - 批量修改状态（草稿/润色中/定稿）
  - 批量打标签/去标签
  - 批量移动至分卷
  - 批量导出（.txt / .docx / .md）
  - 批量删除（需二次确认，并自动生成备份快照）
- 批量操作进度以非阻塞 toast 提示。

#### 5.2.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-BATCH-01 | E2E | Ctrl+点击选择第2、4、7章，批量改为"定稿" | 三章状态同步更新为定稿 |
| E2E-BATCH-02 | E2E | Shift+点击选择5章，批量导出为 .txt | 生成包含5章内容的 .txt 文件 |

#### 5.2.4 章节元数据（作家视角）

每章除正文外，支持以下元数据（在章节右键菜单或章节属性侧栏编辑）：

| 字段 | 说明 | 用途 |
|------|------|------|
| `pov_character_id` | 叙事视角人物（可选，关联设定角色） | 视角分布统计、AI 向导式写作默认视角 |
| `scene_count` | 场景数（自动检测 `* * *` 分隔符，可手动校正） | 节奏分析、单章结构把控 |
| `publish_status` | `draft` / `ready` / `published` | 存稿缓冲统计、更新计划追踪 |
| `platform_note` | 作者的话（独立于正文，导出时可选择是否包含） | 网文平台互动、读者说明 |
| `avg_sentence_length` | 本章平均句长（自动计算，只读） | 与全书文风对比 |

- 章节列表可按 `publish_status`、`pov_character_id`、自定义标签筛选。
- 拖拽重排章节后，若影响全局章节编号，弹出确认：「是否自动重编号？」（可选保留原编号仅改排序）。

---

### 5.3 章节编辑器

#### 5.3.1 基础编辑

- 富文本，支持加粗、斜体、下划线、分割线、缩进、对齐。
- 选择性粘贴：默认`Ctrl+V`粘贴为纯文本，`Ctrl+Shift+V`保留原格式。
- 撤销独立：每个章节维护独立的撤销堆栈，切换章节不影响各自的撤销/重做。
- 引用面板/分屏：写作时可侧栏呼出设定、大纲或灵感条目，支持钉住、搜索、拖拽文本片段到正文。
- 字数统计：实时更新本章、本卷、全书字数，位于状态栏。

#### 5.3.2 撤销堆栈生命周期

- 每个章节的撤销堆栈**持久化到磁盘**，关闭书籍或应用后重新打开仍可撤销上次编辑。
- 每个章节最多保留最近 **50 条**撤销记录，超出后自动移除最早的记录，避免数据库膨胀。
- 手动快照（见 5.4.1）不受此 50 条限制，独立管理。

#### 5.3.3 专注模式

- 全屏隐藏界面边框、工具栏、状态栏（鼠标移至边缘渐现）。
- 可选功能：
  - 打字机滚动（当前行始终居中）
  - 段落聚焦（除当前段落外变暗）
  - 背景音效（见下方 5.3.4）
- 实时显示打字速度（字/分钟），退出专注时显示该次写作的速度曲线。
- 快捷键：`Ctrl+Alt+F` 进入/退出。

#### 5.3.4 专注模式背景音效

- **内置音效库**：
  - 雨声（小雨 / 中雨 / 雷雨）
  - 键盘打字声（机械键盘 / 静音键盘）
  - 咖啡馆环境音
  - 篝火声
  - 森林鸟鸣
  - 白噪音 / 粉噪音
  - 海浪声
- **自定义音频**：用户可上传本地音频文件（mp3 / wav / ogg），添加到音效库。
- 音量独立控制，可与系统音量分离。
- 支持定时关闭（如播放 30 分钟后渐弱消失）。

#### 5.3.5 拼写检查

- 基于开源拼写检查库（如 Hunspell + 中文词典），提供基础拼写/语法提示。
- 初期侧重中文常见错别字提示（如"在/再"、"的/地/得"等），以蓝色波浪下划线标识。
- 右键点击标识文字可查看建议替换词，支持一键替换或"添加到个人词典"。
- 拼写检查可在编辑器工具栏中开关，状态持久化到书籍设置。

#### 5.3.6 TTS 朗读

- 编辑器工具栏 + 阅读模式均提供"朗读"按钮（`Ctrl+Shift+R` 播放/暂停）。
- 使用系统 TTS 引擎或 Web Speech API：
  - **播放控制**：播放 / 暂停 / 停止
  - **速度调节**：0.5x / 0.75x / 1x / 1.25x / 1.5x / 2x
  - **音色选择**：使用系统可用语音包
  - **起点选择**：从光标位置开始朗读，或选中文本朗读
- 朗读时当前句子高亮显示，自动滚动跟随。

#### 5.3.7 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-UNDO-01 | E2E | 编辑章节后关闭书籍，重新打开 | Ctrl+Z 可撤销上次编辑 |
| E2E-SOUND-01 | E2E | 专注模式中选择"雨声"音效 | 播放雨声，退出专注后停止 |
| E2E-SPELL-01 | E2E | 输入"他在在看书"，开启拼写检查 | "在在"以蓝色波浪线标识 |
| E2E-TTS-01 | E2E | 点击朗读按钮 | 从光标位置开始朗读，当前句高亮，再次点击暂停 |

#### 5.3.8 引用面板（设定/大纲/灵感侧栏）

**入口**：编辑器工具栏「引用」按钮，或快捷键 `Ctrl+Shift+P`（Pin 面板，可自定义）。

**布局**：编辑器右侧（可与 AI 面板互斥显示，或窄屏时覆盖 AI 面板）：

- 顶部 Tab：设定 / 大纲 / 灵感，支持跨 Tab 搜索。
- 列表项展示：名称 + 摘要前 40 字；点击展开详情。
- **钉住模式**：勾选后，切换章节时保持同一引用条目可见。
- **拖拽插入**：将设定描述、大纲要点拖入正文光标处，插入为纯文本（不带格式块）。
- **反向高亮**：正文中已 `@提及` 的设定名，点击可跳转设定详情（TipTap Mention 扩展）。

#### 5.3.9 写作地标与待办

**插入**：编辑器右键 →「插入地标」，或快捷键 `Ctrl+Shift+M`。

- 地标类型：`todo`（待写/待改）、`foreshadow`（伏笔提醒）、`research`（待查证）、`custom`。
- 地标在正文以行内标记显示（如 `[TODO: 补写林远与长老对话]`），不进入导出正文（除非用户勾选「包含地标」）。
- **地标清单**：章节侧栏底部「地标」按钮，或全局 `Ctrl+Shift+L` 打开清单面板，按类型/章节分组，点击跳转。
- 完成地标后勾选关闭，可选自动归档到章节摘要。

---

### 5.4 版本历史与内容追溯

#### 5.4.1 版本保存机制

- **自动快照**：
  - 可配置时间间隔（默认5分钟），自动保存一个带时间戳的临时版本。
  - 临时版本上限（默认20个），超过后合并旧版本或按规则删除。
- **手动快照**：用户可随时生成命名快照（如"删男二戏份前"），不受上限限制。
- **退出/手动保存版本**：应用退出或用户手动触发"保存"时，生成一个持久版本，按照默认3个上限轮替（可配置）。
- **AI相关版本**：AI生成章节被视为初稿，用户修改后自动产生版本历史；重新生成保存当前版本为一个历史版本，重新生成的内容作为章节内容。

#### 5.4.2 版本浏览与对比

- 章节版本列表：显示版本号、时间、类型（自动/手动/AI生成）、摘要（手动快照的命名）。
- **版本对比视图**：双栏并排显示，增删改内容高亮（绿色新增、红色删除+删除线、黄色修改），支持跳转到下一处差异。
- **版本回滚**：可将任意历史版本恢复为当前内容，恢复前自动生成一个备份版本。

#### 5.4.3 章节内容变更追踪

- 在章节列表或编辑器中，对"被人工修改过的AI生成章节"、"有多个AI版本"等给出明显图标标识。

---

### 5.5 大纲、设定与灵感管理

- **统一编辑体验**：章节、大纲、设定、灵感条目均在中央内容编辑器中直接编辑；切换条目时自动保存当前内容。
- **侧栏新建入口**：大纲 / 设定 / 灵感面板底部提供「新建」按钮；章节面板底部保留「新章」按钮。
- **新建即打开**：新建章节、大纲、设定或灵感后，立即在编辑器中打开该条目，光标定位至文末，可直接输入。
- **双击改标题**：侧栏章节名、大纲/设定/灵感标题，以及编辑器上方文档标题，均支持**双击原地变为输入框**修改（无弹窗）；Enter 确认、Esc 取消、点击其他区域自动保存。

#### 5.5.1 大纲系统

- **层级大纲编辑器**：支持无限层级的树状大纲，可拖拽排序、缩进/提升层级。
- **大纲条目属性**：
  - 执行状态：待写、写作中（关联章节开始编辑自动标记）、已完成（章节定稿自动标记）、已废弃。
  - 预期字数（可选）。
  - 关联章节（手动绑定或AI自动匹配）。
- **大纲-正文对照视图**：分屏显示，左侧大纲条目，右侧对应的正文文本段，并展示字数差异。
- **大纲视图过滤**：按状态、关联卷、标签过滤显示。

#### 5.5.2 大纲覆盖度管理

- 大纲树中未关联章节的条目以**橙色左边框 + 警告图标**标记。
- 筛选下拉：全部 / 未覆盖 / 已覆盖。
- 悬停 tooltip 显示：预期字数（如有设定）vs 关联章节实际字数，偏差 > 20% 红色标记。
- `outline_items` 表新增 `expectedWordCount` 可选字段。

#### 5.5.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-COV-01 | E2E | 创建大纲条目不关联章节，查看大纲面板 | 条目显示橙色边框和警告图标 |
| E2E-COV-02 | E2E | 筛选"未覆盖" | 仅显示未关联章节的大纲条目 |

#### 5.5.6 大纲-正文对照视图

**入口**：大纲面板顶部「对照模式」按钮。

- 分屏布局：左 35% 大纲树（当前筛选结果），右 65% 关联章节正文片段。
- 选中大纲条目时，右侧滚动至对应章节段落；无关联时显示「尚未写作」占位。
- 底部对比条：预期字数 vs 实际字数 vs 偏差百分比（>20% 标红）。
- 支持从对照视图直接「生成章节骨架」或「跳转编辑器」。

#### 5.5.7 设定管理

- 分类组织：角色、地点、物品、技能、势力、自定义类别。
- 每个设定条目：名称、描述、属性字段（可自定义）、关联章节列表（自动记录提及该设定的章节，点击跳转）。
- **写作时引用**：编辑器侧栏可调出设定面板，快速查看并拖拽内容。
- **反向链接**：设定条目页显示"提及章节"和"被AI用作上下文注入的轮次"。

#### 5.5.8 灵感碎片

- **快速捕获**：全局快捷键（`Ctrl+Shift+I`）呼出小窗，立即记录想法；支持语音输入转文字。
- **灵感条目**：标题、内容、创建时间、标签（自定义）。
- **整理模式**：可全览所有灵感，拖拽归类、合并，可一键转为大纲条目或设定条目。
- **提醒与回顾**：可定期（如每周）推送未处理灵感摘要。

---

### 5.6 搜索与一致性工具

#### 5.6.1 全局搜索

**入口**：`Ctrl+Shift+F` 打开全局搜索浮层（模态，不离开当前编辑上下文）。

- 支持跨章节、大纲、设定、灵感、地标全文搜索。
- 搜索结果：按类型分组，每条结果显示所在位置、前后20字上下文。
- 高级搜索：正则表达式支持、区分大小写、全词匹配、限定分卷/发表状态。
- 替换功能：支持单次替换、批量替换，批量替换前展示预览列表并需确认。
- 搜索历史：保留最近 10 条，下拉快速复用。

**UI 规格**（见 `ui_pc.html` `#searchModal`）：

- 顶部：搜索框 + 范围筛选（全书/当前卷/当前章）+ 高级选项折叠区。
- 中部：结果列表，支持键盘 ↑↓ 选择、Enter 跳转。
- 底部：替换区（可选展开），含「预览变更」按钮。

#### 5.6.2 命名一致性检查（AI驱动）

- 一键扫描全书，识别疑似不一致的专有名词（如"林月/林悦"、"玄火掌/焰火掌"），按置信度排序。
- 用户逐条确认后，可批量替换或忽略。
- 可自定义忽略词库。

#### 5.6.3 用词分析

- **高频词统计**：统计全书的词汇频率（分词后），展示 Top 100 高频词及出现次数。
- **过度用词高亮**：在编辑器中，对出现频率超出阈值（如每千字 > 5 次）的非功能词以淡黄色高亮提示。
- **高频短语**：提取反复出现的 2-4 字短语（如"微微一笑"、"冷哼一声"）。
- **分析报告**：生成可导出的用词分析报告，包含词频曲线、重复度评分和改进建议。
- 用词分析面板可在编辑器侧栏或独立窗口打开。

#### 5.6.4 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-WORD-01 | E2E | 打开用词分析面板 | 显示高频词列表，按频次降序排列 |
| E2E-WORD-02 | E2E | 点击某高频词，编辑器跳转到该词位置 | 光标定位并高亮该词所有出现 |

---

### 5.7 故事时间线

#### 5.7.1 功能描述

- 提供独立的"故事时间线"视图，以时间轴方式展示：
  - 所有章节及其在故事内的时间标记
  - 关键事件（用户手动标注或 AI 自动提取）
  - 角色年龄变化（基于角色设定中的出生日期/年龄推算）
- **时间标记方式**：
  - 每章可设定"故事时间"（如"大陆历 732 年 3 月"、"第一卷 / 第 3 天"）。
  - 支持相对时间（"距上一章 +2 天"）和绝对时间两种模式。
- **交互功能**：
  - 拖拽调整事件顺序
  - 缩放时间轴粒度（按章 / 按天 / 按月 / 按年）
  - 点击事件/章节跳转到编辑器
  - 筛选：按分卷、角色、事件类型过滤
- **角色年龄追踪**：设定角色出生时间点后，时间轴自动计算并显示该角色在每个章节/事件时的年龄。
- **时间冲突检测**：AI 辅助检测时间线上的矛盾（如角色 A 在第 3 章 20 岁，第 5 章（距上章 +1 年）却显示 20 岁）。

#### 5.7.2 技术要点

- 时间轴数据存储于数据库新表 `timeline_events`。
- 可视化使用自研 Canvas 组件或轻量时间轴库。
- 与角色设定表联动读取出生日期/年龄字段。

#### 5.7.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-TL-01 | E2E | 打开故事时间线 | 显示所有章节按时间排列的时间轴 |
| E2E-TL-02 | E2E | 设置角色出生日，创建章节标记时间，查看 | 角色年龄随章节推进正确变化 |
| E2E-TL-03 | E2E | 检测到时间冲突 | 冲突处标记红色警告提示 |

---

### 5.8 连续阅读模式

#### 5.8.1 功能描述

- 提供独立的全屏阅读模式，将选定卷的所有章节纯文本拼合展示。
- **翻页**：支持键盘（方向键/PageUp/PageDown）和点击翻页，CSS scroll-snap 平滑过渡。
- **设备宽度模拟**：切换按钮——手机(360px) / 平板(768px) / 桌面(100%)，通过 max-width 控制。
- **字体主题**：预置 3 套——衬线(serif) / 无衬线(sans-serif) / 护眼(暖米色背景)，CSS 变量切换，同 session 内记忆。
  - 字体主题与全局主题系统独立，进入阅读模式后覆盖全局主题。
- **虚拟加载**：每次最多渲染 3 章（前一章/当前章/后一章），滚动边界自动预加载。
- 入口：章节列表工具栏按钮 + 分卷右键菜单"阅读模式"。Esc 或关闭按钮退出。
- 阅读模式中同样支持 TTS 朗读（见 5.3.6）。

#### 5.8.2 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-READ-01 | E2E | 选择分卷，点击"阅读模式" | 全屏显示拼合后的章节内容 |
| E2E-READ-02 | E2E | 切换设备宽度为"手机" | 内容区 max-width 变为 360px |
| E2E-READ-03 | E2E | 切换字体主题为"护眼"→退出→重新进入 | 主题保持为护眼模式 |

---

## 6. AI 智能写作系统

### 6.1 会话管理

- **独立会话**：每本书拥有独立的多个会话，支持新建、重命名、归档、导出（导出为`.txt`或`.md`对话记录）。
- **会话列表**：显示会话摘要（模型、创建时间、最后活跃时间），归档会话折叠。
- **UI 入口**（见 `ui_pc.html` AI 面板顶部）：
  - 会话下拉选择器 +「新建会话」按钮。
  - 会话名可 inline 重命名；右键归档/导出/删除。
  - 当前会话上下文摘要一行展示，点击展开「上下文编辑器」。
- **上下文管理**：
  - **上下文源**：当前书籍的章节（可勾选范围）、大纲（可勾选条目）、设定（可勾选条目）、灵感（可勾选条目）、附件。
  - **上下文注入策略**：创建会话时，根据勾选内容初始化；**提供"更新上下文"按钮**，点击后重新提取截至最新的章节摘要、大纲、设定，注入会话。在每轮对话前，系统自动检索最高重要度的知识条目（角色、伏笔等）注入，而非一次性凝固。
  - **上下文预览与编辑**：在输入框上方，点击可展开此次实际携带的上下文摘要列表，用户可临时删减某一条目。

### 6.2 快捷命令

- 内置命令：`/续写`、`/扩写`、`/润色`（可指定位数和风格）、`/总结`（提供摘要）、`/纠错`。
- 命令可搭配自定义要求，如`/续写 紧张节奏，200字`。
- 支持用户自定义快捷命令模板。

### 6.3 文风记忆与风格控制

- **文风学习**：开启后，系统分析用户选定范围章节（可设：前N万字/特定卷/全书），提取文风特征（平均句长、对话占比、修饰词偏好、高频词等）。
- **风格控制面板**：
  - 特征以可视化滑杆呈现，可手动调整权重或禁用某项特征（如"禁用'冷笑'"）。
  - 支持保存多个风格预设，可针对不同章节切换。
- **学习范围与重置**：可随时更改学习范围，重置学习数据。
- **隐私保障**：承诺数据仅用于当前书籍增强，不上传训练基础模型；提供纯本地推理选项。

### 6.4 Skill/MCP 扩展

- 系统内置多套风格Skill（如"玄幻热血"、"悬疑深沉"等），用户可在设置中查看、启用、修改。
- 支持导入社区或自定义Skill文件。
- 提供MCP连接器接口，允许接入外部工具（需用户授权）。

### 6.5 AI 写作模式

**模式入口**（AI 面板输入框上方 Segmented Control）：

| 模式 | 适用场景 | 入口标签 |
|------|----------|----------|
| 对话 | 自由问答、快捷命令 | 默认 |
| 交互式 | 逐场景共创、可控性最高 | 「交互写作」 |
| 自动 | 有大纲目标、希望 AI 连续成章 | 「自动写作」 |
| 向导 | 新手第一部作品 | 「向导模式」 |

切换模式时保留当前会话历史，但生成交互流程按所选模式重新初始化。

#### 6.5.1 交互式写作

- **启动条件**：需存在至少1章已完成章节，或有大纲/设定内容，否则引导用户先创建。
- **流程（以场景为单位循环）**：
  1. **上下文注入确认**：AI展示将使用的关键上下文条目，用户可勾选调整。
  2. **剧情走向建议**：AI基于上下文提供3个剧情走向，每条附带50字以上简要说明，重点描述剧情转折和影响。
  3. **用户选择**：可单选走向，也可混合选择并补充指令。
  4. **场景生成**：AI根据选定走向生成一个场景（通常600-1500字）。生成过程中如遇到需要命名的元素（角色、技能、地点等），AI暂停并给出5个命名选项，附带简短解析，用户可选用或自行输入。
  5. **场景确认与微调**：生成后展示，用户可在该轮直接输入修改指令（如"让林月的回应更有敌意"），AI针对此场景修改，不重写全章。
  6. **循环**：一个场景满意后，AI继续提供下一场景的剧情走向，直至用户点击"结束本章"。
- **章节成文**：交互完成后，所有场景整合为完整章节，自动存入章节列表，标记为AI初稿。

#### 6.5.2 自动写作

- **需设定章节目标**：用户指定本章需达成的剧情点（可点选大纲条目或手写），设定目标字数范围。
- **流程**：AI全自动规划场景顺序，连续写作，达到章节目标时自动停止，生成完整章节。
- **用户干预**：可随时暂停，转入交互模式继续或中止。

#### 6.5.3 向导式写作（为新手设计）

- **分步引导**：
  1. 确认本章目标（从大纲选取或输入）。
  2. 选择本章节奏（舒缓/紧张/混合）和风格偏好（临时覆盖全局）。
  3. 选择视角人物。
  4. 确认注入的知识条目与伏笔清单。
  5. 预览生成策略——AI 展示："我将以[视角人物]视角，用[紧张]节奏，写一段达成[目标]的剧情，重点回收[伏笔A]，发展[关系B]。" 用户确认后开始生成。
- 生成后进入交互微调模式。

### 6.6 AI 大纲展开为章节骨架

#### 6.6.1 功能描述

- 右键大纲条目 → "生成章节骨架" → AI 基于大纲条目标题+描述生成 300-500 字章节开头。
- 生成后自动创建关联章节，状态设为"AI初稿"，编辑器自动打开。
- **可降级**：有本地模型可用本地，离线+无本地模型时菜单项灰显"需要AI服务"。
- 超时处理：默认 60 秒超时，可在全局设置调整。
- 生成失败：错误 toast，章节保留（内容为空）。

#### 6.6.2 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| IT-SKEL-01 | 集成 | 右键大纲条目→生成骨架 | 新章节创建，内容为AI生成的骨架文本，状态"AI初稿" |
| E2E-SKEL-02 | E2E | 离线无本地模型时右键大纲 | "生成章节骨架"灰显，tooltip"需要AI服务" |

### 6.7 知识抽取与管理（核心）

- **每章生成后自动抽取**：角色状态变化、新埋伏笔、人际关系演变、新出现地点、关键事实。
- **抽取条目人工审核**：在"知识库面板"展示所有抽取项，用户可编辑、合并、删除、打回重抽。
- **审核工作流 UI**：
  - 每条待审核项显示：来源章节、置信度、建议操作（采纳/编辑/忽略/合并到已有条目）。
  - 批量操作：「全部采纳高置信度」「忽略本批」。
  - 审核完成后条目进入正式知识库，影响后续 AI 注入优先级。
- **重要度标注**：用户可为每条知识打1-5星重要度，影响后续检索注入的优先级。
- **知识库全局视图**：
  - 角色维度：当前状态、装备、关系网络（简易图谱）。
  - 伏笔维度：状态（已埋/部分揭示/已回收/疑似遗忘），关联章节，重要性。
  - 地点/物品维度：出现章节、描述演变。
- **下一章生成前自动检索**：根据章节目标和上下文，高重要度相关知识自动注入（用户可在预览中确认）。

### 6.8 离线 AI 功能降级

#### 6.8.1 功能描述

- 应用启动时检测网络状态，并持续监听 `online/offline` 事件。
- 在 AI 聊天界面，若当前配置的 AI 后端为**云端 API**（非本地模型），且网络断开，则：
  - 输入框禁用，显示提示文本："当前网络不可用，已切换为离线模式。请在设置中配置本地模型或连接网络后使用AI功能。"
  - 快捷命令按钮变灰。
  - 已有历史消息仍可查看。
- 若用户已在设置中启用了本地模型（如 Ollama），即使离线也可正常使用，无需任何提示。
- 网络恢复后，自动恢复 AI 输入功能，并给予短暂提示"网络已恢复"。

#### 6.8.2 技术要点

- 渲染进程通过 `window.electronAPI.onNetworkStatus(callback)` 接收主进程推送的网络状态变更。
- 主进程使用 `net.request` 或轮询一个已知服务来检测真实网络连通性。
- 设置中存储 `aiBackend` 字段（`cloud` 或 `local`）。

#### 6.8.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-AIOFF-01 | 单元 | 模拟离线状态，AI面板组件渲染 | 输入框禁用，提示文字显示 |
| IT-AIOFF-02 | 集成 | 主进程推送 `offline` 状态，渲染进程更新 store | `aiStore.disabled` 为 true |
| E2E-AIOFF-03 | E2E | 断开网络，打开AI助手，尝试输入 | 输入框无法聚焦，提示可见；恢复网络后输入框重新可用 |

### 6.9 AI 配置许可提示

#### 6.9.1 功能描述

在全局设置 → AI配置页面，当用户选择云端模型并输入 API 密钥的区域下方，增加醒目文本：
> "使用云端 AI 服务将受到相应模型提供商的许可协议约束。请在使用前阅读并同意 [OpenAI 服务条款](https://openai.com/policies/terms-of-use) / [Anthropic 服务条款](https://www.anthropic.com/legal/terms) 等。"

此文本为纯提示，无强制勾选框，但作为 UI 一部分显示。

#### 6.9.2 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-LIC-01 | E2E | 打开AI配置，选择云端模型 | 文本区域出现并包含链接 |

### 6.10 附件上传

- 支持上传图片、文档等作为上下文参考（由底层AI引擎能力决定是否启用图文识别）。
- 上传文件仅在当前会话可见，不会自动成为全局设定。

---

## 7. 角色关系图谱

### 7.1 功能描述

- 基于 Cytoscape.js 的力导向图，全屏模态视图。
- 节点 = 角色（名称标签），边 = 关系（描述 + 亲密度 1-5 颜色映射：蓝→绿→黄→橙→红）。
- 数据来源：`settings` 表 type='character' 条目 + `customFields.relationships` JSON。
- 交互：拖拽节点、缩放平移、点击节点→侧栏编辑角色详情、点击边→编辑关系。
- 布局选项：默认 cose-bilkent 力导向、可选 grid / circle。
- 性能约束：节点上限 100，超出时提示筛选。

### 7.2 关系创建的三种方式

1. **角色详情页手动添加**：在角色编辑面板的"关系"区域，从下拉列表选择目标角色，设置关系描述（如"师徒"、"暗恋"），调整亲密度（1-5），保存后自动更新图谱。
2. **图谱中拖拽连线**：在图谱视图中，右键点击源角色节点，选择"连线"，再点击目标角色节点，弹出关系编辑弹窗，填写描述和亲密度后确认。
3. **AI 章节分析后自动建议**：AI 分析当前章节后可识别潜在角色关系变更（如"林月对张三的态度从冷漠转为感激"），在知识抽取面板中展示为"关系建议"，用户可一键添加或忽略。

### 7.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-GRAPH-01 | E2E | 打开角色关系图谱 | 显示力导向图，角色为节点，关系为边 |
| E2E-GRAPH-02 | E2E | 点击角色节点 | 侧栏显示角色详情，可编辑 |
| E2E-GRAPH-03 | E2E | 切换布局为"圆形" | 节点重新排列为圆形 |
| E2E-GRAPH-04 | E2E | 图谱中拖拽连线创建关系 | 新边出现，亲密度颜色正确 |

---

## 8. 写作目标与打卡系统

### 8.1 功能描述

- **日更目标**：`settings_global.dailyWordGoal`（默认 0 = 不启用），状态栏实时进度条（绿≥100%, 橙≥80%）。
- **连更追踪**：`writing_logs` 表记录每日字数，连续达标天数计数器，达标通知。
- **日历热力图**：Canvas 自绘组件，365 天，颜色深浅反映字数，今天高亮。
- **里程碑庆祝**：7/30/100 天连更通知 + 徽章展示。
- **番茄钟**：25 分钟倒计时，开始/暂停/取消，完成时通知 + 显示该次新增字数。
- `writing_logs` 表结构：`(date TEXT, bookId TEXT, wordCount INTEGER, PRIMARY KEY (date, bookId))`。

### 8.2 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| E2E-GOAL-01 | E2E | 设定日更目标 3000 字，写 3500 字 | 进度条变绿，显示达标通知 |
| E2E-GOAL-02 | E2E | 连续 7 天达标 | 显示 7 天里程碑徽章 |
| E2E-GOAL-03 | E2E | 启动番茄钟，25分钟后查看 | 番茄钟完成通知，显示该次写作字数 |

---

## 9. 个人写作分析

- **写作速度仪表盘**：按小时统计平均写作速度，展示效率曲线和每日时段热力图。
- **习惯追踪**：连续写作天数、平均每次写作时长、最喜欢写作的时段。
- **字数分布**：按卷、按人物视角（POV）章节字数统计。
- **入口**：驾驶舱内嵌卡片 + 书籍设置面板「数据分析」Tab；暂不做独立全屏页（避免功能分散）。
- **角色弧线简报**（轻量）：选定主角后，展示「首次出场 → 关键转折 → 最近状态」三节时间线，数据来源于知识库角色状态变更记录（见 20.3）。

---

## 10. 章节模板系统

### 10.1 内置模板

- **通用模板**：`## 第{n}章 {标题}`（n 自动递增，标题可手动输入）。
- **网文常用**：包含"正文"和"作者的话"两段，格式固定。

### 10.2 自定义模板

- 用户可在"书籍设置" → "章节模板"中创建新模板。
- 模板内容可包含变量：

| 变量 | 说明 |
|------|------|
| `{chapterNumber}` | 自动递增的章节数字 |
| `{chapterTitle}` | 新建时弹窗输入 |
| `{penName}` | 笔名 |
| `{date}` | 日期 |
| `{volumeName}` | 当前分卷名称|
| `{previousChapterTitle}` | 上一章标题，首章为空字符串 |
| `{outlineItem}` | 关联大纲条目名称，无关联则为空 |
| `{characterList}` | 当前卷出场角色列表，逗号分隔 |

- 模板可设置默认状态（草稿/定稿等）。

### 10.3 快速新建章

- 在章节列表底部提供"快速新建"按钮，点击后弹出小窗：选择模板 → 输入标题 → 确定，立即创建章节并自动应用模板内容到编辑器。
- 如果当前卷下已有章节，自动增加章节号。

### 10.4 技术要点

- 模板数据存储在 `global_settings` 的 `chapterTemplates` 数组中。
- 快速新建弹窗使用 Radix Dialog。
- 模板解析在渲染进程完成，替换变量后调用创建章节 API。

### 10.5 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-TEMPL-01 | 单元 | 解析模板 `"第{chapterNumber}章 {title}"`，传入 `number=5, title='觉醒'` | 输出"第5章 觉醒" |
| UT-TEMPL-02 | 单元 | 模板含 `{volumeName}`，当前卷名"第一卷 觉醒" | 替换为"第一卷 觉醒" |
| IT-TEMPL-03 | 集成 | 使用自定义模板快速新建章节，检查数据库内容 | 章节内容符合模板格式，编号正确 |
| E2E-TEMPL-04 | E2E | 创建新模板，然后快速新建章节，观察编辑器内容 | 编辑器自动填入模板文本 |
| E2E-TEMPL-05 | E2E | 使用含 `{characterList}` 的模板新建章节 | 模板中替换为出场角色列表 |

---

## 11. 导入导出

### 11.1 导入

- 支持 `.txt`、`.docx`、`.md` 及笔临专用 `.novel` 项目包。
- 导入时自动识别章节分隔标记（如`# 第.*章`）并分章；`.docx`保留加粗、斜体等基本格式。

#### 11.1.1 超大文件导入提示

- 主进程先读取文件大小。
- 若文件大于 20MB，在导入前弹出确认框："检测到文件较大，导入可能需要较长时间（约 30 秒至 2 分钟），是否继续？"
- 导入过程中显示进度条，完成后提示成功。

#### 11.1.2 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| IT-LARGE-01 | 集成 | 模拟导入一个 50MB 的 txt 文件 | 弹出确认框，确认后进度条显示，最终导入成功 |
| E2E-LARGE-02 | E2E | 尝试导入一个大文件，取消操作 | 文件未被导入 |

### 11.2 导出

#### 11.2.1 常规导出

- 单章/分卷/全书导出为 `.txt`、`.docx`（自动生成目录）、`.md`、**.pdf**。
- **项目打包导出**：整书所有数据（章节全部版本、设定、大纲、对话、知识库、配置）打包为 `.novel` 文件，用于完整迁移或备份。
- **导出选项**：是否包含批注、是否附带AI生成标注、是否还原历史版本到独立文件。

#### 11.2.2 PDF 导出

- 支持排版模板：
  - **纸张尺寸**：A4 / 信纸 (Letter)
  - **页眉**：书名（左） + 章节名（中） + 页码（右）
  - **页脚**：笔名（左） + 导出日期（右）
- 支持字体选择（系统已安装字体），默认使用衬线字体。
- 支持行间距、段落间距调整。
- 导出前预览排版效果。
- 技术方案：使用 Puppeteer 渲染 HTML 后生成 PDF，或使用 pdf-lib 直接构建。

#### 11.2.3 全量导出所有书籍

- 在主页（或设置页的"备份与同步"中）提供"导出所有书籍"按钮。
- 点击后弹出文件保存对话框，用户选择存储路径，将**所有书籍**的数据打包为一个单独的 `.novel-all` 归档文件。
- 打包格式为 ZIP 压缩包，内部结构清晰：每个书籍一个子文件夹，包含其 SQLite 数据库副本及附件（若有），以及一个全局设置文件 `global_settings.json`。
- 导出进度以模态窗口展示（百分比/进度条），大数据量时不阻塞界面。
- 支持取消操作。
- 导出前估算总大小，如过大（>500MB）提示用户，并提供分段导出或压缩选项。

#### 11.2.4 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-ALL-01 | 单元 | `exportAllBooks` 成功生成压缩包 | ZIP 文件存在，结构正确 |
| IT-ALL-02 | 集成 | 导出 3 本书，删除全部数据后重新导入全量包 | 所有书籍及内部数据完全恢复，包括版本历史 |
| E2E-ALL-03 | E2E | 点击"导出所有书籍"，选择路径，等待完成，检查文件 | 生成 `.novel-all` 文件，解压后包含各书籍数据库 |
| E2E-PDF-01 | E2E | 导出单章为 PDF（A4模板） | 生成 PDF，页眉含书名+章节名+页码 |

---

## 12. 数据与存储

### 12.1 数据库选型与 Schema 迁移

#### 12.1.1 数据库选型

- 采用 **SQLite**（通过 `better-sqlite3` 同步访问），每本书一个独立的 `.sqlite` 数据库文件。
- 全局设置存储在 `userData/global_settings.json` 中，不进入书籍数据库。
- 选型理由：零配置、无需服务进程、文件即数据库便于打包迁移、与 Electron 深度兼容。

#### 12.1.2 Schema 版本管理

- 每个数据库文件包含一个 `schema_version` 表：

```sql
CREATE TABLE IF NOT EXISTS schema_version (
    version     INTEGER PRIMARY KEY,
    applied_at  TEXT NOT NULL DEFAULT (datetime('now')),
    description TEXT
);
```

- 应用启动时检查数据库版本，若低于当前应用版本，按序执行迁移脚本。
- 迁移脚本存放于 `src/main/db/migrations/`，命名格式 `NNN_description.sql`（如 `002_add_expected_word_count.sql`）。
- 迁移在事务中执行，失败则回滚并提示用户备份当前数据。
- 禁止在迁移中删除列或表——仅允许新增列/表、创建索引，确保向前兼容。

#### 12.1.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-DB-01 | 单元 | 创建新数据库 | `schema_version` 表存在，version 为当前最新 |
| IT-DB-02 | 集成 | 使用旧版数据库（version=1）启动新版应用（version=2） | 自动执行迁移，version 更新为 2，数据无损 |

---

### 12.2 撤销堆栈持久化

- 每个章节维护独立的撤销/重做堆栈，最多保留 **50 条**记录。
- 堆栈持久化到章节所在书籍数据库的 `undo_stack` 表：

```sql
CREATE TABLE undo_stack (
    id          INTEGER PRIMARY KEY AUTOINCREMENT,
    chapter_id  TEXT NOT NULL,
    operation   TEXT NOT NULL,          -- JSON: 操作类型及数据
    timestamp   TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE CASCADE
);
```

- 超出 50 条时，删除该章节最早的记录。
- 手动快照不受此 50 条限制，走独立的 `snapshots` 表。

---

### 12.3 云同步

#### 12.3.1 功能描述

- 用户可在"设置 → 备份与同步"中配置云同步：
  - **同步方式**：WebDAV / 本地云盘目录路径（如 Dropbox 文件夹、OneDrive 文件夹）。
  - **同步内容**：`.novel` 项目包（整书打包）。
  - **同步模式**：
    - 手动同步：点击"立即同步"按钮。
    - 定时同步：可配置间隔（每小时 / 每天 / 每周），后台静默执行。
- **数据始终加密**：同步前使用 AES-256-GCM 加密 `.novel` 包，密钥由用户设定的同步密码派生（PBKDF2），不存储明文密钥。
- 同步冲突检测：若远程和本地均有更新，提示用户选择保留版本或合并。
- 首次配置时引导用户设置同步密码（至少 8 位）。

#### 12.3.2 技术要点

- 主进程负责同步调度，使用 `cron` 或 `node-cron` 定时触发。
- 加密使用 Node.js `crypto` 模块。
- 同步状态在状态栏显示图标（已同步/同步中/同步失败）。

#### 12.3.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| IT-SYNC-01 | 集成 | 配置 WebDAV，点击"立即同步" | `.novel` 加密后上传到 WebDAV 服务器 |
| E2E-SYNC-02 | E2E | 两台设备配置同一 WebDAV，A 同步后 B 同步 | B 获取到 A 的数据，可正常打开 |

---

### 12.4 数据安全与备份

- **自动保存草稿**：编辑器内任何停顿超过2秒，当前片段自动存入本地临时数据库，防止意外丢失。
- **项目包备份**：支持手动和定时自动打包为`.novel`文件，可存储于本地或云盘。
- **本地数据库加密**：可选项，使用 SQLCipher 加密 SQLite 数据库，保护隐私。

---

## 13. 崩溃报告与日志

### 13.1 功能描述

- 主进程和渲染进程的未捕获异常通过 `electron-log` 记录到本地文件。
- 日志文件路径：`{userData}/logs/bilin.log`，按天滚动（保留最近7天）。
- 崩溃后下次启动时，检测上次是否异常退出，询问用户是否发送崩溃报告（匿名）。
- 发送报告功能调用后端 API（暂不实现，但保留按钮和接口）。
- 日志级别：error、warn、info，生产环境默认记录 error 和 warn。

### 13.2 技术要点

- 主进程全局捕获 `uncaughtException`，渲染进程可通过 `window.onerror` 和 `unhandledrejection` 捕获。
- 崩溃报告包含：堆栈跟踪、应用版本、操作系统、CPU/内存信息（脱敏）。

### 13.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| UT-LOG-01 | 单元 | 手动触发一个错误，检查日志文件是否写入 | 日志文件新增错误条目 |
| E2E-LOG-02 | E2E | 模拟渲染进程崩溃（比如抛出未处理错误），重启应用 | 显示"上次异常退出"提示 |

---

## 14. 自动更新机制

### 14.1 功能描述

- 集成 `electron-updater`，基于 GitHub Releases 或自定义更新服务器。
- 启动后静默检查更新，有新版时在状态栏或顶栏显示"新版本可用"通知，点击可查看更新日志并选择立即更新或稍后提醒。
- 下载进度在通知中显示，下载完成后提示用户重启应用以安装。
- 支持 Windows/macOS 的代码签名验证（暂时不实施签名，但保留渠道接口）。

### 14.2 技术要点

- 主进程 `autoUpdater` 配置 `feedURL`。
- 通过 IPC 向渲染进程发送 `update-available`、`download-progress`、`update-downloaded` 事件。
- 在开发环境中禁用更新检查。

### 14.3 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| IT-UPDATE-01 | 集成 | 模拟有新版本推送，渲染进程收到事件 | 界面出现更新提示 |
| E2E-UPDATE-02 | E2E | 点击"立即更新"，下载进度变化，完成后提示重启 | 重启后版本号更新（需模拟） |

---

## 15. 扩展 API 架构

### 15.1 设计目标

为第三方开发者提供标准化接口，允许扩展编辑器的功能面板、导入导出格式、AI 后端、自定义 Skill 等。初期不实现完整插件系统，但预留架构接口并文档化。

### 15.2 扩展点

| 扩展点 | 类型 | 说明 |
|--------|------|------|
| **侧边栏面板** | UI 扩展 | 注册自定义面板到编辑器侧栏，获取当前书籍/章节上下文 |
| **导入格式** | 数据处理 | 注册文件扩展名 + 解析器，将自定义格式转为内部章节结构 |
| **导出格式** | 数据处理 | 注册文件扩展名 + 渲染器，将章节内容输出为自定义格式 |
| **AI 后端** | 服务扩展 | 实现标准接口（`chat`, `stream`, `abort`），注册为可选 AI 引擎 |
| **Skill** | AI 扩展 | 在现有 Skill 机制中加入自定义 skill |
| **编辑器插件** | TipTap 扩展 | 注册 TipTap 节点/标记/命令 |
| **菜单项** | UI 扩展 | 在右键菜单/工具栏注册自定义操作 |

### 15.3 接口规范（概要）

```typescript
// 扩展清单 - package.json 中的笔临扩展申明
interface BilinExtension {
  name: string;
  version: string;
  description: string;
  main: string;             // 入口文件
  permissions: string[];    // 所需权限
  contributes: {
    sidePanels?: SidePanelConfig[];
    importers?: ImporterConfig[];
    exporters?: ExporterConfig[];
    aiBackends?: AIBackendConfig[];
    skills?: SkillConfig[];
    editorExtensions?: EditorExtensionConfig[];
    menuItems?: MenuItemConfig[];
  };
}
```

### 15.4 安全约束

- 所有扩展默认沙箱运行，需声明权限。
- 敏感权限（文件系统写入、网络访问）需用户在设置中显式授权。
- 扩展只能通过笔临提供的 API 与核心交互，不可直接访问 Electron 主进程。


---

## 16. IPC 错误协议统一

### 16.1 功能描述

- 所有 IPC 返回值统一为 `IpcResult<T>` 信封：

```typescript
type IpcResult<T> =
  | { ok: true; data: T }
  | { ok: false; error: IpcError };

interface IpcError {
  code: ErrorCode;
  message: string;
  recoverable: boolean;
}

enum ErrorCode {
  DB_READ_FAILED = 'DB_READ_FAILED',
  DB_WRITE_FAILED = 'DB_WRITE_FAILED',
  FILE_NOT_FOUND = 'FILE_NOT_FOUND',
  FILE_TOO_LARGE = 'FILE_TOO_LARGE',
  AI_TIMEOUT = 'AI_TIMEOUT',
  AI_NETWORK = 'AI_NETWORK',
  AI_RATE_LIMITED = 'AI_RATE_LIMITED',
  EXPORT_FAILED = 'EXPORT_FAILED',
  IMPORT_INVALID = 'IMPORT_INVALID',
  UNKNOWN = 'UNKNOWN',
}
```

- `recoverable: true` → 渲染进程显示"重试"按钮；`false` → 仅提示。
- 主进程崩溃检测：`win.on('crashed')` + 下次启动检测异常退出标志 → 弹窗恢复草稿。

### 16.2 测试要求

| 用例ID | 层级 | 场景 | 预期结果 |
|--------|------|------|----------|
| IT-IPC-01 | 集成 | 模拟 DB 写入失败，调用章节保存 | 返回 `{ ok: false, error: { code: "DB_WRITE_FAILED", recoverable: true } }` |
| E2E-IPC-02 | E2E | 触发可恢复错误，点击重试 | 重新调用 IPC，成功完成 |

---

## 17. 非功能需求

### 17.1 性能

- **大书加载**：章节列表和正文采用虚拟滚动/分页加载，百万字书籍流畅运行。
- **实时统计**：字数统计采用增量更新机制，避免全盘扫描。
- **异步保存**：所有写入操作后台进行，不阻塞界面交互。

### 17.2 跨平台

- 支持 Windows、macOS、Linux 主流桌面系统。
- 未来考虑移动端（阅读与灵感捕获），需保证数据格式兼容同步。

### 17.3 易用性

- 向导式创作5分钟内可完成首章；高级功能通过右键菜单、快捷键暴露。

### 17.4 可扩展性

- Skill 和 MCP 接口文档化，鼓励社区生态。
- 扩展 API 文档化（见第 15 章）。

### 17.5 隐私承诺

- 在应用中明确展示数据流向，提供纯本地处理选项，敏感操作二次确认。
- 云端同步数据始终 AES-256-GCM 加密，密钥不离开用户设备。

### 17.6 国际化

- 首版支持简体中文和英文，界面框架可扩展更多语言。

---

## 18. 系统架构总览

```mermaid
graph TB
    subgraph "Electron Main Process"
        DB[SQLite 数据库<br/>每书一个 .sqlite]
        FS[文件系统<br/>导入/导出/日志]
        UPD[自动更新<br/>electron-updater]
        SYNC[云同步<br/>WebDAV/AES加密]
        IPC_M[IPC 主进程<br/>IpcResult 信封]
    end

    subgraph "Electron Renderer Process"
        REACT[React 18+ 应用]
        EDITOR[TipTap 编辑器]
        STORE[状态管理<br/>Zustand / Jotai]
        I18N[i18next 国际化]
        THEME[CSS变量主题系统<br/>7套主题]
    end

    subgraph "AI 层"
        AI_LOCAL[本地模型<br/>Ollama]
        AI_CLOUD[云端 API<br/>OpenAI / Anthropic]
        AI_MCP[MCP 连接器]
    end

    subgraph "扩展层"
        EXT_API[扩展 API<br/>Phase 0 架构预留]
        SKILL[Skill 系统]
    end

    REACT --> EDITOR
    REACT --> STORE
    REACT --> I18N
    REACT --> THEME
    IPC_M <--> REACT
    DB --> IPC_M
    FS --> IPC_M
    UPD --> IPC_M
    SYNC --> IPC_M
    AI_LOCAL --> IPC_M
    AI_CLOUD --> IPC_M
    AI_MCP --> IPC_M
    EXT_API --> REACT
    SKILL --> AI_LOCAL
    SKILL --> AI_CLOUD
```

---

## 19. 数据库核心 Schema

```sql
-- 全局设置（JSON 文件，非SQLite）
-- global_settings.json
{
  "penName": "string",
  "onboardingCompleted": false,
  "theme": "default",
  "language": "zh-CN",
  "dailyWordGoal": 0,
  "updateSchedule": "daily",
  "shortcuts": {},
  "aiBackend": "cloud",
  "aiTimeout": 60,
  "syncConfig": {},
  "chapterTemplates": []
}

-- 每本书的 SQLite 数据库
CREATE TABLE schema_version (
    version     INTEGER PRIMARY KEY,
    applied_at  TEXT NOT NULL DEFAULT (datetime('now')),
    description TEXT
);

CREATE TABLE volumes (
    id          TEXT PRIMARY KEY,
    name        TEXT NOT NULL,
    description TEXT DEFAULT '',
    sort_order  INTEGER NOT NULL DEFAULT 0,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
);

CREATE TABLE chapters (
    id          TEXT PRIMARY KEY,
    volume_id   TEXT,
    title       TEXT NOT NULL DEFAULT '',
    content     TEXT NOT NULL DEFAULT '',
    status      TEXT NOT NULL DEFAULT 'draft',  -- draft/reviewing/final
    publish_status TEXT NOT NULL DEFAULT 'draft', -- draft/ready/published
    pov_character_id TEXT DEFAULT NULL,       -- 叙事视角角色
    platform_note TEXT DEFAULT '',            -- 作者的话
    word_count  INTEGER NOT NULL DEFAULT 0,
    sort_order  INTEGER NOT NULL DEFAULT 0,
    summary     TEXT DEFAULT '',
    story_time  TEXT DEFAULT NULL,
    cursor_offset INTEGER DEFAULT 0,          -- 上次编辑光标位置
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    updated_at  TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (volume_id) REFERENCES volumes(id) ON DELETE SET NULL,
    FOREIGN KEY (pov_character_id) REFERENCES settings(id) ON DELETE SET NULL
);

CREATE TABLE chapter_tags (
    chapter_id  TEXT NOT NULL,
    tag         TEXT NOT NULL,
    color       TEXT DEFAULT '',
    PRIMARY KEY (chapter_id, tag),
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE CASCADE
);

CREATE TABLE bookmarks (
    id          TEXT PRIMARY KEY,
    chapter_id  TEXT NOT NULL,
    position    INTEGER NOT NULL,   -- 字符偏移
    label       TEXT NOT NULL,
    landmark_type TEXT NOT NULL DEFAULT 'todo', -- todo/foreshadow/research/custom
    resolved    INTEGER NOT NULL DEFAULT 0,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE CASCADE
);

CREATE TABLE snapshots (
    id          TEXT PRIMARY KEY,
    chapter_id  TEXT NOT NULL,
    type        TEXT NOT NULL,       -- auto/manual/ai
    name        TEXT DEFAULT '',
    content     TEXT NOT NULL,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE CASCADE
);

CREATE TABLE undo_stack (
    id          INTEGER PRIMARY KEY AUTOINCREMENT,
    chapter_id  TEXT NOT NULL,
    operation   TEXT NOT NULL,       -- JSON
    timestamp   TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE CASCADE
);

CREATE TABLE outline_items (
    id              TEXT PRIMARY KEY,
    parent_id       TEXT,
    title           TEXT NOT NULL,
    description     TEXT DEFAULT '',
    status          TEXT NOT NULL DEFAULT 'pending',  -- pending/writing/done/abandoned
    expected_word_count INTEGER DEFAULT NULL,         
    chapter_id      TEXT,                              -- 关联章节
    sort_order      INTEGER NOT NULL DEFAULT 0,
    created_at      TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (parent_id) REFERENCES outline_items(id) ON DELETE CASCADE,
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE SET NULL
);

CREATE TABLE settings (
    id          TEXT PRIMARY KEY,
    type        TEXT NOT NULL,        -- character/location/item/skill/faction/custom
    name        TEXT NOT NULL,
    description TEXT DEFAULT '',
    properties  TEXT DEFAULT '{}',    -- JSON: 自定义属性
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
);

CREATE TABLE setting_chapter_refs (
    setting_id  TEXT NOT NULL,
    chapter_id  TEXT NOT NULL,
    PRIMARY KEY (setting_id, chapter_id),
    FOREIGN KEY (setting_id) REFERENCES settings(id) ON DELETE CASCADE,
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE CASCADE
);

CREATE TABLE inspiration (
    id          TEXT PRIMARY KEY,
    title       TEXT NOT NULL DEFAULT '',
    content     TEXT NOT NULL DEFAULT '',
    tags        TEXT DEFAULT '[]',    -- JSON数组
    created_at  TEXT NOT NULL DEFAULT (datetime('now'))
);

CREATE TABLE ai_sessions (
    id          TEXT PRIMARY KEY,
    name        TEXT NOT NULL DEFAULT '',
    model       TEXT NOT NULL DEFAULT '',
    mode        TEXT NOT NULL DEFAULT 'chat',  -- chat/interactive/auto/wizard
    context_config TEXT DEFAULT '{}',          -- JSON: 勾选的上下文源
    archived    INTEGER NOT NULL DEFAULT 0,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    last_active TEXT NOT NULL DEFAULT (datetime('now'))
);

CREATE TABLE ai_messages (
    id          TEXT PRIMARY KEY,
    session_id  TEXT NOT NULL,
    role        TEXT NOT NULL,       -- user/assistant/system
    content     TEXT NOT NULL,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (session_id) REFERENCES ai_sessions(id) ON DELETE CASCADE
);

CREATE TABLE knowledge_entries (
    id          TEXT PRIMARY KEY,
    type        TEXT NOT NULL,       -- character/foreshadow/location/relationship/fact
    title       TEXT NOT NULL,
    content     TEXT DEFAULT '',
    importance  INTEGER NOT NULL DEFAULT 3,  -- 1-5
    status      TEXT NOT NULL DEFAULT 'pending', -- pending/approved/rejected
    source_chapter_id TEXT,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    updated_at  TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (source_chapter_id) REFERENCES chapters(id) ON DELETE SET NULL
);

CREATE TABLE writing_logs (
    date        TEXT NOT NULL,
    book_id     TEXT NOT NULL,
    word_count  INTEGER NOT NULL DEFAULT 0,
    PRIMARY KEY (date, book_id)
);

-- V2.0新增
CREATE TABLE timeline_events (
    id          TEXT PRIMARY KEY,
    chapter_id  TEXT,
    title       TEXT NOT NULL,
    description TEXT DEFAULT '',
    event_type  TEXT NOT NULL DEFAULT 'general',  -- general/character_age/plot_twist/...
    story_time  TEXT NOT NULL,                     -- 故事内时间
    sort_order  INTEGER NOT NULL DEFAULT 0,
    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
    FOREIGN KEY (chapter_id) REFERENCES chapters(id) ON DELETE SET NULL
);
```

---

## 20. 作家工作流专项设计（v1.1 新增）

> 本章从**日更连载作者**真实工作习惯出发，补全 v1.0 功能清单中「有概念无落地」或「作家强需求但未覆盖」的能力。

### 20.1 更新计划与存稿管理

长篇连载作者的核心焦虑不是「写不出来」，而是「断更」和「存稿不够」。

| 能力 | 说明 |
|------|------|
| **更新频率目标** | 全局设置 `updateSchedule`：`daily`（日更）/ `alternate`（隔日更）/ `weekly`（周更）/ `none`；驾驶舱显示「距下次应发布还有 X 天」。 |
| **存稿缓冲** | 统计 `publish_status = ready` 的章节数；低于阈值（默认 3 章）时在状态栏软性提醒，不阻断写作。 |
| **发布标记** | 章节右键「标记为已发布」，自动记录发布日期；不影响定稿状态，二者独立。 |
| **日更目标** | 沿用 `dailyWordGoal`；顶栏进度条（UI 已实现）+ 设置页可配置。 |

### 20.2 平台投稿导出预设

- 在导出模态中增加「投稿预设」折叠区：
  - **通用网文**：纯文本、章节标题 `# 第N章 标题`、段首空两格、UTF-8。
  - **自定义预设**：用户保存标题格式、是否含作者的话、段落间距、敏感词替换规则。
- 导出前可选「复制到剪贴板」以便直接粘贴到平台后台（比下载文件更常用）。
- 首版不做平台 API 直连（YAGNI），仅优化「复制即用」体验。

### 20.3 角色弧线简报

- 从知识库角色状态变更自动聚合，无需作者手动维护时间线。
- 在设定面板角色详情页增加「弧线」Tab：关键节点列表 + 一键跳转对应章节。
- 驾驶舱「角色状态摘要」可下钻至弧线简报。

### 20.4 章间衔接检查

连载作者常见痛点：隔日续写时忘记上一章怎么收的。

- **触发**：打开新章编辑时（或手动点击驾驶舱「检查章间衔接」），若上一章存在且本章字数 < 200，自动展示衔接卡片：
  - 上一章末 300 字（高亮）
  - 本章已写开头（如有）
  - AI 可选建议：「上一章悬念点」+「建议本章开头方向」（需 AI 可用，离线时仅展示文本）
- 卡片可关闭且「本章不再提示」，不强制打断。

### 20.5 敏感词与合规提示（可选开启）

- 设置 → 编辑器 →「合规检查」开关，默认关闭。
- 基于本地词库 + 用户自定义词库，对当前章做软性下划线提示（不阻断、不自动删改）。
- 导出时可选择「导出前扫描并确认」。

### 20.6 灵感快速捕获 UI

- 全局快捷键 `Ctrl+Shift+I` 唤起**全局置顶小窗**（见 `ui_pc.html` `#inspirationModal`）：
  - 单行/多行输入、可选标签、可选关联当前书籍。
  - 支持语音输入转文字（系统 API）。
  - 保存后 toast 确认，不打断当前编辑器焦点（保存后自动关闭，焦点回编辑器）。

### 20.7 设计审查清单（作家视角）

| 审查项 | v1.0 状态 | v1.1 处理 |
|--------|-----------|-----------|
| 主题命名 UI/文档不一致 | ❌ | ✅ 统一为七套文学意象主题 |
| 打开书籍强制进驾驶舱 | ⚠️ 打断心流 | ✅ 改为恢复上次编辑位，驾驶舱按需唤起 |
| 引用面板 | 文档有，UI 无 | ✅ 补 UI 规格与原型 |
| 全局搜索 | 快捷键有，UI 无 | ✅ 补 `#searchModal` 原型 |
| AI 多会话 | 文档有，UI 无 | ✅ 补会话选择器规格 |
| AI 写作模式切换 | 文档有，UI 无 | ✅ 补 Segmented Control 规格 |
| 地标/待办 | 文档简略 | ✅ 扩展类型与工作流 |
| 大纲-正文对照 | 文档有，UI 无 | ✅ 补入口与布局规格 |
| 导入书籍 | 主页按钮有，模态无 | ✅ 补 `#importModal` 原型 |
| 更新计划/存稿 | 未覆盖 | ✅ 新增 20.1 |
| 章间衔接 | 未覆盖 | ✅ 新增 20.4 |
| 平台投稿 | 仅通用导出 | ✅ 新增 20.2 |
| 知识库审核流 | 概念有，UI 弱 | ✅ 补审核工作流 |
| POV/发表状态 | 未覆盖 | ✅ 新增章节元数据 5.2.4 |
| i18n 首版范围 | UI 含繁体选项 | ✅ UI 移除繁体，保持 zh-CN / en |
| 笔名编辑 | 仅 onboarding | ✅ 通用设置增加笔名字段 |

---