dsh-world 0.6.6 → 0.7.1

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 (90) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/CONTRIBUTING.md +163 -161
  3. package/NOTES.md +184 -152
  4. package/README.md +237 -227
  5. package/client/index.js +894 -738
  6. package/lib/archive.d.ts +3 -1
  7. package/lib/archive.js +6 -4
  8. package/lib/compaction.js +8 -0
  9. package/lib/compactionSwap.d.ts +29 -2
  10. package/lib/compactionSwap.js +62 -7
  11. package/lib/console/homeApply.d.ts +11 -2
  12. package/lib/console/homeApply.js +36 -7
  13. package/lib/console/routes.d.ts +13 -0
  14. package/lib/console/routes.js +43 -0
  15. package/lib/console/snapshot.d.ts +8 -0
  16. package/lib/console/snapshot.js +4 -2
  17. package/lib/ecosystem/bridge/route.d.ts +7 -0
  18. package/lib/ecosystem/bridge/route.js +30 -0
  19. package/lib/ecosystem/qq/route.d.ts +2 -1
  20. package/lib/ecosystem/qq/route.js +10 -2
  21. package/lib/ecosystem/qq-native/batch.d.ts +2 -0
  22. package/lib/ecosystem/qq-native/batch.js +3 -1
  23. package/lib/ecosystem/qq-native/index.d.ts +2 -0
  24. package/lib/ecosystem/qq-native/index.js +4 -0
  25. package/lib/ecosystem/qq-native/replies.d.ts +6 -1
  26. package/lib/ecosystem/qq-native/replies.js +19 -1
  27. package/lib/ecosystem/shared/context.d.ts +1 -1
  28. package/lib/ecosystem/shared/context.js +1 -1
  29. package/lib/ecosystem/shared/identity.d.ts +12 -0
  30. package/lib/ecosystem/shared/identity.js +17 -1
  31. package/lib/ecosystem/shared/turn.d.ts +8 -5
  32. package/lib/ecosystem/shared/turn.js +16 -17
  33. package/lib/ecosystem/wechat/archive.d.ts +2 -0
  34. package/lib/ecosystem/wechat/archive.js +3 -1
  35. package/lib/ecosystem/wechat/home.js +9 -4
  36. package/lib/ecosystem/wechat/messages.d.ts +11 -0
  37. package/lib/ecosystem/wechat/messages.js +9 -1
  38. package/lib/ecosystem/wechat/sending.js +36 -9
  39. package/lib/ecosystem/wechat/supervisor.d.ts +11 -2
  40. package/lib/ecosystem/wechat/supervisor.js +90 -9
  41. package/lib/history.d.ts +6 -4
  42. package/lib/history.js +61 -12
  43. package/lib/hostContract.d.ts +1 -0
  44. package/lib/index.js +41 -14
  45. package/lib/life/activity.d.ts +2 -0
  46. package/lib/life/activity.js +1 -1
  47. package/lib/life/alarm.d.ts +12 -4
  48. package/lib/life/alarm.js +21 -6
  49. package/lib/life/diary.d.ts +6 -0
  50. package/lib/life/diary.js +23 -2
  51. package/lib/life/runtime.d.ts +1 -0
  52. package/lib/life/runtime.js +57 -9
  53. package/lib/life/toolRegistry.d.ts +4 -3
  54. package/lib/life/toolRegistry.js +13 -3
  55. package/lib/life/types.d.ts +6 -1
  56. package/lib/memory.d.ts +57 -0
  57. package/lib/memory.js +207 -0
  58. package/lib/memoryFiles.d.ts +50 -0
  59. package/lib/memoryFiles.js +168 -0
  60. package/lib/memoryStore.d.ts +112 -0
  61. package/lib/memoryStore.js +159 -0
  62. package/lib/memoryTools.d.ts +31 -0
  63. package/lib/memoryTools.js +106 -0
  64. package/lib/promptSection.d.ts +2 -0
  65. package/lib/runtime.d.ts +1 -1
  66. package/lib/runtime.js +62 -75
  67. package/lib/sourceArchive.d.ts +1 -0
  68. package/lib/sourceArchive.js +4 -5
  69. package/lib/store.d.ts +15 -1
  70. package/lib/store.js +12 -2
  71. package/lib/types.d.ts +1 -4
  72. package/lib/worldPrompt.d.ts +6 -0
  73. package/lib/worldPrompt.js +8 -2
  74. package/lib/worldSwitch.d.ts +9 -1
  75. package/lib/worldSwitch.js +14 -1
  76. package/package.json +128 -117
  77. package/scripts/compact-home.mjs +29 -0
  78. package/scripts/update-world.mjs +6 -4
  79. package/src/ecosystem/wechat/windows/README.md +7 -5
  80. package/src/ecosystem/wechat/windows/adapter.py +86 -31
  81. package/src/ecosystem/wechat/windows/engine/NOTICE.md +1 -1
  82. package/src/ecosystem/wechat/windows/engine/bridge.cpp +9 -1
  83. package/src/ecosystem/wechat/windows/engine/build.ps1 +8 -2
  84. package/src/ecosystem/wechat/windows/engine/profiles.json +56 -0
  85. package/src/ecosystem/wechat/windows/native.py +4 -1
  86. package/src/ecosystem/wechat/windows/outgoing.py +21 -0
  87. package/src/ecosystem/wechat/windows/sender.py +26 -6
  88. package/templates/alarm.md +3 -4
  89. package/templates/world-prompt-memory.md +10 -0
  90. package/templates/world-prompt.md +7 -2
package/NOTES.md CHANGED
@@ -1,152 +1,184 @@
1
- # 注意事项
2
-
3
- 容易踩的地方集中写在这里,按主题分类。功能介绍见 [README](README.md),安装步骤见 [INSTALL](INSTALL.md),每个版本改了什么见 [更新日志](CHANGELOG.md)。
4
-
5
- - [默认就会发生的事](#默认就会发生的事)
6
- - [安装与升级](#安装与升级)
7
- - [人设与提示词](#人设与提示词)
8
- - [压缩与记忆](#压缩与记忆)
9
- - [世界范围与会话](#世界范围与会话)
10
- - [微信](#微信)
11
- - [QQ](#qq)
12
-
13
- ## 默认就会发生的事
14
-
15
- 装上、升级之后不用你做什么,下面这些就会发生:
16
-
17
- - **首次启动时,profile 的压缩会被换成 dsh-world 自带的“只留对话”压缩**(先备份,重启 DSH 后生效)。整个 profile 的会话都会受影响。不想换,写 `replaceCompaction: false`。详情:[默认换用只留对话的压缩](#默认换用只留对话的压缩)。
18
- - **自动压缩在上下文窗口的 75% 触发**,没声明窗口的模型按 1M 估算。详情:[自动压缩什么时候触发](#自动压缩什么时候触发)。
19
- - **每晚 23:00 的回顾之后,家会话会自动压缩一次**,让她改写的“我是谁”生效;每晚多一次摘要调用,控制台可关。详情:[每日回顾后自动压缩](#每日回顾后自动压缩)。
20
- - **在控制台写了人设,它会取代 DSH 自带的那句默认身份**;你已经在 DSH 里设好的系统人设原样保留。详情:[人设和 DSH 自带的系统提示词](#人设和-dsh-自带的系统提示词)。
21
- - **微信和 QQ 默认都是关的**,要用先在配置里启用,再到控制台「概览 → 接入」拨开(已经在用微信的世界升级后保持开着)。微信群里被 @ 时默认带前 5 条消息作上下文,控制台微信页可调 1–20。详情:[微信的开关](#微信的开关)、[QQ 的开关](#qq-的开关)。
22
-
23
- ## 安装与升级
24
-
25
- ### 默认换用只留对话的压缩
26
-
27
- 默认自动换上。装好 `dsh-world` 后第一次启动,插件会把你 profile 的 `cordis.patch.yml` 里原版压缩那一行换成 `dsh-world/compaction`,先在同目录留一份 `.dsh-world.<随机>.bak` 备份,重启 DSH 后生效,世界面板的健康状态里会提示这件事。只有找到唯一一条原版压缩配置时才会改;已经换过、写法对不上或有多条时什么都不动。每个世界只试这一次:之后你手动改回原版,它不会再替你换。不想换,在 `dsh-world` 的配置里写 `replaceCompaction: false`。手动启用或恢复也可以用下面的脚本:
28
-
29
- ```powershell
30
- powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\enable-tool-free-compaction.ps1 -profilePath '<你的 DSH profile 目录>'
31
- ```
32
-
33
- 脚本做的是同一件事:把原版压缩条目换成 `dsh-world/compaction` 并留备份。它对整个 profile 生效,不限世界工作区,见 [对世界工作区以外的影响](#对世界工作区以外的影响)。
34
-
35
- ### 微信首次接入与升级
36
-
37
- 开启插件的微信开关本身不会启动 Windows 适配器;可手动启动,或在配置里写 `wechatAdapter` 让插件随微信模块启动和停止它(见适配器 README)。无论哪种,都需要配套适配器并完成账号及聊天目标注册后,微信工具才可使用。这套原生桥不依赖 `dsh-plugin-weixin` 或 iLink。升级插件和适配器后,两者均需重启,不能让旧适配器进程继续运行新版协议;保留原配置、游标和回执。
38
-
39
- ## 人设与提示词
40
-
41
- ### 修改人设和世界提示词后要手动应用
42
-
43
- **修改人设、世界提示词后,需要手动热加载,才能让已有家会话及时用上新内容。** 先保存修改,再到「人设」或「世界提示词」页点击 **「应用并压缩家会话」**。仅保存或重新打开控制台,不会立即刷新家会话。
44
-
45
- 任务会等家空闲后执行一次,不打断当前对话;完成后的下一轮使用已保存的人设、名字、世界提示词和「我是谁」。压缩会调用模型并重建上下文缓存,没有可压缩内容时只刷新配置。面板显示执行结果或失败原因,停止世界会取消任务。
46
-
47
- 这个按钮只作用于家会话;其他已有会话在各自下一次成功压缩或重新加载时更新,新建会话直接读取已保存内容。
48
-
49
- ### 人设和 DSH 自带的系统提示词
50
-
51
- 在控制台「人设」页写了内容以后:
52
-
53
- - 它取代 DSH 自带的那句默认身份(“You are an AI agent powered by DeepSeek Harness.”),作为单独一段放进系统提示词。
54
- - 你在 DSH 里已经设好的系统人设(宿主设置里的人设前缀,或当前预设自带的人设)**不会被替换**,原样保留在最前面,控制台写的排在它后面。预设如果已经自己改写了那句默认身份,也按它写的保留;你在 DSH 里关掉了默认身份、自己写开头,同样不动。
55
- - 控制台「人设」全部留空时,什么都不改,沿用 DSH 的默认身份和你已有的人设。
56
- - DSH 其余的系统提示(计划、工具、文件引用等说明)不动。
57
- - 如果同一份人设在 DSH 里和控制台里各写了一遍,两份都会进提示词,内容会重复;只想要一份,清掉其中一处。
58
- - 范围是所有匹配该世界预设的普通会话,不限工作区;改动对已有会话在下次压缩或「应用并压缩家会话」后生效,新会话直接使用。
59
-
60
- ## 压缩与记忆
61
-
62
- ### 自动压缩什么时候触发
63
-
64
- 适用于 dsh-world 自带的压缩,默认会换上。每一步发请求之前检查一次,会话用量超过上下文窗口的 **75%** 就先压缩。窗口是 1M 时约 786,432。比例可以在压缩那一行的 `config` 里用 `thresholdRatio` 调整。
65
-
66
- - 只有当单次回复上限(`maxTokens`,由 DSH 给模型的请求带上,不是本插件设的)大到“提示加回复装不下”时,才会比 75% 更早触发;不再额外扣固定的余量。
67
- - 窗口值取自模型适配器声明的 `contextWindow`。适配器没有声明的模型(自己加的通道常见),按 `defaultContextWindow`(默认 1,048,576,即 1M)估算,并在日志里警告一次。如果它真实的窗口更小,请在适配器模型上配置 `contextWindow`,或在 `modelPolicies` 里给这个模型写 `defaultContextWindow`。
68
- - 估大了不会卡死:请求被模型以“超出上下文窗口”拒绝时,会整段压缩后自动重试一次,但每次会白挨一次被拒绝的请求。
69
- - 如果你没有换用本插件的压缩(`replaceCompaction: false`),触发规则以 DSH 原版压缩为准,上面这些不适用。
70
-
71
- ### 每日回顾后自动压缩
72
-
73
- 默认开,可在控制台概览的「回顾后自动压缩」关掉。每晚 23:00 的回顾里她会改写「我是谁」,而系统提示只在压缩之后才重新读取,不压缩的话新版要等到下一次压缩才生效,可能隔好几天。所以回顾那一轮结束、家空闲后,插件会自动执行一次[「应用并压缩家会话」](#修改人设和世界提示词后要手动应用):新版「我是谁」随压缩一起生效,压缩后最近的聊天原文会作为记忆块重新放回她眼前,衔接是接得上的。压缩本来就要重建缓存,这样不会多破坏一次,但每晚会多一次摘要调用。只在回顾真的送到她那里之后才触发,闹钟和问候不会;只作用于家会话,人设和世界提示词的修改仍然需要手动应用。
74
-
75
- ## 世界范围与会话
76
-
77
- ### 对世界工作区以外的影响
78
-
79
- 只有下面这两项会作用到世界工作区以外的会话:
80
-
81
- 1. **人设**:控制台人设作为单独一段,取代 DSH 自带的默认身份句、排在宿主系统人设之后,所有匹配该世界预设的普通会话都会带上,不限工作区。
82
- 2. **只留对话的压缩**(装上插件后首次启动默认换上,可在配置里写 `replaceCompaction: false` 关掉):它替换的是整个 profile 的压缩方式,其他工作区的会话压缩时也会去掉工具调用过程,只留一段对话摘要。写代码等依赖工具过程的会话,压缩后会丢掉这些细节。
83
-
84
- 除此之外,记忆、世界提示词、世界线、工具、通道和归档都不会进入工作区以外的会话。
85
-
86
- ### 看到“会话已离开世界工作区,请重新发送”
87
-
88
- 这是插件在请求发出前的最后一道检查,会话不在世界工作区里、却还带着世界上下文时就拦住它,并顺手把残留的世界记忆块清掉,所以重新发送通常就能通过。每次拦截,DSH 日志里都有一条 `dsh-world: 阻止了会话 …` 的警告,写明原因(请求里还带着几条世界记忆块、世界提示还挂在会话上)、会话 ID 和预设,以及清理之后会话表面上还剩哪些记忆节点(位置和事件类型)。日志里不会出现任何消息文字。如果重新发送后仍然被拦,请把这条日志发给作者。
89
-
90
- ## 微信
91
-
92
- ### 微信的开关
93
-
94
- 默认关。要用微信,先在配置里写 `wechat: true`,再到控制台「概览 → 接入」把微信拨开:开着就立即注册 `wechat_chats`、`wechat_history`、`wechat_image`、`wechat_send`、`wechat_delivery` 和 `sticker_*` 这些工具,并拉起适配器(配了 `wechatAdapter` 时);关掉就撤掉工具、停止适配器。没在配置里启用的模块不能从控制台打开。已经在用微信的世界(它的微信模块以前跑过)升级后保持开着,不会被悄悄关掉。
95
-
96
- ### 微信支持版本
97
-
98
- 目前仅适配 **Windows x64 微信 `4.1.15.13`、`4.1.15.56` 的指定构建**。适配器会核对 `Weixin.dll` 的文件大小和 SHA256;其他构建(包括版本号相同但文件指纹不同的构建)会在加载原生桥前被拒绝。macOS、Linux 客户端暂不支持。升级微信前请确认新构建已有适配;各版本的实测范围见 [微信模块](src/ecosystem/wechat/windows/README.md)。
99
-
100
- ### 微信风控与账号风险
101
-
102
- 当前桥不是微信官方 API,接收端解密读取本地消息数据库,发送端向微信进程加载 DLL 并调用内部函数,存在账号功能受限或封禁风险。微信安全中心 [2026 年 1 月 29 日公告(媒体转载)](https://www.thepaper.cn/newsDetail_forward_32493057) 将违规获取聊天记录、联系人数据,以及通过模拟按键、自动化脚本操控微信等列为治理内容。仅用于家庭群、低频聊天,或改用 Computer Use,都不能保证账号安全;公开资料没有可靠的封号概率或安全发送阈值。
103
-
104
- ### 微信退出重开
105
-
106
- 保持适配器运行,退出微信后它会暂停收发并等待;她原来的账号重新登录后,会自动重新绑定进程并沿用消息游标恢复监听,无需重启 DSH。若退出发生在消息处理或发送途中,且结果尚未确认,则停止并保留待核对记录,不会自动重复回复;按微信模块中的 `Acknowledge` 流程核对后恢复。
107
-
108
- ### 微信图片接收
109
-
110
- 私聊普通图片会先缓冲最多 3 秒,合并紧随的同一发言人的一条说明文字后进入模型,每轮最多两张图,更多图片留到后续轮次。开始处理后才到达的文字排到下一轮,继续使用同一会话已有的图片上下文。群聊里被真实 @ 时最近两张图会直接给她;平时翻群消息时图片先显示为未读取,她想看哪张就用 `wechat_image` 取(一次一张,图片还没下载到这台电脑时会明确报错)。图片及附件引用只进入对应会话总日志,不自动写入共享记忆块;合并的真实文字按原归档范围保存,是否另行留存图片中的信息由她自己判断。缓存不可用时明确标记未读取,不操作界面下载。
111
-
112
- ### 微信表情包接收
113
-
114
- 私聊里你发来的原生表情包会按消息中的地址从腾讯 CDN 下载,md5 与消息一致才接受,并取第一帧作为图片交给她;这是适配器主动联网的功能,可在适配器配置里写 `"fetchStickers": false` 关闭,读取失败时她会看到明确的“未读取”原因。动图只取第一帧;群聊里的表情包目前不会交给她,群里发表情包后再 @ 她,她只能收到触发文字和其他已支持的上下文。原生表情包也不会进入插件的记忆归档。
115
-
116
- ### 微信表情库
117
-
118
- 她的表情库由本插件自己维护,放在世界目录的 `stickers/` 下,每张只有名称和标签。`sticker_search` 按关键词找(一次最多几张,不倾倒整个库,也不回传图片),`sticker_save` 把聊天里别人发来的表情包收进来(保留原始动图,同一张不重复收),`sticker_edit`、`sticker_remove` 管理;发送用 `wechat_send`。不再需要 DeepSeek-meme 插件和 `stickerDir` 配置,旧库用 `scripts/import-stickers.mjs` 导入一次即可,说明见 [微信模块](src/ecosystem/wechat/windows/README.md#表情库)。QQ 仍用自己的收藏表情。
119
-
120
- ### 微信里的 @
121
-
122
- 她发出的文字里写 `@昵称` 只是普通文字,不会真的 @ 到人,被提到的人也收不到提醒。原生发送没有 @ 列表,靠操作窗口输入 @ 又会抢占焦点、与“后台发送、不操作窗口”的设计冲突,所以不做;需要点名时她会在文字里写清对方的称呼。
123
-
124
- ### 视频号与朋友圈(预留)
125
-
126
- 目前聊天中分享的视频号卡片会被跳过,不进入她的会话或共享记忆;收到卡片后没有回复,不代表微信监听掉线。视频号需要另行接入卡片解析和视频内容读取。朋友圈的浏览、发布也需要独立的操作能力,现有私聊/群聊发送接口不能发布朋友圈。这些能力暂只记录为微信模块的后续扩展,尚未实现。
127
-
128
- ## QQ
129
-
130
- ### QQ 模块仍需要外部的 SnowLuma
131
-
132
- QQ 模块是插件自己连 OneBot,但登录 QQ、对外提供 OneBot 服务的是外部的 **SnowLuma**,需要你另行安装,插件不会替你安装它(看门狗只会把已装好的 SnowLuma 拉起来)。SnowLuma 按它自己的 EULA 不许被自动化脚本部署,装法与参数怎么拿见 [INSTALL.md](INSTALL.md)。除了 SnowLuma 本体,还需要它的 SDK,见下一条。没装 SnowLuma 时 QQ 通道连不上,不影响微信和其他功能。
133
-
134
- ### 额外依赖 SnowLuma SDK(`@snowluma/sdk`)
135
-
136
- 首次手动开启 QQ 时,缺少 SDK 就调用宿主包管理器装到当前 DSH profile,禁用安装脚本,不修补 SDK 文件;安装完成后提示重启 DSH,再按保存的开关启用 QQ。安装失败会显示原因,运行环境要求以 SDK 自身说明为准,不自动升级 Node。不使用 QQ 时无需 SDK,不影响其他功能;也可自行安装兼容版本,见 [安装说明](INSTALL.md#第一步把-dsh-world-装进-profile)。
137
-
138
- ### QQ 的开关
139
-
140
- 默认关。要用 QQ,先在配置里写 `qqNative.enabled: true`,再到控制台「概览 → 接入」把 QQ 拨开:开着才加载通道,关掉就断开连接。没在配置里启用的模块不能从控制台打开。首次手动开启时缺少 SDK 会按需安装,见上一条。
141
-
142
- ### QQ 的记忆
143
-
144
- QQ 消息由插件自己那条原生通道送进家里,插件没有为它做微信那样的渠道身份。按 `bindHomeSession`(默认 `owner`),主人的私聊用她的家会话,因此按普通家会话归档;每个群各挂一个独立会话(标题形如 `QQ · <群名>`),挂在她的房间工作区下、用同一个 `agentPreset`——所以在默认的 `archiveScope: workspace` 下,**群里的对话和微信群一样会进归档、进记忆块**,归档里只有会话、没有渠道标记。写 `none` 时私聊也另建一个这样的独立会话。群里的消息默认只有被叫到才接话,其余只进本轮上下文、不开口也不花额度。
145
-
146
- ### 群里默认只接被叫到的
147
-
148
- 对应 `groupTrigger: mention`:被 @、引用她刚说过的话、或文本命中 `groupKeywords` 才算叫她,其余消息只进本轮上下文,不开口也不花额度;写 `all` 就是每句都接,代价是群里每一条都会让她跑完一轮。`@全体` 是群公告,不算叫她。`bindHomeSession` 决定谁和她的家会话共用一个入口,默认 `owner`。
149
-
150
- ### 看门狗
151
-
152
- 对应 `supervise`,默认开。QQ 开着时每 30 秒探一次 `wsUrl` 的端口,不通就按 `snowlumaHome` 把 SnowLuma 拉起来(本机有 `SnowLuma-watchdog` 计划任务时借它跑,能活过 DSH 重启;没有就直接起进程,只活到 DSH 退出)。拉不起来的原因写在卡上。不想让插件动手就设成 `false`,卡上的「拉起 SnowLuma」按钮照旧能用。
1
+ # 注意事项
2
+
3
+ 容易踩的地方集中写在这里,按主题分类。功能介绍见 [README](README.md),安装步骤见 [INSTALL](INSTALL.md),每个版本改了什么见 [更新日志](CHANGELOG.md)。
4
+
5
+ - [默认就会发生的事](#默认就会发生的事)
6
+ - [安装与升级](#安装与升级)
7
+ - [人设与提示词](#人设与提示词)
8
+ - [压缩与记忆](#压缩与记忆)
9
+ - [世界范围与会话](#世界范围与会话)
10
+ - [微信](#微信)
11
+ - [QQ](#qq)
12
+
13
+ ## 默认就会发生的事
14
+
15
+ 装上、升级之后不用你做什么,下面这些就会发生:
16
+
17
+ - **首次启动时,profile 的压缩会被换成 dsh-world 自带的“只留对话”压缩**(先备份,重启 DSH 后生效)。整个 profile 的会话都会受影响。不想换,写 `replaceCompaction: false`。DSH 桌面版上会把世界所用的预设整份写进 profile 再换。详情:[默认换用只留对话的压缩](#默认换用只留对话的压缩)。
18
+ - **自动压缩在上下文窗口的 75% 触发**,没声明窗口的模型按 1M 估算。详情:[自动压缩什么时候触发](#自动压缩什么时候触发)。
19
+ - **每晚回顾(默认 23:00)之后,家会话会自动压缩一次**,让她改写的“我是谁”生效;每晚多一次摘要调用,控制台可关。详情:[每日回顾后自动压缩](#每日回顾后自动压缩)。
20
+ - **过去的日记她改不了**:只能写今天的;写错了,在今天的日记里纠正。详情:[过去的日记只读](#过去的日记只读)。
21
+ - **在控制台写了人设,它会取代 DSH 自带的那句默认身份**;你已经在 DSH 里设好的系统人设原样保留。详情:[人设和 DSH 自带的系统提示词](#人设和-dsh-自带的系统提示词)。
22
+ - **微信和 QQ 默认都是关的**,要用先在配置里启用,再到控制台「概览 → 接入」拨开(已经在用微信的世界升级后保持开着)。微信群里被 @ 时默认带前 5 条消息作上下文,控制台微信页可调 1–20。详情:[微信的开关](#微信的开关)、[QQ 的开关](#qq-的开关)。
23
+
24
+ ## 安装与升级
25
+
26
+ ### 默认换用只留对话的压缩
27
+
28
+ 默认自动换上。装好 `dsh-world` 后第一次启动,插件会把你 profile 的 `cordis.patch.yml` 里原版压缩那一行换成 `dsh-world/compaction`,先在同目录留一份 `.dsh-world.<随机>.bak` 备份,重启 DSH 后生效,世界面板的健康状态里会提示这件事。只有找到唯一一条原版压缩配置时才会改;已经换过、写法对不上或有多条时什么都不动。每个世界只试这一次:之后你手动改回原版,它不会再替你换。不想换,在 `dsh-world` 的配置里写 `replaceCompaction: false`。手动启用或恢复也可以用下面的脚本:
29
+
30
+ ```powershell
31
+ powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\enable-tool-free-compaction.ps1 -profilePath '<你的 DSH profile 目录>'
32
+ ```
33
+
34
+ 脚本做的是同一件事:把原版压缩条目换成 `dsh-world/compaction` 并留备份。它对整个 profile 生效,不限世界工作区,见 [对世界工作区以外的影响](#对世界工作区以外的影响)。
35
+
36
+ **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 里本来就有整份预设,走的是上面的直接替换。
37
+
38
+ 整份写进 profile 的代价:之后 DSH 升级对这个预设的改动(新工具、提示词调整)不会自动进来,因为 profile 里这份会盖住 DSH 自带的。想跟上新版,恢复备份(或删掉 profile 里 `preset-standard` 那一项),再把 `world.json` 里的 `compactionSwapped` 删掉,下次启动会按新版预设重新换一次。只影响这个预设:其他预设的会话仍用原版压缩。
39
+
40
+ 换不成时(找不到预设、预设里没有或有多条原版压缩),插件不改任何文件,在健康状态里说明:自动压缩仍由预设自带的压缩负责,下面的 75% 触发线不生效。控制台的「应用并压缩」和回顾后压缩不受影响,它们直接使用家会话预设里的那个压缩。
41
+
42
+ ### 微信首次接入与升级
43
+
44
+ 开启插件的微信开关本身不会启动 Windows 适配器;可手动启动,或在配置里写 `wechatAdapter` 让插件随微信模块启动和停止它(见适配器 README)。无论哪种,都需要配套适配器并完成账号及聊天目标注册后,微信工具才可使用。这套原生桥不依赖 `dsh-plugin-weixin` 或 iLink。升级插件和适配器后,两者均需重启,不能让旧适配器进程继续运行新版协议;保留原配置、游标和回执。
45
+
46
+ 升级改动了原生桥源码时,由插件管理的适配器(配了 `wechatAdapter`)会自己重新构建一次:用插件自带的 `engine/build.ps1` 编到适配器 `config.json` 旁边的 `engine` 目录,编好再启动,控制台微信页这时显示「正在重新构建原生桥」;编好后旧的构建目录会删掉(微信正占用着的留到下次)。需要的还是第一次部署时用过的 Visual Studio C++ x64 构建工具。没有这套工具或编译失败时,适配器停下不再重试,原因写进控制台的健康,按提示在仓库里运行 `wechat.ps1 Build`,再在控制台重启适配器。自己手动运行的适配器不会自动构建,升级后照旧手动 Build。适配器因为别的原因退出时,控制台也会显示它退出前说的最后一句话。
47
+
48
+ ## 人设与提示词
49
+
50
+ ### 修改人设和世界提示词后要手动应用
51
+
52
+ **修改人设、世界提示词后,需要手动热加载,才能让已有家会话及时用上新内容。** 先保存修改,再到「人设」或「世界提示词」页点击 **「应用并压缩家会话」**。仅保存或重新打开控制台,不会立即刷新家会话。
53
+
54
+ 任务会等家空闲后执行一次,不打断当前对话;完成后的下一轮使用已保存的人设、名字、世界提示词和「我是谁」。压缩会调用模型并重建上下文缓存,没有可压缩内容时只刷新配置。面板显示执行结果或失败原因,停止世界会取消任务。
55
+
56
+ 这个按钮只作用于家会话;其他已有会话在各自下一次成功压缩或重新加载时更新,新建会话直接读取已保存内容。
57
+
58
+ ### 你自己的世界提示词不会被自动改
59
+
60
+ 升级带来了新的提示词段落(找回过去),但**不会改动你已有的 `world-prompt.md`**:工具照常生效,只是她在提示里读不到它们的来历。控制台的「世界提示词」页会列出你的模板没用到的变量,并给出可以直接贴进去的一段(也在 `templates/world-prompt-memory.md`)。
61
+
62
+ ### 人设和 DSH 自带的系统提示词
63
+
64
+ 在控制台「人设」页写了内容以后:
65
+
66
+ - 它取代 DSH 自带的那句默认身份(“You are an AI agent powered by DeepSeek Harness.”),作为单独一段放进系统提示词。
67
+ - 你在 DSH 里已经设好的系统人设(宿主设置里的人设前缀,或当前预设自带的人设)**不会被替换**,原样保留在最前面,控制台写的排在它后面。预设如果已经自己改写了那句默认身份,也按它写的保留;你在 DSH 里关掉了默认身份、自己写开头,同样不动。
68
+ - 控制台「人设」全部留空时,什么都不改,沿用 DSH 的默认身份和你已有的人设。
69
+ - DSH 其余的系统提示(计划、工具、文件引用等说明)不动。
70
+ - 如果同一份人设在 DSH 里和控制台里各写了一遍,两份都会进提示词,内容会重复;只想要一份,清掉其中一处。
71
+ - 范围是所有匹配该世界预设的普通会话,不限工作区;改动对已有会话在下次压缩或「应用并压缩家会话」后生效,新会话直接使用。
72
+
73
+ ## 压缩与记忆
74
+
75
+ ### 自动压缩什么时候触发
76
+
77
+ 适用于 dsh-world 自带的压缩,默认会换上。每一步发请求之前检查一次,会话用量超过上下文窗口的 **75%** 就先压缩。窗口是 1M 时约 786,432。比例可以在压缩那一行的 `config` 里用 `thresholdRatio` 调整。
78
+
79
+ - 只有当单次回复上限(`maxTokens`,由 DSH 给模型的请求带上,不是本插件设的)大到“提示加回复装不下”时,才会比 75% 更早触发;不再额外扣固定的余量。
80
+ - 窗口值取自模型适配器声明的 `contextWindow`。适配器没有声明的模型(自己加的通道常见),按 `defaultContextWindow`(默认 1,048,576,即 1M)估算,并在日志里警告一次。如果它真实的窗口更小,请在适配器模型上配置 `contextWindow`,或在 `modelPolicies` 里给这个模型写 `defaultContextWindow`。
81
+ - 估大了不会卡死:请求被模型以“超出上下文窗口”拒绝时,会整段压缩后自动重试一次,但每次会白挨一次被拒绝的请求。
82
+ - 如果你没有换用本插件的压缩(`replaceCompaction: false`,或在桌面版上[没换成](#默认换用只留对话的压缩)),触发规则以 DSH 原版压缩为准,上面这些不适用。
83
+
84
+ ### 每日回顾后自动压缩
85
+
86
+ 默认开,可在控制台概览的「回顾后自动压缩」关掉。每晚的回顾里她会改写「我是谁」,而系统提示只在压缩之后才重新读取,不压缩的话新版要等到下一次压缩才生效,可能隔好几天。所以回顾那一轮结束、家空闲后,插件会自动执行一次[「应用并压缩家会话」](#修改人设和世界提示词后要手动应用):新版「我是谁」随压缩一起生效,压缩后最近的聊天原文会作为记忆块重新放回她眼前,衔接是接得上的。压缩本来就要重建缓存,这样不会多破坏一次,但每晚会多一次摘要调用。只在回顾真的送到她那里之后才触发,闹钟和问候不会;只作用于家会话,人设和世界提示词的修改仍然需要手动应用。没压成时(比如找不到压缩服务、摘要请求被模型拒绝),原因连同底层报错一起留在健康状态里,下一次压缩成功后消失。
87
+
88
+ ### 主动触发一次压缩的脚本
89
+
90
+ 回顾后的压缩失败或没有触发时,可以手动补一次:开启配置里的 `bridge`(需要重启 DSH 生效),然后运行 `node scripts/compact-home.mjs`(世界目录不止一个时把路径作为参数)。脚本读取世界目录里的 `bridge.json`,向本机请求压缩家会话;她正在忙的话会等这一轮结束后再压缩,和控制台的「应用并压缩」是同一条路径。也可以用系统的计划任务在每晚回顾之后定时运行它。失败原因会写进健康状态和 DSH 日志(以 `dsh-world: 应用并压缩失败` 开头)。
91
+
92
+ ### 长期记忆的查找
93
+
94
+ - **没有索引,也就没有升级时的建库**:聊天在 `archive.sqlite` 的原表里直接按字面扫描,日记等文件在查询时直接读,没有额外的表、队列或重建,旧档案升级后第一次查询就能用。扫描随聊天量线性变慢:我们量过合成数据,约 10 万条 50 毫秒、50 万条 300 毫秒以内,陪伴场景远用不到这个量级。
95
+ - **查找的范围**:聊天和日记(`diaryDir` 里的 `.md`/`.txt`,一层)。自述不进查找,仍然全文放进提示。文件只有当前内容,旧版本不保存。
96
+ - **查找的限制**:查询只认字面文字(区分大小写);没有共同文字、时间线索的往事找不回来;有来源读不到时结果里会带 `coverage`,零结果不代表没发生过;分页只限制返回的量,不限制扫描的量。
97
+ - **一次返回的量是故意压小的**:`memory_find` 默认 8 条、每条摘录约 200 字,`memory_read` 默认 2000 字,因为工具结果会在这一轮之后的每一步被重发。要更多就翻页(`nextCursor`)或读原文,不要一次要几十条。
98
+
99
+ ### 过去的日记只读
100
+
101
+ 日记目录里按日期命名的 `YYYY-MM-DD.md`,她只能用 `write`、`edit` 改还没合上的那几天:今天,以及回顾还没做完的那天(回顾定在中午以前、或者回顾晚到第二天时,前一天的日记会一直开到那一轮回顾结束)。改已经合上的日子,工具会被拒绝,并告诉她在今天的日记里写下哪里记错了、现在怎么看。读日记不受影响;日记目录里不按日期命名的文件、子目录里的文件不管。这条只拦她的文件工具:`pwsh` 等命令行能写任何文件,没法可靠地分辨,所以不拦。你自己在编辑器里改日记不受影响。
102
+
103
+ ### 归档或记忆出错时她照常说话
104
+
105
+ 归档写不进去(比如磁盘满、数据库被占用)、某个会话的日志一时读不出来,或者记忆块建不出来时,她照常回话,问题显示在控制台的「健康」里。这期间说的话不会丢:它们在宿主的会话日志里,插件记着每个会话归档到了哪里,问题解决后,这个会话下一次有动静或 DSH 下次启动时,会从断点补进归档,不会重复。记忆块建不出来时,她眼前还是上一块(刚压缩完就没有),下一步会再试。补不回来的只有一种:宿主的会话日志在磁盘上坏了、一直读不出来,那个会话里的话就进不了归档,健康里会一直显示它。
106
+
107
+ ## 世界范围与会话
108
+
109
+ ### 对世界工作区以外的影响
110
+
111
+ 只有下面这两项会作用到世界工作区以外的会话:
112
+
113
+ 1. **人设**:控制台人设作为单独一段,取代 DSH 自带的默认身份句、排在宿主系统人设之后,所有匹配该世界预设的普通会话都会带上,不限工作区。
114
+ 2. **只留对话的压缩**(装上插件后首次启动默认换上,可在配置里写 `replaceCompaction: false` 关掉):它替换的是整个 profile 的压缩方式,其他工作区的会话压缩时也会去掉工具调用过程,只留一段对话摘要。写代码等依赖工具过程的会话,压缩后会丢掉这些细节。
115
+
116
+ 除此之外,记忆、世界提示词、世界线、工具、通道和归档都不会进入工作区以外的会话。
117
+
118
+ ### 看到“会话已离开世界工作区,请重新发送”
119
+
120
+ 这是插件在请求发出前的最后一道检查,会话不在世界工作区里、却还带着世界上下文时就拦住它,并顺手把残留的世界记忆块清掉,所以重新发送通常就能通过。每次拦截,DSH 日志里都有一条 `dsh-world: 阻止了会话 …` 的警告,写明原因(请求里还带着几条世界记忆块、世界提示还挂在会话上)、会话 ID 和预设,以及清理之后会话表面上还剩哪些记忆节点(位置和事件类型)。日志里不会出现任何消息文字。如果重新发送后仍然被拦,请把这条日志发给作者。
121
+
122
+ ## 微信
123
+
124
+ ### 微信的开关
125
+
126
+ 默认关。要用微信,先在配置里写 `wechat: true`,再到控制台「概览 → 接入」把微信拨开:开着就立即注册 `wechat_chats`、`wechat_history`、`wechat_image`、`wechat_send`、`wechat_delivery` 和 `sticker_*` 这些工具,并拉起适配器(配了 `wechatAdapter` 时);关掉就撤掉工具、停止适配器。没在配置里启用的模块不能从控制台打开。已经在用微信的世界(它的微信模块以前跑过)升级后保持开着,不会被悄悄关掉。
127
+
128
+ ### 微信支持版本
129
+
130
+ 目前仅适配 **Windows x64 微信 `4.1.15.13`、`4.1.15.56` 的指定构建**。适配器会核对 `Weixin.dll` 的文件大小和 SHA256;其他构建(包括版本号相同但文件指纹不同的构建)会在加载原生桥前被拒绝。macOS、Linux 客户端暂不支持。升级微信前请确认新构建已有适配;各版本的实测范围见 [微信模块](src/ecosystem/wechat/windows/README.md)。
131
+
132
+ ### 微信风控与账号风险
133
+
134
+ 当前桥不是微信官方 API,接收端解密读取本地消息数据库,发送端向微信进程加载 DLL 并调用内部函数,存在账号功能受限或封禁风险。微信安全中心 [2026 年 1 月 29 日公告(媒体转载)](https://www.thepaper.cn/newsDetail_forward_32493057) 将违规获取聊天记录、联系人数据,以及通过模拟按键、自动化脚本操控微信等列为治理内容。仅用于家庭群、低频聊天,或改用 Computer Use,都不能保证账号安全;公开资料没有可靠的封号概率或安全发送阈值。
135
+
136
+ ### 微信退出重开
137
+
138
+ 保持适配器运行,退出微信后它会暂停收发并等待;她原来的账号重新登录后,会自动重新绑定进程并沿用消息游标恢复监听,无需重启 DSH。若退出发生在消息处理或发送途中,且结果尚未确认,则停止并保留待核对记录,不会自动重复回复;按微信模块中的 `Acknowledge` 流程核对后恢复。
139
+
140
+ ### 微信图片接收
141
+
142
+ 收到消息后会先缓冲 3 秒(控制台微信页可调):同一个人在这段时间里又发来文字或图片,就重新计时,等对方安静下来,把这几条合成一条交给她,最长等 30 秒、最多 16 条、合起来不超过 2000 字。别人插话、引用或表情包会让这一批立刻结束。私聊每轮最多两张图,更多图片留到后续轮次;群聊只有叫到她的那条会等,后面同一个人补的话一起交给她。开始处理后才到达的消息排到下一轮,继续使用同一会话已有的图片上下文。群聊里被真实 @ 时最近两张图会直接给她;平时翻群消息时图片先显示为未读取,她想看哪张就用 `wechat_image` 取(一次一张,图片还没下载到这台电脑时会明确报错)。图片及附件引用只进入对应会话总日志,不自动写入共享记忆块;合并的真实文字按原归档范围保存,是否另行留存图片中的信息由她自己判断。缓存不可用时明确标记未读取,不操作界面下载。
143
+
144
+ ### 微信表情包接收
145
+
146
+ 私聊里你发来的原生表情包会按消息中的地址从腾讯 CDN 下载,md5 与消息一致才接受,并取第一帧作为图片交给她;这是适配器主动联网的功能,可在适配器配置里写 `"fetchStickers": false` 关闭,读取失败时她会看到明确的“未读取”原因。动图只取第一帧;群聊里的表情包目前不会交给她,群里发表情包后再 @ 她,她只能收到触发文字和其他已支持的上下文。原生表情包也不会进入插件的记忆归档。
147
+
148
+ ### 微信表情库
149
+
150
+ 她的表情库由本插件自己维护,放在世界目录的 `stickers/` 下,每张只有名称和标签。`sticker_search` 按关键词找(一次最多几张,不倾倒整个库,也不回传图片),`sticker_save` 把聊天里别人发来的表情包收进来(保留原始动图,同一张不重复收),`sticker_edit`、`sticker_remove` 管理;发送用 `wechat_send`。不再需要 DeepSeek-meme 插件和 `stickerDir` 配置,旧库用 `scripts/import-stickers.mjs` 导入一次即可,说明见 [微信模块](src/ecosystem/wechat/windows/README.md#表情库)。QQ 仍用自己的收藏表情。
151
+
152
+ ### 微信里的 @
153
+
154
+ 她发出的文字里写 `@昵称` 只是普通文字,不会真的 @ 到人,被提到的人也收不到提醒。原生发送没有 @ 列表,靠操作窗口输入 @ 又会抢占焦点、与“后台发送、不操作窗口”的设计冲突,所以不做;需要点名时她会在文字里写清对方的称呼。
155
+
156
+ ### 视频号与朋友圈(预留)
157
+
158
+ 目前聊天中分享的视频号卡片会被跳过,不进入她的会话或共享记忆;收到卡片后没有回复,不代表微信监听掉线。视频号需要另行接入卡片解析和视频内容读取。朋友圈的浏览、发布也需要独立的操作能力,现有私聊/群聊发送接口不能发布朋友圈。这些能力暂只记录为微信模块的后续扩展,尚未实现。
159
+
160
+ ## QQ
161
+
162
+ ### QQ 模块仍需要外部的 SnowLuma
163
+
164
+ QQ 模块是插件自己连 OneBot,但登录 QQ、对外提供 OneBot 服务的是外部的 **SnowLuma**,需要你另行安装,插件不会替你安装它(看门狗只会把已装好的 SnowLuma 拉起来)。SnowLuma 按它自己的 EULA 不许被自动化脚本部署,装法与参数怎么拿见 [INSTALL.md](INSTALL.md)。除了 SnowLuma 本体,还需要它的 SDK,见下一条。没装 SnowLuma 时 QQ 通道连不上,不影响微信和其他功能。
165
+
166
+ ### 额外依赖 SnowLuma SDK(`@snowluma/sdk`)
167
+
168
+ 首次手动开启 QQ 时,缺少 SDK 就调用宿主包管理器装到当前 DSH profile,禁用安装脚本,不修补 SDK 文件;安装完成后提示重启 DSH,再按保存的开关启用 QQ。安装失败会显示原因,运行环境要求以 SDK 自身说明为准,不自动升级 Node。不使用 QQ 时无需 SDK,不影响其他功能;也可自行安装兼容版本,见 [安装说明](INSTALL.md#第一步把-dsh-world-装进-profile)。
169
+
170
+ ### QQ 的开关
171
+
172
+ 默认关。要用 QQ,先在配置里写 `qqNative.enabled: true`,再到控制台「概览 → 接入」把 QQ 拨开:开着才加载通道,关掉就断开连接。没在配置里启用的模块不能从控制台打开。首次手动开启时缺少 SDK 会按需安装,见上一条。
173
+
174
+ ### QQ 的记忆
175
+
176
+ QQ 消息由插件自己那条原生通道送进家里,插件没有为它做微信那样的渠道身份。按 `bindHomeSession`(默认 `owner`),主人的私聊用她的家会话,因此按普通家会话归档;每个群各挂一个独立会话(标题形如 `QQ · <群名>`),挂在她的房间工作区下、用同一个 `agentPreset`——所以在默认的 `archiveScope: workspace` 下,**群里的对话和微信群一样会进归档、进记忆块**,归档里只有会话、没有渠道标记。写 `none` 时私聊也另建一个这样的独立会话。群里的消息默认只有被叫到才接话,其余只进本轮上下文、不开口也不花额度。
177
+
178
+ ### 群里默认只接被叫到的
179
+
180
+ 对应 `groupTrigger: mention`:被 @、引用她刚说过的话、或文本命中 `groupKeywords` 才算叫她,其余消息只进本轮上下文,不开口也不花额度;写 `all` 就是每句都接,代价是群里每一条都会让她跑完一轮。`@全体` 是群公告,不算叫她。`bindHomeSession` 决定谁和她的家会话共用一个入口,默认 `owner`。
181
+
182
+ ### 看门狗
183
+
184
+ 对应 `supervise`,默认开。QQ 开着时每 30 秒探一次 `wsUrl` 的端口,不通就按 `snowlumaHome` 把 SnowLuma 拉起来(本机有 `SnowLuma-watchdog` 计划任务时借它跑,能活过 DSH 重启;没有就直接起进程,只活到 DSH 退出)。拉不起来的原因写在卡上。不想让插件动手就设成 `false`,卡上的「拉起 SnowLuma」按钮照旧能用。