stratagate-dsh 0.3.40 → 0.3.42

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 (43) 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 +134 -51
  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/development-validation.md +20 -0
  26. package/docs/dreaming-agent.md +69 -69
  27. package/docs/event-extractor.md +48 -48
  28. package/docs/feedback.md +50 -50
  29. package/docs/issue-128-lease-cache-review-followup.md +55 -55
  30. package/docs/issue-128-review-followup.md +58 -58
  31. package/docs/knowledge-graph.md +38 -38
  32. package/docs/npm-release.md +55 -53
  33. package/docs/surface-maintenance.md +36 -36
  34. package/docs/user-operation-priority.md +46 -39
  35. package/docs/validation/issue119-after.json +30 -0
  36. package/docs/validation/issue119-before.json +94 -0
  37. package/docs/validation/issue119.md +41 -41
  38. package/docs/validation/workspace-cleanup-20261020.md +36 -36
  39. package/package.json +256 -255
  40. package/packages/core/examples/basic.ts +87 -87
  41. package/packages/core/src/blocks.ts +442 -442
  42. package/packages/core/src/weights.ts +21 -21
  43. package/screenshots.json +8 -8
@@ -1,58 +1,58 @@
1
- # Issue #128 复审修复记录
2
-
3
- 本轮继续使用独立 Worktree `.worktrees/fix-128-background-worker` 和分支 `codex/fix-128-background-worker`。用户已取消 PR 交付:只保留本地提交、测试及复审材料,不推送、不更新 PR、不合并、不发布。源码固定提交为 `415096f19d09d9bcc29c44634c7ae78fd6c2f52d`(运行时修复提交为 `8a569b911f40f43934406f5362251cf44b2c28f0`,随后增加 Windows CI 并发限制);后续证据提交只增加报告和测量结果。
4
-
5
- ## 根因与修复
6
-
7
- 原 Worker 在上一轮结束后重新安排 3 秒轮询,问题不是计时器重叠,而是每轮完整打开所有 namespace 才判断有无任务,以及 SQLite 打开时重复检查各 namespace 的 FTS 完整性。持久化派生索引已消除这一发现路径。本轮进一步修复独立复审发现的三个问题:
8
-
9
- 1. **未变化的历史消息被重新标记为 FTS dirty。** 快照 UPSERT 会触发 UPDATE,但原触发器不检查变化。现在 UPSERT 跳过完全未变化的消息;FTS 触发器只关注内容、Block 归属、namespace 或 ID 的实际变化。直接 SQL 修改仍会标记旧键和新键,惰性修复保持增量。触发器升级置于事务内,避免安装期间漏掉并发写入。
10
- 2. **前八个损坏键饿死后续健康键。** 重建新增持久化 `rebuild_after`,失败键等待 60 秒;通过到期索引选择下一批,跨重启继续。源数据变化立即重置等待并更换 generation。脏键不会使用过时的调度条目,失败也不会要求零延迟重排。该字段只属于可重建索引的修复信息,没有替代 Job 重试状态。
11
- 3. **只有可封存 open tail 时反复加载而不封存。** Worker 使用 Core 的 `hasSealableTail()`,与实际封存使用同一判定;重启后即使没有任何 Job 也能生成 Block,完成后不再重复打开。直接 SQL 移除或移动 open tail 时也会使旧 namespace 失效。
12
-
13
- 全范围自查及兼容复验另外发现并修复:
14
-
15
- - **额度恢复的毫秒竞态:** 本轮发现时间和历史额度截止时间原先各读一次时钟,跨毫秒时可能把可用额度当作未来到期;现在共享同一个 `now`,回归刻意让每次时钟读取递增。
16
- - **长模型超过租约时重复调用:** Summary、Extraction、Graph、Topic 仅在模型执行期间定期续租。续租只更新持久化 Job 元数据,不加载历史记忆,不修改业务 revision。正常保存会合并同一 running attempt 的新租约;恢复或完成写入在同一事务内校验修改前的租约,防止旧快照缩短租约或覆盖新认领。Topic 完成后仍清除租约,既有状态语义保留。租约停止续期后,原有到期恢复和尝试上限继续生效。
17
- - **空认领产生 revision 写入:** Graph/Topic 无可认领工作时直接返回,避免另一 worker 为一个空认领保存快照并使模型所有者的结果失效。
18
- - **Windows 测试进程压力:** 本地复验捕获了子进程启动 `EBUSY` 及其引起的 Vitest 进程池错误,不能把该轮断言通过当作整体通过。Windows CI 现在最多启动两个测试 worker;单项超时不变。后续在本任务内独立 Node 24/npm 入口下完整复验通过,未更改系统 Node 或其他任务运行时。
19
-
20
- ## 空闲路径与旧任务
21
-
22
- 空闲轮询只检查持久化调度/脏键到期索引、模型是否就绪、历史额度和独立 Profile Maintenance。不会枚举全部 namespace、打开完整记忆、读取原始消息正文、遍历历史 Graph 或重新计算全部 Topic 资格,也不再做全库 FTS 完整性检查。
23
-
24
- Jobs、Event 及 Topic ledger 始终是事实来源。任务保存与派生索引更新在同一事务中完成;同进程通知只是唤醒提示。跨进程写入由 SQLite 触发器留下持久化脏键,原有 3 秒轻量轮询发现它们。升级只初始化键列表,重建按 namespace 和 Event 批次让出事件循环,发布前校验 generation;重启、失败退避或模型未就绪不会丢掉待重建键。Topic 的 Event 版本变化即使尚无 Job,也参与派生资格计算。历史额度到期后恢复,Profile Maintenance 独立运行。
25
-
26
- ## 验证
27
-
28
- - Windows x64 / Node `24.19.0`,`CI=true`:`npm run check`、`npm test`、`npm run build`、`node scripts/verify-package.mjs` 通过。
29
- - Core **306**、DSH **588**、WorkBuddy **10**,共 **904** 项通过,另有 **1** 项既有跳过。
30
- - Issue #128 定向回归共 **32** 项(Core 24、DSH 8)。包括 100 个含历史 namespace 十轮零完整加载;1000 个空闲 namespace 不枚举、不加载;只有任务 namespace 打开;四类调度;8 个坏键加第 9 个健康键及重启、退避解除;600 条旧消息在 Event/使用记录保存后 dirty 为零、检索修复调用为零;旧索引/FTS 升级;只有 open tail 的恢复;模型就绪、到期重试、次数上限、额度恢复和独立 Profile。
31
- - 四类长模型回归使用模拟时钟越过原 5 分钟租约,并启动另一真实 OS 进程;另一个进程模型调用/认领为零,原任务完成,续租计时器清除。另覆盖并发保存合并租约以及过时恢复/完成的事务拒绝。这是时间推进与真实进程竞争测试,不是真实等待数分钟的网络模型测量。
32
- - Windows DSH `0.2.0-rc.1` 的完整隔离兼容脚本已在上述固定源码、独立 Node 24/npm 入口下通过,包括类型检查、588 项 DSH 测试(1 项既有跳过)、构建、干净包安装、CLI 启动、管理接口、会话页及旧迁移。
33
- - Windows DSH `0.2.0-rc.2` 在同一固定源码和入口下完整通过同一流程,588 项 DSH 测试通过(1 项既有跳过),以及干净包安装、真实 CLI 启动、管理接口、会话页和旧迁移。两版脚本均正常退出,退出码为 0。
34
-
35
- 最后一次完整测试中,原超时的 100 namespace 用例为 1.885 秒,历史额度章节重建用例为 2.268 秒;这些耗时包含各自夹具准备,受同机负载影响。没有提高原用例超时。夹具改用一个 writer 准备历史,完整加载计数只从夹具完成后开始。无法读取被封禁账号的 GitHub Actions 日志,因此不能把本地复验解释为已证明此前远端超时的唯一原因,也不声称远端 CI 已通过。
36
-
37
- 单独的 rc.2 兼容轮中,上述两项分别为 0.959 秒和 0.981 秒,全部 DSH 测试用时 23.26 秒;此前整套测试中的 DSH 部分为 50.35 秒。保留两组结果,不用较快一轮代替较慢一轮。
38
-
39
- ## 性能证据
40
-
41
- 前次提交 `bf30690e7a6673f9c2a3a029f7506f368b6f8f9c` 的合成测量保留于 [原始 JSON](benchmarks/issue-128-windows.json),未覆盖。上述固定源码的本轮测量另存为 [本轮 JSON](benchmarks/issue-128-windows-review.json),其中记录了基线、源码 SHA、采集时间、CPU 原始时间和每轮耗时。
42
-
43
- 命令:`node --expose-gc scripts/benchmark-worker-128.mjs`。Windows x64 / Node 24.19.0,每个场景 100 个 namespace,三轮串行 Worker 轮询,每轮结束后仍等待 3 秒,模型使用 stub。先准备一份已完成派生工作的数据库,再分别复制给基线 `e954eaf2f2cbbef4bb6226a2ebb35191424868c2` 和修复源码。基线副本移除新增调度/FTS dirty 触发器、表及 Summary/Extraction 租约列,避免把新维护成本算到旧代码。数据库准备、构建不计入轮询样本;测量时未并行运行本任务构建或测试。
44
-
45
- | 合成库 | 实现 | 进程 CPU 平均 | 平均轮询 ms | RSS 测量前/后 MiB | 峰值 RSS MiB | 三轮完整加载 |
46
- | --- | --- | ---: | ---: | ---: | ---: | ---: |
47
- | 8.53 MiB | 基线 | 19.66% | 2105.68 | 54.23 / 69.82 | 70.84 | 300 |
48
- | 8.53 MiB | 修复 | 0.34% | 13.50 | 53.98 / 51.82 | 55.27 | 0 |
49
- | 1449.42 MiB | 基线 | 61.80% | 10386.64 | 53.68 / 150.11 | 316.73 | 300 |
50
- | 1449.42 MiB | 修复 | 1.20% | 11.74 | 49.68 / 48.69 | 52.05 | 0 |
51
-
52
- CPU 使用 Node 进程 CPU 时间除以包含等待的总墙钟时间;RSS 是被测子进程内存,峰值由 `process.resourceUsage()` 提供。历史体积增加约 170 倍后,修复样本未表现出线性增长的轮询开销;零完整加载和索引查询计划另由定向回归保证。这里只测三轮,CPU 计数分辨率、同机负载及缓存会影响结果,不能据此承诺真实长期 CPU 固定为某个百分比。
53
-
54
- 两次性能测量均是合成库、隔离 Worker 和模拟模型,不是用户 168 MB / 14 namespace 原库或完整 DSH 桌面进程。真实 CLI 兼容验收使用隔离 DSH Home/会话夹具,未接入用户生产数据库。实际原库的长期 CPU、内存、界面响应以及真实网络模型长耗时仍需人工验收。
55
-
56
- ## 离线独立复审
57
-
58
- 本轮没有推送或更新 PR #130。交付本地固定提交、相对基线的完整补丁、变更文件的完整当前/基线源码、Git bundle、本报告、两次原始性能 JSON、已通过的测试/兼容性日志以及中文复审提示词。离线包的 `manifest.json` 记录最终交付 SHA 和各文件 SHA-256;源码冻结在上述提交,后续证据提交只增加文档。复审必须检查整个调度与 FTS 改动,而不仅是三个阻塞项的补丁。
1
+ # Issue #128 复审修复记录
2
+
3
+ 本轮继续使用独立 Worktree `.worktrees/fix-128-background-worker` 和分支 `codex/fix-128-background-worker`。用户已取消 PR 交付:只保留本地提交、测试及复审材料,不推送、不更新 PR、不合并、不发布。源码固定提交为 `415096f19d09d9bcc29c44634c7ae78fd6c2f52d`(运行时修复提交为 `8a569b911f40f43934406f5362251cf44b2c28f0`,随后增加 Windows CI 并发限制);后续证据提交只增加报告和测量结果。
4
+
5
+ ## 根因与修复
6
+
7
+ 原 Worker 在上一轮结束后重新安排 3 秒轮询,问题不是计时器重叠,而是每轮完整打开所有 namespace 才判断有无任务,以及 SQLite 打开时重复检查各 namespace 的 FTS 完整性。持久化派生索引已消除这一发现路径。本轮进一步修复独立复审发现的三个问题:
8
+
9
+ 1. **未变化的历史消息被重新标记为 FTS dirty。** 快照 UPSERT 会触发 UPDATE,但原触发器不检查变化。现在 UPSERT 跳过完全未变化的消息;FTS 触发器只关注内容、Block 归属、namespace 或 ID 的实际变化。直接 SQL 修改仍会标记旧键和新键,惰性修复保持增量。触发器升级置于事务内,避免安装期间漏掉并发写入。
10
+ 2. **前八个损坏键饿死后续健康键。** 重建新增持久化 `rebuild_after`,失败键等待 60 秒;通过到期索引选择下一批,跨重启继续。源数据变化立即重置等待并更换 generation。脏键不会使用过时的调度条目,失败也不会要求零延迟重排。该字段只属于可重建索引的修复信息,没有替代 Job 重试状态。
11
+ 3. **只有可封存 open tail 时反复加载而不封存。** Worker 使用 Core 的 `hasSealableTail()`,与实际封存使用同一判定;重启后即使没有任何 Job 也能生成 Block,完成后不再重复打开。直接 SQL 移除或移动 open tail 时也会使旧 namespace 失效。
12
+
13
+ 全范围自查及兼容复验另外发现并修复:
14
+
15
+ - **额度恢复的毫秒竞态:** 本轮发现时间和历史额度截止时间原先各读一次时钟,跨毫秒时可能把可用额度当作未来到期;现在共享同一个 `now`,回归刻意让每次时钟读取递增。
16
+ - **长模型超过租约时重复调用:** Summary、Extraction、Graph、Topic 仅在模型执行期间定期续租。续租只更新持久化 Job 元数据,不加载历史记忆,不修改业务 revision。正常保存会合并同一 running attempt 的新租约;恢复或完成写入在同一事务内校验修改前的租约,防止旧快照缩短租约或覆盖新认领。Topic 完成后仍清除租约,既有状态语义保留。租约停止续期后,原有到期恢复和尝试上限继续生效。
17
+ - **空认领产生 revision 写入:** Graph/Topic 无可认领工作时直接返回,避免另一 worker 为一个空认领保存快照并使模型所有者的结果失效。
18
+ - **Windows 测试进程压力:** 本地复验捕获了子进程启动 `EBUSY` 及其引起的 Vitest 进程池错误,不能把该轮断言通过当作整体通过。Windows CI 现在最多启动两个测试 worker;单项超时不变。后续在本任务内独立 Node 24/npm 入口下完整复验通过,未更改系统 Node 或其他任务运行时。
19
+
20
+ ## 空闲路径与旧任务
21
+
22
+ 空闲轮询只检查持久化调度/脏键到期索引、模型是否就绪、历史额度和独立 Profile Maintenance。不会枚举全部 namespace、打开完整记忆、读取原始消息正文、遍历历史 Graph 或重新计算全部 Topic 资格,也不再做全库 FTS 完整性检查。
23
+
24
+ Jobs、Event 及 Topic ledger 始终是事实来源。任务保存与派生索引更新在同一事务中完成;同进程通知只是唤醒提示。跨进程写入由 SQLite 触发器留下持久化脏键,原有 3 秒轻量轮询发现它们。升级只初始化键列表,重建按 namespace 和 Event 批次让出事件循环,发布前校验 generation;重启、失败退避或模型未就绪不会丢掉待重建键。Topic 的 Event 版本变化即使尚无 Job,也参与派生资格计算。历史额度到期后恢复,Profile Maintenance 独立运行。
25
+
26
+ ## 验证
27
+
28
+ - Windows x64 / Node `24.19.0`,`CI=true`:`npm run check`、`npm test`、`npm run build`、`node scripts/verify-package.mjs` 通过。
29
+ - Core **306**、DSH **588**、WorkBuddy **10**,共 **904** 项通过,另有 **1** 项既有跳过。
30
+ - Issue #128 定向回归共 **32** 项(Core 24、DSH 8)。包括 100 个含历史 namespace 十轮零完整加载;1000 个空闲 namespace 不枚举、不加载;只有任务 namespace 打开;四类调度;8 个坏键加第 9 个健康键及重启、退避解除;600 条旧消息在 Event/使用记录保存后 dirty 为零、检索修复调用为零;旧索引/FTS 升级;只有 open tail 的恢复;模型就绪、到期重试、次数上限、额度恢复和独立 Profile。
31
+ - 四类长模型回归使用模拟时钟越过原 5 分钟租约,并启动另一真实 OS 进程;另一个进程模型调用/认领为零,原任务完成,续租计时器清除。另覆盖并发保存合并租约以及过时恢复/完成的事务拒绝。这是时间推进与真实进程竞争测试,不是真实等待数分钟的网络模型测量。
32
+ - Windows DSH `0.2.0-rc.1` 的完整隔离兼容脚本已在上述固定源码、独立 Node 24/npm 入口下通过,包括类型检查、588 项 DSH 测试(1 项既有跳过)、构建、干净包安装、CLI 启动、管理接口、会话页及旧迁移。
33
+ - Windows DSH `0.2.0-rc.2` 在同一固定源码和入口下完整通过同一流程,588 项 DSH 测试通过(1 项既有跳过),以及干净包安装、真实 CLI 启动、管理接口、会话页和旧迁移。两版脚本均正常退出,退出码为 0。
34
+
35
+ 最后一次完整测试中,原超时的 100 namespace 用例为 1.885 秒,历史额度章节重建用例为 2.268 秒;这些耗时包含各自夹具准备,受同机负载影响。没有提高原用例超时。夹具改用一个 writer 准备历史,完整加载计数只从夹具完成后开始。无法读取被封禁账号的 GitHub Actions 日志,因此不能把本地复验解释为已证明此前远端超时的唯一原因,也不声称远端 CI 已通过。
36
+
37
+ 单独的 rc.2 兼容轮中,上述两项分别为 0.959 秒和 0.981 秒,全部 DSH 测试用时 23.26 秒;此前整套测试中的 DSH 部分为 50.35 秒。保留两组结果,不用较快一轮代替较慢一轮。
38
+
39
+ ## 性能证据
40
+
41
+ 前次提交 `bf30690e7a6673f9c2a3a029f7506f368b6f8f9c` 的合成测量保留于 [原始 JSON](benchmarks/issue-128-windows.json),未覆盖。上述固定源码的本轮测量另存为 [本轮 JSON](benchmarks/issue-128-windows-review.json),其中记录了基线、源码 SHA、采集时间、CPU 原始时间和每轮耗时。
42
+
43
+ 命令:`node --expose-gc scripts/benchmark-worker-128.mjs`。Windows x64 / Node 24.19.0,每个场景 100 个 namespace,三轮串行 Worker 轮询,每轮结束后仍等待 3 秒,模型使用 stub。先准备一份已完成派生工作的数据库,再分别复制给基线 `e954eaf2f2cbbef4bb6226a2ebb35191424868c2` 和修复源码。基线副本移除新增调度/FTS dirty 触发器、表及 Summary/Extraction 租约列,避免把新维护成本算到旧代码。数据库准备、构建不计入轮询样本;测量时未并行运行本任务构建或测试。
44
+
45
+ | 合成库 | 实现 | 进程 CPU 平均 | 平均轮询 ms | RSS 测量前/后 MiB | 峰值 RSS MiB | 三轮完整加载 |
46
+ | --- | --- | ---: | ---: | ---: | ---: | ---: |
47
+ | 8.53 MiB | 基线 | 19.66% | 2105.68 | 54.23 / 69.82 | 70.84 | 300 |
48
+ | 8.53 MiB | 修复 | 0.34% | 13.50 | 53.98 / 51.82 | 55.27 | 0 |
49
+ | 1449.42 MiB | 基线 | 61.80% | 10386.64 | 53.68 / 150.11 | 316.73 | 300 |
50
+ | 1449.42 MiB | 修复 | 1.20% | 11.74 | 49.68 / 48.69 | 52.05 | 0 |
51
+
52
+ CPU 使用 Node 进程 CPU 时间除以包含等待的总墙钟时间;RSS 是被测子进程内存,峰值由 `process.resourceUsage()` 提供。历史体积增加约 170 倍后,修复样本未表现出线性增长的轮询开销;零完整加载和索引查询计划另由定向回归保证。这里只测三轮,CPU 计数分辨率、同机负载及缓存会影响结果,不能据此承诺真实长期 CPU 固定为某个百分比。
53
+
54
+ 两次性能测量均是合成库、隔离 Worker 和模拟模型,不是用户 168 MB / 14 namespace 原库或完整 DSH 桌面进程。真实 CLI 兼容验收使用隔离 DSH Home/会话夹具,未接入用户生产数据库。实际原库的长期 CPU、内存、界面响应以及真实网络模型长耗时仍需人工验收。
55
+
56
+ ## 离线独立复审
57
+
58
+ 本轮没有推送或更新 PR #130。交付本地固定提交、相对基线的完整补丁、变更文件的完整当前/基线源码、Git bundle、本报告、两次原始性能 JSON、已通过的测试/兼容性日志以及中文复审提示词。离线包的 `manifest.json` 记录最终交付 SHA 和各文件 SHA-256;源码冻结在上述提交,后续证据提交只增加文档。复审必须检查整个调度与 FTS 改动,而不仅是三个阻塞项的补丁。
@@ -1,38 +1,38 @@
1
- # 可选知识图谱(第一阶段)
2
-
3
- 知识图谱默认关闭。事件卡、主题目录、普通记忆检索和常驻 Profile 独立工作;关闭图谱不会删除已有节点、边、来源、事件或处理记录,也不会重新提取事件或重建目录。
4
-
5
- ## 使用方式
6
-
7
- 在记忆界面的 **更多 → 高级设置 → 记忆配置 → 启用知识图谱** 操作。
8
-
9
- - 新安装默认隐藏长期记忆中的图谱页;开启后显示,曾经开启后关闭仍保留入口。
10
- - 已有数据库升级默认关闭,保留入口并将图谱内容置灰;首次进入设置显示说明,点击“我知道了”后持久记录,不再显示。
11
- - 图谱与事件卡、目录存在部分重复。开启会额外调用模型整理实体和关系,后续维护、补建和自动注入也会增加 token 消耗;可随时关闭或重新开启。
12
- - 开启和继续先统计各空间尚未完成的事件。存在待处理事件时,显示数量和预计批次数,用户确认后才启用。没有待处理事件时直接恢复查询和展示。
13
- - 确认只批准统计时的有限事件 ID 清单,不在每次启动时自动扩展历史范围。此前代次的排队任务(包括没有创建代次的旧任务)只能处理本次批准的有效来源;批次内未批准、已遗忘或已归档的事件不会送入模型。正常启用期间产生的新事件沿用原有增量投影,无须第二次审批。每批最多 8 条,每轮处理一批,沿用现有租约、并发竞争、退避和最多 3 次尝试限制;手动重试才另开尝试预算。
14
- - “暂停图谱任务”暂停投影和补建,保留查询;“统计并继续图谱任务”重新统计和确认。关闭开关同时停用图谱查询和自动注入。
15
-
16
- ## 持久化与迁移
17
-
18
- DSH 使用数据库内既有 `stratagate_dsh_settings`:`graphEnabled` 保存用户选择,`graphControl` 保存暂停、控制代次、首次说明状态和有限补建清单;`graphPolicyMigration` 标记一次性初始化。首次缺少开关时写入 `false`;已有明确值保持不变。只读浏览旧库不触发写入迁移,首次设置操作或正常写入启动时完成初始化。
19
-
20
- Core 为 `memory_spaces` 添加 `graph_enabled`、`graph_epoch`,以 `stratagate_graph_policy_migrations` 标记兼容迁移,保留当前 schema 版本和旧数据结构。SDK 默认同样关闭,可用 `graphEnabled: true` 显式创建开启的新空间;打开已有空间尊重持久状态。对已有空间先读取 `graphBackfillEventIds()`,用户确认后调用 `setGraphEnabled(true, approvedIds)`,不自动补建未批准历史。DSH 的安装级设置优先于 Core 空间配置。
21
-
22
- SDK 的有限批准清单复用 `memory_spaces` 配置行,兼容增加 `graph_approved_event_ids_json` 文本列保存;缺失时按空清单读取,writer 首次打开时添加列,不改变 schema 版本或既有图谱内容。任务 JSON 的可选 `createdEpoch` 仅用于区分本代次新增任务与历史任务;缺少该字段不会获得自动处理权限。调度索引升级规则版本后按相同来源过滤规则重建,避免后台重复发现不可执行任务。
23
-
24
- ## 关闭时的运行时边界
25
-
26
- 关闭会阻止新投影入队、历史补建、后台图谱调度、过期任务恢复、自动和手动重试、自动图谱召回及上下文注入。普通 Agent 不再注册 `memory_search_graph`、`memory_expand_graph_node`、历史 `memory_expand_element`;已取得的工具引用也会再次检查状态。管理员仍可读取保留的数据用于灰色展示。
27
-
28
- 每次关闭或暂停递增控制代次。领取任务、模型请求及其内部格式重试检查代次;完成、失败和租约续期也检查。每次领取还生成独立的持久化 `claimToken`,所以租约过期后同一任务 ID 的新 attempt 不会接受旧请求的迟到结果。SQLite 在写事务内再次核验,拒绝关闭期间、旧代次或旧 attempt 的迟到结果。并发事件提取仍可提交事实,但提交时会剔除新产生的图谱排队任务。重新确认恢复时使用新的任务 ID,保留已消耗的尝试次数;已耗尽三次尝试的旧代次任务保持失败终态,不会复制成不可执行的 `pending` 任务,旧请求也不能覆盖新任务。
29
-
30
- 恢复不会清空既有终态错误或隐式重置次数;已存在的错误 `pending + attempts>=3` 记录会收敛为明确失败。显式手动重试仍沿用原有入口并开启新预算,每次重试都创建新的任务 ID(同一代次也如此),旧失败记录保留审计信息。`memory_assess.next_strategy` 与 Graph 工具一起动态更新,关闭时不再提示图谱检索或历史 Element 工具。
31
-
32
- 已经发给供应商的请求无法保证撤回,其剩余 token 可能仍计费;此结果不会写回图谱,也不会继续发起内部重试。
33
-
34
- ## 降级限制
35
-
36
- 旧版本不认识 `graphEnabled` 及控制代次。数据库仍可被旧版本打开,但降级运行可能重新启用图谱处理、补建、工具和自动注入,也无法保证拦截迟到结果。关闭状态的运行时保证仅适用于支持此开关的版本;不要同时运行新旧版本写入同一数据库。
37
-
38
- 本阶段不增加每日 MD,不改变事件卡提取、目录生成更新或 Dreaming 职责。
1
+ # 可选知识图谱(第一阶段)
2
+
3
+ 知识图谱默认关闭。事件卡、主题目录、普通记忆检索和常驻 Profile 独立工作;关闭图谱不会删除已有节点、边、来源、事件或处理记录,也不会重新提取事件或重建目录。
4
+
5
+ ## 使用方式
6
+
7
+ 在记忆界面的 **更多 → 高级设置 → 记忆配置 → 启用知识图谱** 操作。
8
+
9
+ - 新安装默认隐藏长期记忆中的图谱页;开启后显示,曾经开启后关闭仍保留入口。
10
+ - 已有数据库升级默认关闭,保留入口并将图谱内容置灰;首次进入设置显示说明,点击“我知道了”后持久记录,不再显示。
11
+ - 图谱与事件卡、目录存在部分重复。开启会额外调用模型整理实体和关系,后续维护、补建和自动注入也会增加 token 消耗;可随时关闭或重新开启。
12
+ - 开启和继续先统计各空间尚未完成的事件。存在待处理事件时,显示数量和预计批次数,用户确认后才启用。没有待处理事件时直接恢复查询和展示。
13
+ - 确认只批准统计时的有限事件 ID 清单,不在每次启动时自动扩展历史范围。此前代次的排队任务(包括没有创建代次的旧任务)只能处理本次批准的有效来源;批次内未批准、已遗忘或已归档的事件不会送入模型。正常启用期间产生的新事件沿用原有增量投影,无须第二次审批。每批最多 8 条,每轮处理一批,沿用现有租约、并发竞争、退避和最多 3 次尝试限制;手动重试才另开尝试预算。
14
+ - “暂停图谱任务”暂停投影和补建,保留查询;“统计并继续图谱任务”重新统计和确认。关闭开关同时停用图谱查询和自动注入。
15
+
16
+ ## 持久化与迁移
17
+
18
+ DSH 使用数据库内既有 `stratagate_dsh_settings`:`graphEnabled` 保存用户选择,`graphControl` 保存暂停、控制代次、首次说明状态和有限补建清单;`graphPolicyMigration` 标记一次性初始化。首次缺少开关时写入 `false`;已有明确值保持不变。只读浏览旧库不触发写入迁移,首次设置操作或正常写入启动时完成初始化。
19
+
20
+ Core 为 `memory_spaces` 添加 `graph_enabled`、`graph_epoch`,以 `stratagate_graph_policy_migrations` 标记兼容迁移,保留当前 schema 版本和旧数据结构。SDK 默认同样关闭,可用 `graphEnabled: true` 显式创建开启的新空间;打开已有空间尊重持久状态。对已有空间先读取 `graphBackfillEventIds()`,用户确认后调用 `setGraphEnabled(true, approvedIds)`,不自动补建未批准历史。DSH 的安装级设置优先于 Core 空间配置。
21
+
22
+ SDK 的有限批准清单复用 `memory_spaces` 配置行,兼容增加 `graph_approved_event_ids_json` 文本列保存;缺失时按空清单读取,writer 首次打开时添加列,不改变 schema 版本或既有图谱内容。任务 JSON 的可选 `createdEpoch` 仅用于区分本代次新增任务与历史任务;缺少该字段不会获得自动处理权限。调度索引升级规则版本后按相同来源过滤规则重建,避免后台重复发现不可执行任务。
23
+
24
+ ## 关闭时的运行时边界
25
+
26
+ 关闭会阻止新投影入队、历史补建、后台图谱调度、过期任务恢复、自动和手动重试、自动图谱召回及上下文注入。普通 Agent 不再注册 `memory_search_graph`、`memory_expand_graph_node`、历史 `memory_expand_element`;已取得的工具引用也会再次检查状态。管理员仍可读取保留的数据用于灰色展示。
27
+
28
+ 每次关闭或暂停递增控制代次。领取任务、模型请求及其内部格式重试检查代次;完成、失败和租约续期也检查。每次领取还生成独立的持久化 `claimToken`,所以租约过期后同一任务 ID 的新 attempt 不会接受旧请求的迟到结果。SQLite 在写事务内再次核验,拒绝关闭期间、旧代次或旧 attempt 的迟到结果。并发事件提取仍可提交事实,但提交时会剔除新产生的图谱排队任务。重新确认恢复时使用新的任务 ID,保留已消耗的尝试次数;已耗尽三次尝试的旧代次任务保持失败终态,不会复制成不可执行的 `pending` 任务,旧请求也不能覆盖新任务。
29
+
30
+ 恢复不会清空既有终态错误或隐式重置次数;已存在的错误 `pending + attempts>=3` 记录会收敛为明确失败。显式手动重试仍沿用原有入口并开启新预算,每次重试都创建新的任务 ID(同一代次也如此),旧失败记录保留审计信息。`memory_assess.next_strategy` 与 Graph 工具一起动态更新,关闭时不再提示图谱检索或历史 Element 工具。
31
+
32
+ 已经发给供应商的请求无法保证撤回,其剩余 token 可能仍计费;此结果不会写回图谱,也不会继续发起内部重试。
33
+
34
+ ## 降级限制
35
+
36
+ 旧版本不认识 `graphEnabled` 及控制代次。数据库仍可被旧版本打开,但降级运行可能重新启用图谱处理、补建、工具和自动注入,也无法保证拦截迟到结果。关闭状态的运行时保证仅适用于支持此开关的版本;不要同时运行新旧版本写入同一数据库。
37
+
38
+ 本阶段不增加每日 MD,不改变事件卡提取、目录生成更新或 Dreaming 职责。
@@ -1,53 +1,55 @@
1
- # npm 暂存发布
2
-
3
- 目标是把大包上传、网络重试放在用户认证之前。当前仅走 npm;GitHub 恢复前不执行 PR、CI、Tag、Release、trusted publishing 或 Roadmap 同步。
4
-
5
- ## 前置条件
6
-
7
- - 用户已验收候选并明确授权正式发布;本脚本不会代替验收、源码审查或相关测试。
8
- - 正式源码已固定,版本和锁文件一致,正式 `.tgz` 已构建、校验并记录 SHA-256。不得用候选版本代替正式版本,也不重新打包覆盖原文件。
9
- - 正式包内 `README.md` 和 `README.zh-CN.md` 必须与已审查源码字节一致;本地图片和文档链接必须存在。`status` 和 `stage` 共用这一检查,避免 npm 展示旧 README。
10
- - 使用满足项目 engines 的 Node,及支持 `npm stage publish/list/view/download/approve` 的 npm CLI。
11
- - 复用现有 npm 登录。只有登录确实不可用时才要求用户登录;发布认证与账号登录是两件事。
12
-
13
- ## 执行
14
-
15
- 使用 `scripts/release-npm.mjs`;所有路径参数可为绝对路径。以下 PowerShell 变量需替换为本次真实证据,不要复制历史临时 npm 路径或硬编码 registry IP:
16
-
17
- ```powershell
18
- $releaseArgs = @(
19
- '--artifact', '<已校验的正式包.tgz>',
20
- '--sha256', '<审查时记录的SHA-256>',
21
- '--evidence', '<本次独立证据目录>',
22
- '--npm-cli', '<支持stage的npm-cli.js>',
23
- '--userconfig', '<当前有效的npmrc>'
24
- )
25
- node scripts/release-npm.mjs @releaseArgs --action status
26
- node scripts/release-npm.mjs @releaseArgs --action stage
27
- # validating 时等待后再执行 stage,复用同一个 stageId,不重新上传。
28
- # STAGE_VERIFIED 后,才进入需要用户在 Edge 完成认证的步骤。
29
- node scripts/release-npm.mjs @releaseArgs --action approve
30
- node scripts/release-npm.mjs @releaseArgs --action verify
31
- ```
32
-
33
- `status` 为默认操作,只查询远端、记录本地状态;已发布但尚未做完整下载核验时返回 `PUBLISHED_NEEDS_VERIFICATION`,执行 `verify` 下载核验即可,不再上传或认证。`stage` 上传或复用暂存包,并下载比对 SHA-256;`approve` 只批准已有、通过字节校验的暂存包,不会上传新包,批准成功后自动核验公开包。发布过程中保持进程运行,给用户实际返回的认证链接,禁止打开内置浏览器。用户确认完成后先检查原进程,不要另起一条 approve。
34
-
35
- 脚本保留 `npm-release-state.json` 和下载的暂存包,使用进程锁避免同一证据目录并发认证。记录不包含 npm token、OTP 或 npmrc 内容。脚本只调用官方 registry,不关闭 TLS 校验,也不更改系统代理或 DNS。
36
-
37
- ## 中断恢复
38
-
39
- - 每次先查公开版本:同版本内容一致就核验并结束,不再上传或认证;内容冲突则停止。tag 不一致单独报告,不重新发布。
40
- - 上传结果不明:先 `status`,远端存在匹配暂存包就复用。无远端记录时不自动再次上传;核实失败后才用 `stage --retry-upload`。本地没有记录时也会查询远端,避免跨进程重传。
41
- - 认证或批准请求断线:先检查原进程、公开版本和 stage 状态。脚本保留 `APPROVAL_UNCERTAIN`,不自动再认证。确认确实未发布且需要重试后才用 `approve --retry-approval`。
42
- - 原进程仍运行时等待原进程;不要创建新认证链接。失效链接只在实际重新发起必要认证时替换。
43
- - 网络、权限、服务器校验失败时保留包和证据,先排查原因,不退回直接 `npm publish` 循环,不通过关闭二次认证来减少操作。
44
-
45
- 通常只需要最后一次发布认证;登录过期、认证链接过期或服务端明确要求时仍可能需要额外认证,不能保证永远只有一次。
46
-
47
- ## 本地验证脚本
48
-
49
- ```powershell
50
- node --test tests/npm-release.test.mjs
51
- ```
52
-
53
- 测试使用模拟 npm 和 registry,覆盖恢复、重复上传防护、认证失败和字节冲突,不访问真实发布接口。
1
+ # npm 暂存发布
2
+
3
+ GitHub 账号已于 2026-11-05 恢复。正式发布默认恢复 `.github/workflows/release-dsh.yml` 的 GitHub Actions trusted-publishing 路径:发布源码进入 `origin/main`,通过相关 CI,再由同一提交生成 npm 包、Tag / Release、版本包、固定名称包和源码归档,核验后更新 Roadmap #93,并同步 Gitee。发包仍须已有发布授权和候选验收;仓库同步不等于发布授权。
4
+
5
+ 本页记录需要明确采用的本地 npm 暂存备用路径,目标是把大包上传、网络重试放在用户认证之前。采用备用路径仍须同步 GitHub 源码、CI、Tag / Release 资产与 Roadmap;npm 已公开时只补齐 GitHub,不重新发布或重新构建来替换已验收包。GitHub 包资产应复用经下载核验的公开 npm 包,两个包资产字节一致;源码归档对应已核实的发布提交。历史版本缺乏提交或包哈希证据时标注缺口,不补造 provenance。不要对已公开版本直接触发会再次执行 npm publish 的旧发布工作流。
6
+
7
+ ## 前置条件
8
+
9
+ - 用户已验收候选并明确授权正式发布;本脚本不会代替验收、源码审查或相关测试。
10
+ - 正式源码已固定,版本和锁文件一致,正式 `.tgz` 已构建、校验并记录 SHA-256。不得用候选版本代替正式版本,也不重新打包覆盖原文件。
11
+ - 正式包内 `README.md` 和 `README.zh-CN.md` 必须与已审查源码字节一致;本地图片和文档链接必须存在。`status` 和 `stage` 共用这一检查,避免 npm 展示旧 README。
12
+ - 使用满足项目 engines 的 Node,及支持 `npm stage publish/list/view/download/approve` 的 npm CLI。
13
+ - 复用现有 npm 登录。只有登录确实不可用时才要求用户登录;发布认证与账号登录是两件事。
14
+
15
+ ## 执行
16
+
17
+ 使用 `scripts/release-npm.mjs`;所有路径参数可为绝对路径。以下 PowerShell 变量需替换为本次真实证据,不要复制历史临时 npm 路径或硬编码 registry IP:
18
+
19
+ ```powershell
20
+ $releaseArgs = @(
21
+ '--artifact', '<已校验的正式包.tgz>',
22
+ '--sha256', '<审查时记录的SHA-256>',
23
+ '--evidence', '<本次独立证据目录>',
24
+ '--npm-cli', '<支持stage的npm-cli.js>',
25
+ '--userconfig', '<当前有效的npmrc>'
26
+ )
27
+ node scripts/release-npm.mjs @releaseArgs --action status
28
+ node scripts/release-npm.mjs @releaseArgs --action stage
29
+ # validating 时等待后再执行 stage,复用同一个 stageId,不重新上传。
30
+ # STAGE_VERIFIED 后,才进入需要用户在 Edge 完成认证的步骤。
31
+ node scripts/release-npm.mjs @releaseArgs --action approve
32
+ node scripts/release-npm.mjs @releaseArgs --action verify
33
+ ```
34
+
35
+ `status` 为默认操作,只查询远端、记录本地状态;已发布但尚未做完整下载核验时返回 `PUBLISHED_NEEDS_VERIFICATION`,执行 `verify` 下载核验即可,不再上传或认证。`stage` 上传或复用暂存包,并下载比对 SHA-256;`approve` 只批准已有、通过字节校验的暂存包,不会上传新包,批准成功后自动核验公开包。发布过程中保持进程运行,给用户实际返回的认证链接,禁止打开内置浏览器。用户确认完成后先检查原进程,不要另起一条 approve。
36
+
37
+ 脚本保留 `npm-release-state.json` 和下载的暂存包,使用进程锁避免同一证据目录并发认证。记录不包含 npm token、OTP 或 npmrc 内容。脚本只调用官方 registry,不关闭 TLS 校验,也不更改系统代理或 DNS。
38
+
39
+ ## 中断恢复
40
+
41
+ - 每次先查公开版本:同版本内容一致就核验并结束,不再上传或认证;内容冲突则停止。tag 不一致单独报告,不重新发布。
42
+ - 上传结果不明:先 `status`,远端存在匹配暂存包就复用。无远端记录时不自动再次上传;核实失败后才用 `stage --retry-upload`。本地没有记录时也会查询远端,避免跨进程重传。
43
+ - 认证或批准请求断线:先检查原进程、公开版本和 stage 状态。脚本保留 `APPROVAL_UNCERTAIN`,不自动再认证。确认确实未发布且需要重试后才用 `approve --retry-approval`。
44
+ - 原进程仍运行时等待原进程;不要创建新认证链接。失效链接只在实际重新发起必要认证时替换。
45
+ - 网络、权限、服务器校验失败时保留包和证据,先排查原因,不退回直接 `npm publish` 循环,不通过关闭二次认证来减少操作。
46
+
47
+ 通常只需要最后一次发布认证;登录过期、认证链接过期或服务端明确要求时仍可能需要额外认证,不能保证永远只有一次。
48
+
49
+ ## 本地验证脚本
50
+
51
+ ```powershell
52
+ node --test tests/npm-release.test.mjs
53
+ ```
54
+
55
+ 测试使用模拟 npm 和 registry,覆盖恢复、重复上传防护、认证失败和字节冲突,不访问真实发布接口。
@@ -1,36 +1,36 @@
1
- # 长会话表面对账
2
-
3
- 记忆组装默认读取现有 checkpoint。自动衰减对账改在回合结束后做;用户明确提层和当前请求需要的容量修复仍及时执行。
4
-
5
- 用户手动选择优先于自动单块预算;已生效的手动选择不会被容量修复立即降回低层。整体窗口检查、具体等待或失败说明和相邻用户操作的保护规则见[用户操作优先级](user-operation-priority.md)。
6
-
7
- ## 写入规则
8
-
9
- - 一轮对账收集每个 Block 的最终层级,再调用一次 `setBlockSurfaceLevels()`。
10
- - 相同层级不写库,不生成快照,也不更新 revision。检查在写队列内完成,避免并发的相同请求重复提交。
11
- - 单条 `setBlockSurfaceLevel()` 保留,内部使用批量接口。
12
- - 数据库层级更新具有事务性。原生会话日志与记忆库分别保存;中途失败时,按实际 checkpoint 重算和重试,不能视作跨库事务。
13
-
14
- ## 后台什么时候跑
15
-
16
- 封块、派生完成、衰减设置变化、宿主压缩或容量变化后,给会话标记待处理。同一会话的任务会合并。
17
-
18
- 新回合开始时暂停未执行的维护。组装正在等待检索时也不启动维护。任务等相关入库完成后,基于最新状态计算并连续应用 checkpoint,再统一记账。计算和应用之间没有异步等待,避免旧文本在后来的用户提层之后生效。
19
-
20
- `flush()` 只等待入库,不等待自动表面维护。失败后保留待处理状态并退避重试;关闭时取消定时器,等待已开始的任务结束。重启后会检查现有 checkpoint,也会尝试补回保存 Block 后丢失的封块请求;宿主已压缩掉的原始范围不会被重新插入。
21
-
22
- 自动恢复只处理原片段仍在当前上下文中的 Block。宿主压缩后失效的自动任务会移出队列,后续对账不再为这些历史 Block 渲染内容;每轮共用一次来源筛查。用户明确选择仍保留同步失败原因,保存失败且来源仍在的任务继续重试。
23
-
24
- ## 怎么验证
25
-
26
- 相关测试:`packages/core/tests/surface-levels.test.ts`、`tests/surface-maintenance.test.ts`、`tests/issue81-surface.test.ts`。
27
-
28
- 用符合项目要求的 Node 版本执行:
29
-
30
- ```powershell
31
- node scripts/benchmark-surface-assembly.mjs --base=<修复前的提交> --rounds=12
32
- ```
33
-
34
- 脚本只使用临时目录里的构造数据和 SQLite,不打开用户数据库。基线 runtime/store 从指定 Git 提交读取,其余依赖共用当前版本。结果、逐轮样本、源码哈希及两个版本的构建文件保存在 `.benchmarks/surface-*/`。
35
-
36
- 测试区分首次需要衰减的组装、维护后的稳定组装、后台对账,以及重复调用同值 setter。没有接入真实向量服务,因此耗时不能代替真实长会话的端到端测量。事件循环延迟使用 1ms 分辨率的 `monitorEventLoopDelay`,包括调度延迟。
1
+ # 长会话表面对账
2
+
3
+ 记忆组装默认读取现有 checkpoint。自动衰减对账改在回合结束后做;用户明确提层和当前请求需要的容量修复仍及时执行。
4
+
5
+ 用户手动选择优先于自动单块预算;已生效的手动选择不会被容量修复立即降回低层。整体窗口检查、具体等待或失败说明和相邻用户操作的保护规则见[用户操作优先级](user-operation-priority.md)。
6
+
7
+ ## 写入规则
8
+
9
+ - 一轮对账收集每个 Block 的最终层级,再调用一次 `setBlockSurfaceLevels()`。
10
+ - 相同层级不写库,不生成快照,也不更新 revision。检查在写队列内完成,避免并发的相同请求重复提交。
11
+ - 单条 `setBlockSurfaceLevel()` 保留,内部使用批量接口。
12
+ - 数据库层级更新具有事务性。原生会话日志与记忆库分别保存;中途失败时,按实际 checkpoint 重算和重试,不能视作跨库事务。
13
+
14
+ ## 后台什么时候跑
15
+
16
+ 封块、派生完成、衰减设置变化、宿主压缩或容量变化后,给会话标记待处理。同一会话的任务会合并。
17
+
18
+ 新回合开始时暂停未执行的维护。组装正在等待检索时也不启动维护。任务等相关入库完成后,基于最新状态计算并连续应用 checkpoint,再统一记账。计算和应用之间没有异步等待,避免旧文本在后来的用户提层之后生效。
19
+
20
+ `flush()` 只等待入库,不等待自动表面维护。失败后保留待处理状态并退避重试;关闭时取消定时器,等待已开始的任务结束。重启后会检查现有 checkpoint,也会尝试补回保存 Block 后丢失的封块请求;宿主已压缩掉的原始范围不会被重新插入。
21
+
22
+ 自动恢复只处理原片段仍在当前上下文中的 Block。宿主压缩后失效的自动任务会移出队列,后续对账不再为这些历史 Block 渲染内容;每轮共用一次来源筛查。用户明确选择仍保留同步失败原因,保存失败且来源仍在的任务继续重试。
23
+
24
+ ## 怎么验证
25
+
26
+ 相关测试:`packages/core/tests/surface-levels.test.ts`、`tests/surface-maintenance.test.ts`、`tests/issue81-surface.test.ts`。
27
+
28
+ 用符合项目要求的 Node 版本执行:
29
+
30
+ ```powershell
31
+ node scripts/benchmark-surface-assembly.mjs --base=<修复前的提交> --rounds=12
32
+ ```
33
+
34
+ 脚本只使用临时目录里的构造数据和 SQLite,不打开用户数据库。基线 runtime/store 从指定 Git 提交读取,其余依赖共用当前版本。结果、逐轮样本、源码哈希及两个版本的构建文件保存在 `.benchmarks/surface-*/`。
35
+
36
+ 测试区分首次需要衰减的组装、维护后的稳定组装、后台对账,以及重复调用同值 setter。没有接入真实向量服务,因此耗时不能代替真实长会话的端到端测量。事件循环延迟使用 1ms 分辨率的 `monitorEventLoopDelay`,包括调度延迟。
@@ -1,39 +1,46 @@
1
- # 用户操作优先级
2
-
3
- 用户在面板中明确选择的层级,优先于自动压缩的单块预算和 Agent 的证据读取。模型上下文总容量、原会话是否仍可替换、数据一致性及破坏性操作的保护仍然有效。
4
-
5
- ## Block 层级选择
6
-
7
- - 自动封块和衰减继续使用 `min(4096 tokens, 模型窗口的 4%)` 的单块限制。用户手动选择不使用这项限制,也不要求展开后的内容必须比原内容小。
8
- - 已加载会话在保存选择前,估算替换后的整段会话大小,并计入已知工具定义及输出预留。预计超过模型窗口且会使占用增加时,先从最旧的自动管理历史块中逐层简略,腾够空间就停止;保留其他手动选择、当前输入和工具调用链。只替换本插件已有的历史展示片段,保留原文和恢复能力,不额外调用模型。
9
- - 容量方案在写入前整体检查。腾出所有可用空间仍不足时,不修改任何历史展示或展开指针,就地说明当前模型预计放不下,并提供选择更简略层级或切换更大模型的下一步。缩小内容的选择仍可执行。
10
- - 估算不是模型 tokenizer 的精确计数;模型窗口未提供时,不推测为 4096。之后宿主组装的新提示、工具变更及模型服务的实际限制仍由宿主处理。
11
- - 用户可选择更高或更低层级,也可重新选择当前层级来替换尚未生效的旧请求。自动维护不能立即用单块限制撤销用户选择。
12
- - 选择会重设衰减起点。新封存块继续增长后,仍按原规则自然衰减;这不是永久置顶。
13
- - Agent 工具仍返回所请求层的证据;已有用户选择时,不改用户层级、来源或衰减起点,也不为这一只读结果生成快照。
14
-
15
- ## 同步结果
16
-
17
- - 点击历史块只打开“分层内容预览”,预览不改变助手可见的内容;每层用“让助手参考 L4”等直接按钮应用选择。“助手可见层级”只显示已确认的实际层级,尚无确认信息时显示“尚未确认”。助手可见不表示助手已经读过或采用。
18
- - `applied`:所选内容已写入原生会话并完成保存。直接更新实际层级,短暂显示“已应用 L4,供助手后续回复参考。”,不留下永久来源徽章。
19
- - `pending`:选择已保存,但所属会话尚未加载、仍在整理或正在保存。对应历史块旁说明“打开这段对话后生效”等具体情况,以及助手当前仍可见的层级。
20
- - `blocked`:会话加载后发现整体容量不足,或原片段已不可替换。对应历史块旁说明原因、当前有效层级和下一步,并记录错误;普通请求不再反复渲染该任务。请求中断、保存报错或刷新失败时,提示暂时无法确认结果,标明上次确认的层级,并提供“刷新状态”,不谎报应用失败。
21
-
22
- 正常操作不因插件的内部阈值弹出二次确认。涉及新的费用或授权、破坏性操作、改变其他手动选择时,才让用户作出实质决定。主流程使用用户熟悉的说法,技术细节按需展开。
23
-
24
- 容量阻塞会在模型路由容量、工具定义或输出预留变化,以及宿主整理后重新检查;相同请求头不会触发无效重试。用户重新选择会立即重新检查。来源片段不可替换时,保留明确失败状态,不自动复活宿主已压缩掉的内容。
25
-
26
- 原生会话日志与记忆库不是同一个事务。保存中途失败会返回错误并保留同步请求;重试以实际上下文为准,避免重复插入。重启后从用户锚点与实际层级重建未完成选择,包括向较低层级的切换。
27
-
28
- ## 本次相邻排查范围
29
-
30
- 除手动展开外,检查了画像编辑与后台整理、事件置顶与自动去重、手动重试、去重人工选择与撤销附近的优先级保护。
31
-
32
- - 画像整理在写入前比较完整输入快照;较早的后台结果不能覆盖用户刚改的画像,受保护短字段不能被整理改写。
33
- - 置顶事件有权重及去重保护,人工去重结果不会被普通重扫清除。
34
- - 手动重试可重设已耗尽的自动重试次数。主题整理的手动重试有一次优先尝试,不等待自动历史补建额度;该权限在认领任务时原子消费,重启不丢失,也不会被失败后的自动重试反复使用。用户明确暂停或禁用的功能仍保持暂停或禁用。
35
- - 合并、归档、撤销等涉及持久数据的操作继续检查来源、并发修改及撤销条件,不因“用户优先”跳过一致性保护。
36
-
37
- 此范围不是全仓库所有用户操作的穷举审计,也不扩大任何破坏性操作的授权。
38
-
39
- 相关验证:`tests/user-expansion-priority.test.ts`、`tests/user-expansion-capacity.test.ts`、`tests/issue81-surface.test.ts`、`tests/surface-maintenance.test.ts`、`tests/client.test.ts`、`tests/web.test.ts`、`tests/memory-topics.test.ts`、`packages/core/tests/block-timeline.test.ts`、`packages/core/tests/topics.test.ts`,以及主题恢复、画像、人工去重和重试的现有回归测试。
1
+ # 用户操作优先级
2
+
3
+ 用户在面板中明确选择的层级,优先于自动压缩的单块预算和 Agent 的证据读取。模型上下文总容量、原会话是否仍可替换、数据一致性及破坏性操作的保护仍然有效。
4
+
5
+ ## Block 层级选择
6
+
7
+ - 自动封块和衰减继续使用 `min(4096 tokens, 模型窗口的 4%)` 的单块限制。用户手动选择不使用这项限制,也不要求展开后的内容必须比原内容小。
8
+ - 已加载会话在保存选择前,估算替换后的整段会话大小,并计入已知工具定义及输出预留。预计超过模型窗口且会使占用增加时,先从最旧的自动管理历史块中逐层简略,腾够空间就停止;保留其他手动选择、当前输入和工具调用链。只替换本插件已有的历史展示片段,保留原文和恢复能力,不额外调用模型。
9
+ - 容量方案在写入前整体检查。腾出所有可用空间仍不足时,不修改任何历史展示或展开指针,就地说明当前模型预计放不下,并提供选择更简略层级或切换更大模型的下一步。缩小内容的选择仍可执行。
10
+ - 估算不是模型 tokenizer 的精确计数;模型窗口未提供时,不推测为 4096。之后宿主组装的新提示、工具变更及模型服务的实际限制仍由宿主处理。
11
+ - 用户可选择更高或更低层级,也可重新选择当前层级来替换尚未生效的旧请求。自动维护不能立即用单块限制撤销用户选择。
12
+ - 选择会重设衰减起点。新封存块继续增长后,仍按原规则自然衰减;这不是永久置顶。
13
+ - Agent 工具仍返回所请求层的证据;已有用户选择时,不改用户层级、来源或衰减起点,也不为这一只读结果生成快照。
14
+
15
+ ## 同步结果
16
+
17
+ - 点击历史块只打开“分层内容预览”,预览不改变助手可见的内容;每层用“让助手参考 L4”等直接按钮应用选择。“助手可见层级”只显示已确认的实际层级,尚无确认信息时显示“尚未确认”。助手可见不表示助手已经读过或采用。
18
+ - `applied`:所选内容已写入原生会话并完成保存。直接更新实际层级,短暂显示“已应用 L4,供助手后续回复参考。”,不留下永久来源徽章。
19
+ - `pending`:选择已保存,但所属会话尚未加载、仍在整理或正在保存。对应历史块旁说明“打开这段对话后生效”等具体情况,以及助手当前仍可见的层级。
20
+ - `blocked`:会话加载后发现整体容量不足,或原片段已不可替换。对应历史块旁说明原因、当前有效层级和下一步,并记录错误;普通请求不再反复渲染该任务。请求中断、保存报错或刷新失败时,提示暂时无法确认结果,标明上次确认的层级,并提供“刷新状态”,不谎报应用失败。
21
+
22
+ 正常操作不因插件的内部阈值弹出二次确认。涉及新的费用或授权、破坏性操作、改变其他手动选择时,才让用户作出实质决定。主流程使用用户熟悉的说法,技术细节按需展开。
23
+
24
+ 容量阻塞会在模型路由容量、工具定义或输出预留变化,以及宿主整理后重新检查;相同请求头不会触发无效重试。用户重新选择会立即重新检查。来源片段不可替换时,保留明确失败状态,不自动复活宿主已压缩掉的内容。
25
+
26
+ 原生会话日志与记忆库不是同一个事务。保存中途失败会返回错误并保留同步请求;重试以实际上下文为准,避免重复插入。重启后从用户锚点与实际层级重建未完成选择,包括向较低层级的切换。
27
+
28
+ ## 原生上下文替换边界
29
+
30
+ - 封块、自动衰减、用户层级选择和容量腾挪使用同一处写入检查,只替换对应历史块的原始对话或本插件已有的该块展示。
31
+ - 系统提示词、开发者消息(包括工具定义变更)和其他插件的上下文必须保留,即使它们出现在某一轮内部。它们位于范围两端时排除在替换之外;夹在中间、无法完整保留时不替换该段,也不把残片冒充完整历史。原文仍保存在会话与记忆库中。
32
+ - 容量按实际要替换的上下文节点估算,不把事件编号当作当前显示顺序;宿主较晚写入的工具结果整理节点也计入对应范围。
33
+ - 自动维护遇到明确不可重试的错误立即停止重试;其他连续失败最多尝试三次。保留未完成工作,来源、容量或记忆修订变化后再检查;普通读取不重复执行同一失败操作。用户重新选择层级可显式重试保存,恢复时不重复插入已写入的展示。
34
+
35
+ ## 本次相邻排查范围
36
+
37
+ 除手动展开外,检查了画像编辑与后台整理、事件置顶与自动去重、手动重试、去重人工选择与撤销附近的优先级保护。
38
+
39
+ - 画像整理在写入前比较完整输入快照;较早的后台结果不能覆盖用户刚改的画像,受保护短字段不能被整理改写。
40
+ - 置顶事件有权重及去重保护,人工去重结果不会被普通重扫清除。
41
+ - 手动重试可重设已耗尽的自动重试次数。主题整理的手动重试有一次优先尝试,不等待自动历史补建额度;该权限在认领任务时原子消费,重启不丢失,也不会被失败后的自动重试反复使用。用户明确暂停或禁用的功能仍保持暂停或禁用。
42
+ - 合并、归档、撤销等涉及持久数据的操作继续检查来源、并发修改及撤销条件,不因“用户优先”跳过一致性保护。
43
+
44
+ 此范围不是全仓库所有用户操作的穷举审计,也不扩大任何破坏性操作的授权。
45
+
46
+ 相关验证:`tests/user-expansion-priority.test.ts`、`tests/user-expansion-capacity.test.ts`、`tests/issue81-surface.test.ts`、`tests/surface-maintenance.test.ts`、`tests/client.test.ts`、`tests/web.test.ts`、`tests/memory-topics.test.ts`、`packages/core/tests/block-timeline.test.ts`、`packages/core/tests/topics.test.ts`,以及主题恢复、画像、人工去重和重试的现有回归测试。
@@ -0,0 +1,30 @@
1
+ {
2
+ "verification": "deterministic mocked streams, not live model generation",
3
+ "base": "e954eaf2f2cbbef4bb6226a2ebb35191424868c2",
4
+ "rows": [
5
+ {
6
+ "initialCharacters": 656,
7
+ "retryOverview": "same",
8
+ "success": true,
9
+ "calls": 1
10
+ },
11
+ {
12
+ "initialCharacters": 778,
13
+ "retryOverview": "same",
14
+ "success": true,
15
+ "calls": 1
16
+ },
17
+ {
18
+ "initialCharacters": 1000,
19
+ "retryOverview": "same",
20
+ "success": true,
21
+ "calls": 1
22
+ },
23
+ {
24
+ "initialCharacters": 1001,
25
+ "retryOverview": "empty",
26
+ "success": true,
27
+ "calls": 2
28
+ }
29
+ ]
30
+ }