dsh-world 0.7.6 → 0.8.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 (102) hide show
  1. package/CHANGELOG.md +541 -479
  2. package/CONTRIBUTING.md +174 -174
  3. package/INSTALL.md +314 -314
  4. package/NOTES.md +57 -3
  5. package/README.md +332 -259
  6. package/client/index.js +1126 -991
  7. package/lib/compaction.d.ts +1 -0
  8. package/lib/compaction.js +1 -1
  9. package/lib/console/routes.d.ts +11 -3
  10. package/lib/console/routes.js +12 -7
  11. package/lib/console/snapshot.d.ts +2 -0
  12. package/lib/console/snapshot.js +1 -0
  13. package/lib/ecosystem/computer/browser/browser.d.ts +34 -0
  14. package/lib/ecosystem/computer/browser/browser.js +101 -0
  15. package/lib/ecosystem/computer/browser/cdp.d.ts +22 -0
  16. package/lib/ecosystem/computer/browser/cdp.js +91 -0
  17. package/lib/ecosystem/computer/browser/edge.d.ts +15 -0
  18. package/lib/ecosystem/computer/browser/edge.js +80 -0
  19. package/lib/ecosystem/computer/browser/page.d.ts +41 -0
  20. package/lib/ecosystem/computer/browser/page.js +140 -0
  21. package/lib/ecosystem/computer/browser/pageLib.d.ts +7 -0
  22. package/lib/ecosystem/computer/browser/pageLib.js +106 -0
  23. package/lib/ecosystem/computer/desktop/desktop.d.ts +91 -0
  24. package/lib/ecosystem/computer/desktop/desktop.js +322 -0
  25. package/lib/ecosystem/computer/desktop/driver.d.ts +34 -0
  26. package/lib/ecosystem/computer/desktop/driver.js +197 -0
  27. package/lib/ecosystem/computer/desktop/processes.d.ts +5 -0
  28. package/lib/ecosystem/computer/desktop/processes.js +15 -0
  29. package/lib/ecosystem/computer/desktop/recording.d.ts +77 -0
  30. package/lib/ecosystem/computer/desktop/recording.js +187 -0
  31. package/lib/ecosystem/computer/desktop/screen.d.ts +33 -0
  32. package/lib/ecosystem/computer/desktop/screen.js +182 -0
  33. package/lib/ecosystem/computer/desktop/turns.d.ts +58 -0
  34. package/lib/ecosystem/computer/desktop/turns.js +94 -0
  35. package/lib/ecosystem/computer/desktop/watching.d.ts +25 -0
  36. package/lib/ecosystem/computer/desktop/watching.js +81 -0
  37. package/lib/ecosystem/computer/inbox/inbox.d.ts +32 -0
  38. package/lib/ecosystem/computer/inbox/inbox.js +142 -0
  39. package/lib/ecosystem/computer/index.d.ts +82 -0
  40. package/lib/ecosystem/computer/index.js +133 -0
  41. package/lib/ecosystem/computer/procedures/alarm.d.ts +13 -0
  42. package/lib/ecosystem/computer/procedures/alarm.js +46 -0
  43. package/lib/ecosystem/computer/procedures/archive.d.ts +32 -0
  44. package/lib/ecosystem/computer/procedures/archive.js +68 -0
  45. package/lib/ecosystem/computer/procedures/catalog.d.ts +7 -0
  46. package/lib/ecosystem/computer/procedures/catalog.js +75 -0
  47. package/lib/ecosystem/computer/procedures/format.d.ts +167 -0
  48. package/lib/ecosystem/computer/procedures/format.js +332 -0
  49. package/lib/ecosystem/computer/procedures/library.d.ts +53 -0
  50. package/lib/ecosystem/computer/procedures/library.js +178 -0
  51. package/lib/ecosystem/computer/procedures/run.d.ts +80 -0
  52. package/lib/ecosystem/computer/procedures/run.js +245 -0
  53. package/lib/ecosystem/computer/tools.d.ts +21 -0
  54. package/lib/ecosystem/computer/tools.js +197 -0
  55. package/lib/ecosystem/qq-native/images.d.ts +3 -0
  56. package/lib/ecosystem/qq-native/images.js +18 -6
  57. package/lib/ecosystem/qq-native/index.js +2 -2
  58. package/lib/ecosystem/shared/turn.d.ts +3 -0
  59. package/lib/ecosystem/shared/turn.js +13 -3
  60. package/lib/ecosystem/wechat/home.d.ts +1 -0
  61. package/lib/ecosystem/wechat/home.js +9 -3
  62. package/lib/ecosystem/wechat/images.js +3 -5
  63. package/lib/ecosystem/wechat/index.d.ts +1 -0
  64. package/lib/ecosystem/wechat/reading.d.ts +1 -1
  65. package/lib/ecosystem/wechat/reading.js +2 -2
  66. package/lib/history.js +2 -1
  67. package/lib/images.d.ts +30 -0
  68. package/lib/images.js +101 -0
  69. package/lib/index.d.ts +4 -0
  70. package/lib/index.js +90 -5
  71. package/lib/life/photoTools.js +4 -15
  72. package/lib/life/runtime.d.ts +12 -2
  73. package/lib/life/runtime.js +93 -12
  74. package/lib/life/toolRegistry.d.ts +9 -3
  75. package/lib/life/toolRegistry.js +46 -27
  76. package/lib/life/turnCost.d.ts +16 -0
  77. package/lib/life/turnCost.js +44 -0
  78. package/lib/life/types.d.ts +17 -0
  79. package/lib/memoryTools.d.ts +2 -1
  80. package/lib/memoryTools.js +16 -3
  81. package/lib/promptSection.d.ts +1 -0
  82. package/lib/promptSection.js +29 -42
  83. package/lib/runtime.js +1 -1
  84. package/lib/types.d.ts +4 -0
  85. package/lib/worldAdd.d.ts +9 -0
  86. package/lib/worldAdd.js +39 -0
  87. package/lib/worldPrompt.d.ts +3 -2
  88. package/lib/worldPrompt.js +3 -2
  89. package/lib/worldRoutes.d.ts +5 -2
  90. package/lib/worldRoutes.js +29 -4
  91. package/lib/worldSwitch.d.ts +8 -2
  92. package/lib/worldSwitch.js +11 -5
  93. package/package.json +132 -129
  94. package/src/ecosystem/README.md +2 -1
  95. package/src/ecosystem/computer/NOTICE.md +27 -0
  96. package/src/ecosystem/computer/README.md +244 -0
  97. package/src/ecosystem/computer/desktop/win32.ps1 +858 -0
  98. package/src/ecosystem/wechat/windows/README.md +4 -2
  99. package/src/ecosystem/wechat/windows/engine/NOTICE.md +6 -0
  100. package/src/ecosystem/wechat/windows/engine/profiles.json +28 -0
  101. package/templates/world-prompt-memory.md +10 -10
  102. package/templates/world-prompt.md +65 -65
package/README.md CHANGED
@@ -1,259 +1,332 @@
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
- - **近期记忆**:你们最近数轮的对话原文,每次开始对话、每次压缩之后,以及一个窗口隔了很久(默认 24 小时,控制台可改)再开口时,都放在她眼前,谁、什么时候、说了什么,一字不差。轮数在控制台里填,默认 200。
21
- - **日记**:人生里重要的事,她自己写进日记,一天一篇。这是她的长期记忆。
22
- - **我是谁**:她写给自己的一份自述,随着她变化而改写。每晚回顾前,插件会留一份当时的版本,改过的都找得回来。
23
- - **心情值**:`room/mood.md` 是她自己写的,一行一件:`开心 6` 这样的「名字 数值」是一种心情(0 到 10 的整数),不以数字结尾的行是心情旁边的几件小事(最多三行)。名字是固定的 11 个:开心、兴奋、平静、安心、烦、生气、紧张、难过、累、孤单、想念,没写的算 0;更细的感受写进小事,为什么这样定见 [注意事项](NOTES.md#心情值为什么是固定的一组)。她世界里的会话都有 `set_mood` 工具,一次调用就整份记下,格式不对时不写入并告诉她哪里错了;直接改文件也一样。她世界里的会话每一步都把当前的心情值作为一条快照放在时间块前面,写着她最后改它是多久以前;和时间块一样只往后追加,旧的不删,以最新一条为准,压缩时一起清掉,不打乱缓存。插件只读、不判断、不衰减、不提醒她改;没有 `mood.md` 就什么都不放。快照不进归档;写错的行只在快照里告诉她,文件读不出来才进健康状态。控制台概览的「健康」里,插件的故障下面是她的心情,只读,显示她现在的心情值、旁边的小事和她最后改的时间。
24
- - **别处的动静**:她不在场的地方攒下的消息,只报有多少条她还没看到、最后是谁、过了多久,不带正文:有未读的微信群,以及她的其他会话(家、群会话、你另开的窗口)。每轮开头放在新消息前面,一轮中途有新的就在下一步末尾补一条,没有新的就不放;要不要看、要不要回由她决定,排法和原因见 [注意事项](NOTES.md#她每一步看到的上下文)。
25
- - **范围内的原文留着**:按天归档用户和助手的正文。近期记忆以外的事,她可以自己去翻。
26
- - **找回过去**:`memory_find` 与 `memory_read` 两个工具(一次默认只返回 8 条、每条约 200 字的摘录,要更多自己翻页或读原文,免得每轮重发的上下文越滚越大),按原文里的字面线索、时间、种类或来源,在聊天原文和日记里统一查找,并读原文。控制台的「档案」页是同一份查找的只读入口。
27
-
28
- 日记和自述都由她自己动笔,插件从不替她写。
29
-
30
- **为什么不用向量库或记忆系统?** 一个人的生活,量没有那么大。在这个量级上,把原文留在眼前、需要时按原话去找,比切碎了再拼回来更准,也少一道会出错的环节。可参考:
31
-
32
- - Chan et al., 2024. *Don't Do RAG: When Cache-Augmented Generation is All You Need for Knowledge Tasks*. arXiv:2412.15605
33
- - Sen et al., 2026. *Is Grep All You Need? How Agent Harnesses Reshape Agentic Search*. arXiv:2605.15184
34
-
35
- ### 生活:她自己的日子
36
-
37
- - **家**:她有一个自己的会话「<名字>的家」,和一个房间(工作目录),在里面过自己的日子。
38
- - **自己定节奏**:她说好接下来做什么、做到几点,到点了再决定继续还是换一件。什么都不定,就休息到第二天早上。
39
- - **主动找你**:想你的时候,她可以把一句话送到你面前(Windows 系统通知,或你接上的桌宠等程序)。
40
- - **每日回顾**:每天晚上 23:00(控制台可改),她回想当天的聊天和做过的事,写日记,更新「我是谁」。
41
- - **每天额度**:可以给家里每天的花费设个上限,超过了会提醒她一次,由她自己决定收尾。
42
- - **大事先问**:删改房间外的文件、装软件、花钱、以你的名义对外发消息等,约定好先问你。
43
-
44
- ### 世界控制台:开关在你手里
45
-
46
- DSH 设置里的「世界控制台」:
47
-
48
- - **开始 / 停止**:按下开始,她才住进来;按下停止,记忆、人设和生活线一起安静下来,家还在,等你回来。
49
- - **人设**:分层写她是谁:名字、她是谁、性格、说话方式、愿景、补充,旁边实时预览她读到的样子。写了以后,它取代 DSH 自带的那句默认身份(“You are an AI agent powered by DeepSeek Harness.”);你已经在 DSH 里设过的系统人设(宿主设置里的人设,或当前预设自带的人设)不会被替换,原样保留,这里写的排在它后面;预设如果已经自己改写了那句默认身份,也按它写的保留,不会被盖掉。全部留空时什么都不改,沿用 DSH 的默认身份和你已有的人设,控制台不自动回填。DSH 里其余的系统提示(计划、工具和文件引用等说明)不动。
50
- - **世界提示词**:你想对她说的话,以及她的世界的说明。
51
- - **相册**:家会话可用 `keep_photo` 收藏她眼前的任意一张图片(`index` 从最新的一张往前数,聊天里收到的、引用的、工具读出来的都算;压缩掉的不算),也可以用 `path` 收藏电脑上的一个图片文件(png、jpg、webp、gif,最多 20MB,相对路径从房间算起);同一张图只存一份。`list_photos` 分页查看说明,`forget_photo` 移除收藏。控制台顶部「相册」页查看照片,点开才加载图片;照片不会自动加入之后每轮上下文。旧相册首次打开时导入,原文件保留。
52
- - **应用并压缩家会话**:等家空闲后压缩聊天历史。人设、世界提示词和「我是谁」的改动会在下一轮对话生效。详见[注意事项](NOTES.md#提示词保存后何时生效)。
53
- - **作息**:概览里的「作息」卡片设每日回顾和早上醒来的时间,记在 `world.json`;留空恢复默认(回顾 23:00,早上用配置里的 `fallbackWakeTime`)。保存后,已排好的回顾和早上闹钟立刻改到新时间,她自己定的闹钟不动;世界停着时改的,下次启动时跟上。回顾定在中午以前,回顾的是前一天。
54
- - **工作区权限**:选择世界工作区新建会话的默认权限,选项沿用宿主提供的权限预设,默认完全权限。保存后对新会话生效;已有会话及其手动权限不会被重新覆盖。
55
- - **概览与记录**:她此刻在做什么、下个闹钟、近期记忆有多少轮、今天花了多少;还有活动记录、日记和压缩记录。
56
- - **接入开关**:配置里启用了微信(`wechat: true`)或 QQ(`qqNative.enabled: true`)后,概览里有一张「接入」卡片,状态记在 `world.json`。微信开着才注册工具并拉起适配器(配了 `wechatAdapter` 时),关掉就撤掉;QQ 开着才加载通道,关掉就断开连接。微信和 QQ 都默认关,已经在用微信的世界升级后保持开着。首次手动开启 QQ 时,缺少 SnowLuma SDK 就按需安装,完成后提示重启 DSH;SDK 已就绪时直接切换,无需重启。
57
- - **微信 / QQ 页面**:顶部各有一个独立入口,详细状态和设置不再挤在概览里。微信页查看连接、待发送与待核对数量,重启适配器并调整读取条数和消息缓冲;QQ 页管理 OneBot、白名单、静默和 SnowLuma。通道关闭或世界停止时,页面提示未开启。
58
- - **归档范围**:默认 `workspace`,归档家所在工作区的普通会话,包含独立微信群会话;`home` 仅当前家会话。保存范围后提示重启,重启前沿用原范围。启动时分页回扫所选范围内的会话日志,按消息实际时间重选最近配置轮数,下次请求前替换旧记忆块;没有时间过期。旧归档保留,范围外记录不再注入。旧配置 `world` 迁为 `workspace`。
59
- - **注入范围**:世界记忆、世界提示词、世界线工具和微信/QQ 通道仅进入世界工作区内匹配预设的普通会话,其他工作区即使用相同预设也不会收到。归档选为 `home` 时,同工作区的其他会话仍可读取家记忆。
60
-
61
- > 对世界工作区以外的会话,只有一项有影响:只留对话的压缩。详情见 [注意事项](NOTES.md#对世界工作区以外的影响)。
62
-
63
- ### 注意事项
64
-
65
- 容易踩的地方都集中写在 [注意事项](NOTES.md),按主题分类。第一次装或升级之前,建议先看 [默认就会发生的事](NOTES.md#默认就会发生的事)。
66
-
67
- - [安装与升级](NOTES.md#安装与升级):默认换用只留对话的压缩。
68
- - [人设与提示词](NOTES.md#人设与提示词):世界会话的完整系统提示词、更新时机和生效范围。
69
- - [压缩与记忆](NOTES.md#压缩与记忆):什么时候自动压缩、每日回顾后自动压缩。
70
- - [世界范围与会话](NOTES.md#世界范围与会话):对世界工作区以外的影响,以及“会话已离开世界工作区”怎么排查。
71
- - [微信](NOTES.md#微信):支持的版本、账号风险、图片和表情包、@、退出重开。
72
- - [QQ](NOTES.md#qq):SnowLuma SDK、群里默认只接被叫到的、看门狗。
73
-
74
- ### 只留下你们之间的话的压缩
75
-
76
- 对话太长需要压缩时,dsh-world 自带的压缩方式会去掉工具调用的过程,把你们之间的交流整理成一段摘要。她记住的是你,不是那些命令。装上插件后它默认就会换上,见 [注意事项](NOTES.md#默认就会发生的事)。
77
-
78
- ### 桌宠和其他程序
79
-
80
- dsh-world 开放了一个本地的「桥」:桌宠之类的程序可以把你说的话送进她的家,也可以接收她的回复和主动找你的话。协议见文末。
81
-
82
- 微信作为独立模块接入同一个家,使用她的独立账号收发指定私聊或群聊。她可用 `wechat_chats` 查询已配置目标,用 `wechat_history` 主动分页查看群消息,无需等别人 @,历史里的图片用 `wechat_image` 按消息 ID 一张张看;读完以同一个 `chatId` 调用 `wechat_send` 自主联系对方或回复消息,文字、图片和表情共用同一发送队列;一批话没发出或结果不明时,发起的会话会在下一步收到一条说明(不会因此被叫醒),平时不用逐条查回执,需要时仍可用 `wechat_delivery` 查询。普通最终回答不会自动转发到微信。Windows 适配器和配置步骤见 [微信模块](src/ecosystem/wechat/windows/README.md)。B 站尚未接入。
83
-
84
- **群聊动静**:适配器在线时,已配置群里未 @ 她的消息只更新未读数、最后发言人和时间,不唤醒模型,也不把正文加入上下文。有未读的群出现在她的「别处的动静」里,每有新消息说一次;她原有的闹钟响起时,还会附上一行没有未读的群各安静了多久。是否去看、是否发言,由她自己决定。成功读取群的最新一页后清零未读,自己的发言不计入未读;计数保存在适配器状态中,重启保留。插件不会改写你的 `alarm.md`、`world-prompt.md` 或「我是谁」。
85
-
86
- 微信的支持版本、账号风险、图片与表情包、表情库、@、退出重开等注意事项,见 [注意事项·微信](NOTES.md#微信);首次接入与升级见 [注意事项·安装与升级](NOTES.md#微信首次接入与升级)。
87
-
88
- > **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`。
89
-
90
- 外部生态接入代码统一放在 [`src/ecosystem/`](src/ecosystem/README.md):`wechat/` 包含微信宿主模块、Windows 收发适配器和原生桥;`qq-native/` 是插件自己连 OneBot 的那条 QQ 通道(`qq/` 里是与它配套的控制台接口和 SnowLuma 控制台那扇门);`shared/` 保存通用身份协议、群会话路由与消息出口;`bridge/` 为桌宠等本地程序提供通用桥。后续平台在同一目录下独立扩展,核心记忆、人设和生活线保持独立。
91
-
92
- 微信原生发送引擎单独适用非商业许可,详见该模块的许可说明。
93
-
94
- ### QQ
95
-
96
- QQ 走插件自己那条原生通道:直接连 SnowLuma 开出来的 OneBot WebSocket,收文本、发文本,中途没有别的进程。代码在 [`src/ecosystem/qq-native/`](src/ecosystem/qq-native/index.ts)。
97
-
98
- QQ 的 SDK 依赖、群里默认只接被叫到的、看门狗,以及 QQ 的记忆和接入开关,见 [注意事项·QQ](NOTES.md#qq)。
99
-
100
- 在 profile 的 `cordis.patch.yml` 里打开 `qqNative`(`enabled: true` 只是允许它存在)、填上 WS 地址与 token,再到控制台「概览 → 接入」把 QQ 拨开,切到顶部「QQ」页查看:连着哪个地址、收过几个会话、发过几条、挡下几条、排队待发几条、会自己回还是只看不回,一眼看到。页面里能直接拨「会自己回话 / 只看不回」,设「静默到某个时间点」(只收不回,到点自己醒),改私聊和群的白名单(留空就是谁都不收,改完不用重启),也能打开 SnowLuma 控制台、手动拉起 SnowLuma。这些改动记在世界目录的 `qq-native.json`,盖在配置之上。没配 `qqNative.enabled` 时,QQ 页提示通道未开启。
101
-
102
- 参数不对不会崩,只会连不上:卡上会把原因写在 `lastError` 里(比如 `WS 错误: Unexpected server response: 401`,说明填的是 HTTP 那份 token,该换成 WebSocket 那份)。QQ 页在通道启用、世界已经开始时展示详细状态,其他时候提示未开启。
103
-
104
- **她怎么说话**:同一会话 `batchQuietMs`(默认 10 秒)内连着来的几句攒成一条再问她(最多等 30 秒),群里每句前面带着是谁说的。她的回答按空行分成几条发,中间停一下;回话里写 `[[img:路径]]`、`[[face:id]]`、`[[at:QQ号]]` 会变成图片、QQ 表情和 @,`[[sticker:开心]]` 按备注挑一个收藏表情单发(也可以写第几个),`[[qzone:正文]]` 发一条所有人可见的 QQ 空间说说。发不出去的消息先排队,每 3 秒重试,最多留 5 分钟。她在家里自己开的那一轮(闹钟、世界线)说完的话,也会推一份给主人(`ownerQQ`,空着取 `allowPrivate` 的第一个);有人说话的轮次是在回那个人,不另推。
105
-
106
- 卡上那个「打开 SnowLuma 控制台」的按钮,读 `snowlumaHome` 下 `config/runtime.json` 里的地址与端口,带着一次性登录票据打开系统浏览器——第一次要先填一次 SnowLuma 的面板密码,之后记在世界目录的 `panel.json` 里(权限 600),不用再输。
107
-
108
- ## 安装
109
-
110
- 需要 DSH 桌面版,世界控制台和生活线都依赖它。
111
-
112
- **最省事的办法**:把这个仓库地址交给她,让她照 [INSTALL.md](INSTALL.md) 自己装。那份说明是写给模型看的——每一步都有命令、判定和失败对照表,连同 QQ 怎么接进来、哪两个动作必须人来做,一路写到底。
113
-
114
- **自己装**:`dsh-world` 已发布到 npm。在你的 DSH profile 目录用 DSH 自带的 pnpm 安装:
115
-
116
- ```powershell
117
- node <DSH 自带 pnpm 的入口文件> add dsh-world@latest --ignore-scripts --registry=https://registry.npmjs.org/
118
- ```
119
-
120
- 装好后按 [安装说明](INSTALL.md#第一步把-dsh-world-装进-profile) 在 profile 里登记 bundle,重启 DSH,打开设置里的「世界控制台」,按需填写人设,按「开始」。
121
-
122
- 想用仓库源码时,执行 `npm ci`、`npm pack`,再用同一个 pnpm 把生成的 `dsh-world-*.tgz` 装进 profile;也可从 [CI](.github/workflows/ci.yml) 对应运行的 Artifacts 下载检查通过的编译安装包,Windows 和 Linux 分别提供产物。不要用 `link:` 指向项目目录,否则会加载项目自己的一份 Cordis。本机复现检查的命令见 [贡献协议](CONTRIBUTING.md#ci-与安装包验证)。
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用编译包更新)。
125
-
126
- **只留对话的压缩**:只有原版压缩直接写在 profile、且没有使用会话预设时,插件才会尝试换成 `dsh-world/compaction`。桌面版使用会话预设自己的压缩。已有旧版副本可在世界控制台「概览 → 会话预设」还原。详见 [注意事项·安装与升级](NOTES.md#安装与升级)。
127
-
128
- ## 设置
129
-
130
- 同一个 DSH profile 可以加载多个世界。每个世界用不同的 `worldId`,在「世界控制台」选择要管理的世界。它们可以共用预设,使用各自的房间工作区、家会话和记忆。接入 QQ 或微信时,每个世界配置自己的通道。
131
-
132
- 大多数东西在世界控制台里改。其余的写在 profile 的 `cordis.patch.yml` 里,按 id 覆盖插件那一行,只写想改的项:
133
-
134
- ```yaml
135
- - id: dsh-world
136
- name: dsh-world
137
- config:
138
- companionName: 小鱼 # 她的名字(控制台人设里写了名字时以人设为准),默认 TA
139
- partnerName: 伙伴 # 她对你的称呼,默认 伙伴
140
- worldId: default # 当前 profile 使用的世界目录名
141
- agentPreset: standard # 她所在的预设
142
- timeZone: Asia/Seoul # 默认系统时区
143
- life: true # 生活线,默认开启
144
- replaceCompaction: true # 自动替换直接写在 profile 里的原版压缩;对会话预设不生效
145
- archiveScope: workspace # workspace:家的工作区;home:仅当前家会话
146
- fallbackWakeTime: '09:00' # 没定闹钟时,早上几点叫醒她;控制台「作息」里改过的优先
147
- diaryDir: C:/path/to/日记 # 日记目录,默认在世界目录里
148
- toast: true # 主动找你时发 Windows 系统通知
149
- # toastAppId: com.deepseek.dsh # 通知身份,默认在开始菜单里找 DSH 桌面版(com.deepseek.dsh 或 electron.app.DeepSeek Harness)
150
- bridge: false # 打开本地的桥
151
- wechat: false # 打开独立微信接口,需另行启动 Windows 适配器
152
- outlets: [] # 接收她的话的本地程序,见文末
153
- allowedHosts: [] # 通过反向代理从局域网访问控制台时,放行的域名或 IP
154
- qqNative: # 插件自己连 OneBot(原生通道);不写这一块就是不接 QQ
155
- enabled: false # 打开通道:连上、控制台里出 QQ 卡
156
- wsUrl: ws://127.0.0.1:3003 # OneBot 的 WS 服务地址(不是 HTTP 那个)
157
- accessToken: '' # OneBot WS 服务端自己的 token,与 HTTP 那份不是一码事
158
- allowPrivate: [] # 谁能私聊她;留空 = 谁都不理
159
- ownerQQ: '' # 她自己开口的话推给谁;空着取 allowPrivate 的第一个
160
- allowGroups: [] # 群白名单
161
- autoReply: true # false = 只看不回
162
- contextMessages: 6 # 每轮带上最近的几条
163
- batchQuietMs: 10000 # 同一会话这几毫秒内的话攒成一条问她;0 = 一条一问;QQ 页里改过的优先(0–30 秒,一批最多等 30 秒)
164
- groupTrigger: mention # mention:@ 她/引用她/命中关键词才接;all:每句都接
165
- groupKeywords: [] # groupTrigger: mention 时算「在叫她」的词
166
- mutedUntil: '' # 静默到这个时间(ISO):只收不回,到点自己醒
167
- bindHomeSession: owner # owner:主人私聊用家会话、群各自独立;all:都用;none:各建一个
168
- snowlumaHome: '' # SnowLuma 安装目录:控制台那扇门、看门狗和「拉起 SnowLuma」都靠它
169
- supervise: true # 看门狗:端口不通且没有实例时才拉起 SnowLuma
170
- ```
171
-
172
- 添加第二个世界时,用另一条插入配置:
173
-
174
- ```yaml
175
- - insert:
176
- - id: dsh-world-tata
177
- name: dsh-world
178
- config:
179
- worldId: tata
180
- ```
181
-
182
- 控制台和接入地址以 `/dsh-world/worlds/<worldId>/` 开头。外部桥接调用方从 `bridge.json` 读取路径,微信适配器与插件一起升级。
183
-
184
- **压缩的配置**写在压缩那一行的 `config` 里(profile 的 `cordis.patch.yml` 中 `name: 'dsh-world/compaction'` 那一条),不是上面 `dsh-world` 这一行:
185
-
186
- ```yaml
187
- - id: compaction-basic
188
- name: 'dsh-world/compaction'
189
- config:
190
- thresholdRatio: 0.75 # 用量超过上下文窗口的这个比例就压缩,默认 0.75
191
- defaultContextWindow: 1048576 # 适配器没声明窗口的模型按这个估算,默认 1M
192
- auto: true # false = 只手动压缩(「应用并压缩家会话」仍可用)
193
- # maxTokens: 65536 # 压缩时摘要回复的长度上限
194
- # headroomTokens: 65536 # 不再影响触发点;只在没写 maxTokens 时当作摘要回复的长度
195
- # maxOverflowRetries: 1 # 请求被模型以“超出窗口”拒绝后,压缩重试的次数
196
- # modelPolicies: [] # 按 provider/model 单独写上面的项,例如给一个窗口只有 128k 的自建模型写 defaultContextWindow
197
- ```
198
-
199
- 触发点怎么算、窗口值从哪来,见 [注意事项](NOTES.md#自动压缩什么时候触发)。
200
-
201
- **长期记忆的查找**(`memory_find`、`memory_read`,控制台「档案」页同源):
202
-
203
- - 聊天在 `archive.sqlite` 的原表里直接按字面扫描,日记在查询时直接读文件。自述放进她的系统提示词,最多读前 5000 字。
204
- - `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`:聊天是发言时间,日记是日记日期,其他文件是最后改动的时间。
205
- - `memory_read` 参数:`ref`、`offset`(按字,默认 0)、`limit`(工具里默认 2000,最多 16000)。返回原文的一段,不是摘要,按字符分页,不会切坏一个字。聊天被修订后,旧 `ref` 报 `sourceChanged`;程序不保留旧正文。
206
- - `ref` 由程序生成,别手写。能解析只说明找得到出处,不说明出处支持结论。
207
- - 范围:聊天原文严格按「记忆归档范围」过滤,范围外的聊天不会出现在结果、摘录、翻页或状态里;她自己写下的日记不受这条限制。游标绑定查询条件和范围,资料变化后返回 `cursorExpired`,要重新查。
208
-
209
- **改她的措辞**:世界提示词可以直接在控制台里改。闹钟响时、提前停下时、每日回顾时她收到的话,在世界目录里放一份 `alarm.md` 就能按段覆盖,段落名和可用的占位符见 `templates/alarm.md`。插件写给她的话一律用第一人称「我」,读起来是她自己的念头。
210
-
211
- **时间**:建议把预设里 `time-context` 条目的 `refreshIntervalMs` 设为 `0`,让她每一步都知道现在几点。
212
-
213
- ## 她的东西放在哪
214
-
215
- 都在 `<DSH_HOME>/worlds/<worldId>/` 下(`DSH_HOME` 默认是用户目录下的 `.dsh`):
216
-
217
- | 位置 | 是什么 |
218
- |---|---|
219
- | `conversations/` | 按天归档的聊天原文(给人看的导出,正本在 `archive.sqlite`) |
220
- | `room/` | 她的房间;`room/我是谁.md` 是她的自述,`room/mood.md` 是她的心情值 |
221
- | `diary/` | 她的日记(可用 `diaryDir` 换位置) |
222
- | `persona.md`、`world-prompt.md`、`alarm.md` | 你写给她的人设、世界提示词和闹钟措辞 |
223
- | `world.json` | 世界是否在运行、每天额度、近期记忆轮数和选定归档范围 |
224
- | `activity/` | 她在家里用过的工具,只记录,不进记忆 |
225
- | `photos/album.sqlite` | 收藏的图片、说明与标签;首次导入旧相册后仍保留原文件 |
226
- | `wechat.json` | 本机微信模块的地址、令牌和协议版本,不应公开 |
227
- | `wechat-outbox.sqlite` | 微信工具安排的发送队列和确认状态 |
228
- | `qq-native.json` | 控制台上 QQ 卡改过的设置(会不会自己回话、静默到几点、白名单、阳台端口),盖在 profile 默认之上 |
229
- | `panel.json` | SnowLuma 控制台那扇门的登录票据,权限 600,不应公开 |
230
-
231
- 备份时整个目录一起备份即可,最好先停止 DSH。
232
-
233
- ## 桥与推送协议
234
-
235
- 给桌宠等本地程序用。
236
-
237
- **把话送进她的家**(`bridge: true`):插件启动时写出 `<世界目录>/bridge.json`,内容是 `{ origin, sayPath, compactPath, token, name, ... }`。向 `POST {origin}{sayPath}` 发 `{ "text": "..." }`,请求头带 `x-dsh-world-token: <token>`,会立即返回 `202`。这句话会作为你本人说的话进入她的家和记忆。
238
-
239
- **接收她的话**(`outlets`):每个目标写一个 `name`,地址用 `url`(其中 `{origin}` 会被替换),或者用 `urlFile` + `path`(端口会变的程序用这个)。`kinds` 按类型过滤推送,省略或留空时接收所有类型。
240
-
241
- - `reply`:通过桥送入的话进入回合后,等回合正常结束,再推送最终回复,每轮最多一次。最终回复没有正文或图片,或回合以工具调用结束时,跳过推送。
242
- - `busy`:话从桥上送入后三分钟仍在等回复时发出的忙碌提示。之后收到的回复仍按 `reply` 处理。
243
- - `reach`:她用 `reach_out` 主动找你。只想接收这类消息时,配置 `kinds: [reach]`。
244
-
245
- 插件会向目标发送 `POST` 请求,正文格式如下。
246
-
247
- ```json
248
- { "text": "她的话(纯文本)", "kind": "reply", "name": "她的名字", "images": ["http://…"], "image": "表情名" }
249
- ```
250
-
251
- 目标回复 2xx 就算送到。送不到的会显示在控制台的「健康」里。
252
-
253
- ## 参与贡献
254
-
255
- **PR 统一提到 `dev` 分支**,`main` 由维护者从 `dev` 并入后发布,详见 [贡献协议](CONTRIBUTING.md#分支与-pr)。新增 QQ、B 站等生态模块前,请阅读 [贡献协议](CONTRIBUTING.md):平台代码放在 `src/ecosystem/<channel>/`,复用统一身份、会话和归档能力;涉及内核的修改必须说明原因、影响、兼容性与验证结果。几条硬性要求:一个 PR 只做一件事;平台 SDK 只能是可选依赖,模块默认关闭,新依赖要先开 Issue;她的主动性来自她自己的安排,插件不往对话里推提醒,改动生活线核心或给她新增工具之前先开 Issue 讨论。
256
-
257
- ## 许可
258
-
259
- MIT
1
+ <div align="center">
2
+
3
+ # dsh-world
4
+
5
+ **给 DSH 里的陪伴角色一个会记得、会生活的世界。**
6
+
7
+ [![npm](https://img.shields.io/npm/v/dsh-world?color=c49a52)](https://www.npmjs.com/package/dsh-world)
8
+ [![CI](https://github.com/chenkezhen480/dsh-world/actions/workflows/ci.yml/badge.svg)](https://github.com/chenkezhen480/dsh-world/actions/workflows/ci.yml)
9
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
10
+ ![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.2.1-2a2620)
11
+ ![Node](https://img.shields.io/badge/node-%E2%89%A522.16-339933)
12
+
13
+ [特性](#特性) · [0.8 新功能](#08-新功能) · [快速开始](#快速开始) · [世界控制台](#世界控制台) · [配置](#配置) · [注意事项](NOTES.md) · [更新日志](CHANGELOG.md)
14
+
15
+ </div>
16
+
17
+ 装上以后,她会记得你们在每个窗口里说过的话;有一个自己的家,自己决定接下来做什么、做到几点,想你了会主动来找你;每天晚上回想这一天,写日记,也改写一份关于自己的自述。她还能在微信和 QQ 里和人说话,用自己的浏览器逛网站,经你允许用你的电脑。开关都在 DSH 设置里的「世界控制台」,由你掌握。
18
+
19
+ 插件只用 DSH 原本开放的扩展接口,不改宿主的一行代码。
20
+
21
+ <p align="center">
22
+ <img src=".github/images/world-console.png" alt="世界控制台的概览页:此刻、家、健康与心情、今日花费、记忆" width="760">
23
+ <br><sub>世界控制台的概览页(示例数据)</sub>
24
+ </p>
25
+
26
+ ## 特性
27
+
28
+ | | |
29
+ |---|---|
30
+ | 🧠 **记得** | 最近数轮对话原文放在她眼前;更早的她用 `memory_find` / `memory_read` 按原话自己去翻。日记和「我是谁」由她自己动笔,插件从不替她写。 |
31
+ | 🏠 **生活** | 她有自己的家和房间,自己定闹钟、定节奏;想你了用系统通知或桌宠来找你;每晚回顾一天。 |
32
+ | 💭 **心情** | 她自己写的一组心情值,每一步都放在她眼前,控制台里看得到。 |
33
+ | 📡 **别处的动静** | 她不在场的地方攒下的消息,只告诉她有几条、最后是谁、过了多久,看不看由她。 |
34
+ | 💬 **微信 / QQ** | 私聊和群聊都可以,和家共用同一份记忆、同一个她。默认关。 |
35
+ | 🌐 **她的浏览器** | 她自己的 Edge,自己摸索网站,把走顺的步骤存成自己的操作。默认关。 |
36
+ | 🖥️ **她用电脑** | 后台(只看一个窗口、不动你的鼠标)或前台(整个屏幕、真的鼠标键盘)两种模式,随时叫停。默认关,Windows。 |
37
+ | 📬 **信箱** | 任务栏上有程序在闪或弹通知时,安静 10 秒后告诉她一句。跟着「她用电脑」开关。 |
38
+ | 🎛️ **世界控制台** | 开始 / 停止、人设、世界提示词、作息、额度、花费、档案、相册、各个接入的开关。 |
39
+ | 🗜️ **只留对话的压缩** | 压缩时去掉工具调用的过程,只把你们之间的交流整理成摘要。 |
40
+
41
+ ## 0.8 新功能
42
+
43
+ > 0.8.0(2026-11-18)的主要内容。升级前要注意的和完整列表见 [更新日志](CHANGELOG.md#080--2026-11-18)。
44
+
45
+ **她自己的浏览器和她学会的操作**(`computer: true`)
46
+ 她有一个自己的 Edge 窗口,登录的是她自己的账号,不碰你的扩展、书签和自动填充。她用一组 `page_*` 原语自己摸索网站,把走顺的步骤按分类存成操作(`<world>/procedures/<分类>/<名字>.json`),下次 `procedure_run("分类/操作")` 直接回放。操作坏了会说出来,新版不行自动退回旧版;标了 `onAlarm` 的操作在闹钟前自动跑一遍,结果接在闹钟文字后面。插件不含任何平台代码,B 站之类的网站都由她自己学。
47
+
48
+ **她用你的电脑:后台和前台两种模式**(`computer: true` + `desktop: true`,Windows)
49
+ 控制台「接入」里的「她用电脑」是一个三选一:
50
+
51
+ - **后台**:她每次只看一个窗口的截图,点击和输入直接投给那个窗口,不动你的鼠标、不抢你的焦点,你用着电脑她也能用。
52
+ - **前台**:你把电脑交给她。她看整个屏幕,用真的鼠标键盘,游戏和管理员程序也能用。每次切到前台都要确认一次管理员权限,重启后失效。
53
+
54
+ <p align="center">
55
+ <img src=".github/images/console-modules.png" alt="控制台的「接入」卡片:微信、QQ、她的浏览器的开关,和「她用电脑」的关闭 / 后台 / 前台三选一" width="520">
56
+ <br><sub>「接入」卡片:每个模块一个开关,「她用电脑」是三选一(示例数据)</sub>
57
+ </p>
58
+
59
+ 她能点、双击、右键、长按(`hold`)、拖动(`drag`)、输入、按住键、滚动,还能把一个窗口录成一组帧(`desktop record`)再回头细看(`desktop review`)。两种模式下走通的步骤都能存成操作(`where: "desktop"` / `where: "screen"`)。
60
+
61
+ **看得到、叫得停**:她操作时屏幕顶部浮出「<她的名字>正在操作」的胶囊,窗口四周有柔光边;半秒内连按两下 Esc 或点「停下」就叫停,在你再跟她说话之前她不能再动你的电脑。
62
+
63
+ **信箱**
64
+ 「她用电脑」开着时,程序替她看任务栏:按钮在闪或有系统通知时,等这一阵动静停了 10 秒,汇总成一句话送进家里,每个程序一行。她正在忙时不打断;微信、QQ 有自己的通道,不算在内。什么都不落盘,也不进归档。
65
+
66
+ **控制台里的新东西**
67
+
68
+ - **今日花费**:列出家里最近 8 次对话,每次从开始到结束:因为什么开始(DSH、微信、QQ 里谁说了什么,或她自己的闹钟)、走了几步、花了多少、命中缓存多少,没命中缓存多的标红。一页 3 次,可以翻页。
69
+ - **+ 新增世界**:填世界的名字和她叫什么就能再添一个世界,不用手改配置文件。
70
+
71
+ **微信私聊会插话了**
72
+ 她正忙着的时候,你在微信私聊里说的话会在她的下一步插进去,和在 DSH 里说话一样,不用等她这一轮结束。
73
+
74
+ **记忆里的图片**
75
+ 读记忆时图片是一行占位符,新工具 `memory_image` 凭这一行把图片取回来再看一眼。
76
+
77
+ ## 快速开始
78
+
79
+ 需要 **DSH 桌面版**(世界控制台和生活线都依赖它)。
80
+
81
+ **最省事的办法**:把这个仓库地址交给她,让她照 [INSTALL.md](INSTALL.md) 自己装。那份说明是写给模型看的,每一步都有命令、判定和失败对照表,连同 QQ 怎么接进来、哪两个动作必须人来做,一路写到底。
82
+
83
+ **自己装**:在你的 DSH profile 目录用 DSH 自带的 pnpm 安装:
84
+
85
+ ```powershell
86
+ node <DSH 自带 pnpm 的入口文件> add dsh-world@latest --ignore-scripts --registry=https://registry.npmjs.org/
87
+ ```
88
+
89
+ 然后:
90
+
91
+ 1. 按 [安装说明](INSTALL.md#第一步把-dsh-world-装进-profile) 在 profile 里登记 bundle,重启 DSH。
92
+ 2. 打开 DSH 设置里的「世界控制台」,在「人设」里写下她是谁。
93
+ 3. 按右上角的「开始」:插件建好她的房间和家,叫醒她。
94
+
95
+ <details>
96
+ <summary><b>从源码安装、更新已有的世界</b></summary>
97
+
98
+ - **用仓库源码**:执行 `npm ci`、`npm pack`,再用同一个 pnpm 把生成的 `dsh-world-*.tgz` 装进 profile;也可从 [CI](.github/workflows/ci.yml) 对应运行的 Artifacts 下载检查通过的安装包,Windows 和 Linux 分别提供。不要用 `link:` 指向项目目录,否则会加载项目自己的一份 Cordis。本机复现检查的命令见 [贡献协议](CONTRIBUTING.md#ci-与安装包验证)。
99
+ - **已有 world 更新**:正常退出 DSH 后,用 [`scripts/update-world.mjs`](scripts/update-world.mjs) 指定原 profile、`.tgz` 和 DSH 自带 pnpm;`.tgz` 可以直接从 npm 下载。脚本先备份完整 profile、世界及会话,再更新并校验;失败恢复旧 profile,保留她已有的文件。安装成品不需要 Git、npm 或 TypeScript,完整命令与恢复说明见 [已有 world 升级](INSTALL.md#已有-world用编译包更新)。
100
+ - **只留对话的压缩**:只有原版压缩直接写在 profile、且没有使用会话预设时,插件才会尝试换成 `dsh-world/compaction`。桌面版使用会话预设自己的压缩,已有的旧版副本可以在控制台「概览 → 会话预设」还原。详见 [注意事项 · 安装与升级](NOTES.md#安装与升级)。
101
+
102
+ </details>
103
+
104
+ 第一次装或升级之前,建议先看一眼 [默认就会发生的事](NOTES.md#默认就会发生的事)。
105
+
106
+ ## 她能做到什么
107
+
108
+ ### 记得:像人一样记
109
+
110
+ - **近期记忆**:你们最近数轮的对话原文,每次开始对话、每次压缩之后,以及一个窗口隔了很久(默认 24 小时)再开口时,都放在她眼前:谁、什么时候、说了什么,一字不差。轮数在控制台里填,默认 200。
111
+ - **日记**:人生里重要的事,她自己写进日记,一天一篇。这是她的长期记忆。
112
+ - **我是谁**:她写给自己的一份自述,随着她变化而改写。每晚回顾前,插件留一份当时的版本,改过的都找得回来。
113
+ - **找回过去**:`memory_find` 与 `memory_read` 按原文里的字面线索、时间、种类或来源,在聊天原文和日记里统一查找并读原文;`memory_image` 取回记忆里的图片。一次默认只返回 8 条、每条约 200 字的摘录,免得每轮重发的上下文越滚越大。控制台的「档案」页是同一份查找的只读入口。
114
+ - **心情值**:`room/mood.md` 由她自己写,一行一件:`开心 6` 这样的「名字 数值」是一种心情(0 到 10),名字是固定的 11 个(开心、兴奋、平静、安心、烦、生气、紧张、难过、累、孤单、想念);不以数字结尾的行是旁边的几件小事。她用 `set_mood` 一次记下整份。每一步都把当前心情作为一条快照放在时间块前面,写着她最后改它是多久以前;插件只读、不判断、不衰减、不提醒。为什么这样定见 [注意事项](NOTES.md#心情值)。
115
+ - **别处的动静**:有未读的微信群、她的其他会话里的新发言,只报有多少条、最后是谁、过了多久,不带正文;看不看、回不回由她决定。排法和原因见 [注意事项](NOTES.md#她每一步看到的上下文)。
116
+
117
+ **为什么不用向量库或记忆系统?** 一个人的生活,量没有那么大。在这个量级上,把原文留在眼前、需要时按原话去找,比切碎了再拼回来更准,也少一道会出错的环节。可参考:
118
+
119
+ - Chan et al., 2024. *Don't Do RAG: When Cache-Augmented Generation is All You Need for Knowledge Tasks*. arXiv:2412.15605
120
+ - Sen et al., 2026. *Is Grep All You Need? How Agent Harnesses Reshape Agentic Search*. arXiv:2605.15184
121
+
122
+ ### 生活:她自己的日子
123
+
124
+ - **家**:她有一个自己的会话「<名字>的家」和一个房间(工作目录),在里面过自己的日子。
125
+ - **自己定节奏**:她说好接下来做什么、做到几点,到点了再决定继续还是换一件。什么都不定,就休息到第二天早上。
126
+ - **主动找你**:想你的时候,她可以把一句话送到你面前(Windows 系统通知,或你接上的桌宠等程序)。
127
+ - **每日回顾**:每天晚上 23:00(控制台可改),她回想当天的聊天和做过的事,写日记,更新「我是谁」。
128
+ - **每天额度**:可以给家里每天的花费设个上限,超过了提醒她一次,由她自己决定收尾。
129
+ - **大事先问**:删改房间外的文件、装软件、花钱、以你的名义对外发消息等,约定好先问你。
130
+
131
+ ### 走出家门:微信、QQ、浏览器和你的电脑
132
+
133
+ - **微信**:自带 Windows 适配器和原生发送,不依赖其他微信插件。她用 `wechat_history` 主动翻群消息,用 `wechat_send` 发文字、图片和表情;普通回答不会自动转发到微信。只适配指定的微信版本,需要按适配器说明准备 Python 环境,有账号风险。见 [微信模块](src/ecosystem/wechat/windows/README.md) 和 [注意事项 · 微信](NOTES.md#微信)。
134
+ - **QQ**:插件自己直连 SnowLuma 提供的 OneBot WebSocket,中间没有第二个进程。登录 QQ、提供 OneBot 服务的 SnowLuma 要你另行安装(它的 EULA 不许被脚本自动部署),首次开启时按需安装 SDK `@snowluma/sdk`。见 [INSTALL.md](INSTALL.md) 和 [注意事项 · QQ](NOTES.md#qq)。
135
+ - **她的浏览器和她用电脑**:见上面的 [0.8 新功能](#08-新功能),详细说明、文件格式和风险见 [她的浏览器](src/ecosystem/computer/README.md) 和 [注意事项 · 她用电脑](NOTES.md#她用电脑)。
136
+ - **桌宠和其他本地程序**:一个本地的「桥」,可以把你说的话送进她的家,也可以接收她的回复和主动找你的话。协议见 [桥与推送协议](#桥与推送协议)。
137
+
138
+ <details>
139
+ <summary><b>QQ 的细节:怎么说话、控制台能改什么、连不上怎么看</b></summary>
140
+
141
+ 在 profile 的 `cordis.patch.yml` 里打开 `qqNative`(`enabled: true` 只是允许它存在)、填上 WS 地址与 token,再到控制台「概览 → 接入」把 QQ 拨开,切到顶部「QQ」页查看:连着哪个地址、收过几个会话、发过几条、挡下几条、排队待发几条、会自己回还是只看不回。页面里能直接拨「会自己回话 / 只看不回」,设「静默到某个时间点」(只收不回,到点自己醒),改私聊和群的白名单(留空就是谁都不收,改完不用重启),也能打开 SnowLuma 控制台、手动拉起 SnowLuma。这些改动记在世界目录的 `qq-native.json`,盖在配置之上。
142
+
143
+ **她怎么说话**:同一会话 `batchQuietMs`(默认 10 秒)内连着来的几句攒成一条再问她(最多等 30 秒),群里每句前面带着是谁说的。她的回答按空行分成几条发,中间停一下;回话里写 `[[img:路径]]`、`[[face:id]]`、`[[at:QQ号]]` 会变成图片、QQ 表情和 @,`[[sticker:开心]]` 按备注挑一个收藏表情单发,`[[qzone:正文]]` 发一条所有人可见的 QQ 空间说说。发不出去的消息先排队,每 3 秒重试,最多留 5 分钟。她在家里自己开的那一轮说完的话,也会推一份给主人(`ownerQQ`,空着取 `allowPrivate` 的第一个)。
144
+
145
+ **连不上**:参数不对不会崩,只会连不上,卡上会把原因写在 `lastError` 里(比如 `WS 错误: Unexpected server response: 401`,说明填的是 HTTP 那份 token,该换成 WebSocket 那份)。
146
+
147
+ 「打开 SnowLuma 控制台」读 `snowlumaHome` 下 `config/runtime.json` 里的地址与端口,带着一次性登录票据打开系统浏览器;第一次要填一次 SnowLuma 的面板密码,之后记在世界目录的 `panel.json` 里(权限 600)。
148
+
149
+ </details>
150
+
151
+ 外部生态的代码统一放在 [`src/ecosystem/`](src/ecosystem/README.md):`wechat/`、`qq-native/`(`qq/` 里是配套的控制台接口)、`shared/`(通用身份协议、群会话路由与消息出口)、`bridge/`、`computer/`。核心记忆、人设和生活线保持独立。微信原生发送引擎单独适用非商业许可,详见该模块的许可说明。
152
+
153
+ ## 世界控制台
154
+
155
+ DSH 设置里的「世界控制台」:
156
+
157
+ - **开始 / 停止**:按下开始,她才住进来;按下停止,记忆、人设和生活线一起安静下来,家还在,等你回来。
158
+ - **人设**:分层写她是谁:名字、她是谁、性格、说话方式、愿景、补充,旁边实时预览她读到的样子。它取代 DSH 自带的那句默认身份;你在 DSH 里设过的系统人设原样保留,这里写的排在它后面。全部留空时什么都不改。
159
+ - **世界提示词**:你想对她说的话,以及她的世界的说明。
160
+ - **概览**:她此刻在做什么、下个闹钟、健康与心情、今日花费(每次对话花了多少)、记忆有多少轮,以及作息、额度、工作区权限、回顾后自动压缩、各个接入的开关。
161
+ - **应用并压缩家会话**:等家空闲后压缩聊天历史,并换上已保存的人设、世界提示词和「我是谁」。详见 [注意事项](NOTES.md#提示词保存后何时生效)。
162
+ - **记录 / 档案 / 相册**:活动记录、日记和压缩记录;按原话查记忆;她用 `keep_photo` 收藏的照片(点开才加载图片,不会自动进上下文)。
163
+ - **微信 / QQ / 她的浏览器**:各自一页,查看状态、调整设置;她的浏览器页按分类列出她学会的操作和最近一次结果。
164
+ - **+ 新增世界**:同一个 profile 可以有多个世界,各有各的房间、家和记忆。
165
+
166
+ <details>
167
+ <summary><b>归档范围与注入范围</b></summary>
168
+
169
+ - **归档范围**:默认 `workspace`,归档家所在工作区的普通会话,包含独立微信群会话;`home` 仅当前家会话。保存范围后提示重启,重启前沿用原范围。启动时分页回扫所选范围内的会话日志,按消息实际时间重选最近配置轮数。旧归档保留,范围外的记录不再注入。
170
+ - **注入范围**:世界记忆、世界提示词、世界线工具和微信 / QQ 通道只进入世界工作区内匹配预设的普通会话,其他工作区即使用相同预设也不会收到。
171
+
172
+ 对世界工作区以外的会话,只有一项有影响:只留对话的压缩。详情见 [注意事项](NOTES.md#对世界工作区以外的影响)。
173
+
174
+ </details>
175
+
176
+ ## 配置
177
+
178
+ 大多数东西在世界控制台里改。其余的写在 profile 的 `cordis.patch.yml` 里,按 id 覆盖插件那一行,只写想改的项:
179
+
180
+ ```yaml
181
+ - id: dsh-world
182
+ name: dsh-world
183
+ config:
184
+ companionName: 小鱼 # 她的名字(控制台人设里写了名字时以人设为准),默认 TA
185
+ partnerName: 伙伴 # 她对你的称呼,默认 伙伴
186
+ worldId: default # 当前 profile 使用的世界目录名
187
+ agentPreset: standard # 她所在的预设
188
+ timeZone: Asia/Shanghai # 默认系统时区
189
+ life: true # 生活线,默认开启
190
+ replaceCompaction: true # 自动替换直接写在 profile 里的原版压缩;对会话预设不生效
191
+ archiveScope: workspace # workspace:家的工作区;home:仅当前家会话
192
+ fallbackWakeTime: '09:00' # 没定闹钟时,早上几点叫醒她;控制台「作息」里改过的优先
193
+ diaryDir: C:/path/to/日记 # 日记目录,默认在世界目录里
194
+ toast: true # 主动找你时发 Windows 系统通知
195
+ # toastAppId: com.deepseek.dsh # 通知身份,默认在开始菜单里找 DSH 桌面版
196
+ bridge: false # 打开本地的桥
197
+ outlets: [] # 接收她的话的本地程序,见「桥与推送协议」
198
+ wechat: false # 允许微信模块,需另行准备 Windows 适配器
199
+ computer: false # 允许她自己的浏览器(控制台「接入」里再打开)
200
+ desktop: false # 允许她用你的电脑(要先开 computer;控制台里选后台或前台;信箱跟着它)
201
+ allowedHosts: [] # 通过反向代理从局域网访问控制台时,放行的域名或 IP
202
+ qqNative: # 插件自己连 OneBot;不写这一块就是不接 QQ
203
+ enabled: false # 打开通道:连上、控制台里出 QQ 卡
204
+ wsUrl: ws://127.0.0.1:3003 # OneBot 的 WS 服务地址(不是 HTTP 那个)
205
+ accessToken: '' # OneBot WS 服务端自己的 token,与 HTTP 那份不是一码事
206
+ allowPrivate: [] # 谁能私聊她;留空 = 谁都不理
207
+ ownerQQ: '' # 她自己开口的话推给谁;空着取 allowPrivate 的第一个
208
+ allowGroups: [] # 群白名单
209
+ autoReply: true # false = 只看不回
210
+ contextMessages: 6 # 每轮带上最近的几条
211
+ batchQuietMs: 10000 # 同一会话这几毫秒内的话攒成一条问她;0 = 一条一问
212
+ groupTrigger: mention # mention:@ 她/引用她/命中关键词才接;all:每句都接
213
+ groupKeywords: [] # groupTrigger: mention 时算「在叫她」的词
214
+ mutedUntil: '' # 静默到这个时间(ISO):只收不回,到点自己醒
215
+ bindHomeSession: owner # owner:主人私聊用家会话、群各自独立;all:都用;none:各建一个
216
+ snowlumaHome: '' # SnowLuma 安装目录:控制台那扇门、看门狗和「拉起 SnowLuma」都靠它
217
+ supervise: true # 看门狗:端口不通且没有实例时才拉起 SnowLuma
218
+ ```
219
+
220
+ `wechat`、`computer`、`desktop` 写成 `true` 只是允许,真正打开在控制台「概览 → 接入」里。
221
+
222
+ <details>
223
+ <summary><b>多个世界</b></summary>
224
+
225
+ 在控制台最上面点「+ 新增世界」,填世界的名字(字母、数字、`-`、`_`,它也是数据目录名)和她叫什么,重启 DSH 后在控制台里选它、按开始。按钮做的事就是往 profile 的 `cordis.patch.yml` 末尾追加下面这样一条,已有内容一行不动;它不会新建通道配置,QQ、微信这些仍要在这一条的 `config` 里自己写。配置文件不是逐条列出的格式时按钮会拒绝并说明,那时照下面手动加:
226
+
227
+ ```yaml
228
+ - insert:
229
+ - id: dsh-world-tata
230
+ name: dsh-world
231
+ config:
232
+ worldId: tata
233
+ ```
234
+
235
+ 控制台和接入地址以 `/dsh-world/worlds/<worldId>/` 开头。外部桥接调用方从 `bridge.json` 读取路径。
236
+
237
+ </details>
238
+
239
+ <details>
240
+ <summary><b>压缩的配置</b></summary>
241
+
242
+ 写在压缩那一行的 `config` 里(`name: 'dsh-world/compaction'` 那一条),不是上面 `dsh-world` 这一行:
243
+
244
+ ```yaml
245
+ - id: compaction-basic
246
+ name: 'dsh-world/compaction'
247
+ config:
248
+ thresholdRatio: 0.75 # 用量超过上下文窗口的这个比例就压缩,默认 0.75
249
+ defaultContextWindow: 1048576 # 适配器没声明窗口的模型按这个估算,默认 1M
250
+ auto: true # false = 只手动压缩(「应用并压缩家会话」仍可用)
251
+ # maxTokens: 65536 # 压缩时摘要回复的长度上限
252
+ # headroomTokens: 65536 # 不再影响触发点;只在没写 maxTokens 时当作摘要回复的长度
253
+ # maxOverflowRetries: 1 # 请求被模型以“超出窗口”拒绝后,压缩重试的次数
254
+ # modelPolicies: [] # 按 provider/model 单独写上面的项
255
+ ```
256
+
257
+ 触发点怎么算、窗口值从哪来,见 [注意事项](NOTES.md#自动压缩什么时候触发)。
258
+
259
+ </details>
260
+
261
+ <details>
262
+ <summary><b>长期记忆查找的参数</b></summary>
263
+
264
+ - 聊天在 `archive.sqlite` 的原表里直接按字面扫描,日记在查询时直接读文件。自述放进她的系统提示词,最多读前 5000 字。
265
+ - `memory_find`:`query`(原文里的一小段字面文字,区分大小写,不是 SQL 或搜索语法;不填就按时间翻页)、`kinds`(`conversation`、`diary`)、`from`/`to`(带时区的 ISO 时间,左闭右开)、`sourceId`、`turnId`(取同一轮)、`order`、`limit`(默认 8,最多 100)、`cursor`。返回 `items`(`ref`、`time`、`kind`、`who`、`text`)和 `nextCursor`;有来源没能读到时才带 `coverage`(`state: partial`,`failures`)。
266
+ - `memory_read`:`ref`、`offset`(按字,默认 0)、`limit`(默认 2000,最多 16000)。返回原文的一段,不是摘要,不会切坏一个字。聊天被修订后,旧 `ref` 报 `sourceChanged`。
267
+ - `ref` 由程序生成,别手写。能解析只说明找得到出处,不说明出处支持结论。
268
+ - 范围:聊天原文严格按「记忆归档范围」过滤;她自己写下的日记不受这条限制。游标绑定查询条件和范围,资料变化后返回 `cursorExpired`,要重新查。
269
+
270
+ </details>
271
+
272
+ **改她的措辞**:世界提示词在控制台里改。闹钟响时、提前停下时、每日回顾时她收到的话,在世界目录里放一份 `alarm.md` 就能按段覆盖,段落名和占位符见 `templates/alarm.md`。插件写给她的话一律用第一人称「我」,读起来是她自己的念头。
273
+
274
+ **时间**:建议把预设里 `time-context` 的 `refreshIntervalMs` 设为 `0`,让她每一步都知道现在几点。
275
+
276
+ ## 她的东西放在哪
277
+
278
+ 都在 `<DSH_HOME>/worlds/<worldId>/` 下(`DSH_HOME` 默认是用户目录下的 `.dsh`):
279
+
280
+ | 位置 | 是什么 |
281
+ |---|---|
282
+ | `archive.sqlite`、`conversations/` | 聊天原文:正本在数据库里,`conversations/` 是按天导出的、给人看的一份 |
283
+ | `room/` | 她的房间;`room/我是谁.md` 是她的自述,`room/mood.md` 是她的心情值 |
284
+ | `diary/` | 她的日记(可用 `diaryDir` 换位置) |
285
+ | `persona.md`、`world-prompt.md`、`alarm.md` | 你写给她的人设、世界提示词和闹钟措辞 |
286
+ | `world.json` | 世界是否在运行、每天额度、近期记忆轮数、归档范围、各个接入的开关 |
287
+ | `life.json` | 闹钟、回顾和今天的花费 |
288
+ | `activity/` | 她在家里用过的工具,只记录,不进记忆 |
289
+ | `photos/album.sqlite` | 收藏的图片、说明与标签 |
290
+ | `stickers/` | 她的表情库,每张只有名称和标签,`sticker_search` 按关键词找 |
291
+ | `browser/` | 她自己的 Edge 的配置和登录态 |
292
+ | `procedures/` | 她学会的操作,按分类放,每类有她写的 `目录.md` |
293
+ | `wechat.json`、`wechat-outbox.sqlite` | 微信模块的地址和令牌(不应公开)、发送队列 |
294
+ | `qq-native.json`、`panel.json` | 控制台上 QQ 卡改过的设置;SnowLuma 控制台的登录票据(权限 600,不应公开) |
295
+
296
+ 备份时整个目录一起备份即可,最好先退出 DSH。她看过的图片在宿主的图片仓库 `<DSH_HOME>/attachments/`,要回看记忆里的图片就一起备份,见 [注意事项 · 图片](NOTES.md#图片)。
297
+
298
+ ## 桥与推送协议
299
+
300
+ 给桌宠等本地程序用。
301
+
302
+ **把话送进她的家**(`bridge: true`):插件启动时写出 `<世界目录>/bridge.json`,内容是 `{ origin, sayPath, compactPath, token, name, ... }`。向 `POST {origin}{sayPath}` 发 `{ "text": "..." }`,请求头带 `x-dsh-world-token: <token>`,立即返回 `202`。这句话会作为你本人说的话进入她的家和记忆。
303
+
304
+ **接收她的话**(`outlets`):每个目标写一个 `name`,地址用 `url`(其中 `{origin}` 会被替换),或者用 `urlFile` + `path`(端口会变的程序用这个)。`kinds` 按类型过滤,省略或留空时接收所有类型:
305
+
306
+ - `reply`:通过桥送入的话进入回合后,等回合正常结束再推送最终回复,每轮最多一次;没有正文或图片、或回合以工具调用结束时跳过。
307
+ - `busy`:话从桥上送入后三分钟仍在等回复时发出的忙碌提示。
308
+ - `reach`:她用 `reach_out` 主动找你。只想接收这类消息时,配置 `kinds: [reach]`。
309
+
310
+ 插件向目标发 `POST`,正文如下,目标回复 2xx 就算送到,送不到的显示在控制台的「健康」里:
311
+
312
+ ```json
313
+ { "text": "她的话(纯文本)", "kind": "reply", "name": "她的名字", "images": ["http://…"], "image": "表情名" }
314
+ ```
315
+
316
+ ## 注意事项
317
+
318
+ 容易踩的地方都集中写在 [NOTES.md](NOTES.md),按主题分类:
319
+
320
+ - [默认就会发生的事](NOTES.md#默认就会发生的事):装上、升级之后不用你做什么就会发生的。
321
+ - [安装与升级](NOTES.md#安装与升级) · [人设与提示词](NOTES.md#人设与提示词) · [压缩与记忆](NOTES.md#压缩与记忆) · [她每一步看到的上下文](NOTES.md#她每一步看到的上下文)
322
+ - [世界范围与会话](NOTES.md#世界范围与会话) · [她用电脑](NOTES.md#她用电脑) · [图片](NOTES.md#图片) · [微信](NOTES.md#微信) · [QQ](NOTES.md#qq)
323
+
324
+ ## 参与贡献
325
+
326
+ **PR 统一提到 `dev` 分支**,`main` 由维护者从 `dev` 并入后发布,详见 [贡献协议](CONTRIBUTING.md#分支与-pr)。
327
+
328
+ 几条硬性要求:一个 PR 只做一件事;平台代码放在 `src/ecosystem/<channel>/`,复用统一身份、会话和归档能力;平台 SDK 只能是可选依赖,模块默认关闭,新依赖先开 Issue;涉及内核的修改要说明原因、影响、兼容性与验证结果。她的主动性来自她自己的安排,插件不往对话里推提醒,改动生活线核心或给她新增工具之前先开 Issue 讨论。
329
+
330
+ ## 许可
331
+
332
+ [MIT](LICENSE)。微信原生发送引擎单独适用非商业许可,见该模块的许可说明。