stratagate-dsh 0.3.40 → 0.3.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/CHANGELOG.md +732 -732
  2. package/CONTRIBUTING.md +99 -88
  3. package/CONTRIBUTING.zh-CN.md +90 -88
  4. package/LICENSE +21 -21
  5. package/README.md +510 -489
  6. package/README.zh-CN.md +514 -493
  7. package/benchmarks/locomo-conv26-r8-final.json +146 -146
  8. package/cordis.patch.yml +16 -16
  9. package/dist/client.d.ts +1 -1
  10. package/dist/client.js +1 -1
  11. package/dist/index.js.map +1 -1
  12. package/dist/plugin.js +130 -49
  13. package/dist/plugin.js.map +1 -1
  14. package/dist/repair-profile.js +0 -0
  15. package/dist/repair-profile.js.map +1 -1
  16. package/docs/ARCHITECTURE.md +282 -282
  17. package/docs/DSH.md +337 -337
  18. package/docs/DSH.zh-CN.md +325 -325
  19. package/docs/EVALUATION.md +189 -189
  20. package/docs/EXTERNAL_MEMORY_IMPORT.zh-CN.md +99 -99
  21. package/docs/MEMORY_TOPICS.zh-CN.md +51 -51
  22. package/docs/benchmarks/issue-128-windows-review.json +104 -104
  23. package/docs/benchmarks/issue-128-windows.json +103 -103
  24. package/docs/database-access.md +32 -32
  25. package/docs/dreaming-agent.md +69 -69
  26. package/docs/event-extractor.md +48 -48
  27. package/docs/feedback.md +50 -50
  28. package/docs/issue-128-lease-cache-review-followup.md +55 -55
  29. package/docs/issue-128-review-followup.md +58 -58
  30. package/docs/knowledge-graph.md +38 -38
  31. package/docs/npm-release.md +55 -53
  32. package/docs/surface-maintenance.md +36 -36
  33. package/docs/user-operation-priority.md +46 -39
  34. package/docs/validation/issue119-after.json +30 -0
  35. package/docs/validation/issue119-before.json +94 -0
  36. package/docs/validation/issue119.md +41 -41
  37. package/docs/validation/workspace-cleanup-20261020.md +36 -36
  38. package/package.json +256 -255
  39. package/packages/core/examples/basic.ts +87 -87
  40. package/packages/core/src/blocks.ts +442 -442
  41. package/packages/core/src/weights.ts +21 -21
  42. package/screenshots.json +8 -8
@@ -1,51 +1,51 @@
1
- # 记忆目录与主题整合
2
-
3
- 本次实现两项能力:默认可见的记忆目录,以及按需展开的跨事件主题概览。经验提炼不在本次范围内。
4
-
5
- ## 使用方式
6
-
7
- - 用户画像继续单独常驻。默认目录提供 Chapter 标题、description 和按稳定顺序排列的 Section 标题,并保留主题编号;不注入 `.0` / overview 正文。
8
- - 目录只用于导航;主题概览把已有事件整理为背景、进展、决定、变化和待确认问题,每段保留事件来源。
9
- - 一个 Topic 对应长期的大章节,例如“StrataGate”“求职与职业发展”。节是能持续容纳同类事件的长期类别,例如“缺陷排查与修复”“版本发布与安装”“架构与配置决策”;单个 bug、版本、日期、任务和处理状态留在节内总览与原事件,不独立成节。已有类别能容纳时复用原标题,同类不同状态或不同版本不再拆节。分类随章的实际内容归纳,不套全局固定表,不设硬节数上限;归类不改变任何事件事实。
10
- - 小节归属单独保存在 `sections` 的标题与事件编号中;总览只概括内容并保留各段自己的证据引用。同一章内同名小节及总览按全半角、大小写和空白规范化匹配,与段落类型无关。新总览的展示标题必须匹配本轮声明或继承的小节;省略标题时,其类型对应的默认名称也必须匹配,模型解析和显式 `sections` 写入共用同一校验。总览不能自行建立无事件的小节;旧快照及无 `sections` 的旧 SDK 调用仍按来源和类型名称恢复,有效旧总览可原样保留。节的 `.0 总览` 按各段最早来源在章节中的位置排序并原样展示内容,同位置按最晚来源位置及稳定内容排序;`.1~N` 分页展示归入该节的事件,不要求总览引用每条事件。没有总览的小节仍展示事件,界面不显示空的 `.0 总览`。
11
- - 新模型结果必须为每条本批章节成员分配至少一个小节;总览可为空,旧小节归属和有效概要由存储层继承。只有本批事件可按显式新归属重新分类;非本批旧事件确认某条关系时,保留其其他小节归属。存储层先确定最终小节,再处理总览:重分类使旧小节没有事件时,丢弃对应旧总览,包括本轮原样回传的旧段;新总览指向已消失的小节则拒绝整次写入。小节仍有成员时继续保留有效旧总览,不为保存总览恢复已移走的事件归属。界面“待归类事件”只包含本章尚无小节归属的事件,与未被概括的事件数量分别计算。旧快照按已有总览来源恢复确定的小节归属;0.3.3 首次 writer 打开时,为已完成整理但仍缺少小节关系的旧事件排队一次定向补归类,包括此前已持久化 `sections` 的候选数据。补归类按原章分批,只更新该章的小节成员关系,保留章 ID、章名、描述、成员顺序、已知归属和有效总览,不重新提取事件。某事件属于多个章时逐章补齐;没有总览也必须写入真实归属。迁移标记及剩余关系持久化,重启不反复排队;只读访问不启动补归类。旧 SDK 调用缺少 `sections` 时仍兼容普通整理,补归类任务必须提供显式 `sections`。
12
- - 旧事件补归类复用历史整理后台,全库每 10 分钟最多 2 个历史任务,不重置已有额度;新增或修改的事件仍走优先增量路径。模型不可用或额度耗尽时暂留待归类,后台恢复后继续。工作单位是“章节、事件、来源版本”的关系:一个章节等待重试或耗尽重试不会阻止其他章节补齐同一事件。每个任务最多 3 次尝试,失败可通过现有“重新整理”入口发起新的有限周期;重启不会自动清零重试。目录保留未完成关系数及失败关系数,不把多个章节的关系压成一个事件来判断结算;仍有其他关系待处理时显示处理中,只剩终态失败关系时返回 `failed` 并显示未完成和重新整理入口,不报全部完成,也不保持正在处理的轮询状态。遗忘、归档或来源修改会撤销旧版本的补归类关系及过期结果。为控制输入,补归类候选省略旧总览,最多显示 120 个且合计不超过 4,000 字符的完整小节标题,明确提供省略数量;原章必须在实际模型输入中,不能静默裁掉或改分到其他章。
13
- - 小节按其成员在章内成员列表中的最早位置排序,不跟随模型输出段落的先后顺序;同位置用稳定节编号排序。已有成员在前、新事件追加在后,因此新事件形成的新节置后,旧节不会因为新总览前置而改号。更新后的目录视图版本使旧编号及分页缓存失效。
14
- - 主模型按需打开主题,再通过现有事件、图谱或原文工具取证,继续使用现有证据检查与采用流程。
15
- - 现有自动召回继续工作,目录与概览不能成为唯一检索入口。
16
-
17
- 工具按需要选择:`memory_list_topics` 浏览或查询目录;需要主题脉络时用 `memory_expand_topic` 查看概览,需要事实证据时可直接用 `memory_search_events(query, topic_id)` 核实事件,再进入既有证据评估与采用流程。前两个工具不生成证据批次。空查询可浏览主题事件,使用返回的 `nextOffset` 继续分页;`temporalIntent` 可选择最早或最新记录。
18
-
19
- ## 范围与维护
20
-
21
- - 目录覆盖当前命名空间内可见的对话事件和主动记忆,含没有图谱节点的事件。
22
- - 图谱展示聚类只是可选分组线索,不能将不相连节点的展示拼组当作语义主题。
23
- - 后台用已有事件分批整理历史,后续只处理内容、状态或关联变化。检索时间、采用次数和衰减不触发重新生成。
24
- - 首次写连接打开命名空间时,固定已有历史事件的版本清单,持久记录“待处理 → 处理中 → 已完成”;新命名空间冻结空集合并直接完成,随后新增事件都按增量处理。关闭或重启后接着处理未完成批次,已成功批次和主题编号保留;整理器版本升级时才开启新的回填清单。并发打开沿用先成功保存的清单,只读访问不初始化、不迁移。
25
- - 整个数据库的历史回填每 10 分钟最多启动 2 批,每批最多 12 条事件。额度在调用前持久预扣,各命名空间共用,重启不重置,失败重试也占额度;达到上限后保留简略入口,下一窗口继续。这个上限约束后台整理任务,模型桥内部的格式重试和适配器降级仍分别有固定上限,并不承诺固定金额。新增或语义变化的事件优先整理,不占历史额度。旧章因某条来源或背景依赖变化而整章失效时,其余未变化成员的重建必须共用这份历史额度,不能变成无限制增量任务。重建版本单独持久记录,不改写首次打开冻结的历史清单;旧测试版已失效的积压也保守归入历史额度。
26
- - 每轮最多尝试 3 次,失败等待至少 30 / 60 秒,历史额度不足时等待更久。用尽次数后停止自动重试。用户可在历史整理的失败详情中选择“重新整理这 N 条”:仅将该批当前有效来源排队为新一轮,仍占共享历史额度;成功批次不重做。来源变化、遗忘、过期目录及重复提交均不能强行复用旧失败;新任务编号拒绝旧结果。排队和进度持久保存,重启不重置预算。“已完成”表示本轮任务已结算,不代表所有批次成功。
27
- - 本次主题整理器升级到第 3 代。首次写连接打开第 2 代目录时,保留来源及依赖仍有效的章 ID、章名、成员顺序和创建时间,清空旧细节小节与旧派生任务/进度,冻结当时可见事件按新规则重新分批整理;节及节内编号会因本次重新分组更新。第 1 代碎章及混合/未知代目录仍整体退休,依赖已变化或隐藏的旧章语言不沿用。全程不修改事件、原文、图谱或采用记录,也不重置全库历史额度;新增及发生变化的事件继续优先。只读访问仅在内存预览:保留有效第 2 代章的导航,隐藏旧小节并保留事件入口;不启动历史整理、不写库。第 1 代旧目录仍隐藏。第 3 代成功进度和编号在重启后保留,不反复重建。
28
- - 旧章候选仍最多 12 个,排序结合全部已有节标题以及少量成员标题和标签。每个已展示候选提供全部轻量节标题、最多 4 段正文;节标题不授予未展示事件的引用权限。提示要求可容纳新事项时逐字复用已有节标题,不近义改名。同名章在已展示候选中唯一匹配时复用编号;全局已有同名正式章但未展示时拒绝结果,不静默创建重复章,显式改名也不能撞上另一章;不同项目仍独立归类,不引入永久跨章合并机制。
29
- - 失效只标记一次。模型遗漏主题编号时,存储层为明确的成员延续复用编号;无法唯一对应的旧失效主题,在所有仍可见成员成功处理后移除。分批成功进度不会被旧主题再次清零,过期模型结果仍拒绝。
30
- - 每章每次模型响应最多 8 段概要;这限制单次输出,不是累计段数或节数上限。有效旧段自动保留,不被新段挤掉;同名段仍聚合成一个节。章节累计内容与全量 JSON 存储的增量化另行跟踪。
31
- - 每批模型输入及输出有固定上限,调用有超时、有限重试和重启恢复;主模型上下文组装只读取目录。
32
- - 尚未整理和暂时失败的事件仍提供可验证的简略入口,不阻塞普通检索。
33
- - 每批最多整理 12 个事件,候选旧主题最多 12 个,模型输入含结构约束不超过约 20,000 词元。每段概览注明来源;主题展开限制约 2,400 词元。展开结果优先保留轻量 `sections` 索引(标题和 `sourceEventCount`),包括无总览的小节,并用 `totalSections`、`omittedSections` 说明省略范围;索引、概要、省略计数和外层响应共用预算。全量小节成员关系只在服务端分页,不加入模型展开结果。
34
- - 主题目录按偏好与要求、决定与计划、工作与结果、交流与协作、其他经历分类;分类仅用于浏览,不改变主题内容和编号。完整目录每页最多 20 项。
35
- - 正式主题按创建时间从早到晚排列,新增主题追加;同一时刻仅以不可变的主题编号排序,改名不改变章序。注入目录、主题工具与界面共用这一顺序,待整理入口置后,展示章号不写入数据库。
36
- - Dashboard 只返回主题、节、总览段落及事件数量,不返回事件成员编号、全量标题或摘要;Bootstrap 失败详情也只传数量。完整成员关系保留在服务端。节编号由规范化标题派生,界面与分页共用同一聚合规则。展开节、待整理或失败详情时,用只读接口每页最多读取 9 条事件;数据版本变化时丢弃旧页。同类型但不同标题仍是不同节,同名段落合为一个节。
37
- - 目录默认预算不超过 400 个估算词元,原相关记忆预算为 900 词元。超预算时先预留分类、`memory_list_topics(category, offset)` 分页和 `memory_expand_topic(id)` 小节入口;优先保留章标题与 description,再逐轮为各章加入小节标题。章信息仍放不下时优先保留各分类的章入口,必要时省略 description;全部输出共用预算,未展示的章和小节可继续按需浏览。
38
-
39
- ## 必须始终成立
40
-
41
- 1. 事件和原文是证据底座,目录与概览不写回为新事件,不登记采用证据,不强化记忆。
42
- 2. 主题编号独立于展示聚类成员;每条可见目录文字和概览都有可验证的来源依赖。
43
- 3. 来源被遗忘、归档、撤销或修改后,旧派生文字先停止曝光,后台再重建。不能通过原始对话重新总结来复活已隐藏的事件。
44
- 4. 模型结果提交前重新核对读取时的来源版本;过期任务不能覆盖新版主题。
45
- 5. 主题只在当前命名空间可见;安装级画像不自动并入项目主题。
46
- 6. 历史、计划、取消、争议和当前事实不能在整合时混为一谈;缺少信息保留为待确认问题。
47
- 7. 升级、失败和重启不会修改或删除已有事件、图谱和原始对话;目录可独立重建。
48
-
49
- ## 验收
50
-
51
- 验证模糊查询发现主题、无图谱事件覆盖、按主题取证、增量整合与稳定编号、隐藏来源即时失效、过期提交拒绝、零采用强化、命名空间隔离、旧库升级、重启恢复、有限重试、输入和目录预算,以及后台失败时原搜索继续可用。测试只使用临时数据库与模拟模型。
1
+ # 记忆目录与主题整合
2
+
3
+ 本次实现两项能力:默认可见的记忆目录,以及按需展开的跨事件主题概览。经验提炼不在本次范围内。
4
+
5
+ ## 使用方式
6
+
7
+ - 用户画像继续单独常驻。默认目录提供 Chapter 标题、description 和按稳定顺序排列的 Section 标题,并保留主题编号;不注入 `.0` / overview 正文。
8
+ - 目录只用于导航;主题概览把已有事件整理为背景、进展、决定、变化和待确认问题,每段保留事件来源。
9
+ - 一个 Topic 对应长期的大章节,例如“StrataGate”“求职与职业发展”。节是能持续容纳同类事件的长期类别,例如“缺陷排查与修复”“版本发布与安装”“架构与配置决策”;单个 bug、版本、日期、任务和处理状态留在节内总览与原事件,不独立成节。已有类别能容纳时复用原标题,同类不同状态或不同版本不再拆节。分类随章的实际内容归纳,不套全局固定表,不设硬节数上限;归类不改变任何事件事实。
10
+ - 小节归属单独保存在 `sections` 的标题与事件编号中;总览只概括内容并保留各段自己的证据引用。同一章内同名小节及总览按全半角、大小写和空白规范化匹配,与段落类型无关。新总览的展示标题必须匹配本轮声明或继承的小节;省略标题时,其类型对应的默认名称也必须匹配,模型解析和显式 `sections` 写入共用同一校验。总览不能自行建立无事件的小节;旧快照及无 `sections` 的旧 SDK 调用仍按来源和类型名称恢复,有效旧总览可原样保留。节的 `.0 总览` 按各段最早来源在章节中的位置排序并原样展示内容,同位置按最晚来源位置及稳定内容排序;`.1~N` 分页展示归入该节的事件,不要求总览引用每条事件。没有总览的小节仍展示事件,界面不显示空的 `.0 总览`。
11
+ - 新模型结果必须为每条本批章节成员分配至少一个小节;总览可为空,旧小节归属和有效概要由存储层继承。只有本批事件可按显式新归属重新分类;非本批旧事件确认某条关系时,保留其其他小节归属。存储层先确定最终小节,再处理总览:重分类使旧小节没有事件时,丢弃对应旧总览,包括本轮原样回传的旧段;新总览指向已消失的小节则拒绝整次写入。小节仍有成员时继续保留有效旧总览,不为保存总览恢复已移走的事件归属。界面“待归类事件”只包含本章尚无小节归属的事件,与未被概括的事件数量分别计算。旧快照按已有总览来源恢复确定的小节归属;0.3.3 首次 writer 打开时,为已完成整理但仍缺少小节关系的旧事件排队一次定向补归类,包括此前已持久化 `sections` 的候选数据。补归类按原章分批,只更新该章的小节成员关系,保留章 ID、章名、描述、成员顺序、已知归属和有效总览,不重新提取事件。某事件属于多个章时逐章补齐;没有总览也必须写入真实归属。迁移标记及剩余关系持久化,重启不反复排队;只读访问不启动补归类。旧 SDK 调用缺少 `sections` 时仍兼容普通整理,补归类任务必须提供显式 `sections`。
12
+ - 旧事件补归类复用历史整理后台,全库每 10 分钟最多 2 个历史任务,不重置已有额度;新增或修改的事件仍走优先增量路径。模型不可用或额度耗尽时暂留待归类,后台恢复后继续。工作单位是“章节、事件、来源版本”的关系:一个章节等待重试或耗尽重试不会阻止其他章节补齐同一事件。每个任务最多 3 次尝试,失败可通过现有“重新整理”入口发起新的有限周期;重启不会自动清零重试。目录保留未完成关系数及失败关系数,不把多个章节的关系压成一个事件来判断结算;仍有其他关系待处理时显示处理中,只剩终态失败关系时返回 `failed` 并显示未完成和重新整理入口,不报全部完成,也不保持正在处理的轮询状态。遗忘、归档或来源修改会撤销旧版本的补归类关系及过期结果。为控制输入,补归类候选省略旧总览,最多显示 120 个且合计不超过 4,000 字符的完整小节标题,明确提供省略数量;原章必须在实际模型输入中,不能静默裁掉或改分到其他章。
13
+ - 小节按其成员在章内成员列表中的最早位置排序,不跟随模型输出段落的先后顺序;同位置用稳定节编号排序。已有成员在前、新事件追加在后,因此新事件形成的新节置后,旧节不会因为新总览前置而改号。更新后的目录视图版本使旧编号及分页缓存失效。
14
+ - 主模型按需打开主题,再通过现有事件、图谱或原文工具取证,继续使用现有证据检查与采用流程。
15
+ - 现有自动召回继续工作,目录与概览不能成为唯一检索入口。
16
+
17
+ 工具按需要选择:`memory_list_topics` 浏览或查询目录;需要主题脉络时用 `memory_expand_topic` 查看概览,需要事实证据时可直接用 `memory_search_events(query, topic_id)` 核实事件,再进入既有证据评估与采用流程。前两个工具不生成证据批次。空查询可浏览主题事件,使用返回的 `nextOffset` 继续分页;`temporalIntent` 可选择最早或最新记录。
18
+
19
+ ## 范围与维护
20
+
21
+ - 目录覆盖当前命名空间内可见的对话事件和主动记忆,含没有图谱节点的事件。
22
+ - 图谱展示聚类只是可选分组线索,不能将不相连节点的展示拼组当作语义主题。
23
+ - 后台用已有事件分批整理历史,后续只处理内容、状态或关联变化。检索时间、采用次数和衰减不触发重新生成。
24
+ - 首次写连接打开命名空间时,固定已有历史事件的版本清单,持久记录“待处理 → 处理中 → 已完成”;新命名空间冻结空集合并直接完成,随后新增事件都按增量处理。关闭或重启后接着处理未完成批次,已成功批次和主题编号保留;整理器版本升级时才开启新的回填清单。并发打开沿用先成功保存的清单,只读访问不初始化、不迁移。
25
+ - 整个数据库的历史回填每 10 分钟最多启动 2 批,每批最多 12 条事件。额度在调用前持久预扣,各命名空间共用,重启不重置,失败重试也占额度;达到上限后保留简略入口,下一窗口继续。这个上限约束后台整理任务,模型桥内部的格式重试和适配器降级仍分别有固定上限,并不承诺固定金额。新增或语义变化的事件优先整理,不占历史额度。旧章因某条来源或背景依赖变化而整章失效时,其余未变化成员的重建必须共用这份历史额度,不能变成无限制增量任务。重建版本单独持久记录,不改写首次打开冻结的历史清单;旧测试版已失效的积压也保守归入历史额度。
26
+ - 每轮最多尝试 3 次,失败等待至少 30 / 60 秒,历史额度不足时等待更久。用尽次数后停止自动重试。用户可在历史整理的失败详情中选择“重新整理这 N 条”:仅将该批当前有效来源排队为新一轮,仍占共享历史额度;成功批次不重做。来源变化、遗忘、过期目录及重复提交均不能强行复用旧失败;新任务编号拒绝旧结果。排队和进度持久保存,重启不重置预算。“已完成”表示本轮任务已结算,不代表所有批次成功。
27
+ - 本次主题整理器升级到第 3 代。首次写连接打开第 2 代目录时,保留来源及依赖仍有效的章 ID、章名、成员顺序和创建时间,清空旧细节小节与旧派生任务/进度,冻结当时可见事件按新规则重新分批整理;节及节内编号会因本次重新分组更新。第 1 代碎章及混合/未知代目录仍整体退休,依赖已变化或隐藏的旧章语言不沿用。全程不修改事件、原文、图谱或采用记录,也不重置全库历史额度;新增及发生变化的事件继续优先。只读访问仅在内存预览:保留有效第 2 代章的导航,隐藏旧小节并保留事件入口;不启动历史整理、不写库。第 1 代旧目录仍隐藏。第 3 代成功进度和编号在重启后保留,不反复重建。
28
+ - 旧章候选仍最多 12 个,排序结合全部已有节标题以及少量成员标题和标签。每个已展示候选提供全部轻量节标题、最多 4 段正文;节标题不授予未展示事件的引用权限。提示要求可容纳新事项时逐字复用已有节标题,不近义改名。同名章在已展示候选中唯一匹配时复用编号;全局已有同名正式章但未展示时拒绝结果,不静默创建重复章,显式改名也不能撞上另一章;不同项目仍独立归类,不引入永久跨章合并机制。
29
+ - 失效只标记一次。模型遗漏主题编号时,存储层为明确的成员延续复用编号;无法唯一对应的旧失效主题,在所有仍可见成员成功处理后移除。分批成功进度不会被旧主题再次清零,过期模型结果仍拒绝。
30
+ - 每章每次模型响应最多 8 段概要;这限制单次输出,不是累计段数或节数上限。有效旧段自动保留,不被新段挤掉;同名段仍聚合成一个节。章节累计内容与全量 JSON 存储的增量化另行跟踪。
31
+ - 每批模型输入及输出有固定上限,调用有超时、有限重试和重启恢复;主模型上下文组装只读取目录。
32
+ - 尚未整理和暂时失败的事件仍提供可验证的简略入口,不阻塞普通检索。
33
+ - 每批最多整理 12 个事件,候选旧主题最多 12 个,模型输入含结构约束不超过约 20,000 词元。每段概览注明来源;主题展开限制约 2,400 词元。展开结果优先保留轻量 `sections` 索引(标题和 `sourceEventCount`),包括无总览的小节,并用 `totalSections`、`omittedSections` 说明省略范围;索引、概要、省略计数和外层响应共用预算。全量小节成员关系只在服务端分页,不加入模型展开结果。
34
+ - 主题目录按偏好与要求、决定与计划、工作与结果、交流与协作、其他经历分类;分类仅用于浏览,不改变主题内容和编号。完整目录每页最多 20 项。
35
+ - 正式主题按创建时间从早到晚排列,新增主题追加;同一时刻仅以不可变的主题编号排序,改名不改变章序。注入目录、主题工具与界面共用这一顺序,待整理入口置后,展示章号不写入数据库。
36
+ - Dashboard 只返回主题、节、总览段落及事件数量,不返回事件成员编号、全量标题或摘要;Bootstrap 失败详情也只传数量。完整成员关系保留在服务端。节编号由规范化标题派生,界面与分页共用同一聚合规则。展开节、待整理或失败详情时,用只读接口每页最多读取 9 条事件;数据版本变化时丢弃旧页。同类型但不同标题仍是不同节,同名段落合为一个节。
37
+ - 目录默认预算不超过 400 个估算词元,原相关记忆预算为 900 词元。超预算时先预留分类、`memory_list_topics(category, offset)` 分页和 `memory_expand_topic(id)` 小节入口;优先保留章标题与 description,再逐轮为各章加入小节标题。章信息仍放不下时优先保留各分类的章入口,必要时省略 description;全部输出共用预算,未展示的章和小节可继续按需浏览。
38
+
39
+ ## 必须始终成立
40
+
41
+ 1. 事件和原文是证据底座,目录与概览不写回为新事件,不登记采用证据,不强化记忆。
42
+ 2. 主题编号独立于展示聚类成员;每条可见目录文字和概览都有可验证的来源依赖。
43
+ 3. 来源被遗忘、归档、撤销或修改后,旧派生文字先停止曝光,后台再重建。不能通过原始对话重新总结来复活已隐藏的事件。
44
+ 4. 模型结果提交前重新核对读取时的来源版本;过期任务不能覆盖新版主题。
45
+ 5. 主题只在当前命名空间可见;安装级画像不自动并入项目主题。
46
+ 6. 历史、计划、取消、争议和当前事实不能在整合时混为一谈;缺少信息保留为待确认问题。
47
+ 7. 升级、失败和重启不会修改或删除已有事件、图谱和原始对话;目录可独立重建。
48
+
49
+ ## 验收
50
+
51
+ 验证模糊查询发现主题、无图谱事件覆盖、按主题取证、增量整合与稳定编号、隐藏来源即时失效、过期提交拒绝、零采用强化、命名空间隔离、旧库升级、重启恢复、有限重试、输入和目录预算,以及后台失败时原搜索继续可用。测试只使用临时数据库与模拟模型。
@@ -1,104 +1,104 @@
1
- {
2
- "baselineSha": "e954eaf2f2cbbef4bb6226a2ebb35191424868c2",
3
- "sourceSha": "415096f19d09d9bcc29c44634c7ae78fd6c2f52d",
4
- "capturedAt": "2026-10-10T11:22:46.467Z",
5
- "scope": "Synthetic DSH runtime on Windows; not the user database or full DSH UI process.",
6
- "scenarios": [
7
- {
8
- "name": "small",
9
- "namespaces": 100,
10
- "rawUserCharsPerNamespace": 8192,
11
- "databaseBytes": 8941568,
12
- "rounds": 3,
13
- "intervalMs": 3000,
14
- "measurements": {
15
- "before": {
16
- "pollsMs": [
17
- 2035.9983000000002,
18
- 2204.014,
19
- 2077.0357000000004
20
- ],
21
- "meanPollMs": 2105.682666666667,
22
- "fullMemoryLoads": 300,
23
- "cpuMs": 3015,
24
- "wallMs": 15335.1882,
25
- "processCpuPercent": 19.660665136147465,
26
- "rssBefore": 56864768,
27
- "rssAfter": 73207808,
28
- "peakRss": 74285056,
29
- "node": "v24.19.0",
30
- "platform": "win32",
31
- "arch": "x64",
32
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
33
- },
34
- "after": {
35
- "pollsMs": [
36
- 32.8809,
37
- 5.330300000000079,
38
- 2.298700000000281
39
- ],
40
- "meanPollMs": 13.503300000000118,
41
- "fullMemoryLoads": 0,
42
- "cpuMs": 31,
43
- "wallMs": 9071.7334,
44
- "processCpuPercent": 0.3417208005693818,
45
- "rssBefore": 56606720,
46
- "rssAfter": 54337536,
47
- "peakRss": 57950208,
48
- "node": "v24.19.0",
49
- "platform": "win32",
50
- "arch": "x64",
51
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
52
- }
53
- }
54
- },
55
- {
56
- "name": "large",
57
- "namespaces": 100,
58
- "rawUserCharsPerNamespace": 1572864,
59
- "databaseBytes": 1519824896,
60
- "rounds": 3,
61
- "intervalMs": 3000,
62
- "measurements": {
63
- "before": {
64
- "pollsMs": [
65
- 12951.9511,
66
- 8731.1299,
67
- 9476.834900000005
68
- ],
69
- "meanPollMs": 10386.638633333334,
70
- "fullMemoryLoads": 300,
71
- "cpuMs": 24844,
72
- "wallMs": 40200.4599,
73
- "processCpuPercent": 61.80028801113292,
74
- "rssBefore": 56283136,
75
- "rssAfter": 157401088,
76
- "peakRss": 332111872,
77
- "node": "v24.19.0",
78
- "platform": "win32",
79
- "arch": "x64",
80
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
81
- },
82
- "after": {
83
- "pollsMs": [
84
- 29.53,
85
- 3.372899999999845,
86
- 2.309900000000198
87
- ],
88
- "meanPollMs": 11.737600000000015,
89
- "fullMemoryLoads": 0,
90
- "cpuMs": 109,
91
- "wallMs": 9061.4375,
92
- "processCpuPercent": 1.2028996503038287,
93
- "rssBefore": 52092928,
94
- "rssAfter": 51056640,
95
- "peakRss": 54579200,
96
- "node": "v24.19.0",
97
- "platform": "win32",
98
- "arch": "x64",
99
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
100
- }
101
- }
102
- }
103
- ]
104
- }
1
+ {
2
+ "baselineSha": "e954eaf2f2cbbef4bb6226a2ebb35191424868c2",
3
+ "sourceSha": "415096f19d09d9bcc29c44634c7ae78fd6c2f52d",
4
+ "capturedAt": "2026-10-10T11:22:46.467Z",
5
+ "scope": "Synthetic DSH runtime on Windows; not the user database or full DSH UI process.",
6
+ "scenarios": [
7
+ {
8
+ "name": "small",
9
+ "namespaces": 100,
10
+ "rawUserCharsPerNamespace": 8192,
11
+ "databaseBytes": 8941568,
12
+ "rounds": 3,
13
+ "intervalMs": 3000,
14
+ "measurements": {
15
+ "before": {
16
+ "pollsMs": [
17
+ 2035.9983000000002,
18
+ 2204.014,
19
+ 2077.0357000000004
20
+ ],
21
+ "meanPollMs": 2105.682666666667,
22
+ "fullMemoryLoads": 300,
23
+ "cpuMs": 3015,
24
+ "wallMs": 15335.1882,
25
+ "processCpuPercent": 19.660665136147465,
26
+ "rssBefore": 56864768,
27
+ "rssAfter": 73207808,
28
+ "peakRss": 74285056,
29
+ "node": "v24.19.0",
30
+ "platform": "win32",
31
+ "arch": "x64",
32
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
33
+ },
34
+ "after": {
35
+ "pollsMs": [
36
+ 32.8809,
37
+ 5.330300000000079,
38
+ 2.298700000000281
39
+ ],
40
+ "meanPollMs": 13.503300000000118,
41
+ "fullMemoryLoads": 0,
42
+ "cpuMs": 31,
43
+ "wallMs": 9071.7334,
44
+ "processCpuPercent": 0.3417208005693818,
45
+ "rssBefore": 56606720,
46
+ "rssAfter": 54337536,
47
+ "peakRss": 57950208,
48
+ "node": "v24.19.0",
49
+ "platform": "win32",
50
+ "arch": "x64",
51
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
52
+ }
53
+ }
54
+ },
55
+ {
56
+ "name": "large",
57
+ "namespaces": 100,
58
+ "rawUserCharsPerNamespace": 1572864,
59
+ "databaseBytes": 1519824896,
60
+ "rounds": 3,
61
+ "intervalMs": 3000,
62
+ "measurements": {
63
+ "before": {
64
+ "pollsMs": [
65
+ 12951.9511,
66
+ 8731.1299,
67
+ 9476.834900000005
68
+ ],
69
+ "meanPollMs": 10386.638633333334,
70
+ "fullMemoryLoads": 300,
71
+ "cpuMs": 24844,
72
+ "wallMs": 40200.4599,
73
+ "processCpuPercent": 61.80028801113292,
74
+ "rssBefore": 56283136,
75
+ "rssAfter": 157401088,
76
+ "peakRss": 332111872,
77
+ "node": "v24.19.0",
78
+ "platform": "win32",
79
+ "arch": "x64",
80
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
81
+ },
82
+ "after": {
83
+ "pollsMs": [
84
+ 29.53,
85
+ 3.372899999999845,
86
+ 2.309900000000198
87
+ ],
88
+ "meanPollMs": 11.737600000000015,
89
+ "fullMemoryLoads": 0,
90
+ "cpuMs": 109,
91
+ "wallMs": 9061.4375,
92
+ "processCpuPercent": 1.2028996503038287,
93
+ "rssBefore": 52092928,
94
+ "rssAfter": 51056640,
95
+ "peakRss": 54579200,
96
+ "node": "v24.19.0",
97
+ "platform": "win32",
98
+ "arch": "x64",
99
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
100
+ }
101
+ }
102
+ }
103
+ ]
104
+ }
@@ -1,103 +1,103 @@
1
- {
2
- "baselineSha": "e954eaf2f2cbbef4bb6226a2ebb35191424868c2",
3
- "capturedAt": "2026-10-09T14:26:54.222Z",
4
- "scope": "Synthetic DSH runtime on Windows; not the user database or full DSH UI process.",
5
- "scenarios": [
6
- {
7
- "name": "small",
8
- "namespaces": 100,
9
- "rawUserCharsPerNamespace": 8192,
10
- "databaseBytes": 8949760,
11
- "rounds": 3,
12
- "intervalMs": 3000,
13
- "measurements": {
14
- "before": {
15
- "pollsMs": [
16
- 1559.2007,
17
- 2646.6144999999997,
18
- 2287.6314999999995
19
- ],
20
- "meanPollMs": 2164.482233333333,
21
- "fullMemoryLoads": 300,
22
- "cpuMs": 3547,
23
- "wallMs": 15505.109400000001,
24
- "processCpuPercent": 22.876330043824133,
25
- "rssBefore": 56803328,
26
- "rssAfter": 73904128,
27
- "peakRss": 74313728,
28
- "node": "v24.19.0",
29
- "platform": "win32",
30
- "arch": "x64",
31
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
32
- },
33
- "after": {
34
- "pollsMs": [
35
- 17.57029999999999,
36
- 3.0478000000002794,
37
- 4.158300000000054
38
- ],
39
- "meanPollMs": 8.258800000000107,
40
- "fullMemoryLoads": 0,
41
- "cpuMs": 16,
42
- "wallMs": 9039.4974,
43
- "processCpuPercent": 0.17700099122767599,
44
- "rssBefore": 56590336,
45
- "rssAfter": 54194176,
46
- "peakRss": 57184256,
47
- "node": "v24.19.0",
48
- "platform": "win32",
49
- "arch": "x64",
50
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
51
- }
52
- }
53
- },
54
- {
55
- "name": "large",
56
- "namespaces": 100,
57
- "rawUserCharsPerNamespace": 1572864,
58
- "databaseBytes": 1519833088,
59
- "rounds": 3,
60
- "intervalMs": 3000,
61
- "measurements": {
62
- "before": {
63
- "pollsMs": [
64
- 13949.606099999999,
65
- 12921.8561,
66
- 12388.245900000002
67
- ],
68
- "meanPollMs": 13086.569366666668,
69
- "fullMemoryLoads": 300,
70
- "cpuMs": 32203,
71
- "wallMs": 48289.1154,
72
- "processCpuPercent": 66.687906235698,
73
- "rssBefore": 56573952,
74
- "rssAfter": 180330496,
75
- "peakRss": 284123136,
76
- "node": "v24.19.0",
77
- "platform": "win32",
78
- "arch": "x64",
79
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
80
- },
81
- "after": {
82
- "pollsMs": [
83
- 40.84779999999998,
84
- 3.018500000000131,
85
- 3.4000999999998385
86
- ],
87
- "meanPollMs": 15.75546666666665,
88
- "fullMemoryLoads": 0,
89
- "cpuMs": 63,
90
- "wallMs": 9055.1278,
91
- "processCpuPercent": 0.6957383859342107,
92
- "rssBefore": 56807424,
93
- "rssAfter": 54194176,
94
- "peakRss": 57184256,
95
- "node": "v24.19.0",
96
- "platform": "win32",
97
- "arch": "x64",
98
- "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
99
- }
100
- }
101
- }
102
- ]
103
- }
1
+ {
2
+ "baselineSha": "e954eaf2f2cbbef4bb6226a2ebb35191424868c2",
3
+ "capturedAt": "2026-10-09T14:26:54.222Z",
4
+ "scope": "Synthetic DSH runtime on Windows; not the user database or full DSH UI process.",
5
+ "scenarios": [
6
+ {
7
+ "name": "small",
8
+ "namespaces": 100,
9
+ "rawUserCharsPerNamespace": 8192,
10
+ "databaseBytes": 8949760,
11
+ "rounds": 3,
12
+ "intervalMs": 3000,
13
+ "measurements": {
14
+ "before": {
15
+ "pollsMs": [
16
+ 1559.2007,
17
+ 2646.6144999999997,
18
+ 2287.6314999999995
19
+ ],
20
+ "meanPollMs": 2164.482233333333,
21
+ "fullMemoryLoads": 300,
22
+ "cpuMs": 3547,
23
+ "wallMs": 15505.109400000001,
24
+ "processCpuPercent": 22.876330043824133,
25
+ "rssBefore": 56803328,
26
+ "rssAfter": 73904128,
27
+ "peakRss": 74313728,
28
+ "node": "v24.19.0",
29
+ "platform": "win32",
30
+ "arch": "x64",
31
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
32
+ },
33
+ "after": {
34
+ "pollsMs": [
35
+ 17.57029999999999,
36
+ 3.0478000000002794,
37
+ 4.158300000000054
38
+ ],
39
+ "meanPollMs": 8.258800000000107,
40
+ "fullMemoryLoads": 0,
41
+ "cpuMs": 16,
42
+ "wallMs": 9039.4974,
43
+ "processCpuPercent": 0.17700099122767599,
44
+ "rssBefore": 56590336,
45
+ "rssAfter": 54194176,
46
+ "peakRss": 57184256,
47
+ "node": "v24.19.0",
48
+ "platform": "win32",
49
+ "arch": "x64",
50
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
51
+ }
52
+ }
53
+ },
54
+ {
55
+ "name": "large",
56
+ "namespaces": 100,
57
+ "rawUserCharsPerNamespace": 1572864,
58
+ "databaseBytes": 1519833088,
59
+ "rounds": 3,
60
+ "intervalMs": 3000,
61
+ "measurements": {
62
+ "before": {
63
+ "pollsMs": [
64
+ 13949.606099999999,
65
+ 12921.8561,
66
+ 12388.245900000002
67
+ ],
68
+ "meanPollMs": 13086.569366666668,
69
+ "fullMemoryLoads": 300,
70
+ "cpuMs": 32203,
71
+ "wallMs": 48289.1154,
72
+ "processCpuPercent": 66.687906235698,
73
+ "rssBefore": 56573952,
74
+ "rssAfter": 180330496,
75
+ "peakRss": 284123136,
76
+ "node": "v24.19.0",
77
+ "platform": "win32",
78
+ "arch": "x64",
79
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
80
+ },
81
+ "after": {
82
+ "pollsMs": [
83
+ 40.84779999999998,
84
+ 3.018500000000131,
85
+ 3.4000999999998385
86
+ ],
87
+ "meanPollMs": 15.75546666666665,
88
+ "fullMemoryLoads": 0,
89
+ "cpuMs": 63,
90
+ "wallMs": 9055.1278,
91
+ "processCpuPercent": 0.6957383859342107,
92
+ "rssBefore": 56807424,
93
+ "rssAfter": 54194176,
94
+ "peakRss": 57184256,
95
+ "node": "v24.19.0",
96
+ "platform": "win32",
97
+ "arch": "x64",
98
+ "cpuMeasurementNote": "A zero CPU delta means below Windows counter resolution in this sample, not zero actual CPU work."
99
+ }
100
+ }
101
+ }
102
+ ]
103
+ }
@@ -1,32 +1,32 @@
1
- # 大库数据访问与增量保存
2
-
3
- 这轮改动沿用 SQLite 的事务、索引和版本检查。日常列表使用独立读模型,常用小修改直接提交局部记录;涉及派生关系的操作通过工作单元提交变化的记录。没有新增数据库引擎、ORM 或 schema 迁移。
4
-
5
- ## 读取
6
-
7
- - `SqliteStorage.readBlockPage` 在同一只读事务里读取导航元数据,按会话、顺序和分页选出块,再补齐当前页的原文与工具载荷。轮次、总数、衰减位置继续基于完整导航数据计算。
8
- - `readDashboardEntries` 为首页读取元数据,只补齐当前块页与当前审计页实际需要返回的原文。事件列表通过 `readEventModel` 读取元数据,筛选和分页后再加工展示字段。
9
- - `AdminReadModel` 没有 `schemaVersion`,因此不能误传给需要完整快照的保存接口。它不用于原文详情、导出或助手证据读取。
10
- - 块、事件、任务、节点及元素之间的关联在一次请求内建立索引,保持原来的顺序、去重规则和虚拟分块范围。
11
- - 旧 schema 和混合会话的块列表保留完整恢复路径。块搜索仍按完整返回对象匹配,再分页,保留已有搜索语义。
12
- - dashboard 条件请求先读取空间版本、设置及去重维护状态。ETag 相同直接返回 304,不读取页面原文;分页、搜索和事件筛选条件属于缓存键。
13
-
14
- ## 写入与内存一致性
15
-
16
- `StorageAdapter.commitRecords` 是可选能力,提供追加对话、块指针、事件置顶和采用回执几个业务事务。事务检查预期版本;成功后同步更新内存和版本,失败不发布这次内存变化。重复采用回执在修改队列内再次检查,避免同时到达的请求重复强化。
17
-
18
- `saveChanges` 为其他派生、导入和语义修改提供工作单元:比较记录元数据、原文位置及明确的原文修改,只写变化的行,删除失效来源关系,原文和全文索引在同一个事务中处理。原有 `save` 入口及不支持新能力的适配器继续可用。
19
-
20
- 版本检查不能替代任务租约检查。图谱撤权、任务身份、并发心跳合并和事务失败回滚沿用原机制;计算变化集合发生在合并当前租约之后。
21
-
22
- 旧接口允许调用者修改返回的事件、块或原文文本,再由后续操作保存。为兼容这种用法,引擎保留已提交的记录元数据基线;检测到未提交修改时,常用小操作转入工作单元,一并保存相关变化。`getBlockContext` 产生的派生指针变化可合并进入同一层级事务。
23
-
24
- 工具载荷由引擎持有独立的 JSON 值,首次接入持久化状态时冻结,后续保存共享这些不可变值,避免反复深拷贝全部历史工具结果。调用方传入的对象不被冻结;完整导出仍返回可以独立编辑的副本。原文文本和工具载荷整体替换可以由记录差异识别;不应原地修改已存储工具载荷的内部字段。
25
-
26
- ## 验证与边界
27
-
28
- 新增测试比较完整保存与增量保存的重开结果,检查实际 SQL 更新范围,注入事务中途失败,覆盖重复回执、过期写入、输入对象所有权和旧对象修改。API 测试比较新旧列表及 dashboard 的完整 JSON,包含跨页搜索、旧会话、空页、超过 40 块的后续页、审计来源和条件请求。
29
-
30
- 基准使用 24 / 96 / 384 块隔离构造库,每块四轮对话及工具 JSON。旧实现来自本次修改前保存的工作区源码;每项热操作保留 9 个原始样本,冷首次请求单列。原始记录见 `.benchmarks/database-access/results.json`;源码基线和原有工作区差异保存在 `.artifacts/database-access-before/`。测量不包含模型、向量服务或真实用户数据库,不能据此推算真实 DSH 的整轮响应时间。
31
-
32
- 剩余成本包括:导航和关联元数据的扫描、完整语义搜索、旧数据恢复、变化的图谱/主题 JSON 文档及复杂派生操作的元数据比较。助手运行时仍会缓存已打开空间;这次没有移除所有完整快照入口,也没有把所有复杂写入改成专用 SQL 命令。schema 保持 14,并以修改前的 SQLite 读取器核对新事务产物的可读性。
1
+ # 大库数据访问与增量保存
2
+
3
+ 这轮改动沿用 SQLite 的事务、索引和版本检查。日常列表使用独立读模型,常用小修改直接提交局部记录;涉及派生关系的操作通过工作单元提交变化的记录。没有新增数据库引擎、ORM 或 schema 迁移。
4
+
5
+ ## 读取
6
+
7
+ - `SqliteStorage.readBlockPage` 在同一只读事务里读取导航元数据,按会话、顺序和分页选出块,再补齐当前页的原文与工具载荷。轮次、总数、衰减位置继续基于完整导航数据计算。
8
+ - `readDashboardEntries` 为首页读取元数据,只补齐当前块页与当前审计页实际需要返回的原文。事件列表通过 `readEventModel` 读取元数据,筛选和分页后再加工展示字段。
9
+ - `AdminReadModel` 没有 `schemaVersion`,因此不能误传给需要完整快照的保存接口。它不用于原文详情、导出或助手证据读取。
10
+ - 块、事件、任务、节点及元素之间的关联在一次请求内建立索引,保持原来的顺序、去重规则和虚拟分块范围。
11
+ - 旧 schema 和混合会话的块列表保留完整恢复路径。块搜索仍按完整返回对象匹配,再分页,保留已有搜索语义。
12
+ - dashboard 条件请求先读取空间版本、设置及去重维护状态。ETag 相同直接返回 304,不读取页面原文;分页、搜索和事件筛选条件属于缓存键。
13
+
14
+ ## 写入与内存一致性
15
+
16
+ `StorageAdapter.commitRecords` 是可选能力,提供追加对话、块指针、事件置顶和采用回执几个业务事务。事务检查预期版本;成功后同步更新内存和版本,失败不发布这次内存变化。重复采用回执在修改队列内再次检查,避免同时到达的请求重复强化。
17
+
18
+ `saveChanges` 为其他派生、导入和语义修改提供工作单元:比较记录元数据、原文位置及明确的原文修改,只写变化的行,删除失效来源关系,原文和全文索引在同一个事务中处理。原有 `save` 入口及不支持新能力的适配器继续可用。
19
+
20
+ 版本检查不能替代任务租约检查。图谱撤权、任务身份、并发心跳合并和事务失败回滚沿用原机制;计算变化集合发生在合并当前租约之后。
21
+
22
+ 旧接口允许调用者修改返回的事件、块或原文文本,再由后续操作保存。为兼容这种用法,引擎保留已提交的记录元数据基线;检测到未提交修改时,常用小操作转入工作单元,一并保存相关变化。`getBlockContext` 产生的派生指针变化可合并进入同一层级事务。
23
+
24
+ 工具载荷由引擎持有独立的 JSON 值,首次接入持久化状态时冻结,后续保存共享这些不可变值,避免反复深拷贝全部历史工具结果。调用方传入的对象不被冻结;完整导出仍返回可以独立编辑的副本。原文文本和工具载荷整体替换可以由记录差异识别;不应原地修改已存储工具载荷的内部字段。
25
+
26
+ ## 验证与边界
27
+
28
+ 新增测试比较完整保存与增量保存的重开结果,检查实际 SQL 更新范围,注入事务中途失败,覆盖重复回执、过期写入、输入对象所有权和旧对象修改。API 测试比较新旧列表及 dashboard 的完整 JSON,包含跨页搜索、旧会话、空页、超过 40 块的后续页、审计来源和条件请求。
29
+
30
+ 基准使用 24 / 96 / 384 块隔离构造库,每块四轮对话及工具 JSON。旧实现来自本次修改前保存的工作区源码;每项热操作保留 9 个原始样本,冷首次请求单列。原始记录见 `.benchmarks/database-access/results.json`;源码基线和原有工作区差异保存在 `.artifacts/database-access-before/`。测量不包含模型、向量服务或真实用户数据库,不能据此推算真实 DSH 的整轮响应时间。
31
+
32
+ 剩余成本包括:导航和关联元数据的扫描、完整语义搜索、旧数据恢复、变化的图谱/主题 JSON 文档及复杂派生操作的元数据比较。助手运行时仍会缓存已打开空间;这次没有移除所有完整快照入口,也没有把所有复杂写入改成专用 SQL 命令。schema 保持 14,并以修改前的 SQLite 读取器核对新事务产物的可读性。