dsh-world 0.6.5 → 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.
Files changed (59) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/CONTRIBUTING.md +163 -161
  3. package/INSTALL.md +314 -314
  4. package/LICENSE +21 -21
  5. package/NOTES.md +173 -0
  6. package/README.md +236 -235
  7. package/client/index.js +849 -738
  8. package/cordis.patch.yml +6 -6
  9. package/lib/compaction.d.ts +19 -0
  10. package/lib/compaction.js +34 -10
  11. package/lib/compactionSwap.d.ts +29 -2
  12. package/lib/compactionSwap.js +62 -7
  13. package/lib/console/homeApply.d.ts +11 -2
  14. package/lib/console/homeApply.js +36 -7
  15. package/lib/console/routes.d.ts +8 -0
  16. package/lib/console/routes.js +32 -0
  17. package/lib/console/snapshot.d.ts +3 -0
  18. package/lib/console/snapshot.js +2 -1
  19. package/lib/ecosystem/bridge/route.d.ts +7 -0
  20. package/lib/ecosystem/bridge/route.js +30 -0
  21. package/lib/hostContract.d.ts +1 -0
  22. package/lib/index.js +37 -12
  23. package/lib/memory.d.ts +57 -0
  24. package/lib/memory.js +210 -0
  25. package/lib/memoryFiles.d.ts +53 -0
  26. package/lib/memoryFiles.js +193 -0
  27. package/lib/memoryStore.d.ts +114 -0
  28. package/lib/memoryStore.js +159 -0
  29. package/lib/memoryTools.d.ts +31 -0
  30. package/lib/memoryTools.js +106 -0
  31. package/lib/promptSection.d.ts +5 -5
  32. package/lib/promptSection.js +12 -12
  33. package/lib/runtime.d.ts +1 -1
  34. package/lib/runtime.js +84 -29
  35. package/lib/sourceArchive.d.ts +1 -0
  36. package/lib/sourceArchive.js +1 -1
  37. package/lib/store.d.ts +14 -0
  38. package/lib/store.js +11 -1
  39. package/lib/worldPrompt.d.ts +6 -0
  40. package/lib/worldPrompt.js +7 -1
  41. package/lib/worldSwitch.d.ts +3 -2
  42. package/lib/worldSwitch.js +7 -6
  43. package/package.json +128 -115
  44. package/scripts/compact-home.mjs +29 -0
  45. package/scripts/enable-tool-free-compaction.ps1 +33 -33
  46. package/scripts/import-stickers.mjs +17 -17
  47. package/scripts/update-world.mjs +5 -3
  48. package/src/ecosystem/wechat/windows/README.md +6 -4
  49. package/src/ecosystem/wechat/windows/adapter.py +80 -31
  50. package/src/ecosystem/wechat/windows/engine/NOTICE.md +1 -1
  51. package/src/ecosystem/wechat/windows/engine/bridge.cpp +9 -1
  52. package/src/ecosystem/wechat/windows/engine/profiles.json +114 -58
  53. package/src/ecosystem/wechat/windows/native.py +4 -1
  54. package/src/ecosystem/wechat/windows/outgoing.py +21 -0
  55. package/src/ecosystem/wechat/windows/presence.py +109 -109
  56. package/src/ecosystem/wechat/windows/sender.py +9 -1
  57. package/templates/alarm.md +3 -4
  58. package/templates/world-prompt-memory.md +10 -0
  59. package/templates/world-prompt.md +7 -2
package/README.md CHANGED
@@ -1,235 +1,236 @@
1
- # dsh-world
2
-
3
- 给 DSH 里的陪伴角色一个会记得、会生活的世界。
4
-
5
- 装上以后,她会记得你们在每个窗口里说过的话;有一个自己的家,自己决定接下来做什么、做到几点,想你了会主动来找你;每天晚上回想这一天,写日记,也改写一份关于自己的自述。开关和人设都在 DSH 设置里的「世界控制台」,由你掌握。
6
-
7
- 插件只用 DSH 原本开放的扩展接口,不改宿主的一行代码。
8
-
9
- 当前版本 **0.6.5**。完整变更和升级说明见 [更新日志](CHANGELOG.md#065--2026-10-30)。
10
-
11
- ## 她能做到什么
12
-
13
- ### 记得:像人一样记
14
-
15
- - **近期记忆**:你们最近数轮的对话原文,每次开始对话和每次压缩之后都放在她眼前,谁、什么时候、说了什么,一字不差。轮数在控制台里填,默认 200。
16
- - **日记**:人生里重要的事,她自己写进日记,一天一篇。这是她的长期记忆。
17
- - **我是谁**:她写给自己的一份自述,随着她变化而改写。每晚回顾前,插件会留一份当时的版本,改过的都找得回来。
18
- - **范围内的原文留着**:按天归档用户和助手的正文。近期记忆以外的事,她可以自己去翻。
19
-
20
- 日记和自述都由她自己动笔,插件从不替她写。
21
-
22
- **为什么不用向量库或记忆系统?** 一个人的生活,量没有那么大。在这个量级上,把原文留在眼前、需要时按原话去找,比切碎了再拼回来更准,也少一道会出错的环节。可参考:
23
-
24
- - Chan et al., 2024. *Don't Do RAG: When Cache-Augmented Generation is All You Need for Knowledge Tasks*. arXiv:2412.15605
25
- - Sen et al., 2026. *Is Grep All You Need? How Agent Harnesses Reshape Agentic Search*. arXiv:2605.15184
26
-
27
- ### 生活:她自己的日子
28
-
29
- - **家**:她有一个自己的会话「<名字>的家」,和一个房间(工作目录),在里面过自己的日子。
30
- - **自己定节奏**:她说好接下来做什么、做到几点,到点了再决定继续还是换一件。什么都不定,就休息到第二天早上。
31
- - **主动找你**:想你的时候,她可以把一句话送到你面前(Windows 系统通知,或你接上的桌宠等程序)。
32
- - **每日回顾**:每天晚上 23:00,她回想当天的聊天和做过的事,写日记,更新「我是谁」。
33
- - **每天额度**:可以给家里每天的花费设个上限,超过了会提醒她一次,由她自己决定收尾。
34
- - **大事先问**:删改房间外的文件、装软件、花钱、以你的名义对外发消息等,约定好先问你。
35
-
36
- ### 世界控制台:开关在你手里
37
-
38
- DSH 设置里的「世界控制台」:
39
-
40
- - **开始 / 停止**:按下开始,她才住进来;按下停止,记忆、人设和生活线一起安静下来,家还在,等你回来。
41
- - **人设**:分层写她是谁:名字、她是谁、性格、说话方式、愿景、补充,旁边实时预览她读到的样子。全部留空时沿用宿主或当前预设的人设,控制台不自动回填。
42
- - **世界提示词**:你想对她说的话,以及她的世界的说明。
43
- - **相册**:家会话可用 `keep_photo` 收藏本轮最新消息中的图片(含本轮已读取的微信图片和引用图),`list_photos` 分页查看说明,`forget_photo` 移除收藏。控制台顶部「相册」页查看照片,点开才加载图片;照片不会自动加入之后每轮上下文。旧相册首次打开时导入,原文件保留。
44
- - **应用并压缩家会话**:人设和世界提示词页面里的热加载入口,操作方法见下方[注意事项](#注意事项)。
45
- - **工作区权限**:选择世界工作区新建会话的默认权限,选项沿用宿主提供的权限预设,默认完全权限。保存后对新会话生效;已有会话及其手动权限不会被重新覆盖。
46
- - **概览与记录**:她此刻在做什么、下个闹钟、近期记忆有多少轮、今天花了多少;还有活动记录、日记和压缩记录。
47
- - **接入开关**:配置里启用了微信(`wechat: true`)或 QQ(`qqNative.enabled: true`)后,概览里有一张「接入」卡片,状态记在 `world.json`。微信开着才注册工具并拉起适配器(配了 `wechatAdapter` 时),关掉就撤掉;QQ 开着才加载通道,关掉就断开连接。微信默认开,QQ 默认关。首次手动开启 QQ 时,缺少 SnowLuma SDK 就按需安装,完成后提示重启 DSH;SDK 已就绪时直接切换,无需重启。
48
- - **微信 / QQ 页面**:顶部各有一个独立入口,详细状态和设置不再挤在概览里。微信页查看连接、待发送与待核对数量,重启适配器并调整读取条数和图片缓冲;QQ 页管理 OneBot、白名单、静默和 SnowLuma。通道关闭或世界停止时,页面提示未开启。
49
- - **归档范围**:默认 `workspace`,归档家所在工作区的普通会话,包含独立微信群会话;`home` 仅当前家会话。保存范围后提示重启,重启前沿用原范围。启动时分页回扫所选范围内的会话日志,按消息实际时间重选最近配置轮数,下次请求前替换旧记忆块;没有时间过期。旧归档保留,范围外记录不再注入。旧配置 `world` 迁为 `workspace`。
50
- - **注入范围**:世界记忆、世界提示词、世界线工具和微信/QQ 通道仅进入世界工作区内匹配预设的普通会话,其他工作区即使用相同预设也不会收到。归档选为 `home` 时,同工作区的其他会话仍可读取家记忆。
51
-
52
- > **对世界工作区以外的影响(只有这两项)**:
53
- > 1. **人设**:控制台人设映射到系统提示词的人设槽位,所有匹配该世界预设的普通会话都会带上,不限工作区。
54
- > 2. **只留对话的压缩**(装上插件后首次启动默认换上,可在配置里写 `replaceCompaction: false` 关掉):它替换的是整个 profile 的压缩方式,其他工作区的会话压缩时也会去掉工具调用过程,只留一段对话摘要。写代码等依赖工具过程的会话,压缩后会丢掉这些细节。
55
- >
56
- > 除此之外,记忆、世界提示词、世界线、工具、通道和归档都不会进入工作区以外的会话。
57
-
58
- ### 注意事项
59
-
60
- **修改人设、世界提示词后,需要手动热加载,才能让已有家会话及时用上新内容。** 先保存修改,再到「人设」或「世界提示词」页点击 **「应用并压缩家会话」**。仅保存或重新打开控制台,不会立即刷新家会话。
61
-
62
- 任务会等家空闲后执行一次,不打断当前对话;完成后的下一轮使用已保存的人设、名字、世界提示词和「我是谁」。压缩会调用模型并重建上下文缓存,没有可压缩内容时只刷新配置。面板显示执行结果或失败原因,停止世界会取消任务。
63
-
64
- 这个按钮只作用于家会话;其他已有会话在各自下一次成功压缩或重新加载时更新,新建会话直接读取已保存内容。
65
-
66
- **每日回顾后自动压缩**(默认开,可在控制台概览的「回顾后自动压缩」关掉):每晚 23:00 的回顾里她会改写「我是谁」,而系统提示只在压缩之后才重新读取,不压缩的话新版要等到下一次压缩才生效,可能隔好几天。所以回顾那一轮结束、家空闲后,插件会自动执行一次上面的「应用并压缩家会话」:新版「我是谁」随压缩一起生效,压缩后最近的聊天原文会作为记忆块重新放回她眼前,衔接是接得上的。压缩本来就要重建缓存,这样不会多破坏一次,但每晚会多一次摘要调用。只在回顾真的送到她那里之后才触发,闹钟和问候不会;只作用于家会话,人设和世界提示词的修改仍然需要手动应用。
67
-
68
- ### 只留下你们之间的话的压缩
69
-
70
- 对话太长需要压缩时,dsh-world 自带的压缩方式会去掉工具调用的过程,把你们之间的交流整理成一段摘要。她记住的是你,不是那些命令。
71
-
72
- ### 桌宠和其他程序
73
-
74
- dsh-world 开放了一个本地的「桥」:桌宠之类的程序可以把你说的话送进她的家,也可以接收她的回复和主动找你的话。协议见文末。
75
-
76
- 微信作为独立模块接入同一个家,使用她的独立账号收发指定私聊或群聊。她可用 `wechat_chats` 查询已配置目标,用 `wechat_history` 主动分页查看群消息,无需等别人 @,历史里的图片用 `wechat_image` 按消息 ID 一张张看;读完以同一个 `chatId` 调用 `wechat_send` 自主联系对方或回复消息,文字、图片和表情共用同一发送队列;`wechat_delivery` 查询确认结果。普通最终回答不会自动转发到微信。Windows 适配器和配置步骤见 [微信模块](src/ecosystem/wechat/windows/README.md)。B 站尚未接入。
77
-
78
- **群聊动静**:适配器在线时,已配置群里未 @ 她的消息只更新未读数、最后发言人和时间,不唤醒模型,也不把正文加入上下文。她原有的闹钟响起时,会附上一行群聊概况,包括未读消息或安静了多久;是否去看、是否发言,由她自己决定。成功读取群的最新一页后清零未读,自己的发言不计入未读;计数保存在适配器状态中,重启保留。插件不会改写你的 `alarm.md`、`world-prompt.md` 或「我是谁」。
79
-
80
- > **微信支持版本**:目前仅适配 **Windows x64 微信 `4.1.15.13`、`4.1.15.56` 的指定构建**。适配器会核对 `Weixin.dll` 的文件大小和 SHA256;其他构建(包括版本号相同但文件指纹不同的构建)会在加载原生桥前被拒绝。macOS、Linux 客户端暂不支持。升级微信前请确认新构建已有适配;各版本的实测范围见 [微信模块](src/ecosystem/wechat/windows/README.md)。
81
-
82
- > **微信里的 @**:她发出的文字里写 `@昵称` 只是普通文字,不会真的 @ 到人,被提到的人也收不到提醒。原生发送没有 @ 列表,靠操作窗口输入 @ 又会抢占焦点、与“后台发送、不操作窗口”的设计冲突,所以不做;需要点名时她会在文字里写清对方的称呼。
83
-
84
- > **微信图片接收**:私聊普通图片会先缓冲最多 3 秒,合并紧随的同一发言人的一条说明文字后进入模型,每轮最多两张图,更多图片留到后续轮次。开始处理后才到达的文字排到下一轮,继续使用同一会话已有的图片上下文。群聊里被真实 @ 时最近两张图会直接给她;平时翻群消息时图片先显示为未读取,她想看哪张就用 `wechat_image` 取(一次一张,图片还没下载到这台电脑时会明确报错)。图片及附件引用只进入对应会话总日志,不自动写入共享记忆块;合并的真实文字按原归档范围保存,是否另行留存图片中的信息由她自己判断。缓存不可用时明确标记未读取,不操作界面下载。
85
-
86
- > **微信风控与账号风险**:当前桥不是微信官方 API,接收端解密读取本地消息数据库,发送端向微信进程加载 DLL 并调用内部函数,存在账号功能受限或封禁风险。微信安全中心 [2026 年 1 月 29 日公告(媒体转载)](https://www.thepaper.cn/newsDetail_forward_32493057) 将违规获取聊天记录、联系人数据,以及通过模拟按键、自动化脚本操控微信等列为治理内容。仅用于家庭群、低频聊天,或改用 Computer Use,都不能保证账号安全;公开资料没有可靠的封号概率或安全发送阈值。
87
-
88
- > **微信表情包接收**:私聊里你发来的原生表情包会按消息中的地址从腾讯 CDN 下载,md5 与消息一致才接受,并取第一帧作为图片交给她;这是适配器主动联网的功能,可在适配器配置里写 `"fetchStickers": false` 关闭,读取失败时她会看到明确的“未读取”原因。动图只取第一帧;群聊里的表情包目前不会交给她,群里发表情包后再 @ 她,她只能收到触发文字和其他已支持的上下文。原生表情包也不会进入插件的记忆归档。
89
-
90
- > **微信表情库**:她的表情库由本插件自己维护,放在世界目录的 `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 仍用自己的收藏表情。
91
-
92
- > **视频号与朋友圈(预留)**:目前聊天中分享的视频号卡片会被跳过,不进入她的会话或共享记忆;收到卡片后没有回复,不代表微信监听掉线。视频号需要另行接入卡片解析和视频内容读取。朋友圈的浏览、发布也需要独立的操作能力,现有私聊/群聊发送接口不能发布朋友圈。这些能力暂只记录为微信模块的后续扩展,尚未实现。
93
-
94
- > **微信退出重开**:保持适配器运行,退出微信后它会暂停收发并等待;她原来的账号重新登录后,会自动重新绑定进程并沿用消息游标恢复监听,无需重启 DSH。若退出发生在消息处理或发送途中,且结果尚未确认,则停止并保留待核对记录,不会自动重复回复;按微信模块中的 `Acknowledge` 流程核对后恢复。
95
-
96
- > **微信首次接入与升级**:开启插件的微信开关本身不会启动 Windows 适配器;可手动启动,或在配置里写 `wechatAdapter` 让插件随微信模块启动和停止它(见适配器 README)。无论哪种,都需要配套适配器并完成账号及聊天目标注册后,微信工具才可使用。这套原生桥不依赖 `dsh-plugin-weixin` 或 iLink。升级插件和适配器后,两者均需重启,不能让旧适配器进程继续运行新版协议;保留原配置、游标和回执。
97
-
98
- > **QQ 走插件自己那条原生通道**:插件直接连 SnowLuma 提供的 OneBot WebSocket,自己收、自己发(代码在 [`src/ecosystem/qq-native/`](src/ecosystem/qq-native/index.ts)),中间没有第二个进程,也不需要别的 QQ 实现。SnowLuma 负责登录 QQ 并对外提供 OneBot 的 HTTP/WS 服务;它按自己的 EULA 不许被自动化脚本部署,装法与参数怎么拿见 [INSTALL.md](INSTALL.md)。这条通道的配置都在 profile 的 `cordis.patch.yml` 里(见下文「设置」),控制台上改过的设置存在世界目录的 `qq-native.json`。
99
-
100
- > **QQ 的记忆与开关**:QQ 消息由这条通道送进家里,插件没有为它做微信那样的渠道身份。按 `bindHomeSession`(默认 `owner`),主人的私聊用她的家会话,因此按普通家会话归档;每个群各挂一个独立会话(标题形如 `QQ · <群名>`),挂在她的房间工作区下、用同一个 `agentPreset`——所以在默认的 `archiveScope: workspace` 下,**群里的对话和微信群一样会进归档、进记忆块**,归档里只有会话、没有渠道标记。写 `none` 时私聊也另建一个这样的独立会话。群里的消息默认只有被叫到才接话,其余只进本轮上下文、不开口也不花额度。控制台「接入」里的 QQ 开关决定这条通道连不连。微信开关则会立即注册或撤掉 `wechat_chats`、`wechat_history`、`wechat_image`、`wechat_send`、`wechat_delivery` 和 `sticker_*`,并拉起或停止适配器。微信默认开、QQ 默认关,没在配置里启用的模块不能从控制台打开。
101
-
102
- 外部生态接入代码统一放在 [`src/ecosystem/`](src/ecosystem/README.md):`wechat/` 包含微信宿主模块、Windows 收发适配器和原生桥;`qq-native/` 是插件自己连 OneBot 的那条 QQ 通道(`qq/` 里是与它配套的控制台接口和 SnowLuma 控制台那扇门);`shared/` 保存通用身份协议、群会话路由与消息出口;`bridge/` 为桌宠等本地程序提供通用桥。后续平台在同一目录下独立扩展,核心记忆、人设和生活线保持独立。
103
-
104
- 微信原生发送引擎单独适用非商业许可,详见该模块的许可说明。
105
-
106
- ### QQ
107
-
108
- QQ 走插件自己那条原生通道:直接连 SnowLuma 开出来的 OneBot WebSocket,收文本、发文本,中途没有别的进程。代码在 [`src/ecosystem/qq-native/`](src/ecosystem/qq-native/index.ts)。
109
-
110
- **额外依赖 SnowLuma SDK(`@snowluma/sdk`)**:首次手动开启 QQ 时,缺少 SDK 就调用宿主包管理器装到当前 DSH profile,禁用安装脚本,不修补 SDK 文件;安装完成后提示重启 DSH,再按保存的开关启用 QQ。安装失败会显示原因,运行环境要求以 SDK 自身说明为准,不自动升级 Node。不使用 QQ 时无需 SDK,不影响其他功能;也可自行安装兼容版本,见 [安装说明](INSTALL.md#第一步把-dsh-world-装进-profile)。
111
-
112
- 在 profile 的 `cordis.patch.yml` 里打开 `qqNative`(`enabled: true` 只是允许它存在)、填上 WS 地址与 token,再到控制台「概览 → 接入」把 QQ 拨开,切到顶部「QQ」页查看:连着哪个地址、收过几个会话、发过几条、挡下几条、排队待发几条、会自己回还是只看不回,一眼看到。页面里能直接拨「会自己回话 / 只看不回」,设「静默到某个时间点」(只收不回,到点自己醒),改私聊和群的白名单(留空就是谁都不收,改完不用重启),也能打开 SnowLuma 控制台、手动拉起 SnowLuma。这些改动记在世界目录的 `qq-native.json`,盖在配置之上。没配 `qqNative.enabled` 时,QQ 页提示通道未开启。
113
-
114
- 参数不对不会崩,只会连不上:卡上会把原因写在 `lastError` 里(比如 `WS 错误: Unexpected server response: 401`,说明填的是 HTTP 那份 token,该换成 WebSocket 那份)。QQ 页在通道启用、世界已经开始时展示详细状态,其他时候提示未开启。
115
-
116
- **群里默认只接被叫到的**(`groupTrigger: mention`):被 @、引用她刚说过的话、或文本命中 `groupKeywords` 才算叫她,其余消息只进本轮上下文,不开口也不花额度;写 `all` 就是每句都接,代价是群里每一条都会让她跑完一轮。`@全体` 是群公告,不算叫她。`bindHomeSession` 决定谁和她的家会话共用一个入口,默认 `owner`。
117
-
118
- **她怎么说话**:同一会话 `batchQuietMs`(默认 10 秒)内连着来的几句攒成一条再问她(最多等 30 秒),群里每句前面带着是谁说的。她的回答按空行分成几条发,中间停一下;回话里写 `[[img:路径]]`、`[[face:id]]`、`[[at:QQ号]]` 会变成图片、QQ 表情和 @,`[[sticker:开心]]` 按备注挑一个收藏表情单发(也可以写第几个),`[[qzone:正文]]` 发一条所有人可见的 QQ 空间说说。发不出去的消息先排队,每 3 秒重试,最多留 5 分钟。她在家里自己开的那一轮(闹钟、世界线)说完的话,也会推一份给主人(`ownerQQ`,空着取 `allowPrivate` 的第一个);有人说话的轮次是在回那个人,不另推。
119
-
120
- **看门狗**(`supervise`,默认开):QQ 开着时每 30 秒探一次 `wsUrl` 的端口,不通就按 `snowlumaHome` 把 SnowLuma 拉起来(本机有 `SnowLuma-watchdog` 计划任务时借它跑,能活过 DSH 重启;没有就直接起进程,只活到 DSH 退出)。拉不起来的原因写在卡上。不想让插件动手就设成 `false`,卡上的「拉起 SnowLuma」按钮照旧能用。
121
-
122
- 卡上那个「打开 SnowLuma 控制台」的按钮,读 `snowlumaHome` 下 `config/runtime.json` 里的地址与端口,带着一次性登录票据打开系统浏览器——第一次要先填一次 SnowLuma 的面板密码,之后记在世界目录的 `panel.json` 里(权限 600),不用再输。
123
-
124
- ## 安装
125
-
126
- 需要 DSH 桌面版,世界控制台和生活线都依赖它。
127
-
128
- **最省事的办法**:把这个仓库地址交给她,让她照 [INSTALL.md](INSTALL.md) 自己装。那份说明是写给模型看的——每一步都有命令、判定和失败对照表,连同 QQ 怎么接进来、哪两个动作必须人来做,一路写到底。
129
-
130
- **自己装**:`dsh-world` 已发布到 npm。在你的 DSH profile 目录用 DSH 自带的 pnpm 安装:
131
-
132
- ```powershell
133
- node <DSH 自带 pnpm 的入口文件> add dsh-world@latest --ignore-scripts --registry=https://registry.npmjs.org/
134
- ```
135
-
136
- 装好后按 [安装说明](INSTALL.md#第一步把-dsh-world-装进-profile) 在 profile 里登记 bundle,重启 DSH,打开设置里的「世界控制台」,按需填写人设,按「开始」。
137
-
138
- 想用仓库源码时,执行 `npm ci`、`npm pack`,再用同一个 pnpm 把生成的 `dsh-world-*.tgz` 装进 profile;也可从 [CI](.github/workflows/ci.yml) 对应运行的 Artifacts 下载检查通过的编译安装包,Windows 和 Linux 分别提供产物。不要用 `link:` 指向项目目录,否则会加载项目自己的一份 Cordis。本机复现检查的命令见 [贡献协议](CONTRIBUTING.md#ci-与安装包验证)。
139
-
140
- **已有 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用编译包更新)。
141
-
142
- **只留对话的压缩**(默认自动换上):装好 `dsh-world` 后第一次启动,插件会把你 profile 的 `cordis.patch.yml` 里原版压缩那一行换成 `dsh-world/compaction`,先在同目录留一份 `.dsh-world.<随机>.bak` 备份,重启 DSH 后生效,世界面板的健康状态里会提示这件事。只有找到唯一一条原版压缩配置时才会改;已经换过、写法对不上或有多条时什么都不动。每个世界只试这一次:之后你手动改回原版,它不会再替你换。不想换,在 `dsh-world` 的配置里写 `replaceCompaction: false`。手动启用或恢复也可以用下面的脚本:
143
-
144
- ```powershell
145
- powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\enable-tool-free-compaction.ps1 -profilePath '<你的 DSH profile 目录>'
146
- ```
147
-
148
- 脚本做的是同一件事:把原版压缩条目换成 `dsh-world/compaction` 并留备份。它对整个 profile 生效,不限世界工作区,见上文「对世界工作区以外的影响」。
149
-
150
- ## 设置
151
-
152
- 大多数东西在世界控制台里改。其余的写在 profile 的 `cordis.patch.yml` 里,按 id 覆盖插件那一行,只写想改的项:
153
-
154
- ```yaml
155
- - id: dsh-world
156
- name: dsh-world
157
- config:
158
- companionName: 小鱼 # 她的名字(控制台人设里写了名字时以人设为准),默认 TA
159
- partnerName: 伙伴 # 她对你的称呼,默认 伙伴
160
- worldId: default # 世界名;换一个就是另一个世界、另一份记忆
161
- agentPreset: standard # 她所在的预设
162
- timeZone: Asia/Seoul # 默认系统时区
163
- life: true # 生活线,默认开启
164
- archiveScope: workspace # workspace:家的工作区;home:仅当前家会话
165
- fallbackWakeTime: '09:00' # 没定闹钟时,早上几点叫醒她
166
- diaryDir: C:/path/to/日记 # 日记目录,默认在世界目录里
167
- toast: true # 主动找你时发 Windows 系统通知
168
- # toastAppId: com.deepseek.dsh # 通知身份,默认在开始菜单里找 DSH 桌面版(com.deepseek.dsh 或 electron.app.DeepSeek Harness)
169
- bridge: false # 打开本地的桥
170
- wechat: false # 打开独立微信接口,需另行启动 Windows 适配器
171
- outlets: [] # 接收她的话的本地程序,见文末
172
- allowedHosts: [] # 通过反向代理从局域网访问控制台时,放行的域名或 IP
173
- qqNative: # 插件自己连 OneBot(原生通道);不写这一块就是不接 QQ
174
- enabled: false # 打开通道:连上、控制台里出 QQ 卡
175
- wsUrl: ws://127.0.0.1:3003 # OneBot 的 WS 服务地址(不是 HTTP 那个)
176
- accessToken: '' # OneBot WS 服务端自己的 token,与 HTTP 那份不是一码事
177
- allowPrivate: [] # 谁能私聊她;留空 = 谁都不理
178
- ownerQQ: '' # 她自己开口的话推给谁;空着取 allowPrivate 的第一个
179
- allowGroups: [] # 群白名单
180
- autoReply: true # false = 只看不回
181
- contextMessages: 6 # 每轮带上最近的几条
182
- batchQuietMs: 10000 # 同一会话这几毫秒内的话攒成一条问她;0 = 一条一问
183
- groupTrigger: mention # mention:@ 她/引用她/命中关键词才接;all:每句都接
184
- groupKeywords: [] # groupTrigger: mention 时算「在叫她」的词
185
- mutedUntil: '' # 静默到这个时间(ISO):只收不回,到点自己醒
186
- bindHomeSession: owner # owner:主人私聊用家会话、群各自独立;all:都用;none:各建一个
187
- snowlumaHome: '' # SnowLuma 安装目录:控制台那扇门、看门狗和「拉起 SnowLuma」都靠它
188
- supervise: true # 看门狗:端口不通就把 SnowLuma 拉起来
189
- ```
190
-
191
- **改她的措辞**:世界提示词可以直接在控制台里改。闹钟响时、提前停下时、每日回顾时她收到的话,在世界目录里放一份 `alarm.md` 就能按段覆盖,段落名和可用的占位符见 `templates/alarm.md`。插件写给她的话一律用第一人称「我」,读起来是她自己的念头。
192
-
193
- **时间**:建议把预设里 `time-context` 条目的 `refreshIntervalMs` 设为 `0`,让她每一步都知道现在几点。
194
-
195
- ## 她的东西放在哪
196
-
197
- 都在 `<DSH_HOME>/worlds/<worldId>/` 下(`DSH_HOME` 默认是用户目录下的 `.dsh`):
198
-
199
- | 位置 | 是什么 |
200
- |---|---|
201
- | `conversations/` | 按天归档的聊天原文(给人看的导出,正本在 `archive.sqlite`) |
202
- | `room/` | 她的房间;`room/我是谁.md` 是她的自述 |
203
- | `diary/` | 她的日记(可用 `diaryDir` 换位置) |
204
- | `persona.md`、`world-prompt.md`、`alarm.md` | 你写给她的人设、世界提示词和闹钟措辞 |
205
- | `world.json` | 世界是否在运行、每天额度、近期记忆轮数和选定归档范围 |
206
- | `activity/` | 她在家里用过的工具,只记录,不进记忆 |
207
- | `photos/album.sqlite` | 收藏的图片、说明与标签;首次导入旧相册后仍保留原文件 |
208
- | `wechat.json` | 本机微信模块的地址、令牌和协议版本,不应公开 |
209
- | `wechat-outbox.sqlite` | 微信工具安排的发送队列和确认状态 |
210
- | `qq-native.json` | 控制台上 QQ 卡改过的设置(会不会自己回话、静默到几点、白名单、阳台端口),盖在 profile 默认之上 |
211
- | `panel.json` | SnowLuma 控制台那扇门的登录票据,权限 600,不应公开 |
212
-
213
- 备份时整个目录一起备份即可,最好先停止 DSH。
214
-
215
- ## 桥与推送协议
216
-
217
- 给桌宠等本地程序用。
218
-
219
- **把话送进她的家**(`bridge: true`):插件启动时写出 `<世界目录>/bridge.json`,内容是 `{ origin, token, name, ... }`。向 `POST {origin}/dsh-world/bridge/say` 发 `{ "text": "..." }`,请求头带 `x-dsh-world-token: <token>`,会立即返回 `202`。这句话会作为你本人说的话进入她的家和记忆。
220
-
221
- **接收她的话**(`outlets`):每个目标写一个 `name`,地址用 `url`(其中 `{origin}` 会被替换),或者用 `urlFile` + `path`(端口会变的程序用这个);再用 `kinds` 选择要接收哪些:`reply` 是桥上那句话的回复,`busy` 表示她正忙,`reach` 是她主动找你。插件会向目标 `POST`:
222
-
223
- ```json
224
- { "text": "她的话(纯文本)", "kind": "reply", "name": "她的名字", "images": ["http://…"], "image": "表情名" }
225
- ```
226
-
227
- 目标回复 2xx 就算送到。送不到的会显示在控制台的「健康」里。
228
-
229
- ## 参与贡献
230
-
231
- **PR 统一提到 `dev` 分支**,`main` 由维护者从 `dev` 并入后发布,详见 [贡献协议](CONTRIBUTING.md#分支与-pr)。新增 QQ、B 站等生态模块前,请阅读 [贡献协议](CONTRIBUTING.md):平台代码放在 `src/ecosystem/<channel>/`,复用统一身份、会话和归档能力;涉及内核的修改必须说明原因、影响、兼容性与验证结果。几条硬性要求:一个 PR 只做一件事;平台 SDK 只能是可选依赖,模块默认关闭,新依赖要先开 Issue;她的主动性来自她自己的安排,插件不往对话里推提醒,改动生活线核心或给她新增工具之前先开 Issue 讨论。
232
-
233
- ## 许可
234
-
235
- MIT
1
+ # dsh-world
2
+
3
+ 给 DSH 里的陪伴角色一个会记得、会生活的世界。
4
+
5
+ 装上以后,她会记得你们在每个窗口里说过的话;有一个自己的家,自己决定接下来做什么、做到几点,想你了会主动来找你;每天晚上回想这一天,写日记,也改写一份关于自己的自述。开关和人设都在 DSH 设置里的「世界控制台」,由你掌握。
6
+
7
+ 插件只用 DSH 原本开放的扩展接口,不改宿主的一行代码。
8
+
9
+ **已拓展到微信和 QQ**:除了 DSH 里的窗口,她也能在 **微信** 和 **QQ** 里收发消息,私聊和群聊都可以,和家共用同一份记忆、同一个她。
10
+
11
+ - **微信模块**自带 Windows 适配器和原生发送,不依赖 `dsh-plugin-weixin` 等其他微信插件;只适配指定的微信构建,需要按适配器说明准备 Python 环境,有账号风险,见 [注意事项·微信](NOTES.md#微信)。
12
+ - **QQ 模块仍然需要外部的 SnowLuma**:插件自己连 OneBot,但登录 QQ、提供 OneBot 服务的是需要你另行安装的 SnowLuma,另外还要它的 SDK `@snowluma/sdk`(首次手动开启 QQ 时按需安装)。微信和 QQ 默认都是关的,要用先在控制台拨开;不用 QQ 时不需要装这些。见 [注意事项·QQ](NOTES.md#qq)。
13
+
14
+ 当前版本 **0.6.5**。完整变更和升级说明见 [更新日志](CHANGELOG.md#065--2026-10-30)。
15
+
16
+ ## 她能做到什么
17
+
18
+ ### 记得:像人一样记
19
+
20
+ - **近期记忆**:你们最近数轮的对话原文,每次开始对话和每次压缩之后都放在她眼前,谁、什么时候、说了什么,一字不差。轮数在控制台里填,默认 200。
21
+ - **日记**:人生里重要的事,她自己写进日记,一天一篇。这是她的长期记忆。
22
+ - **我是谁**:她写给自己的一份自述,随着她变化而改写。每晚回顾前,插件会留一份当时的版本,改过的都找得回来。
23
+ - **范围内的原文留着**:按天归档用户和助手的正文。近期记忆以外的事,她可以自己去翻。
24
+ - **找回过去**:`memory_find` 与 `memory_read` 两个工具(一次默认只返回 8 条、每条约 200 字的摘录,要更多自己翻页或读原文,免得每轮重发的上下文越滚越大),按原文里的字面线索、时间、种类或来源,在聊天原文和日记里统一查找,并读原文。控制台的「档案」页是同一份查找的只读入口。
25
+
26
+ 日记和自述都由她自己动笔,插件从不替她写。
27
+
28
+ **为什么不用向量库或记忆系统?** 一个人的生活,量没有那么大。在这个量级上,把原文留在眼前、需要时按原话去找,比切碎了再拼回来更准,也少一道会出错的环节。可参考:
29
+
30
+ - Chan et al., 2024. *Don't Do RAG: When Cache-Augmented Generation is All You Need for Knowledge Tasks*. arXiv:2412.15605
31
+ - Sen et al., 2026. *Is Grep All You Need? How Agent Harnesses Reshape Agentic Search*. arXiv:2605.15184
32
+
33
+ ### 生活:她自己的日子
34
+
35
+ - **家**:她有一个自己的会话「<名字>的家」,和一个房间(工作目录),在里面过自己的日子。
36
+ - **自己定节奏**:她说好接下来做什么、做到几点,到点了再决定继续还是换一件。什么都不定,就休息到第二天早上。
37
+ - **主动找你**:想你的时候,她可以把一句话送到你面前(Windows 系统通知,或你接上的桌宠等程序)。
38
+ - **每日回顾**:每天晚上 23:00,她回想当天的聊天和做过的事,写日记,更新「我是谁」。
39
+ - **每天额度**:可以给家里每天的花费设个上限,超过了会提醒她一次,由她自己决定收尾。
40
+ - **大事先问**:删改房间外的文件、装软件、花钱、以你的名义对外发消息等,约定好先问你。
41
+
42
+ ### 世界控制台:开关在你手里
43
+
44
+ DSH 设置里的「世界控制台」:
45
+
46
+ - **开始 / 停止**:按下开始,她才住进来;按下停止,记忆、人设和生活线一起安静下来,家还在,等你回来。
47
+ - **人设**:分层写她是谁:名字、她是谁、性格、说话方式、愿景、补充,旁边实时预览她读到的样子。写了以后,它取代 DSH 自带的那句默认身份(“You are an AI agent powered by DeepSeek Harness.”);你已经在 DSH 里设过的系统人设(宿主设置里的人设,或当前预设自带的人设)不会被替换,原样保留,这里写的排在它后面;预设如果已经自己改写了那句默认身份,也按它写的保留,不会被盖掉。全部留空时什么都不改,沿用 DSH 的默认身份和你已有的人设,控制台不自动回填。DSH 里其余的系统提示(计划、工具和文件引用等说明)不动。
48
+ - **世界提示词**:你想对她说的话,以及她的世界的说明。
49
+ - **相册**:家会话可用 `keep_photo` 收藏本轮最新消息中的图片(含本轮已读取的微信图片和引用图),`list_photos` 分页查看说明,`forget_photo` 移除收藏。控制台顶部「相册」页查看照片,点开才加载图片;照片不会自动加入之后每轮上下文。旧相册首次打开时导入,原文件保留。
50
+ - **应用并压缩家会话**:人设和世界提示词页面里的热加载入口,操作方法见[注意事项](NOTES.md#修改人设和世界提示词后要手动应用)。
51
+ - **工作区权限**:选择世界工作区新建会话的默认权限,选项沿用宿主提供的权限预设,默认完全权限。保存后对新会话生效;已有会话及其手动权限不会被重新覆盖。
52
+ - **概览与记录**:她此刻在做什么、下个闹钟、近期记忆有多少轮、今天花了多少;还有活动记录、日记和压缩记录。
53
+ - **接入开关**:配置里启用了微信(`wechat: true`)或 QQ(`qqNative.enabled: true`)后,概览里有一张「接入」卡片,状态记在 `world.json`。微信开着才注册工具并拉起适配器(配了 `wechatAdapter` 时),关掉就撤掉;QQ 开着才加载通道,关掉就断开连接。微信和 QQ 都默认关,已经在用微信的世界升级后保持开着。首次手动开启 QQ 时,缺少 SnowLuma SDK 就按需安装,完成后提示重启 DSH;SDK 已就绪时直接切换,无需重启。
54
+ - **微信 / QQ 页面**:顶部各有一个独立入口,详细状态和设置不再挤在概览里。微信页查看连接、待发送与待核对数量,重启适配器并调整读取条数和消息缓冲;QQ 页管理 OneBot、白名单、静默和 SnowLuma。通道关闭或世界停止时,页面提示未开启。
55
+ - **归档范围**:默认 `workspace`,归档家所在工作区的普通会话,包含独立微信群会话;`home` 仅当前家会话。保存范围后提示重启,重启前沿用原范围。启动时分页回扫所选范围内的会话日志,按消息实际时间重选最近配置轮数,下次请求前替换旧记忆块;没有时间过期。旧归档保留,范围外记录不再注入。旧配置 `world` 迁为 `workspace`。
56
+ - **注入范围**:世界记忆、世界提示词、世界线工具和微信/QQ 通道仅进入世界工作区内匹配预设的普通会话,其他工作区即使用相同预设也不会收到。归档选为 `home` 时,同工作区的其他会话仍可读取家记忆。
57
+
58
+ > 对世界工作区以外的会话,只有两项有影响:控制台人设和只留对话的压缩。详情见 [注意事项](NOTES.md#对世界工作区以外的影响)。
59
+
60
+ ### 注意事项
61
+
62
+ 容易踩的地方都集中写在 [注意事项](NOTES.md),按主题分类。第一次装或升级之前,建议先看 [默认就会发生的事](NOTES.md#默认就会发生的事)。
63
+
64
+ - [安装与升级](NOTES.md#安装与升级):默认换用只留对话的压缩。
65
+ - [人设与提示词](NOTES.md#人设与提示词):改了以后要手动应用;控制台人设和 DSH 自带系统提示词怎么共存。
66
+ - [压缩与记忆](NOTES.md#压缩与记忆):什么时候自动压缩、每日回顾后自动压缩。
67
+ - [世界范围与会话](NOTES.md#世界范围与会话):对世界工作区以外的影响,以及“会话已离开世界工作区”怎么排查。
68
+ - [微信](NOTES.md#微信):支持的版本、账号风险、图片和表情包、@、退出重开。
69
+ - [QQ](NOTES.md#qq):SnowLuma SDK、群里默认只接被叫到的、看门狗。
70
+
71
+ ### 只留下你们之间的话的压缩
72
+
73
+ 对话太长需要压缩时,dsh-world 自带的压缩方式会去掉工具调用的过程,把你们之间的交流整理成一段摘要。她记住的是你,不是那些命令。装上插件后它默认就会换上,见 [注意事项](NOTES.md#默认就会发生的事)。
74
+
75
+ ### 桌宠和其他程序
76
+
77
+ dsh-world 开放了一个本地的「桥」:桌宠之类的程序可以把你说的话送进她的家,也可以接收她的回复和主动找你的话。协议见文末。
78
+
79
+ 微信作为独立模块接入同一个家,使用她的独立账号收发指定私聊或群聊。她可用 `wechat_chats` 查询已配置目标,用 `wechat_history` 主动分页查看群消息,无需等别人 @,历史里的图片用 `wechat_image` 按消息 ID 一张张看;读完以同一个 `chatId` 调用 `wechat_send` 自主联系对方或回复消息,文字、图片和表情共用同一发送队列;`wechat_delivery` 查询确认结果。普通最终回答不会自动转发到微信。Windows 适配器和配置步骤见 [微信模块](src/ecosystem/wechat/windows/README.md)。B 站尚未接入。
80
+
81
+ **群聊动静**:适配器在线时,已配置群里未 @ 她的消息只更新未读数、最后发言人和时间,不唤醒模型,也不把正文加入上下文。她原有的闹钟响起时,会附上一行群聊概况,包括未读消息或安静了多久;是否去看、是否发言,由她自己决定。成功读取群的最新一页后清零未读,自己的发言不计入未读;计数保存在适配器状态中,重启保留。插件不会改写你的 `alarm.md`、`world-prompt.md` 或「我是谁」。
82
+
83
+ 微信的支持版本、账号风险、图片与表情包、表情库、@、退出重开等注意事项,见 [注意事项·微信](NOTES.md#微信);首次接入与升级见 [注意事项·安装与升级](NOTES.md#微信首次接入与升级)。
84
+
85
+ > **QQ 走插件自己那条原生通道**:插件直接连 SnowLuma 提供的 OneBot WebSocket,自己收、自己发(代码在 [`src/ecosystem/qq-native/`](src/ecosystem/qq-native/index.ts)),中间没有第二个进程,也不需要别的 QQ 实现。SnowLuma 负责登录 QQ 并对外提供 OneBot 的 HTTP/WS 服务;它按自己的 EULA 不许被自动化脚本部署,装法与参数怎么拿见 [INSTALL.md](INSTALL.md)。这条通道的配置都在 profile 的 `cordis.patch.yml` 里(见下文「设置」),控制台上改过的设置存在世界目录的 `qq-native.json`。
86
+
87
+ 外部生态接入代码统一放在 [`src/ecosystem/`](src/ecosystem/README.md):`wechat/` 包含微信宿主模块、Windows 收发适配器和原生桥;`qq-native/` 是插件自己连 OneBot 的那条 QQ 通道(`qq/` 里是与它配套的控制台接口和 SnowLuma 控制台那扇门);`shared/` 保存通用身份协议、群会话路由与消息出口;`bridge/` 为桌宠等本地程序提供通用桥。后续平台在同一目录下独立扩展,核心记忆、人设和生活线保持独立。
88
+
89
+ 微信原生发送引擎单独适用非商业许可,详见该模块的许可说明。
90
+
91
+ ### QQ
92
+
93
+ QQ 走插件自己那条原生通道:直接连 SnowLuma 开出来的 OneBot WebSocket,收文本、发文本,中途没有别的进程。代码在 [`src/ecosystem/qq-native/`](src/ecosystem/qq-native/index.ts)。
94
+
95
+ QQ 的 SDK 依赖、群里默认只接被叫到的、看门狗,以及 QQ 的记忆和接入开关,见 [注意事项·QQ](NOTES.md#qq)。
96
+
97
+ 在 profile 的 `cordis.patch.yml` 里打开 `qqNative`(`enabled: true` 只是允许它存在)、填上 WS 地址与 token,再到控制台「概览 → 接入」把 QQ 拨开,切到顶部「QQ」页查看:连着哪个地址、收过几个会话、发过几条、挡下几条、排队待发几条、会自己回还是只看不回,一眼看到。页面里能直接拨「会自己回话 / 只看不回」,设「静默到某个时间点」(只收不回,到点自己醒),改私聊和群的白名单(留空就是谁都不收,改完不用重启),也能打开 SnowLuma 控制台、手动拉起 SnowLuma。这些改动记在世界目录的 `qq-native.json`,盖在配置之上。没配 `qqNative.enabled` 时,QQ 页提示通道未开启。
98
+
99
+ 参数不对不会崩,只会连不上:卡上会把原因写在 `lastError` 里(比如 `WS 错误: Unexpected server response: 401`,说明填的是 HTTP 那份 token,该换成 WebSocket 那份)。QQ 页在通道启用、世界已经开始时展示详细状态,其他时候提示未开启。
100
+
101
+ **她怎么说话**:同一会话 `batchQuietMs`(默认 10 秒)内连着来的几句攒成一条再问她(最多等 30 秒),群里每句前面带着是谁说的。她的回答按空行分成几条发,中间停一下;回话里写 `[[img:路径]]`、`[[face:id]]`、`[[at:QQ号]]` 会变成图片、QQ 表情和 @,`[[sticker:开心]]` 按备注挑一个收藏表情单发(也可以写第几个),`[[qzone:正文]]` 发一条所有人可见的 QQ 空间说说。发不出去的消息先排队,每 3 秒重试,最多留 5 分钟。她在家里自己开的那一轮(闹钟、世界线)说完的话,也会推一份给主人(`ownerQQ`,空着取 `allowPrivate` 的第一个);有人说话的轮次是在回那个人,不另推。
102
+
103
+ 卡上那个「打开 SnowLuma 控制台」的按钮,读 `snowlumaHome` 下 `config/runtime.json` 里的地址与端口,带着一次性登录票据打开系统浏览器——第一次要先填一次 SnowLuma 的面板密码,之后记在世界目录的 `panel.json` 里(权限 600),不用再输。
104
+
105
+ ## 安装
106
+
107
+ 需要 DSH 桌面版,世界控制台和生活线都依赖它。
108
+
109
+ **最省事的办法**:把这个仓库地址交给她,让她照 [INSTALL.md](INSTALL.md) 自己装。那份说明是写给模型看的——每一步都有命令、判定和失败对照表,连同 QQ 怎么接进来、哪两个动作必须人来做,一路写到底。
110
+
111
+ **自己装**:`dsh-world` 已发布到 npm。在你的 DSH profile 目录用 DSH 自带的 pnpm 安装:
112
+
113
+ ```powershell
114
+ node <DSH 自带 pnpm 的入口文件> add dsh-world@latest --ignore-scripts --registry=https://registry.npmjs.org/
115
+ ```
116
+
117
+ 装好后按 [安装说明](INSTALL.md#第一步把-dsh-world-装进-profile) 在 profile 里登记 bundle,重启 DSH,打开设置里的「世界控制台」,按需填写人设,按「开始」。
118
+
119
+ 想用仓库源码时,执行 `npm ci`、`npm pack`,再用同一个 pnpm 把生成的 `dsh-world-*.tgz` 装进 profile;也可从 [CI](.github/workflows/ci.yml) 对应运行的 Artifacts 下载检查通过的编译安装包,Windows 和 Linux 分别提供产物。不要用 `link:` 指向项目目录,否则会加载项目自己的一份 Cordis。本机复现检查的命令见 [贡献协议](CONTRIBUTING.md#ci-与安装包验证)。
120
+
121
+ **已有 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用编译包更新)。
122
+
123
+ **只留对话的压缩**:装好 `dsh-world` 后第一次启动,默认会把 profile 的压缩换成 `dsh-world/compaction`(先备份,重启 DSH 后生效),整个 profile 的会话压缩都会受影响。怎么关、怎么手动启用,见 [注意事项·安装与升级](NOTES.md#安装与升级)。
124
+
125
+ ## 设置
126
+
127
+ 大多数东西在世界控制台里改。其余的写在 profile 的 `cordis.patch.yml` 里,按 id 覆盖插件那一行,只写想改的项:
128
+
129
+ ```yaml
130
+ - id: dsh-world
131
+ name: dsh-world
132
+ config:
133
+ companionName: 小鱼 # 她的名字(控制台人设里写了名字时以人设为准),默认 TA
134
+ partnerName: 伙伴 # 她对你的称呼,默认 伙伴
135
+ worldId: default # 世界名;换一个就是另一个世界、另一份记忆
136
+ agentPreset: standard # 她所在的预设
137
+ timeZone: Asia/Seoul # 默认系统时区
138
+ life: true # 生活线,默认开启
139
+ replaceCompaction: true # 首次启动把 profile 的压缩换成 dsh-world 的只留对话压缩;false = 不动
140
+ archiveScope: workspace # workspace:家的工作区;home:仅当前家会话
141
+ fallbackWakeTime: '09:00' # 没定闹钟时,早上几点叫醒她
142
+ diaryDir: C:/path/to/日记 # 日记目录,默认在世界目录里
143
+ toast: true # 主动找你时发 Windows 系统通知
144
+ # toastAppId: com.deepseek.dsh # 通知身份,默认在开始菜单里找 DSH 桌面版(com.deepseek.dsh 或 electron.app.DeepSeek Harness)
145
+ bridge: false # 打开本地的桥
146
+ wechat: false # 打开独立微信接口,需另行启动 Windows 适配器
147
+ outlets: [] # 接收她的话的本地程序,见文末
148
+ allowedHosts: [] # 通过反向代理从局域网访问控制台时,放行的域名或 IP
149
+ qqNative: # 插件自己连 OneBot(原生通道);不写这一块就是不接 QQ
150
+ enabled: false # 打开通道:连上、控制台里出 QQ 卡
151
+ wsUrl: ws://127.0.0.1:3003 # OneBot 的 WS 服务地址(不是 HTTP 那个)
152
+ accessToken: '' # OneBot WS 服务端自己的 token,与 HTTP 那份不是一码事
153
+ allowPrivate: [] # 谁能私聊她;留空 = 谁都不理
154
+ ownerQQ: '' # 她自己开口的话推给谁;空着取 allowPrivate 的第一个
155
+ allowGroups: [] # 群白名单
156
+ autoReply: true # false = 只看不回
157
+ contextMessages: 6 # 每轮带上最近的几条
158
+ batchQuietMs: 10000 # 同一会话这几毫秒内的话攒成一条问她;0 = 一条一问
159
+ groupTrigger: mention # mention:@ 她/引用她/命中关键词才接;all:每句都接
160
+ groupKeywords: [] # groupTrigger: mention 时算「在叫她」的词
161
+ mutedUntil: '' # 静默到这个时间(ISO):只收不回,到点自己醒
162
+ bindHomeSession: owner # owner:主人私聊用家会话、群各自独立;all:都用;none:各建一个
163
+ snowlumaHome: '' # SnowLuma 安装目录:控制台那扇门、看门狗和「拉起 SnowLuma」都靠它
164
+ supervise: true # 看门狗:端口不通就把 SnowLuma 拉起来
165
+ ```
166
+
167
+ **压缩的配置**写在压缩那一行的 `config` 里(profile 的 `cordis.patch.yml` 中 `name: 'dsh-world/compaction'` 那一条),不是上面 `dsh-world` 这一行:
168
+
169
+ ```yaml
170
+ - id: compaction-basic
171
+ name: 'dsh-world/compaction'
172
+ config:
173
+ thresholdRatio: 0.75 # 用量超过上下文窗口的这个比例就压缩,默认 0.75
174
+ defaultContextWindow: 1048576 # 适配器没声明窗口的模型按这个估算,默认 1M
175
+ auto: true # false = 只手动压缩(「应用并压缩家会话」仍可用)
176
+ # maxTokens: 65536 # 压缩时摘要回复的长度上限
177
+ # headroomTokens: 65536 # 不再影响触发点;只在没写 maxTokens 时当作摘要回复的长度
178
+ # maxOverflowRetries: 1 # 请求被模型以“超出窗口”拒绝后,压缩重试的次数
179
+ # modelPolicies: [] # 按 provider/model 单独写上面的项,例如给一个窗口只有 128k 的自建模型写 defaultContextWindow
180
+ ```
181
+
182
+ 触发点怎么算、窗口值从哪来,见 [注意事项](NOTES.md#自动压缩什么时候触发)。
183
+
184
+ **长期记忆的查找**(`memory_find`、`memory_read`,控制台「档案」页同源):
185
+
186
+ - 不建索引:聊天在 `archive.sqlite` 的原表里直接按字面扫描,日记在查询时直接读文件;自述照旧在每次开始对话时全文放进她的提示里,不进查找。
187
+ - `memory_find` 参数:`query`(原文里的一小段字面文字,区分大小写,不是 SQL 或搜索语法;不填就按时间翻页)、`kinds`(`conversation`、`diary`)、`from`/`to`(带时区的 ISO 时间,左闭右开,日期请换成当天零点)、`sourceId`、`turnId`(取同一轮)、`order`、`limit`(工具里默认 8,最多 100)、`cursor`。工具返回 `items`(`ref`、`time`、`kind`、`who`、`text`,摘录约 200 字)和 `nextCursor`;有来源没能读到时才带 `coverage`(`state`:`partial`,`failures`)。控制台的同源接口返回更完整的字段。`timeBasis`:聊天是发言时间,日记是日记日期,其他文件是最后改动的时间。
188
+ - `memory_read` 参数:`ref`、`offset`(按字,默认 0)、`limit`(工具里默认 2000,最多 16000)。返回原文的一段,不是摘要,按字符分页,不会切坏一个字。聊天被修订后,旧 `ref` 报 `sourceChanged`;程序不保留旧正文。
189
+ - `ref` 由程序生成,别手写。能解析只说明找得到出处,不说明出处支持结论。
190
+ - 范围:聊天原文严格按「记忆归档范围」过滤,范围外的聊天不会出现在结果、摘录、翻页或状态里;她自己写下的日记不受这条限制。游标绑定查询条件和范围,资料变化后返回 `cursorExpired`,要重新查。
191
+
192
+ **改她的措辞**:世界提示词可以直接在控制台里改。闹钟响时、提前停下时、每日回顾时她收到的话,在世界目录里放一份 `alarm.md` 就能按段覆盖,段落名和可用的占位符见 `templates/alarm.md`。插件写给她的话一律用第一人称「我」,读起来是她自己的念头。
193
+
194
+ **时间**:建议把预设里 `time-context` 条目的 `refreshIntervalMs` 设为 `0`,让她每一步都知道现在几点。
195
+
196
+ ## 她的东西放在哪
197
+
198
+ 都在 `<DSH_HOME>/worlds/<worldId>/` 下(`DSH_HOME` 默认是用户目录下的 `.dsh`):
199
+
200
+ | 位置 | 是什么 |
201
+ |---|---|
202
+ | `conversations/` | 按天归档的聊天原文(给人看的导出,正本在 `archive.sqlite`) |
203
+ | `room/` | 她的房间;`room/我是谁.md` 是她的自述 |
204
+ | `diary/` | 她的日记(可用 `diaryDir` 换位置) |
205
+ | `persona.md`、`world-prompt.md`、`alarm.md` | 你写给她的人设、世界提示词和闹钟措辞 |
206
+ | `world.json` | 世界是否在运行、每天额度、近期记忆轮数和选定归档范围 |
207
+ | `activity/` | 她在家里用过的工具,只记录,不进记忆 |
208
+ | `photos/album.sqlite` | 收藏的图片、说明与标签;首次导入旧相册后仍保留原文件 |
209
+ | `wechat.json` | 本机微信模块的地址、令牌和协议版本,不应公开 |
210
+ | `wechat-outbox.sqlite` | 微信工具安排的发送队列和确认状态 |
211
+ | `qq-native.json` | 控制台上 QQ 卡改过的设置(会不会自己回话、静默到几点、白名单、阳台端口),盖在 profile 默认之上 |
212
+ | `panel.json` | SnowLuma 控制台那扇门的登录票据,权限 600,不应公开 |
213
+
214
+ 备份时整个目录一起备份即可,最好先停止 DSH。
215
+
216
+ ## 桥与推送协议
217
+
218
+ 给桌宠等本地程序用。
219
+
220
+ **把话送进她的家**(`bridge: true`):插件启动时写出 `<世界目录>/bridge.json`,内容是 `{ origin, token, name, ... }`。向 `POST {origin}/dsh-world/bridge/say` 发 `{ "text": "..." }`,请求头带 `x-dsh-world-token: <token>`,会立即返回 `202`。这句话会作为你本人说的话进入她的家和记忆。
221
+
222
+ **接收她的话**(`outlets`):每个目标写一个 `name`,地址用 `url`(其中 `{origin}` 会被替换),或者用 `urlFile` + `path`(端口会变的程序用这个);再用 `kinds` 选择要接收哪些:`reply` 是桥上那句话的回复,`busy` 表示她正忙,`reach` 是她主动找你。插件会向目标 `POST`:
223
+
224
+ ```json
225
+ { "text": "她的话(纯文本)", "kind": "reply", "name": "她的名字", "images": ["http://…"], "image": "表情名" }
226
+ ```
227
+
228
+ 目标回复 2xx 就算送到。送不到的会显示在控制台的「健康」里。
229
+
230
+ ## 参与贡献
231
+
232
+ **PR 统一提到 `dev` 分支**,`main` 由维护者从 `dev` 并入后发布,详见 [贡献协议](CONTRIBUTING.md#分支与-pr)。新增 QQ、B 站等生态模块前,请阅读 [贡献协议](CONTRIBUTING.md):平台代码放在 `src/ecosystem/<channel>/`,复用统一身份、会话和归档能力;涉及内核的修改必须说明原因、影响、兼容性与验证结果。几条硬性要求:一个 PR 只做一件事;平台 SDK 只能是可选依赖,模块默认关闭,新依赖要先开 Issue;她的主动性来自她自己的安排,插件不往对话里推提醒,改动生活线核心或给她新增工具之前先开 Issue 讨论。
233
+
234
+ ## 许可
235
+
236
+ MIT