# 需求文档01 · 基础码字层

## 一、这个模块是什么

基础码字层是光湖作者模块的地基。它不做任何AI辅助，只做一件事：让作者能在这里流畅、安心、不丢稿地写字。所有上层功能（智能辅助、卡文助手、审美库）都建立在这一层之上。

---

## 二、核心功能清单

### 功能01 · 流畅编辑器

**是什么：** 供作者输入正文的核心写作区域。

**要做什么：** 提供干净、无干扰的文字输入界面。支持基础文字格式（加粗、斜体、下划线）。字体、字号、行距可调节。支持全屏专注模式，进入后隐藏所有非正文元素。

**边界（不做什么）：** 不做复杂富文本排版（表格、图片嵌入等）。不强制特定字体风格。

**成功标准：** 作者打开编辑器，输入文字，感觉流畅无卡顿，和使用百灵创作的体验一致或更好。

---

### 功能02 · 云端自动保存

**是什么：** 作者输入内容后，系统自动将内容保存到云端，无需手动操作。

**要做什么：** 每隔固定时间（建议10秒）自动触发保存。网络断开时保存到本地缓存，恢复网络后自动同步。界面上显示「已保存」「保存中」「本地缓存」三种状态提示。

**边界（不做什么）：** 不依赖作者手动点击保存按钮。不在保存时打断作者输入。

**成功标准：** 作者关闭页面再打开，内容完整存在，一个字都不少。

---

### 功能03 · 版本历史

**是什么：** 系统自动记录文稿的历史版本，作者可以找回之前的内容。

**要做什么：** 每次保存生成一个版本快照。作者可以查看版本列表（显示时间）。作者可以预览某个历史版本的内容。作者可以将某个历史版本恢复为当前版本。

**边界（不做什么）：** 版本历史保留最近30天，不永久保留所有版本（避免存储压力）。不提供版本对比diff功能（后续可加）。

**成功标准：** 作者误删内容后，能在版本历史里找回30天内任意时间点的稿子。

---

### 功能04 · 分本分章管理

**是什么：** 作者可以在系统里管理多部作品，每部作品下管理多个章节。

**要做什么：** 支持创建多部「作品」，每部作品下可创建多个「章节」。章节支持拖拽排序。支持章节重命名、删除、复制。显示每个章节的字数统计。显示整部作品的总字数统计。

**边界（不做什么）：** 不做文件夹多层嵌套（只有作品→章节两层）。不做标签分类系统（后续可加）。

**成功标准：** 作者能清晰看到自己所有作品和章节，点击任意章节直接进入编辑，切换流畅。

---

### 功能05 · 全文搜索

**是什么：** 作者在任意位置输入关键词，系统返回该作品全文所有出现该关键词的位置，带上下文预览。

**要做什么：** 在任意章节内可发起全文搜索。搜索范围默认为当前作品全部章节。结果列表显示：所在章节名 + 关键词前后各约50字的上下文预览。点击搜索结果直接跳转到对应章节和位置。关键词高亮显示。支持模糊匹配（如搜「沈」可以找到「沈清」「沈云」等）。

**边界（不做什么）：** 不做跨作品搜索（只在当前作品内搜索）。不做正则表达式搜索。

**成功标准：** 作者记得某段剧情有「雨夜」这个词，搜索后能在几秒内找到全部相关章节，看到上下文就能判断是不是自己要找的那段。这个体验和百灵创作的搜索功能一致或更好。

---

### 功能06 · 多端同步

**是什么：** 作者在电脑上写的内容，在手机上也能看到、继续写；反之亦然。

**要做什么：** 登录同一账号后，内容自动在所有设备间同步。切换设备后内容为最新状态。

**边界（不做什么）：** 不做离线本地模式（需要联网使用）。

**成功标准：** 作者在电脑写到一半，拿起手机打开光湖，看到的是最新的内容，可以继续写。

---

### 功能07 · 错别字检测

**是什么：** 系统自动检测正文中的错别字，提示作者修改。

**要做什么：** 编辑过程中自动检测，错别字下方显示波浪线提示。点击错别字显示建议修改词。作者可以接受建议或忽略。

**边界（不做什么）：** 不做语法检查（只检查错别字）。不强制修改，作者可以选择忽略所有提示。

**成功标准：** 作者写完一章，能通过错别字提示快速扫描并修正明显的输入错误。

---

### 功能08 · AI可完全关闭

**是什么：** 作者可以选择完全关闭所有AI辅助功能，进入纯净写作模式。

**要做什么：** 设置中提供「关闭AI辅助」开关。关闭后，所有AI相关功能（续写建议、卡文提示等）全部隐藏，界面回到纯文本编辑器状态。开关状态持久保存，下次打开仍然有效。

**边界（不做什么）：** 关闭AI不影响云端保存、版本历史、搜索等基础功能。

**成功标准：** 作者进入写入状态时，能做到完全不被AI打扰，界面干净，只有文字。

---

## 三、技术要求

- API接口不写死固定模型，配置成自动检测可用模型的接口（冰朔主控指示）
- 优先选择最简单、最稳定的实现方式
- 本地环境：Node.js · Python · VS Code
- 代码存放：GitHub仓库

---

## 四、优先级顺序

执行层AI人格体请按以下顺序实现：

1. 流畅编辑器（有地方写字，是一切的前提）
2. 云端自动保存（写了不丢，是最基础的安全感）
3. 分本分章管理（能组织内容，才能继续往下做）
4. 全文搜索（妈妈最看重的功能之一，尽早实现）
5. 版本历史（保障稿件安全）
6. 多端同步（扩展使用场景）
7. 错别字检测（体验优化）
8. AI可完全关闭（开关逻辑，等AI辅助层启动前完成即可）