dsh-session-conductor 1.3.18 → 1.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +95 -312
- package/lib/apply.js +22 -8
- package/lib/client.js +17 -5
- package/lib/core/domain-fallback.js +93 -0
- package/lib/core/domain.js +37 -7
- package/lib/features/member-model/batch.js +2 -2
- package/lib/features/member-model/command.js +7 -5
- package/lib/features/member-model/create-teammate.js +3 -1
- package/lib/features/member-model/switch.js +76 -18
- package/lib/features/member-model/tools.js +15 -3
- package/lib/features/memory-recall/index.js +10 -36
- package/lib/features/session-ops-routes.js +21 -0
- package/lib/sessions/events.js +6 -17
- package/lib/sessions/export-restore.js +384 -0
- package/lib/sessions/log-stream.js +68 -0
- package/lib/sessions/member-trace.js +343 -0
- package/lib/sessions/resolve.js +120 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,312 +1,120 @@
|
|
|
1
1
|
# dsh-session-conductor
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
DSH 会话管理增强插件：面板管理会话、批量删除与回收站、损坏修复、自动续跑、模板注入，以及成员（子代理）的模型/权限/换名管理。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## 功能
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
## 功能总览
|
|
10
|
-
|
|
11
|
-
| 功能 | 说明 | 入口 |
|
|
7
|
+
| 功能 | 做什么 | 入口 |
|
|
12
8
|
|---|---|---|
|
|
13
|
-
| 会话管理面板 |
|
|
14
|
-
| 回收站 |
|
|
15
|
-
| 自动重命名 |
|
|
16
|
-
| 自动续跑 |
|
|
17
|
-
| 会话分组 |
|
|
18
|
-
| 撤回最后一条消息 |
|
|
19
|
-
| 损坏修复 |
|
|
20
|
-
| 价值分析 | LLM
|
|
21
|
-
| 全文搜索 |
|
|
22
|
-
|
|
|
23
|
-
| 模板注入 |
|
|
24
|
-
| 自动重命名模型 |
|
|
25
|
-
| 成员模型切换 |
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
会话管理面板（侧边栏入口）：
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
设置页 · 模板注入（设置 → 会话管理）：
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
## 环境要求（支持的 DSH 版本）
|
|
9
|
+
| 会话管理面板 | 五视图（全部/已归档/活跃/回收站/说明）；归档、删除、撤回、置不活跃、释放空闲 | 侧边栏「会话管理」 |
|
|
10
|
+
| 回收站 | 删除只打标记，可单条/多选/按批次还原；到期或一键清空才真删盘 | 面板「回收站」 |
|
|
11
|
+
| 自动重命名 | 回合后分析内容，主题偏离时生成新标题 | 面板逐会话开关 |
|
|
12
|
+
| 自动续跑 | 识别非人为中断并继续原任务，失败 30s 重试 | 面板逐会话开关 |
|
|
13
|
+
| 会话分组 | 按工作区分组显示；分组下新建会话 | 设置 → 插件 → 会话分组 |
|
|
14
|
+
| 撤回最后一条消息 | 删除最后一条用户消息及整轮回复（预览 + 二次确认 + 备份） | 面板按钮 |
|
|
15
|
+
| 损坏修复 | seq-gap / EIO 坏块 / 双格式 / zstd 帧级损坏 四类 | 面板「说明」页 + `/repair` 系列 |
|
|
16
|
+
| 价值分析 | LLM 给会话分类（已完成/未完成/久未活跃/活跃中） | 面板按钮 |
|
|
17
|
+
| 全文搜索 | FTS5 优先，内置 zstd 扫描兜底 | 面板搜索框 |
|
|
18
|
+
| 压缩模型 | 上下文自动压缩使用独立模型 | 设置 → 插件 → 压缩模型 |
|
|
19
|
+
| 模板注入 | 方案/收尾模板；本地文件、在线网址、目录浏览三种导入 | 设置 → 会话管理 |
|
|
20
|
+
| 自动重命名模型 | 指定标题分析用的模型 | 设置 → 会话管理 |
|
|
21
|
+
| 成员模型切换 | 切单个或全部成员的模型，可跟随主代理 | `/model-switch`、`set_member_model` |
|
|
22
|
+
| 成员权限预设 | 查看/切换成员权限预设，支持批量与跟随 | `/perm-switch`、`set_member_permission` |
|
|
23
|
+
| 成员换名 | 新建成员并把原会话内容搬进去 | `clone_member_as` |
|
|
24
|
+
| 创建成员并选模型 | 创建时即指定模型，首轮就用它 | `create_teammate_with_model` |
|
|
25
|
+
| 指定模型新建会话 | 新建会话并直接指定 provider/model | `create_session` |
|
|
26
|
+
| 记忆取回 | 上下文用量骤降时自动回注最近几轮对话 | 自动注入 + `recall_memory` |
|
|
27
|
+
| 上下文用量 | 查自己会话的占用与构成 | `context_usage` |
|
|
28
|
+
| 跨会话消息 | 给另一个会话发消息，空闲时自动唤醒 | `list_sessions`、`send_to_session` |
|
|
29
|
+
| 成员轨迹 | 读子代理的完整执行过程：思考、正文、工具调用与结果 | `read_member_trace` |
|
|
30
|
+
|
|
31
|
+
## 环境要求
|
|
45
32
|
|
|
46
33
|
| 项 | 要求 |
|
|
47
34
|
|---|---|
|
|
48
|
-
|
|
|
49
|
-
| Node |
|
|
35
|
+
| DSH | **0.2.1 及以上**（更早版本功能可用，但列表缓存不生效，会话多时列表构建变慢） |
|
|
36
|
+
| Node | 与宿主自带的 Node 一致 |
|
|
50
37
|
| 平台 | Linux（群晖 DSM / fnOS 等）；纯 Node 实现，无原生依赖 |
|
|
51
38
|
|
|
52
|
-
|
|
53
|
-
**`SessionPersistenceSnapshot`**（`{ header, revision, eventCount?, sizeBytes? }`）里的 `revision`
|
|
54
|
-
作为「日志变过没有」的变更令牌。0.2.1 起该 API 稳定提供 `revision`；更早的版本里
|
|
55
|
-
`list()` 只给裸 header（没有 `revision`），插件会**优雅降级**：功能全部正常，
|
|
56
|
-
只是每次列表构建都要重新解析会话日志（会话多、日志大时会明显变慢、内存占用高）。
|
|
57
|
-
|
|
58
|
-
> 早期代码曾探测 `persistence.listSnapshots()` 并期望它返回 `{ header, revision }` ——
|
|
59
|
-
> 该 session 级方法**在任何 DSH 版本里都不存在**（0.1.6 里同名的 `listSnapshots(profileDir)`
|
|
60
|
-
> 是 profile 快照，另一套东西），所以那个探测永远失败、缓存从未生效过。
|
|
61
|
-
> 1.2.0 起统一改用 `list()` 并按快照解析。
|
|
62
|
-
|
|
63
|
-
## 安装
|
|
64
|
-
|
|
65
|
-
装到哪个 profile 由 `--profile` 指定。`dsh plugin` 会把后面的参数**转发给该 profile 目录下的 pnpm**，
|
|
66
|
-
因此第 2 步与「直接在该 profile 目录执行 pnpm」等价（该命令会初始化首次使用的 profile）。
|
|
67
|
-
|
|
68
|
-
1. **把插件源码放进 profile 的真实目录**（目录拷贝，不要软链）：
|
|
69
|
-
```
|
|
70
|
-
<DSH_HOME>/profiles/<profile>/local-plugins/dsh-session-conductor/
|
|
71
|
-
```
|
|
72
|
-
2. **用 dsh 在该 profile 里装依赖**（写入 profile 的 `package.json` 与 `node_modules/`）：
|
|
73
|
-
```
|
|
74
|
-
dsh plugin --profile <profile> add file:local-plugins/dsh-session-conductor
|
|
75
|
-
dsh plugin --profile <profile> install
|
|
76
|
-
```
|
|
77
|
-
装完 profile `package.json` 的 `dependencies` 里应出现
|
|
78
|
-
`"dsh-session-conductor": "file:local-plugins/dsh-session-conductor"`。
|
|
79
|
-
3. **bundle 形态再补 loader 行**：把插件名加进 profile `package.json` 的 `dsh.profile.bundles`；
|
|
80
|
-
插件自带的 `cordis.patch.yml` 必须用顶层 `- insert:` **新建** loader 行 —— 顶层 `- id:` 是"覆盖已有行"，
|
|
81
|
-
基座没有该 id 时市场会报 `patch target not found`。
|
|
82
|
-
4. **装前预演、装后确认**：装前先 dry-run（确认插件入口能被 import、patch 能进组合树、不破坏现有插件组合）；
|
|
83
|
-
装完重启宿主，并在实例日志里确认该插件 `loaded`。
|
|
84
|
-
|
|
85
|
-
> 为什么放在 profile 的 `local-plugins/` 而不是全局：插件与宿主版本强绑定，放在 profile 内可随实例
|
|
86
|
-
> 独立升级，也不会让多个 profile 互相污染。
|
|
87
|
-
|
|
88
|
-
### 从 GitHub 安装（可选）
|
|
89
|
-
|
|
90
|
-
本仓库是公开仓库，可直接用 GitHub 源安装。
|
|
91
|
-
|
|
92
|
-
⚠️ **`dsh plugin --profile <名> add …` 当前实测会挂死且零输出**（两次都以 timeout 结束、日志为空）⇒
|
|
93
|
-
安装请在**该 profile 目录里直跑 pnpm**（`dsh plugin` 的设计是把参数转发给 profile 的 pnpm，两者本应等价，
|
|
94
|
-
但转发这条路目前不可用）：
|
|
95
|
-
|
|
96
|
-
```bash
|
|
97
|
-
cd <DSH_HOME>/profiles/<profile>
|
|
98
|
-
pnpm add github:EIGHTfs/dsh-session-conductor#<commit>
|
|
99
|
-
# 等价写法：pnpm add git+https://github.com/EIGHTfs/dsh-session-conductor.git#<commit>
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
**前置条件**：
|
|
103
|
-
|
|
104
|
-
1. **本机要有 `npm`** —— pnpm 构建 git 来源的包时会在临时目录执行 `npm install`；
|
|
105
|
-
缺 npm 时表现为 `ERR_PNPM_PREPARE_PACKAGE` + `spawn ENOENT: npm: command not found`。
|
|
106
|
-
2. **pnpm 11 默认禁止 git 源依赖执行构建脚本** —— 仅**带 `prepare`/`prepack` 的插件**需要放行
|
|
107
|
-
（例：dsh-git-push 的 prepare 构建不入库的 `lib/client.js`）。**本仓库没有 prepare/prepack ⇒ 无需这一步**；
|
|
108
|
-
若安装的是那类插件，先在 profile 的 `pnpm-workspace.yaml` 里加：
|
|
109
|
-
|
|
110
|
-
```yaml
|
|
111
|
-
allowBuilds:
|
|
112
|
-
<包名>@https://codeload.github.com/<owner>/<repo>/tar.gz/<commit>: true
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
⚠️ key 里带 commit 哈希 ⇒ 换版本/换提交要同步改这一行；否则报 `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`。
|
|
116
|
-
|
|
117
|
-
- 用 `#<commit>` 固定版本（本仓库远端暂无 tag，写 `#v1.0.x` 会拉不到）；公开仓库匿名可装，私有仓库才需凭据。
|
|
118
|
-
- 装完同样要做上面的第 3、4 步（`dsh.profile.bundles` + `cordis.patch.yml` 的 `- insert:` + 重启确认 `loaded`）。
|
|
119
|
-
|
|
120
|
-
## 使用
|
|
121
|
-
|
|
122
|
-
### 会话管理面板
|
|
123
|
-
|
|
124
|
-
点击侧边栏底部「会话管理」按钮展开浮层面板：
|
|
39
|
+
## 用法
|
|
125
40
|
|
|
126
|
-
|
|
127
|
-
- **已归档**：列出被归档的会话，可恢复（取消归档）、删除
|
|
128
|
-
- **活跃**：当前活跃（live/running）的会话
|
|
129
|
-
- **回收站**：列出被删除（只打了标记）的会话，显示删除时间与剩余天数；五个操作：**设置保留天数**、**撤销上次删除**（还原最近一个批次）、**还原选中**、**全选**、**一键清空**（二次确认后立即真删）。单条也能点行内「还原」
|
|
130
|
-
- **说明**：损坏修复（seq-gap / EIO / 双格式）+ 使用说明
|
|
41
|
+
### 面板与设置页
|
|
131
42
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
43
|
+
- **面板**：侧边栏底部「会话管理」展开。五个视图分别是全部、已归档、活跃、回收站、说明。
|
|
44
|
+
行内可归档、删除、撤回最后一条消息、开关自动重命名/自动续跑；顶部可搜索、价值分析、释放全部空闲。
|
|
45
|
+
- **设置页**：左侧栏「会话管理」独立页。模板注入（方案/收尾两个槽位，可上传本地 md、填在线网址、
|
|
46
|
+
浏览 DSH 目录导入，导入后可再编辑）与自动重命名模型选择。
|
|
135
47
|
|
|
136
|
-
###
|
|
48
|
+
### 聊天框指令
|
|
137
49
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
- **模板注入**：方案模板 / 收尾模板两个槽位。每个槽位下拉选导入方式：
|
|
141
|
-
- **本地文件**：从设备选择上传（系统文件选择器）
|
|
142
|
-
- **在线 md 网址**：输入网址，后端下载转存
|
|
143
|
-
- **DSH 目录浏览**：路径选择悬浮窗（目录树 + 路径输入，点 .md 选中后导入）
|
|
144
|
-
导入内容显示在编辑框（动态高度、自动换行），**可再次编辑并保存**；开启后注入系统提示词，AI 一开始就看见（方案/收尾各一条上下文注入）。
|
|
145
|
-
- **自动重命名模型**：选择标题分析用的模型（跟随会话模型或指定便宜/专用模型）
|
|
146
|
-
|
|
147
|
-
### 真实后端预览页
|
|
148
|
-
|
|
149
|
-
改 UI 后免重启查看效果 —— **预览能力已移出本插件**，统一用独立插件 `dsh-useful-tools`（**0.1.11**）的 `preview` / `minihost` 工具。
|
|
150
|
-
|
|
151
|
-
**最短三行（实测可用；本仓库没有 `assets/preview.spec.mjs` 也能出真实界面）**：
|
|
50
|
+
`/model-switch` —— 查看/切换成员模型：
|
|
152
51
|
|
|
153
52
|
```
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
53
|
+
/model-switch # 无参：列出成员与各自模型
|
|
54
|
+
/model-switch writer # 只给成员：查它实际在用的模型
|
|
55
|
+
/model-switch writer sa6400/deepseek-v4.1-flash # 成员 + 模型：切换
|
|
56
|
+
/model-switch * auto # 成员写 * = 全部；模型写 auto = 跟随我
|
|
157
57
|
```
|
|
158
58
|
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
**要点**：
|
|
59
|
+
`/perm-switch` —— 查看/切换成员权限预设：
|
|
162
60
|
|
|
163
|
-
- **`services` 必须传**（0.1.11 新增）：本插件 `apply()` 依赖 `storageDomain` 等宿主服务，不注入时 `/templates` 会 500、页面显示「storageDomain 不可用」；注入 `test/api/helpers/fake-services.mjs` 后 `/templates` 返回 200 真实数据（已实测）。
|
|
164
|
-
- **autoMount**（0.1.7 起）：无 spec 时 mock 宿主 `__ModuleLoader__` / `require` / `ctx`（slots / locale / effect），调插件 `apply(ctx)`，把 `slots.register(def, component)` 捕获到的组件 `createRoot().render()` 到 `#root`。**限制**：组件若依赖 `useSettings` / `useSession` 这类宿主 hooks 会渲染失败（页面会显示错误与已捕获插槽清单，不白屏）；要 100% 还原仍需 spec 提供 mock。locale 取插件自己 `ctx.locale.register` 的字典，键名不一致会回退成 key。
|
|
165
|
-
- `gen` 默认产物是 `<插件根>/assets/preview.html`（会写进仓库）⇒ 不想入库就传 `out`（如 `out: "<临时目录>/preview.html"`），并让 `serve` 的 `file` 指向同一路径。本仓库已把该产物加进 `.gitignore`。
|
|
166
|
-
- `serve` 默认端口 **31188**，显式传 `port` 才用你给的；`backend` 可指向 minihost 的端口（`/api/*` 反代到模拟后端），也可指向**真实 DSH 后端**。
|
|
167
|
-
- 显式传 `spec` 但文件不存在会**直接报错**（不静默降级）—— 故意的，避免指错文件还生成一个看不懂的页面。
|
|
168
|
-
- **截图**（README 配图）走 **browser 插件的 `browser_screenshot`**；「自包含快照」形态不做（理由见 `dsh-useful-tools` 的 `docs/NOT-DONE.md`）。
|
|
169
|
-
- **隔离实例自测**（0.1.8/0.1.9）：`test_env { action:"create"|"start"|"stop"|"status", plugin, pluginName }` 起独立 `DSH_HOME` + 自动端口的实例；`sync_plugin { write:true, register:true, dshHome:"<测试环境 DSH_HOME>" }` 把插件装进去（写 profile 的 `dependencies` + `dsh.profile.bundles`，并对齐 `node_modules` 副本）。
|
|
170
|
-
- 停止：`minihost { action: "stop", port: 31177 }` + `preview { action: "stop", port: 31200 }`；状态：两者都用 `action: "status"`。
|
|
171
|
-
- **截图**（README 配图）改走 **browser 插件的 `browser_screenshot`**；「自包含快照」形态不做（理由见 `dsh-useful-tools` 的 `docs/NOT-DONE.md`）。
|
|
172
|
-
|
|
173
|
-
### 聊天框指令：`/model-switch`
|
|
174
|
-
|
|
175
|
-
在**用户聊天框**里直接看/切成员（子代理）的模型，不必求 AI。指令由插件注册到宿主的
|
|
176
|
-
`ctx.commands` 服务，**在插件加载时生效** —— 装好或更新后需重载一次实例，输入框里敲 `/model` 才有补全。
|
|
177
|
-
|
|
178
|
-
**① 看有哪些成员、各自在用什么**
|
|
179
|
-
|
|
180
|
-
```
|
|
181
|
-
/model-switch
|
|
182
61
|
```
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
· model-test(session-aaaa-1111) — 最近请求=wb/cn:deepseek-v4-flash
|
|
188
|
-
· writer(session-bbbb-2222) — 最近请求=n/deepseek-v4.1-flash
|
|
189
|
-
|
|
190
|
-
要查**实际**在用什么（含历史请求，不只本次进程）或切换：
|
|
191
|
-
/model-switch <成员名或 sessionId> ← 查实际模型
|
|
192
|
-
/model-switch <成员名或 sessionId> <provider>/<模型> ← 切换并回显查证
|
|
193
|
-
|
|
194
|
-
和别人对齐 / 批量：
|
|
195
|
-
/model-switch * auto ← 最常用：所有子代理都换成「我自己现在用的」模型
|
|
196
|
-
/model-switch <成员名> auto ← 只让这一个成员换成我自己现在用的模型
|
|
197
|
-
/model-switch * <provider>/<模型> ← 所有子代理换成一个指定的模型
|
|
198
|
-
|
|
199
|
-
* = 全部成员（不含我自己）；auto = 「跟我保持一致」，不用去查我用的是哪个模型。
|
|
62
|
+
/perm-switch # 无参：列出成员与各自预设
|
|
63
|
+
/perm-switch writer # 只给成员：查 preset / sandbox / approval
|
|
64
|
+
/perm-switch writer danger-full-access # 成员 + 预设：切换
|
|
65
|
+
/perm-switch * auto # 成员写 * = 全部；预设写 auto = 跟随我
|
|
200
66
|
```
|
|
201
67
|
|
|
202
|
-
|
|
68
|
+
两条指令都支持：成员位置可填成员名、唯一子串或 sessionId；`*` 表示全部成员（不含自己）；
|
|
69
|
+
`auto` 表示跟随主代理当前值。切换后回执会带上「实际生效」的查证结果。
|
|
203
70
|
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
| 场景 | 用户指令 | AI 工具调用 |
|
|
207
|
-
|---|---|---|
|
|
208
|
-
| **所有子代理都跟我一致** | `/model-switch * auto` | `set_member_model({})`（三个参数全留空） |
|
|
209
|
-
| 只让某一个跟我一致 | `/model-switch <成员名> auto` | `set_member_model({ target: "<成员名>" })` |
|
|
210
|
-
| 所有子代理统一到指定模型 | `/model-switch * sa6400/deepseek-v4.1-flash` | `set_member_model({ provider: "sa6400", model: "deepseek-v4.1-flash" })` |
|
|
211
|
-
|
|
212
|
-
**参数留空的语义**（指令与工具一致）：
|
|
213
|
-
|
|
214
|
-
| 参数 | 留空 / `*` / `auto` 的含义 |
|
|
215
|
-
|---|---|
|
|
216
|
-
| 成员（`target` 或第一个位置参数） | 留空或 `*` = **全部成员**（自动排除我自己，也排除正在创建 / 已失败的） |
|
|
217
|
-
| 模型（`provider`+`model` 或第二个位置参数） | 留空或 `auto` = **跟主代理（Lead）一致**，即我自己当前实际在用的模型 |
|
|
218
|
-
|
|
219
|
-
「我自己在用的模型」取自**请求级权威记录**（会话日志里的 `request/header`，即真实发出请求时用的值），
|
|
220
|
-
读不到就如实报错，不会拿名册里的静态字段冒充。批量执行**串行**、**逐个隔离失败**、**回执带完整名单**。
|
|
221
|
-
|
|
222
|
-
权限预设同样支持这套写法：`/perm-switch * auto` = 所有子代理的权限预设跟我一致；
|
|
223
|
-
`set_member_permission({})` 等价。
|
|
224
|
-
|
|
225
|
-
注意：正在跑回合的成员会被跳过（等 60s 仍未结束则报错并提示先中断）—— 这是有意的，
|
|
226
|
-
运行中切模型不生效，还可能被其内存态覆盖。
|
|
227
|
-
|
|
228
|
-
### 为什么子代理界面上没有「切换模型」按钮
|
|
229
|
-
|
|
230
|
-
主会话输入框右上角那个模型选择器，在**子代理会话里是宿主硬性关掉的**，不是本插件漏做，也不是宿主漏做：
|
|
71
|
+
### AI 工具
|
|
231
72
|
|
|
232
73
|
```js
|
|
233
|
-
//
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
//
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
### 模型切换为什么要写 override（以及它和官方界面的关系）
|
|
255
|
-
|
|
256
|
-
官方模型选择链是「投影 pending → 会话请求头 → 部署默认」：写 `model/selection` 事件只让 pending
|
|
257
|
-
生效**一轮**，被 `request/header` 消费后，新回合会沿请求头链回落，最终回到部署默认模型。
|
|
258
|
-
所以本插件在 `agent/request` 瀑布流里按会话强制改写请求配置（每轮都改 → 跨轮必然持久），
|
|
259
|
-
这份持久状态存在插件域 `memberModelOverrides` 里。
|
|
260
|
-
|
|
261
|
-
**这个机制曾有致命副作用**（1.3.18 修复）：override 优先级高于官方链路，一旦写入，
|
|
262
|
-
用户在主会话界面用官方模型选择器切换就**完全无效** —— 界面显示新模型、请求一直走 override 里的旧模型，
|
|
263
|
-
不报错、不提示、也没有清除入口。现场表现为「界面切三次、跨三个回合、改日志、重启宿主全都不动」。
|
|
264
|
-
|
|
265
|
-
**现在的行为**：官方切换会往 `modelSelection` 投影写 `pending`，插件每轮请求前把它与 override 比对，
|
|
266
|
-
不一致就**把 override 同步成官方的新值**（同步而非清除 —— 既让界面选择立刻生效，又保留跨轮持久能力）。
|
|
267
|
-
同步失败只记一条日志并退回旧 override，绝不打断请求。
|
|
268
|
-
|
|
269
|
-
使用注意：
|
|
74
|
+
list_models({}) // 列出可用 provider 与模型 id
|
|
75
|
+
set_member_model({ target, provider, model }) // 三者都可空：target 空=全部成员；provider/model 空=跟随我
|
|
76
|
+
set_member_permission({ target, preset }) // 两者都可空：target 空=全部成员；preset 空=跟随我
|
|
77
|
+
list_permission_presets({}) // 列出可选权限预设
|
|
78
|
+
clone_member_as({ source, name, description, withHistory, provider, model, subagentProvider })
|
|
79
|
+
// source/name 必填；withHistory 默认 true（false=只建空成员）
|
|
80
|
+
create_teammate_with_model({ name, description, prompt, provider, model, subagentProvider, context })
|
|
81
|
+
// name/description/prompt/provider/model 必填
|
|
82
|
+
create_session({ cwd, workspaceId, provider, model, text, dryRun, sessionId })
|
|
83
|
+
// 全可空：cwd 缺省=调用方 cwd；dryRun=true 只预览
|
|
84
|
+
list_sessions({ query, limit, offset, fromIndex }) // 全可空：fromIndex=true 直接读索引（秒回）
|
|
85
|
+
send_to_session({ sessionId, text, mode, dryRun }) // sessionId/text 必填；mode=queue|steer
|
|
86
|
+
recall_memory({ rounds, session }) // 都可空：rounds 默认取配置、上限 50；session 空=自己
|
|
87
|
+
context_usage({}) // 无参
|
|
88
|
+
read_member_trace({ session, rounds, detail, include, maxCharsPerItem })
|
|
89
|
+
// session 空=自己（可填成员名/id/前缀/标题）；rounds 默认 1（上限 20）
|
|
90
|
+
// detail=summary(每条一行)|full(完整文本)；include 可裁 reasoning,text,tool
|
|
91
|
+
// maxCharsPerItem 单条截断（默认 800）
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
典型调用：
|
|
270
95
|
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
- 想让某个会话彻底回到「官方说了算」，执行一次官方界面切换即可（override 会被同步成新值）。
|
|
275
|
-
|
|
276
|
-
「最近请求」取自**进程内真实请求记录**（瞬时、不扫日志）；显示「未知」说明本进程还没见它请求过，用 ② 查历史。若同时显示目标与最近请求且不一致，会附 `⚠️ 与目标不一致（下一回合生效前属正常）`。
|
|
277
|
-
|
|
278
|
-
**② 查某个成员实际在用什么**
|
|
279
|
-
|
|
280
|
-
```
|
|
281
|
-
/model-switch writer
|
|
282
|
-
```
|
|
283
|
-
|
|
284
|
-
```
|
|
285
|
-
成员 writer(session-bbbb-2222)
|
|
96
|
+
```js
|
|
97
|
+
// 全部子代理都换成我现在用的模型
|
|
98
|
+
set_member_model({})
|
|
286
99
|
|
|
287
|
-
|
|
288
|
-
|
|
100
|
+
// 只把 writer 切到指定模型
|
|
101
|
+
set_member_model({ target: "writer", provider: "sa6400", model: "cn:deepseek-v4.1-flash" })
|
|
289
102
|
|
|
290
|
-
|
|
291
|
-
|
|
103
|
+
// 把 probe1 克隆成 rename1（换名用）
|
|
104
|
+
clone_member_as({ source: "probe1", name: "rename1" })
|
|
292
105
|
|
|
293
|
-
|
|
106
|
+
// 给另一个会话发消息（dryRun 先预览目标状态与限流余量）
|
|
107
|
+
send_to_session({ sessionId: "session-xxxx", text: "继续刚才的任务", dryRun: true })
|
|
294
108
|
|
|
295
|
-
|
|
109
|
+
// 看子代理最近一轮的执行过程（子代理只有最后一条回复会被自动发回，中间的思考靠这里读）
|
|
110
|
+
read_member_trace({ session: "writer" })
|
|
296
111
|
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
```
|
|
112
|
+
// 看最近 3 轮，只要思考与工具调用
|
|
113
|
+
read_member_trace({ session: "writer", rounds: 3, include: "reasoning,tool" })
|
|
300
114
|
|
|
115
|
+
// 要完整文本（默认 summary 每条压成一行）
|
|
116
|
+
read_member_trace({ session: "writer", detail: "full" })
|
|
301
117
|
```
|
|
302
|
-
已把成员 writer(session-bbbb-2222) 切到 n/deepseek-v4.1-flash
|
|
303
|
-
生效方式：model/selection 事件（官方投影接管）…
|
|
304
|
-
最近一次实际请求：wb/cn:deepseek-v4-flash（2026/10/17 05:18:00）
|
|
305
|
-
判定：⏳ 待下一回合生效（最近一次请求是切换前发出的，属正常）
|
|
306
|
-
确认结果会在该成员下次发起请求时注入回发起方（事件驱动，不阻塞）。
|
|
307
|
-
```
|
|
308
|
-
|
|
309
|
-
看到 **⏳ 不代表失败**：切换本就下一回合生效（当前那次请求早已发出）。该成员下次请求时插件按事件判定，并把 `【切换查证】✅ 已确认生效：…`（或 `❌ 未生效：期望 X，实际 Y` —— 不假装成功）注入回发起方。定位可用**成员名**或 **sessionId**（名字支持唯一子串，重名会要求写全）；模型必须写成 `provider/model`，写错会直接给正确格式。
|
|
310
118
|
|
|
311
119
|
## API
|
|
312
120
|
|
|
@@ -314,24 +122,19 @@ throw new Error('model selection is unavailable for addressed subagent sessions'
|
|
|
314
122
|
|
|
315
123
|
| 端点 | 方法 | 用途 |
|
|
316
124
|
|---|---|---|
|
|
317
|
-
| `/list` | GET |
|
|
318
|
-
| `/archive`
|
|
125
|
+
| `/list` | GET | 会话列表；`?fromIndex=true` 读落盘索引秒回，`?job=1` 交给后台 job |
|
|
126
|
+
| `/archive` `/restore` | POST | 归档 / 恢复会话 |
|
|
319
127
|
| `/delete` | POST | 删除会话（拒绝运行中） |
|
|
320
128
|
| `/undo` | POST | 撤回最后一条消息 |
|
|
321
|
-
| `/auto-rename` | POST |
|
|
322
|
-
| `/auto-continue` | POST | 自动续跑开关 |
|
|
129
|
+
| `/auto-rename` `/auto-continue` | POST | 两个逐会话开关 |
|
|
323
130
|
| `/auto-continue-gate` | GET/POST | 全局续跑闸门 |
|
|
324
131
|
| `/release` | POST | 释放空闲会话 |
|
|
325
132
|
| `/value-analysis` | POST | 价值分析 |
|
|
326
|
-
| `/repair`
|
|
133
|
+
| `/repair` `/repair-eio` `/repair-dual` | POST | 三类损坏修复 |
|
|
327
134
|
| `/search` | GET | 全文搜索 |
|
|
328
|
-
| `/compaction-model` | GET/POST |
|
|
329
|
-
| `/templates` | GET/POST |
|
|
330
|
-
| `/
|
|
331
|
-
| `/auto-rename-model` | GET | 自动重命名模型（透传官方 modelCatalog） |
|
|
332
|
-
| `/i18n` | GET | 语言包（zh/en 外置 JSON） |
|
|
333
|
-
|
|
334
|
-
示例：
|
|
135
|
+
| `/compaction-model` `/auto-rename-model` | GET/POST | 两个模型设置 |
|
|
136
|
+
| `/templates` `/templates/dir` | GET/POST | 模板注入与目录浏览 |
|
|
137
|
+
| `/i18n` | GET | 语言包（zh/en） |
|
|
335
138
|
|
|
336
139
|
```bash
|
|
337
140
|
curl http://<host>/api/session-conductor/list
|
|
@@ -346,27 +149,7 @@ curl -X POST http://<host>/api/session-conductor/archive \
|
|
|
346
149
|
|
|
347
150
|
## 文档索引
|
|
348
151
|
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
- [
|
|
352
|
-
- [
|
|
353
|
-
- [函数列表](docs/FUNCTIONS.md) — lib/ 全部导出函数的名称/位置/签名（doc-func 维护）
|
|
354
|
-
|
|
355
|
-
### 聊天框指令：`/perm-switch`
|
|
356
|
-
|
|
357
|
-
在**用户聊天框**里看/切成员（子代理）的**权限预设**。子代理在界面上切不了权限预设，这条指令是唯一的界面内入口。
|
|
358
|
-
|
|
359
|
-
```
|
|
360
|
-
/perm-switch # 列成员与各自预设（auto 悬空会告警）
|
|
361
|
-
/perm-switch <成员名|sessionId> # 查该成员的 preset / sandbox / approval
|
|
362
|
-
/perm-switch <成员名|sessionId> <预设名> # 切单个成员
|
|
363
|
-
/perm-switch * <预设名> # 全部成员切成该预设（回执带完整名单）
|
|
364
|
-
/perm-switch <成员名|*> auto # 跟随主代理（Lead）当前预设
|
|
365
|
-
```
|
|
366
|
-
|
|
367
|
-
**为什么需要它**：子代理会话的 `permission/preset` 一旦指向当前不可用的值（典型：`auto` 在「自动审查」关闭后悬空），
|
|
368
|
-
该成员会永久唤不醒，而宿主只会报一句 `subagent/not-resumable`。典型判据：会话日志最后一条
|
|
369
|
-
`permission/preset` 是 `auto`，且当前可选预设列表里**没有** `auto`。
|
|
370
|
-
|
|
371
|
-
改动写在会话日志里（追加一条 `permission/preset` 事件，带 checksum），成员下次加载/唤醒时按折叠语义生效
|
|
372
|
-
（最后一条 preset 事件为准）。已有事件不动，可删尾部帧回滚。
|
|
152
|
+
- [文件目录结构](docs/FILE-TREE.md) — 目录树与文件作用
|
|
153
|
+
- [版本列表](docs/VERSIONS.md) — 按 git 提交聚合的版本记录
|
|
154
|
+
- [函数列表](docs/FUNCTIONS.md) — lib/ 导出函数的名称/位置/签名
|
|
155
|
+
- [模型与权限切换机制](docs/模型与权限切换机制.MD) — 子代理切换的实现依据与内部机制
|
package/lib/apply.js
CHANGED
|
@@ -317,24 +317,38 @@ export async function apply(ctx, config = {}) {
|
|
|
317
317
|
// 不依赖官方「投影 pending + 请求头链」（那条链在新回合会回落部署默认模型），
|
|
318
318
|
// override 由 set_member_model 写入（domain 持久 + 内存缓存镜像），每轮都改 → 跨轮持久。
|
|
319
319
|
ctx.on("agent/request", async ({ agent }, next) => {
|
|
320
|
-
const resolved = await next();
|
|
321
320
|
const sessionId = agent?.session?.id;
|
|
321
|
+
// ① 进入即读 override 与官方 pending —— 这是 UI 切换「立即生效」的关键。
|
|
322
|
+
// 旧实现把同步放在 await next() 之后：请求组装阶段官方链路可能解析出旧模型
|
|
323
|
+
// （system-prompt/assemble 被缓存时 selection.assembled 停留旧值），返回阶段我们
|
|
324
|
+
// 再拿旧 override 一盖，本次请求就定型了；残留的 pending 要等下一轮才被读到，
|
|
325
|
+
// 表现为「UI 切了模型，AI 用旧模型回完一轮才切过去」。pending 只会被请求后的
|
|
326
|
+
// consumeSelection 清掉，waterfall 进入时它必然还在 —— 所以进入时同步最可靠。
|
|
322
327
|
let override = await getMemberModelOverride(ctx, sessionId);
|
|
323
|
-
// 官方界面切换同步：override 优先级高于官方链路，若用户在主会话界面用官方选择器改了模型，
|
|
324
|
-
// 不把新值同步进 override 就会出现「界面显示新模型、请求一直走旧模型」且无处可查
|
|
325
|
-
// （实测事故：批量写入的 override 把会话钉在已失效 provider 上，界面切换、改日志、重启全无效）。
|
|
326
|
-
// 做法是同步而不是清除：官方切换会写投影 pending，这里把它写回 override，
|
|
327
|
-
// 既让界面选择立刻生效，又保留 override 的跨轮持久能力（不会回落部署默认）。
|
|
328
328
|
try {
|
|
329
329
|
const pending = readOfficialPendingSelection(ctx, agent);
|
|
330
330
|
const adopt = adoptOfficialSelection(override, pending);
|
|
331
331
|
if (adopt) {
|
|
332
332
|
await setMemberModelOverride(ctx, sessionId, adopt.provider, adopt.model);
|
|
333
333
|
override = adopt;
|
|
334
|
-
log(ctx, `官方界面切换已同步到 override
|
|
334
|
+
log(ctx, `官方界面切换已同步到 override（请求前）：${sessionId} → ${adopt.provider}/${adopt.model}`);
|
|
335
|
+
}
|
|
336
|
+
} catch (error) {
|
|
337
|
+
// 同步失败绝不打断请求：退回用旧 override
|
|
338
|
+
log(ctx, `官方切换同步失败（不影响本次请求）: ${String(error?.message ?? error)}`);
|
|
339
|
+
}
|
|
340
|
+
const resolved = await next();
|
|
341
|
+
// ② 返回阶段兜底：极端情况下进入时投影尚未 fold 到最新（刚 append 事件还没被折叠），
|
|
342
|
+
// 返回阶段再给一次机会；正常路径这里 pending 与 override 已一致，不会再写。
|
|
343
|
+
try {
|
|
344
|
+
const pending = readOfficialPendingSelection(ctx, agent);
|
|
345
|
+
const adopt = adoptOfficialSelection(override, pending);
|
|
346
|
+
if (adopt) {
|
|
347
|
+
await setMemberModelOverride(ctx, sessionId, adopt.provider, adopt.model);
|
|
348
|
+
override = adopt;
|
|
349
|
+
log(ctx, `官方界面切换已同步到 override（返回兜底）：${sessionId} → ${adopt.provider}/${adopt.model}`);
|
|
335
350
|
}
|
|
336
351
|
} catch (error) {
|
|
337
|
-
// 同步失败绝不打断请求：退回用旧 override（行为与修复前一致）
|
|
338
352
|
log(ctx, `官方切换同步失败（不影响本次请求）: ${String(error?.message ?? error)}`);
|
|
339
353
|
}
|
|
340
354
|
const applied = applyModelOverride(resolved, override);
|
package/lib/client.js
CHANGED
|
@@ -1,3 +1,15 @@
|
|
|
1
|
+
function __dshScLoad(registration) {
|
|
2
|
+
const host = window.__ModuleLoader__;
|
|
3
|
+
if (registration.id === "dsh-session-conductor") { host.load(registration); return; }
|
|
4
|
+
const cycle = (window.__dshScCycle = (window.__dshScCycle ?? 0) + (window.__dshScCycleOpen ? 0 : 1));
|
|
5
|
+
window.__dshScCycleOpen = true;
|
|
6
|
+
const seen = (window.__dshScSeen ??= new Set());
|
|
7
|
+
const id = `${registration.id}@${cycle}`;
|
|
8
|
+
if (seen.has(id)) return;
|
|
9
|
+
seen.add(id);
|
|
10
|
+
host.load({ ...registration, id });
|
|
11
|
+
}
|
|
12
|
+
window.__dshScCycleOpen = false;
|
|
1
13
|
// dsh-session-conductor —— 会话管理增强插件（浏览器半边）。
|
|
2
14
|
// dsh-skip-quality（conv-log：fallback 行为 UI 文案内嵌 JSON，非文档注释，属规则误报）
|
|
3
15
|
//
|
|
@@ -72,7 +84,7 @@ window.__SC_TR__ = (key, vars) => {
|
|
|
72
84
|
return String(val);
|
|
73
85
|
};
|
|
74
86
|
|
|
75
|
-
|
|
87
|
+
__dshScLoad({
|
|
76
88
|
id: "dsh-session-conductor",
|
|
77
89
|
factory: (require) => {
|
|
78
90
|
var module = { exports: {} };
|
|
@@ -2407,7 +2419,7 @@ window.__ModuleLoader__.load({
|
|
|
2407
2419
|
return module.exports;
|
|
2408
2420
|
},
|
|
2409
2421
|
});
|
|
2410
|
-
|
|
2422
|
+
__dshScLoad({
|
|
2411
2423
|
id: "dsh-session-conductor-group",
|
|
2412
2424
|
factory: (require) => {
|
|
2413
2425
|
var module = { exports: {} };
|
|
@@ -2522,7 +2534,7 @@ window.__ModuleLoader__.load({
|
|
|
2522
2534
|
* 排队消息列表仍由原生 dock 负责（不重复渲染）。不改 DSH 原生源码。
|
|
2523
2535
|
*/
|
|
2524
2536
|
|
|
2525
|
-
|
|
2537
|
+
__dshScLoad({
|
|
2526
2538
|
id: "dsh-session-conductor-processing",
|
|
2527
2539
|
factory: (require) => {
|
|
2528
2540
|
var module = { exports: {} };
|
|
@@ -2627,7 +2639,7 @@ window.__ModuleLoader__.load({
|
|
|
2627
2639
|
* 设置 → 插件配置 → 「压缩模型」：会话模型旁单独选压缩用模型（省 pro 成本）。
|
|
2628
2640
|
* 可选：跟随会话模型（默认）/ 指定便宜模型（agnes 等）。写入 /api/session-conductor/compaction-model。
|
|
2629
2641
|
*/
|
|
2630
|
-
|
|
2642
|
+
__dshScLoad({
|
|
2631
2643
|
id: "dsh-session-conductor-compaction-model",
|
|
2632
2644
|
factory: (require) => {
|
|
2633
2645
|
var module = { exports: {} };
|
|
@@ -2751,7 +2763,7 @@ window.__ModuleLoader__.load({
|
|
|
2751
2763
|
* UI 组件 scs_* = 页面级。
|
|
2752
2764
|
*/
|
|
2753
2765
|
|
|
2754
|
-
|
|
2766
|
+
__dshScLoad({
|
|
2755
2767
|
id: "dsh-session-conductor-settings",
|
|
2756
2768
|
factory: (require) => {
|
|
2757
2769
|
var module = { exports: {} };
|