SYSTEM
桌面智能创作助手(码字工具)|带时间的工作计划表
src/content/notes/growth/04-带时间的工作计划表.md 桌面智能创作助手(码字工具)|带时间的工作计划表
文档版本:v2.0(重定位·激进瘦身)
总周期:8 周,合计 56 自然日;业余开发每日可投入 1‑2 小时;周末集中做阶段验收、集成测试、文档。 技术方案:Spring Boot 3.5 + Spring AI 1.x GA(Spring AI 2.0 GA 要求 Spring Boot 4 基线,与本项目不兼容,锁定 1.x)+ Electron 桌面壳(Vue3 + Element Plus) + SQLite(四表) + Ollama;后端与 jlink 裁剪 JRE 随桌面安装包分发,v1.0 仅交付 Windows x64。 🔵v2.0 变化:产品重定位为码字工具 + AI 赋能;移除多 Agent FSM、写文件人工审批、本地文档 RAG、多会话隔离、Redis 快照、pgvector;数据层由六表收敛为 SQLite 四表(document / doc_version / prompt_template / material,单文件嵌入式),去掉 Redis;SSE 事件白名单收敛为 token / error / complete;阶段由 8 段重型设计重构为「写作核心(W1‑W4)→ AI 赋能(W3‑W7)→ 交付(W8)」。 全部里程碑对应 Git Tag:v0.1、v0.2、v0.3、v0.4、v0.5、v0.6、v0.7、v1.0。 文档包含:阶段总览、按天详细任务表格、里程碑定义、里程碑总览、文本甘特图、完整风险清单、MVP 阻塞降级裁剪预案、交付物清单、进度管控规则、迭代路线图。
总体时间基线
| 周次 | 天数范围 | 阶段名称 | Git标签 | 里程碑 |
|---|---|---|---|---|
| W1 | D1‑D7 | 阶段0:环境与后端脚手架 | v0.1 | M1 本地模型对话 + 健康探测 + 日志脱敏就绪 |
| W2 | D8‑D14 | 阶段1:Electron 桌面壳 + 编辑器 + 文档管理(写作核心骨架) | v0.2 | M2 桌面窗口可写作、文档 CRUD、草稿防丢稿 |
| W3 | D15‑D21 | 阶段2:ModelRouter 双模式 + AI 续写 + 快捷处理 | v0.3 | M3 续写/快捷处理可用,双模式切换 |
| W4 | D22‑D28 | 阶段3:文档版本 + 多格式导出(写作核心闭环) | v0.4 | M4 存版/对比/回滚 + txt/md/word 导出 |
| W5 | D29‑D35 | 阶段4:文体模板 + 大纲 + 灵感 + 素材 | v0.5 | M5 模板切换/大纲跳转/灵感/素材插入可用 |
| W6 | D36‑D42 | 阶段5:全文自检(规则引擎 + LLM + 前端标注) | v0.6 | M6 全文自检标红替换闭环 |
| W7 | D43‑D49 | 阶段6:写作舒适辅助 + 模型参数预设 + 联网素材 | v0.7 | M7 舒适三件套 + 参数双预设 + 联网开关 |
| W8 | D50‑D56 | 阶段7:桌面打包交付(jlink JRE + 进程编排 + 冒烟测试)、安全测试、完整文档交付 | v1.0 | M8 完整可交付 MVP 成品(Windows x64 安装包) |
时间说明:
- D1=项目第 1 自然天,D56=项目第 56 自然天;
- 周内工作日执行开发编码;周末(D6‑D7 / D13‑D14 / D20‑D21 / D27‑D28 / D34‑D35 / D41‑D42 / D48‑D49 / D55‑D56)执行阶段验收、集成测试、文档编写、bug 集中修复;
- 工时单位 h,为预估总投入工时;业余模式拆分为每日 1‑2h 执行;
- 整体预留 +1 周弹性缓冲窗口,若某阶段阻塞可整体后移,不裁剪核心功能。
一、按天详细任务计划表
阶段0|环境与后端脚手架 W1 D1‑D7|Tag v0.1|里程碑 M1
| 周 | 天 | 任务内容 | 工时(h) | 产出/验收标准 | 风险 & 应对 |
|---|---|---|---|---|---|
| W1 | D1 | 搭建本地开发环境:安装 JDK21、Maven、Docker Desktop、IDEA、Node.js;配置国内镜像源 | 2 | java -version / mvn -v / node -v 执行正常;依赖下载无网络问题 |
网络慢→全部使用国内 Maven / npm 镜像 |
| D2 | 本机安装 Ollama,拉取 qwen2.5:3b;curl 调用 ollama 接口完成基础推理测试;设置 OLLAMA_MODELS=D:\ollama\models、OLLAMA_LLM_LIBRARY=cpu(弱核显 CPU 推理,避免 Vulkan 乱码) | 2 | ollama run qwen2.5:3b 可正常对话;确认 Ollama 服务监听 127.0.0.1:11434 |
显存不足→降级 qwen2.5:1.5b;弱显卡乱码→强制 CPU 推理;文档明确:下载预训练模型,不需要训练模型 | |
| D3 | Spring Initializr 创建 Spring Boot 3.5 项目;引入 spring‑ai‑starter‑model‑ollama、SQLite(sqlite‑jdbc + mybatis‑plus‑boot‑starter)、POI(XWPF) 依赖;统一版本对齐 Spring Boot 3.5.x + Spring AI 1.x GA(核实 Maven Central 实际 GA 版本) | 2 | 项目可正常启动;Maven 依赖无版本冲突;启动冒烟测试通过 | 严格对齐 Spring AI 版本;禁止随意升级依赖;启动验证兼容性 | |
| D4 | 开发基础 ChatController(非流式);对接本机 Ollama;编写基础 DTO 与全局异常骨架 | 2 | curl localhost:8080/api/... 可拿到模型返回结果;异常不直接抛出原始堆栈 |
接口参数基础校验;区分业务异常与系统异常 | |
| D5 | 统一 application.yml 分层配置(ollama.base-url、SQLite 连接取自数据目录 + PRAGMA WAL);完善全局异常处理器;实现日志层密钥脱敏(正则替换,不包装请求体);实现健康探测接口 /api/status/local-model(3 状态 UNAVAILABLE/MODEL_MISSING/READY + 推荐模型列表 + pull 命令);实现 X-Local-Token 生成写入数据目录并加接口校验 / Host 校验 | 2 | 配置分层清晰;健康接口返回 3 状态;日志自动脱敏 apiKey;业务接口缺 token 返回 401 | 容器模式无法区分未安装/未启动→统一归 UNAVAILABLE 引导;单元测试日志脱敏 | |
| D6‑D7 | 周末|端到端最小闭环(vertical slice):用最小页面(可先为普通 Vite 页面)打通【触发 → 后端存 SQLite → 调 Ollama 续写 → SSE 流回 → 前端插入】整链路,尽早暴露集成风险;随后阶段0 集成验收、README 初稿、单元测试、打 Git Tag v0.1 | 3 | ★M1:调用 Ollama 可问答;健康探测 3 状态完整;日志脱敏生效;最小闭环跑通(前端↔后端↔Ollama↔SQLite) | 回滚点:commit v0.1;若链路阻塞优先保证健康接口 + 基础对话 + SSE 最小闭环 |
M1 里程碑(W1 末 D6‑D7) 可演示成品:后端调用本地 Ollama 完成问答;健康探测 3 状态可诊断;日志脱敏生效;前端↔后端↔Ollama↔SQLite 最小闭环跑通。 验收标准:
- curl 调用后端接口返回正常回答;
- 健康接口返回 3 状态(UNAVAILABLE / MODEL_MISSING / READY),返回推荐模型与复制 pull 命令;
- 日志层脱敏生效,不打印明文密钥;业务接口缺
X-Local-Token返回 401;- SQLite 初始化成功(四表建表脚本可执行,库文件生成于应用数据目录);
- 端到端最小闭环跑通:前端触发 → 后端落库 → 调 Ollama → SSE 流回前端插入;
- README 明确说明:本地模式下载预训练模型,不需要训练模型。 Git Tag:v0.1
阶段1|Electron 桌面壳 + 编辑器 + 文档管理 W2 D8‑D14|Tag v0.2|里程碑 M2
🟢阶段重点:前端外壳采用 Electron 桌面壳(Vue3 + Element Plus),正文编辑器采用 TipTap(ProseMirror 内核)(不再自研 contenteditable),SSE 统一使用 fetch + ReadableStream,彻底禁用 EventSource;写作核心第一块落地:编辑器 + 文档 CRUD + 防丢稿草稿缓存。
| 周 | 天 | 任务内容 | 工时(h) | 产出/验收标准 | 风险 & 应对 |
|---|---|---|---|---|---|
| W2 | D8 | 初始化 Electron 工程:Vite + Vue3 + TypeScript + Element Plus;main/preload/renderer 三进程骨架;electron‑builder 打包配置;安全基线:contextIsolation 开启、nodeIntegration 关闭、sandbox 开启,preload 仅暴露文件选择/保存/注入 token 能力;主进程 spawn 启动后端(shell:false)+ tree-kill 兜底杀进程树 + 启动遮罩轮询健康接口 + 退出优雅停机;开发模式启动成功 |
4 | electron 开发模式渲染 Vue 页面成功;主进程可创建窗口;后端随应用自动拉起、就绪前显示遮罩、退出无残留进程;渲染进程安全配置生效 | Electron 打包/热更新坑;进程树残留与端口占用;preload 白名单能力最小化 |
| D9 | 桌面主窗口布局:文档列表侧边栏 + 正文编辑器(TipTap / ProseMirror 内核接入:@tiptap/vue-3 + 基础排版扩展)+ AI 工具箱占位区 + 字数统计占位;护眼暗色基础 |
3 | ★主窗口布局可用;TipTap 编辑器可输入、可读写 HTML(getHTML())与纯文本(getText());暗色主题基础生效 |
编辑器内核定型为 TipTap→统一用 getHTML()/getText(),标红与偏移映射按 03 §1.9 处理 |
|
| D10 | 文档管理后端:document 表建表 + MyBatis‑Plus Entity/Mapper;接口 GET/POST/GET{id}/PUT/DELETE /api/documents(支持 genre/keyword 过滤);删除事务级联版本 |
3 | 文档 CRUD 接口可用;列表可按更新时间排序、按 genre/关键词过滤;统一审计时间字段 | 命名与规范对齐 03 §1.7;禁止循环 N+1 查询 | |
| D11 | 前端文档管理接线:新建/重命名/分组/搜索/删除;列表按更新时间排序、按文体过滤;当前文档切换保持状态 | 3 | ★文档列表与后端联调通过;新建/删除/切换可用;关闭重开仍能加载 | 切换文档时未保存内容丢失→切换前自动存草稿 | |
| D12 | 编辑器写作体验 + 防丢稿:正文输入防抖实时自动缓存 localStorage(writingCache 按 documentId 分 key),重启应用恢复并提示;实时字数统计(当前文档总字数 + 当前选中字数)基础实现 | 3 | ★断网/崩溃重启恢复草稿不丢稿;字数统计准确(含中文输入法 Composition 处理) | localStorage 容量→草稿按文档分 key、清理旧草稿;字数统计基于 getText() 避免输入法推荐词虚增 |
|
| D13‑D14 | 周末|阶段1 验收;执行文档 CRUD + 草稿缓存单元/集成测试;修复 bug;提交代码,打 Git Tag v0.2 | 2 | ★M2:桌面窗口可写作;文档 CRUD 入库 SQLite;草稿防丢稿验证通过 | commit v0.2;优先保证编辑器、文档管理、防丢稿可用 |
M2 里程碑(W2 末 D13‑D14) 可演示成品:Electron 桌面窗口打开即可写作;新建/管理文档并入库;崩溃/重启后草稿恢复。 验收标准:
- 桌面窗口主布局完整(文档列表 + 编辑器 + 工具箱占位);
- 文档 CRUD 入库 SQLite,列表排序/过滤正常;
- 防抖自动缓存生效,重启恢复草稿并提示;
- 渲染进程安全基线(contextIsolation / sandbox / nodeIntegration)配置正确;
- 后端随应用启动(遮罩 → 就绪),退出后无残留 java 进程、8080 端口已释放。 Git Tag:v0.2
阶段2|ModelRouter 双模式 + AI 续写 + 快捷处理 W3 D15‑D21|Tag v0.3|里程碑 M3
🟢阶段重点:ModelRouter 唯一大模型出入口,实现 LOCAL(Ollama) / USER_PROVIDED_API 双模式;apiKey 全部从 POST 请求体 modelConfig 读取,不使用 HTTP Header,仅单次请求内存、不落库不落日志;SSE 白名单收敛为 token / error / complete。
| 周 | 天 | 任务内容 | 工时(h) | 产出/验收标准 | 风险 & 应对 |
|---|---|---|---|---|---|
| W3 | D15 | 开发 ModelRouter 骨架:统一调用接口;实现 LOCAL(Ollama) 模式(宿主机 127.0.0.1:11434 / 容器 ollama:11434);SSE 用 SseEmitter 承载,订阅 Spring AI Flux 持 Disposable;约 15s 心跳保活,写失败即判定断连并 dispose 释放资源;WebClient 显式连接/读超时;Ollama 异常翻译(服务连不上/模型不存在/显存不足→业务错误码) | 3 | LOCAL 模式可调用本地模型并 SSE 流式返回;客户端断开后立即 dispose、无后台空跑;异常不抛原始堆栈 | 异常分类映射错误码;SSE 背压与断连释放;Broken pipe 优雅捕获 |
| D16 | 实现 USER_PROVIDED_API 模式:代理转发第三方 OpenAI 兼容接口;apiKey 仅 POST body 局部临时变量,不赋值成员变量、不缓存、不落库;内置 OpenAI/DeepSeek/通义千问 BaseURL 模板;temperature/maxTokens 透传;日志脱敏校验 | 3 | mode=USER_PROVIDED_API 可代理转发并流式返回;日志不输出明文密钥;异常翻译为业务错误码 | 密钥泄露风险;禁止密钥落日志/异常堆栈;单元测试两种模式分支 | |
| D17 | 开发 /api/ai/continue 续写接口:接收 context + genre + targetWords + modelConfig;上文截取合理长度;字数约束拼入提示词;SSE token/complete;前端光标处流式插入,支持接受/撤销/重新生成 |
3 | ★续写流式返回并插入正文;可撤销、可重新生成;超长上文不超上下文 | 提示词工程质量;截断策略(取最近 N 字符);结果可撤销由前端管理 | |
| D18 | 开发 /api/ai/quick 快捷处理接口:expand/condense/restyle/wordcount 四操作;按 genre 映射 restyle 风格提示词;字数约束拼入提示词;前端选中态原地替换,可撤销 |
3 | ★四操作流式返回处理结果;restyle 按文体生效;字数指令生效;替换可撤销 | 提示词四类模板工程质量;后端只返回文本,替换/撤销由前端管理 | |
| D19 | 设置页模型接入:模式单选【本地 Ollama】/【我自己的 API 密钥】;本地模型 3 状态卡片调用 /api/status/local-model(UNAVAILABLE/MODEL_MISSING/READY),不可用时单选置灰;API 表单(服务商下拉、密钥掩码、自定义 BaseURL、模型名);【测试连通性】按钮;全部配置持久化 localStorage、不上传后端 |
3 | ★双模式可切换;本地不可用时置灰并引导;可填自有 API 并测试连通性;密钥仅存本地 | 配置卸载丢失提示备份;连通性测试校验密钥与接口可用性 | |
| D20‑D21 | 周末|阶段2 验收;回归测试:本地模式续写/快捷处理、自有 API 模式续写/快捷处理、密钥安全专项(日志/异常/前端控制台无明文);补齐单元测试;提交代码,打 Git Tag v0.3 | 3 | ★M3:续写 + 快捷处理双模式可用;SSE 白名单无越界;密钥零泄露 | commit v0.3;SSE 断连释放资源;非核心 restyle 风格可后续迭代 |
M3 里程碑(W3 末 D20‑D21) 可演示成品:写作时在光标处续写、框选文字做扩写/精简/换风格/调篇幅;本地模式与自有 API 模式均可切换使用。 验收标准:
- LOCAL 模式续写/快捷处理流式返回正常,异常友好提示;
- USER_PROVIDED_API 模式代理转发正常,密钥仅单次请求内存;
- SSE 事件仅 token / error / complete,无白名单外事件;
- 密钥不落日志、不入异常堆栈、不入库;单元测试两种模式分支通过;
- 设置页双模式切换 + 本地不可用置灰引导 + 连通性测试可用。 Git Tag:v0.3
阶段3|文档版本 + 多格式导出 W4 D22‑D28|Tag v0.4|里程碑 M4
| 周 | 天 | 任务内容 | 工时(h) | 产出/验收标准 | 风险 & 应对 |
|---|---|---|---|---|---|
| W4 | D22 | doc_version 表 + 存版接口:POST /api/documents/{id}/versions 手动存版;GET .../versions 版本列表;content_hash(SHA‑256) 去重,内容未变不落新版本 |
2.5 | 存版接口可用;相同内容不重复落版本;版本列表按时间倒序 | content_hash 计算成本→仅对正文快照计算;长度校验 |
| D23 | 版本对比与回滚:GET .../versions/compare?v1=&v2= 行级 diff(diff-match-patch,不依赖外部命令);POST .../rollback 回滚作为新版本追加,保留历史不可覆写 |
3 | ★双版本行级 diff 返回正确;回滚后旧版本仍保留;回滚生成新版本 | diff 算法工程质量;回滚语义(追加而非覆写)专项测试 | |
| D24 | 前端版本面板:存版按钮、版本列表、双版本 diff 对比视图、一键回滚;会话结束/文档切离时自动存一版(防高频) | 3 | ★版本面板可存版/对比/回滚;自动存版仅在切离/退出触发一次 | diff 视图 UI 如阻塞可降级为简版对比(in‑line 差异着色) | |
| D25 | 导出接口 GET /api/documents/{id}/export?format=md|txt|word:md/txt 直出;word 使用 Apache POI(XWPF)生成 .docx;Content‑Disposition 指定文件名 |
3 | 三种格式导出文件可打开且内容正确;docx 格式正常 | POI 样式局限→基础标题/段落即可,不做复杂排版 | |
| D26 | 前端导出:按文体默认导出格式(网文 txt / 自媒体 md / 公文 word),可覆盖选择;导出文件名带文体扩展名;导出本地流转不上传第三方 | 2 | ★按文体默认格式导出;用户可覆盖选择;文件名正确 | 导出编码问题(UTF‑8/BOM);txt 换行符兼容 | |
| D27‑D28 | 周末|阶段3 验收;写作核心闭环 E2E:写作→存版→对比→回滚→导出;单元+集成测试;修复 bug;提交代码,打 Git Tag v0.4 | 2 | ★M4:写作核心闭环可用;版本去重/回滚/三格式导出验证通过 | commit v0.4;word 高级排版为可选增强,不影响基础导出 |
M4 里程碑(W4 末 D27‑D28) 可演示成品:写完一章可存版、对比历史版本、写坏后一键回滚;成品按文体导出 txt / md / word。 验收标准:
- 存版按 content_hash 去重;版本列表/对比/回滚闭环可用;
- 回滚保留历史不可覆写,作为新版本追加;
- txt / md / word 三种格式导出内容正确、文件可打开;
- 前端按文体默认导出格式,用户可覆盖。 Git Tag:v0.4
阶段4|文体模板 + 大纲 + 灵感 + 素材 W5 D29‑D35|Tag v0.5|里程碑 M5
🟢阶段重点:AI 赋能第二批——多文体一键模板切换、大纲生成与灵感建议、素材收藏与插入;全部为 ModelRouter 单轮调用,不进任何编排。
| 周 | 天 | 任务内容 | 工时(h) | 产出/验收标准 | 风险 & 应对 |
|---|---|---|---|---|---|
| W5 | D29 | 文体模板后端:agent.yml 内联三套文体 system prompt(NOVEL/MEDIA/OFFICIAL,启动加载 + 设置页手动重载,无文件监听);prompt_template 表 + 内置模板种子数据(isSystem 只读);模板 CRUD 接口支持 genre 过滤 |
3 | 三套文体提示词生效并可手动重载;模板列表按 genre 过滤;用户可新增自定义模板 | 提示词工程质量(三套各覆盖多场景指令);不硬编码 Java |
| D30 | 前端文体切换:工具栏文体切换(网文/自媒体/公文/CUSTOM);模板面板(预制+自定义,按 genre 分栏、增删);切换后下一轮 AI 调用携带对应 system prompt;当前文体记忆 localStorage | 2.5 | ★一键切换文体并生效;模板面板可管理自定义模板;切换不影响正文 | UI 与编辑区联动;切换时保留正文不丢失 | |
| D31 | /api/ai/outline 大纲生成:输入 keyPoints + genre,ModelRouter 单轮生成 Markdown 层级大纲(##/###);SSE token/complete;前端解析为大纲树,锚点点击跳转正文 |
3 | ★关键点→结构化大纲流式生成;前端解析为层级列表;点击跳转正文标题 | 大纲格式不稳定→提示词限定严格标题层级;解析容错(非标题行归入上级) | |
| D32 | /api/ai/inspire 灵感建议:按 topic + genre + aspect(TITLE/OPENING/OUTLINE_IDEA) 流式返回建议,供用户挑选插入 |
2.5 | ★灵感建议流式返回;可挑选插入正文 | 建议质量→按 aspect 分别设计提示词 | |
| D33 | 素材收藏后端:material 表 + /api/materials CRUD(genre/kind/content/source 校验入库);content 纯文本,不解析为指令 |
3 | 素材增删改查可用;按 genre 过滤;长度/格式校验生效 | 素材内容防注入(不拼装指令);长度上限 | |
| D34‑D35 | 周末|阶段4 验收;选中文本一键收藏;素材面板按 genre 分栏;点击/拖拽插入正文光标处;模板/大纲/灵感/素材全链路 E2E;提交代码,打 Git Tag v0.5 | 2.5 | ★M5:模板切换、大纲跳转、灵感建议、素材收藏插入全部可用 | commit v0.5;大纲拖拽排序如时间紧张降级为纯展示+跳转 |
M5 里程碑(W5 末 D34‑D35) 可演示成品:一键切换网文/自媒体/公文模板并生效;输入关键点生成可跳转大纲;AI 给出标题/开头灵感;选中文本收藏为素材并插入正文。 验收标准:
- 三套文体模板一键切换,AI 调用携带对应 system prompt;自定义模板按 genre 管理;
- 大纲流式生成并解析为层级列表,点击锚点跳转正文;
- 灵感建议按 aspect 流式返回;
- 素材增删改查、按 genre 归档、选中快速收藏、点击/拖拽插入正文;
- 全部为单轮调用,SSE 复用 token/complete,未新增事件类型。 Git Tag:v0.5
阶段5|全文自检(规则引擎 + LLM + 前端标注) W6 D36‑D42|Tag v0.6|里程碑 M6
🟢阶段重点:
/api/ai/check为普通 JSON 接口(非 SSE);规则引擎(词级,纯函数无 IO)为 v1.0 必做,LLM(语义级)为 P2;LLM 返回非法 JSON 时优雅降级。 ⚠️标红裁剪点(重要):v1.0 不做”实时输入实时标红”。仅当用户点击【全文自检】才执行一次校验并生成 Decoration 标记;用户一旦编辑输入即清空全部标记,再次点击自检才重建。以此规避高频重算 offset 映射的性能开销。
|周|天|任务内容|工时(h)|产出/验收标准|风险 & 应对|
|---|---|---|---|---|
|W6|D36|自检规则引擎:按 genre 加载检规——网文:重复用词(词频/邻近)+ 敏感词词典;自媒体:平淡词库;公文:口语化词典 + 格式正则(段落/序号/标题层级);返回词级问题(type/severity/offset/original/suggestion/replacement);幂等、纯函数、无外部 IO|3|★词级自检返回结构化问题列表;按体裁分别命中对应检规|词典/正则工程质量;偏移基于纯文本投影,前端做 offset ↔ ProseMirror position 映射(03 §1.9)|
||D37|/api/ai/check 接口:规则引擎 + LLM 语义检查(FLAT_BEGIN 开头无吸引力 / LOGIC_GAP 逻辑断层)走 ModelRouter 单轮;LLM JSON 解析容错(非法 JSON 仅返回规则结果不报错);合并返回 issues + summary|3|★语义级问题返回正确;LLM 解析失败优雅降级;接口非 SSE|LLM 输出不稳定→提示词强约束 + 解析容错;超长文本切片分段检查|
||D38|自检标注前端:正文按问题类型标色下划线;悬浮 tooltip 展示原文/建议 + 一键替换;按 genre 自动切换检规展示|3|★标红/下划线定位正确;替换一键生效并可撤销|用 TipTap 装饰(Decoration)实现标红下划线;纯文本 offset ↔ ProseMirror position 映射;替换走 TipTap 事务;替换后重取文本重建映射|
||D39|问题列表与跳转:侧边问题列表点击跳转定位;替换后可撤销;替换后清除过期标记并重新映射;summary 展示|3|★问题列表跳转定位准确;替换后标记正确刷新|大文档性能→问题列表虚拟滚动或分段渲染|
||D40|自检词库/正则外部化到 agent.yml;设置页提供【重载配置】按钮触发检规重载(无文件监听)|2|检规词库可配置并可手动重载生效;配置损坏回滚旧配置|配置加载格式校验;不引入 WatchService 并发复杂度|
||D41‑D42|周末|阶段5 验收;check 全链路 E2E(三 genre 规则命中 + 语义级 + 标红替换);单元+集成测试;提交代码,打 Git Tag v0.6|2|★M6:全文自检标红替换闭环可用;规则引擎 + LLM 合并返回正确|commit v0.6;语义级检查如工期紧可先保证规则引擎(词级)|
M6 里程碑(W6 末 D41‑D42) 可演示成品:写完一键自检,正文问题标红、悬浮给出建议、一键替换;分文体加载不同检规。 验收标准:
- 规则引擎按 genre 命中对应检规(词级问题);
- LLM 语义级问题(开头/逻辑)返回正确,解析失败优雅降级;
- 标红映射、悬浮建议、一键替换、问题列表跳转均可撤销/定位准确;
- 词库/正则外部化到 agent.yml,启动时加载,设置页”重载配置”按钮可刷新生效。 Git Tag:v0.6
阶段6|写作舒适辅助 + 模型参数预设 + 联网素材 W7 D43‑D49|Tag v0.7|里程碑 M7
| 周 | 天 | 任务内容 | 工时(h) | 产出/验收标准 | 风险 & 应对 |
|---|---|---|---|---|---|
| W7 | D43 | 写作舒适辅助(一):护眼暗色完善(Element Plus dark 变量,跟随系统 + 手动切换,灯光色温模拟);打字机专注模式(输入区居中放大、滚动跟随)→ P2 有余力再做 | 3 | ★暗色主题可用;打字机模式如完成则可用;偏好持久化 localStorage | 暗色变量覆盖遗漏→统一走主题变量;打字机为 P2 不阻塞交付 |
| D44 | 写作舒适辅助(二):悬浮字数统计(当前文档总字数 + 当前选中字数),可拖拽、可隐藏,偏好本地持久化 | 2.5 | ★悬浮字数可拖拽/隐藏;文档与选中字数统计准确 | 字数口径只依赖编辑器实时文本,不引入”当日累计”数据模型 | |
| D45 | 模型参数配置:temperature 创意程度滑杆(0‑1)、maxTokens/单次生成字数;保存并切换两套预设(网文预设 / 公文预设);透传后端生效 | 2.5 | ★参数调整生效;双预设保存与一键切换可用 | 字数换算系数;参数越界校验 | |
| D46 | 联网素材开关 + SearchProvider:抽象接口 + 至少实现一个引擎(如 Tavily);useOnlineSearch 接入续写/quick;未配置搜索 key 时开关置灰;搜索失败返回 ERR‑SEARCH‑001 不阻塞主流程;P2 有余力再做(未做则开关始终置灰 + 文档说明) |
3 | ★如完成:联网开关随 key 配置联动、未配置置灰 | 外部依赖可用性;搜索失败降级为仅本地上下文;列为 P2 不阻塞交付 | |
| D47 | 设置页收尾:配置 JSON 导入导出(含密钥,提示妥善保管);FAQ(无需训练模型、费用归属用户、双模式区别);文案通读剔除”训练”字眼 | 2.5 | 配置可导出/导入;FAQ 完整;文案无错误表述 | 导入导出 UI 如阻塞可降级为手动备份 JSON 文档说明 | |
| D48‑D49 | 周末|阶段6 验收;AI 赋能全景 E2E;回归写作核心链路;单元+集成测试;提交代码,打 Git Tag v0.7 | 2 | ★M7:舒适三件套、参数双预设、联网开关全部可用;联网未配置不影响其余功能 | commit v0.7;联网搜索受阻→置灰 + 文档说明,不阻塞交付 |
M7 里程碑(W7 末 D48‑D49) 可演示成品:护眼暗色 / 打字机专注 / 悬浮字数三件套;模型参数双预设一键切换;联网素材开关按配置联动。 验收标准:
- 暗色主题、悬浮字数统计可用且偏好持久化(打字机模式为 P2);
- temperature/maxTokens 透传生效;网文/公文双预设保存切换;
- 联网开关未配置时置灰、搜索失败不阻塞主流程(联网素材为 P2);
- 设置页配置导入导出 + FAQ 文案无”训练模型”错误表述。 Git Tag:v0.7
阶段7|桌面打包交付 + 打磨 + 安全测试 W8 D50‑D56|Tag v1.0|里程碑 M8
🟢正式交付形态 = Windows x64 桌面安装包(Electron + jlink 裁剪 JRE + 后端 jar;进程编排见 03 §6.7);Docker Compose 仅保留为开发调试,端口强制绑定 127.0.0.1。
| 周 | 天 | 任务内容 | 工时(h) | 产出/验收标准 | 风险 & 应对 |
|---|---|---|---|---|---|
| W8 | D50 | 桌面打包交付:electron-builder 出 Windows x64 NSIS 安装包 + 免安装 zip;jlink 裁剪最小 JRE 打入 extraResources;主进程 spawn(java, [--writer.data-dir]) 启动后端 + tree-kill 杀进程树 + 启动遮罩 + 退出优雅停机(03 §6.7);打包后冒烟测试(安装→启动→写作/续写→导出→退出无残留进程、端口释放) |
3 | ★生成的 exe 可安装、可启动、后端随应用拉起、退出无残留进程;数据目录定位正确 | 打包后路径变化→全部用 userData 动态获取;不依赖用户预装 JDK;冒烟测试不可省略;Docker Compose 仅留开发调试 |
| D51 | 全链路前后端完整联调(写作核心 + AI 赋能全部功能);集中 Bug 修复;性能体验优化(大文档编辑、长文滚动、编辑区卡顿) | 3 | ★全部业务流程完整跑通;编辑区长文不卡顿;异常场景友好降级 | 性能瓶颈定位(编辑器渲染/模型调用);编辑器分块/虚拟滚动方案 | |
| D52 | 安全专项测试:密钥泄露(日志/异常/前端控制台)、提示注入(素材/模板不作为指令)、异常边界(Ollama 关停、SQLite 库文件只读/损坏、配置损坏回滚);补齐安全测试用例文档 | 3 | ★安全用例全部通过;无明文密钥泄露;异常场景友好提示不崩溃 | 安全测试用例逐条执行;文档留存 | |
| D53 | 录制完整演示录屏(两条使用路径 + AI 赋能全景);回归全部核心与新增场景(验收清单逐条过) | 2.5 | ★演示录屏覆盖答辩全部功能点;回归无阻塞级缺陷 | 录屏脚本提前列清单;回归用例按 03 §5.4 场景 1‑7(含新增场景 7 桌面进程编排) | |
| D54‑D56 | 收尾阶段|完整交付物产出;完善全套 Markdown 文档(01/02/03/04);README、架构 Mermaid 图、部署文档、两种使用模式帮助文档、故障排查清单、FAQ 认知误区;整理安全测试用例;Git 仓库整理;打最终 Git Tag v1.0;项目交付评审 | 4 | ★M8 v1.0 可交付;全套文档完整;文档全部剔除”训练模型”错误字眼;确认不内置大模型;Git 标签 v0.1‑v1.0 齐全 | 文档完整性;消除用户认知偏差;交付评审核对全部交付物清单 |
M8 里程碑(W8 D54‑D56|最终交付 v1.0) 可演示成品:Windows x64 桌面安装包(内含 jlink 裁剪 JRE + 后端 jar)安装即用;录屏完整演示两条使用路径(自有 API 开箱即用 / 本地 Ollama 离线)与 AI 赋能全部功能。(Docker Compose 仅保留为开发调试方案,非交付形态。) 验收标准:
- Windows x64 安装包可正常安装、启动;后端随应用自动拉起,就绪前显示启动遮罩,退出后无残留 java 进程、8080 端口释放;
- 应用数据(
.db、agent.yml)落在 userData 数据目录,打包成 exe 后路径定位正确;文档清晰区分两条使用路径与数据层部署边界(数据即本地 SQLite 文件);FAQ 消除”应用自带模型、需要训练模型”认知误区;- 架构图、部署文档、故障排查清单、安全测试用例齐全;
- 演示录屏完整覆盖:编辑器 + 防丢稿、文档管理、AI 续写、快捷处理、文体切换、大纲 + 灵感、素材插入、全文自检、舒适辅助、版本回滚、txt/md/word 导出、模型参数双预设、双模式切换;
- 全套四份核心 Markdown 文档完整产出,无 FSM / 审批 / RAG / Redis / Chrome 扩展 等过期表述残留。 Git Tag:v1.0
二、里程碑总览汇总
| 里程碑 | 时间点 | 可演示的最小成品 | 核心验收要点 | 回滚版本 |
|---|---|---|---|---|
| M1 本地模型对话 + 健康探测 | W1 末(D6‑D7) | 调用 Ollama 完成问答;健康接口诊断状态 | 健康 3 状态、日志脱敏、X-Local-Token 校验、SQLite 初始化、最小闭环跑通 | v0.1 |
| M2 桌面壳 + 编辑器 + 文档管理 | W2 末(D13‑D14) | 桌面窗口可写作;文档 CRUD;草稿防丢稿 | 文档入库、防抖缓存恢复、Electron 安全基线、后端随应用拉起且退出无残留进程 | v0.2 |
| M3 双模式 + 续写 + 快捷处理 | W3 末(D20‑D21) | 光标续写;框选扩写/精简/换风格/调篇幅;双模式切换 | SSE 白名单、密钥零泄露、双模式分支 | v0.3 |
| M4 版本 + 导出 | W4 末(D27‑D28) | 存版/对比/回滚;txt/md/word 导出 | content_hash 去重、回滚追加不覆写、POI docx | v0.4 |
| M5 模板 + 大纲 + 灵感 + 素材 | W5 末(D34‑D35) | 文体一键切换;大纲跳转;灵感建议;素材插入 | 单轮调用不进编排、素材防注入、按 genre 归档 | v0.5 |
| M6 全文自检 | W6 末(D41‑D42) | 自检标红并一键替换;分文体检规 | 规则引擎纯函数、LLM 容错降级、偏移映射 | v0.6 |
| M7 舒适辅助 + 参数 + 联网 | W7 末(D48‑D49) | 暗色/悬浮字数(打字机 P2);参数双预设;联网开关(P2) | 偏好持久化、参数透传、联网未配置置灰 | v0.7 |
| M8 可交付桌面成品 | W8(D54‑D56) | Windows x64 桌面安装包(jlink JRE + 后端 jar)安装即用;完整文档 + 演示录屏 | 安装可启动、后端自动拉起、退出无残留进程、数据目录正确、全套四份文档、完整交付物 | v1.0 |
三、文本甘特图
■=开发编码;◆=里程碑验收;空白=无开发任务 |阶段|D1‑D7|D8‑D14|D15‑D21|D22‑D28|D29‑D35|D36‑D42|D43‑D49|D50‑D56| |---|---|---|---|---|---|---|---|---| |阶段0 环境与后端脚手架|■■■■■■■||||||| |阶段1 桌面壳+编辑器+文档||■■■■■■■|||||| |阶段2 双模式+续写+快捷处理|||■■■■■■■||||| |阶段3 版本+导出||||■■■■■■■|||| |阶段4 模板+大纲+灵感+素材|||||■■■■■■■||| |阶段5 全文自检||||||■■■■■■■|| |阶段6 舒适辅助+参数+联网|||||||■■■■■■■| |阶段7 桌面打包交付||||||||■■■■■■■| |M里程碑|M1◆|M2◆|M3◆|M4◆|M5◆|M6◆|M7◆|M8◆|
四、完整风险清单
| 风险分类 | 风险描述 | 潜在影响 | ✅MVP v1.0 应对方案 | 测试手段 | 降级预案 | v1.1 迭代优化 |
|---|---|---|---|---|---|---|
| 安全‑API‑Key 泄露风险 | apiKey 被日志/异常堆栈打印;前端控制台打印;被持久化 | 用户第三方 API 密钥泄露产生非预期费用 | 1.全局日志脱敏过滤器;2.禁止异常堆栈打印原始请求体;3.主/渲染进程禁 console 打印;4.密钥仅单次请求内存,不落库不落日志;5.密钥存 localStorage 不上传后端 | 密钥泄露专项测试;代码评审日志点 | 检测到密钥落库/落日志直接抛内部异常阻断 | v1.1 密钥传输额外加密 |
| 安全‑提示注入风险 | 素材/模板/自检 LLM 返回内容含指令被后端执行 | 越权或异常行为 | 1.素材/模板内容不作为指令解析;2.自检 LLM 结果仅取结构化字段;3.SSE 严格白名单 | 注入用例测试 | 非法内容丢弃,仅用规则引擎结果 | v1.1 输入内容分级过滤 |
| 模型‑双模式适配风险 | Ollama 原生接口与 OpenAI 兼容协议差异;第三方兼容性参差 | 部分服务商转发失败 | 1.ModelRouter 统一适配层;2.内置常见服务商模板 + 自定义 BaseURL;3.异常翻译业务错误码 | 双模式回归;多服务商连通测试 | 仅保证主流 OpenAI 兼容服务商;异常友好提示 | v1.1 增加更多服务商适配 |
| 硬件‑Ollama 依赖风险 | 用户未安装/未启动 Ollama 或未 pull 模型;混淆下载模型=训练模型 | 用户误以为产品不可用而放弃 | 1.健康探测 3 状态(UNAVAILABLE/MODEL_MISSING/READY);2.本地模式不可用置灰禁止选择;3.FAQ/README 反复澄清无需训练;4.推荐模型列表 + 一键复制 pull 命令;5.强引导优先自有 API 模式;6.弱显卡强制 CPU 推理 | 3 状态场景手动测试;弱显卡回归;文案评审 | 优先自有 API 模式;本地模式作为高级可选 | v1.1 图形化模型管理;局域网远端 Ollama |
| 硬件‑模型错配风险 | 盲目下载 7B 大模型,内存不足卡顿/OOM | 本地模式运行异常,误以为 Bug | 1.健康接口给推荐清单;2.文档写明各模型最低内存;3.OOM 错误 SSE 友好提示 | 不同硬件模拟;OOM 场景测试 | 提示切换 1.5b 小模型或自有 API 模式 | v1.1 显卡显存探测精准推荐 |
| AI‑提示词工程质量风险 | 续写/quick/大纲/自检提示词效果不稳定,输出格式不达标 | AI 能力体验差 | 1.提示词全部外部化 agent.yml 便于迭代;2.大纲限定严格标题层级 + 解析容错;3.自检 LLM JSON 强约束 + 降级 | 各能力效果回归;格式解析测试 | 语义级自检降级为规则引擎;大纲非标题行归入上级 | v1.1 提示词版本化与 A/B |
| 前端‑编辑器与偏移映射风险 | 纯文本 offset 与 ProseMirror position 映射不一致;大文档卡顿 | 标红定位错位、编辑卡顿 | 1.采用 TipTap/ProseMirror 成熟位置映射(03 §1.9);2.替换走事务、替换后重取文本重建映射;3.清理过期标记;4.大文档性能优化 | 大文档性能测试;标红替换回归 | 自检定位降级为段落级提示 | v1.1 编辑器性能与偏移体系打磨 |
| 网络‑SSE 流式风险 | SSE 断连、超时、背压;后端流资源未释放造成泄漏 | 流式中断、前后端状态不一致、线程/连接泄漏 | 1.纯 fetch+ReadableStream,禁用 EventSource;2.后端 SseEmitter 持 Spring AI Flux 的 Disposable,~15s 心跳 ping 保活并借写失败检测断连→dispose;3.WebClient 显式连接/读超时;4.Broken pipe 优雅处理;5.前端 AbortController.abort();6.事件白名单 | 模拟断网/弱网/主动中止测试 | 断连友好提示允许重发 | v1.1 断线续传 |
| 数据‑SQLite 并发与损坏风险 | 单库多连接写冲突(database locked)、WAL 膨胀、事务内包 AI 调用拖长事务;库文件损坏或被误删 | 文档与版本丢失、写入失败 | 1.Hikari maximum-pool-size:1;2.连接初始化统一 PRAGMA(WAL/synchronous=NORMAL/busy_timeout=5000/foreign_keys=ON);3.红线:事务内禁网络 IO / AI 调用,禁长事务长读;4.定时 wal_checkpoint(TRUNCATE) 防膨胀;5.单进程独占、备份策略(03 §7.4);6.删除文档事务级联 |
重启后数据回归;并发写入压测;备份还原演练 | 从复制的 .db / VACUUM INTO 快照还原 | v1.1 自动备份与版本化 |
| 外部依赖‑联网素材风险 | 第三方搜索 API 选型不确定、key 未配置或失效 | 联网素材不可用 | 1.SearchProvider 抽象;2.未配置开关置灰;3.搜索失败 ERR‑SEARCH‑001 不阻塞主流程 | 联网开关联动测试;失败降级测试 | 置灰 + 文档说明,不影响其余功能交付 | v1.1 多引擎切换、素材一键收藏 |
| 范围‑工期风险 | 写作核心 + AI 赋能功能较多,业余工时不稳定 | 延期交付 | 1.按 W1‑W8 分阶段排期,每周末可演示 + Git Tag;2.执行裁剪预案(见五);3.弹性 +1 周缓冲 | 每周里程碑验收及时暴露阻塞 | 执行 MVP 裁剪预案,优先保核心闭环 | v1.1 补齐裁剪项 |
| 业务‑费用风险 | 自有 API 模式消耗用户自己额度,用户不知情 | 账单纠纷 | 1.设置页文案明确提示消耗用户自己额度;2.不做自动切换高级模型 | 文案评审;双模式回归 | 默认本地模式;自有 API 由用户主动配置 | v1.1 客户端额度预警阈值 |
| MVP 能力边界风险 | 无登录鉴权;无法按 API‑Key 独立配额统计;无 RAG/多会话 | 用户预期偏差 | 1.文档记录能力边界;2.设置页提示配额到服务商控制台;3.README 显著位置写明 | 文档评审;需求核对 | 能力边界交第三方控制台与文档说明 | v1.1/v1.2 账号体系 + 素材库检索 |
| 进程‑后端生命周期风险(R1) | 关窗后 Java 进程残留、8080 端口被占用、二次启动失败;子进程未被杀成僵尸 | 应用无法再次启动、用户需手动杀进程 | 1.主进程 spawn(java, [...], {shell:false}) 使 java 成为直接子进程;2.tree-kill(Windows taskkill /T /F)兜底杀进程树;3.启动前回收残留 8080;4.监听 exit/close 崩溃自愈重启;5.JVM ShutdownHook + shutdown 端点(仅 127.0.0.1),退出优雅停机失败再强杀 |
打包后冒烟测试(退出无残留进程、端口释放);反复启停回归 | 提示用户手动结束残留 java 进程 | v1.1 更细的进程健康上报 |
| 安全‑本机接口鉴权风险(R3) | localhost 并非安全边界,浏览器网页可跨页发起请求(含 DNS rebinding) | 本机接口被网页滥用、数据被窥探 | 1.启动生成一次性 X-Local-Token 写入 userData 文件→主进程读取→preload 注入渲染进程,token 绝不经过 HTTP;2.业务接口校验否则 401 ERR‑AUTH‑001;3.Host 仅允许 localhost/127.0.0.1;4.CORS 禁 *,精确匹配 file://(Origin: null) 与 dev http://localhost:5173;5.威胁模型仅防跨页攻击,不防本机已有恶意程序 |
401 鉴权用例;跨源请求测试 | 鉴权失败统一 401 友好提示 | v1.1 更严格的来源白名单 |
| 交付‑路径定位风险(R7) | 打包成 exe 后相对路径失效,配置/库文件读写失败 | 安装后应用无法正常读写数据 | 1.主进程以 --writer.data-dir=<userData>/data 注入;2.Java 侧 WriterHome 按”启动参数→env→user.home”解析;3.配置/agent.yml/.db 全落该目录;禁止写死相对路径;4.打包后路径冒烟测试列入交付清单 |
打包后安装测试;多机安装验证 | 回退 user.home 兜底目录 | v1.1 用户自定义数据目录 |
五、MVP 阻塞降级裁剪预案(发生延期风险优先执行,保障 8 周交付核心 v1.0)
当开发阻塞,优先裁剪次要功能,保证核心闭环:编辑器 + 防丢稿、文档管理、AI 续写、快捷处理(quick)、双模式 ModelRouter + 密钥安全、文体模板切换、大纲生成、全文自检(规则引擎)、版本留存、多格式导出、Ollama 健康探测引导。
❌第一档:v1.0 绝对禁止裁剪(MVT 最小可行闭环,无论如何降级必须保留)
- 编辑器 + 防抖自动缓存防丢稿(崩溃/重启恢复草稿)。
- 文档管理 CRUD 入库 SQLite。
- AI 续写 + 选中文字快捷处理(quick 四操作)。
- ModelRouter 双模式(LOCAL Ollama / 用户自有 API);apiKey 仅单次请求内存、日志脱敏、不落库;不使用 HTTP Header 传密钥。
- Ollama 健康探测接口 + 设置页 3 状态 UI 置灰、引导、FAQ 澄清”无需训练模型”。
- 文体模板切换(内置三套)+ 大纲生成。
- 全文自检规则引擎(词级,纯函数无 IO)+ 前端标红替换。
- 文档版本存版 / 对比 / 回滚 + txt / md 导出。
- fetch + ReadableStream SSE(token/error/complete),禁用 EventSource。
- 桌面进程编排:spawn + tree-kill + 启动遮罩 + 优雅停机(否则无法交付可用安装包)。
- X-Local-Token 本机接口鉴权(纵深防御,防跨页攻击)。
⚠️第二档:可降级 / 后置到 P2(v1.1 迭代,阻塞时优先裁剪)
- 联网素材开关 → 外部依赖项:搜索选型受阻时 UI 置灰 + 文档说明;不影响其余功能交付。
- 自检语义级 LLM 检查 → 工期紧时先保证规则引擎(词级);语义级(开头/逻辑)后置 P2。
- 打字机专注模式 → 舒适辅助先保暗色 + 悬浮字数;打字机后置 P2。
- 大纲拖拽排序 → 降级为纯展示 + 点击锚点跳转;拖拽排序后置 P2。
- 灵感建议(inspire) → 优先保证 TITLE/OPENING,OUTLINE_IDEA 后置。
- word 导出高级排版 → 仅基础标题/段落,复杂排版后置 P2。
- 配置导入导出 UI → 裁剪该 UI;设置页文档写明手动备份配置 JSON 步骤。
- 自定义文体模板 → 先保证内置三套(NOVEL/MEDIA/OFFICIAL),自定义模板 CRUD 后置。
- 版本自动存版 → 仅手动存版 + 文档切离/退出自动存一版;高频自动存版后置。
- 配置热加载 → 降级为”启动读取 + 设置页手动重载配置按钮”;砍掉 WatchService 文件监听。
- 单测范围 → 收敛为 3‑5 个关键用例(ModelRouter 分支 / 日志脱敏 / 自检规则引擎 / 文档版本 / offset 映射)。
六、交付物清单 M8 v1.0
- Windows x64 桌面安装包(正式交付形态)
- electron-builder 产出的 NSIS 安装包 + 免安装 zip;
- jlink 裁剪 JRE(约 50‑90MB)打入
extraResources,不依赖用户预装 JDK21; - 主进程 spawn 拉起后端 + tree-kill 杀进程树 + 启动遮罩 + 优雅停机;
- 打包后冒烟测试报告(安装→启动→写作/续写→导出→退出无残留进程、端口释放)。
- Git 源代码仓库
- Spring Boot 后端完整工程(ModelRouter 双模式、AI 赋能服务、文档/版本/模板/素材四表持久化、自检规则引擎);
- Electron 桌面壳前端工程(Vue3 + Element Plus + TipTap 编辑器内核,electron-builder 打包);
- Git 标签:v0.1 ~ v1.0;
- 配置资源
- docker-compose.yml / docker-compose.dev.yml(仅开发调试,非交付形态);
- agent.yml(含三套文体 system prompt、续写/quick/outline/inspire 提示词、自检词库与正则);落于应用数据目录;
- SQLite 四表建表 SQL / Flyway 迁移脚本;
- 全套核心 Markdown 文档(4 份)
01-需求文档.md:产品需求、用户故事、非功能需求、迭代路线;02-接口文档.md:REST/SSE 接口(含续写/quick/outline/inspire/check/documents/versions/materials/templates)、请求响应样例、SSE 事件、错误码;03-生产规范.md:编码规范、安全红线、测试规范、部署规范、运维、发布流程、安全检查清单;04-带时间的工作计划表.md:即本文档;
- 辅助文档
- README.md 快速启动(Windows x64 安装指引);
- 系统架构 Mermaid 图;
- 部署文档(含桌面安装包安装 / 升级 / 数据目录说明);
- 故障排查清单;
- API 简要说明文档;
- 安全测试用例文档;
- CHANGELOG 版本变更日志;
- 演示材料:完整演示录屏,覆盖两条使用路径与 AI 赋能全部核心点。
七、进度管控规则
- 周末固定验收机制:每个周末(D6‑D7 / D13‑D14 / D20‑D21 / D27‑D28 / D34‑D35 / D41‑D42 / D48‑D49 / D55‑D56)必须完成本阶段的演示、单元测试、bug 修复、打 Tag;不把阶段债务堆积到最后一周。
- 阻塞上报机制:如果某一项任务预估超出计划工时 >50%,立刻触发降级预案,评估是否裁剪次要功能,不硬扛。
- 弹性缓冲:整体预留 +1 周全局弹性窗口,若多个阶段阻塞,优先整体后移,而不是随意砍掉核心功能。
- 安全优先原则:密钥安全、SSE 白名单、配置回滚、防丢稿为红线,不允许为赶工期做简化;非核心 UI、美化、次要分支可降级后置。
- 每阶段必须保留可运行版本:即使部分功能未做完,Git Tag 对应的版本必须可以启动、可以演示,拒绝提交无法运行的半成品 Tag。
- 外部依赖评审:联网素材等外部依赖必须在引入前确认可用性;未确认前一律置灰,禁止以”占位实现”冒充功能。
八、v1.0 与后续迭代路线图
🚩v1.0(8 周,当前排期,必须落地)
码字工具为本体:Electron 桌面壳(编辑器 + 防丢稿自动缓存 + 文档管理 + 舒适辅助 + 版本留存 + 多格式导出); AI 为赋能:续写、选中文字快捷处理(扩写/精简/换风格/调篇幅)、大纲与灵感、素材收藏插入、全文自检、文体模板; 模型接入:ModelRouter 双模式(用户自有 API / 本地 Ollama)+ Ollama 健康探测 + 模型参数预设;SQLite 四表持久化。
❗重要对外宣传 & 文档声明:
- 应用本身不包含、不打包大模型;
- 本地 Ollama 模式需要用户自己安装 Ollama 并下载已经预训练完成的开源模型;不需要训练模型;
- 不想折腾软件安装,直接填入自有 API-Key 即可完整使用全部功能;
- 文档/版本/模板/素材存本机 SQLite 单文件(数据即本地文件);无需安装数据库服务,建议定期复制该
.db文件备份;- v1.0 无法做按用户 API-Key 独立配额统计,配额请去第三方服务商控制台查看;
- 联网素材需第三方搜索 API(外部依赖),未配置时开关置灰,不影响其他功能;
- v1.0 不提供多 Agent 自动编排、本地文档 RAG、多会话隔离;
- 平台声明:v1.0 桌面安装包仅交付 Windows x64(Windows 10/11),macOS / Linux 不在 v1.0 范围内;安装包内置 jlink 裁剪 JRE,用户无需预装 JDK。
🚩v1.1(v1.0 完成后迭代,预计额外 2‑3 周,不纳入 v1.0 排期)
- 素材库检索:以本地向量检索形式回归(替代原重型 RAG)。
- 导出扩展(PDF / HTML);批量文档管理增强。
- 支持配置局域网远端 Ollama 地址,把本地模型部署在高性能局域网设备。
- 补齐 v1.0 裁剪项:自检语义级检查完善、大纲拖拽排序、自定义模板 CRUD、配置导入导出 UI。
- 联网素材多引擎切换、素材一键直存收藏区。
- AI 生成中断:续写 / 快捷处理支持停止生成(前端 AbortController + 后端按 requestId 显式取消并 dispose 流),半成品默认丢弃后可重新生成。
🚩v1.2(远期独立分支)
云端同步 / 多设备草稿同步:剥离本地文件与本地模型能力,独立分支维护,避免与本地优先主产品架构互相拖累。