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