# 单次摘要：模型输入、覆盖范围与归档

本文描述 v0.10.0 的 `single-request` 实现，不代表正式发布已完成或已安装的 DSH 已更新。使用入口见[使用说明](<../README.md>)；历史验证仍保留在[验收记录](<ACCEPTANCE.md>)。

## 默认与请求边界

- [宿主](<../src/host.mjs>)默认计划器固定 `strategy:"single-request"`，输入预算默认 64000 字节，重规划范围 4000–64000；UI 没有切换 full 策略的选项。预算是含提示、JSON 包装及路由预留的 UTF-8 保守估算，不是 token 或实际网络请求长度。小预算可能连必要统计都放不下，规划会失败。
- 一次明确确认生成恰好一份模型 payload；插件不自动拆分，不在同次生成中派发第二次 `llm.stream`，失败不自动重试。显式重试须重新确认且可能再次计费。不能用插件调用数推断供应商计费或保证底层适配器没有重试。
- [库级计划器](<../src/analysis.mjs>)仍默认 `strategy:"full"`、24000 字节，并支持全量分片；这不是当前宿主/UI 默认。历史 full 测试不能替代单次摘要验收。

## 完整本地清单不等于模型全文

[摘要构造器](<../src/single-request.mjs>)先解析完整已采集差异及上下文，建立本地路径、状态、字节、哈希、范围及来源清单，再选取有限模型证据：

1. 每个项目的必要统计、固定端点与清单哈希先进入请求。必要统计装不下时拒绝规划，不静默删项目。
2. 各仓库及单独上下文通道轮转分配剩余预算；文件按生成物标志、路径/扩展名优先级与路径排序。接口目录、头文件、源码、配置等优先级只是确定性启发式，不是完整依赖分析或语义重要性判断。
3. 文件元数据也受预算约束，完整清单中的部分路径可能完全没有文件专属证据发给模型。被选文件仅可能附带差异块或上下文的有限前缀，单片前缀最多 1024 UTF-16 单元，还可能因预算更短；不是完整文件，也不是所有 hunk。
4. 生成物通过扩展名等路径模式识别，不读取其用途作语义判断；识别为生成物或二进制的正文不发送，生成物元数据也可能未入选。没有被识别成生成物不证明它一定是源码。

发送前核对 `fullManifestFiles`、`sentFileCount`、`sentTextFileCount`、`omittedFileCount`、`generatedFileCount`、上下文计数与 `sentSourceBytes`。`originalSourceBytes`/`decodedSourceBytes` 是解码后 UTF-8 文本口径，包含上下文时也计入上下文，不是远端原始传输字节。`processed`、`cited` 只统计已发送摘要证据；不能称为全部代码已理解。未发送内容无法支持“没有接口变化”“无风险”或完整跨仓调用关系结论。哈希与合法引用只证明身份/定位，不证明结论正确。

## 主报告与完整证据保存

[报告生成器](<../src/report.mjs>)在单次摘要模式下输出固定端点、哈希、本地文件清单及文件证据/正文发送标记，不内嵌全部 diff。成功的模型报告正文采用短数字引用，不在每条结论前重复“分片 1”或原始证据 ID；两份默认折叠的技术附录保留完整清单、实际发送的摘要/原文片段正文、证据 ID、source 与 block 哈希及 UTF-16 字符起止偏移；偏移不是源码行号或字节位置，合成统计也不等于原文件。默认计划器即使规划失败也使用本地 compact manifest，不回退嵌入巨量 diff；库级自定义 full 调用另论。保留已发送证据便于核对，不把它扩展为全部差异归档。

完整 snapshot 只保存在宿主预览内存中：开始分析前 TTL 为 10 分钟，重规划不续期；释放、淘汰、重启都会丢失，成功生成会删除预览。报告恢复缓存只保留报告，不等于恢复完整证据。当前 UI 没有完整快照自动落盘或导出按钮；需要证据归档时，必须在释放或过期前由操作者通过明确授权的本地流程另存原始快照/差异，并核对固定端点与哈希。只下载摘要 Markdown、保存配置或保留哈希不能重建原文。

## v0.10.0 当前验证进度

本版使用精确 JSON 分块遍历统计 snapshot 字节与 SHA-256，保持普通捕获快照的 JSON.stringify 字节口径和既有计划身份，避免旧统计/哈希路径构造巨大 JSON 副本。约 369 MB 历史快照在原生 Electron 的无模型 preview/generate 已通过，无 OOM，2727 路径、计划身份及 62760 字节估算保持一致。v0.10.0 本地全量 299/299（45.823 秒）、静态 84 文件、同构建浏览器 41/41（64.623 秒）与精确打包/production-only 隔离安装已通过。fresh 原生同进程 production collect 四项目＋官方 LlmRuntime 已成功，无 bridge/replay、无 OOM：snapshot 368989806 字节、2734 路径；计划 62750/64000 字节，消息 58905 字节，真实模型 1 次，48 项证据、29 项被引用，23 个文件元数据、21 个正文片段、2711 个文件未发专属证据，原文片段 17644 字节。默认报告 475022 字节、主文 77 行、附录折叠；roundtrip/幂等恢复/重复 generate 后仍为 1 次模型调用，源仓库 config/index、凭据与用户配置未变。初次验收脚本的 e- 检测过宽，误匹配合法 evidence- 引用；错误留档后仅离线修正测试并续验，未重发、重采或改写报告。独立 coverage 全量 299/299，通过已加载文件行 98.97%、分支 91.64%、函数 97.88%，非全仓 JSX。该原生成功不等于当前 GUI 已安装验收或模型语义质量证明，正式发布仍待远端 CI。实际 HTML 阅读附件已验证桌面 1440px/手机 390px 无整页溢出、2 附录默认关闭、86 个安全引用可展开对应附录，无 script/img/外部请求，正文无原始技术 ID；独立 CSS 的首次漏 wrap 已仅在附件中修复，生产源码原已有 wrap，未改变生产构建。最终构建身份见验收记录，历史构建数字不混用。该改进不消除快照本体等资源开销，不承诺任意规模无 OOM，不自动归档，也不意味着当前 GUI 已更新。

以下保留改进前的过程证据，不把旧回放和旧构建数字沿用为 v0.10.0 最终通过。

## 改进前过程记录

2026-11-04，本轮实际四项目采集已成功：路径数 266 + 28 + 2354 + 79 = 2727；diff 合计 363937169 字节，序列化 snapshot 368977331 字节（约 369 MB，十进制）。这些是采集记录，不是单次摘要输入大小。此前 full 策略在 64000 字节预算下计划 7193 次调用，不代表已执行这些调用。

采集阶段为 0 次模型调用。后续已在同一固定快照完成真实 single-request：计划估算 62760 字节，向官方 `gpt/gpt6.1sol` 路由实际派发 1 次，正常 stop，48 项证据的五组结构化结果及引用通过程序校验。发送 23 个文件专属元数据，其中 21 个带正文片段；2704 个文件没有发送文件专属证据。已发送文件也不是全文已读，程序验证不等于报告业务结论正确。

本次验收根目录为 G:/C3Engine_3。原 870172 字节报告已逐字节备份为 `配置驱动发布报告-技术证据.md`；主文件 `配置驱动发布报告-单次分析.md` 现为 4851 字节可读正文，另生成独立 `配置驱动发布报告-阅读版.html`。这是原有结果的本地整理，没有新增模型调用、重新采集或修改配置；完整 snapshot 已由操作者另存，不是插件 UI 自动归档。只读恢复/结果重放额外模型调用为 0。独立 HTML 经桌面/移动视口核对，显示 2 个表格，无编码实体/原始证据 ID 干扰、无外部请求或整页横向溢出；不将它视为当前 DSH GUI 已更新。本文不复制业务差异正文。

**改进前运行限制：** 桌面 Electron 直接载入约 369 MB snapshot 曾在派发前 OOM，该次为 0 调用。成功路径使用 Node 8 GB 堆的大证据父进程，经过官方 Electron 紧凑 LLM bridge 发送预算内 payload，并通过 host capture seam 回放已采集固定 snapshot。它证明这一受控回放与真实接口生成成功，不是当前 GUI 原生采集到大快照再生成的端到端验收，不证明宿主原生内存问题已解决；未据此放行安装版、安装或重启宿主。

浏览器夹具另有 40/40 通过（约 1.8 分钟），包括原 39 项与单次摘要合同、预算/覆盖提示、确认重置、只读恢复不重复派发。该轮 sourceHash 为 `d27614c704e16f749cd994f025dc0b6e1aac065634200a8466f9c5e73f6b5a23`，clientHash 为 `2eefa26e8de39875ea13b823424f413817649210842266455881a462812176a0`；它不证明真实压缩算法、付费请求统计或后续源码均已重测。compact fallback、证据正文附录修改后的本地全量回归 280/280 通过，129.7 秒，静态解析 78 文件通过；这是该轮源码证据，后续内存优化不自动沿用。浏览器该轮来自这些修改之前的 bundle，仅归为 UI 合同验证，不能挂作最终 host 源码浏览器实测。宿主内存改进仍在进行，不预填为已解决。

后续阅读体验修正的本地全量回归 295/295 通过（51.4 秒），静态解析 82 文件通过；同构建浏览器 41/41 通过（约 1.2 分钟），sourceHash：`88f9245b3a6466ce56ea8317174240896f85c4f417409e055d4bd9e56923e1d4`，clientHash：`77bfc956b716b4c5db1087e8a267c74f4aa3f14630ac2dde839a27d49c17318c`。新增安全语义 viewer 验证标题/列表/表格、数字实体仅转文本、代码原样、技术附录及原始 Markdown 默认关闭，危险内容保持 literal 且不发外部请求，下载 Markdown 字节不变。模型输入为夹具，不是实际模型结论质量、已安装 GUI 或原生 OOM 修复证明。