@dsh-plus/subagent-model 0.1.9 → 0.2.0

package/lib/index.d.ts

@@ -28,7 +28,6 @@ declare const Config: z<SubagentModelConfigInput, SubagentModelConfig>;
 interface InjectedOptions {
   provider?: string;
   model?: string;
-  /** 私有标记：随 agentOptions 抵达子代理 options，由 agent/request 监听器消费。 */
   reasoningEffort?: string;
 }
 //#endregion
@@ -44,13 +43,11 @@ declare class SubagentModelService extends Service {
   constructor(ctx: Context, config: SubagentModelConfig);
   /** 当前生效配置（settings 用户层解析结果或 cordis 行级 config）。 */
   currentConfig(): SubagentModelConfig;
-  /** 已注册的子代理 provider 名（配置卡片据此合成行）。 */
-  subagentProviders(): string[];
 }
 //#endregion
 //#region src/index.d.ts
 declare const name = "dsh-plus-subagent-model";
-declare const inject: readonly ["subagents", "llm"];
+declare const inject: readonly ["subagents"];
 declare function apply(ctx: Context, config: SubagentModelConfig): void;
 //#endregion
 export { Config, type EntryConfig, type InjectedOptions, type SubagentModelConfig, SubagentModelService, apply, inject, name };

package/lib/index.js

@@ -1,33 +1,37 @@
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
 import { Context, Service } from "@deepseek-ai/cordis";
 //#endregion
 //#region src/config.ts
 /**
-* 配置单一事实源：cordis 行级 Config（组合默认值，dev/prod patch 层可覆盖）
-* 与 settings namespace（用户层，经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml）
-* 共用同一 schemastery schema。条目按【子代理 provider 名】键控
-* （standard preset 事实映射：subagent↔spawn、subagent_fork↔fork）。
+* 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
+* （用户层，经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml）共用同一
+* schemastery schema。条目按【子代理 provider 名】键控（standard preset
+* 事实映射：subagent↔spawn、subagent_fork↔fork），特殊键 `default` 作为
+* 未命中具体 provider 时的兜底（spawn/fork 共享同一路由的便捷写法）。
 *
-* 运行时语义（详见 delegation.ts）：
-* - provider/model 显式时注入子代理 `agentOptions`（覆盖"继承主代理"快照）；
-* - reasoningEffort 显式时经私有字段随 agentOptions 抵达子代理，再由
-*   `agent/request` 瀑布监听器应用（dsh 原生 AgentOptions 不含 effort 字段）。
+* 运行时语义（详见 delegation.ts）：provider/model/reasoningEffort 显式时
+* 注入子代理 `request.agentOptions`——当前平台（0.1.2-rc.1）的
+* resolveChildAgentOptions 原生读取 provider/model/reasoningEffort 三个字段
+* （含冷恢复 descriptor），不再需要旧版 effort 瀑布的私有字段搬运。
 *
-* 类型说明：z.dict 的推断类型引用 cosmokit 的 Dict，直接导出会触发
-* dts 的 TS2742（不可具名引用）；按官方 dsh-permission-presets 模式，
-* 显式声明输入/输出接口并注解 schema（输出为规范型，输入为可空宽松型）。
-* @module subagent-model/config
+* 与官方 subagent-model-selection 的关系：官方机制是"主代理模型可选白名单"，
+* 不强制任何模型（未显式选择时子代理继承主代理路由）；本插件补的是
+* "管理端强制默认路由"——主代理未显式选择时才注入，显式选择仍优先。
+* @module @dsh-plus/subagent-model/config
 */
-/** settings 命名空间；webui 配置卡片与插件运行期读取同一份（字面量见 ./ns.ts）。 */
-const SETTINGS_NS = settingsNamespace("dsh-plus-subagent-model");
+/** settings 命名空间（字面量即合法命名空间；webui 配置卡片与插件运行期读取同一份）。 */
+const SETTINGS_NS = "dsh-plus-subagent-model";
 /** 思考程度哨兵值：继承主代理（不注入 effort 字段）。 */
 const EFFORT_INHERIT = "inherit";
+/** 思考程度哨兵值：跟随模型默认（显式剥离任何继承/推导出的 effort）。 */
+const EFFORT_DEFAULT = "default";
+/** 兜底条目键：未命中具体 provider 名时生效（spawn/fork 共享同一路由的便捷写法）。 */
+const DEFAULT_ENTRY = "default";
 const EntrySchema = z.object({
 	enabled: z.boolean().description("该子代理 provider 行的开关").default(false),
 	provider: z.string().description("LLM 提供商 id；留空 = 继承主代理").default(""),
 	model: z.string().description("模型 id；留空 = 继承主代理").default(""),
-	reasoningEffort: z.string().description(`思考程度：${EFFORT_INHERIT}（继承主代理）/ default（跟随模型默认）/ 提供商目录档位 id`).default(EFFORT_INHERIT)
+	reasoningEffort: z.string().description(`思考程度：${EFFORT_INHERIT}（继承主代理）/ ${EFFORT_DEFAULT}（跟随模型默认）/ 提供商目录档位 id`).default(EFFORT_INHERIT)
 });
 const Config = z.object({
 	enabled: z.boolean().description("总开关").default(false),
@@ -45,9 +49,18 @@ function resolveEntry(entry) {
 	if (entry.reasoningEffort !== "inherit") out.reasoningEffort = entry.reasoningEffort;
 	return out.provider !== void 0 || out.model !== void 0 || out.reasoningEffort !== void 0 ? out : void 0;
 }
+/** 按 provider 名解析条目，未命中时回落 default 兜底条目。 */
+function entryFor(current, name) {
+	if (name === void 0 || !current().enabled) return void 0;
+	const entries = current().entries;
+	const direct = entries[name];
+	if (direct !== void 0) return resolveEntry(direct);
+	const fallback = entries[DEFAULT_ENTRY];
+	return fallback === void 0 ? void 0 : resolveEntry(fallback);
+}
 /**
-* 合并注入片段与工具行已有的 agentOptions：部署级显式配置优先，
-* 插件只补空缺（standard preset 的工具行无 agentOptions，插件即生效）。
+* 合并注入片段与委托请求已有的 agentOptions：显式（工具行配置 / 主代理
+* 显式选择的路由）优先，插件只补空缺——与官方 agentOptions 合并语义一致。
 */
 function mergeAgentOptions(injected, existing) {
 	return {
@@ -55,23 +68,6 @@ function mergeAgentOptions(injected, existing) {
 		...existing
 	};
 }
-/**
-* 把条目的 effort 决策应用到一次 LLM 请求配置上（纯函数）：
-* - undefined：直通（未配置 effort，保持原生推导）；
-* - EFFORT_DEFAULT：剥离 reasoningEffort（跟随模型默认，覆盖 fork 的 seed 继承）；
-* - 其余：显式覆盖。
-*/
-function applyEffort(resolved, effort) {
-	if (effort === void 0) return resolved;
-	if (effort === "default") {
-		const { reasoningEffort: _dropped, ...rest } = resolved;
-		return rest;
-	}
-	return {
-		...resolved,
-		reasoningEffort: effort
-	};
-}
 /** 校验一条用户提交的条目；返回错误消息，合法时返回 null。 */
 function validateEntry(entry) {
 	const model = entry.model ?? "";
@@ -90,119 +86,12 @@ function validateEntries(entries) {
 	return null;
 }
 //#endregion
-//#region src/catalog.ts
-function toEffort(effort) {
-	return {
-		id: String(effort.id),
-		name: effort.name,
-		...effort.description === void 0 ? {} : { description: effort.description }
-	};
-}
-/**
-* 构建目录。单个提供商失败只进入 failures，不拖垮其余组；
-* 无模型的组被丢弃（与官方 buildModelCatalog 同语义）。
-*/
-async function buildModelCatalog(ctx) {
-	const llm = ctx.get("llm");
-	if (llm === void 0) return {
-		providers: [],
-		failures: [],
-		subagentProviders: subagentProvidersOf(ctx)
-	};
-	const catalog = await Promise.all(llm.listProviders().map(async (provider) => {
-		try {
-			const models = await llm.listModels(provider.id);
-			const entries = await Promise.all(models.map(async (model) => {
-				const resolved = await llm.resolveModelInfo(provider.id, model.id);
-				const reasoning = resolved.reasoning === void 0 ? void 0 : {
-					efforts: resolved.reasoning.efforts.map(toEffort),
-					...resolved.reasoning.defaultEffort === void 0 ? {} : { defaultEffort: String(resolved.reasoning.defaultEffort) }
-				};
-				return {
-					id: model.id,
-					name: model.name,
-					...model.description === void 0 ? {} : { description: model.description },
-					...reasoning === void 0 ? {} : { reasoning }
-				};
-			}));
-			return {
-				kind: "group",
-				group: {
-					id: provider.id,
-					name: provider.name,
-					models: entries
-				}
-			};
-		} catch (error) {
-			return {
-				kind: "failure",
-				failure: {
-					id: provider.id,
-					name: provider.name,
-					message: error instanceof Error ? error.message : String(error)
-				}
-			};
-		}
-	}));
-	return {
-		providers: catalog.filter((item) => item.kind === "group" && item.group.models.length > 0).map((item) => item.kind === "group" ? item.group : void 0).filter((group) => group !== void 0),
-		failures: catalog.filter((item) => item.kind === "failure").map((item) => item.kind === "failure" ? item.failure : void 0).filter((failure) => failure !== void 0),
-		subagentProviders: subagentProvidersOf(ctx)
-	};
-}
-/** 已注册的子代理 provider 名（llm 服务缺失时同样返回，卡片仍可渲染）。 */
-function subagentProvidersOf(ctx) {
-	const subagents = ctx.get("subagents");
-	return subagents === void 0 ? [] : [...subagents.list()];
-}
-//#endregion
-//#region src/config-api.ts
-const ROUTE_CATALOG = "/dsh-plus/subagent-model/catalog";
-function sendJson(res, status, body) {
-	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
-	res.end(JSON.stringify(body));
-}
-async function handleCatalog(ctx, res) {
-	sendJson(res, 200, await buildModelCatalog(ctx));
-}
-/** 注册目录路由；返回是否注册成功（webServer 缺失时由调用方保证不调用）。 */
-function registerCatalogApi(ctx) {
-	const logger = ctx.logger("subagent-model");
-	const guard = (handler) => {
-		return async (req, res) => {
-			try {
-				await handler(req, res);
-			} catch (error) {
-				const message = error instanceof Error ? error.message : String(error);
-				logger.warn(`catalog api ${req.method ?? "?"} ${req.url ?? "?"} failed: ${message}`);
-				if (!res.headersSent) sendJson(res, 400, { error: message });
-				else res.end();
-			}
-		};
-	};
-	ctx.webServer.register({
-		kind: "exact",
-		path: ROUTE_CATALOG,
-		handler: guard(async (req, res) => {
-			if (req.method !== "GET") {
-				sendJson(res, 405, { error: "method not allowed" });
-				return;
-			}
-			await handleCatalog(ctx, res);
-		})
-	});
-}
-//#endregion
 //#region src/delegation.ts
 const WRAPPED = Symbol("dsh-plus-subagent-model.wrapped");
-function entryFor(current, name) {
-	if (name === void 0) return void 0;
-	const entry = current().entries[name];
-	return entry === void 0 ? void 0 : resolveEntry(entry);
-}
 /**
-* 包装 `ctx.subagents.start` / `startContinuable`：按 provider 名命中配置条目，
-* 向委托请求注入 agentOptions（显式工具行配置优先，插件只补空缺）。
+* 包装 `ctx.subagents.start` / `startContinuable`：按 provider 名命中配置条目
+* （未命中回落 default 条目），向委托请求注入 agentOptions——调用方显式携带
+* 的 agentOptions（工具行配置 / 主代理显式选择）优先，插件只补空缺。
 * 未命中条目时完全直通（原生继承主代理行为）。
 * 返回注销函数（恢复原方法），随调用方 fiber 释放。
 */
@@ -245,77 +134,46 @@ function installDelegationHook(ctx, current) {
 		delete marked[WRAPPED];
 	}, "subagent-model: delegation hook");
 }
-/**
-* 读取一次 LLM 请求的发起 agent 上本插件携带的 effort 私有标记：
-* 仅对子代理（session header origin==='subagent'）生效，主代理不受影响。
-* 纯函数（agent 为最小结构面），便于单测。
-*/
-function childEffortOf(agent) {
-	if (agent.session.header.origin !== "subagent") return void 0;
-	return agent.options.reasoningEffort;
-}
-/**
-* 根 ctx 监听 `agent/request` 瀑布：对子代理应用条目配置的思考程度。
-* provider/model 无需在此处理（路由直接读 options）。
-* 根级监听覆盖 HMR 重载后已存在子代理的后续请求。
-*/
-function installChildRoute(ctx) {
-	ctx.on("agent/request", async (payload, next) => {
-		const resolved = await next();
-		const effort = childEffortOf(payload.agent);
-		if (effort === void 0) return resolved;
-		return applyEffort(resolved, effort);
-	});
-}
 //#endregion
 //#region src/service.ts
 /**
-* SubagentModelService：子代理模型配置中枢。
-* - 配置：installSettingsSection 接入 settings 用户层（$DSH_HOME/settings.yaml，热生效），
+* SubagentModelService：子代理模型配置中枢（host 半）。
+* - 配置：installSection 接入 settings 用户层（$DSH_HOME/settings.yaml，热生效），
 *   无 settings provider 时退化为 cordis 行级 config；写入经 validate 钩子
 *   走 validateEntries 规则（model 不能脱离 provider 等），非法即拒。
-* - 委托挂钩：包装 ctx.subagents.start/startContinuable，按 provider 名注入
-*   agentOptions（provider/model/effort 私有标记），未命中条目完全直通。
-* - 子代理路由：根 ctx 的 agent/request 瀑布监听，把条目 effort 应用到子代理请求。
-* - 自定义端点：ctx.webServer 仅注册模型目录路由（配置读写已走官方 settings RPC）。
+* - 委托挂钩：包装 ctx.subagents.start/startContinuable，按 provider 名
+*   （未命中回落 default 条目）注入 agentOptions（provider/model/effort）。
 * @module @dsh-plus/subagent-model
 */
 var SubagentModelService = class extends Service {
-	static [Context.inject] = ["subagents", "llm"];
+	static [Context.inject] = ["subagents"];
 	current;
 	constructor(ctx, config) {
 		super(ctx, "subagentModel");
 		this.current = () => config;
-		installSettingsSection(ctx, SETTINGS_NS, Config, config, {
-			validate: (cfg) => {
-				const error = validateEntries(cfg.entries);
-				if (error !== null) throw new Error(`subagent-model: ${error}`);
-			},
-			setSource: (source) => {
-				this.current = source;
-			},
-			onChange: () => {}
+		ctx.inject(["settings"], (settingsCtx) => {
+			settingsCtx.settings.installSection(ctx, SETTINGS_NS, Config, config, {
+				validate: (cfg) => {
+					const error = validateEntries(cfg.entries);
+					if (error !== null) throw new Error(`subagent-model: ${error}`);
+				},
+				setSource: (source) => {
+					this.current = source;
+				},
+				onChange: () => {}
+			});
 		});
 		installDelegationHook(ctx, () => this.current());
-		installChildRoute(ctx);
-		ctx.inject(["webServer"], (webCtx) => {
-			registerCatalogApi(webCtx);
-		});
 	}
 	/** 当前生效配置（settings 用户层解析结果或 cordis 行级 config）。 */
 	currentConfig() {
 		return this.current();
 	}
-	/** 已注册的子代理 provider 名（配置卡片据此合成行）。 */
-	subagentProviders() {
-		const subagents = this.ctx.get("subagents");
-		return subagents === void 0 ? [] : [...subagents.list()];
-	}
 };
 //#endregion
 //#region src/index.ts
 const name = "dsh-plus-subagent-model";
-const inject = ["subagents", "llm"];
+const inject = ["subagents"];
 function apply(ctx, config) {
 	ctx.plugin(SubagentModelService, config);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dsh-plus/subagent-model",
-  "version": "0.1.9",
-  "description": "dsh-plus service+ui plugin: 为 subagent/subagent_fork 等子代理按提供商配置模型与思考程度（或继承主代理）",
+  "version": "0.2.0",
+  "description": "dsh-plus service plugin: 为 subagent/subagent_fork 等子代理按 provider 配置模型与思考程度（或继承主代理）",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -10,9 +10,6 @@
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./client": {
-      "default": "./lib/client.js"
-    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
@@ -20,37 +17,17 @@
     "lib",
     "src"
   ],
-  "dsh": {
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-api-remotes"
-      ],
-      "platform": "web"
-    }
-  },
-  "dependencies": {
-    "@dsh-plus/shared": "0.1.3"
-  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.2-alpha.2",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/cosmokit": "1.8.2",
-    "@deepseek-ai/dsh-agent": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.1.1-rc.2",
-    "@deepseek-ai/schemastery": "3.18.1",
-    "@types/react": "~18.3.1",
-    "react": "^18.2.0"
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-subagent": "0.1.2-alpha.2",
+    "@deepseek-ai/schemastery": "3.18.2"
   },
   "publishConfig": {
     "access": "public"

package/src/config.ts

@@ -1,32 +1,34 @@
 /**
- * 配置单一事实源：cordis 行级 Config（组合默认值，dev/prod patch 层可覆盖）
- * 与 settings namespace（用户层，经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml）
- * 共用同一 schemastery schema。条目按【子代理 provider 名】键控
- * （standard preset 事实映射：subagent↔spawn、subagent_fork↔fork）。
+ * 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
+ * （用户层，经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml）共用同一
+ * schemastery schema。条目按【子代理 provider 名】键控（standard preset
+ * 事实映射：subagent↔spawn、subagent_fork↔fork），特殊键 `default` 作为
+ * 未命中具体 provider 时的兜底（spawn/fork 共享同一路由的便捷写法）。
  *
- * 运行时语义（详见 delegation.ts）：
- * - provider/model 显式时注入子代理 `agentOptions`（覆盖"继承主代理"快照）；
- * - reasoningEffort 显式时经私有字段随 agentOptions 抵达子代理，再由
- *   `agent/request` 瀑布监听器应用（dsh 原生 AgentOptions 不含 effort 字段）。
+ * 运行时语义（详见 delegation.ts）：provider/model/reasoningEffort 显式时
+ * 注入子代理 `request.agentOptions`——当前平台（0.1.2-rc.1）的
+ * resolveChildAgentOptions 原生读取 provider/model/reasoningEffort 三个字段
+ * （含冷恢复 descriptor），不再需要旧版 effort 瀑布的私有字段搬运。
  *
- * 类型说明：z.dict 的推断类型引用 cosmokit 的 Dict，直接导出会触发
- * dts 的 TS2742（不可具名引用）；按官方 dsh-permission-presets 模式，
- * 显式声明输入/输出接口并注解 schema（输出为规范型，输入为可空宽松型）。
- * @module subagent-model/config
+ * 与官方 subagent-model-selection 的关系：官方机制是"主代理模型可选白名单"，
+ * 不强制任何模型（未显式选择时子代理继承主代理路由）；本插件补的是
+ * "管理端强制默认路由"——主代理未显式选择时才注入，显式选择仍优先。
+ * @module @dsh-plus/subagent-model/config
  */
 
-import { settingsNamespace } from '@deepseek-ai/dsh-settings'
 import z from '@deepseek-ai/schemastery'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
-/** settings 命名空间；webui 配置卡片与插件运行期读取同一份（字面量见 ./ns.ts）。 */
-export const SETTINGS_NS = settingsNamespace(NS_LITERAL)
+/** settings 命名空间（字面量即合法命名空间；webui 配置卡片与插件运行期读取同一份）。 */
+export const SETTINGS_NS = NS_LITERAL
 
 /** 思考程度哨兵值：继承主代理（不注入 effort 字段）。 */
 export const EFFORT_INHERIT = 'inherit'
 /** 思考程度哨兵值：跟随模型默认（显式剥离任何继承/推导出的 effort）。 */
 export const EFFORT_DEFAULT = 'default'
+/** 兜底条目键：未命中具体 provider 名时生效（spawn/fork 共享同一路由的便捷写法）。 */
+export const DEFAULT_ENTRY = 'default'
 
 /** 一条条目的规范输出形态。 */
 export interface EntryConfig {
@@ -77,7 +79,6 @@ export const Config: z<SubagentModelConfigInput, SubagentModelConfig> = z.object
 export interface InjectedOptions {
   provider?: string
   model?: string
-  /** 私有标记：随 agentOptions 抵达子代理 options，由 agent/request 监听器消费。 */
   reasoningEffort?: string
 }
 
@@ -96,9 +97,22 @@ export function resolveEntry(entry: EntryConfig): InjectedOptions | undefined {
     : undefined
 }
 
+/** 按 provider 名解析条目，未命中时回落 default 兜底条目。 */
+export function entryFor(
+  current: () => SubagentModelConfig,
+  name: string | undefined,
+): InjectedOptions | undefined {
+  if (name === undefined || !current().enabled) return undefined
+  const entries = current().entries
+  const direct = entries[name]
+  if (direct !== undefined) return resolveEntry(direct)
+  const fallback = entries[DEFAULT_ENTRY]
+  return fallback === undefined ? undefined : resolveEntry(fallback)
+}
+
 /**
- * 合并注入片段与工具行已有的 agentOptions：部署级显式配置优先，
- * 插件只补空缺（standard preset 的工具行无 agentOptions，插件即生效）。
+ * 合并注入片段与委托请求已有的 agentOptions：显式（工具行配置 / 主代理
+ * 显式选择的路由）优先，插件只补空缺——与官方 agentOptions 合并语义一致。
  */
 export function mergeAgentOptions(
   injected: InjectedOptions,
@@ -107,30 +121,7 @@ export function mergeAgentOptions(
   return { ...injected, ...existing }
 }
 
-/** 请求配置的形状（与 dsh agent/request 瀑布产物的相关字段）。 */
-export interface RequestConfig {
-  provider: string
-  model: string
-  reasoningEffort?: string
-  maxTokens?: number
-}
-
-/**
- * 把条目的 effort 决策应用到一次 LLM 请求配置上（纯函数）：
- * - undefined：直通（未配置 effort，保持原生推导）；
- * - EFFORT_DEFAULT：剥离 reasoningEffort（跟随模型默认，覆盖 fork 的 seed 继承）；
- * - 其余：显式覆盖。
- */
-export function applyEffort<T extends RequestConfig>(resolved: T, effort: string | undefined): T {
-  if (effort === undefined) return resolved
-  if (effort === EFFORT_DEFAULT) {
-    const { reasoningEffort: _dropped, ...rest } = resolved
-    return rest as T
-  }
-  return { ...resolved, reasoningEffort: effort } as T
-}
-
-/** 条目校验的输入面（卡片提交的可能为宽松形态）。 */
+/** 条目校验的输入面（settings 写入的 validate 钩子用）。 */
 export interface EntryValidationInput {
   provider?: string | null
   model?: string | null

package/src/delegation.ts

@@ -1,53 +1,49 @@
 /**
  * 运行时挂钩：子代理模型路由的注入点。
  *
- * 机制依据（官方 dsh-subagent / dsh-agent-loop）：
- * - 子代理的模型由【创建时】的 AgentOptions 决定：`resolveChildAgentOptions(parent,
- *   request.agentOptions, depth)` = 父 options 快照 + 显式 agentOptions（后者胜出）。
- *   子代理不经 api-proxy 的 create/resume setup，不安装模型 selection，
- *   `agent/request` 瀑布默认无人覆盖 —— 因此 provider/model 只需注入
- *   `request.agentOptions`，路由即命中。
- * - reasoningEffort 不在 AgentOptions 读取路径上（AgentLoop 只读 provider/model/maxTokens，
- *   子代理 buildRequest 的 effort 仅来自自身 session 折叠的 request/header）。
- *   故 effort 以私有字段随 agentOptions 抵达子代理 options，再由根 ctx 的
- *   `agent/request` 瀑布监听器应用（origin==='subagent' 过滤）。
- * - 冷恢复（continuable resume）：descriptor 持久化 agentProvider/agentModel
- *   （来自 request.agentOptions），恢复后模型保持；effort 经 session log 的
- *   request/header 保留 —— 与热路径注入结果一致。
+ * 机制依据（官方 dsh-subagent 0.1.2-rc.1）：子代理的模型由【创建时】的
+ * AgentOptions 决定——`resolveChildAgentOptions(parent, request.agentOptions,
+ * childDepth)` = 父 options 快照 + 显式 agentOptions（后者胜出），且原生读取
+ * provider/model/reasoningEffort 三个字段（materialize → agents.create/resume
+ * → agentLoop.options），冷恢复（continuable resume）经 descriptor 持久化保持。
+ * 因此只需在 `request.agentOptions` 注入 provider/model/reasoningEffort，
+ * 路由即命中，无需旧版 effort 瀑布的私有字段搬运。
  *
  * 两个挂钩均幂等（Symbol 标记 + dispose 恢复），HMR 重载安全。
- * @module subagent-model/delegation
+ * @module @dsh-plus/subagent-model/delegation
  */
 import type { Context } from '@deepseek-ai/cordis'
-import type { AgentOptions } from '@deepseek-ai/dsh-agent'
-import type { LlmCallConfig } from '@deepseek-ai/dsh-llm'
-import type { ContinuableStartSpec, SubagentStartRequest } from '@deepseek-ai/dsh-subagent'
 
 import {
-  applyEffort,
+  entryFor,
+  type InjectedOptions,
   mergeAgentOptions,
-  type RequestConfig,
-  resolveEntry,
   type SubagentModelConfig,
 } from './config.ts'
 
 const WRAPPED = Symbol('dsh-plus-subagent-model.wrapped')
 
 /** 子代理服务的最小运行期面（仅包装用到的两个入口）。 */
-interface SubagentsLike {
+export interface SubagentsLike {
   start(name: string, request: SubagentStartRequest): Promise<unknown>
   startContinuable(spec: ContinuableStartSpec): Promise<unknown>
 }
 
-function entryFor(current: () => SubagentModelConfig, name: string | undefined) {
-  if (name === undefined) return undefined
-  const entry = current().entries[name]
-  return entry === undefined ? undefined : resolveEntry(entry)
+/** 子代理创建请求的窄面（只读 agentOptions）。 */
+export interface SubagentStartRequest {
+  agentOptions?: InjectedOptions
+}
+
+/** 可继续子代理启动规范的窄面。 */
+export interface ContinuableStartSpec {
+  provider: string
+  request: SubagentStartRequest
 }
 
 /**
- * 包装 `ctx.subagents.start` / `startContinuable`：按 provider 名命中配置条目，
- * 向委托请求注入 agentOptions（显式工具行配置优先，插件只补空缺）。
+ * 包装 `ctx.subagents.start` / `startContinuable`：按 provider 名命中配置条目
+ * （未命中回落 default 条目），向委托请求注入 agentOptions——调用方显式携带
+ * 的 agentOptions（工具行配置 / 主代理显式选择）优先，插件只补空缺。
  * 未命中条目时完全直通（原生继承主代理行为）。
  * 返回注销函数（恢复原方法），随调用方 fiber 释放。
  */
@@ -96,30 +92,3 @@ export function installDelegationHook(
     'subagent-model: delegation hook',
   )
 }
-
-/**
- * 读取一次 LLM 请求的发起 agent 上本插件携带的 effort 私有标记：
- * 仅对子代理（session header origin==='subagent'）生效，主代理不受影响。
- * 纯函数（agent 为最小结构面），便于单测。
- */
-export function childEffortOf(agent: {
-  session: { header: { origin?: 'subagent' } }
-  options: AgentOptions & { reasoningEffort?: string }
-}): string | undefined {
-  if (agent.session.header.origin !== 'subagent') return undefined
-  return agent.options.reasoningEffort
-}
-
-/**
- * 根 ctx 监听 `agent/request` 瀑布：对子代理应用条目配置的思考程度。
- * provider/model 无需在此处理（路由直接读 options）。
- * 根级监听覆盖 HMR 重载后已存在子代理的后续请求。
- */
-export function installChildRoute(ctx: Context): void {
-  ctx.on('agent/request', async (payload, next) => {
-    const resolved = await next()
-    const effort = childEffortOf(payload.agent)
-    if (effort === undefined) return resolved
-    return applyEffort(resolved as RequestConfig, effort) as LlmCallConfig
-  })
-}

package/src/index.ts

@@ -1,9 +1,10 @@
 /**
  * dsh 插件：子代理独立模型配置（subagent / subagent_fork 等）。
  * 为子代理按 provider 名配置 LLM 提供商、模型与思考程度（reasoningEffort），
- * 或选择从主代理继承；只负责模型选定，其余参数（maxTokens/persona/toolFilter/
- * maxDepth 等）保持 dsh 原生行为。配置 UI 位于 webui 设置-插件-插件配置，
- * 持久化到 $DSH_HOME/settings.yaml 并热生效。
+ * 或选择从主代理继承；`default` 条目可让 spawn/fork 共享同一路由。
+ * 主代理显式选择的路由（官方 subagent-model-selection 的 model 字段）优先，
+ * 本插件只补"未选择时的强制默认"。
+ * 配置经 settings 用户层（$DSH_HOME/settings.yaml）持久化并热生效。
  * @module @dsh-plus/subagent-model
  */
 import type { Context } from '@deepseek-ai/cordis'
@@ -13,7 +14,7 @@ import { SubagentModelService } from './service.ts'
 
 export const name = 'dsh-plus-subagent-model'
 
-export const inject = ['subagents', 'llm'] as const
+export const inject = ['subagents'] as const
 
 export type {
   EntryConfig,

package/src/ns.ts

@@ -1,9 +1,6 @@
 /**
- * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
- * 服务端经 settingsNamespace() 品牌化后使用（config.ts），浏览器半将其作为
- * settings.plugin.item keyed 槽位的 key —— 同一字面量两处共用，防止漂移。
- * 契约：dsh rc7 起该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
- * 官方配置页只渲染 key 命中 Host 已注册命名空间的卡片。
- * @module subagent-model/ns
+ * settings 命名空间字面量（纯常量，零依赖）。沿用旧版插件命名空间，
+ * 已存在于生产 settings.yaml 的旧配置可直接续用。
+ * @module @dsh-plus/subagent-model/ns
  */
 export const SETTINGS_NS = 'dsh-plus-subagent-model'