3.0 KiB
3.0 KiB
B03 资料研究
职责与对象
外部与私人资料、榜单观察、原文和参考作品分析。
实例归属以总体架构为准；结构、状态和公开外壳分别引用数据模型与接口契约。
公开接口
| 用例 | 输入责任 | 输出与后果 |
|---|---|---|
| import_source | 来源身份、内容、用途和导入选项 | 原文版本与处理任务 |
| capture_ranking | 登记来源、榜种和采集请求 | 带采集时刻及质量状态的快照 |
| start_analysis | 固定原文、范围、结构和预算 | 可恢复拆书任务 |
| read_evidence | 来源版本与位置 | 原文片段及校验信息 |
| select_analysis | 分析版本和作者用途 | 选用记录及方法或设定交接 |
所有接口在本模块的接口.py 暴露。输入输出类型由同一公开表面导出，外部不导入私有模型或 SQL。
内部职责
| 文件 | 职责 |
|---|---|
| 接口.py | 资料研究公开用例和可导入合同 |
| 模型.py | 资料研究稳定对象、外壳及内部状态 |
| 存储.py | 资料研究所属记录的 SQL 与版本读写 |
| 来源导入.py | 文件、网页、笔记和灵感导入 |
| 原文版本.py | 原文保留、来源位置及不可变版本 |
| 文本清理.py | 噪声清理候选和原文保护 |
| 分章切窗.py | 分章、窗口划分及输入漂移 |
| 榜单快照.py | 来源、时间、质量、排名及观察差异 |
| 样本选题.py | 样本比较、选题依据及选书交接 |
| 拆书分析.py | 章节、阶段、实体与写法分析 |
| 实体归并.py | 参考作品内专名、别名及歧义 |
| 分析版本.py | 分窗成果、修复、重算与版本选用 |
| 提示词/分析参考作品.md | 参考作品分析任务模板 |
| 提示词/核对实体歧义.md | 疑似同名和别名核对模板 |
完整路径及运行模板见目标文件清单。逐文件意图、边界与目标见文件合同。
实现约束
- 原文与分析分开版本化，清理产生对照结果而不抹掉旧原文。
- 分窗任务绑定固定输入；输入漂移不得接着向旧分析版本写结果。
- 名称与别名归并保留歧义及证据，同名不能直接合并。
- 榜单失败保留失败状态，不能让模型记忆补成实时事实；榜单名次不直接归因到最近一次 run。
协作与失败
来源读取实现由基础设施注入；任务归 S02，方法候选转 B04，本书设定候选转 B02，统一检索交 B09。
来源不可用、分章歧义、窗失败和部分完成分别可见；修复仅重做选定失败范围。
验收行为
- 原文版本改变不覆盖旧引文。
- 分窗失败可续跑且不重复出卡。
- 同名实体不误合并。
- 选题依据与资料来源可回查。
验收入口和替换条件见迁移与验收；这些条目是目标行为，不是已通过测试的声明。