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,69 +1,69 @@
1
- # 目录 Dreaming Agent
2
-
3
- 第一版 scope 为 `directory`,持久化 `policyVersion` 用于后续扩展与兼容检查。任务调度、认领/租约、证据读取、目录写入与 DSH 会话宿主分开:Core 管理原子提交与断点,Runtime 协调运行,DSH 提供真实 Agent 和会话;UI 只请求状态与控制动作。
4
-
5
- 新会话头部传入目录所属工作区的 `cwd`,优先从匹配 namespace 的活动普通会话取值,再从持久化会话头部恢复;不读取历史正文。项目/会话作用域找不到真实路径时暂停并提示先打开对应普通会话,不以插件目录冒充工作区。全局/自定义导入空间无唯一工作区时使用宿主运行目录作为查看地址,工具权限仍按 run scope 隔离。打开会话前完成宿主 flush。旧版本生成的无 `cwd` 会话头不可改写;打开或继续时提示终止旧轮并重新开始,保留已提交的目录修改与旧日志。
6
-
7
- ## 工具与权限
8
-
9
- | 工具 | 行为 |
10
- | --- | --- |
11
- | `memory_list_topics` / `memory_expand_topic` | 运行空间内目录导航与分页总览,独立 scoped 实现 |
12
- | `dreaming_search` | 冻结有效 Event、其引用的原始消息及有效图谱检索 |
13
- | `dreaming_read` | 完整 Event、来源 Block、图谱节点的只读分页 |
14
- | `dreaming_directory` | 当前章节改名、小节改名/合并、当前批 Event 移动、带来源的总览/经验替换、追加或跨小节原子整理 |
15
- | `dreaming_finish` | 确认当前批已检查;推进下一批,最终结束 |
16
-
17
- Agent 只注册上述工具,拒绝继承的 shell、网络、文件和记忆写入工具。普通聊天工具的证据评估批次与使用反馈不复用。`dreaming_search` 使用底层检索;`dreaming_read` 使用 `renderBlock`,不调用会提升层级/改变衰减锚点的 `expandBlock`。Dreaming 系统提示词注入持久用户画像,仅作为相关偏好和长期要求的参考,不能替代目录来源证据;会话不重新摄入记忆,也不继承普通聊天的自动检索上下文。
18
-
19
- ### 概要整理操作
20
-
21
- `set-overview {title,entries}` 只替换指定小节的全部概要,不替换整章。`append-overview` 仅用于真正新增的事实。`move-events` 只改变当前批 Event 的小节归属,不自动移动概要正文。
22
-
23
- `rewrite-overview {titles,entries}` 原子替换所列多个已有小节的全部概要;每个 entry 必须显式指定这些小节之一作为 `title`。它支持把事实从错放的小节移到正确小节,也支持合并重复段落、更正旧表述。必须包含所列小节所有需要保留的独有内容,包括目标小节原有概要;未列出的小节保持原样。目标小节可由同一次提交前面的 `move-events` 创建。只有重排概要时也可单独调用,不要求改变 Event 归属。
24
-
25
- 例如把“旧分类”中的一段移到“新分类”,提交 `titles:["旧分类","新分类"]`,在 entries 中列出两节应保留的全部内容,把该段的 title 改为“新分类”,保留其正文和来源。移动后无需在“旧分类”留下重复正文或仅为通过校验而添加交叉索引。
26
-
27
- 替换前必须完整读取原有引用来源。Core 按所选小节新概要的来源并集检查,禁止丢失任何原有来源引用;不再要求同一个引用必须留在原小节。任一操作失败则整次提交回滚,其他步骤的改名、移动和重写也不保存。章节版本、认领和冻结来源校验保持有效。
28
-
29
- 新证据修正旧说法时,优先改写或合并旧段落,同时引用新旧来源并保留时间顺序、适用范围、仍有效的细节和不确定性;不让旧结论继续充当当前事实,再在末尾不断追加补丁。仅因材料较新不能自行裁定矛盾。单小节用 `set-overview`,跨小节用 `rewrite-overview`。这些规则在原生 Agent 与兼容的 detached 路径共用。
30
-
31
- 概要错误会附上具体 Event ID 和原因:`overview-source-not-retrieved` 表示需要完整读取,按 `nextOffset` 连续翻页;`overview-source-not-in-chapter` 表示来源属于别章,反复读取不会获得本章引用权限;`overview-source-unavailable` 表示未知、已变化或不在本轮冻结范围;`overview-source-reference-missing` 表示替换遗漏旧引用。未知小节、缺少条目 title、空来源和无效正文也分别报错。
32
-
33
- ## 持久化与并发
34
-
35
- 任务保存在既有 Topic 状态中,无新增数据库/schema 迁移。任务冻结来源版本,按章节拆成有限上下文页面。提交在 Core 现有事务内检查 run ID、owner、epoch、租约、章节版本、来源有效性和已读证据。大 Event 只有连续分页读完才进入证据集合;检查覆盖断点不依赖最近工具日志的长度。
36
-
37
- Event 分页按递归稳定字段顺序序列化,页结果和持久断点绑定完整内容摘要。重启不依赖对象属性插入顺序;旧格式断点或内容摘要改变时清除旧覆盖并从零读取。当前批所有 Event 的完整证据覆盖满足后才能完成,未读完的大 Event 不会被报告为已检查。
38
-
39
- 暂停等当前步骤到达安全边界,继续时换 epoch;终止立即取消当前请求并提升 epoch,使迟到结果无法写入。已完成写入保留。运行定期续租;崩溃后过期认领可人工继续。并发投影改变来源或章节会拒绝写入,由用户终止后重新规划。
40
-
41
- 最后一批完成后,Agent 可继续生成最终总结。此时同一 run、owner、epoch 的在途心跳只返回已完成状态,不更新时戳、不重建租约,也不取消总结;Runtime 收到完成状态后停止心跳。其他 owner、旧 epoch 和旧 run 仍被拒绝,已完成轮次仍不能写目录。
42
-
43
- 用户手动触发的 Dreaming 优先于同一记忆空间的自动目录投影。开始时立即持久化目录占用,阻止任何连接认领新的目录投影;已经认领且租约有效的投影先收尾,界面显示“等待当前后台目录整理完成”,等待期间不请求 Dreaming 模型。收尾完成、失败或租约过期后,再按最新目录冻结批次与来源,过期投影的迟到结果不能覆盖 Dreaming。其他记忆空间的目录任务照常调度。
44
-
45
- 首次目录尚未生成时,只要有有效投影正在执行,同样可以启动等待;投影收尾后重新规划。没有章节且没有有效在途投影时拒绝启动。在途投影失败或过期后若仍无章节,本轮以“暂无可整理的目录章节”完成并释放占用。等待轮询只读取最新状态;现有每 20 秒心跳续租,不按每次轮询写库。暂停、失效认领和投影结束时仍经过原事务处理状态变化。
46
-
47
- 暂停和宿主重启后保留目录占用,避免继续时目录已经被后台改写;整轮完成或用户终止后释放占用并唤醒后台任务。暂停轮次的状态会提示用户:后台目录整理等待本轮继续或终止。若其他写入仍改变冻结章节或来源,则立即暂停并标记需要重新开始;旧版本遗留的冲突轮次在继续前同样校验,不再让模型反复重读。界面隐藏该轮次的“继续”,提示终止后重新开始,已提交的修改保留。
48
-
49
- 小节身份不依赖当前标题;合并保留旧身份的别名,后续普通投影保留身份、别名和有效经验。空改动和回到近期旧状态的编辑被拒绝,不能用反复改名制造进展。
50
-
51
- ## 增长、结束与消耗
52
-
53
- 批次最多 24 个 Event,并按预计上下文容量进一步拆小;这是页面大小,不是整轮调用限额。目录页的进度按这些批次计算(例如 `1/14` 批约为 7%),不是简单按章节数计算;一个较大的章节可能拆成多个批次。Dreaming 使用原生 DSH Agent 会话,启动、恢复和切批时追加当前任务;同批后续步骤沿用对话和工具结果,不逐步替换历史,也不重复注入完整任务。相关旧总览完整提供,不设置插件自己的 4000/6000 Token 截断;历史保留和摘要压缩由宿主根据实际模型窗口管理。
54
-
55
- 流程为检查本批 Event、对照旧总览、只提交有价值的目录调整、完成本批并继续。已有覆盖时允许不修改就完成,不把同一事实的改写当成新内容追加。目录 sections/overview 页绑定内容摘要并持久记录覆盖;任务提供恢复时的已读范围,随后分页按工具返回的 nextOffset 前进。对话中的核对结论、用户方向、错误和成功结果交由宿主保留或摘要。失败写入提案另有持久化记录,不受最近 12 条诊断日志的窗口影响;恢复时提供完整提案,读取错误不再包装为失败写入。
56
-
57
- `dreaming_finish` 表示批次已全部检查,允许无需修改;所有冻结批次完成后进入 completed。重复无效工具调用、连续无工具进展的模型步骤或失败时暂停。没有累计 token 限额,界面和控制接口不提供上限设置。内部计量保留实际模型输入结构的 token 估算和输出估算/供应商输出计数,仅用于诊断;目录页和模型任务上下文不展示消耗数字,不声称价格或账单精度。旧任务继续时在原子事务中清除历史 tokenLimit,保留任务、批次进度、证据断点与会话身份。
58
-
59
- 无进展计数在新增完整 Event 证据、推进连续有效来源页、读取经校验的目录新项或成功修改目录时重置。搜索关键词变化、空结果与重读已覆盖页均不重置;连续 12 次无进展工具调用后暂停,允许其间进行有限探索;一旦有上述有效进展,连续计数从零开始。空响应(含 `(empty)`)或普通文字回复结束但任务未完成时,在同一 Agent Loop 内提示继续;连续三次没有工具行动才暂停,不按整轮累计。复用持久化的 idleModelSteps,工具检查点或完成批次后重置;不使用后台定时重试。用户暂停、终止和真实请求错误优先于自动继续。切批消息明确上一批已完成、当前批待处理,完成全部批次后只生成总结,不再催促工具调用。
60
-
61
- 原生 Agent 在请求最终组装后的 `llm/stream` 边界计量实际消息(含任务和系统提示)及 JSON 工具定义,自动继续也走相同入口,仅用于诊断。单次输出长度沿用宿主/模型配置,插件不强制 32768 Token 上限,也不按 8192 Token 的普通文本长度提前中断。模型请求错误先交给宿主原生策略处理,包括上下文溢出后的摘要压缩与恢复;宿主拒绝恢复或耗尽其恢复预算后才持久化暂停。宿主摘要请求不被计作 Dreaming 工作步骤,不干扰本批的无工具进展计数;摘要自身用量由宿主记录。没有整轮时长或累计调用次数硬限额;完成后的总结请求也计量,但不重新激活任务或租约。
62
-
63
- 目录写入使用带必需 kind 的明确参数结构,操作数组必须扁平;错误不视为成功提交,Agent 可以纠正并重新提交。暂停时不为说明原因额外调用模型,而是在原生会话写入插件通知,报告真实原因、检查批次与已保存修改。start 每次创建新 run/session;resume 保留本轮会话与宿主保留的历史,并追加最新任务;之前版本已经裁掉的中间结论不能凭空恢复。
64
-
65
- 每批每次继续最多允许 64 次成功目录提交,达到后在当前步骤检查点暂停并保留已写入内容。用户明确继续或进入下一批时重新计数;页数与整轮调用量不受此上限限制。无工具循环在请求发送前被拦截时,不计入模型调用次数或 Token 消耗。
66
-
67
- ## 验证边界
68
-
69
- 测试使用隔离 SQLite 与 DSH JSONL 目录,验证真实 Agent Loop、工具拒绝、分批、写入、暂停/终止、用户补充、宿主重启恢复与完整会话。浏览器检查桌面/手机布局、浮窗原文、控制按钮与减少动画设置。测试模型是脚本化流,不证明真实模型能正确提炼经验;未改用户生产数据,也未发布。
1
+ # 目录 Dreaming Agent
2
+
3
+ 第一版 scope 为 `directory`,持久化 `policyVersion` 用于后续扩展与兼容检查。任务调度、认领/租约、证据读取、目录写入与 DSH 会话宿主分开:Core 管理原子提交与断点,Runtime 协调运行,DSH 提供真实 Agent 和会话;UI 只请求状态与控制动作。
4
+
5
+ 新会话头部传入目录所属工作区的 `cwd`,优先从匹配 namespace 的活动普通会话取值,再从持久化会话头部恢复;不读取历史正文。项目/会话作用域找不到真实路径时暂停并提示先打开对应普通会话,不以插件目录冒充工作区。全局/自定义导入空间无唯一工作区时使用宿主运行目录作为查看地址,工具权限仍按 run scope 隔离。打开会话前完成宿主 flush。旧版本生成的无 `cwd` 会话头不可改写;打开或继续时提示终止旧轮并重新开始,保留已提交的目录修改与旧日志。
6
+
7
+ ## 工具与权限
8
+
9
+ | 工具 | 行为 |
10
+ | --- | --- |
11
+ | `memory_list_topics` / `memory_expand_topic` | 运行空间内目录导航与分页总览,独立 scoped 实现 |
12
+ | `dreaming_search` | 冻结有效 Event、其引用的原始消息及有效图谱检索 |
13
+ | `dreaming_read` | 完整 Event、来源 Block、图谱节点的只读分页 |
14
+ | `dreaming_directory` | 当前章节改名、小节改名/合并、当前批 Event 移动、带来源的总览/经验替换、追加或跨小节原子整理 |
15
+ | `dreaming_finish` | 确认当前批已检查;推进下一批,最终结束 |
16
+
17
+ Agent 只注册上述工具,拒绝继承的 shell、网络、文件和记忆写入工具。普通聊天工具的证据评估批次与使用反馈不复用。`dreaming_search` 使用底层检索;`dreaming_read` 使用 `renderBlock`,不调用会提升层级/改变衰减锚点的 `expandBlock`。Dreaming 系统提示词注入持久用户画像,仅作为相关偏好和长期要求的参考,不能替代目录来源证据;会话不重新摄入记忆,也不继承普通聊天的自动检索上下文。
18
+
19
+ ### 概要整理操作
20
+
21
+ `set-overview {title,entries}` 只替换指定小节的全部概要,不替换整章。`append-overview` 仅用于真正新增的事实。`move-events` 只改变当前批 Event 的小节归属,不自动移动概要正文。
22
+
23
+ `rewrite-overview {titles,entries}` 原子替换所列多个已有小节的全部概要;每个 entry 必须显式指定这些小节之一作为 `title`。它支持把事实从错放的小节移到正确小节,也支持合并重复段落、更正旧表述。必须包含所列小节所有需要保留的独有内容,包括目标小节原有概要;未列出的小节保持原样。目标小节可由同一次提交前面的 `move-events` 创建。只有重排概要时也可单独调用,不要求改变 Event 归属。
24
+
25
+ 例如把“旧分类”中的一段移到“新分类”,提交 `titles:["旧分类","新分类"]`,在 entries 中列出两节应保留的全部内容,把该段的 title 改为“新分类”,保留其正文和来源。移动后无需在“旧分类”留下重复正文或仅为通过校验而添加交叉索引。
26
+
27
+ 替换前必须完整读取原有引用来源。Core 按所选小节新概要的来源并集检查,禁止丢失任何原有来源引用;不再要求同一个引用必须留在原小节。任一操作失败则整次提交回滚,其他步骤的改名、移动和重写也不保存。章节版本、认领和冻结来源校验保持有效。
28
+
29
+ 新证据修正旧说法时,优先改写或合并旧段落,同时引用新旧来源并保留时间顺序、适用范围、仍有效的细节和不确定性;不让旧结论继续充当当前事实,再在末尾不断追加补丁。仅因材料较新不能自行裁定矛盾。单小节用 `set-overview`,跨小节用 `rewrite-overview`。这些规则在原生 Agent 与兼容的 detached 路径共用。
30
+
31
+ 概要错误会附上具体 Event ID 和原因:`overview-source-not-retrieved` 表示需要完整读取,按 `nextOffset` 连续翻页;`overview-source-not-in-chapter` 表示来源属于别章,反复读取不会获得本章引用权限;`overview-source-unavailable` 表示未知、已变化或不在本轮冻结范围;`overview-source-reference-missing` 表示替换遗漏旧引用。未知小节、缺少条目 title、空来源和无效正文也分别报错。
32
+
33
+ ## 持久化与并发
34
+
35
+ 任务保存在既有 Topic 状态中,无新增数据库/schema 迁移。任务冻结来源版本,按章节拆成有限上下文页面。提交在 Core 现有事务内检查 run ID、owner、epoch、租约、章节版本、来源有效性和已读证据。大 Event 只有连续分页读完才进入证据集合;检查覆盖断点不依赖最近工具日志的长度。
36
+
37
+ Event 分页按递归稳定字段顺序序列化,页结果和持久断点绑定完整内容摘要。重启不依赖对象属性插入顺序;旧格式断点或内容摘要改变时清除旧覆盖并从零读取。当前批所有 Event 的完整证据覆盖满足后才能完成,未读完的大 Event 不会被报告为已检查。
38
+
39
+ 暂停等当前步骤到达安全边界,继续时换 epoch;终止立即取消当前请求并提升 epoch,使迟到结果无法写入。已完成写入保留。运行定期续租;崩溃后过期认领可人工继续。并发投影改变来源或章节会拒绝写入,由用户终止后重新规划。
40
+
41
+ 最后一批完成后,Agent 可继续生成最终总结。此时同一 run、owner、epoch 的在途心跳只返回已完成状态,不更新时戳、不重建租约,也不取消总结;Runtime 收到完成状态后停止心跳。其他 owner、旧 epoch 和旧 run 仍被拒绝,已完成轮次仍不能写目录。
42
+
43
+ 用户手动触发的 Dreaming 优先于同一记忆空间的自动目录投影。开始时立即持久化目录占用,阻止任何连接认领新的目录投影;已经认领且租约有效的投影先收尾,界面显示“等待当前后台目录整理完成”,等待期间不请求 Dreaming 模型。收尾完成、失败或租约过期后,再按最新目录冻结批次与来源,过期投影的迟到结果不能覆盖 Dreaming。其他记忆空间的目录任务照常调度。
44
+
45
+ 首次目录尚未生成时,只要有有效投影正在执行,同样可以启动等待;投影收尾后重新规划。没有章节且没有有效在途投影时拒绝启动。在途投影失败或过期后若仍无章节,本轮以“暂无可整理的目录章节”完成并释放占用。等待轮询只读取最新状态;现有每 20 秒心跳续租,不按每次轮询写库。暂停、失效认领和投影结束时仍经过原事务处理状态变化。
46
+
47
+ 暂停和宿主重启后保留目录占用,避免继续时目录已经被后台改写;整轮完成或用户终止后释放占用并唤醒后台任务。暂停轮次的状态会提示用户:后台目录整理等待本轮继续或终止。若其他写入仍改变冻结章节或来源,则立即暂停并标记需要重新开始;旧版本遗留的冲突轮次在继续前同样校验,不再让模型反复重读。界面隐藏该轮次的“继续”,提示终止后重新开始,已提交的修改保留。
48
+
49
+ 小节身份不依赖当前标题;合并保留旧身份的别名,后续普通投影保留身份、别名和有效经验。空改动和回到近期旧状态的编辑被拒绝,不能用反复改名制造进展。
50
+
51
+ ## 增长、结束与消耗
52
+
53
+ 批次最多 24 个 Event,并按预计上下文容量进一步拆小;这是页面大小,不是整轮调用限额。目录页的进度按这些批次计算(例如 `1/14` 批约为 7%),不是简单按章节数计算;一个较大的章节可能拆成多个批次。Dreaming 使用原生 DSH Agent 会话,启动、恢复和切批时追加当前任务;同批后续步骤沿用对话和工具结果,不逐步替换历史,也不重复注入完整任务。相关旧总览完整提供,不设置插件自己的 4000/6000 Token 截断;历史保留和摘要压缩由宿主根据实际模型窗口管理。
54
+
55
+ 流程为检查本批 Event、对照旧总览、只提交有价值的目录调整、完成本批并继续。已有覆盖时允许不修改就完成,不把同一事实的改写当成新内容追加。目录 sections/overview 页绑定内容摘要并持久记录覆盖;任务提供恢复时的已读范围,随后分页按工具返回的 nextOffset 前进。对话中的核对结论、用户方向、错误和成功结果交由宿主保留或摘要。失败写入提案另有持久化记录,不受最近 12 条诊断日志的窗口影响;恢复时提供完整提案,读取错误不再包装为失败写入。
56
+
57
+ `dreaming_finish` 表示批次已全部检查,允许无需修改;所有冻结批次完成后进入 completed。重复无效工具调用、连续无工具进展的模型步骤或失败时暂停。没有累计 token 限额,界面和控制接口不提供上限设置。内部计量保留实际模型输入结构的 token 估算和输出估算/供应商输出计数,仅用于诊断;目录页和模型任务上下文不展示消耗数字,不声称价格或账单精度。旧任务继续时在原子事务中清除历史 tokenLimit,保留任务、批次进度、证据断点与会话身份。
58
+
59
+ 无进展计数在新增完整 Event 证据、推进连续有效来源页、读取经校验的目录新项或成功修改目录时重置。搜索关键词变化、空结果与重读已覆盖页均不重置;连续 12 次无进展工具调用后暂停,允许其间进行有限探索;一旦有上述有效进展,连续计数从零开始。空响应(含 `(empty)`)或普通文字回复结束但任务未完成时,在同一 Agent Loop 内提示继续;连续三次没有工具行动才暂停,不按整轮累计。复用持久化的 idleModelSteps,工具检查点或完成批次后重置;不使用后台定时重试。用户暂停、终止和真实请求错误优先于自动继续。切批消息明确上一批已完成、当前批待处理,完成全部批次后只生成总结,不再催促工具调用。
60
+
61
+ 原生 Agent 在请求最终组装后的 `llm/stream` 边界计量实际消息(含任务和系统提示)及 JSON 工具定义,自动继续也走相同入口,仅用于诊断。单次输出长度沿用宿主/模型配置,插件不强制 32768 Token 上限,也不按 8192 Token 的普通文本长度提前中断。模型请求错误先交给宿主原生策略处理,包括上下文溢出后的摘要压缩与恢复;宿主拒绝恢复或耗尽其恢复预算后才持久化暂停。宿主摘要请求不被计作 Dreaming 工作步骤,不干扰本批的无工具进展计数;摘要自身用量由宿主记录。没有整轮时长或累计调用次数硬限额;完成后的总结请求也计量,但不重新激活任务或租约。
62
+
63
+ 目录写入使用带必需 kind 的明确参数结构,操作数组必须扁平;错误不视为成功提交,Agent 可以纠正并重新提交。暂停时不为说明原因额外调用模型,而是在原生会话写入插件通知,报告真实原因、检查批次与已保存修改。start 每次创建新 run/session;resume 保留本轮会话与宿主保留的历史,并追加最新任务;之前版本已经裁掉的中间结论不能凭空恢复。
64
+
65
+ 每批每次继续最多允许 64 次成功目录提交,达到后在当前步骤检查点暂停并保留已写入内容。用户明确继续或进入下一批时重新计数;页数与整轮调用量不受此上限限制。无工具循环在请求发送前被拦截时,不计入模型调用次数或 Token 消耗。
66
+
67
+ ## 验证边界
68
+
69
+ 测试使用隔离 SQLite 与 DSH JSONL 目录,验证真实 Agent Loop、工具拒绝、分批、写入、暂停/终止、用户补充、宿主重启恢复与完整会话。浏览器检查桌面/手机布局、浮窗原文、控制按钮与减少动画设置。测试模型是脚本化流,不证明真实模型能正确提炼经验;未改用户生产数据,也未发布。
@@ -1,48 +1,48 @@
1
- # Event Extractor v2
2
-
3
- 新版提取规则只用于升级后正常提取的新 Event。提取器不会重放旧 L5、改写旧标题或回填分类提示和版本号。已有待处理任务仍按正常重试规则处理。历史重复卡由下述独立的一次性整理任务处理。
4
-
5
- ## 提取判断
6
-
7
- 判断独立含义及遗忘成本,而不是以重要性、criticality 或消息角色作为统一门槛。用户事实、评价、审美反馈、明确要求、纠正、改变决定和可复用指导采用较低提取门槛;普通 Agent / Tool 执行步骤采用较高门槛。已确认根因、平台限制、失败条件、可复用经验和重要结果仍可独立保留。Summarizer 的高召回预筛同步提示这些候选。
8
-
9
- 保守使用现有 scope:单次答复要求保留 session 范围;项目要求使用 project;明确长期指导才可使用 user。重复纠正可以成为经验的证据,但不能把一次局部反馈扩大成永久人格或审美。两个能独立变化、被检索、冲突或替代的事实仍分开;原子化不等于记录每次工具调用。标题保留明确对象、稳定锚点和一个主要变化,详细原因留在 summary。
10
- Extractor 结构化输出必须明确返回合法 scope。工具调用及文本 fallback 都先进行同一 schema 验证;遗漏或非法值触发现有有界重试,重试仍失败时不写入 Event,不再默认扩大为 project。核心旧 Event、手工输入及自定义 Extractor 的兼容类型不变。
11
-
12
- ## 重复与关系
13
-
14
- 同一 Block 内的同义表达由模型识别为一条事实,保留直接支持它的目标消息 ID。适配层额外合并同一次输出中 title、summary、scope、criticality 和 temporal 完全相同的卡片,比较截断前的完整模型文本,合并目标来源及检索标签;不同事实、范围或关系不合并。
15
- 精确重复卡的 catalogHints 保留第一张卡的归一化结果,包括第一张缺省时继续缺省;不合并或追加后续卡的类别。
16
-
17
- 纯重复且没有新增长期信息可不提取;明确强化或延续用 sameEventId,替代/纠正用 supersedesEventIds,无法确认替代的矛盾用 conflictsWithEventIds。历史卡保留。相同项目、关键词近似不能单独建立关系。现有 timeline 仍最多提供 8 条相关及 4 条最近 Event,增加每条最多 400 字符的摘要、范围和历史状态以辅助识别;字段对自定义 Extractor 保持可选。timeline / neighbor 只供理解和关系匹配,不能为新事实提供来源。
18
-
19
- ## 入库去重与一次性历史整理
20
-
21
- 程序负责从当前命名空间的 passive/agent 两个 Event 池发现候选。同批同来源的重复输出仍确定性消重,写入回执继续处理重放;跨 Block 的相似记录即使文字相同,也交给 AI 判断,不能仅凭文本相似直接丢弃新来源。
22
-
23
- 专用裁决器读取双方完整卡与来源。KEEP_LEFT/KEEP_RIGHT 选择沿用的主卡,并返回完整标题和正文草稿;只有证据支持同一事实、草稿有效且 confidence 至少为 0.9 时才自动采用。缺失信息、表达精度和分类差异不单独构成冲突;不同发生、后续进展、纠正或真实矛盾应明确 KEEP_BOTH,不确定才 REVIEW。明确 KEEP_BOTH 视为 AI 已完成,不要求用户逐对确认。缺草稿、低把握、失败或证据超限时保留原卡,进入人工队列,不回退到程序拼接。阈值是执行规则,并非经真实模型评测校准的准确率。
24
-
25
- 整理版本为 3,升级时重审未由人工确认的旧候选,并保留已有撤销记录。扫描包括 active/superseded 卡;自动裁决只处理双方 active 的候选,历史版本直接进入人工队列,不消耗自动裁决调用。初次扫描完成后,新增 Event 会触发新候选发现,已处理候选不反复调用模型。程序检查命名空间/会话范围、指纹、置顶和关系完整性;日期、数值等语义差异交给 AI 或人工结合上下文判断。合并采用完整草稿,双方引语、参与者、标签、来源及安全关联按规则保留;沿用主卡的结构化日期和状态,界面提示有差异的字段。自动合并及普通有效卡合并遇到进展、替代、冲突关系或时间环时拒绝折叠;显式人工历史合并保留原始时间链,不重定向历史关联。权重继承双方真实采用字段最大值,不制造采用回执。
26
-
27
- 后台保留跨进程租约、调用前预留尝试、每对最多两次、60 秒退避和 30 秒外层超时。人工预览复用当前来源指纹对应的 AI 稿;无缓存时可请求草稿,失败后仍可直接填写完整稿,最终确认本身不调用模型。界面分为“需要你判断 / 等待 AI / 已处理”,支持完整标题/正文编辑、仅保留 A/B、保留两张、来源查看和手动接管。切换候选/队列会在当前页面保留最多 50 份编辑草稿;刷新不保存未提交的人工编辑。自动与人工合并均保存可恢复的逆操作;撤销会恢复原内容、历史状态及关系,有后续编辑、采用或相关投影变化时拒绝覆盖新数据。
28
-
29
- 界面逐组展示 A/B 卡片及发生日期、引语、参与者和来源。用户先选主卡,再选择“合并双方内容”或“只保留所选卡”,预览保留/归档对象、日期和证据去向后确认。日期或事实存在差异时可由用户核对完整稿后合并,不确定时保留两张。superseded 历史卡可在人工确认后补入当前有效卡:默认推荐当前卡作为主卡,完整标题和正文必须经 AI 起草或人工编辑后提交;旧卡归档且保留原文、来源及时间链,双方证据汇入当前卡,当前卡结构化日期和状态不变,外部关联不改写。旧卡即使指向第三个版本,也可在人工确认的完整稿中作为来源,原后继指针保留;将被归档的卡已置顶或已作为其他合并的原始证据时,拒绝并显示具体原因。用户仍可显式二选一(恢复历史卡前单独提示影响):所选卡设为 active,另一张归档,内容、采用权重、原始来源和历史引用均不混合、不改写;不额外排入模型投影任务。置顶副卡、已合并来源和过期指纹仍受保护。归档卡已有的 supersededBy 保留,只有原来没有后继时才指向所选卡;显式恢复被选历史卡时将其设为 active 并清除自身后继,这是用户选择恢复的状态转换,不改写第三张卡。中断恢复复用已持久化逆操作核对归档结果,不把后继指针当作人工选择的唯一凭据。人工选择独立记为 selected,不冒充 merged;归档 agent 卡可通过显式来源页面查看证据。撤销后回到“需要你判断”并定位刚恢复的候选,避免跳到无关卡片。
30
-
31
- 存储 schema 13 通过独立 event_merge_sources 表记录 mergedFromEventIds;普通卡继续采用单来源边界,合并卡的额外消息必须来自可追溯的归档原卡。schema 12 可只读查看并无损升级,旧插件会拒绝打开更高存储版本。撤销外部导入时,若其证据已参与合并则拒绝整批删除,避免破坏其他来源。narrative 是已退役的 Event 字段,现存正文在 summary;合并不生成或改写事实正文。
32
-
33
- 这套机制减少重复,但不能保证语义改写零漏判。仅共享主题、后续进展或时间不明的重复发生都优先保留;不会为追求去重率抹掉独立事实。存量扫描采用词元候选召回,低词面重合的同义表达仍可能未命中。
34
-
35
- ## 可选字段与兼容
36
-
37
- | 字段 | 语义 | 边界 |
38
- | --- | --- | --- |
39
- | `catalogHints?: string[]` | 长期类别的自由短语,仅供导航 | 最多 2 个,每个最多 64 个 Unicode 字符;可以缺省或为空;不设 enum 或 other/其他兜底,不指定目录 ID/路径,不改写标题来充当类别 |
40
- | `extractorVersion?: number` | 对话提取规则版本 | DSH Extractor 在代码中标记为 `2`,不让模型决定;旧卡、手工卡及其他 Extractor 缺省合法 |
41
-
42
- 运行时限制提示数量,移除空白、重复、非法类型、明显兜底和目录 ID/路径;类别是否有来源、是否只是标题改写等语义约束由 prompt 负责。Topic Projector 可见 catalogHints 用于路由,但不能据此生成事实或决定章/节。Element 和 Graph 都用字段白名单构造 Event 模型输入,物理排除提示和版本号;Element 保留事实正文、引用、目标来源、时间、范围、criticality 和历史关系。检索的事实字段、provenance、时间、criticality 和 admission 机制不变。
43
-
44
- SQLite 用新增的可选 `event_metadata` 附表保存这两个字段,支持 passive / agent 两个 Event 池,随原有事务保存和清理。只为已有字段的卡写元数据行;不 ALTER 旧 Event 表或重建历史数据,存储 schema 仍为 12。旧库没有附表也可以只读打开;普通写入器打开时创建空表。旧 Event 的 API 字段形状保持原样,新字段存在时才输出。
45
-
46
- ## 验证边界
47
-
48
- 确定性测试验证 prompt/schema 合约、模型输出归一化、同 Block 及跨 Block 去重、目标来源边界、relation 写入、SQLite 往返、旧库只读/升级、无历史重提取/回填,以及旧卡的检索、Topic、Graph、API 和 UI 路径。去重另覆盖模型失败/低把握时保留、并发变化、跨进程租约、检查点恢复和一次性执行。测试里的模型响应是 mock,并非真实模型语义准确率测量;同义识别、提取敏感度及泛化质量仍取决于实际模型。未新增依赖或目录算法。
1
+ # Event Extractor v2
2
+
3
+ 新版提取规则只用于升级后正常提取的新 Event。提取器不会重放旧 L5、改写旧标题或回填分类提示和版本号。已有待处理任务仍按正常重试规则处理。历史重复卡由下述独立的一次性整理任务处理。
4
+
5
+ ## 提取判断
6
+
7
+ 判断独立含义及遗忘成本,而不是以重要性、criticality 或消息角色作为统一门槛。用户事实、评价、审美反馈、明确要求、纠正、改变决定和可复用指导采用较低提取门槛;普通 Agent / Tool 执行步骤采用较高门槛。已确认根因、平台限制、失败条件、可复用经验和重要结果仍可独立保留。Summarizer 的高召回预筛同步提示这些候选。
8
+
9
+ 保守使用现有 scope:单次答复要求保留 session 范围;项目要求使用 project;明确长期指导才可使用 user。重复纠正可以成为经验的证据,但不能把一次局部反馈扩大成永久人格或审美。两个能独立变化、被检索、冲突或替代的事实仍分开;原子化不等于记录每次工具调用。标题保留明确对象、稳定锚点和一个主要变化,详细原因留在 summary。
10
+ Extractor 结构化输出必须明确返回合法 scope。工具调用及文本 fallback 都先进行同一 schema 验证;遗漏或非法值触发现有有界重试,重试仍失败时不写入 Event,不再默认扩大为 project。核心旧 Event、手工输入及自定义 Extractor 的兼容类型不变。
11
+
12
+ ## 重复与关系
13
+
14
+ 同一 Block 内的同义表达由模型识别为一条事实,保留直接支持它的目标消息 ID。适配层额外合并同一次输出中 title、summary、scope、criticality 和 temporal 完全相同的卡片,比较截断前的完整模型文本,合并目标来源及检索标签;不同事实、范围或关系不合并。
15
+ 精确重复卡的 catalogHints 保留第一张卡的归一化结果,包括第一张缺省时继续缺省;不合并或追加后续卡的类别。
16
+
17
+ 纯重复且没有新增长期信息可不提取;明确强化或延续用 sameEventId,替代/纠正用 supersedesEventIds,无法确认替代的矛盾用 conflictsWithEventIds。历史卡保留。相同项目、关键词近似不能单独建立关系。现有 timeline 仍最多提供 8 条相关及 4 条最近 Event,增加每条最多 400 字符的摘要、范围和历史状态以辅助识别;字段对自定义 Extractor 保持可选。timeline / neighbor 只供理解和关系匹配,不能为新事实提供来源。
18
+
19
+ ## 入库去重与一次性历史整理
20
+
21
+ 程序负责从当前命名空间的 passive/agent 两个 Event 池发现候选。同批同来源的重复输出仍确定性消重,写入回执继续处理重放;跨 Block 的相似记录即使文字相同,也交给 AI 判断,不能仅凭文本相似直接丢弃新来源。
22
+
23
+ 专用裁决器读取双方完整卡与来源。KEEP_LEFT/KEEP_RIGHT 选择沿用的主卡,并返回完整标题和正文草稿;只有证据支持同一事实、草稿有效且 confidence 至少为 0.9 时才自动采用。缺失信息、表达精度和分类差异不单独构成冲突;不同发生、后续进展、纠正或真实矛盾应明确 KEEP_BOTH,不确定才 REVIEW。明确 KEEP_BOTH 视为 AI 已完成,不要求用户逐对确认。缺草稿、低把握、失败或证据超限时保留原卡,进入人工队列,不回退到程序拼接。阈值是执行规则,并非经真实模型评测校准的准确率。
24
+
25
+ 整理版本为 3,升级时重审未由人工确认的旧候选,并保留已有撤销记录。扫描包括 active/superseded 卡;自动裁决只处理双方 active 的候选,历史版本直接进入人工队列,不消耗自动裁决调用。初次扫描完成后,新增 Event 会触发新候选发现,已处理候选不反复调用模型。程序检查命名空间/会话范围、指纹、置顶和关系完整性;日期、数值等语义差异交给 AI 或人工结合上下文判断。合并采用完整草稿,双方引语、参与者、标签、来源及安全关联按规则保留;沿用主卡的结构化日期和状态,界面提示有差异的字段。自动合并及普通有效卡合并遇到进展、替代、冲突关系或时间环时拒绝折叠;显式人工历史合并保留原始时间链,不重定向历史关联。权重继承双方真实采用字段最大值,不制造采用回执。
26
+
27
+ 后台保留跨进程租约、调用前预留尝试、每对最多两次、60 秒退避和 30 秒外层超时。人工预览复用当前来源指纹对应的 AI 稿;无缓存时可请求草稿,失败后仍可直接填写完整稿,最终确认本身不调用模型。界面分为“需要你判断 / 等待 AI / 已处理”,支持完整标题/正文编辑、仅保留 A/B、保留两张、来源查看和手动接管。切换候选/队列会在当前页面保留最多 50 份编辑草稿;刷新不保存未提交的人工编辑。自动与人工合并均保存可恢复的逆操作;撤销会恢复原内容、历史状态及关系,有后续编辑、采用或相关投影变化时拒绝覆盖新数据。
28
+
29
+ 界面逐组展示 A/B 卡片及发生日期、引语、参与者和来源。用户先选主卡,再选择“合并双方内容”或“只保留所选卡”,预览保留/归档对象、日期和证据去向后确认。日期或事实存在差异时可由用户核对完整稿后合并,不确定时保留两张。superseded 历史卡可在人工确认后补入当前有效卡:默认推荐当前卡作为主卡,完整标题和正文必须经 AI 起草或人工编辑后提交;旧卡归档且保留原文、来源及时间链,双方证据汇入当前卡,当前卡结构化日期和状态不变,外部关联不改写。旧卡即使指向第三个版本,也可在人工确认的完整稿中作为来源,原后继指针保留;将被归档的卡已置顶或已作为其他合并的原始证据时,拒绝并显示具体原因。用户仍可显式二选一(恢复历史卡前单独提示影响):所选卡设为 active,另一张归档,内容、采用权重、原始来源和历史引用均不混合、不改写;不额外排入模型投影任务。置顶副卡、已合并来源和过期指纹仍受保护。归档卡已有的 supersededBy 保留,只有原来没有后继时才指向所选卡;显式恢复被选历史卡时将其设为 active 并清除自身后继,这是用户选择恢复的状态转换,不改写第三张卡。中断恢复复用已持久化逆操作核对归档结果,不把后继指针当作人工选择的唯一凭据。人工选择独立记为 selected,不冒充 merged;归档 agent 卡可通过显式来源页面查看证据。撤销后回到“需要你判断”并定位刚恢复的候选,避免跳到无关卡片。
30
+
31
+ 存储 schema 13 通过独立 event_merge_sources 表记录 mergedFromEventIds;普通卡继续采用单来源边界,合并卡的额外消息必须来自可追溯的归档原卡。schema 12 可只读查看并无损升级,旧插件会拒绝打开更高存储版本。撤销外部导入时,若其证据已参与合并则拒绝整批删除,避免破坏其他来源。narrative 是已退役的 Event 字段,现存正文在 summary;合并不生成或改写事实正文。
32
+
33
+ 这套机制减少重复,但不能保证语义改写零漏判。仅共享主题、后续进展或时间不明的重复发生都优先保留;不会为追求去重率抹掉独立事实。存量扫描采用词元候选召回,低词面重合的同义表达仍可能未命中。
34
+
35
+ ## 可选字段与兼容
36
+
37
+ | 字段 | 语义 | 边界 |
38
+ | --- | --- | --- |
39
+ | `catalogHints?: string[]` | 长期类别的自由短语,仅供导航 | 最多 2 个,每个最多 64 个 Unicode 字符;可以缺省或为空;不设 enum 或 other/其他兜底,不指定目录 ID/路径,不改写标题来充当类别 |
40
+ | `extractorVersion?: number` | 对话提取规则版本 | DSH Extractor 在代码中标记为 `2`,不让模型决定;旧卡、手工卡及其他 Extractor 缺省合法 |
41
+
42
+ 运行时限制提示数量,移除空白、重复、非法类型、明显兜底和目录 ID/路径;类别是否有来源、是否只是标题改写等语义约束由 prompt 负责。Topic Projector 可见 catalogHints 用于路由,但不能据此生成事实或决定章/节。Element 和 Graph 都用字段白名单构造 Event 模型输入,物理排除提示和版本号;Element 保留事实正文、引用、目标来源、时间、范围、criticality 和历史关系。检索的事实字段、provenance、时间、criticality 和 admission 机制不变。
43
+
44
+ SQLite 用新增的可选 `event_metadata` 附表保存这两个字段,支持 passive / agent 两个 Event 池,随原有事务保存和清理。只为已有字段的卡写元数据行;不 ALTER 旧 Event 表或重建历史数据,存储 schema 仍为 12。旧库没有附表也可以只读打开;普通写入器打开时创建空表。旧 Event 的 API 字段形状保持原样,新字段存在时才输出。
45
+
46
+ ## 验证边界
47
+
48
+ 确定性测试验证 prompt/schema 合约、模型输出归一化、同 Block 及跨 Block 去重、目标来源边界、relation 写入、SQLite 往返、旧库只读/升级、无历史重提取/回填,以及旧卡的检索、Topic、Graph、API 和 UI 路径。去重另覆盖模型失败/低把握时保留、并发变化、跨进程租约、检查点恢复和一次性执行。测试里的模型响应是 mock,并非真实模型语义准确率测量;同义识别、提取敏感度及泛化质量仍取决于实际模型。未新增依赖或目录算法。
package/docs/feedback.md CHANGED
@@ -1,50 +1,50 @@
1
- # StrataGate 邮件反馈与本地运行诊断
2
-
3
- 反馈针对 StrataGate 插件的故障、使用疑问和改进建议。默认流程:用户要求或接受整理反馈 → Agent 写草稿 → 程序附加本地诊断快照 → 用户在插件内检查完整报告 → 复制到自己的邮箱发送。收件地址为 `jiahongcheng61@gmail.com`。
4
-
5
- ## Agent 信息与交互
6
-
7
- - 常驻策略只说明作用域、主动建议门槛和诊断入口。工具说明包含填写依据与更新语义;详细运行数据按需返回。
8
- - 当前 DSH 默认 native 模式在组装模型请求时提供可见工具的名称、说明与参数;这两个工具采用该方式。PTC 模式由宿主生成工具 SDK 声明。渐进披露用于运行摘要、分页异常与诊断详情:常驻保留短入口,调用后再读取数据,生成草稿时由程序直接附加完整本地快照。
9
- - `feedback_prepare` 自动整理本地诊断摘要,返回草稿链接与尚未发送状态。新问题用 `new_draft=true`,修改时省略字段保留原值,空字符串或空数组清空字段。用户编辑过的自定义 Markdown 内容会保留。
10
- - `stratagate_diagnostics` 默认读取当前记忆空间摘要,使用返回的 `id` 获取脱敏详情,使用 `nextOffset` 分页。诊断属于运行数据,不走语义记忆检索与强化。
11
- - 已填好的 AI 草稿直接进入检查页;修改、完整预览、复制、邮箱和下载位于同一流程。报告预览固定后,复制与下载使用同一快照;用户修改后重新检查。
12
- - 对话里的同源反馈链接由插件接管点击,阻止宿主 Markdown 将其再次交给侧边浏览器。DSH 0.2.0 通过 `sidebar.settings` 中共享的设置面板 store 打开插件页,反馈空间和目标页由插件传递;关闭重开和已打开面板内切换空间均保留目标草稿。
13
- - 桌面主界面使用 `dsh-app://app/`;插件通过桌面预加载桥接 `dshDesktopBoot.ready()` 的 `streamBaseUrl` 确认当前 HTTP 后端,仅接管该后端根路径下的有效反馈链接。启动信息未返回时保留首次点击,确认归属后进入设置;其他实例或读取失败则交回宿主原有链接行为。桌面草稿导航沿用主界面的认证代理,直接在当前面板切换。
14
- - 明确、持续影响当前任务的插件问题才适合主动建议,先处理问题,每个会话最多建议一次,接受后准备草稿。普通后台重试只记本地诊断,保持聊天安静。后台诊断不自动注入模型上下文。
15
- - 页面提供可复制的 AI 请求提示词,用户回到相关会话发送。直接请求已经授权创建草稿。
16
-
17
- ## 数据范围与统计口径
18
-
19
- 运行数据保存在本地数据库的 `stratagate_dsh_diagnostic_*` 表,与核心记忆快照分开。调用结束、操作完成/失败、检索与工具结果等事件只入有界缓冲,最长约五秒批量落盘;正常关闭时尽力刷盘。最多缓冲 256 条,超出丢弃最旧记录并报告丢弃数。数据库忙时立即放弃本次写入并保留缓冲,统计失败不使聊天或记忆任务失败。
20
-
21
- 原始诊断最多保留七天、全库最多 2000 条;按 UTC 日、记忆空间、模块、模型和插件版本的汇总最多保留九十天、全库最多 10000 行。报告覆盖最近七个 UTC 日(含今天);最多读取 2000 行汇总、展示 40 组模型/版本明细和一页 20 条异常,截断与下一页位置均明确返回。尚未落盘的缓冲在异常退出时可能丢失;写入失败和缓冲丢弃计数属于当前进程,报告保留采集开始时间与缺失说明。
22
-
23
- - `modelCalls`:实际经过采集器的流式请求尝试,包括失败、取消、截断、内部重试。
24
- - `modelCancelled`:流式 aborted 结束、直接抛出的 AbortError/ABORT_ERR 或消费方提前结束;取消与 `modelFailed` 分开计数,已返回 usage 仍保留。
25
- - `operations`:一次记忆模型操作,包含其内部内容修正及路由回退请求。它与持久化后台任务的整个生命周期不同。一次失败后由后台再次执行,会形成另一条操作记录。
26
- - `validationFailures`:请求返回后,内容格式或语义校验失败。请求传输成功并不保证内容合格。
27
- - `operationsRecovered`:同一操作经历多个请求后完成;包括兼容回退。首次成功率、操作失败率、恢复率均提供操作样本数,耗时为均值。
28
- - `pipeline`:生成报告时现存摘要、Event 提取、图谱、主题和导入任务的状态。历史重试详情受原始记录保留范围限制;`oldestPendingUpdatedAt` 是最早的待处理任务最后更新时间。
29
- - Token 使用适配器报告值。DSH 的未缓存输入、缓存读取、缓存写入互斥;reasoning 为输出子集,单列展示,不再次相加。缺失 usage 与缺失 total 分别保留,未知值不填零。
30
- - `observedBackgroundTokenShare`:当前空间完整已观测请求中,后台请求 Token 占比。任何请求缺少总用量或汇总不完整时为 null;该数值不包含主聊天内所有记忆输入成本,也不等于账单费用占比。
31
- - `memoryInputEstimate`:对已组装的记忆常驻规则、工具定义、画像、目录和自动上下文做文本 Token 估算,逐个观测聊天请求累计。历史工具结果、分层对话及多模态等归因尚不完整。
32
- - 数据库共享画像维护或暂时无法归属的调用列入 `sharedOrUnattributed`,不伪造工作区分摊。
33
- - 收益提供检索充分性、空结果、采用回执与分层内容体积估算。分层估算使用最近最多 64 个存储块,代表内容大小比较,不等于实际账单节省或答案质量。
34
- - 主聊天采集覆盖能关联到本插件会话且经过宿主 `llm/stream` 钩子的请求;费用比例、净收益及未观测请求保持未知。旧版本历史不回填。
35
-
36
- ## 反馈内容与隐私
37
-
38
- 默认报告含用户检查的问题描述、基础诊断、近期模块统计和异常分类、阶段、时间。前端最近错误和后台任务错误原文仅在用户勾选详细错误日志后加入;默认报告还会剔除旧诊断快照中的 detail 字段。持续采集不存模型输入、输出正文或工具参数;错误只取有界 message,并在本地落盘前去除常见凭据、URL、Windows 路径和邮箱。默认摘要省略详细错误文本;按诊断 ID 读取详情时提供脱敏文本。前端生成报告时另对凭据、邮箱、URL、Windows/UNC/Unix 路径脱敏。
39
-
40
- 详细错误日志、记忆正文由用户选择加入。自动脱敏有边界,检查页展示完整待复制内容供人工确认。统计以本地存储为限,发送邮件由用户完成;复制和下载只表示本地操作成功,实际发送与作者收件需邮件侧证据。
41
-
42
- ## 验证
43
-
44
- 使用隔离 SQLite 数据库验证重启保留、命名空间隔离、失败写入不阻塞、原始记录上限与汇总保留、Token 去重计数及缺失标记;模型测试覆盖无效输出重试的额外消耗和后台空间归属;反馈测试覆盖 AI 草稿直达检查、完整快照、用户编辑和剪贴板失败回退。
45
-
46
- `scripts/test-feedback-navigation-browser.mjs` 使用已安装 DSH 的真实 Markdown 链接、设置面板和共享 store,以及插件真实组件,在无头 Chrome 中检查点击传播、草稿定位和普通外链。API 使用合成数据,不读取真实用户配置。需要 React/React DOM、宿主 UI 构建依赖和 Chrome;可用 `STRATAGATE_BROWSER_NODE_MODULES` 指定独立依赖目录、`STRATAGATE_BROWSER_CHROME` 指定浏览器。可选 `STRATAGATE_NAVIGATION_BASELINE_SOURCE` 提供旧版 client.js 做原样复现对照,`STRATAGATE_NAVIGATION_EVIDENCE` 保存结果。
47
-
48
- 设置 `STRATAGATE_NAVIGATION_SURFACE=desktop` 时,测试以独立 Electron 44、临时用户目录、真实注册的 `dsh-app` 协议和隔离 IPC 启动信息运行;桌面主界面与 HTTP 草稿链接使用不同来源。测试经过插件实际 `apply` 注册、真实 `MarkdownText`、`SlotCore` 和设置面板,不调用付费模型。`STRATAGATE_BROWSER_ELECTRON` 指定测试二进制;`STRATAGATE_NAVIGATION_CLIENT_SOURCE` 可指向安装包内的 dist/client.js 验证确切产物;`STRATAGATE_NAVIGATION_SCREENSHOT` 可保存合成场景截图。该测试验证隔离桌面壳中的链路,真实用户 DSH 配置仍需人工验收。
49
-
50
- 宿主界面的真实邮件发送仍由用户完成。页面截图采用合成数据,仅用于布局检查;具体测试与性能证据见 `docs/validation/feedback-observability-20261016/`。
1
+ # StrataGate 邮件反馈与本地运行诊断
2
+
3
+ 反馈针对 StrataGate 插件的故障、使用疑问和改进建议。默认流程:用户要求或接受整理反馈 → Agent 写草稿 → 程序附加本地诊断快照 → 用户在插件内检查完整报告 → 复制到自己的邮箱发送。收件地址为 `jiahongcheng61@gmail.com`。
4
+
5
+ ## Agent 信息与交互
6
+
7
+ - 常驻策略只说明作用域、主动建议门槛和诊断入口。工具说明包含填写依据与更新语义;详细运行数据按需返回。
8
+ - 当前 DSH 默认 native 模式在组装模型请求时提供可见工具的名称、说明与参数;这两个工具采用该方式。PTC 模式由宿主生成工具 SDK 声明。渐进披露用于运行摘要、分页异常与诊断详情:常驻保留短入口,调用后再读取数据,生成草稿时由程序直接附加完整本地快照。
9
+ - `feedback_prepare` 自动整理本地诊断摘要,返回草稿链接与尚未发送状态。新问题用 `new_draft=true`,修改时省略字段保留原值,空字符串或空数组清空字段。用户编辑过的自定义 Markdown 内容会保留。
10
+ - `stratagate_diagnostics` 默认读取当前记忆空间摘要,使用返回的 `id` 获取脱敏详情,使用 `nextOffset` 分页。诊断属于运行数据,不走语义记忆检索与强化。
11
+ - 已填好的 AI 草稿直接进入检查页;修改、完整预览、复制、邮箱和下载位于同一流程。报告预览固定后,复制与下载使用同一快照;用户修改后重新检查。
12
+ - 对话里的同源反馈链接由插件接管点击,阻止宿主 Markdown 将其再次交给侧边浏览器。DSH 0.2.0 通过 `sidebar.settings` 中共享的设置面板 store 打开插件页,反馈空间和目标页由插件传递;关闭重开和已打开面板内切换空间均保留目标草稿。
13
+ - 桌面主界面使用 `dsh-app://app/`;插件通过桌面预加载桥接 `dshDesktopBoot.ready()` 的 `streamBaseUrl` 确认当前 HTTP 后端,仅接管该后端根路径下的有效反馈链接。启动信息未返回时保留首次点击,确认归属后进入设置;其他实例或读取失败则交回宿主原有链接行为。桌面草稿导航沿用主界面的认证代理,直接在当前面板切换。
14
+ - 明确、持续影响当前任务的插件问题才适合主动建议,先处理问题,每个会话最多建议一次,接受后准备草稿。普通后台重试只记本地诊断,保持聊天安静。后台诊断不自动注入模型上下文。
15
+ - 页面提供可复制的 AI 请求提示词,用户回到相关会话发送。直接请求已经授权创建草稿。
16
+
17
+ ## 数据范围与统计口径
18
+
19
+ 运行数据保存在本地数据库的 `stratagate_dsh_diagnostic_*` 表,与核心记忆快照分开。调用结束、操作完成/失败、检索与工具结果等事件只入有界缓冲,最长约五秒批量落盘;正常关闭时尽力刷盘。最多缓冲 256 条,超出丢弃最旧记录并报告丢弃数。数据库忙时立即放弃本次写入并保留缓冲,统计失败不使聊天或记忆任务失败。
20
+
21
+ 原始诊断最多保留七天、全库最多 2000 条;按 UTC 日、记忆空间、模块、模型和插件版本的汇总最多保留九十天、全库最多 10000 行。报告覆盖最近七个 UTC 日(含今天);最多读取 2000 行汇总、展示 40 组模型/版本明细和一页 20 条异常,截断与下一页位置均明确返回。尚未落盘的缓冲在异常退出时可能丢失;写入失败和缓冲丢弃计数属于当前进程,报告保留采集开始时间与缺失说明。
22
+
23
+ - `modelCalls`:实际经过采集器的流式请求尝试,包括失败、取消、截断、内部重试。
24
+ - `modelCancelled`:流式 aborted 结束、直接抛出的 AbortError/ABORT_ERR 或消费方提前结束;取消与 `modelFailed` 分开计数,已返回 usage 仍保留。
25
+ - `operations`:一次记忆模型操作,包含其内部内容修正及路由回退请求。它与持久化后台任务的整个生命周期不同。一次失败后由后台再次执行,会形成另一条操作记录。
26
+ - `validationFailures`:请求返回后,内容格式或语义校验失败。请求传输成功并不保证内容合格。
27
+ - `operationsRecovered`:同一操作经历多个请求后完成;包括兼容回退。首次成功率、操作失败率、恢复率均提供操作样本数,耗时为均值。
28
+ - `pipeline`:生成报告时现存摘要、Event 提取、图谱、主题和导入任务的状态。历史重试详情受原始记录保留范围限制;`oldestPendingUpdatedAt` 是最早的待处理任务最后更新时间。
29
+ - Token 使用适配器报告值。DSH 的未缓存输入、缓存读取、缓存写入互斥;reasoning 为输出子集,单列展示,不再次相加。缺失 usage 与缺失 total 分别保留,未知值不填零。
30
+ - `observedBackgroundTokenShare`:当前空间完整已观测请求中,后台请求 Token 占比。任何请求缺少总用量或汇总不完整时为 null;该数值不包含主聊天内所有记忆输入成本,也不等于账单费用占比。
31
+ - `memoryInputEstimate`:对已组装的记忆常驻规则、工具定义、画像、目录和自动上下文做文本 Token 估算,逐个观测聊天请求累计。历史工具结果、分层对话及多模态等归因尚不完整。
32
+ - 数据库共享画像维护或暂时无法归属的调用列入 `sharedOrUnattributed`,不伪造工作区分摊。
33
+ - 收益提供检索充分性、空结果、采用回执与分层内容体积估算。分层估算使用最近最多 64 个存储块,代表内容大小比较,不等于实际账单节省或答案质量。
34
+ - 主聊天采集覆盖能关联到本插件会话且经过宿主 `llm/stream` 钩子的请求;费用比例、净收益及未观测请求保持未知。旧版本历史不回填。
35
+
36
+ ## 反馈内容与隐私
37
+
38
+ 默认报告含用户检查的问题描述、基础诊断、近期模块统计和异常分类、阶段、时间。前端最近错误和后台任务错误原文仅在用户勾选详细错误日志后加入;默认报告还会剔除旧诊断快照中的 detail 字段。持续采集不存模型输入、输出正文或工具参数;错误只取有界 message,并在本地落盘前去除常见凭据、URL、Windows 路径和邮箱。默认摘要省略详细错误文本;按诊断 ID 读取详情时提供脱敏文本。前端生成报告时另对凭据、邮箱、URL、Windows/UNC/Unix 路径脱敏。
39
+
40
+ 详细错误日志、记忆正文由用户选择加入。自动脱敏有边界,检查页展示完整待复制内容供人工确认。统计以本地存储为限,发送邮件由用户完成;复制和下载只表示本地操作成功,实际发送与作者收件需邮件侧证据。
41
+
42
+ ## 验证
43
+
44
+ 使用隔离 SQLite 数据库验证重启保留、命名空间隔离、失败写入不阻塞、原始记录上限与汇总保留、Token 去重计数及缺失标记;模型测试覆盖无效输出重试的额外消耗和后台空间归属;反馈测试覆盖 AI 草稿直达检查、完整快照、用户编辑和剪贴板失败回退。
45
+
46
+ `scripts/test-feedback-navigation-browser.mjs` 使用已安装 DSH 的真实 Markdown 链接、设置面板和共享 store,以及插件真实组件,在无头 Chrome 中检查点击传播、草稿定位和普通外链。API 使用合成数据,不读取真实用户配置。需要 React/React DOM、宿主 UI 构建依赖和 Chrome;可用 `STRATAGATE_BROWSER_NODE_MODULES` 指定独立依赖目录、`STRATAGATE_BROWSER_CHROME` 指定浏览器。可选 `STRATAGATE_NAVIGATION_BASELINE_SOURCE` 提供旧版 client.js 做原样复现对照,`STRATAGATE_NAVIGATION_EVIDENCE` 保存结果。
47
+
48
+ 设置 `STRATAGATE_NAVIGATION_SURFACE=desktop` 时,测试以独立 Electron 44、临时用户目录、真实注册的 `dsh-app` 协议和隔离 IPC 启动信息运行;桌面主界面与 HTTP 草稿链接使用不同来源。测试经过插件实际 `apply` 注册、真实 `MarkdownText`、`SlotCore` 和设置面板,不调用付费模型。`STRATAGATE_BROWSER_ELECTRON` 指定测试二进制;`STRATAGATE_NAVIGATION_CLIENT_SOURCE` 可指向安装包内的 dist/client.js 验证确切产物;`STRATAGATE_NAVIGATION_SCREENSHOT` 可保存合成场景截图。该测试验证隔离桌面壳中的链路,真实用户 DSH 配置仍需人工验收。
49
+
50
+ 宿主界面的真实邮件发送仍由用户完成。页面截图采用合成数据,仅用于布局检查;具体测试与性能证据见 `docs/validation/feedback-observability-20261016/`。
@@ -1,55 +1,55 @@
1
- # Issue #128:同 revision 续租缓存复审修复
2
-
3
- 源码提交:`0f0cb8fbce5a116e4670785716aa62f68cdd9c08`。本报告之后的交付提交只增加证据文档;交付 SHA 以离线包 manifest 为准。
4
-
5
- 上轮交付:`bc73b6b7b2353e9c82726b8976f440672546ce9e`。完整修复基线:`e954eaf2f2cbbef4bb6226a2ebb35191424868c2`。
6
-
7
- ## 复现与修复
8
-
9
- 审查指出的边界成立。B 在 A 续租前加载 running Job,A 用真实独立 OS 子进程调用 SQLite 续租接口,业务 revision 不变;推进时钟越过 B 缓存的租约时间,B 尝试处理另一线程的 Block。修复前,Summary、Extraction、Graph、Topic 四个定向用例均出现 `Storage lease conflict`,无法完成另一任务。干净复现日志为 `lease-cache-repro-fixed-fixture.log`,不是仅凭静态推断。
10
-
11
- 最小修复继续把 Jobs 作为事实来源,不增加业务 revision、不引入新的业务状态机或常驻历史缓存:
12
-
13
- - SQLite 增加可选的轻量 `loadDerivationLeases()`。一次读事务获取当前 namespace 的 revision 和四类 running 认领元数据,不读取消息、Block 正文、Event 内容或 Graph 节点。Graph/Topic 只向调用者返回 Job 身份、attempt、updatedAt、leaseUntil;Topic 的 JSON 查询在 SQLite 内完成。
14
- - 本地发现 running 租约已到期时,恢复前先同步持久化元数据。`reloadFromStorage()` 与 `refreshFromStorage()` 在 revision 相同且认领身份一致时,只同步租约字段。业务 revision 变化,或 running 集合、attempt、updatedAt 不一致时,才读取完整权威快照;不能用租约读结果猜测业务状态。
15
- - Topic claim 使用同一个到期前置同步。正常完成、到期恢复、失败重试和最大次数仍由原有状态机处理,写入仍受 SQLite 事务认领与租约校验保护。
16
- - 心跳仍可能恰好发生在元数据读取之后、恢复写入之前。SQLite 会拒绝旧租约写入;前台 Block 调度遇到冲突后刷新持久化状态,并至少等待原有 3 秒 Worker 间隔后再试,不为这次正常竞争记录插件错误。其他抛出的异常也受同一个重排下限约束。新任务正常唤醒和既有持久化失败重试时间不变。
17
-
18
- 没有调大后台轮询间隔。新元数据读取用于实际任务恢复及显式重载,空闲轮询仍只查到期调度/脏键索引、额度和独立 Profile Maintenance,不会因此逐个打开 namespace。旧数据库可按原有迁移与分批脏键重建发现旧任务;跨进程写入仍依赖持久化触发器和轻量轮询,不依赖内存通知。
19
-
20
- ## 定向验证
21
-
22
- - 四类真实子进程续租:B 未显式 reload,也不会误恢复 A;A 保持 running、attempt 不变;另一线程任务完成;重复三轮不重复调用模型;续租同步期间完整 `SqliteStorage.load()` 调用为零。观察者的两种显式重载接口也取得同 revision 新租约。
23
- - 同 revision 下认领 attempt 或状态被外部 SQL 改变:确实加载一次完整权威快照,而不是只替换租约。
24
- - 前台真实 SQLite 竞争:读取旧元数据后 A 再续租,B 越过旧截止时间,事务拒绝恢复写入。没有插件错误日志;2,999ms 内不重试,3,000ms 后另一任务完成;额外推进 10 秒不再重排;完整加载仍为零。
25
- - 既有失败恢复测试改用模拟定时器,明确断言退避期间 namespace 仍可打开、退避后任务完成,没有增加测试超时。
26
- - 全范围自查还复现了最终一次 Summary/Extraction 租约中断后的终止边界:Core 已拒绝再执行,恢复留下的到期时间仍会让前台不断重排一个无法执行的任务。两个修复前回归均发现立即重试定时器;前台增加原有最大尝试次数过滤后,连续四次调度都不再创建定时器,模型调用为零。没有修改持久化重试 ledger 或增加尝试次数。
27
-
28
- 时间边界使用注入时钟/模拟定时器;续租写入和认领竞争使用真实 SQLite,四类续租各使用真实独立 OS 进程。没有声称在本轮实际等待 5 分钟网络模型调用。
29
-
30
- ## 整体核查与测试
31
-
32
- Windows x64 / Node `24.19.0` / `CI=true`:
33
-
34
- - `npm run check` 通过。
35
- - `npm test`:Core **312**、DSH **591**、WorkBuddy **10**,共 **913** 项通过、**1** 项既有跳过。
36
- - Issue #128 两个定向文件共 **41** 项通过(Core 30、DSH 11),包含先前 FTS、坏键公平重建、open tail、租约续期及本轮缓存和最终尝试边界回归。
37
- - `npm run build` 全部目标通过;`node scripts/verify-package.mjs` 验证 58 个包内文件及干净 tarball 安装,通过。
38
- - Windows DSH `0.2.0-rc.1` 和 `0.2.0-rc.2` 各自完整兼容脚本通过,均在冻结源码下完成类型检查、591 项 DSH 测试(1 项既有跳过)、构建、干净包安装、真实 CLI 启动、陈旧 peer 可恢复修复、管理能力、两条会话标题/页面和旧迁移,退出码均为 0。
39
- - 首次 rc.1 流程跨过了最终尝试次数补丁,未作为最终提交的完整证据。冻结后完整补跑日志为 `lease-cache-compat-rc1-final.log`;rc.2 日志为 `lease-cache-compat-rc2.log`。补跑 rc.1 和最后构建/包检查只关闭 npm 附带的 audit/fund 网络请求,依赖安装和全部功能断言保留;未执行安全漏洞审计。环境记录见 `lease-cache-validation-context.json`。
40
-
41
- 自查覆盖整个调度与 FTS 范围:派生索引与任务保存仍在同一事务;坏键持久化 60 秒退避与 generation 校验保留;未变化消息 UPSERT/FTS UPDATE 触发器仍不污染 dirty 集合;普通打开不再全库检查 FTS,旧库按搜索 namespace 懒回填,显式修复入口保留;只有可封存 open tail 的资格检查与 Worker 一致;Topic Event 版本动态工作及历史额度、模型就绪、重启恢复和独立 Profile Maintenance 相关回归仍通过。
42
-
43
- 本轮初次全量运行有一项失败:旧测试默认等待窗口短于新增 3 秒异常退避。修正为上述明确的时间边界断言后完整复验通过。离线包保留干净的修复前四类失败日志与最终通过日志,避免混用。
44
-
45
- ## 性能与验收边界
46
-
47
- 本轮没有重新采集 CPU/RSS 基准。此前 [Windows 合成数据](benchmarks/issue-128-windows-review.json) 属于源码 `415096f19d09d9bcc29c44634c7ae78fd6c2f52d`,其中 1449.42 MiB 合成库的 Worker CPU 61.80% → 1.20%、三轮完整加载 300 → 0,不能标注为本轮源码的测量。本轮的空闲回归继续验证 100 namespace 多轮、1000 namespace 大规模扫描不打开完整记忆;这不是完整 DSH 桌面进程 CPU 验收。
48
-
49
- 原用户 168 MB / 14 namespace 数据库、真实网络长模型、桌面界面响应及长期 CPU/RSS 仍需人工验证;远端 CI 未知。没有访问或修改用户生产数据库,没有推送 GitHub、更新 PR、合并或发布版本。
50
-
51
- ## 离线交付
52
-
53
- 新包包含完整提交源码 ZIP、完整任务分支历史 Git bundle、相对基线完整补丁、相对上轮增量补丁、测试/兼容日志、报告、中文审查提示词和 SHA-256 manifest。bundle 包含基线及其祖先,无外部 prerequisite;会在本任务的新隔离目录实际克隆并检查 HEAD。它仅包含任务分支引用,不打包其他工作分支。
54
-
55
- 完整源码包含 lockfile、测试夹具和构建配置。Node/npm 依赖未内嵌,重新执行测试需要可用 npm registry 或预先准备的依赖缓存;Git 仓库恢复本身不依赖 GitHub。历史报告与性能 JSON 保留原来的源码归属,最新结论以本报告和 manifest 为准。
1
+ # Issue #128:同 revision 续租缓存复审修复
2
+
3
+ 源码提交:`0f0cb8fbce5a116e4670785716aa62f68cdd9c08`。本报告之后的交付提交只增加证据文档;交付 SHA 以离线包 manifest 为准。
4
+
5
+ 上轮交付:`bc73b6b7b2353e9c82726b8976f440672546ce9e`。完整修复基线:`e954eaf2f2cbbef4bb6226a2ebb35191424868c2`。
6
+
7
+ ## 复现与修复
8
+
9
+ 审查指出的边界成立。B 在 A 续租前加载 running Job,A 用真实独立 OS 子进程调用 SQLite 续租接口,业务 revision 不变;推进时钟越过 B 缓存的租约时间,B 尝试处理另一线程的 Block。修复前,Summary、Extraction、Graph、Topic 四个定向用例均出现 `Storage lease conflict`,无法完成另一任务。干净复现日志为 `lease-cache-repro-fixed-fixture.log`,不是仅凭静态推断。
10
+
11
+ 最小修复继续把 Jobs 作为事实来源,不增加业务 revision、不引入新的业务状态机或常驻历史缓存:
12
+
13
+ - SQLite 增加可选的轻量 `loadDerivationLeases()`。一次读事务获取当前 namespace 的 revision 和四类 running 认领元数据,不读取消息、Block 正文、Event 内容或 Graph 节点。Graph/Topic 只向调用者返回 Job 身份、attempt、updatedAt、leaseUntil;Topic 的 JSON 查询在 SQLite 内完成。
14
+ - 本地发现 running 租约已到期时,恢复前先同步持久化元数据。`reloadFromStorage()` 与 `refreshFromStorage()` 在 revision 相同且认领身份一致时,只同步租约字段。业务 revision 变化,或 running 集合、attempt、updatedAt 不一致时,才读取完整权威快照;不能用租约读结果猜测业务状态。
15
+ - Topic claim 使用同一个到期前置同步。正常完成、到期恢复、失败重试和最大次数仍由原有状态机处理,写入仍受 SQLite 事务认领与租约校验保护。
16
+ - 心跳仍可能恰好发生在元数据读取之后、恢复写入之前。SQLite 会拒绝旧租约写入;前台 Block 调度遇到冲突后刷新持久化状态,并至少等待原有 3 秒 Worker 间隔后再试,不为这次正常竞争记录插件错误。其他抛出的异常也受同一个重排下限约束。新任务正常唤醒和既有持久化失败重试时间不变。
17
+
18
+ 没有调大后台轮询间隔。新元数据读取用于实际任务恢复及显式重载,空闲轮询仍只查到期调度/脏键索引、额度和独立 Profile Maintenance,不会因此逐个打开 namespace。旧数据库可按原有迁移与分批脏键重建发现旧任务;跨进程写入仍依赖持久化触发器和轻量轮询,不依赖内存通知。
19
+
20
+ ## 定向验证
21
+
22
+ - 四类真实子进程续租:B 未显式 reload,也不会误恢复 A;A 保持 running、attempt 不变;另一线程任务完成;重复三轮不重复调用模型;续租同步期间完整 `SqliteStorage.load()` 调用为零。观察者的两种显式重载接口也取得同 revision 新租约。
23
+ - 同 revision 下认领 attempt 或状态被外部 SQL 改变:确实加载一次完整权威快照,而不是只替换租约。
24
+ - 前台真实 SQLite 竞争:读取旧元数据后 A 再续租,B 越过旧截止时间,事务拒绝恢复写入。没有插件错误日志;2,999ms 内不重试,3,000ms 后另一任务完成;额外推进 10 秒不再重排;完整加载仍为零。
25
+ - 既有失败恢复测试改用模拟定时器,明确断言退避期间 namespace 仍可打开、退避后任务完成,没有增加测试超时。
26
+ - 全范围自查还复现了最终一次 Summary/Extraction 租约中断后的终止边界:Core 已拒绝再执行,恢复留下的到期时间仍会让前台不断重排一个无法执行的任务。两个修复前回归均发现立即重试定时器;前台增加原有最大尝试次数过滤后,连续四次调度都不再创建定时器,模型调用为零。没有修改持久化重试 ledger 或增加尝试次数。
27
+
28
+ 时间边界使用注入时钟/模拟定时器;续租写入和认领竞争使用真实 SQLite,四类续租各使用真实独立 OS 进程。没有声称在本轮实际等待 5 分钟网络模型调用。
29
+
30
+ ## 整体核查与测试
31
+
32
+ Windows x64 / Node `24.19.0` / `CI=true`:
33
+
34
+ - `npm run check` 通过。
35
+ - `npm test`:Core **312**、DSH **591**、WorkBuddy **10**,共 **913** 项通过、**1** 项既有跳过。
36
+ - Issue #128 两个定向文件共 **41** 项通过(Core 30、DSH 11),包含先前 FTS、坏键公平重建、open tail、租约续期及本轮缓存和最终尝试边界回归。
37
+ - `npm run build` 全部目标通过;`node scripts/verify-package.mjs` 验证 58 个包内文件及干净 tarball 安装,通过。
38
+ - Windows DSH `0.2.0-rc.1` 和 `0.2.0-rc.2` 各自完整兼容脚本通过,均在冻结源码下完成类型检查、591 项 DSH 测试(1 项既有跳过)、构建、干净包安装、真实 CLI 启动、陈旧 peer 可恢复修复、管理能力、两条会话标题/页面和旧迁移,退出码均为 0。
39
+ - 首次 rc.1 流程跨过了最终尝试次数补丁,未作为最终提交的完整证据。冻结后完整补跑日志为 `lease-cache-compat-rc1-final.log`;rc.2 日志为 `lease-cache-compat-rc2.log`。补跑 rc.1 和最后构建/包检查只关闭 npm 附带的 audit/fund 网络请求,依赖安装和全部功能断言保留;未执行安全漏洞审计。环境记录见 `lease-cache-validation-context.json`。
40
+
41
+ 自查覆盖整个调度与 FTS 范围:派生索引与任务保存仍在同一事务;坏键持久化 60 秒退避与 generation 校验保留;未变化消息 UPSERT/FTS UPDATE 触发器仍不污染 dirty 集合;普通打开不再全库检查 FTS,旧库按搜索 namespace 懒回填,显式修复入口保留;只有可封存 open tail 的资格检查与 Worker 一致;Topic Event 版本动态工作及历史额度、模型就绪、重启恢复和独立 Profile Maintenance 相关回归仍通过。
42
+
43
+ 本轮初次全量运行有一项失败:旧测试默认等待窗口短于新增 3 秒异常退避。修正为上述明确的时间边界断言后完整复验通过。离线包保留干净的修复前四类失败日志与最终通过日志,避免混用。
44
+
45
+ ## 性能与验收边界
46
+
47
+ 本轮没有重新采集 CPU/RSS 基准。此前 [Windows 合成数据](benchmarks/issue-128-windows-review.json) 属于源码 `415096f19d09d9bcc29c44634c7ae78fd6c2f52d`,其中 1449.42 MiB 合成库的 Worker CPU 61.80% → 1.20%、三轮完整加载 300 → 0,不能标注为本轮源码的测量。本轮的空闲回归继续验证 100 namespace 多轮、1000 namespace 大规模扫描不打开完整记忆;这不是完整 DSH 桌面进程 CPU 验收。
48
+
49
+ 原用户 168 MB / 14 namespace 数据库、真实网络长模型、桌面界面响应及长期 CPU/RSS 仍需人工验证;远端 CI 未知。没有访问或修改用户生产数据库,没有推送 GitHub、更新 PR、合并或发布版本。
50
+
51
+ ## 离线交付
52
+
53
+ 新包包含完整提交源码 ZIP、完整任务分支历史 Git bundle、相对基线完整补丁、相对上轮增量补丁、测试/兼容日志、报告、中文审查提示词和 SHA-256 manifest。bundle 包含基线及其祖先,无外部 prerequisite;会在本任务的新隔离目录实际克隆并检查 HEAD。它仅包含任务分支引用,不打包其他工作分支。
54
+
55
+ 完整源码包含 lockfile、测试夹具和构建配置。Node/npm 依赖未内嵌,重新执行测试需要可用 npm registry 或预先准备的依赖缓存;Git 仓库恢复本身不依赖 GitHub。历史报告与性能 JSON 保留原来的源码归属,最新结论以本报告和 manifest 为准。