14 lines
2.3 KiB
Markdown
14 lines
2.3 KiB
Markdown
# 工程解析缓存与来源核对
|
|
|
|
1.19在已有ProjectIndex内扩展持久复用。缓存对象是当前用户所选项目的声明、导入、派生签名和文件元数据;不保存模型Key、请求正文、设备身份、审批、工具副作用或检查结果。工程源码、原工件和Task账本仍是依据与恢复来源。
|
|
|
|
每次查询先建立当前有界源码SHA快照,再按项目/工作区身份、Git HEAD/分支、解析器/格式修订/分析预算及文件SHA/访问身份选择解析材料。导入目标根据当前文件集重新计算。返回前用文件句柄再核对源码字节、名称集和Git身份;两次观察间检测到变化即拒绝返回/保存,用户可重新刷新。任何快照只说明记录时的读取范围,不能证明之后的文件永远不变;精确补丁仍需当前SHA。
|
|
|
|
权限/链接变化和不完整扫描不会保留旧缓存结果。部分扫描只重新分析当前可读范围,界面显示范围不完整。Python是声明候选,不是编译器结果;JS/TS静态AST不证明运行时模块解析。缓存不会生成「检查通过」或补造工具结果。
|
|
|
|
内存和磁盘各最多8个项目、32MiB,单项目派生数据最多8MiB;按最近使用淘汰。缓存文件有格式、结构与摘要校验,损坏/超限/不可用时从当前源码重建。目录联接、软/硬链接缓存文件拒绝使用;清除仅删除本项目摘要命名的派生文件。宿主数据下cache/project-index/settings.json仅保存enabled,重启保持开关。禁用后不载入/保存缓存,已有派生文件可单独清除。
|
|
|
|
在「工程索引 → 解析缓存」查看上次核对时间、命中/重新解析、失效原因、容量和耗时,并管理本机开关与本项目清除。清除后保留上次检索结果及其时间,下一次查询重建;不会伪造新的核对时间。运行诊断仅显示状态,不发起新的检索。手机观察、审批和停止权限没有缓存管理或上传权限。
|
|
|
|
本地复用主要减少跨实例的解析工作,不保证所有工程或每次请求更快。每次来源读取、闭合核对和派生存储都有开销。冷/热/失效比较及Node/React/Python实际工具链见[QA-1.19](QA-1.19.md)。本地复用、上游prompt缓存与实际token计费分别记录,只有服务实际报告的用量才能登记为上游缓存用量。
|