stratagate-dsh 0.3.32 → 0.3.33
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.
- package/CHANGELOG.md +709 -694
- package/CONTRIBUTING.md +88 -0
- package/CONTRIBUTING.zh-CN.md +88 -0
- package/README.md +487 -491
- package/README.zh-CN.md +491 -495
- package/benchmarks/locomo-conv26-r8-final.json +146 -0
- package/cordis.patch.yml +16 -16
- package/dist/client.d.ts +1 -1
- package/dist/client.js +107 -21
- package/dist/index.d.ts +9 -0
- package/dist/index.js.map +1 -1
- package/dist/plugin.d.ts +9 -0
- package/dist/plugin.js +415 -90
- package/dist/plugin.js.map +1 -1
- package/dist/repair-profile.js.map +1 -1
- package/docs/ARCHITECTURE.md +282 -282
- package/docs/DSH.md +331 -331
- package/docs/DSH.zh-CN.md +309 -291
- package/docs/EVALUATION.md +189 -189
- package/docs/EXTERNAL_MEMORY_IMPORT.zh-CN.md +99 -99
- package/docs/MEMORY_TOPICS.zh-CN.md +51 -51
- package/docs/dreaming-agent.md +69 -69
- package/docs/event-extractor.md +48 -48
- package/docs/npm-release.md +1 -0
- package/docs/validation/workspace-cleanup-20261020.md +36 -36
- package/package.json +255 -249
- package/packages/core/examples/basic.ts +87 -0
- package/packages/core/src/blocks.ts +442 -0
- package/packages/core/src/weights.ts +21 -0
- package/docs/assets/41fc676096d0a13337a1c03aaf8f499b.png +0 -0
- package/docs/assets/cecc9d191a4b9bf22a479623e2ebdc1d.png +0 -0
|
@@ -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
|
+
验证模糊查询发现主题、无图谱事件覆盖、按主题取证、增量整合与稳定编号、隐藏来源即时失效、过期提交拒绝、零采用强化、命名空间隔离、旧库升级、重启恢复、有限重试、输入和目录预算,以及后台失败时原搜索继续可用。测试只使用临时数据库与模拟模型。
|
package/docs/dreaming-agent.md
CHANGED
|
@@ -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、工具拒绝、分批、写入、暂停/终止、用户补充、宿主重启恢复与完整会话。浏览器检查桌面/手机布局、浮窗原文、控制按钮与减少动画设置。测试模型是脚本化流,不证明真实模型能正确提炼经验;未改用户生产数据,也未发布。
|
package/docs/event-extractor.md
CHANGED
|
@@ -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/npm-release.md
CHANGED
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
- 用户已验收候选并明确授权正式发布;本脚本不会代替验收、源码审查或相关测试。
|
|
8
8
|
- 正式源码已固定,版本和锁文件一致,正式 `.tgz` 已构建、校验并记录 SHA-256。不得用候选版本代替正式版本,也不重新打包覆盖原文件。
|
|
9
|
+
- 正式包内 `README.md` 和 `README.zh-CN.md` 必须与已审查源码字节一致;本地图片和文档链接必须存在。`status` 和 `stage` 共用这一检查,避免 npm 展示旧 README。
|
|
9
10
|
- 使用满足项目 engines 的 Node,及支持 `npm stage publish/list/view/download/approve` 的 npm CLI。
|
|
10
11
|
- 复用现有 npm 登录。只有登录确实不可用时才要求用户登录;发布认证与账号登录是两件事。
|
|
11
12
|
|
|
@@ -1,36 +1,36 @@
|
|
|
1
|
-
# 2026-10-20 工作区整理
|
|
2
|
-
|
|
3
|
-
## 已保存的源码
|
|
4
|
-
|
|
5
|
-
将 `codex/review-dreaming-stop-20261019` 上此前未提交的工作作为一个完整快照提交,包含 Event 去重与维护、Dreaming 目录占用及原生上下文和概要重写修复、DSH 兼容性检查、WorkBuddy 适配,以及对应测试与文档。基线为 `3e03c685d308cb6eac5a57675bb94cce52c7b0aa`。此前多个任务修改了相同文件,本次保留最终工作树,不重新拆分或改写各任务历史。
|
|
6
|
-
|
|
7
|
-
## 本次验证
|
|
8
|
-
|
|
9
|
-
使用本机现有 Node v24.19.0,重新运行以下检查,验证期间源码 SHA-256 无变化。
|
|
10
|
-
|
|
11
|
-
| 检查 | 结果 |
|
|
12
|
-
| --- | --- |
|
|
13
|
-
| Core 测试 | 414 通过 |
|
|
14
|
-
| DSH 测试 | 866 通过、1 项既有跳过 |
|
|
15
|
-
| WorkBuddy 测试 | 10 通过 |
|
|
16
|
-
| Core、DSH、WorkBuddy TypeScript | 全部通过 |
|
|
17
|
-
| Core、DSH 服务端与客户端、WorkBuddy 构建 | 全部通过 |
|
|
18
|
-
| Git 差异空白检查 | 通过 |
|
|
19
|
-
|
|
20
|
-
原始日志、测试 JSON、源码哈希与整理前状态保存在本地 `.artifacts/workspace-cleanup-20261020/`;`verify.mjs` 记录实际执行参数。没有运行真实模型或操作生产数据库。本次没有打包、候选验收或发布。
|
|
21
|
-
|
|
22
|
-
默认 PATH 中 Node 为 v22.12.0,低于项目要求的 `^22.19.0 || >=24.0.0`;本次使用 Codex 自带的 `C:/Users/19007/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin/node.exe`。未改变其他应用的 Node 安装或系统 PATH;后续手动运行项目命令仍需选择受支持的 Node。
|
|
23
|
-
|
|
24
|
-
## 分支与证据保留
|
|
25
|
-
|
|
26
|
-
- 本地历史中的 PR #116、#120、#122 合并提交与祖先检查共同确认 `codex/readme-community-layout`、`codex/topic-section-membership`、`codex/memory-directory-section-titles` 已纳入本地 `main`,已使用 `git branch -d` 删除。README 辅助 worktree 无修改、未跟踪文件或忽略文件,已移除。
|
|
27
|
-
- 新提交完成后,本地 `main` 从原基线快进到新提交,再删除已收拢的 `codex/review-dreaming-stop-20261019`。
|
|
28
|
-
- 其他旧分支存在未纳入本地主线的提交,或仍由 worktree 使用,予以保留。`codex/issue119-topic-reliability` 的辅助 worktree 留有 24 个未跟踪验证文件,保留该分支和工作目录。
|
|
29
|
-
- 原地保留 400 份未跟踪验证文件(含历史快照、测试结果、截图及 SQLite 夹具),逐文件路径、大小和 SHA-256 记录在 `preserved-validation.json`;发布目录顶层文件清单记录在 `preserved-release-files.json`。候选 tgz、评审 ZIP、发布证据、已安装依赖及用户数据均保留。
|
|
30
|
-
- 仅在本仓库 `.git/info/exclude` 添加 `/.worktrees/`、`/release-candidates/` 和现有未跟踪验证路径,未修改共享忽略规则。新增规则完整记录于 `local-excludes-added.txt`。这些文件仍在磁盘上,只是不再显示为待提交内容。
|
|
31
|
-
|
|
32
|
-
## 远端限制
|
|
33
|
-
|
|
34
|
-
`git ls-remote --heads origin` 返回账号暂停的 HTTP 403,无法核实当前远端分支或执行远端清理。缓存的 `origin/main` 与本地 `main` 在整理前已有分叉(本地独有 3 个提交、缓存远端独有 4 个提交),因此未据此重写或合并主线。未执行 push 或删除远端分支。
|
|
35
|
-
|
|
36
|
-
GitHub PR、CI、Tag、Release、trusted-publishing 和 Roadmap 同步按用户既有要求跳过;本地已有合并记录用于判断本地分支,不代表重新核验了 GitHub 状态。所有现有 tag 和发布产物均保留。
|
|
1
|
+
# 2026-10-20 工作区整理
|
|
2
|
+
|
|
3
|
+
## 已保存的源码
|
|
4
|
+
|
|
5
|
+
将 `codex/review-dreaming-stop-20261019` 上此前未提交的工作作为一个完整快照提交,包含 Event 去重与维护、Dreaming 目录占用及原生上下文和概要重写修复、DSH 兼容性检查、WorkBuddy 适配,以及对应测试与文档。基线为 `3e03c685d308cb6eac5a57675bb94cce52c7b0aa`。此前多个任务修改了相同文件,本次保留最终工作树,不重新拆分或改写各任务历史。
|
|
6
|
+
|
|
7
|
+
## 本次验证
|
|
8
|
+
|
|
9
|
+
使用本机现有 Node v24.19.0,重新运行以下检查,验证期间源码 SHA-256 无变化。
|
|
10
|
+
|
|
11
|
+
| 检查 | 结果 |
|
|
12
|
+
| --- | --- |
|
|
13
|
+
| Core 测试 | 414 通过 |
|
|
14
|
+
| DSH 测试 | 866 通过、1 项既有跳过 |
|
|
15
|
+
| WorkBuddy 测试 | 10 通过 |
|
|
16
|
+
| Core、DSH、WorkBuddy TypeScript | 全部通过 |
|
|
17
|
+
| Core、DSH 服务端与客户端、WorkBuddy 构建 | 全部通过 |
|
|
18
|
+
| Git 差异空白检查 | 通过 |
|
|
19
|
+
|
|
20
|
+
原始日志、测试 JSON、源码哈希与整理前状态保存在本地 `.artifacts/workspace-cleanup-20261020/`;`verify.mjs` 记录实际执行参数。没有运行真实模型或操作生产数据库。本次没有打包、候选验收或发布。
|
|
21
|
+
|
|
22
|
+
默认 PATH 中 Node 为 v22.12.0,低于项目要求的 `^22.19.0 || >=24.0.0`;本次使用 Codex 自带的 `C:/Users/19007/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin/node.exe`。未改变其他应用的 Node 安装或系统 PATH;后续手动运行项目命令仍需选择受支持的 Node。
|
|
23
|
+
|
|
24
|
+
## 分支与证据保留
|
|
25
|
+
|
|
26
|
+
- 本地历史中的 PR #116、#120、#122 合并提交与祖先检查共同确认 `codex/readme-community-layout`、`codex/topic-section-membership`、`codex/memory-directory-section-titles` 已纳入本地 `main`,已使用 `git branch -d` 删除。README 辅助 worktree 无修改、未跟踪文件或忽略文件,已移除。
|
|
27
|
+
- 新提交完成后,本地 `main` 从原基线快进到新提交,再删除已收拢的 `codex/review-dreaming-stop-20261019`。
|
|
28
|
+
- 其他旧分支存在未纳入本地主线的提交,或仍由 worktree 使用,予以保留。`codex/issue119-topic-reliability` 的辅助 worktree 留有 24 个未跟踪验证文件,保留该分支和工作目录。
|
|
29
|
+
- 原地保留 400 份未跟踪验证文件(含历史快照、测试结果、截图及 SQLite 夹具),逐文件路径、大小和 SHA-256 记录在 `preserved-validation.json`;发布目录顶层文件清单记录在 `preserved-release-files.json`。候选 tgz、评审 ZIP、发布证据、已安装依赖及用户数据均保留。
|
|
30
|
+
- 仅在本仓库 `.git/info/exclude` 添加 `/.worktrees/`、`/release-candidates/` 和现有未跟踪验证路径,未修改共享忽略规则。新增规则完整记录于 `local-excludes-added.txt`。这些文件仍在磁盘上,只是不再显示为待提交内容。
|
|
31
|
+
|
|
32
|
+
## 远端限制
|
|
33
|
+
|
|
34
|
+
`git ls-remote --heads origin` 返回账号暂停的 HTTP 403,无法核实当前远端分支或执行远端清理。缓存的 `origin/main` 与本地 `main` 在整理前已有分叉(本地独有 3 个提交、缓存远端独有 4 个提交),因此未据此重写或合并主线。未执行 push 或删除远端分支。
|
|
35
|
+
|
|
36
|
+
GitHub PR、CI、Tag、Release、trusted-publishing 和 Roadmap 同步按用户既有要求跳过;本地已有合并记录用于判断本地分支,不代表重新核验了 GitHub 状态。所有现有 tag 和发布产物均保留。
|