@dsh-plus/subagent-model 0.3.12 → 0.3.14

package/lib/client.js

@@ -42,7 +42,7 @@ window.__ModuleLoader__.load({
 							className: `${p}-pending`,
 							children: props.dirtyLabel
 						}) : null,
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: `${p}-chevron${props.open ? ` ${p}-chevronOpen` : ""}` })
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular, { className: `${p}-chevron${props.open ? ` ${p}-chevronOpen` : ""}` })
 					]
 				}), props.open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: `${p}-body`,
@@ -458,7 +458,8 @@ ${extra}
 		* 「子代理模型配置」配置卡片：经 injectPluginConfigCard 注册（legacy settings.plugin.item
 		* 与 0.1.6-alpha.2 插件页 plugins.row.config / plugins.bundle.config，view 分发 summary/page）。
 		* 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/CheckRow/SelectField）。
-		* 配置读写走官方 settingsScope 传输：value 为 schema 解析后的命名空间值
+		* 配置读写经共享层 ctx.remote.settings 直连（0.1.7 起 settingsScope 已由 configForms
+		* 取代）：value 为 schema 解析后的命名空间值
 		* （enabled + entries），行集合 = 目录返回的已注册子代理 provider
 		* ∪ 已配置条目，保存时全量写回 entries（未配置的新 provider 行以默认空值
 		* 落盘，自文档化）；「模型目录」为唯一保留的自定义端点。

package/lib/index.d.ts

@@ -1,5 +1,6 @@
-import z from "@deepseek-ai/schemastery";
 import { Context, Service } from "@deepseek-ai/cordis";
+import { VolatileFields } from "@dsh-plus/shared";
+import z from "@deepseek-ai/schemastery";
 //#region src/config.d.ts
 /** 一条条目的规范输出形态。 */
 interface EntryConfig {
@@ -23,7 +24,9 @@ interface SubagentModelConfigInput {
     reasoningEffort?: string | null;
   }> | null;
 }
-declare const Config: z<SubagentModelConfigInput, SubagentModelConfig>;
+/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+type SubagentModelConfigFields = VolatileFields<SubagentModelConfig>;
+declare const Config: z<SubagentModelConfigInput, SubagentModelConfigFields>;
 /** 注入子代理 AgentOptions 的结果对象：只含需要覆盖的字段。 */
 interface InjectedOptions {
   provider?: string;
@@ -40,7 +43,7 @@ declare module '@deepseek-ai/cordis' {
 declare class SubagentModelService extends Service {
   static inject: string[];
   private current;
-  constructor(ctx: Context, config: SubagentModelConfig);
+  constructor(ctx: Context, config: SubagentModelConfig | SubagentModelConfigFields);
   /** 当前生效配置（settings 用户层解析结果或 cordis 行级 config）。 */
   currentConfig(): SubagentModelConfig;
 }
@@ -48,6 +51,6 @@ declare class SubagentModelService extends Service {
 //#region src/index.d.ts
 declare const name = "dsh-plus-subagent-model";
 declare const inject: readonly ['subagents', 'llm'];
-declare function apply(ctx: Context, config: SubagentModelConfig): void;
+declare function apply(ctx: Context, config: SubagentModelConfig | SubagentModelConfigFields): void;
 //#endregion
 export { Config, type EntryConfig, type InjectedOptions, type SubagentModelConfig, SubagentModelService, apply, inject, name };

package/lib/index.js

@@ -1,6 +1,6 @@
-import z from "@deepseek-ai/schemastery";
 import { Service } from "@deepseek-ai/cordis";
-//#endregion
+import { unwrapVolatile } from "@dsh-plus/shared";
+import z from "@deepseek-ai/schemastery";
 //#region src/config.ts
 /**
 * 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
@@ -19,8 +19,6 @@ import { Service } from "@deepseek-ai/cordis";
 * "管理端强制默认路由"——主代理未显式选择时才注入，显式选择仍优先。
 * @module @dsh-plus/subagent-model/config
 */
-/** settings 命名空间（字面量即合法命名空间；webui 配置卡片与插件运行期读取同一份）。 */
-const SETTINGS_NS = "dsh-plus-subagent-model";
 /** 思考程度哨兵值：继承主代理（不注入 effort 字段）。 */
 const EFFORT_INHERIT = "inherit";
 /** 思考程度哨兵值：跟随模型默认（显式剥离任何继承/推导出的 effort）。 */
@@ -34,8 +32,8 @@ const EntrySchema = z.object({
 	reasoningEffort: z.string().description(`思考程度：${EFFORT_INHERIT}（继承主代理）/ ${EFFORT_DEFAULT}（跟随模型默认）/ 提供商目录档位 id`).default(EFFORT_INHERIT)
 });
 const Config = z.object({
-	enabled: z.boolean().description("总开关").default(false),
-	entries: z.dict(EntrySchema).description("按子代理 provider 名（spawn/fork/…）配置").default({})
+	enabled: z.boolean().description("总开关").default(false).volatile(),
+	entries: z.dict(EntrySchema).description("按子代理 provider 名（spawn/fork/…）配置").default({}).volatile()
 });
 /**
 * 解析一条条目为要注入的 agentOptions 片段。
@@ -244,18 +242,13 @@ var SubagentModelService = class extends Service {
 	current;
 	constructor(ctx, config) {
 		super(ctx, "subagentModel");
-		this.current = () => config;
-		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: () => {}
-			});
+		this.current = () => unwrapVolatile(config);
+		ctx.on("internal/config", function(_raw, next) {
+			const candidate = next();
+			if (this !== ctx.fiber) return candidate;
+			const error = validateEntries(unwrapVolatile(Config(candidate)).entries);
+			if (error !== null) throw new Error(`subagent-model: ${error}`);
+			return candidate;
 		});
 		installDelegationHook(ctx, () => this.current());
 		ctx.inject(["webServer"], (webCtx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/subagent-model",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "dsh-plus service+ui plugin: 为 subagent/subagent_fork 等子代理按提供商配置模型与思考程度（或继承主代理）",
   "type": "module",
   "main": "lib/index.js",
@@ -19,23 +19,23 @@
     "src"
   ],
   "dependencies": {
-    "@dsh-plus/shared": "0.1.21"
+    "@dsh-plus/shared": "0.1.23"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-subagent": "0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-subagent": "0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "26.4.0",
     "@types/react": "~18.3.31",
     "react": "^18.2.0"

package/src/client/api.ts

@@ -1,6 +1,6 @@
 /**
- * 自定义端点通道：仅剩「模型目录」（配置读写已迁移到官方 settingsScope
- * 传输，见 scope.ts 与 card.tsx）。
+ * 自定义端点通道：仅剩「模型目录」（配置读写已迁移到共享层
+ * ctx.remote.settings（0.1.7 起 settingsScope 已删）传输，见 scope.ts 与 card.tsx）。
  * @module subagent-model/client/api
  */
 

package/src/client/card.tsx

@@ -2,7 +2,8 @@
  * 「子代理模型配置」配置卡片：经 injectPluginConfigCard 注册（legacy settings.plugin.item
  * 与 0.1.6-alpha.2 插件页 plugins.row.config / plugins.bundle.config，view 分发 summary/page）。
  * 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/CheckRow/SelectField）。
- * 配置读写走官方 settingsScope 传输：value 为 schema 解析后的命名空间值
+ * 配置读写经共享层 ctx.remote.settings 直连（0.1.7 起 settingsScope 已由 configForms
+ * 取代）：value 为 schema 解析后的命名空间值
  * （enabled + entries），行集合 = 目录返回的已注册子代理 provider
  * ∪ 已配置条目，保存时全量写回 entries（未配置的新 provider 行以默认空值
  * 落盘，自文档化）；「模型目录」为唯一保留的自定义端点。

package/src/client/client.ts

@@ -8,8 +8,8 @@
  * 类型说明：浏览器半只用到 slots/locale/remote 的很窄一面，
  * scope 与基础控件走 @dsh-plus/shared/client 套件（收编自本插件原实现）。
  * 0.1.2-alpha.1 起配置读写统一走 ctx.remote.settings 直连
- * （connection.api.settings RPC 面已移除；不复用 settingsScope 服务——
- * 非 loopback 页面下它固定 memory 模式无数据）；自定义端点仅剩「模型目录」（api.ts）。
+ * （connection.api.settings RPC 面已移除；0.1.7 起 settingsScope 服务亦删除——
+ * configForms 取代，插件卡片自始直连 remote.settings）；自定义端点仅剩「模型目录」（api.ts）。
  * 卡片 key/rowId 约定见 @dsh-plus/shared/client/config-slots。
  * @module @dsh-plus/subagent-model/client
  */

package/src/config.ts

@@ -17,6 +17,7 @@
  */
 
 import z from '@deepseek-ai/schemastery'
+import type { VolatileFields } from '@dsh-plus/shared'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
@@ -70,9 +71,19 @@ const EntrySchema = z.object({
     .default(EFFORT_INHERIT),
 })
 
-export const Config: z<SubagentModelConfigInput, SubagentModelConfig> = z.object({
-  enabled: z.boolean().description('总开关').default(false),
-  entries: z.dict(EntrySchema).description('按子代理 provider 名（spawn/fork/…）配置').default({}),
+// 0.1.7：全字段 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
+// loader 原位提交活动引用；输出面标注活动字段声明面（结构兼容 volatile 引用），
+// 平面消费契约保持 SubagentModelConfig 接口不变。
+/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+export type SubagentModelConfigFields = VolatileFields<SubagentModelConfig>
+
+export const Config: z<SubagentModelConfigInput, SubagentModelConfigFields> = z.object({
+  enabled: z.boolean().description('总开关').default(false).volatile(),
+  entries: z
+    .dict(EntrySchema)
+    .description('按子代理 provider 名（spawn/fork/…）配置')
+    .default({})
+    .volatile(),
 })
 
 /** 注入子代理 AgentOptions 的结果对象：只含需要覆盖的字段。 */

package/src/index.ts

@@ -12,7 +12,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis'
 
-import { Config, type SubagentModelConfig } from './config.ts'
+import type { SubagentModelConfig, SubagentModelConfigFields } from './config.ts'
 import { SubagentModelService } from './service.ts'
 
 export const name = 'dsh-plus-subagent-model'
@@ -24,9 +24,10 @@ export type {
   InjectedOptions,
   SubagentModelConfig,
 } from './config.ts'
+export { Config } from './config.ts'
 export { SubagentModelService } from './service.ts'
-export { Config }
 
-export function apply(ctx: Context, config: SubagentModelConfig): void {
+// config 运行期为 loader 解析的 volatile 活动字段（测试可直接传平面值）。
+export function apply(ctx: Context, config: SubagentModelConfig | SubagentModelConfigFields): void {
   ctx.plugin(SubagentModelService, config)
 }

package/src/service.ts

@@ -1,8 +1,8 @@
 /**
  * SubagentModelService：子代理模型配置中枢（host 半）。
- * - 配置：installSection 接入 settings 用户层（$DSH_HOME/settings.yaml，热生效），
- *   无 settings provider 时退化为 cordis 行级 config；写入经 validate 钩子
- *   走 validateEntries 规则（model 不能脱离 provider 等），非法即拒。
+ * - 配置：0.1.7 volatile 活动引用（loader 解析层并入用户层，GUI 写入原位提交
+ *   热生效）；写入经 internal/config waterfall 校验（validateEntries 规则
+ *   （model 不能脱离 provider 等），非法即拒、不落盘）。
  * - 委托挂钩：包装 ctx.subagents.start/startContinuable，按 provider 名
  *   （未命中回落 default 条目）注入 agentOptions（provider/model/effort）。
  * - 自定义端点：ctx.webServer 仅注册模型目录路由（配置读写已走官方
@@ -12,8 +12,15 @@
 import type { Context } from '@deepseek-ai/cordis'
 import { Service } from '@deepseek-ai/cordis'
 import type {} from '@deepseek-ai/dsh-settings'
+import { unwrapVolatile } from '@dsh-plus/shared'
 
-import { Config, SETTINGS_NS, type SubagentModelConfig, validateEntries } from './config.ts'
+import {
+  Config,
+  type SubagentModelConfig,
+  type SubagentModelConfigFields,
+  type SubagentModelConfigInput,
+  validateEntries,
+} from './config.ts'
 import { registerCatalogApi } from './config-api.ts'
 import { installDelegationHook } from './delegation.ts'
 
@@ -30,22 +37,21 @@ export class SubagentModelService extends Service {
 
   private current: () => SubagentModelConfig
 
-  constructor(ctx: Context, config: SubagentModelConfig) {
+  constructor(ctx: Context, config: SubagentModelConfig | SubagentModelConfigFields) {
     super(ctx, 'subagentModel')
-    this.current = () => config
-    // 官方 installSection 范式（同 secret-env/usage-panel）：setSource 收到的是
-    // () => scope.get() 活视图——委托挂钩永远现取最新配置，热生效无竞态。
-    ctx.inject(['settings'], (settingsCtx) => {
-      settingsCtx.settings.installSection(ctx, SETTINGS_NS, Config, config, {
-        validate: (cfg: SubagentModelConfig) => {
-          const error = validateEntries(cfg.entries)
-          if (error !== null) throw new Error(`subagent-model: ${error}`)
-        },
-        setSource: (source: () => SubagentModelConfig) => {
-          this.current = source
-        },
-        onChange: () => {},
-      })
+    // 0.1.7 替代 installSection/setSource：活动引用原位提交——委托挂钩
+    // 永远现取最新配置，热生效无竞态。
+    this.current = () => unwrapVolatile(config)
+    // 写入校验（原 installSection validate；官方 llm-pi-ai 同款 waterfall）：
+    // configEditor.edit 落盘前先跑 internal/config，handler throw 即拒绝整笔写入。
+    ctx.on('internal/config', function (_raw: unknown, next: () => unknown) {
+      const candidate = next()
+      if (this !== ctx.fiber) return candidate
+      const error = validateEntries(
+        unwrapVolatile(Config(candidate as SubagentModelConfigInput)).entries,
+      )
+      if (error !== null) throw new Error(`subagent-model: ${error}`)
+      return candidate
     })
     installDelegationHook(ctx, () => this.current())
     // 模型目录端点（卡片下拉数据源；仅监听 dsh web 同源）。