开发文档
这组文档面向维护者和开发者,记录当前项目的有效架构、运行链路、日志诊断约定和测试方法。涉及实现与本文档不一致时,应先核对代码与最近一次需求,再同步修正文档,避免继续引用已经失效的阶段性设计。
文档列表
| 文档 | 内容 |
|---|---|
| 开发环境与命令 | 依赖版本、构建、GUI/CLI 调试和测试命令 |
| 架构总览 | 目录职责、核心模块、GUI/CLI 总体分层图 |
| 业务流程 | Workflow、抓取分派、任务类型差异和生成流程 |
| 前端 / Electron / 后端分工 | Electron 窗口与桥接、前端页面状态流、IPC 边界 |
| 数据与日志 | SQLite、按日日志、会话错误、事件契约、诊断表和书籍级输出历史 |
| 测试与 Fixture | 测试分层、fixture 更新、Cookie、隔离和结果判定 |
| 维护注意事项 | 修改 IPC、日志、测试和文档时的同步清单 |
七张核心流程图索引
本轮链路梳理以七张图为边界;不同知乎任务类型不重复绘图,统一使用分派图和差异表表达。
| 编号 | 流程图 | 所在文档 |
|---|---|---|
| 1 | GUI、CLI 与后端总体分层 | 架构总览 |
| 2 | Electron 启动、窗口与桥接关系 | 前端 / Electron / 后端分工 |
| 3 | 前端页面、状态与 IPC 调用 | 前端 / Electron / 后端分工 |
| 4 | RunTaskWorkflow 命令时序 | 业务流程 |
| 5 | 任务分派、分页、扩展与持久化 | 业务流程 |
| 6 | 读取、排序、分卷与三格式输出 | 业务流程 |
| 7 | 日志汇聚与故障定位 | 数据与日志 |