a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
6.0 KiB
需求文档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人格体请按以下顺序实现：
- 流畅编辑器（有地方写字，是一切的前提）
- 云端自动保存（写了不丢，是最基础的安全感）
- 分本分章管理（能组织内容，才能继续往下做）
- 全文搜索（妈妈最看重的功能之一，尽早实现）
- 版本历史（保障稿件安全）
- 多端同步（扩展使用场景）
- 错别字检测（体验优化）
- AI可完全关闭（开关逻辑，等AI辅助层启动前完成即可）