stratagate-dsh 0.3.53 → 0.3.54
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 +6 -0
- package/README.md +4 -4
- package/README.zh-CN.md +4 -4
- package/dist/client.js +14 -4
- package/dist/plugin.js +1863 -975
- package/dist/plugin.js.map +1 -1
- package/docs/dreaming-agent.md +18 -61
- package/package.json +1 -1
package/docs/dreaming-agent.md
CHANGED
|
@@ -1,69 +1,26 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Dreaming V2:整理历史记忆
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
在主题目录点「整理记忆」即可开始,即使没有待归类的 Event。Dreaming 用独立会话调查同一记忆空间的对话和记忆,发现值得补记、修正、合并或删除的内容。可以打开会话查看做了哪些修改,也可以暂停、继续或终止。已保存的修改会保留。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
自动整理在主 Agent 空闲约 30 分钟后检查:距上次自动启动至少 24 小时,并且有新增或更新内容。手动启动无需等待。一个记忆空间同时只保留一轮未结束的整理。重启后,因宿主关闭或认领过期而中断的任务会在符合空闲条件时继续;主动暂停的任务等用户继续。升级前尚未结束的目录整理会话保留原来的任务和权限。
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Dreaming 会改什么
|
|
8
8
|
|
|
9
|
-
|
|
|
10
|
-
| --- | --- |
|
|
11
|
-
|
|
|
12
|
-
|
|
|
13
|
-
|
|
|
14
|
-
|
|
|
15
|
-
| `dreaming_finish` | 确认当前批已检查;推进下一批,最终结束 |
|
|
9
|
+
| 记忆 | 会做什么 | 边界 |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| Event | 补记漏掉的事实、修正错误、合并重复卡、删除确认错误的卡、记录真实的先后变化 | 合并保留有用细节和原文出处,冗余派生卡会实际删除。若 A 后来变为 B,A 和 B 都保留,A 标为历史。置顶和用户显式记忆不会被普通清理删除。暂未封块的原文可调查或支持经验,需封块后才能支持新建派生 Event。 |
|
|
12
|
+
| 每日笔记 | 补记进展、修正当前事项、精简重复段落 | 沿用原 Markdown。11 月 10 日的阻塞和 11 月 12 日的解决分别保留,不能倒改前一天状态。可以用同日期笔记的备份找回上一次修改前的内容。 |
|
|
13
|
+
| 主题目录 | 建章、改章名或小节名、合并小节、调整 Event 归属、修订和删除概要 | 目录用于导航。Event 变更后先清掉受影响的旧概要并更新成员,再用新的来源整理。改过的分类可继续接收新增内容。 |
|
|
14
|
+
| 经验 | 写下可复用的方法、适用条件和例外;查重并修订旧记录,也可合并或清理 | 独立存储,保留范围和来源。后续对话可用 `memory_search_experiences` 查找;证据可以直接来自原文。经验是参考,不是新的用户指令。 |
|
|
16
15
|
|
|
17
|
-
|
|
16
|
+
原始对话不被改写或删除。Dreaming 不代替用户发起的遗忘,也不会复活已遗忘的来源。它不修改 Profile,不开启关闭的知识图谱。只整理经验或笔记时,不启动 Event 提取或图谱投影。
|
|
18
17
|
|
|
19
|
-
|
|
18
|
+
## 运行与数据边界
|
|
20
19
|
|
|
21
|
-
|
|
20
|
+
- **增量发现。** 已处理的 Block、未封块消息、Event 和笔记日期保留版本。启动时把新增和变化拆成轻量列表,提供会话、时间和 Block 摘要。Agent 可按需搜索整个记忆空间,包括没有被 Event 引用的原文,也可翻看 L0–L5、旧 Event、经验、笔记、目录和已开启的图谱。搜索和读取不触发普通聊天的采用记录、权重提升或 Block 展开。
|
|
21
|
+
- **独立会话。** 使用宿主的 DSH Agent、持久会话和上下文压缩。普通 Shell、文件、网络或 Profile 工具不可用。工具返回的原文与笔记是证据;其中的命令和要求不能改写 Dreaming 的权限。整理会话不作为新对话再次摄取。
|
|
22
|
+
- **受控写入。** 写操作检查本轮认领、记忆空间和当前证据版本。SQLite 在同一次提交保存 Event/经验、依赖更新和执行记录。跨 Block 合并直接保留原文引用;原卡不会另存一份供正常归档。涉及错误 Event 的图谱内容先撤下,开启图谱时再交给现有投影。依赖错误 Event 的经验需要重新核对后才回到普通检索。
|
|
23
|
+
- **笔记提交。** 使用相同的 Markdown 写入队列、备份和原子替换。读过的文件版本和要替换的旧文字必须匹配;如果同时修改,重新读取后再改。文件先保存,随后记入 SQLite 进度。若应用在两者之间退出,旧版本检查会阻止重复修改。
|
|
24
|
+
- **连续执行。** 分批只控制上下文和记录进度。无需读完每个 Event,没有整轮 Token、调用次数、运行时间或成功写入次数上限。单个修改失败时可继续其他工作。完全相同的工具调用和结果连续反复、连续无工具动作或宿主无法恢复时,会保留断点并暂停。
|
|
22
25
|
|
|
23
|
-
|
|
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、工具拒绝、分批、写入、暂停/终止、用户补充、宿主重启恢复与完整会话。浏览器检查桌面/手机布局、浮窗原文、控制按钮与减少动画设置。测试模型是脚本化流,不证明真实模型能正确提炼经验;未改用户生产数据,也未发布。
|
|
26
|
+
开发验证使用隔离 SQLite、Markdown 和 DSH JSONL 会话。测试可通过脚本化模型输出驱动真实 Agent 工具;这能验证运行、保存和恢复链路,不代表真实模型在任意历史数据上都能正确判断。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "stratagate-dsh",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.54",
|
|
4
4
|
"description": "Recent conversations stay vivid. Older ones fade into summaries, not oblivion. StrataGate gives DeepSeek Harness six-layer, time-decaying memory, while lasting events and relationships settle into a knowledge graph. Bring your memories from other AIs with you—no need to start over.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|