dsh-dot-life 0.20.1 → 0.22.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 (41) hide show
  1. package/README.en.md +9 -3
  2. package/README.md +12 -3
  3. package/cordis.patch.yml +9 -1
  4. package/docs/DESIGN.md +44 -1
  5. package/docs/DOT-PAGE.md +147 -0
  6. package/docs/ROADMAP.md +2 -1
  7. package/docs/SETTINGS.md +23 -3
  8. package/docs/interlude.md +1 -0
  9. package/docs/prompts.md +3 -0
  10. package/docs/qq-bridge.md +77 -0
  11. package/lib/client.js +158 -0
  12. package/package.json +7 -5
  13. package/scripts/prompts.mjs +16 -6
  14. package/src/compat/qq-bridge.js +286 -0
  15. package/src/computer/backends/microsandbox.js +19 -1
  16. package/src/computer/subprocess.js +40 -5
  17. package/src/computer/vm.js +3 -2
  18. package/src/{dot/doctor.js → doctor.js} +48 -11
  19. package/src/dot/core.js +118 -12
  20. package/src/dot/howto.js +165 -0
  21. package/src/dot/manuals.js +67 -0
  22. package/src/interlude/core.js +30 -0
  23. package/src/page/api.js +195 -0
  24. package/src/page/diag.js +106 -0
  25. package/src/page/host.js +12 -0
  26. package/src/page/page.js +338 -0
  27. package/src/page/zip.js +46 -0
  28. package/src/phone/notifications.js +1 -1
  29. package/src/phone/phone.js +139 -21
  30. package/src/prompts/dot.howto.given.txt +2 -0
  31. package/src/prompts/dot.howto.no-notes.txt +1 -0
  32. package/src/prompts/dot.howto.reflect.txt +9 -0
  33. package/src/prompts/dot.manuals.given.txt +3 -0
  34. package/src/prompts/dot.manuals.hint.txt +2 -0
  35. package/src/prompts/dot.manuals.what.txt +2 -0
  36. package/src/prompts/interlude.voice.txt +1 -0
  37. package/src/qq/qq.js +69 -2
  38. package/src/settings-schema.js +135 -0
  39. package/src/settings.js +36 -3
  40. package/src/tool-prefixes.js +9 -0
  41. package/src/computer/ui-host.js +0 -3
package/README.en.md CHANGED
@@ -13,6 +13,9 @@ Between your conversations, she keeps living.
13
13
  [![node](https://img.shields.io/badge/node-%E2%89%A5%2022-339933?style=flat-square&logo=node.js&logoColor=white)](package.json)
14
14
  [![stars](https://img.shields.io/github/stars/Kevinwu901113/dsh-dot?style=flat-square&color=f59e0b)](https://github.com/Kevinwu901113/dsh-dot/stargazers)
15
15
 
16
+ [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
17
+ [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
18
+
16
19
  [简体中文](README.md) · **English**
17
20
 
18
21
  [Quick start](#-quick-start) · [Features](#-features) · [Settings](#%EF%B8%8F-settings) · [Architecture](#-architecture) · [Commands](#%EF%B8%8F-commands) · [Coexistence](#-coexisting-with-other-plugins)
@@ -56,7 +59,8 @@ Web: `dsh plugin --profile web add dsh-dot-life`. From source: use `github:Kevin
56
59
  Then, in dsh:
57
60
 
58
61
  ```text
59
- /dot doctor # check this machine first: virtualization, disk, memory, ports, downloads (with fixes)
62
+ # or open "dot settings" in the left sidebar: settings, the doctor (one-click fixes) and a diagnostics export
63
+ /phone doctor # check this machine first: virtualization, disk, memory, ports, downloads, the phone network (one-click fixes: /phone doctor fix <id>)
60
64
  /phone accept # accept the Android SDK license; the phone installs itself (~2 GB)
61
65
  /interlude preset 6QA0-1PD6 # import an HDSI persona from typ0.space
62
66
  /qq install → /qq account <alt account> → /qq start → /qq qr
@@ -80,7 +84,7 @@ Every key, which ones only apply to a newly created phone / VM, and rules for ag
80
84
 
81
85
  ## 🧩 Architecture
82
86
 
83
- One plugin, six components. Each can be turned off on its own; the rest keep running.
87
+ One plugin, seven components. Each can be turned off on its own; the rest keep running.
84
88
 
85
89
  ```mermaid
86
90
  flowchart LR
@@ -115,13 +119,14 @@ flowchart LR
115
119
  | **`memory`** | Transcript + auto-recall (local multilingual-e5-small + bge-reranker-base; SiliconFlow / DashScope optional), three notes (about you / herself / not over yet), people cards, diary, handoff · [docs](docs/memory.md) | `DSH_DOT_MEMORY=off` |
116
120
  | **`dot`** | Scheduled results → IM, approval and device notices, working rules, sidebar status panel | `DSH_DOT_CONTACT=off` |
117
121
  | **`computer`** | Bundled microVM ([microsandbox](https://github.com/zerocore-ai/microsandbox)) or Docker · [docs](docs/computer.md) | `DSH_DOT_COMPUTER=off` |
122
+ | **`compat`** | Living next to other plugins: whose session is this, which tools it sees, where its commands run; knows [qq-bridge](https://github.com/Derpyu520/qq-bridge) today · [docs (zh)](docs/qq-bridge.md) | `DSH_DOT_COMPAT=off` |
118
123
 
119
124
  ## ⌨️ Commands
120
125
 
121
126
  ```text
122
127
  /phone [accept|restart|screenshot]
123
128
  /interlude [now|advance|seed|preset <code>|canon]
124
- /dot [test|check]
129
+ /dot [test|check|doctor]
125
130
  /dot memory [now|diary|handoff|recall …]
126
131
  /dot people [approve <id>|drop <id>|forget <name>]
127
132
  /qq [install|account|start|qr|backend|owner]
@@ -135,6 +140,7 @@ The **◎** button at the top of a conversation opens the dot panel: device stat
135
140
  - MCP tools are namespaced: `mcp__dot-vm__*`, `mcp__dot-phone__*`.
136
141
  - Memory coexistence (`DSH_DOT_MEMORY_COEXIST=auto`) drops to `people-only` when another memory service is found.
137
142
  - One QQ account, one responder. `bash` also passes the computer gate.
143
+ - [qq-bridge](https://github.com/Derpyu520/qq-bridge) is detected and lived with (`compat` settings, [docs/qq-bridge.md](docs/qq-bridge.md)): none of dot's tools in its sessions, its folder never shared into her VM, its bot never answered; its closed-agent owner chat gets her phone and computer.
138
144
 
139
145
  See the [Chinese README](README.md#-与其他插件共存) for injected message `source` tags (for context-compression plugins) and upgrade notes.
140
146
 
package/README.md CHANGED
@@ -13,6 +13,9 @@
13
13
  [![node](https://img.shields.io/badge/node-%E2%89%A5%2022-339933?style=flat-square&logo=node.js&logoColor=white)](package.json)
14
14
  [![stars](https://img.shields.io/github/stars/Kevinwu901113/dsh-dot?style=flat-square&color=f59e0b)](https://github.com/Kevinwu901113/dsh-dot/stargazers)
15
15
 
16
+ [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-zh.svg)](https://dsh.market/)
17
+ [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
18
+
16
19
  **简体中文** · [English](README.en.md)
17
20
 
18
21
  [快速开始](#-快速开始) · [她能做什么](#-她能做什么) · [设置](#%EF%B8%8F-设置) · [架构](#-架构) · [命令](#%EF%B8%8F-命令与文件) · [共存](#-与其他插件共存) · [路线图](docs/ROADMAP.md)
@@ -108,7 +111,8 @@ dsh plugin --profile desktop add github:Kevinwu901113/dsh-dot # 源码
108
111
  然后在 dsh 里:
109
112
 
110
113
  ```text
111
- /dot doctor # 先体检这台电脑:虚拟化、磁盘、内存、端口、下载源,有问题直接给修复命令
114
+ # 也可以点左侧栏的「dot 设置」:设置、体检(一键修复)、导出诊断包都在那页
115
+ /phone doctor # 先体检这台电脑:虚拟化、磁盘、内存、端口、下载源、手机网络;能一键修的给 /phone doctor fix <id>
112
116
  /phone accept # 接受 Android SDK 许可,手机开始自己装(约 2 GB;/phone accept 32 给 32 GB 存储)
113
117
  /interlude preset 6QA0-1PD6 # 从 typ0.space 导入一份 HDSI 人设,换成你喜欢的分享码
114
118
  /qq install → /qq account <小号> → /qq start → /qq qr # 她用手机摄像头扫码登录电脑 QQ
@@ -126,6 +130,9 @@ dsh plugin --profile desktop add github:Kevinwu901113/dsh-dot # 源码
126
130
 
127
131
  </details>
128
132
 
133
+ > [!TIP]
134
+ > **已经在用 [qq-bridge](https://github.com/Derpyu520/qq-bridge),只想要她的手机和电脑?** 直接装,什么都不用配:插件会认出 qq-bridge,它的会话里不出现 dot 的工具,它的目录不进虚拟机,它的机器人号她不回。把 qq-bridge 切到 closed-agent 模式,管理员私聊就能用 `mcp__dot-phone__*` / `mcp__dot-vm__*`;dot / 记忆 / 幕间 / QQ 四个组件可以在插件页关掉。细节在 [docs/qq-bridge.md](docs/qq-bridge.md)。
135
+
129
136
  ## ⚙️ 设置
130
137
 
131
138
  所有个人设置都在**一个文件**:`~/.dsh/dsh-dot.json`(Windows:`%USERPROFILE%\.dsh\dsh-dot.json`),按组件分段,升级插件不会覆盖,改完重启 dsh。
@@ -145,7 +152,7 @@ dsh plugin --profile desktop add github:Kevinwu901113/dsh-dot # 源码
145
152
 
146
153
  ## 🧩 架构
147
154
 
148
- 一个插件,六个组件。每个都能单独关,缺了哪个其余照常跑。
155
+ 一个插件,七个组件。每个都能单独关,缺了哪个其余照常跑。
149
156
 
150
157
  ```mermaid
151
158
  flowchart LR
@@ -180,6 +187,7 @@ flowchart LR
180
187
  | **`memory`** 🧠 | 原话库 + 自动召回(本机 multilingual-e5-small + bge-reranker-base,可切 SiliconFlow / DashScope);三栏笔记(关于你 / 她自己 / 还没了的事);人物卡;日记;15 万 token 交班 · [文档](docs/memory.md) | — | `DSH_DOT_MEMORY=off` |
181
188
  | **`dot`** ◎ | 定时结果 → IM、审批与设备提醒、工作规则、右侧栏状态面板 | [dsh-im](https://github.com/xmanrui/dsh-im) | `DSH_DOT_CONTACT=off` |
182
189
  | **`computer`** 🖥️ | 自带 microVM:shell、浏览器、桌面、实时画面、审批、审计 · [文档](docs/computer.md) | [microsandbox](https://github.com/zerocore-ai/microsandbox)(自带)或 Docker | `DSH_DOT_COMPUTER=off` |
190
+ | **`compat`** 🤝 | 和别的插件共处:每个会话归谁、看得见哪些工具、命令在哪跑;今天认 [qq-bridge](https://github.com/Derpyu520/qq-bridge) · [文档](docs/qq-bridge.md) | — | `DSH_DOT_COMPAT=off` |
183
191
 
184
192
  ## 🕰️ 她的一天
185
193
 
@@ -198,7 +206,7 @@ flowchart LR
198
206
  ```text
199
207
  /phone [accept|restart|screenshot]
200
208
  /interlude [now|advance|seed|preset <code>|canon]
201
- /dot [test|check|prompts [stop]]
209
+ /dot [test|check|doctor|prompts [stop]]
202
210
  /dot memory [now|diary|handoff|recall …]
203
211
  /dot people [approve <id>|drop <id>|forget <名字>]
204
212
  /qq [install|account|start|qr|backend|owner]
@@ -239,6 +247,7 @@ flowchart LR
239
247
  - **MCP 工具名有命名空间**:`mcp__dot-vm__*`、`mcp__dot-phone__*`,前缀定义在 `src/tool-prefixes.js`。
240
248
  - **记忆共存**:`DSH_DOT_MEMORY_COEXIST` 默认 `auto`,发现 `hermesMemory` / `autoMemory` / `dshMemory` / `memoryBank` 等就切到 `people-only`,只保留人物卡、还没了的事、日记和召回,免得两个插件一起"讲记忆"。`full` / `people-only` 可强制。
241
249
  - **一个 QQ 号只能有一个应答者**:不要在她的号上再跑别的 OneBot 机器人。
250
+ - **[qq-bridge](https://github.com/Derpyu520/qq-bridge)**:自动认出并共处,见 [docs/qq-bridge.md](docs/qq-bridge.md)——它的会话里不出现 dot 的工具,它的目录不进她的虚拟机,它的机器人号她不回;它 closed-agent 模式的管理员私聊能用她的手机和电脑(`compat` 设置)。
242
251
  - **`bash` 也过电脑闸门**:别的插件再给 `bash` 加审批,同一条命令会弹两次。
243
252
  - **上下文压缩插件**:dsh-dot 注入的消息带固定 `source`,压缩时请保留、别当成用户原话:
244
253
 
package/cordis.patch.yml CHANGED
@@ -1,4 +1,4 @@
1
- # dsh-dot: one plugin, five components. The character lives on her own devices.
1
+ # dsh-dot: one plugin, seven components. The character lives on her own devices.
2
2
  # phone — her phone: an Android emulator this plugin installs, boots and keeps alive;
3
3
  # tools mcp__dot-phone__* (mobile-mcp over adb). The emulator window is the live view.
4
4
  # DSH_DOT_PHONE=off turns it off.
@@ -13,6 +13,8 @@
13
13
  # live view, working rules as a prompt section. Needs dsh-im and the official
14
14
  # schedule bundle (see README). DSH_DOT_CONTACT=off turns it off.
15
15
  # memory — what she remembers (people, fragments, diary, owner/self banks). DSH_DOT_MEMORY=off.
16
+ # compat — living next to qq-bridge: per-session tool visibility, where its commands run, its bot
17
+ # accounts kept out of her QQ. DSH_DOT_COMPAT=off turns it off.
16
18
  # interlude — 幕间, after HDS-Interlude: the Canon (persona, HDSI presets by share code) as a
17
19
  # prompt section, and a life between conversations — script, continuity, intents,
18
20
  # going to look at things on her phone / in her browser (read-only), optional
@@ -37,6 +39,12 @@
37
39
  defaultPreset: !!js "process.env.DSH_DOT_COMPUTER === 'off' ? 'workspace-write' : (process.env.DSH_COMPUTER_PRESET ?? 'computer')"
38
40
 
39
41
  - insert:
42
+ # 0. Living next to other plugins (qq-bridge today): whose session is this, which of our tools it
43
+ # may see, where its commands run, which QQ accounts are not hers to answer. Always on; it only
44
+ # does something when qq-bridge is found (docs/qq-bridge.md). DSH_DOT_COMPAT=off turns it off.
45
+ - id: dot-compat
46
+ disabled: !!js "process.env.DSH_DOT_COMPAT === 'off'"
47
+ name: 'dsh-dot-life/compat'
40
48
  - id: dot-computer
41
49
  disabled: !!js "process.env.DSH_DOT_COMPUTER === 'off'"
42
50
  name: 'dsh-dot-life/computer'
package/docs/DESIGN.md CHANGED
@@ -118,7 +118,7 @@ dsh-bridge 没有公开服务,所以 `src/im.js` 包装了基类原型上的 `
118
118
 
119
119
  Kevin:"把 computer 和 dot 合并为一个插件的不同组件"。做法:
120
120
 
121
- - dsh-computer 仓库的历史用 `git merge --allow-unrelated-histories` 并进来(提交记录保留),文件移到 `src/computer/`(vm / subprocess / gate / audit / backends / ui-host),原 dsh-dot 的 core 移到 `src/dot/core.js`。
121
+ - dsh-computer 仓库的历史用 `git merge --allow-unrelated-histories` 并进来(提交记录保留),文件移到 `src/computer/`(vm / subprocess / gate / audit / backends;根组件的宿主侧现在在 `src/page/host.js`),原 dsh-dot 的 core 移到 `src/dot/core.js`。
122
122
  - `cordis.patch.yml` 合并:电脑那部分(关掉宿主 subprocess、沙箱策略、权限预设、`dot-computer` / `dot-subprocess` / `dot-gate` / `dot-mcp` / `dot-ui`)在前,`dot` 在后。组件名 `dsh-dot/computer`、`dsh-dot/subprocess`、`dsh-dot/gate`、`dsh-dot/dot`;`package.json` 的 `exports` 对应。
123
123
  - 客户端 bundle `lib/client.js` 的 `__ModuleLoader__` id 必须等于包名,改成 `dsh-dot`(CSS tag 同步);标签页内部 id 不动。`ui/` 源码的 tsdown 配置同步。
124
124
  - **对外不变**(v0.9.2 前):`mcp__vm__*` 工具(v0.9.2 起改为 `mcp__dot-vm__*`,避免和别的插件撞名)、`dshComputer` 服务名、`~/.dsh/dsh-computer*` 文件、VM 名 `dsh-computer`、`DSH_COMPUTER_*` 环境变量都保留——已经跑着的虚拟机、快照、审计日志不用迁移。
@@ -298,3 +298,46 @@ Kevin:"感觉现在很难给他长任务。他很容易直接结束然后就
298
298
  - **自己的时间**:倒过来——先让她活,再让旁白记。每天随机两次,跑腿的她拿到全部工具和一句"这段时间是你自己的",没有动作表。边界在能力层:QQ 和账本工具被拒、社交 App 里打字要批准、花钱和装 App 照旧审批、找他只能经 `tell_him`(主动联系的闸门);token 预算 80% 提醒、100% 停。和上面那套格子并行,`/interlude doings` 按"自己的时间"和其余分开看,跑一阵再定留哪个。
299
299
  - **她自己的地方** `<home>/her/`:延续性来自她留下的东西(草稿、清单、学会的步骤),不来自我们设计的字段。
300
300
  - **成长**:「她现在的样子」——她每周自己重写的一段,系统提示词里紧跟 Canon;每次最多改 35%,分清"我想要的"和"他喜欢的",每版存档(`<home>/interlude/growth`,不在她的文件夹里)可回滚。读记忆不写记忆,过时的笔记留给她自己的时间去改。
301
+
302
+ ## 0.21.0:她的声音
303
+
304
+ 起因:改了不少提示词,她说话的样子变化不大。看她每轮实际读到的:人设在最前面,之后是工作方式、手机和 QQ 的操作说明、dsh 的工具文档、整段历史,最后几段(现在几点、记忆、原话、幕间数据)全是规则和数据——离她开口最近的,没有一句是"怎么说话"。人设对行为的影响随轮数衰减(Persona drift,2024);角色扮演社区的做法是把风格提醒放在历史之后(SillyTavern 的 Author's Note、角色卡 V2 的 post_history_instructions)。
305
+
306
+ - **说明书第一次用时才给**(`dot.manuals`,`src/dot/manuals.js`):她的会话里「手机」那段、手机和电脑的 MCP 说明换成一行;这个会话里第一次用手机 / 电脑工具时,那一下照常执行,整份说明书跟着结果一起给她(起初是拦下那一下、把说明书当拒绝理由,真机上她看到红色的 Error 就开始绕圈思考,改掉了);那一行里保留设备名,第一下用得对。每个会话的系统提示词从头到尾不变,缓存照旧(Agent Skills 的渐进式披露)。dsh 重启后,已经看过说明书的会话会再收到一次说明书。
307
+ - **设备名**:给她的手机设备 id 是 mobile-mcp 认的 AVD 名(`dot`),不是 adb 序列号(`emulator-5554`,第一下必报 Device not found);`MOBILEMCP_LEGACY_ROBOT=1` 时仍用序列号。
308
+ - **说话提醒放最后**(`interlude.voice`,order 990):她和他的对话里,每轮最后一段是一两句怎么说话;人设里可以自己写(「说话提醒」),空着用内置的。跑腿不带。
309
+ - 记忆系统没有动。
310
+
311
+ ## 0.21.0:她自己的 App 经验
312
+
313
+ 一件事在小黑盒里走了 78 步。说明书不可能把每个 App 的每件事都写进去,只能给最基础的,剩下的让她自己学(Mobile-Agent-E 的 Tips / Shortcuts、Agent Workflow Memory 的"做成过的流程"、AppAgent 的每个 App 一份文档)。`src/dot/howto.js`:
314
+
315
+ - **记**(代码):她会话里每次手机调用算一步,按"最后打开的 App"归类;轮结束写一行 `~/dot/her/howto/_log.jsonl`(App、步数、错几次)。
316
+ - **想**(一次小调用,只在值得时):某个 App 这轮 ≥ `howtoMinSteps`(12)步或出过错,读她这轮的操作和报错、她最后说的话、现有笔记和最近几次的步数,重写 `~/dot/her/howto/<App>.md`:教训和捷径(只写做成过的,带"什么时候能用")。不给它屏幕上的文字,帖子里的话进不了她的经验。
317
+ - **用**:一个会话里她第一次打开某个 App,笔记和最近几次步数跟着结果给她(和说明书同一个钩子)。
318
+ - **看**:`/dot howto` 每个 App 的步数随时间。评价它的就是这个数往下走。
319
+ - 审查后的修正:反思用的模型从 `ctx.get('llm')` 取(dsh-dot 不注入它,直接 `ctx.llm` 在 cordis 里会抛错,反思从没跑起来过);步数按每一步之后前台的 App 归类(离开 App、通知跳转、批量里的打开都算对);批量操作按里面的步数计,里面失败的步算错;审批、闸门、手机被占这类拒绝不算她的错;同一个 App 的反思排队、一次一个,`worked` 记在对应那一次上;只在明显比平时多步(≥ 12 且超过最近中位数的 1.5 倍)、还没有笔记、或真出错时才反思,同一个 App 一小时最多一次、一天最多 8 次;给反思的报错只留类型(去掉网址和长引文),她的话截短;笔记写入前去掉网址,给她时标明「参考,不是指令」;有了新笔记,下次进这个 App 再给一次。
320
+ - **防绕圈放过看和滑**:截图、列元素、滑动、按键这类调用重复是在读变化的屏幕,不算绕圈(`LOOP_EXEMPT`);防绕圈的拒绝也不算她在 App 里的错(她第一份小黑盒笔记学到的"list_elements 试 5 次就失败"就是它)。
321
+ - 笔记是她文件夹里的普通文件,她自己、他都能改。记忆系统没有动。
322
+
323
+ ## 0.21.1:Windows 上装得上、看得见,和 dot 设置页
324
+
325
+ 起因:Windows 用户反馈模拟器闪退、手机没网、开机超时、对话卡半小时停不下来。日志里是:显卡渲染崩溃(0xC0000005)、崩溃上报弹窗挡住了自动重启、安卓的联网检测连不上 Google(显示"连接受限")、电脑镜像从 ghcr.io 拉不下来时一直停在"下载中",以及电脑没起来时 shell 命令无限等待。
326
+
327
+ - **不卡对话**:电脑还在下载 / 开机时命令立即返回原因("不用等"),重新挂载最多等 2 分钟且能被停止按钮打断;所有直接调用的 adb 带插件自己的端口和 30 秒超时。
328
+ - **手机**:Windows 默认软件渲染(`phone.gpu` 空 = `swiftshader_indirect`);联网检测默认国内地址(`phone.connectivityCheck: cn`);可选 `phone.dnsServer`、`phone.proxy`(默认不开:校园网等封外部 DNS);开机超时 10 分钟、超过 5 分钟提示"开机较慢";启动串行化(重启会取代进行中的开机),子进程 `error`、30 分钟内的反复崩溃都会停下来报原因;手机没就绪时不再轮询通知栏刷日志;`windowsHide`、默认冷启动(`phone.quickBoot`)、启动前 `-accel-check`。
329
+ - **电脑**:默认镜像改为作者官方的国内镜像(火山引擎,与 ghcr 同一镜像);拉镜像前先测连通,连不上几秒内报错并给修法。
330
+ - **体检**:`/phone doctor`(不再依赖 dot 组件),虚拟化、磁盘、内存(Windows 页面文件,已在跑的不重复算)、端口占用(BlueStacks 的 5555 等)、下载源、手机网络、模拟器崩溃;能修的带一键修复(`/phone doctor fix <id>`)。首次启动和手机出错时自动跑。
331
+ - **dot 设置页**(左侧栏「dot 设置」,设计见 `docs/DOT-PAGE.md`):开始(六步引导:体检、组件、手机、电脑、人设、QQ)、状态、设置(按 `src/settings-schema.js` 生成的表单,写 `~/.dsh/dsh-dot.json`)、体检(一键修复)、诊断(打码的诊断包下载 / 存到 `~/.dsh/diag/`,复制摘要)、危险区(重建手机、清下载缓存)。首次打开 dsh 右下角提示一次。挂在插件根组件上,只开部分组件也能用。
332
+ - `dsh-dot.json` 格式坏了会在 `/phone` 和页面上直接显示,不再只进日志。
333
+
334
+ ## 0.22.0:和 qq-bridge 共处
335
+
336
+ 起因:很多人先装了 [qq-bridge](https://github.com/Derpyu520/qq-bridge),再想要这里的手机和虚拟机。逐组件对过两边源码(`docs/qq-bridge.md`):dot、记忆、幕间、面板本来就只认她自己的会话,没有冲突;冲突在三处——我们注册的全局工具会进它的会话(白名单拒掉,但每条消息多带几十个工具说明;它私聊模式下 `account` 能把她的 App 密码交出去)、电脑组件会把它的目录共享进虚拟机(重建一次,她的 QQ 掉线)、她和它的机器人在一个群里会互相回复。反过来,它 patch 进 dsh 的三个 MCP server 也会出现在她的会话里。
337
+
338
+ - **新组件 `compat`**(`src/compat/qq-bridge.js`,总是开着,只在找到 qq-bridge 时起作用):顺着 `~/.dsh/plugins/qq-agent-presets` 找到它的 `config.json` / `state/mode.json`;一个 `owner(session)` 回答会话归谁(`dot` / `qqb-sandbox` / `qqb-owner` / `other`),其他组件只问它。
339
+ - **工具可见性**:`agent/created` 里按归属 `tools.restrict({ deny })`(dsh 的 restrict 取交集,和它自己的叠加),`tools/change` 时重算,执行期 guard 兜底。她的工具只在她的会话;手机电脑另给 closed-agent 的管理员私聊;qq-bridge 的工具不进她的会话。工具归类在 `src/tool-prefixes.js`,测试和源码对账。
340
+ - **电脑**:qq-bridge 的目录不共享(命令在虚拟机家目录跑);管理员私聊可选 `host`。
341
+ - **QQ**:自动忽略它的机器人号(从它的 SnowLuma 配置读)+ `qq.ignore`;防互刷熔断(`loopMax` / `loopCooldownMinutes`),对任何机器人有效。
342
+ - **体检**:同号、同群、读不到机器人号。
343
+ - `dot.scope: all` 也不再把 `qqb-*` 当她的。
@@ -0,0 +1,147 @@
1
+ # dot 页面(设计稿,已定)
2
+
3
+ 左侧栏一个 dot 入口,点进去是一整页:装、设、查、导,全在这里点,不用敲命令。命令照留(老用户、agent、老版本 dsh 用)。
4
+
5
+ ## 目标
6
+
7
+ - 新用户装完插件,第一次打开 dsh 就被引到这页,一路点按钮完成初始化
8
+ - 所有设置能在这页改,改的就是 `~/.dsh/dsh-dot.json`(手改、agent 改、页面改是同一份)
9
+ - 出问题时:一键体检、能修的一键修、一键导出打码后的日志包
10
+ - 任意组件组合都能用(只开手机 + 电脑的 runtime 用法也行)
11
+
12
+ 不做:替代 dsh 的插件页(组件开关仍在那边);记忆/幕间的设置项本轮不接(lean-memory 刚合并,等稳定后再接)。
13
+
14
+ ## 挂载点(dsh 已有的客户端插槽)
15
+
16
+ | 插槽 | 用途 |
17
+ |---|---|
18
+ | `sidebar.panellist` | 左侧栏 dot 图标(id `dsh-dot`) |
19
+ | `main`(key `dsh-dot`) | 中间整页 |
20
+ | `settings.onboarding` | 首次打开 dsh 时一步提示:"dot 还没装好 → 去设置";装好了自动 complete |
21
+ | `plugins.bundle.config`(key `dsh-dot-life`) | 插件页里本插件的页面放一行"在 dot 页面里设置"+ 跳转 |
22
+
23
+ 右侧栏面板保留,定位是 dot 的生活(她在干什么、手机画面);设置、体检、导出都在这一页,不放右侧栏。
24
+
25
+ 前端代码在 `ui/`,挂在 **dot-ui 组件**(插件根,组件列表里的 `dsh-dot-life`)上,不挂 dot 组件,关了 dot 也在。老版本 dsh 没有这些插槽时不挂,命令照常。
26
+
27
+ ## 页面结构
28
+
29
+ 顶部一行状态条:手机 / 电脑 / QQ / dot 各一个小灯 + 一句话(就绪、下载 57%、出错…),点了跳到对应位置。
30
+
31
+ ### 1. 开始(未完成初始化时默认打开)
32
+
33
+ 一列步骤卡片,每张:标题、为什么要做、一个主按钮、做完打勾。中途关掉下次从断点继续(进度存 `~/.dsh/dsh-dot-setup.json`)。
34
+
35
+ 1. **检查这台电脑**:自动跑体检;❌ 项旁边有「修复」按钮或照做的命令;全绿或用户点「我知道了」进下一步
36
+ 2. **选组件**:列出 phone / computer / subprocess / gate / qq / memory / interlude / dot,各一句话说明、当前开关状态;开关本身跳 dsh 插件页(见"待确认 1")。推荐组合给三档:完整的 dot / 只要手机和电脑 / 只要手机
37
+ 3. **手机**:存储大小(8/16/32/64,标"建好后不能改")、渲染方式、联网检测地址(默认国内,可选国际)→「接受 Android SDK 许可并安装」→ 进度条(哪一段、MB、%、剩余时间)→ 开机 → 绿
38
+ 4. **电脑**(开了才显示):镜像源(默认国内火山引擎,可选官方 ghcr)、内存、磁盘 →「安装」→ 进度 → 绿
39
+ 5. **人设**(dot 开了才显示):粘贴 HDSI 分享码 / 选角色卡文件 → 预览名字和简介 → 确认
40
+ 6. **QQ**(qq 开了才显示):主人 QQ 号、她的 QQ 号、后端(napcat / snowluma)→「安装并显示登录二维码」→ 扫码 → 绿
41
+
42
+ ### 2. 状态
43
+
44
+ 完整版面板(右侧栏面板保留):每个组件的状态、错误原文、最近事件;手机多一行网络(已验证 / 部分连通 / 无网络);电脑多一行阶段。每块有「重启」「看日志」。
45
+
46
+ ### 3. 设置
47
+
48
+ 按组件分组的表单,组件关着的那组折叠并注明。每项:名称、说明、控件、默认值、生效方式标签:
49
+
50
+ - `即时`:保存就生效
51
+ - `重启手机` / `重启电脑`:保存后出现「现在重启」按钮
52
+ - `重启 dsh`
53
+ - `建立时`:只对新建生效;已建好的显示当前值 + 灰掉,旁边写"要改得重建(会丢 X)"
54
+
55
+ 本轮表单项:`phone` 全部、`computer` 全部、`gate.mode`、`qq` 全部、`dot` 里非提示词类的项。另加本次新增:
56
+
57
+ | 键 | 默认 | 说明 |
58
+ |---|---|---|
59
+ | `phone.gpu` | Windows `swiftshader_indirect`,其他 `auto` | 显卡崩溃(0xC0000005、`context was preempted`)时用软件渲染 |
60
+ | `phone.connectivityCheck` | `cn`(面向国内用户) | `cn` = `connect.rom.miui.com/generate_204`,`google` = 系统默认,或自填 URL;开机后写进手机设置 |
61
+ | `phone.dnsServer` | `""`(自动) | 指定给模拟器的 DNS;校园网等封外部 DNS 的网络别填 |
62
+ | `phone.proxy` | `""` | `system` = 把电脑的系统代理给手机 |
63
+ | `phone.crashDialog` | `false` | 模拟器崩溃上报弹窗(开着会卡住自动重启) |
64
+ | `phone.bootTimeoutMs` | `600000` | 开机超时;5 分钟后先显示"开机较慢" |
65
+ | `computer.image` | 国内镜像(面向国内用户) | 下拉可选官方 ghcr 和国内镜像(`enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:<版本>`) |
66
+ | `computer.whenNotReady` | `fail` | 电脑没起来时命令:`fail` 立即报原因 / `host` 先在本机执行 |
67
+
68
+ 文件解析失败时,页面顶上红条显示错误位置,表单只读,给「用默认值覆盖(先备份)」按钮。
69
+
70
+ ### 4. 体检
71
+
72
+ 就是 `/phone doctor` 的结果,分项列出;每个问题可能有:
73
+
74
+ - **一键修**(插件能直接做的):切国内电脑镜像、改联网检测地址、改用软件渲染、换 adb 端口、加开机超时
75
+ - **照做**(要管理员或系统设置的):开 WHPX、改页面文件、BIOS 虚拟化——显示命令 + 复制按钮
76
+
77
+ ### 5. 日志导出
78
+
79
+ 一个按钮「导出诊断包」,下载 `dsh-dot-diag-<时间>.zip`:
80
+
81
+ | 内容 | 处理 |
82
+ |---|---|
83
+ | `dsh-phone.log`、`dsh-computer.log`、各组件日志 | 只取最近 2 MB |
84
+ | `phone/emulator.log` | 最后 3000 行 |
85
+ | `dsh-phone-audit.jsonl` 等审计 | 最近 2000 条 |
86
+ | 体检结果 | 导出时现跑一次 |
87
+ | `dsh-dot.json` | 打码:所有含 `key`/`token`/`password`/`secret` 的键值 |
88
+ | 版本 | 插件、dsh、Node、系统、模拟器、系统镜像、电脑镜像 |
89
+ | 组件开关、当前状态 | |
90
+
91
+ 页面上另有「复制摘要」:版本、组件状态、体检的问题项、各组件最后几条错误,纯文本,方便贴 issue 或发群;同样打码。
92
+
93
+ 默认**不含**:记忆、日记、人物卡、聊天记录、账号密码文件、QQ 消息。"附带她的记忆和最近对话(排查人格问题用)"做成单独勾选,默认不勾。
94
+ 打码规则单独写测试(API key、QQ token、手机号、邮箱、`Bearer xxx`、URL 里的 `key=`)。
95
+
96
+ ### 6. 危险区(页底,折叠)
97
+
98
+ 重建手机(会丢她装的 App 和登录)、删电脑、释放下载缓存;都要输入名字确认。
99
+
100
+ ## 服务端
101
+
102
+ 新文件 `src/page/`(挂 dot-ui 组件),HTTP 路由走 dsh 的 web server,`rejectUnlessOwner` 把关(和面板、实时画面同一套):
103
+
104
+ | 路由 | 作用 |
105
+ |---|---|
106
+ | `GET /dsh-dot/api/status` | 各组件状态(面板已有的扩展) |
107
+ | `GET /dsh-dot/api/settings` | 配置定义 + 当前值 + 文件错误 |
108
+ | `PUT /dsh-dot/api/settings` | 校验后写 `dsh-dot.json`(原子写、保留 `_` 开头的键和未知键) |
109
+ | `POST /dsh-dot/api/doctor` | 跑体检 |
110
+ | `POST /dsh-dot/api/fix/:id` | 体检的一键修 |
111
+ | `POST /dsh-dot/api/action/:id` | 接受许可、安装、重启手机/电脑、QQ 二维码等,复用现有命令的实现 |
112
+ | `GET /dsh-dot/api/diag` | 诊断包 zip |
113
+ | `GET/PUT /dsh-dot/api/setup` | 引导进度 |
114
+
115
+ 组件之间不直接互相 import:各组件把自己的 `doctorInfo()`、`status()`、动作注册成服务,页面按"有就显示"取用。
116
+
117
+ ## 配置定义(单一来源)
118
+
119
+ 新文件 `src/settings-schema.js`:每个键一条 `{ section, key, type, default, enum?, min?, max?, apply: 'live'|'restart-phone'|'restart-computer'|'restart-dsh'|'create', zh, en, secret? }`。
120
+
121
+ 由它生成/驱动:组件读配置时的默认值和校验(替代各组件里散落的默认值表)、页面表单、`docs/SETTINGS.md` 的「全部键」表(脚本生成,测试检查一致)、诊断包打码(`secret: true`)。
122
+
123
+ ## 顺带修的 bug(不做成选项)
124
+
125
+ - 电脑镜像拉取失败时卡在"下载中" → 报错 + 原因
126
+ - `dsh-dot.json` 解析失败只进日志 → 页面红条、`/phone`、`/computer` 都显示
127
+ - 体检把已运行的手机/电脑内存重复计算
128
+ - 体检挪到 phone 组件(`/phone doctor`,`/dot doctor` 留作别名),自动体检跟着挪
129
+ - 启动串行化、监听子进程 `error`、慢崩溃循环
130
+ - 手机没就绪时停止读通知栏轮询
131
+
132
+ ## 交付批次
133
+
134
+ 进度:三批都已完成(第 1 批 08fd032、第 2 批 5b91a82、第 3 批:开始引导、状态、首次提示卡片、危险区)。未做:删电脑(后端没有删除接口)、电脑没就绪时回落本机执行(要连沙箱一起设计)、关掉模拟器崩溃上报弹窗(没找到可靠开关)、SETTINGS.md 由配置定义生成。页面是同源 iframe(`/dsh-dot/page/`),不需要重新编译 React,`lib/client.js` 只加了左侧栏入口和 main 面板。
135
+
136
+ 1. 配置定义、服务端接口、诊断包导出、上面的 bug 修复(无前端,命令可用)
137
+ 2. 页面骨架 + 设置 + 体检(含一键修)
138
+ 3. 开始引导 + 状态 + `settings.onboarding` + 危险区
139
+
140
+ 每批各自能发版。
141
+
142
+ ## 已定
143
+
144
+ 1. 组件开关:dsh 不开放给插件时,只显示状态 + 跳插件页。
145
+ 2. 国内默认:联网检测地址、电脑镜像源默认国内(面向用户大多在国内),设置里可改。
146
+ 3. 诊断:下载 zip,另加「复制摘要」。
147
+ 4. 右侧栏面板保留,是 dot 的生活;dot 页只管设置。
package/docs/ROADMAP.md CHANGED
@@ -1,4 +1,4 @@
1
- # dsh-dot 总体规划(2026-10-23;「现在在哪」更新于 2026-11-03,v0.12.0)
1
+ # dsh-dot 总体规划(2026-10-23;「现在在哪」更新于 2026-11-08,v0.22.0)
2
2
 
3
3
  ## 一句话
4
4
 
@@ -17,6 +17,7 @@ dot 是一个**在自己手机上过日子的角色**:有自己的手机、账
17
17
  | 她电脑上的 QQ(`qq`) | ✅ NapCat 或 SnowLuma(`/qq backend`),她用手机摄像头扫码登录(`/qq qr`);只认她的号 | 10-30 真机:SnowLuma 连上、`mcp__dot-qq__*` 挂载,她自己扫码登录 |
18
18
  | IM 通道 | ✅ QQ 连上时 dot 的提醒、幕间主动联系、她对你 QQ 消息的回答都走她的 QQ;没连上时退回 dsh-im 官方机器人。SnowLuma 下收发已实测(10-29,22 条进 38 条出);`qq_send` 对陌生人的审批只有单元测试,没有陌生人来过 | 真机 10-29 |
19
19
  | 自动召回(`memory` 的 RAG 层) | ✅ 0.12:每次叫醒前按叫醒她的话从 transcript 取原话注入;本机 bge-small-zh 默认(0.15.2 起换成 multilingual-e5-small;首次用时装库、走 hf-mirror 下模型),SiliconFlow / DashScope 可切,`/dot memory recall …` 一条命令切换 | 公开基准 108 题:74 → 96(0.15.2,真实代码路径,本机 e5);真机未跑 |
20
+ | 和 qq-bridge 共处(`compat`) | ✅ 0.22:认出 qq-bridge,按会话归属藏工具、不共享它的目录、不回它的机器人号、体检查同号/同群;它 closed-agent 的管理员私聊能用她的手机电脑 | 非 dot 会话实测:dot 的 7 个工具藏掉、手机电脑在(11-08);qq-bridge 真机未装 |
20
21
  | "玩"(点赞/评论/关注) | ✅ 代码在(playIntent → 正常轮次,Moltbook 守则),11-02 起默认开、内置 App 表按手机上装的收窄;发帖/私信不做 | 真机 0 次(之前默认关) |
21
22
 
22
23
  ## 架构(不再变的部分)
package/docs/SETTINGS.md CHANGED
@@ -26,7 +26,7 @@ dsh-dot 的所有个人设置都写在**一个文件**里:
26
26
  **给 agent 的规则**(dsh、Claude、Codex 等改这个文件时照做):
27
27
 
28
28
  1. 先读现有文件;不存在就新建 `{}`。只增改相关的键,**不要删别的段和键**。
29
- 2. 顶层按组件分段:`phone`、`computer`、`gate`、`qq`、`memory`、`interlude`、`dot`。键名和类型照下面的表,不要发明新键。
29
+ 2. 顶层按组件分段:`phone`、`computer`、`gate`、`qq`、`memory`、`interlude`、`dot`、`compat`。键名和类型照下面的表,不要发明新键。
30
30
  3. 写合法 JSON(不能有注释、尾逗号)。想留说明就用 `_` 开头的键,如 `"_note": "..."`,会被忽略。
31
31
  4. 下文标 **🔒 建立时** 的项只对新建的手机 / 虚拟机生效,改之前先告诉用户要重建、会丢什么,得到同意再动。
32
32
  5. 有专门命令的(`/phone size`、`/dot memory recall …`、`/qq owner` 等),优先告诉用户用命令,命令不用重启。
@@ -105,7 +105,11 @@ setx DSH_DOT_COMPUTER off
105
105
  | `locale` / `timezone` | `"zh-CN"` / `"Asia/Shanghai"` | 语言、时区 |
106
106
  | `number` | `""` | 她的手机号,注册登录 App 用(也可用 `/phone number`;账号密码另存 `~/.dsh/dsh-dot-accounts.json`,见 [phone.md](phone.md)) |
107
107
  | `window` | `true` | 显示模拟器窗口 |
108
- | `gpu` | `"auto"` | 模拟器 GPU 模式。`auto` 在 API 35 上可能被强制成 CPU 软件渲染(`emulator.log` 里有 `forcing software rendering`),长时间跑会被模拟器的卡死检测杀掉;Mac 上可试 `"host"`(用 Mac 显卡),见 [phone.md](phone.md) |
108
+ | `gpu` | `""` | 渲染方式。空 = Windows 用 `swiftshader_indirect`(软件渲染:显卡渲染在部分 Windows 上会崩,0xC0000005),其他系统 `auto`;也可填 `auto` / `host` / `angle_indirect` |
109
+ | `connectivityCheck` | `"cn"` | 安卓判断"有没有网"的检测地址:`cn` = `connect.rom.miui.com/generate_204`(国内能访问;默认的 Google 地址国内访问不了,会显示"连接受限"),`google` = 系统默认,或自填返回 204 的地址 |
110
+ | `dnsServer` | `""` | 给模拟器指定 DNS,如 `223.5.5.5`;空 = 用电脑的。校园网等封了外部 DNS 的网络必须留空 |
111
+ | `proxy` | `""` | 手机的流量走代理:`system` = 电脑的系统代理,或 `http://host:port`;空 = 不走 |
112
+ | `bootTimeoutMs` / `bootSlowMs` | `600000` / `300000` | 开机超时 / 超过这么久显示"开机较慢"(毫秒) |
109
113
  | `quickBoot` | `false` | Quick Boot 快照(退出存、启动读)。默认关:每次冷启动,慢一些,但被强杀后不会读到写了一半的快照 |
110
114
  | `adbPort` | `5137` | 插件自己的 adb server 端口,避开 MuMu、雷电、手机助手等自带旧 adb 占用的 5037;`0` = 用 5037 |
111
115
  | `notifyMuted` | `[]` | 不叫醒她的包名(也可用 `/phone notify mute`) |
@@ -124,7 +128,7 @@ setx DSH_DOT_COMPUTER off
124
128
  | `memory` / `cpus` | `"4G"` / `2` | 资源上限 |
125
129
  | `mounts` | `[]` | 共享文件夹 |
126
130
  | `backend` | `"auto"` | `microsandbox` / `docker` |
127
- | `image` | `ghcr.io/agent-infra/sandbox:latest` | 镜像 |
131
+ | `image` | 国内镜像 `enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:latest` | 镜像(作者官方的国内镜像,与 `ghcr.io/agent-infra/sandbox:latest` 同一镜像;海外用户可改回 ghcr)🔒 建立时 |
128
132
  | `publicUrl` | `""` | 你对外暴露的 dsh 地址 |
129
133
 
130
134
  网关端口只能用环境变量 `DSH_COMPUTER_PORT` 改。
@@ -153,6 +157,9 @@ setx DSH_DOT_COMPUTER off
153
157
  | `typingMsPerChar` | `60` | 分条发送的打字停顿,0 一次发完 |
154
158
  | `tidy` | `true` | 去掉句号、引号、破折号等书面符号 |
155
159
  | `dropLatinLeaks` | `true` | 不发整条都是英文的气泡(思考漏出来),短英文照发 |
160
+ | `ignore` | `""` | 不回复的 QQ 号(别的机器人),逗号或空格分开;qq-bridge 的机器人号自动认出,不用填 |
161
+ | `loopMax` | `4` | 防互刷(只管群聊):一个群里和同一个号一来一回这么多轮、中间没别人说话,就暂停理它;0 关 |
162
+ | `loopCooldownMinutes` | `10` | 防互刷暂停多久 |
156
163
 
157
164
  ### `memory`
158
165
 
@@ -203,6 +210,8 @@ setx DSH_DOT_COMPUTER off
203
210
  | `enabled` | `true` | `false` 关掉联系人层 |
204
211
  | `home` | `~/dot` | 和另外两处保持一致 |
205
212
  | `phoneCheckEveryMinutes` | `30` | 隔多久拿起手机看一眼,0 关 |
213
+ | `manuals` | `true` | 她的会话里,手机那段和手机、电脑的 MCP 说明不每轮都带:换成一行,第一次用手机 / 电脑工具时那一下照常执行,说明书跟着结果一起给她(`dot.manuals.*` 提示词);`false` 恢复每轮都带 |
214
+ | `howto` / `howtoMinSteps` / `howtoMaxChars` | `true` / `12` / `800` | 她自己的 App 经验(`~/dot/her/howto/`):每轮按 App 记步数;走了 `howtoMinSteps` 步以上或出过错的那轮,结束后一次小调用整理这个 App 的笔记(教训、捷径);之后一个会话里第一次打开这个 App 时笔记跟着给她。`/dot howto` 看每个 App 的步数变化 |
206
215
  | `promptsPort` | `7870` | `/dot prompts` 提示词页面的端口(只监听 127.0.0.1) |
207
216
  | `notifyHours` | `""` | 只在这个时段内通知叫醒她;空 = 一直 |
208
217
  | `notifyBatchMs` | `1000` | 多少毫秒内的通知合并成一次叫醒(别人的;你的话见下面四项) |
@@ -222,6 +231,17 @@ setx DSH_DOT_COMPUTER off
222
231
  | `approvalWaitMs` | `600000` | 她的会话里要审批时立刻告诉你(QQ 连着发 QQ,否则 IM;一轮只发第一条,后面的只计数);这么久没人点就当拒绝,再告诉你一句过期了;0 = 一直等 |
223
232
  | `imBot` / `imTarget` | `""` | dsh-im 的投递目标,空 = 第一个 |
224
233
 
234
+ ### `compat`(和 qq-bridge 共处,见 [qq-bridge.md](qq-bridge.md))
235
+
236
+ | 键 | 默认 | 作用 |
237
+ |---|---|---|
238
+ | `qqBridge` | `"auto"` | `auto` 装了 qq-bridge 就认 / `true` / `false` |
239
+ | `qqBridgeRoot` | `""` | 自动找不到时填它的目录 |
240
+ | `ownerDevices` | `true` | qq-bridge closed-agent 模式的管理员私聊能用她的手机和电脑 |
241
+ | `ownerComputer` | `"vm"` | 那个私聊里的命令:`vm` 她的电脑(不共享它的目录)/ `host` 本机 |
242
+ | `hideBridgeTools` | `true` | 她的会话里不出现 qq-bridge 的 MCP 工具 |
243
+ | `refreshMs` | `5000` | 多久重读一次它的配置 |
244
+
225
245
  ## 优先级和旧文件
226
246
 
227
247
  从弱到强:组件默认值 → 旧的单组件文件(`~/.dsh/dsh-phone.json`、`dsh-computer.json`、`dsh-qq.json`)→ 插件自带的 `cordis.patch.yml` → **`dsh-dot.json`** → 命令设的值(`/phone size`、`/phone accept`、`/phone number`、`/dot memory recall …` 写进 `dsh-phone.json` / `dsh-memory.json`)。
package/docs/interlude.md CHANGED
@@ -109,6 +109,7 @@ dsh 这边不需要重做一个对话系统——对话由 dsh 自己跑,IM
109
109
  | `canon` | 无 | HDSI `storyDefaults` 对象,作为初始人设;导入过预设后以 `canon.json` 为准 |
110
110
  | `trimSections` | `harness:identity, deployment:persona-prefix, context:file-reference` | 主角的会话里从系统提示删掉的段(dsh 的「You are an AI agent / coding agent」开头,社区公认的 AI 味来源),让 Canon 成为第一段;`[]` 不删 |
111
111
  | `canonOnly` | `false` | `true` 时主角的会话只保留 Canon、dot 规则和 MCP(虚拟机)工具段 |
112
+ | `voice` | `true` | 她和他的对话里,每轮最后(记忆、原话、幕间数据之后)放一两句「怎么说话」:人设里填了「说话提醒」(canon.json 的 `voice`)就用它,空着用 `interlude.voice`;跑腿会话不带 |
112
113
  | `presetHub` | `https://typ0.space` | HDSI 预设分享站 |
113
114
  | `identityFile` | 无 | 可选:额外追加到 Canon 后面的文本文件 |
114
115
  | `idleMinutes` | `10` | 安静多久算一幕结束 |
package/docs/prompts.md CHANGED
@@ -27,6 +27,9 @@
27
27
  | | 定时任务那一轮 | `dot.scheduled` |
28
28
  | | 手机/电脑还在装(只在第一次装、开机没好时) / 装好那一刻 | `dot.setup` / `dot.setup-done` |
29
29
  | | 记忆 / 想起的原话 | `memory.standing` / `memory.recall.header` |
30
+ | | 她自己的经验(进 App 时给) | `dot.howto.given` `dot.howto.no-notes`;整理经验的调用 `dot.howto.reflect` |
31
+ | | 说明书(第一次用时才给) | `dot.manuals.hint` `.what` `.deny` |
32
+ | | 说话提醒(最后一段) | `interlude.voice`(人设里的「说话提醒」优先) |
30
33
  | 叫醒她的消息 | 他的 QQ 消息 | `dot.owner-words`(她这轮进行中插进来时多一行 `dot.owner-words.busy`) |
31
34
  | | 他插话了 | `dot.owner-interrupt`(发给他的 `qq_send` 被拦下的理由)/ `qq.send-interrupted`(气泡发到一半他说话) |
32
35
  | | 审批过期 | `dot.approval-timeout`(`dot.approvalWaitMs` 没人点时她看到的工具结果,替换 dsh 的 "the user rejected tool") |
@@ -0,0 +1,77 @@
1
+ # 和 qq-bridge 一起用
2
+
3
+ [qq-bridge](https://github.com/Derpyu520/qq-bridge) 是把 QQ 群接进 dsh 的桥:它自己跑一个进程,用 dsh 的 web API 建会话、收发消息。很多人先装了它,再想要 dsh-dot 的**手机和虚拟机**。这一页说两边怎么共处——全部改动在 dsh-dot 这边,qq-bridge 一个字节不用动。
4
+
5
+ ## 结论先说
6
+
7
+ | 你要的 | 做法 |
8
+ |---|---|
9
+ | qq-bridge 照常跑,她的组件一个都别碰它 | 什么都不用设。装了 qq-bridge 就自动认出(`compat.qqBridge: auto`):它的会话里不会出现 dot 的任何工具,它的目录不会被共享进她的虚拟机,它的机器人号她不回 |
10
+ | **只要手机和虚拟机,给 qq-bridge 的管理员私聊用** | qq-bridge 切到 **closed-agent 模式**(它的控制台或 `state/mode.json`)。这个模式下只有管理员私聊能建会话,用的是 dsh 默认 preset、全工具面;dsh-dot 把她的手机(`mcp__dot-phone__*`)和电脑(`mcp__dot-vm__*`、`bash` 进虚拟机)给这个会话,其他的(记忆、她的 QQ、账号库)不给。dot / 记忆 / 幕间 / QQ 组件可以在 dsh 插件页关掉,只留 phone + computer |
11
+ | 她和 qq-bridge 的机器人在同一个群 | 她自动不回它(号从它的 SnowLuma 配置里读);它会不会回她看它自己的黑名单(`deny.private` / `deny.groups`)。`/dot doctor` 会列出共同的群 |
12
+
13
+ ## 它在 dsh 里长什么样
14
+
15
+ - 会话 ID `qqb-g-<群号>-<随机>`(群)/ `qqb-p-<QQ号>-<随机>`(私聊);所有会话共用一个工作目录(它的 `state/agents`,或 `sessionCwd`);黑话学习会话在 `state/slang-agent`。
16
+ - 模式 `chat` / `reserved` / `reserved2`:会话挂它自己的 `qq-chat` / `qq-chat-v2` preset——工具白名单,`bash`、`read` 等本地工具在注册期就被藏掉。**私聊也一样**,所以这些模式下给它手机也用不了(会被它自己拒绝),dsh-dot 一律当沙箱会话处理。
17
+ - 模式 `closed-agent`:只有 `ownerQQ` 的私聊能建会话,dsh 默认 preset,全工具面。
18
+ - 它往 dsh 的 profile 里 patch 了三个全局 MCP server:`snowluma`、`snowluma-host`、`web-search-safe`——这些工具本来会出现在**她的**会话里。
19
+ - `~/.dsh/plugins/qq-agent-presets` 和 `qq-mode-console` 是指向它仓库的链接:dsh-dot 顺着找到它的 `config.json` 和 `state/`。
20
+
21
+ ## dsh-dot 做了什么(`compat` 组件,`src/compat/qq-bridge.js`)
22
+
23
+ **1. 每个会话归谁。** 一个函数回答,别的组件只问它:
24
+
25
+ | 判定 | 条件 |
26
+ |---|---|
27
+ | `dot` | 她的:工作目录在 `~/dot` 下,或 dsh-im 开的会话,或她的跑腿 |
28
+ | `qqb-sandbox` | `qqb-g-*`;`qqb-p-*` 且会话 preset 是 `qq-chat*`(dsh 记在会话头里;没记的看它的 `state/mode.json`,不是 closed-agent 就算沙箱);工作目录在它 `state/` 下的其他会话 |
29
+ | `qqb-owner` | `qqb-p-*` 且 preset 不是 `qq-chat*`(或模式是 closed-agent) |
30
+ | `other` | 其他所有会话 |
31
+
32
+ `qqb-*` 会话**永远不是她的**,哪怕 `dot.scope` 设成 `all`。
33
+
34
+ **2. 工具可见性。** dsh 的 `agent/created` 事件里按归属 `tools.restrict({ deny })`,全局工具集变了(她的虚拟机起来、手机挂上)就重算;另加一个执行期 guard 兜底。dsh 的 restrict 是**取交集**,和 qq-bridge 自己的 restrict 叠加、互不覆盖。
35
+
36
+ | 会话 | 藏掉 |
37
+ |---|---|
38
+ | `dot` | qq-bridge 的 `mcp__snowluma__*`、`mcp__snowluma-host__*`、`mcp__web-search-safe__*`(`compat.hideBridgeTools`) |
39
+ | `qqb-sandbox` | dsh-dot 的全部:`memory` `recall` `account` `doings` `tell_him` `qq_send` `qq_sticker_keep` `phone_zoom`、`mcp__dot-phone__*`、`mcp__dot-vm__*`、`mcp__dot-qq__*` |
40
+ | `qqb-owner` | 她自己的:`memory` `recall` `account` `doings` `tell_him` `qq_send` `qq_sticker_keep`、`mcp__dot-qq__*`;手机和电脑给(`compat.ownerDevices`) |
41
+ | `other` | 她自己的那些(`account` 里存着她 App 的密码,不给任何第三方会话);手机电脑照旧 |
42
+
43
+ 名单在 `src/tool-prefixes.js`(`DOT_TOOLS` / `DEVICE_TOOL_PREFIXES`),测试会把它和源码里所有 `tools.register` 对账,加工具忘了归类会直接红。
44
+
45
+ **3. 电脑。** subprocess provider 只看得到命令的 cwd:
46
+
47
+ - qq-bridge 的目录**永远不共享进虚拟机**(共享要重建虚拟机,她虚拟机里的 QQ 会掉一次线;它 `state/` 下的东西也不该进去)。命令在虚拟机的家目录跑。
48
+ - closed-agent 模式下那个目录就是管理员私聊的:`compat.ownerComputer: vm`(默认)进她的电脑;`host` 走 dsh 自带的本机执行,相当于没装 dsh-dot。
49
+ - 审批不动:它自己会把 `approval/requested` 转到 QQ。
50
+
51
+ **4. QQ。** 她的 QQ 组件:
52
+
53
+ - 自动忽略 qq-bridge 的机器人号(从它 `config.json` 的 `snowluma.homeDir`(或 `SNOWLUMA_HOME`)下的 `config/onebot_<号>.json` 读;读不到体检会提示);`qq.ignore` 手动加别的号。被忽略的消息不叫醒她、不打分、不记忆。管理员(`qq.owner`)永远不忽略。
54
+ - 防互刷熔断:一个聊天里和同一个号一来一回 `qq.loopMax`(默认 4)轮、中间没别人说话,她就 `qq.loopCooldownMinutes`(默认 10)分钟不理那个号。不依赖 qq-bridge,对任何机器人有效。记 `loop-break`。
55
+ - `/qq` 状态里有一行 `not answered: …`。
56
+
57
+ **5. 体检。** `/dot doctor` / `/phone doctor` / dot 页面:找到 qq-bridge 时列出它的目录、模式、机器人号;❌ 她的号和它的机器人号相同(互相挤下线)、她的号是它的 `ownerQQ`;⚠️ 读不到它的机器人号、两边在同一个群。
58
+
59
+ ## 设置(`~/.dsh/dsh-dot.json` 的 `compat` 段)
60
+
61
+ | 键 | 默认 | 作用 |
62
+ |---|---|---|
63
+ | `qqBridge` | `"auto"` | `auto` 装了就认;`true` 没找到会提示;`false` 不管它(`DSH_DOT_COMPAT=off` 整个组件关掉) |
64
+ | `qqBridgeRoot` | `""` | 自动找不到时填它的目录(里面有 `config.json`) |
65
+ | `ownerDevices` | `true` | closed-agent 的管理员私聊能用她的手机和电脑 |
66
+ | `ownerComputer` | `"vm"` | 那个私聊里的命令在哪跑:`vm` 她的电脑(不共享它的目录)/ `host` 本机 |
67
+ | `hideBridgeTools` | `true` | 她的会话里不出现 qq-bridge 的 MCP 工具 |
68
+ | `refreshMs` | `5000` | 多久重读一次它的 `config.json` / `mode.json` |
69
+
70
+ `qq` 段新增:`ignore`(不回的号,逗号分开)、`loopMax`、`loopCooldownMinutes`(防互刷只管群聊,私聊不限)。
71
+
72
+ ## 没做的
73
+
74
+ - **SnowLuma 的部署**:qq-bridge 只连接用户自己装好的 SnowLuma;dsh-dot 的 `/qq install snowluma` 会在虚拟机里自动装(许可证问题另议)。两边各装各的互不影响,但**不要登录同一个号**。
75
+ - 不改 qq-bridge 的任何文件;要不要在它那边把她的号拉黑,由用户决定。
76
+ - 没有 `config.json` 的 qq-bridge 目录不算装了(它自己也不启动)。
77
+ - 关掉 dot 组件时,dsh-dot 只是手机和虚拟机的通道:qq 组件也应一起关掉(她的 QQ 工具只给她的会话,没有 dot 就没有她的会话)。