dsh-session-conductor 1.3.17 → 1.3.18

package/README.md

@@ -225,6 +225,54 @@ preview  { action: "serve", file: "<插件根>/assets/preview.html", backend: "h
 注意：正在跑回合的成员会被跳过（等 60s 仍未结束则报错并提示先中断）—— 这是有意的，
 运行中切模型不生效，还可能被其内存态覆盖。
 
+### 为什么子代理界面上没有「切换模型」按钮
+
+主会话输入框右上角那个模型选择器，在**子代理会话里是宿主硬性关掉的**，不是本插件漏做，也不是宿主漏做：
+
+```js
+// client/ui-model-selection/src/client/index.ts:134
+available: session => sessions.subagentAddress(session.sessionId) === undefined,
+
+// client/ui-model-selection/src/client/directory.ts:153
+throw new Error('model selection is unavailable for addressed subagent sessions')
+```
+
+宿主源码给出的原因（同文件 `index.ts:9-11`）：子代理会话绑定的模型 RPC 会**绕过父级续跑路径去激活已持久化的历史**，
+所以 UI 层把入口直接关掉。任何走 `session.selectModel` 那条 RPC 的实现都会撞上同一个拦截，装插件也绕不过去。
+
+**所以子代理的模型只能由本插件切换** —— 我们写的是 `model/selection` 事件（交给宿主官方投影接管），
+不经过那条被禁的 RPC，因此不受该限制：
+
+| 目的 | 用户指令 | AI 工具 |
+|---|---|---|
+| 单个成员换成指定模型 | `/model-switch <成员名> <provider>/<模型>` | `set_member_model({ target, provider, model })` |
+| 单个成员跟我用同一个 | `/model-switch <成员名> auto` | `set_member_model({ target })` |
+| 全部子代理跟我用同一个 | `/model-switch * auto` | `set_member_model({})` |
+
+权限预设同理（`/perm-switch`、`set_member_permission`）—— 子代理界面上同样没有权限切换入口。
+
+### 模型切换为什么要写 override（以及它和官方界面的关系）
+
+官方模型选择链是「投影 pending → 会话请求头 → 部署默认」：写 `model/selection` 事件只让 pending
+生效**一轮**，被 `request/header` 消费后，新回合会沿请求头链回落，最终回到部署默认模型。
+所以本插件在 `agent/request` 瀑布流里按会话强制改写请求配置（每轮都改 → 跨轮必然持久），
+这份持久状态存在插件域 `memberModelOverrides` 里。
+
+**这个机制曾有致命副作用**（1.3.18 修复）：override 优先级高于官方链路，一旦写入，
+用户在主会话界面用官方模型选择器切换就**完全无效** —— 界面显示新模型、请求一直走 override 里的旧模型，
+不报错、不提示、也没有清除入口。现场表现为「界面切三次、跨三个回合、改日志、重启宿主全都不动」。
+
+**现在的行为**：官方切换会往 `modelSelection` 投影写 `pending`，插件每轮请求前把它与 override 比对，
+不一致就**把 override 同步成官方的新值**（同步而非清除 —— 既让界面选择立刻生效，又保留跨轮持久能力）。
+同步失败只记一条日志并退回旧 override，绝不打断请求。
+
+使用注意：
+
+- 同步只发生在**已有 override 的会话**上；没有 override 的会话完全交给官方链路，插件不干预。
+- `set_member_model` 的批量「跟随主代理」（`auto` / 三参数全空）写入的是**当时**主代理用的模型；
+  之后主代理再换模型，这些成员**不会**自动跟着变（需再执行一次）。
+- 想让某个会话彻底回到「官方说了算」，执行一次官方界面切换即可（override 会被同步成新值）。
+
 「最近请求」取自**进程内真实请求记录**（瞬时、不扫日志）；显示「未知」说明本进程还没见它请求过，用 ② 查历史。若同时显示目标与最近请求且不一致，会附 `⚠️ 与目标不一致（下一回合生效前属正常）`。
 
 **② 查某个成员实际在用什么**

package/lib/apply.js

@@ -21,7 +21,8 @@ import { refreshTitleState } from './features/rename/title.js';
 // 成员模型：本文件用到 findTargetAgent / switchAgentModel / getMemberModelOverride /
 //   applyModelOverride / validateModelPair（拆出 apply.js 时漏了这一行 import，
 //   运行到相关代码路径会 ReferenceError: getMemberModelOverride is not defined）
-import { getMemberModelOverride, applyModelOverride, noteRequestModel, takeSwitchOutcomes } from './features/member-model/index.js';
+import { getMemberModelOverride, applyModelOverride, noteRequestModel, takeSwitchOutcomes,
+  adoptOfficialSelection, readOfficialPendingSelection, setMemberModelOverride } from './features/member-model/index.js';
 // 会话操作的路由注册已抽到独立模块（handler 实现见该模块；此处只留注册入口）
 import { registerSessionOpsRoutes } from './features/session-ops-routes.js';
 import { registerMemberModelTools } from './features/member-model/tools.js';
@@ -317,7 +318,25 @@ export async function apply(ctx, config = {}) {
     // override 由 set_member_model 写入（domain 持久 + 内存缓存镜像），每轮都改 → 跨轮持久。
     ctx.on("agent/request", async ({ agent }, next) => {
       const resolved = await next();
-      const override = await getMemberModelOverride(ctx, agent?.session?.id);
+      const sessionId = agent?.session?.id;
+      let override = await getMemberModelOverride(ctx, sessionId);
+      // 官方界面切换同步：override 优先级高于官方链路，若用户在主会话界面用官方选择器改了模型，
+      // 不把新值同步进 override 就会出现「界面显示新模型、请求一直走旧模型」且无处可查
+      // （实测事故：批量写入的 override 把会话钉在已失效 provider 上，界面切换、改日志、重启全无效）。
+      // 做法是同步而不是清除：官方切换会写投影 pending，这里把它写回 override，
+      // 既让界面选择立刻生效，又保留 override 的跨轮持久能力（不会回落部署默认）。
+      try {
+        const pending = readOfficialPendingSelection(ctx, agent);
+        const adopt = adoptOfficialSelection(override, pending);
+        if (adopt) {
+          await setMemberModelOverride(ctx, sessionId, adopt.provider, adopt.model);
+          override = adopt;
+          log(ctx, `官方界面切换已同步到 override：${sessionId} → ${adopt.provider}/${adopt.model}`);
+        }
+      } catch (error) {
+        // 同步失败绝不打断请求：退回用旧 override（行为与修复前一致）
+        log(ctx, `官方切换同步失败（不影响本次请求）: ${String(error?.message ?? error)}`);
+      }
       const applied = applyModelOverride(resolved, override);
       // 切换查证（事件驱动）：记录本次请求**真实使用**的 provider/model；若该会话有待查证项，
       // 就在这里按事件判定结果并入队（切换本身不阻塞、不轮询 —— 只等事件到）。

package/lib/features/member-model/index.js

@@ -13,7 +13,11 @@ export {
   // 批量目标解析（空 / `*` / `all` = 全部成员，排除 Lead）与 Lead 定位
   collectTeamMembers, isAllTarget, resolveTargets, resolveLeader,
 } from "./locate.js";
-export { getMemberModelOverride, setMemberModelOverride, applyModelOverride, resetMemberModelCacheForTest } from "./override.js";
+export {
+  getMemberModelOverride, setMemberModelOverride, applyModelOverride, resetMemberModelCacheForTest,
+  // 官方界面切换的同步：override 优先级高于官方链路，不同步就会出现「界面切了但请求不变」
+  adoptOfficialSelection, readOfficialPendingSelection,
+} from "./override.js";
 export { waitForIdle, appendSelectionEventToLog, switchAgentModel } from "./switch.js";
 // 切换查证（事件驱动，注册 job 不阻塞）：登记待查证项 → 每次请求记录实际模型 → 按事件判定 → 结果回报
 export {

package/lib/features/member-model/override.js

@@ -77,6 +77,56 @@ export function applyModelOverride(resolved, override) {
   return { ...rest, provider: override.provider, model: override.model };
 }
 
+/**
+ * 判断是否要把「官方界面刚选的模型」同步进 override。
+ *
+ * 【为什么需要它】本插件的 override 是**每轮强制改写请求**的持久状态，优先级高于官方链路。
+ * 于是有个致命副作用：一旦写入，用户在主会话界面用官方模型选择器切换**完全无效** ——
+ * 界面显示新模型、实际请求走 override 里的旧模型，而且不报错、不提示、无清除入口
+ * （实测事故：批量「跟随主代理」把一批会话钉在某个已失效 provider 上，界面怎么切都不动，
+ *   改会话日志、重启宿主也都没用，因为 override 存在 domain 里且每轮覆盖）。
+ *
+ * 【做法：同步，而不是清除】官方切换会往 `modelSelection` 投影写 `pending`；
+ * 而插件在 hook 里用 override 改写了请求配置 → 与 pending 不匹配 → `consumeSelection` 不会
+ * 清空它，于是 pending 会一直保留。每轮把它与 override 比对，不一致就**把 override 更新成
+ * pending 的值**：官方界面选择立刻生效，同时仍享有 override 的「跨轮持久」能力（不会回落）。
+ *
+ * 只在**已存在 override** 的会话上同步：没有 override 的会话不干预，交给官方链路自己跑。
+ *
+ * @param {{provider: string, model: string} | null} override 当前生效的 override
+ * @param {{provider: string, model: string} | null} pending 官方投影里的待生效选择
+ * @returns {{provider: string, model: string} | null} 需要写入的新 override；null = 无需同步
+ */
+export function adoptOfficialSelection(override, pending) {
+  if (!override || !pending) return null;
+  if (typeof pending.provider !== "string" || typeof pending.model !== "string") return null;
+  if (pending.provider === "" || pending.model === "") return null;
+  if (override.provider === pending.provider && override.model === pending.model) return null;
+  return { provider: pending.provider, model: pending.model };
+}
+
+/**
+ * 从会话投影里读官方「待生效」的模型选择（官方界面切换会写这里）。
+ *
+ * 投影不可用、字段缺失、调用抛错一律返回 null（宁可不同步，也不要在 hook 里抛异常打断请求）。
+ *
+ * @param {object} ctx 插件 context
+ * @param {object} agent 当前请求所属 agent
+ * @returns {{provider: string, model: string} | null}
+ */
+export function readOfficialPendingSelection(ctx, agent) {
+  try {
+    const projections = ctx?.sessionProjections ?? ctx?.get?.("sessionProjections");
+    const state = projections?.stateOf?.(agent?.session, "modelSelection");
+    const pending = state?.pending;
+    if (!pending || typeof pending !== "object") return null;
+    if (typeof pending.provider !== "string" || typeof pending.model !== "string") return null;
+    return { provider: pending.provider, model: pending.model };
+  } catch {
+    return null;
+  }
+}
+
 /** 测试钩子：清空 override 缓存（单测在场景之间调用）。 */
 export function resetMemberModelCacheForTest() {
   memberModelCache.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-conductor",
-  "version": "1.3.17",
+  "version": "1.3.18",
   "description": "DSH session management enhancement: archive/restore sessions, batch & conditional delete, AI auto-rename, interrupted-session auto-resume, release idle sessions, workspace grouping, undo last message, repair damaged session logs, value analysis, full-text search, per-member model switching (list_models / set_member_model), and plan/closing template injection (system-prompt + context).",
   "type": "module",
   "main": "lib/index.js",