dsh-world 0.7.4 → 0.7.6

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 (68) hide show
  1. package/CHANGELOG.md +76 -0
  2. package/CONTRIBUTING.md +11 -0
  3. package/NOTES.md +73 -16
  4. package/README.md +14 -7
  5. package/client/index.js +43 -3
  6. package/lib/abortable.d.ts +1 -0
  7. package/lib/abortable.js +17 -0
  8. package/lib/compaction.d.ts +6 -1
  9. package/lib/compaction.js +8 -3
  10. package/lib/compactionSwap.d.ts +9 -17
  11. package/lib/compactionSwap.js +27 -35
  12. package/lib/console/homeApply.js +1 -12
  13. package/lib/console/routes.d.ts +1 -0
  14. package/lib/console/routes.js +10 -0
  15. package/lib/console/snapshot.d.ts +4 -0
  16. package/lib/console/snapshot.js +3 -0
  17. package/lib/ecosystem/bridge/bridge.d.ts +2 -2
  18. package/lib/ecosystem/bridge/bridge.js +24 -11
  19. package/lib/ecosystem/qq-native/home.d.ts +2 -1
  20. package/lib/ecosystem/qq-native/home.js +6 -2
  21. package/lib/ecosystem/qq-native/images.d.ts +13 -0
  22. package/lib/ecosystem/qq-native/images.js +76 -0
  23. package/lib/ecosystem/qq-native/index.d.ts +1 -0
  24. package/lib/ecosystem/qq-native/index.js +8 -2
  25. package/lib/ecosystem/qq-native/snowluma.d.ts +1 -0
  26. package/lib/ecosystem/qq-native/snowluma.js +13 -4
  27. package/lib/ecosystem/wechat/index.d.ts +5 -0
  28. package/lib/ecosystem/wechat/index.js +3 -1
  29. package/lib/ecosystem/wechat/presence.d.ts +5 -1
  30. package/lib/ecosystem/wechat/presence.js +22 -13
  31. package/lib/ecosystem/wechat/supervisor.d.ts +1 -1
  32. package/lib/ecosystem/wechat/supervisor.js +5 -1
  33. package/lib/elsewhere.d.ts +34 -0
  34. package/lib/elsewhere.js +40 -0
  35. package/lib/history.d.ts +5 -0
  36. package/lib/history.js +5 -0
  37. package/lib/hostContract.d.ts +6 -0
  38. package/lib/index.d.ts +1 -1
  39. package/lib/index.js +84 -46
  40. package/lib/life/home.js +8 -2
  41. package/lib/life/photoTools.js +60 -26
  42. package/lib/life/runtime.js +2 -0
  43. package/lib/memoryTools.d.ts +4 -3
  44. package/lib/memoryTools.js +11 -4
  45. package/lib/mood.d.ts +38 -5
  46. package/lib/mood.js +56 -13
  47. package/lib/moodTools.d.ts +6 -0
  48. package/lib/moodTools.js +30 -0
  49. package/lib/persona.js +7 -0
  50. package/lib/promptSection.d.ts +11 -13
  51. package/lib/promptSection.js +63 -80
  52. package/lib/runtime.d.ts +21 -2
  53. package/lib/runtime.js +162 -53
  54. package/lib/sessionNews.d.ts +17 -0
  55. package/lib/sessionNews.js +55 -0
  56. package/lib/sourceArchive.d.ts +1 -5
  57. package/lib/sourceArchive.js +31 -14
  58. package/lib/store.d.ts +6 -0
  59. package/lib/store.js +17 -3
  60. package/lib/worldScope.d.ts +2 -4
  61. package/lib/worldScope.js +6 -6
  62. package/package.json +1 -1
  63. package/src/ecosystem/wechat/windows/README.md +4 -2
  64. package/src/ecosystem/wechat/windows/adapter.py +6 -1
  65. package/src/ecosystem/wechat/windows/engine/NOTICE.md +6 -0
  66. package/src/ecosystem/wechat/windows/engine/profiles.json +28 -0
  67. package/src/ecosystem/wechat/windows/sender.py +6 -2
  68. package/templates/world-prompt.md +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,81 @@
1
1
  # 更新日志
2
2
 
3
+ ## 0.7.6 — 2026-11-15
4
+
5
+ 本版让她知道别处发生了什么:新增「别处的动静」,有未读的微信群和她其他会话里的新发言,按「多少条、最后是谁、多久前」告诉她,不带正文,群会话里另有一句不把私聊内容带进群里的约束;心情快照改为每一步都放,并写着心情停了多久;QQ 商店表情和部分动图也能收;兼容 DSH 0.2.2-rc.3;控制台的心情挪进「健康」。
6
+
7
+ ### 升级前请看
8
+
9
+ - **她每一步看到的内容变多了一点**:每一步末尾多一条心情快照(几十个 token),有新动静时多一条「别处的动静」。都是只往后追加,不影响前面的缓存;一百多步的一轮大约多一万 token。上下文的排法和原因见 [注意事项](NOTES.md#她每一步看到的上下文)。
10
+ - **群聊概况挪了位置**:有未读的微信群不再写在闹钟消息里,改由「别处的动静」在有新消息时说;闹钟上那行只留没有未读的群各安静了多久。
11
+ - **别处的动静从升级后开始算**:她其他会话里升级前说过的话不会一次倒给她;重启 DSH 后也从当时开始算。新装的只有一个家,什么都不放。
12
+ - **群会话里的约束只是提示词**:群会话的近期记忆和别处的动静末尾会多一句「家里和私聊的话不带进群里说」,她仍然看得到这些内容,靠的是她自己守住。
13
+ - **自定义了 `world-prompt.md` 的**:不用改。别处的动静开头自带一句说明,心情快照末尾写着怎么改。
14
+
15
+ ### 别处的动静
16
+
17
+ - **新增「别处的动静」**:她不在场的地方攒下的消息,以事实的形式告诉她:有多少条她还没看到、最后是谁、过了多久,不带正文,开头一句说明这只是让她知道,要不要看、要不要回由她决定。每轮开头放在新消息前面,一轮中途有新的就在下一步末尾补一条,没有新的就不放,同一件事不重复说。现在接进来两种:
18
+ - 有未读的微信群:以前只在闹钟响时附一行群聊概况,现在有新消息就会说;闹钟上那行只留没有未读的群各安静了多久。
19
+ - 她的其他会话(家、群会话、你另开的窗口):以前要等记忆块重建(会话刚打开、压缩后、很久没说话再开口)才知道别处说过什么,现在下一步就知道那边有几条新的;用 `memory_find` 带上那一行的 sourceId 翻最新的一页就算看过。
20
+ 群会话也能看到别处的动静。群会话里的近期记忆本来就带着家里和私聊的原话,所以在群会话里,近期记忆和别处的动静末尾都多一句:家里和私聊的话不把原话和细节带进群里说、不替谁转述,被问起就带过去。家和 DSH 里另开的窗口不加。
21
+ 只往后追加,压缩时清掉、压缩后重新说一次还没看的,不进归档。新用户只有一个家、没有别处,什么都不放;老用户和宿主里已有会话的用户,从升级后第一次说话开始算,以前的不补;重启 DSH 后也从当时开始算。以后接入的推特、B 站等来源都走这一块,规定见 [注意事项](NOTES.md#她每一步看到的上下文) 和 [贡献协议](CONTRIBUTING.md#新的消息来源怎么进她的上下文)。
22
+
23
+ ### 心情
24
+
25
+ - **心情快照每一步都放,并写着停了多久**:0.7.5 只在心情变了之后、或者每轮开头放一条快照。她一次醒来能连着做一百多步,那条快照很快沉到十几万 token 之后,她不再注意到,心情一两天没动过。现在每一步都在时间块前面追加一条,末尾写着「最后改于 2 天 3 小时前」这样的停留时长,要不要改由她决定;插件仍然不替她改、不提醒、不让数值衰减。和时间块一样只往后追加,不影响前面的缓存,每一步多几十个 token。删掉 `mood.md` 后仍然只说一次「之前那条不再算数」;没有 `mood.md` 的新用户什么都不放。详见 [注意事项](NOTES.md#心情快照为什么只追加不替换)。
26
+ - **心情挪进控制台的「健康」**:0.7.5 的「心情」卡片原先单独挨着「家」,现在放进概览的「健康」卡片,插件的故障在上、她的心情在下,看她现在怎么样只看一处。内容和读法不变,仍然只读;世界还没开始过时也能看到。
27
+
28
+ ### QQ
29
+
30
+ - **QQ 商店表情和部分动图也能收了**(#44,感谢 @endlessstary 实测):这类图 `get_image` 取不到直链,或者给出的不是 `multimedia.nt.qq.com.cn` 的链接,0.7.5 会直接丢掉,她只看到「本次有 QQ 图片未能读取」。现在仍然先走 `get_image`;取不到时改用消息里那张图自带的链接。可下载的域名从 `multimedia.nt.qq.com.cn` 一个放宽到 `qq.com` 和 `qq.com.cn` 下的所有子域名(比如表情商店的 `gxh.vip.qq.com`),仍然只走默认端口的 https,不跟随跳转;其他域名的链接不下载。每批张数、超时和大小限制不变。
31
+
32
+ ### 宿主兼容
33
+
34
+ - **兼容 DSH 0.2.2-rc.3**:rc.3 把 `LlmError` 构造时的错误码在类型上收窄到 DSH 自带的那些,插件转发压缩失败和「会话已离开世界」时用的是自己的错误码,按 rc.3 编译会报错;运行时 DSH 照样接受任意错误码,所以 0.7.5 装在 rc.3 上不受影响。现在两处改用同一个转发函数,0.2.1、0.2.2-rc.1 和 rc.3 都能编译。CI 加上 rc.3 一组。
35
+
36
+ ## 0.7.5 — 2026-11-13
37
+
38
+ 本版不再把 DSH 的会话预设整份写进 profile,旧版留下的副本可以在世界控制台一键还原;世界里的会话改为只用人设和世界模板作系统提示词;心情值固定成 11 个,新增 `set_mood` 工具和控制台「心情」卡片;相册可以收藏她眼前的任意一张图和电脑上的图片文件;QQ 能收图,适配 Windows 微信 4.2.0.52,并修复生活线启动和卸载的时序。
39
+
40
+ ### 升级前请看
41
+
42
+ - **旧版写进 profile 的预设副本**:0.7.3 及以前的插件在桌面版上换压缩时,会把 `standard` 等预设整份写进 profile。这份副本会挡住 DSH 之后对预设的更新,0.7.4 修过的 `list-agents` 就是一例。0.7.5 起插件不再这样做。已有的副本会显示在世界控制台「概览 → 会话预设」,点「还原 DSH 预设」会先备份 `cordis.patch.yml`,再移除整份覆盖(包括你在里面手动改过的设置),重启 DSH 后已有会话改用 DSH 自带的预设。想保留副本里的自定义设置,先在 DSH 的预设设置里核对好再还原。
43
+ - **桌面版不再自动换上「只留对话」的压缩**:插件只在原版压缩直接写在 profile、且没有使用会话预设时才替换。桌面版用会话预设自己的压缩,自动压缩的触发线以那个压缩为准;控制台的「应用并压缩」和回顾后压缩用家会话现有的压缩服务。
44
+ - **世界会话的系统提示词整份替换**:世界运行时,她工作区里且匹配世界预设的会话,系统提示词只有控制台人设和世界模板,DSH 原来的身份句等不再出现;人设留空时只用世界模板。想把在 DSH 里写过的角色设定带进世界,把文字填进控制台的人设。移出工作区或停止世界后,下一轮恢复 DSH 原来的系统提示词。升级后,能识别出曾属于世界的会话会在下一轮重新组装系统提示词,聊天记录保留;这类会话如果已经在世界外,先发一条消息,再执行压缩。
45
+ - **心情值的名字固定了**:0.7.4 时写过组外词的(比如「高兴」「困」),升级后这几行不再算进心情值,快照和控制台卡片会点名提示,用 `set_mood` 换成组里最接近的那个就好;`mood.md` 本身不会被改动。
46
+ - **自定义了 `world-prompt.md` 的**:模板不会被改写,房间段里不会多出 `mood.md` 和 `set_mood` 的说明;工具和快照末尾的提示照样生效。想补的话,照 `templates/world-prompt.md` 的房间段加一句。
47
+ - **微信 4.2.0.52**:已离线核对腾讯签名、DLL 指纹和原生地址,已登录的 `Probe` 和实际投递还没验证。
48
+ - **新装的**:没有旧副本、旧会话和旧的心情文件,以上都不用处理。
49
+
50
+ ### 宿主与提示词
51
+
52
+ - **保留宿主的会话预设,提供还原入口**:不再为了换压缩把预设整份写进 profile,控制台「概览 → 会话预设」持续显示使用 `dsh-world/compaction` 的旧覆盖,并能还原(见上)。启动时删掉旧副本里 DSH 已不再提供的 `list-agents` 那一行的修复继续保留。
53
+ - **按世界替换系统提示词并清理旧会话残留**:世界会话的系统提示词只由人设和世界模板组成,标准和精简预设都一样;离开世界后恢复 DSH 原来的。会话在提示词组装后才进入世界时,旧的宿主提示词会被拦下,到下一轮再换上世界的;关着的会话离开世界、未做标记的旧世界会话,都会在发出世界外的第一个请求前恢复宿主的提示词。
54
+
55
+ ### 心情
56
+
57
+ - **心情值固定成 11 个**:开心、兴奋、平静、安心、烦、生气、紧张、难过、累、孤单、想念,按这个顺序显示,没写的算 0;原来的「困」并进「累」,新增安心、生气、孤单、想念。这 11 个按「愉快/不愉快 × 激动/平静」四个角各取几个,再加上跟人有关的孤单和想念。
58
+
59
+ **为什么这样改**:0.7.4 允许她自己加词,用下来很快就出现了同义词:她写了「高兴 7」,和默认的「开心 0」并排出现在快照里。由着她加词,同义词会越积越多,快照越来越长,前后几次也没法比。所以名字固定,数值只回答「有多少」;更细的感受,比如「有点想家」「被夸了有点不好意思」,写进不以数字结尾的小事那几行(最多三行),那里本来就是自由文字,也不会膨胀。组外的词:用 `set_mood` 写时不写入,并列出能用的词;直接改文件的,文件不改,快照和卡片里点名哪几个没算进去。详见 [注意事项](NOTES.md#心情值为什么是固定的一组)。
60
+ - **新增 `set_mood` 工具**:她世界里的会话都有,一次调用就把心情整份记进 `mood.md`;格式不对或用了组外的词时不写入,文件保持原样,并告诉她哪里错了。0.7.4 只能先读再改文件,至少两次工具调用,实际用下来她很少改。快照末尾也写上「用 set_mood 改」,压缩之后她也知道怎么改;直接改文件照样有效。插件仍然不提醒她改、不替她判断、不让数值自己衰减。
61
+ - **控制台概览新增只读的「心情」卡片**:挨着「家」,显示她现在的心情值、旁边的小事、不在固定一组里的词、没读懂的行数和她最后改的时间,和她每轮读到的是同一份读法。卡片只读,不能替她改;没写过 `mood.md` 时写「她还没有写 mood.md」,文件读不出来时显示原因。不新增存储,每次打开控制台时现读文件。
62
+ - 心情快照仍然只追加、不替换历史里的旧快照,替换会让之后的缓存全部失效,原因见 [注意事项](NOTES.md#心情快照为什么只追加不替换)。
63
+
64
+ ### 相册
65
+
66
+ - **`keep_photo` 不再只能收藏本轮最新那条消息里的图片**:不填 `path` 时,`index` 从她眼前最新的一张图往前数,更早消息里的、引用的、工具读出来的图片都能收藏,被压缩掉的不算;最新那条消息之后没有别的图时,它里面的几张编号和以前一样。填 `path` 时,可以收藏电脑上的一个图片文件(png、jpg、webp、gif,按文件内容判断,最多 20MB,相对路径从她的房间算起),和渠道图片一样先存进宿主的图片存储再进相册。同一张图收藏多次只存一份。工具仍然只在家会话里有。
67
+
68
+ ### QQ、微信与阳台
69
+
70
+ - **QQ 能收图了**:QQ 发给她的消息里的图片会随这条消息一起交给她看。插件只从 QQ 官方图床(`multimedia.nt.qq.com.cn`)下载,每批最多 4 张,单张 10 秒超时,受宿主的图片大小限制,先存进宿主的图片存储;有图没读出来时,会明确告诉她「本次有 QQ 图片未能读取,请勿假装看过」。CQ 字符串里的图片链接不交给模型。
71
+ - **阳台在回合结束后推送最终回复**:以前推的是她看到消息后说的第一段,现在等这一轮结束,推她最后对你说的那段;和工具调用一起出现的文字当作旁白,不推。你又发来新的话时,不再推旧那句的回复。`outlets` 的 `kinds` 省略或留空时接收所有类型。
72
+ - **适配 Windows 微信 4.2.0.52**:地址由本项目从腾讯签名的 `Weixin.dll` 独立比对得出,沿用现有原生桥。微信构建认不出来时,适配器停止自动重启,控制台显示原因,不再反复重试。
73
+
74
+ ### 修复
75
+
76
+ - **生活线启动和卸载时序**:插件加载时不再等世界启动完;生活线和家的恢复放到宿主启动完成之后,不会卡住宿主启动。卸载时取消还在进行的启动补读,可以干净地重新加载;补读还没做完时,已经开着的世界会话也能先拿到提示词和人设;家还在恢复时,世界也能正常停止。
77
+ - **人设里的自定义标题不再丢**:人设文件里写在「名字」后面的自定义 `##` 标题(比如「## 我是谁」),以前会被并进名字,现在保留到「补充」里。
78
+
3
79
  ## 0.7.4 — 2026-11-10
4
80
 
5
81
  本版修复在 DSH 0.2.1 上装过插件的桌面版用户升级到 DSH 0.2.2 后会话打不开的问题,微信私聊不再因为她忙着做别的而停收;新增她自己记的心情值,「我是谁」固定成六段、上限放宽到 5000 字。
package/CONTRIBUTING.md CHANGED
@@ -59,6 +59,17 @@ dsh-world 养的是一个伙伴,不是一个按日程执行的助手。**她
59
59
 
60
60
  改动闹钟、家会话、每日回顾、世界提示词、记忆块注入,或者给她新增工具,都属于生活线核心改动:**先开 Issue 讨论,再写代码**,并在 PR 里按下节说明内核影响。
61
61
 
62
+ ## 新的消息来源怎么进她的上下文
63
+
64
+ 接入新的平台或外部程序时,先分清它带来的是哪一类,再放到对应的位置(排法和原因见 [注意事项](NOTES.md#她每一步看到的上下文)):
65
+
66
+ - **对她说的话**:作为一条用户消息交给她,带结构化身份(见上节)。
67
+ - **随这句话来的上下文**(之前的聊天、引用、图片):贴在那句话前面,标明属于哪条消息,不放到末尾。
68
+ - **不需要她回答的动静**(群里没叫她的消息、通知、另一个会话里的新发言):属于事件,统一进「别处的动静」,不在上下文末尾另加一块。每个来源只报有多少条她还没看到、最后是谁、过了多久,不带正文;写明她用哪个工具去看,读到最新后清零。不写待办、不写「你应该」,要不要看、要不要回由她决定。
69
+ - **状态**(像心情值、时间,每一步都要是最新的):每一步跟在末尾。新增一种状态属于生活线核心改动,先开 Issue。
70
+
71
+ 这几类都只往后追加,不替换、不删除历史里已有的,压缩时清掉,不进归档。新来源要写明它的动静能流到哪些会话,并遵守上一节的世界边界。这一块不带正文;群会话里凡是会见到别处原话或指向别处的地方(近期记忆、别处的动静),都要附上 `history.ts` 的 `GROUP_PRIVACY`,不另写一份措辞。
72
+
62
73
  ## 涉及内核时必须说明
63
74
 
64
75
  这里的“内核”指 dsh-world 的公共行为,不仅指某个目录:
package/NOTES.md CHANGED
@@ -6,6 +6,8 @@
6
6
  - [安装与升级](#安装与升级)
7
7
  - [人设与提示词](#人设与提示词)
8
8
  - [压缩与记忆](#压缩与记忆)
9
+ - [她每一步看到的上下文](#她每一步看到的上下文)
10
+ - [心情值](#心情值)
9
11
  - [世界范围与会话](#世界范围与会话)
10
12
  - [微信](#微信)
11
13
  - [QQ](#qq)
@@ -14,11 +16,11 @@
14
16
 
15
17
  装上、升级之后不用你做什么,下面这些就会发生:
16
18
 
17
- - **首次启动时,profile 的压缩会被换成 dsh-world 自带的“只留对话”压缩**(先备份,重启 DSH 后生效)。整个 profile 的会话都会受影响。不想换,写 `replaceCompaction: false`。DSH 桌面版上会把世界所用的预设整份写进 profile 再换。详情:[默认换用只留对话的压缩](#默认换用只留对话的压缩)。
18
- - **自动压缩在上下文窗口的 75% 触发**,没声明窗口的模型按 1M 估算。详情:[自动压缩什么时候触发](#自动压缩什么时候触发)。
19
+ - 直接在 profile 使用原版压缩时,可自动换成插件的“只留对话”压缩。桌面版由会话预设管理压缩,旧版留下的预设副本可以从控制台还原。详情见 [默认换用只留对话的压缩](#默认换用只留对话的压缩)。
20
+ - 插件自带的自动压缩在上下文窗口的 75% 触发,没声明窗口的模型按 1M 估算。详情见 [自动压缩什么时候触发](#自动压缩什么时候触发)。
19
21
  - **每晚回顾(默认 23:00)之后,家会话会自动压缩一次**,每晚多一次摘要调用,控制台可关。详情见[每日回顾后自动压缩](#每日回顾后自动压缩)。
20
22
  - **过去的日记她改不了**:只能写今天的;写错了,在今天的日记里纠正。详情:[过去的日记只读](#过去的日记只读)。
21
- - **在控制台写了人设,它会取代 DSH 自带的那句默认身份**;你已经在 DSH 里设好的系统人设原样保留。详情:[人设和 DSH 自带的系统提示词](#人设和-dsh-自带的系统提示词)。
23
+ - 世界会话的完整系统提示词由控制台人设和世界模板组成。详见 [人设和 DSH 自带的系统提示词](#人设和-dsh-自带的系统提示词)。
22
24
  - **微信和 QQ 默认都是关的**,要用先在配置里启用,再到控制台「概览 → 接入」拨开(已经在用微信的世界升级后保持开着)。微信群里被 @ 时默认带前 5 条消息作上下文,控制台微信页可调 1–20。详情:[微信的开关](#微信的开关)、[QQ 的开关](#qq-的开关)。
23
25
 
24
26
  ## 安装与升级
@@ -29,7 +31,7 @@ DSH 0.2.2-rc.1 要求 Node.js 至少 24.9,升级自部署宿主时请同时检
29
31
 
30
32
  ### 默认换用只留对话的压缩
31
33
 
32
- 默认自动换上。装好 `dsh-world` 后第一次启动,插件会把你 profile 的 `cordis.patch.yml` 里原版压缩那一行换成 `dsh-world/compaction`,先在同目录留一份 `.dsh-world.<随机>.bak` 备份,重启 DSH 后生效,世界面板的健康状态里会提示这件事。只有找到唯一一条原版压缩配置时才会改;已经换过、写法对不上或有多条时什么都不动。每个世界只试这一次:之后你手动改回原版,它不会再替你换。不想换,在 `dsh-world` 的配置里写 `replaceCompaction: false`。手动启用或恢复也可以用下面的脚本:
34
+ 当 profile 没有会话预设且 `cordis.patch.yml` 里有唯一一条原版压缩配置时,插件会尝试换成 `dsh-world/compaction`。同目录会留一份 `.dsh-world.<随机>.bak` 备份,重启 DSH 后生效。成功后每个世界只换一次,手动改回去会保留你的选择。可以用 `replaceCompaction: false` 关闭,也可以用下方脚本手动替换。
33
35
 
34
36
  ```powershell
35
37
  powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\enable-tool-free-compaction.ps1 -profilePath '<你的 DSH profile 目录>'
@@ -37,13 +39,13 @@ powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\enable-tool-free-c
37
39
 
38
40
  脚本做的是同一件事:把原版压缩条目换成 `dsh-world/compaction` 并留备份。它对整个 profile 生效,不限世界工作区,见 [对世界工作区以外的影响](#对世界工作区以外的影响)。
39
41
 
40
- **DSH 桌面版(Web 界面)上换的是整个预设。** 桌面版把原版压缩放在每个会话所用预设的隔离组里(`dsh-web-app` 的 `presets/standard.patch.yml`),profile 的 `cordis.patch.yml` 里没有那一行,profile 补丁也够不到预设内部(按 id 改会报 `entry "compaction" not found`)。这时插件通过 DSH 自己的配置编辑服务(设置页保存预设走的就是它),把世界所用的预设(`agentPreset`,默认 `standard`)整份写进 profile,只把其中压缩那一行换成 `dsh-world/compaction`,其余原样保留,同样先留备份,重启 DSH 后生效。你在 DSH 里编辑过这个预设的话,profile 里本来就有整份预设,走的是上面的直接替换。
42
+ **DSH 桌面版和 Web 宿主**把压缩放在会话预设中。插件保留宿主的预设和压缩,控制台的「应用并压缩」和回顾后压缩使用家会话现有的压缩服务。
41
43
 
42
- 整份写进 profile 的代价:之后 DSH 升级对这个预设的改动(新工具、提示词调整)不会自动进来,因为 profile 里这份会盖住 DSH 自带的。想跟上新版,恢复备份(或删掉 profile 里 `preset-standard` 那一项),再把 `world.json` 里的 `compactionSwapped` 删掉,下次启动会按新版预设重新换一次。只影响这个预设:其他预设的会话仍用原版压缩。
44
+ 旧版本可能已经把 `standard` 或其他预设整份写进 profile。这份覆盖会挡住 DSH 对预设的更新。世界控制台「概览 → 会话预设」会持续显示使用 `dsh-world/compaction` 的预设覆盖。点「还原 DSH 预设」会先备份 profile 文件,再移除当前预设的整份覆盖(包括其中手动改过的设置)。重启 DSH 后,已有会话会用继承的预设。若想保留覆盖里的自定义设置,可先在 DSH 的预设设置中核对或从备份中取回。无需清理 `world.json` 的旧 `compactionSwapped` 记录。
43
45
 
44
46
  DSH 从预设里删掉某一行时,这份副本还留着它,DSH 找不到那个插件就整个预设都不挂,用这个预设的会话全都打不开。已知的一处:DSH 0.2.2 把 `list_agents` 并进了 `dsh-tool-subagent-control`,副本里 `@deepseek-ai/dsh-tool-subagent-control/list-agents` 那一行不再存在,健康里是「家打不开……never started」。插件每次启动会检查 profile 里的每份预设副本,DSH 自带的预设已经不带这一行时,先备份 `cordis.patch.yml` 再删掉它,健康里说明删了哪个预设,重启 DSH 后恢复;DSH 0.2.1 上这一行仍然有效,不会被删。别的行插件不会替你删:遇到同样「never started」的报错,退出 DSH,对照 DSH 自带的预设,手动删掉报错里那一行。故障期间发来的微信消息不会自动补送,那个聊天会停在「上次消息结果尚未确认」,按 [微信模块](src/ecosystem/wechat/windows/README.md) 的 `Acknowledge` 流程核对(运行中的适配器会占着它,先在控制台关掉微信模块,做完再打开),然后重发那条消息。
45
47
 
46
- 换不成时(找不到预设、预设里没有或有多条原版压缩),插件不改任何文件,在健康状态里说明:自动压缩仍由预设自带的压缩负责,下面的 75% 触发线不生效。控制台的「应用并压缩」和回顾后压缩不受影响,它们直接使用家会话预设里的那个压缩。
48
+ 自动压缩的触发线以当前会话实际使用的压缩服务为准。
47
49
 
48
50
  ### 微信首次接入与升级
49
51
 
@@ -65,20 +67,17 @@ DSH 从预设里删掉某一行时,这份副本还留着它,DSH 找不到那
65
67
 
66
68
  ### 人设和 DSH 自带的系统提示词
67
69
 
68
- 在控制台「人设」页写了内容以后:
70
+ 世界运行时,在她工作区里且匹配世界预设的普通会话,系统提示词只使用控制台「人设」和渲染后的世界模板。人设留空时使用世界模板。想把在 DSH 里写过的角色设定带进世界,可以把相应文字填进世界控制台的人设。
69
71
 
70
- - 它取代 DSH 自带的那句默认身份(“You are an AI agent powered by DeepSeek Harness.”),作为单独一段放进系统提示词。
71
- - 你在 DSH 里已经设好的系统人设(宿主设置里的人设前缀,或当前预设自带的人设)**不会被替换**,原样保留在最前面,控制台写的排在它后面。预设如果已经自己改写了那句默认身份,也按它写的保留;你在 DSH 里关掉了默认身份、自己写开头,同样不动。
72
- - 控制台「人设」全部留空时,什么都不改,沿用 DSH 的默认身份和你已有的人设。
73
- - DSH 其余的系统提示(计划、工具、文件引用等说明)不动。
74
- - 如果同一份人设在 DSH 里和控制台里各写了一遍,两份都会进提示词,内容会重复;只想要一份,清掉其中一处。
75
- - 范围和世界提示词一样,只在她工作区里、匹配该世界预设的普通会话生效。已有会话下一轮使用改动,新会话直接读取已保存的内容。
72
+ 移出工作区或停止世界后,下一轮对话恢复会话原有的 DSH 系统提示词。记忆、闹钟等工具继续按各自的权限提供。
73
+
74
+ 升级后,能从原工作目录或旧日志识别出曾属于世界的会话,会在下一轮重新组装系统提示词,聊天记录保留。这类会话若已经在世界外,请先发一条消息,再执行压缩。
76
75
 
77
76
  ## 压缩与记忆
78
77
 
79
78
  ### 自动压缩什么时候触发
80
79
 
81
- 适用于 dsh-world 自带的压缩,默认会换上。每一步发请求之前检查一次,会话用量超过上下文窗口的 **75%** 就先压缩。窗口是 1M 时约 786,432。比例可以在压缩那一行的 `config` 里用 `thresholdRatio` 调整。
80
+ 使用 dsh-world 自带的压缩时,每一步发请求之前检查一次,会话用量超过上下文窗口的 **75%** 就先压缩。窗口是 1M 时约 786,432。比例可以在压缩那一行的 `config` 里用 `thresholdRatio` 调整。
82
81
 
83
82
  - 只有当单次回复上限(`maxTokens`,由 DSH 给模型的请求带上,不是本插件设的)大到“提示加回复装不下”时,才会比 75% 更早触发;不再额外扣固定的余量。
84
83
  - 窗口值取自模型适配器声明的 `contextWindow`。适配器没有声明的模型(自己加的通道常见),按 `defaultContextWindow`(默认 1,048,576,即 1M)估算,并在日志里警告一次。如果它真实的窗口更小,请在适配器模型上配置 `contextWindow`,或在 `modelPolicies` 里给这个模型写 `defaultContextWindow`。
@@ -122,6 +121,64 @@ DSH 从预设里删掉某一行时,这份副本还留着它,DSH 找不到那
122
121
 
123
122
  归档写不进去(比如磁盘满、数据库被占用)、某个会话的日志一时读不出来,或者记忆块建不出来时,她照常回话,问题显示在控制台的「健康」里。这期间说的话不会丢:它们在宿主的会话日志里,插件记着每个会话归档到了哪里,问题解决后,这个会话下一次有动静或 DSH 下次启动时,会从断点补进归档,不会重复。记忆块建不出来时,她眼前还是上一块(刚压缩完就没有),下一步会再试。补不回来的只有一种:宿主的会话日志在磁盘上坏了、一直读不出来,那个会话里的话就进不了归档,健康里会一直显示它。
124
123
 
124
+ ## 她每一步看到的上下文
125
+
126
+ ### 上下文怎么排
127
+
128
+ 她每一次请求模型(一步)带的是到这一刻为止的全部内容:历史一直往后接,什么都不等一轮结束才加。一轮里的排法是:
129
+
130
+ ```
131
+ [历史……] [别处的动静] [群上下文、引用、图片] [新消息] [心情] [时间] ← 这一轮第一步
132
+ …… [她的回复和工具结果] [别处又来的动静] [心情] [时间] ← 之后的每一步
133
+ ```
134
+
135
+ 插件放进上下文的东西分三类,各有各的位置:
136
+
137
+ - **随消息来的上下文**:群里这句话之前在聊什么、引用的原消息、图片。它说明的是某一句话,所以贴在那句话前面。
138
+ - **状态**:心情值、时间。说的是「现在是什么样」,每一步都要是最新的,所以每一步都跟在最后,时间在最末。
139
+ - **事件**:别处的动静。说的是「刚才发生了什么」,发生过的说一次就够。每轮开头放在新消息前面,说这条消息进来之前别处攒下了什么;一轮还在进行时别处又有新的,下一步在末尾追加一条,只写新增的部分;没有新的就不放。
140
+
141
+ ### 为什么状态每一步都放、事件只放一次
142
+
143
+ 这几块都只往后追加,不替换、不删除历史里的旧的:替换会让从那个位置往后的缓存全部失效。追加一条只多它自己那几十个 token,前面的照样命中,压缩时一起清掉。
144
+
145
+ 状态每一步都放,是心情值那次的教训:0.7.5 只在心情变了时放一条,她一次醒来能连着做一百多步,那条很快沉到十几万 token 之后,她不再注意到,心情一两天没动过。事件不这样放,是因为同样的事每一步念一遍只是重复;她没去看,未读数还在,下一次有新动静时会带上最新的累计数,不会漏掉。
146
+
147
+ ### 别处的动静只报事实
148
+
149
+ 「别处」是她不在场的地方:已配置的微信群、她的其他会话(家、群会话、你在她工作区另开的窗口),以后接入的推特、B 站等也一样。每个来源只报几件事实:有多少条她还没看到、最后是谁、过了多久,**不带正文**。这一块开头有一句说明,告诉她这只是让她知道,不是对她说的话,要不要看、要不要回由她决定,所以自己改过世界提示词的用户也不用补说明。想看就用各来源写明的工具(微信群用 `wechat_history`,别的会话用 `memory_find`),读到最新的以后,那个来源的未读清零。
150
+
151
+ 这一块本身不带正文,原话不会因为它进到别的会话里;她要看,用的还是原来就有的工具,能看到哪些会话照旧由归档范围决定。
152
+
153
+ 别处的动静都会流进家,群会话也能看到。群会话里原本就有近期记忆(里面有家里和私聊的原话),现在又多了「家里有几条新的」,所以在群会话里,近期记忆和别处的动静末尾都会多一句:「我现在在群里。家里和私聊里的话是我和对方之间的:不把原话和细节带进群里说,也不替谁转述;群里有人问起,就带过去,不乱说。」家和你在 DSH 里另开的窗口不加这句。这是提示词上的约束,不是硬性拦截:她仍然看得到这些内容,靠的是她自己守住。这也和插件不往对话里推提醒的原则一致(见 [贡献协议](CONTRIBUTING.md#生活线与她的主动性)):给她能感知的事实,不替她决定。
154
+
155
+ 现在接进来的有两种:
156
+
157
+ - **微信群**:适配器在线时,有未读的群各一行,比如「微信群「家人」12 条我还没看到,最后是阿明(5 分钟前)」。没有未读的群各安静了多久,仍然只附在她的闹钟消息上,那是给她决定要不要主动开口用的。
158
+ - **她的其他会话**:家、群会话、你在她工作区另开的窗口,各一行,比如「家有 6 条我在这边没看到,最后是我自己(刚刚);sourceId:chat:session-…」。数的是那边归档进来的发言(双方的都算),从这个会话开始听的那一刻算起:升级或重启 DSH 之后从当时开始,以前的不补。她用 `memory_find` 带上那个 sourceId、不写 query 翻最新的一页,就算看过了,那边之后的才再算。
159
+
160
+ ## 心情值
161
+
162
+ ### 心情值为什么是固定的一组
163
+
164
+ 心情值只认固定的 11 个:开心、兴奋、平静、安心、烦、生气、紧张、难过、累、孤单、想念,按这个顺序显示,她没写的算 0。0.7.4 时她还能自己加词,实际用下来很快就出现了同义词:她写了「高兴 7」,和默认的「开心 0」并排出现在快照里。由着她加词,同义词会越积越多,快照越来越长,前后几次也没法比。所以 0.7.5 起名字固定,数值只回答「有多少」;想说得更细的,比如「有点想家」「被夸了有点不好意思」,写进不以数字结尾的「小事」那几行(最多三行),那里本来就是自由文字,也不会膨胀。
165
+
166
+ 这 11 个按「愉快/不愉快 × 激动/平静」四个角各取几个,再加上跟人有关的孤单和想念;原来的「困」并进了「累」。
167
+
168
+ - 用 `set_mood` 写了组外的词,这次不写入,并告诉她能用哪些。
169
+ - 直接改文件写了组外的词,文件不改,快照和控制台「健康」里的心情会说哪几个没算进去。
170
+ - 0.7.4 时写过自己的词的,升级后那几行不再算进心情值,快照里会提示一次,她下次用 `set_mood` 换成组里最接近的那个就好。
171
+
172
+ ### 心情快照为什么只追加、不替换
173
+
174
+ 每一步,插件都在时间块前面追加一条心情快照,写着她最后改它是多久以前;旧的留在历史里,以最新一条为准,压缩时一起清掉。不去替换历史里的旧快照,是因为替换会让从那个位置往后的缓存全部失效:心情是她随时会改的,三十轮没变、改一次,这三十轮的内容就都要按未命中缓存重新计费;追加一条每次只多几十个 token。
175
+
176
+ 0.7.5 只在心情变了、或者每轮开头才放一条。实际用下来,她一次醒来能连着做一百多步(整理文件、查资料),那条快照很快沉到十几万 token 之后,她不再注意到它,心情一两天都没动过。0.7.6 起每一步都放,和时间块一样跟在最后:她每一步都看得到现在的心情、以及它停了多久,要不要改由她自己决定。代价是每一步多几十个 token,一百多步的一轮大约多一万,比起这一轮本身涨的十几万很小;只往后追加,前面的缓存照样命中。
177
+
178
+ ### 她为什么有 set_mood 工具
179
+
180
+ 0.7.4 时只能改文件:先读再写,至少两次工具调用,实际用下来她很少改。0.7.5 起她世界里的会话都有 `set_mood`,一次调用就整份记下,格式不对时不写入并说明原因;快照末尾也写着「用 set_mood 改」,压缩之后她也知道怎么改。直接改文件照样有效。插件仍然不提醒她改、不替她判断、不让数值自己衰减。
181
+
125
182
  ## 世界范围与会话
126
183
 
127
184
  ### 新会话的预设选择
@@ -132,7 +189,7 @@ DSH 从预设里删掉某一行时,这份副本还留着它,DSH 找不到那
132
189
 
133
190
  只有下面这一项会作用到世界工作区以外的会话:
134
191
 
135
- - **只留对话的压缩**(装上插件后首次启动默认换上,可在配置里写 `replaceCompaction: false` 关掉):它替换的是整个 profile 的压缩方式,其他工作区的会话压缩时也会去掉工具调用过程,只留一段对话摘要。写代码等依赖工具过程的会话,压缩后会丢掉这些细节。
192
+ - **只留对话的压缩**在它所在的 profile 或预设内生效。该范围内的其他会话压缩时也会去掉工具调用过程,只留一段对话摘要。写代码等依赖工具过程的会话,压缩后会丢掉这些细节。
136
193
 
137
194
  除此之外,人设、记忆、世界提示词、世界线、工具、通道和归档都不会进入工作区以外的会话。人设在 0.7.1 及以前不限工作区,所有用同一预设的会话都会带上;现在和其他部分一样只进她的工作区。以前在工作区外的窗口里和她聊、想继续带着人设的,把那个窗口挪进她的工作区。
138
195
 
package/README.md CHANGED
@@ -20,7 +20,8 @@
20
20
  - **近期记忆**:你们最近数轮的对话原文,每次开始对话、每次压缩之后,以及一个窗口隔了很久(默认 24 小时,控制台可改)再开口时,都放在她眼前,谁、什么时候、说了什么,一字不差。轮数在控制台里填,默认 200。
21
21
  - **日记**:人生里重要的事,她自己写进日记,一天一篇。这是她的长期记忆。
22
22
  - **我是谁**:她写给自己的一份自述,随着她变化而改写。每晚回顾前,插件会留一份当时的版本,改过的都找得回来。
23
- - **心情值**:`room/mood.md` 是她自己写的,一行一件:`开心 6` 这样的「名字 数值」是一种心情(0 到 10 的整数),不以数字结尾的行是心情旁边的几件小事(最多三行)。默认的一组是开心、兴奋、平静、累、困、烦、难过、紧张,没写的算 0,她也可以加自己的词。她世界里的会话在每轮开头、以及她改过之后的下一步,把当前的心情值作为一条快照放在时间块前面;没变就不重复放,旧的那条不删,以最新一条为准,压缩时一起清掉,不打乱缓存。插件只读、不判断、不衰减、不提醒她改;没有 `mood.md` 就什么都不放。快照不进归档;写错的行只在快照里告诉她,文件读不出来才进健康状态。
23
+ - **心情值**:`room/mood.md` 是她自己写的,一行一件:`开心 6` 这样的「名字 数值」是一种心情(0 到 10 的整数),不以数字结尾的行是心情旁边的几件小事(最多三行)。名字是固定的 11 个:开心、兴奋、平静、安心、烦、生气、紧张、难过、累、孤单、想念,没写的算 0;更细的感受写进小事,为什么这样定见 [注意事项](NOTES.md#心情值为什么是固定的一组)。她世界里的会话都有 `set_mood` 工具,一次调用就整份记下,格式不对时不写入并告诉她哪里错了;直接改文件也一样。她世界里的会话每一步都把当前的心情值作为一条快照放在时间块前面,写着她最后改它是多久以前;和时间块一样只往后追加,旧的不删,以最新一条为准,压缩时一起清掉,不打乱缓存。插件只读、不判断、不衰减、不提醒她改;没有 `mood.md` 就什么都不放。快照不进归档;写错的行只在快照里告诉她,文件读不出来才进健康状态。控制台概览的「健康」里,插件的故障下面是她的心情,只读,显示她现在的心情值、旁边的小事和她最后改的时间。
24
+ - **别处的动静**:她不在场的地方攒下的消息,只报有多少条她还没看到、最后是谁、过了多久,不带正文:有未读的微信群,以及她的其他会话(家、群会话、你另开的窗口)。每轮开头放在新消息前面,一轮中途有新的就在下一步末尾补一条,没有新的就不放;要不要看、要不要回由她决定,排法和原因见 [注意事项](NOTES.md#她每一步看到的上下文)。
24
25
  - **范围内的原文留着**:按天归档用户和助手的正文。近期记忆以外的事,她可以自己去翻。
25
26
  - **找回过去**:`memory_find` 与 `memory_read` 两个工具(一次默认只返回 8 条、每条约 200 字的摘录,要更多自己翻页或读原文,免得每轮重发的上下文越滚越大),按原文里的字面线索、时间、种类或来源,在聊天原文和日记里统一查找,并读原文。控制台的「档案」页是同一份查找的只读入口。
26
27
 
@@ -47,7 +48,7 @@ DSH 设置里的「世界控制台」:
47
48
  - **开始 / 停止**:按下开始,她才住进来;按下停止,记忆、人设和生活线一起安静下来,家还在,等你回来。
48
49
  - **人设**:分层写她是谁:名字、她是谁、性格、说话方式、愿景、补充,旁边实时预览她读到的样子。写了以后,它取代 DSH 自带的那句默认身份(“You are an AI agent powered by DeepSeek Harness.”);你已经在 DSH 里设过的系统人设(宿主设置里的人设,或当前预设自带的人设)不会被替换,原样保留,这里写的排在它后面;预设如果已经自己改写了那句默认身份,也按它写的保留,不会被盖掉。全部留空时什么都不改,沿用 DSH 的默认身份和你已有的人设,控制台不自动回填。DSH 里其余的系统提示(计划、工具和文件引用等说明)不动。
49
50
  - **世界提示词**:你想对她说的话,以及她的世界的说明。
50
- - **相册**:家会话可用 `keep_photo` 收藏本轮最新消息中的图片(含本轮已读取的微信图片和引用图),`list_photos` 分页查看说明,`forget_photo` 移除收藏。控制台顶部「相册」页查看照片,点开才加载图片;照片不会自动加入之后每轮上下文。旧相册首次打开时导入,原文件保留。
51
+ - **相册**:家会话可用 `keep_photo` 收藏她眼前的任意一张图片(`index` 从最新的一张往前数,聊天里收到的、引用的、工具读出来的都算;压缩掉的不算),也可以用 `path` 收藏电脑上的一个图片文件(png、jpg、webp、gif,最多 20MB,相对路径从房间算起);同一张图只存一份。`list_photos` 分页查看说明,`forget_photo` 移除收藏。控制台顶部「相册」页查看照片,点开才加载图片;照片不会自动加入之后每轮上下文。旧相册首次打开时导入,原文件保留。
51
52
  - **应用并压缩家会话**:等家空闲后压缩聊天历史。人设、世界提示词和「我是谁」的改动会在下一轮对话生效。详见[注意事项](NOTES.md#提示词保存后何时生效)。
52
53
  - **作息**:概览里的「作息」卡片设每日回顾和早上醒来的时间,记在 `world.json`;留空恢复默认(回顾 23:00,早上用配置里的 `fallbackWakeTime`)。保存后,已排好的回顾和早上闹钟立刻改到新时间,她自己定的闹钟不动;世界停着时改的,下次启动时跟上。回顾定在中午以前,回顾的是前一天。
53
54
  - **工作区权限**:选择世界工作区新建会话的默认权限,选项沿用宿主提供的权限预设,默认完全权限。保存后对新会话生效;已有会话及其手动权限不会被重新覆盖。
@@ -64,7 +65,7 @@ DSH 设置里的「世界控制台」:
64
65
  容易踩的地方都集中写在 [注意事项](NOTES.md),按主题分类。第一次装或升级之前,建议先看 [默认就会发生的事](NOTES.md#默认就会发生的事)。
65
66
 
66
67
  - [安装与升级](NOTES.md#安装与升级):默认换用只留对话的压缩。
67
- - [人设与提示词](NOTES.md#人设与提示词):提示词何时更新,以及控制台人设和 DSH 自带系统提示词如何共存。
68
+ - [人设与提示词](NOTES.md#人设与提示词):世界会话的完整系统提示词、更新时机和生效范围。
68
69
  - [压缩与记忆](NOTES.md#压缩与记忆):什么时候自动压缩、每日回顾后自动压缩。
69
70
  - [世界范围与会话](NOTES.md#世界范围与会话):对世界工作区以外的影响,以及“会话已离开世界工作区”怎么排查。
70
71
  - [微信](NOTES.md#微信):支持的版本、账号风险、图片和表情包、@、退出重开。
@@ -80,7 +81,7 @@ dsh-world 开放了一个本地的「桥」:桌宠之类的程序可以把你
80
81
 
81
82
  微信作为独立模块接入同一个家,使用她的独立账号收发指定私聊或群聊。她可用 `wechat_chats` 查询已配置目标,用 `wechat_history` 主动分页查看群消息,无需等别人 @,历史里的图片用 `wechat_image` 按消息 ID 一张张看;读完以同一个 `chatId` 调用 `wechat_send` 自主联系对方或回复消息,文字、图片和表情共用同一发送队列;一批话没发出或结果不明时,发起的会话会在下一步收到一条说明(不会因此被叫醒),平时不用逐条查回执,需要时仍可用 `wechat_delivery` 查询。普通最终回答不会自动转发到微信。Windows 适配器和配置步骤见 [微信模块](src/ecosystem/wechat/windows/README.md)。B 站尚未接入。
82
83
 
83
- **群聊动静**:适配器在线时,已配置群里未 @ 她的消息只更新未读数、最后发言人和时间,不唤醒模型,也不把正文加入上下文。她原有的闹钟响起时,会附上一行群聊概况,包括未读消息或安静了多久;是否去看、是否发言,由她自己决定。成功读取群的最新一页后清零未读,自己的发言不计入未读;计数保存在适配器状态中,重启保留。插件不会改写你的 `alarm.md`、`world-prompt.md` 或「我是谁」。
84
+ **群聊动静**:适配器在线时,已配置群里未 @ 她的消息只更新未读数、最后发言人和时间,不唤醒模型,也不把正文加入上下文。有未读的群出现在她的「别处的动静」里,每有新消息说一次;她原有的闹钟响起时,还会附上一行没有未读的群各安静了多久。是否去看、是否发言,由她自己决定。成功读取群的最新一页后清零未读,自己的发言不计入未读;计数保存在适配器状态中,重启保留。插件不会改写你的 `alarm.md`、`world-prompt.md` 或「我是谁」。
84
85
 
85
86
  微信的支持版本、账号风险、图片与表情包、表情库、@、退出重开等注意事项,见 [注意事项·微信](NOTES.md#微信);首次接入与升级见 [注意事项·安装与升级](NOTES.md#微信首次接入与升级)。
86
87
 
@@ -122,7 +123,7 @@ node <DSH 自带 pnpm 的入口文件> add dsh-world@latest --ignore-scripts --r
122
123
 
123
124
  **已有 world 更新**:正常退出 DSH 后,用 [`scripts/update-world.mjs`](scripts/update-world.mjs) 指定原 profile、`.tgz` 和 DSH 自带 pnpm;`.tgz` 可直接从 npm 下载,例如 <https://registry.npmjs.org/dsh-world/-/dsh-world-0.6.4.tgz>。脚本先备份完整 profile、世界及会话,再更新并校验;失败恢复旧 profile,保留她已有文件。安装成品无需 Git、npm 或 TypeScript,完整命令与恢复说明见 [已有 world 升级](INSTALL.md#已有-world用编译包更新)。
124
125
 
125
- **只留对话的压缩**:装好 `dsh-world` 后第一次启动,默认会把 profile 的压缩换成 `dsh-world/compaction`(先备份,重启 DSH 后生效),整个 profile 的会话压缩都会受影响。怎么关、怎么手动启用,见 [注意事项·安装与升级](NOTES.md#安装与升级)。
126
+ **只留对话的压缩**:只有原版压缩直接写在 profile、且没有使用会话预设时,插件才会尝试换成 `dsh-world/compaction`。桌面版使用会话预设自己的压缩。已有旧版副本可在世界控制台「概览 → 会话预设」还原。详见 [注意事项·安装与升级](NOTES.md#安装与升级)。
126
127
 
127
128
  ## 设置
128
129
 
@@ -140,7 +141,7 @@ node <DSH 自带 pnpm 的入口文件> add dsh-world@latest --ignore-scripts --r
140
141
  agentPreset: standard # 她所在的预设
141
142
  timeZone: Asia/Seoul # 默认系统时区
142
143
  life: true # 生活线,默认开启
143
- replaceCompaction: true # 首次启动把 profile 的压缩换成 dsh-world 的只留对话压缩;false = 不动
144
+ replaceCompaction: true # 自动替换直接写在 profile 里的原版压缩;对会话预设不生效
144
145
  archiveScope: workspace # workspace:家的工作区;home:仅当前家会话
145
146
  fallbackWakeTime: '09:00' # 没定闹钟时,早上几点叫醒她;控制台「作息」里改过的优先
146
147
  diaryDir: C:/path/to/日记 # 日记目录,默认在世界目录里
@@ -235,7 +236,13 @@ node <DSH 自带 pnpm 的入口文件> add dsh-world@latest --ignore-scripts --r
235
236
 
236
237
  **把话送进她的家**(`bridge: true`):插件启动时写出 `<世界目录>/bridge.json`,内容是 `{ origin, sayPath, compactPath, token, name, ... }`。向 `POST {origin}{sayPath}` 发 `{ "text": "..." }`,请求头带 `x-dsh-world-token: <token>`,会立即返回 `202`。这句话会作为你本人说的话进入她的家和记忆。
237
238
 
238
- **接收她的话**(`outlets`):每个目标写一个 `name`,地址用 `url`(其中 `{origin}` 会被替换),或者用 `urlFile` + `path`(端口会变的程序用这个);再用 `kinds` 选择要接收哪些:`reply` 是桥上那句话的回复,`busy` 表示她正忙,`reach` 是她主动找你。插件会向目标 `POST`:
239
+ **接收她的话**(`outlets`):每个目标写一个 `name`,地址用 `url`(其中 `{origin}` 会被替换),或者用 `urlFile` + `path`(端口会变的程序用这个)。`kinds` 按类型过滤推送,省略或留空时接收所有类型。
240
+
241
+ - `reply`:通过桥送入的话进入回合后,等回合正常结束,再推送最终回复,每轮最多一次。最终回复没有正文或图片,或回合以工具调用结束时,跳过推送。
242
+ - `busy`:话从桥上送入后三分钟仍在等回复时发出的忙碌提示。之后收到的回复仍按 `reply` 处理。
243
+ - `reach`:她用 `reach_out` 主动找你。只想接收这类消息时,配置 `kinds: [reach]`。
244
+
245
+ 插件会向目标发送 `POST` 请求,正文格式如下。
239
246
 
240
247
  ```json
241
248
  { "text": "她的话(纯文本)", "kind": "reply", "name": "她的名字", "images": ["http://…"], "image": "表情名" }
package/client/index.js CHANGED
@@ -286,6 +286,25 @@
286
286
  h('span', { role: 'status', 'aria-live': 'polite', className: error || state.status === 'failed' ? 'dw-bad' : 'dw-muted' }, error || (waiting ? '已排队,不打断当前对话。' : compacting ? '正在执行,请稍候。' : state.message) || (!snap.running || !snap.life ? '请先启动世界生活线。' : ''))))
287
287
  }
288
288
 
289
+ function CompactionPreset(props) {
290
+ var info = props.info
291
+ var sendingState = useState(false), sending = sendingState[0], setSending = sendingState[1]
292
+ var resultState = useState(null), result = resultState[0], setResult = resultState[1]
293
+ function restore() {
294
+ if (!window.confirm('还原预设「' + info.preset + '」?这会移除该预设在当前 profile 中的整份覆盖(包括你自己改过的设置),操作前会备份。')) return
295
+ setSending(true); setResult(null)
296
+ post('restore-compaction-preset').then(function () {
297
+ setResult({ text: '已移除覆盖并备份。请重启 DSH,让已有会话使用还原后的预设。' })
298
+ props.refresh()
299
+ }, function (e) { setResult({ text: e.message || String(e), error: true }) }).then(function () { setSending(false) })
300
+ }
301
+ if (!info && !result) return null
302
+ return h(Card, { title: '会话预设' },
303
+ info ? h('div', { className: 'dw-muted' }, '预设「' + info.preset + '」正在使用 profile 中的压缩配置副本。DSH 升级时,自带预设的更新不会合入这份副本。') : null,
304
+ info && info.canRestore ? h('div', { className: 'dw-setting' }, h('button', { className: 'dw-btn', disabled: sending, onClick: restore }, sending ? '还原中…' : '还原 DSH 预设')) : null,
305
+ result ? h('div', { role: 'status', className: result.error ? 'dw-bad' : 'dw-muted' }, result.text) : null)
306
+ }
307
+
289
308
  /** 今天家里花了多少,和每天的额度(留空不限)。 */
290
309
  function Budget(props) {
291
310
  var budget = props.budget || {}, daily = budget.daily, today = budget.today
@@ -671,9 +690,29 @@
671
690
  row('qq', 'QQ', m.qq, '插件自己直连 OneBot:状态和设置在 QQ 页面。关闭就断开这条通道。', '开启时检查 SDK;缺少时按需安装并提示重启 DSH。'),
672
691
  msg ? h('div', { className: msg.indexOf('失败') >= 0 ? 'dw-bad' : 'dw-muted', role: 'status' }, msg) : null)
673
692
  }
693
+ // Read-only: what she wrote in mood.md and reads before each turn's time block. Only she changes it.
694
+ function Mood(props) {
695
+ var mood = props.mood
696
+ return !mood || mood.kind === 'none' ? h('div', { className: 'dw-muted' }, '她还没有写 mood.md')
697
+ : mood.kind === 'failed' ? h('div', { className: 'dw-bad' }, 'mood.md 读不出来:' + mood.message)
698
+ : [
699
+ h('div', { key: 'v', className: 'dw-trail' }, list(mood.values).map(function (v) { return h('span', { key: v.name, className: v.value ? null : 'dw-muted' }, v.name + ' ' + v.value) })),
700
+ list(mood.trivia).length ? h('div', { key: 't', style: { marginTop: 8 } }, '旁边:' + list(mood.trivia).join(';') + (mood.cut ? '……后面还有' : '')) : null,
701
+ list(mood.outside).length ? h('div', { key: 'o', className: 'dw-muted' }, list(mood.outside).join('、') + ' 不在固定的心情里,没有算进去') : null,
702
+ mood.unread ? h('div', { key: 'u', className: 'dw-muted' }, '有 ' + mood.unread + ' 行没读懂,她在快照里能看到') : null,
703
+ h('div', { key: 'at', className: 'dw-muted', style: { marginTop: 8 } }, mood.updatedAt ? '她最后改于 ' + local(mood.updatedAt, props.zone) : ''),
704
+ ]
705
+ }
706
+ // Her mood sits with the plugin's faults: one place to see how things are with her.
707
+ function Health(props) {
708
+ var faults = list(props.faults)
709
+ return h(Card, { title: '健康', delay: 120 },
710
+ faults.length ? faults.map(function (f, i) { return h('div', { key: i, className: 'dw-bad' }, '● ' + f) }) : h('div', { className: 'dw-ok' }, '● 一切正常'),
711
+ props.mood ? h('div', { style: { marginTop: 12 } }, KV([['心情', h(Mood, { mood: props.mood, zone: props.zone })]])) : null)
712
+ }
674
713
  function Overview(props) {
675
714
  var snap = props.snap, zone = snap.timeZone, life = snap.life, alarm = life && life.alarm, mem = snap.memory
676
- var health = list(snap.health), wakes = life ? list(life.recentWakes) : []
715
+ var wakes = life ? list(life.recentWakes) : []
677
716
  var welcome = !snap.running && !life
678
717
  return h('div', { className: 'dw-pane' },
679
718
  welcome ? h(Card, null, h('div', { className: 'dw-welcome' },
@@ -694,7 +733,8 @@
694
733
  ['最近', wakes.length ? h('div', { className: 'dw-trail' }, wakes.map(function (w, i) { return h('span', { key: i }, local(w.deliveredAt, zone) + ' ' + (sourceLabel[w.source] || w.source) + (w.lateMs >= 120000 ? ' · 晚 ' + Math.round(w.lateMs / 60000) + ' 分' : '')) })) : '—'],
695
734
  ]))) : null,
696
735
  h('div', { className: 'dw-grid' },
697
- h(Card, { title: '健康', delay: 120 }, health.length ? health.map(function (f, i) { return h('div', { key: i, className: 'dw-bad' }, '● ' + f) }) : h('div', { className: 'dw-ok' }, '● 一切正常')),
736
+ h(Health, { faults: snap.health, mood: snap.mood, zone: zone }),
737
+ h(CompactionPreset, { info: snap.compactionPreset, refresh: props.refresh }),
698
738
  h(Memory, { mem: mem, onSaved: props.refresh }),
699
739
  h(Budget, { budget: snap.budget, onSaved: props.refresh }),
700
740
  snap.workspace ? h(WorkspacePermission, { workspace: snap.workspace, onSaved: props.refresh }) : null,
@@ -893,7 +933,7 @@
893
933
  return h(View, { snap: snap, error: error, tick: tick, refresh: function () { if (loadRef.current) loadRef.current() } })
894
934
  }
895
935
 
896
- return { Console: Console, test: { Memory: Memory, MemorySearch: MemorySearch, latest: latest, searchMemory: searchMemory, memoryQuery: memoryQuery, dayStartIso: dayStartIso, WorkspacePermission: WorkspacePermission, CompactAfterReview: CompactAfterReview, Schedule: Schedule, Modules: Modules, HomeApply: HomeApply, PhotoAlbum: PhotoAlbum, Wechat: Wechat, Activity: Activity, Diary: Diary, Qq: Qq, Panel: Panel, View: View, Overview: Overview, PersonaEditor: PersonaEditor, PromptEditor: PromptEditor, loadSnapshot: loadSnapshot, renderPersona: renderPersona } }
936
+ return { Console: Console, test: { Health: Health, Memory: Memory, MemorySearch: MemorySearch, latest: latest, searchMemory: searchMemory, memoryQuery: memoryQuery, dayStartIso: dayStartIso, WorkspacePermission: WorkspacePermission, CompactAfterReview: CompactAfterReview, Schedule: Schedule, Modules: Modules, HomeApply: HomeApply, PhotoAlbum: PhotoAlbum, Wechat: Wechat, Activity: Activity, Diary: Diary, Qq: Qq, Panel: Panel, View: View, Overview: Overview, PersonaEditor: PersonaEditor, PromptEditor: PromptEditor, loadSnapshot: loadSnapshot, renderPersona: renderPersona } }
897
937
  }
898
938
 
899
939
  async function loadWorldIds() {
@@ -0,0 +1 @@
1
+ export declare function abortable<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T>;
@@ -0,0 +1,17 @@
1
+ import { addAbortListener } from 'node:events';
2
+ export async function abortable(promise, signal) {
3
+ if (!signal)
4
+ return promise;
5
+ if (signal.aborted) {
6
+ void promise.catch(() => { });
7
+ signal.throwIfAborted();
8
+ }
9
+ let listener;
10
+ const aborted = new Promise((_, reject) => { listener = addAbortListener(signal, () => reject(signal.reason)); });
11
+ try {
12
+ return await Promise.race([promise, aborted]);
13
+ }
14
+ finally {
15
+ listener[Symbol.dispose]();
16
+ }
17
+ }
@@ -2,7 +2,7 @@ import type { Context } from '@deepseek-ai/cordis';
2
2
  import z from '@deepseek-ai/schemastery';
3
3
  import { CompactionEngine, type CompactionAgentContext, type CompactionResult, type CompactionTrigger, type ManualCompactAgentContext } from '@deepseek-ai/dsh-compaction';
4
4
  import type { CommandId } from '@deepseek-ai/dsh-commands/brand';
5
- import { type Message } from '@deepseek-ai/dsh-llm';
5
+ import { LlmError, type LlmFailure, type Message } from '@deepseek-ai/dsh-llm';
6
6
  import { type SessionSeq } from '@deepseek-ai/dsh-session';
7
7
  import { type RegionAgent, type SummaryResult } from './compactionRegion.ts';
8
8
  import './hostContract.ts';
@@ -59,6 +59,11 @@ export declare function compactionThreshold(input: {
59
59
  * tool result, tool schema and reasoning block from the compacted span, then
60
60
  * replaces the whole conversation with one summary paragraph.
61
61
  */
62
+ /**
63
+ * Raises a failure with its own code, ours or a provider's. DSH 0.2.2-rc.3 narrows the constructor's code to its built-in
64
+ * ones (only `LlmError.fromFailure`, which 0.2.1 lacks, takes any); the runtime check is unchanged.
65
+ */
66
+ export declare const llmError: (failure: LlmFailure) => LlmError;
62
67
  /** Whether a session's compaction service is this one, which can summarize inside a running turn; DSH's stock one cannot. */
63
68
  export declare const compactsWhole: (engine: unknown) => engine is Pick<ToolFreeCompaction, "compactWhole">;
64
69
  export default class ToolFreeCompaction extends CompactionEngine {
package/lib/compaction.js CHANGED
@@ -10,14 +10,14 @@ const summaryInstruction = [
10
10
  '现在暂停对话,改为执行上下文压缩:把上面这段会话中双方的交流整理成一段精炼的中文摘要,供你之后接着对话使用。',
11
11
  '保留用户的意图、情绪与关系进展、明确要求、重要事实、已作决定、未完成事项和最近进展;最后一条用户发言尽量按原意完整保留。以“以下是此前交流的摘要”开头的消息是更早的摘要,请与新内容合并为同一段。',
12
12
  '以【我的时间】(较早的是【你的时间】)开头的消息是你自己定的闹钟和留给自己的话,不是用户说的话;把它们当作你自己的安排来记,不要算作用户发言。',
13
- '开头写着“这是我们最近的聊天记录”(较早的写着“最近的聊天记忆”或“最近的相处记忆”)的记忆资料、系统提示里的世界提示词(含「我是谁」)、以【我的心情值】开头的心情快照和“Time sampled”开头的时间块会在压缩后重新提供,不要写进摘要。工具调用过程已从会话中删除,不要提及工具。',
13
+ '开头写着“这是我们最近的聊天记录”(较早的写着“最近的聊天记忆”或“最近的相处记忆”)的记忆资料、系统提示里的世界提示词(含「我是谁」)、以【我的心情值】开头的心情快照、以【别处的动静】开头的未读计数和“Time sampled”开头的时间块会在压缩后重新提供,不要写进摘要。工具调用过程已从会话中删除,不要提及工具。',
14
14
  '保留准确的姓名、日期、数字和标识,分清每件事是谁说的、谁做的。不要标题、列表或分段,不要开头语,不要补写原文没有的事实,不要调用任何工具,直接输出摘要正文。',
15
15
  ].join('\n');
16
16
  // The model tends to echo the checkpoint lead it saw on earlier summaries; the frame adds it once.
17
17
  const leadEcho = /^以下是此前交流的摘要[^::]{0,40}[::]\s*/;
18
18
  const checkpointLead = '以下是此前交流的摘要,工具调用过程已省略;请把它当作已知背景,直接接着当前对话继续:';
19
19
  // Re-injected after every successful compaction by the memory runtime; replayed only as cacheable prefix.
20
- const injectedSources = new Set(['time-context', 'dsh-world-history', 'dsh-world-mood']);
20
+ const injectedSources = new Set(['time-context', 'dsh-world-history', 'dsh-world-mood', 'dsh-world-elsewhere']);
21
21
  /**
22
22
  * The compacted span exactly as the conversation request sent it, minus every
23
23
  * tool call and tool result, so the summary request shares the longest possible
@@ -83,6 +83,11 @@ class TargetConfigError extends Error {
83
83
  * tool result, tool schema and reasoning block from the compacted span, then
84
84
  * replaces the whole conversation with one summary paragraph.
85
85
  */
86
+ /**
87
+ * Raises a failure with its own code, ours or a provider's. DSH 0.2.2-rc.3 narrows the constructor's code to its built-in
88
+ * ones (only `LlmError.fromFailure`, which 0.2.1 lacks, takes any); the runtime check is unchanged.
89
+ */
90
+ export const llmError = (failure) => new LlmError(failure.message, failure.code, failure);
86
91
  /** Whether a session's compaction service is this one, which can summarize inside a running turn; DSH's stock one cannot. */
87
92
  export const compactsWhole = (engine) => typeof engine?.compactWhole === 'function';
88
93
  export default class ToolFreeCompaction extends CompactionEngine {
@@ -294,7 +299,7 @@ export default class ToolFreeCompaction extends CompactionEngine {
294
299
  signal?.throwIfAborted();
295
300
  const finish = assembler.finish;
296
301
  if (finish.kind === 'error' || finish.kind === 'aborted')
297
- throw new LlmError(finish.failure.message, finish.failure.code, finish.failure);
302
+ throw llmError(finish.failure);
298
303
  if (finish.kind !== 'stop')
299
304
  throw new Error(`dsh-world: compaction summary truncated or invalid (${finish.kind})`);
300
305
  const rawOutput = assembler.blocks();
@@ -1,7 +1,6 @@
1
1
  export type CompactionSwap = {
2
2
  status: 'swapped';
3
3
  backup: string;
4
- preset?: string;
5
4
  } | {
6
5
  status: 'already';
7
6
  } | {
@@ -15,21 +14,14 @@ export type CompactionSwap = {
15
14
  * stock row is there, keeps a backup beside it and swaps atomically; DSH has to be restarted to load the new backend.
16
15
  */
17
16
  export declare function swapStockCompaction(profileDir: string): CompactionSwap;
18
- /** The preset's config with its one stock compaction row renamed to ours; the input is not changed. */
19
- export declare function swapPresetConfig(config: unknown): {
20
- status: 'swapped';
21
- config: unknown;
22
- } | Exclude<CompactionSwap, {
23
- status: 'swapped';
24
- }>;
25
17
  /** DSH's own editor for profile rows: the one its settings pages save through, which also reloads the row. */
26
18
  export interface ConfigEditor {
27
19
  entries(): ConfigEntry[];
28
20
  edit(entry: ConfigEntry, change: (raw: unknown, inherited: unknown) => unknown): Promise<void>;
29
- /** Each row with the value DSH itself supplies beneath the profile's override (DSH 0.2.2 on). */
30
21
  configuration?(): {
31
22
  entry: ConfigEntry;
32
23
  inherited: unknown;
24
+ override?: unknown;
33
25
  }[];
34
26
  }
35
27
  interface ConfigEntry {
@@ -39,12 +31,13 @@ interface ConfigEntry {
39
31
  config?: unknown;
40
32
  };
41
33
  }
42
- /**
43
- * DSH's Web host composes the stock compaction inside each preset, so the profile has no row to rename. The host's
44
- * preset editor writes the whole preset into the profile when a partner edits it; this does the same for her preset
45
- * with only the compaction row changed. That copy no longer follows later DSH updates to the preset.
46
- */
47
- export declare function swapPresetCompaction(editor: ConfigEditor, presetId: string, profileDir: string): Promise<CompactionSwap>;
34
+ export declare const hasAgentPresets: (editor: ConfigEditor | undefined) => boolean;
35
+ export declare function compactionPresetOverride(editor: ConfigEditor, id: string, profileDir: string | undefined): {
36
+ preset: string;
37
+ canRestore: boolean;
38
+ } | null;
39
+ /** Return the inherited value through DSH's editor so it removes the profile override. */
40
+ export declare function restoreCompactionPreset(editor: ConfigEditor, id: string, profileDir: string): Promise<void>;
48
41
  /** The copied preset without the rows DSH itself no longer ships, or undefined when there is nothing to drop; the input is not changed. */
49
42
  export declare function dropRetiredRows(config: unknown, inherited: unknown): unknown;
50
43
  /**
@@ -68,6 +61,5 @@ export declare function swapCompactionOnce(deps: {
68
61
  done(): boolean;
69
62
  markDone(): void;
70
63
  report(message: string): void;
71
- swap?: (profileDir: string) => CompactionSwap | Promise<CompactionSwap>;
72
- }): Promise<void>;
64
+ }): void;
73
65
  export {};