← 返回学习路线

SYSTEM

桌面智能创作助手(码字工具)|带时间的工作计划表

QuillAgent文档
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 安装包)

时间说明:

  1. D1=项目第 1 自然天,D56=项目第 56 自然天;
  2. 周内工作日执行开发编码;周末(D6‑D7 / D13‑D14 / D20‑D21 / D27‑D28 / D34‑D35 / D41‑D42 / D48‑D49 / D55‑D56)执行阶段验收、集成测试、文档编写、bug 集中修复;
  3. 工时单位 h,为预估总投入工时;业余模式拆分为每日 1‑2h 执行;
  4. 整体预留 +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 最小闭环跑通。 验收标准:

  1. curl 调用后端接口返回正常回答;
  2. 健康接口返回 3 状态(UNAVAILABLE / MODEL_MISSING / READY),返回推荐模型与复制 pull 命令;
  3. 日志层脱敏生效,不打印明文密钥;业务接口缺 X-Local-Token 返回 401;
  4. SQLite 初始化成功(四表建表脚本可执行,库文件生成于应用数据目录);
  5. 端到端最小闭环跑通:前端触发 → 后端落库 → 调 Ollama → SSE 流回前端插入;
  6. 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 桌面窗口打开即可写作;新建/管理文档并入库;崩溃/重启后草稿恢复。 验收标准:

  1. 桌面窗口主布局完整(文档列表 + 编辑器 + 工具箱占位);
  2. 文档 CRUD 入库 SQLite,列表排序/过滤正常;
  3. 防抖自动缓存生效,重启恢复草稿并提示;
  4. 渲染进程安全基线(contextIsolation / sandbox / nodeIntegration)配置正确;
  5. 后端随应用启动(遮罩 → 就绪),退出后无残留 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 模式均可切换使用。 验收标准:

  1. LOCAL 模式续写/快捷处理流式返回正常,异常友好提示;
  2. USER_PROVIDED_API 模式代理转发正常,密钥仅单次请求内存;
  3. SSE 事件仅 token / error / complete,无白名单外事件;
  4. 密钥不落日志、不入异常堆栈、不入库;单元测试两种模式分支通过;
  5. 设置页双模式切换 + 本地不可用置灰引导 + 连通性测试可用。 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。 验收标准:

  1. 存版按 content_hash 去重;版本列表/对比/回滚闭环可用;
  2. 回滚保留历史不可覆写,作为新版本追加;
  3. txt / md / word 三种格式导出内容正确、文件可打开;
  4. 前端按文体默认导出格式,用户可覆盖。 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 给出标题/开头灵感;选中文本收藏为素材并插入正文。 验收标准:

  1. 三套文体模板一键切换,AI 调用携带对应 system prompt;自定义模板按 genre 管理;
  2. 大纲流式生成并解析为层级列表,点击锚点跳转正文;
  3. 灵感建议按 aspect 流式返回;
  4. 素材增删改查、按 genre 归档、选中快速收藏、点击/拖拽插入正文;
  5. 全部为单轮调用,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) 可演示成品:写完一键自检,正文问题标红、悬浮给出建议、一键替换;分文体加载不同检规。 验收标准:

  1. 规则引擎按 genre 命中对应检规(词级问题);
  2. LLM 语义级问题(开头/逻辑)返回正确,解析失败优雅降级;
  3. 标红映射、悬浮建议、一键替换、问题列表跳转均可撤销/定位准确;
  4. 词库/正则外部化到 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) 可演示成品:护眼暗色 / 打字机专注 / 悬浮字数三件套;模型参数双预设一键切换;联网素材开关按配置联动。 验收标准:

  1. 暗色主题、悬浮字数统计可用且偏好持久化(打字机模式为 P2);
  2. temperature/maxTokens 透传生效;网文/公文双预设保存切换;
  3. 联网开关未配置时置灰、搜索失败不阻塞主流程(联网素材为 P2);
  4. 设置页配置导入导出 + 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 仅保留为开发调试方案,非交付形态。) 验收标准:

  1. Windows x64 安装包可正常安装、启动;后端随应用自动拉起,就绪前显示启动遮罩,退出后无残留 java 进程、8080 端口释放;
  2. 应用数据(.db、agent.yml)落在 userData 数据目录,打包成 exe 后路径定位正确;文档清晰区分两条使用路径与数据层部署边界(数据即本地 SQLite 文件);FAQ 消除”应用自带模型、需要训练模型”认知误区;
  3. 架构图、部署文档、故障排查清单、安全测试用例齐全;
  4. 演示录屏完整覆盖:编辑器 + 防丢稿、文档管理、AI 续写、快捷处理、文体切换、大纲 + 灵感、素材插入、全文自检、舒适辅助、版本回滚、txt/md/word 导出、模型参数双预设、双模式切换;
  5. 全套四份核心 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 最小可行闭环,无论如何降级必须保留)

  1. 编辑器 + 防抖自动缓存防丢稿(崩溃/重启恢复草稿)。
  2. 文档管理 CRUD 入库 SQLite。
  3. AI 续写 + 选中文字快捷处理(quick 四操作)。
  4. ModelRouter 双模式(LOCAL Ollama / 用户自有 API);apiKey 仅单次请求内存、日志脱敏、不落库;不使用 HTTP Header 传密钥。
  5. Ollama 健康探测接口 + 设置页 3 状态 UI 置灰、引导、FAQ 澄清”无需训练模型”。
  6. 文体模板切换(内置三套)+ 大纲生成。
  7. 全文自检规则引擎(词级,纯函数无 IO)+ 前端标红替换。
  8. 文档版本存版 / 对比 / 回滚 + txt / md 导出。
  9. fetch + ReadableStream SSE(token/error/complete),禁用 EventSource。
  10. 桌面进程编排:spawn + tree-kill + 启动遮罩 + 优雅停机(否则无法交付可用安装包)。
  11. X-Local-Token 本机接口鉴权(纵深防御,防跨页攻击)。

⚠️第二档:可降级 / 后置到 P2(v1.1 迭代,阻塞时优先裁剪)

  1. 联网素材开关 → 外部依赖项:搜索选型受阻时 UI 置灰 + 文档说明;不影响其余功能交付。
  2. 自检语义级 LLM 检查 → 工期紧时先保证规则引擎(词级);语义级(开头/逻辑)后置 P2。
  3. 打字机专注模式 → 舒适辅助先保暗色 + 悬浮字数;打字机后置 P2。
  4. 大纲拖拽排序 → 降级为纯展示 + 点击锚点跳转;拖拽排序后置 P2。
  5. 灵感建议(inspire) → 优先保证 TITLE/OPENING,OUTLINE_IDEA 后置。
  6. word 导出高级排版 → 仅基础标题/段落,复杂排版后置 P2。
  7. 配置导入导出 UI → 裁剪该 UI;设置页文档写明手动备份配置 JSON 步骤。
  8. 自定义文体模板 → 先保证内置三套(NOVEL/MEDIA/OFFICIAL),自定义模板 CRUD 后置。
  9. 版本自动存版 → 仅手动存版 + 文档切离/退出自动存一版;高频自动存版后置。
  10. 配置热加载 → 降级为”启动读取 + 设置页手动重载配置按钮”;砍掉 WatchService 文件监听。
  11. 单测范围 → 收敛为 3‑5 个关键用例(ModelRouter 分支 / 日志脱敏 / 自检规则引擎 / 文档版本 / offset 映射)。

六、交付物清单 M8 v1.0

  1. Windows x64 桌面安装包(正式交付形态)
    • electron-builder 产出的 NSIS 安装包 + 免安装 zip;
    • jlink 裁剪 JRE(约 50‑90MB)打入 extraResources,不依赖用户预装 JDK21;
    • 主进程 spawn 拉起后端 + tree-kill 杀进程树 + 启动遮罩 + 优雅停机;
    • 打包后冒烟测试报告(安装→启动→写作/续写→导出→退出无残留进程、端口释放)。
  2. Git 源代码仓库
    • Spring Boot 后端完整工程(ModelRouter 双模式、AI 赋能服务、文档/版本/模板/素材四表持久化、自检规则引擎);
    • Electron 桌面壳前端工程(Vue3 + Element Plus + TipTap 编辑器内核,electron-builder 打包);
    • Git 标签:v0.1 ~ v1.0;
  3. 配置资源
    • docker-compose.yml / docker-compose.dev.yml(仅开发调试,非交付形态);
    • agent.yml(含三套文体 system prompt、续写/quick/outline/inspire 提示词、自检词库与正则);落于应用数据目录;
    • SQLite 四表建表 SQL / Flyway 迁移脚本;
  4. 全套核心 Markdown 文档(4 份)
    • 01-需求文档.md:产品需求、用户故事、非功能需求、迭代路线;
    • 02-接口文档.md:REST/SSE 接口(含续写/quick/outline/inspire/check/documents/versions/materials/templates)、请求响应样例、SSE 事件、错误码;
    • 03-生产规范.md:编码规范、安全红线、测试规范、部署规范、运维、发布流程、安全检查清单;
    • 04-带时间的工作计划表.md:即本文档;
  5. 辅助文档
    • README.md 快速启动(Windows x64 安装指引);
    • 系统架构 Mermaid 图;
    • 部署文档(含桌面安装包安装 / 升级 / 数据目录说明);
    • 故障排查清单;
    • API 简要说明文档;
    • 安全测试用例文档;
    • CHANGELOG 版本变更日志;
  6. 演示材料:完整演示录屏,覆盖两条使用路径与 AI 赋能全部核心点。

七、进度管控规则

  1. 周末固定验收机制:每个周末(D6‑D7 / D13‑D14 / D20‑D21 / D27‑D28 / D34‑D35 / D41‑D42 / D48‑D49 / D55‑D56)必须完成本阶段的演示、单元测试、bug 修复、打 Tag;不把阶段债务堆积到最后一周。
  2. 阻塞上报机制:如果某一项任务预估超出计划工时 >50%,立刻触发降级预案,评估是否裁剪次要功能,不硬扛。
  3. 弹性缓冲:整体预留 +1 周全局弹性窗口,若多个阶段阻塞,优先整体后移,而不是随意砍掉核心功能。
  4. 安全优先原则:密钥安全、SSE 白名单、配置回滚、防丢稿为红线,不允许为赶工期做简化;非核心 UI、美化、次要分支可降级后置。
  5. 每阶段必须保留可运行版本:即使部分功能未做完,Git Tag 对应的版本必须可以启动、可以演示,拒绝提交无法运行的半成品 Tag。
  6. 外部依赖评审:联网素材等外部依赖必须在引入前确认可用性;未确认前一律置灰,禁止以”占位实现”冒充功能。

八、v1.0 与后续迭代路线图

🚩v1.0(8 周,当前排期,必须落地)

码字工具为本体:Electron 桌面壳(编辑器 + 防丢稿自动缓存 + 文档管理 + 舒适辅助 + 版本留存 + 多格式导出); AI 为赋能:续写、选中文字快捷处理(扩写/精简/换风格/调篇幅)、大纲与灵感、素材收藏插入、全文自检、文体模板; 模型接入:ModelRouter 双模式(用户自有 API / 本地 Ollama)+ Ollama 健康探测 + 模型参数预设;SQLite 四表持久化。

❗重要对外宣传 & 文档声明:

  1. 应用本身不包含、不打包大模型;
  2. 本地 Ollama 模式需要用户自己安装 Ollama 并下载已经预训练完成的开源模型;不需要训练模型;
  3. 不想折腾软件安装,直接填入自有 API-Key 即可完整使用全部功能;
  4. 文档/版本/模板/素材存本机 SQLite 单文件(数据即本地文件);无需安装数据库服务,建议定期复制该 .db 文件备份;
  5. v1.0 无法做按用户 API-Key 独立配额统计,配额请去第三方服务商控制台查看;
  6. 联网素材需第三方搜索 API(外部依赖),未配置时开关置灰,不影响其他功能;
  7. v1.0 不提供多 Agent 自动编排、本地文档 RAG、多会话隔离;
  8. 平台声明:v1.0 桌面安装包仅交付 Windows x64(Windows 10/11),macOS / Linux 不在 v1.0 范围内;安装包内置 jlink 裁剪 JRE,用户无需预装 JDK。

🚩v1.1(v1.0 完成后迭代,预计额外 2‑3 周,不纳入 v1.0 排期)

  1. 素材库检索:以本地向量检索形式回归(替代原重型 RAG)。
  2. 导出扩展(PDF / HTML);批量文档管理增强。
  3. 支持配置局域网远端 Ollama 地址,把本地模型部署在高性能局域网设备。
  4. 补齐 v1.0 裁剪项:自检语义级检查完善、大纲拖拽排序、自定义模板 CRUD、配置导入导出 UI。
  5. 联网素材多引擎切换、素材一键直存收藏区。
  6. AI 生成中断:续写 / 快捷处理支持停止生成(前端 AbortController + 后端按 requestId 显式取消并 dispose 流),半成品默认丢弃后可重新生成。

🚩v1.2(远期独立分支)

云端同步 / 多设备草稿同步:剥离本地文件与本地模型能力,独立分支维护,避免与本地优先主产品架构互相拖累。