@dsh-plus/subagent-model 0.2.0 → 0.3.0

package/src/client/draft.ts

@@ -0,0 +1,69 @@
+/**
+ * 配置卡片的可编辑草稿模型：ConfigValue ↔ Draft 转换与提交补丁（纯函数，
+ * 与渲染分离以便单测）。行集合 = 目录返回的已注册子代理 provider ∪ 已配置条目；
+ * 未配置的新 provider 行以默认空值落盘（自文档化）。
+ * @module subagent-model/client/draft
+ */
+import type { ModelCatalog } from './api.ts'
+
+/** settings 命名空间的解析值（无 secret 字段）。 */
+export interface ConfigValue {
+  enabled: boolean
+  entries: Record<string, WireEntry>
+}
+
+export interface WireEntry {
+  enabled: boolean
+  provider: string
+  model: string
+  reasoningEffort: string
+}
+
+export interface DraftRow {
+  enabled: boolean
+  provider: string
+  model: string
+  reasoningEffort: string
+}
+
+export interface Draft {
+  enabled: boolean
+  rows: Record<string, DraftRow>
+}
+
+export const EMPTY_ROW: DraftRow = {
+  enabled: false,
+  provider: '',
+  model: '',
+  reasoningEffort: 'inherit',
+}
+
+/** 行集 = 目录 subagentProviders ∪ 已配置条目；目录行缺省为空行。 */
+export function draftFrom(value: ConfigValue, catalog: ModelCatalog | null): Draft {
+  const rows: Record<string, DraftRow> = {}
+  const names = new Set<string>()
+  for (const name of catalog?.subagentProviders ?? []) names.add(name)
+  for (const name of Object.keys(value.entries).sort()) names.add(name)
+  for (const name of names) {
+    const entry = value.entries[name]
+    rows[name] =
+      entry === undefined
+        ? { ...EMPTY_ROW }
+        : {
+            enabled: entry.enabled,
+            provider: entry.provider,
+            model: entry.model,
+            reasoningEffort: entry.reasoningEffort,
+          }
+  }
+  return { enabled: value.enabled, rows }
+}
+
+export function toPatch(draft: Draft): Record<string, unknown> {
+  // entries 按键排序物化：dirty 比较走 JSON.stringify，而草稿的播种路径
+  // （先 entries 后补目录空行）与 draftFrom（先目录后 entries）键序不同，
+  // 不排序会出现「未改动却永久 dirty」的假阳性。
+  const entries: Record<string, DraftRow> = {}
+  for (const name of Object.keys(draft.rows).sort()) entries[name] = draft.rows[name]
+  return { enabled: draft.enabled, entries }
+}

package/src/client/i18n.ts

@@ -0,0 +1,65 @@
+/**
+ * 配置卡片文案（zh/en）。经 ctx.locale.register 注册、bind 取用，与官方卡片同机制。
+ * 公共键（save/discard/unsaved 等）来自 shared 的 common 字典，本文件只维护业务键。
+ * @module subagent-model/client/i18n
+ */
+import { commonEn, commonZh, mergeDict } from '@dsh-plus/shared/client'
+
+export const NS = 'dsh-plus-subagent-model'
+
+const ownZh = {
+  title: '子代理模型配置',
+  description: '为 subagent / subagent_fork 等子代理单独指定提供商、模型与思考程度，或继承主代理。',
+  enabled: '启用插件',
+  rowEnabled: '启用该行',
+  provider: '提供商',
+  model: '模型',
+  effort: '思考程度',
+  inheritProvider: '继承主代理',
+  inheritModel: '继承主代理',
+  effortInherit: '继承主代理',
+  effortDefault: '跟随模型默认',
+  providerHint: '留空 = 子代理沿用主代理的提供商与模型。',
+  modelHint: '留空 = 沿用主代理的模型（需与所选提供商匹配）。',
+  effortHint: 'inherit = 不干预（fork 会随会话继承）；default = 显式使用模型默认档位。',
+  rowHint:
+    '按子代理 provider 名匹配；standard preset 中 spawn ↔ subagent 工具、fork ↔ subagent_fork 工具。',
+  rowDesc: '未注册的 provider 行不生效，可保留待用。',
+  noRows: '当前未发现子代理 provider；配置将在 provider 注册后生效。',
+  catalogError: '提供商目录加载失败：',
+  catalogRetry: '重试',
+  catalogLoading: '目录加载中…',
+  unknownValue: '目录外',
+  invalidModel: '模型不能脱离提供商单独配置。',
+}
+
+const ownEn = {
+  title: 'Subagent model config',
+  description:
+    'Pick a provider, model, and thinking effort for subagent / subagent_fork children, or inherit from the main agent.',
+  enabled: 'Enable plugin',
+  rowEnabled: 'Enable row',
+  provider: 'Provider',
+  model: 'Model',
+  effort: 'Effort',
+  inheritProvider: 'Inherit from main agent',
+  inheritModel: 'Inherit from main agent',
+  effortInherit: 'Inherit from main agent',
+  effortDefault: 'Follow model default',
+  providerHint: 'Empty = the child follows the main agent\u2019s provider and model.',
+  modelHint: 'Empty = follow the main agent\u2019s model (must match the chosen provider).',
+  effortHint:
+    'inherit = do not touch (forks inherit via session seed); default = explicitly use the model\u2019s default level.',
+  rowHint:
+    'Matched by subagent provider name; in the standard preset spawn \u2194 subagent tool, fork \u2194 subagent_fork tool.',
+  rowDesc: 'Rows for unregistered providers are inert; keep them for later.',
+  noRows: 'No subagent provider registered yet; config takes effect once one appears.',
+  catalogError: 'Failed to load provider catalog: ',
+  catalogRetry: 'Retry',
+  catalogLoading: 'Loading catalog\u2026',
+  unknownValue: 'outside catalog',
+  invalidModel: 'Model cannot be set without a provider.',
+}
+
+export const zh: Record<string, string> = mergeDict(commonZh, ownZh)
+export const en: Record<string, string> = mergeDict(commonEn, ownEn)

package/src/client/styles.ts

@@ -0,0 +1,30 @@
+/**
+ * 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('dsm')，
+ * 本文件只补插件特有规则（provider 行块 / banner / 目录空态）。
+ * 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载）。
+ * @module subagent-model/client/styles
+ */
+import { cardCss, injectCardStyle } from '@dsh-plus/shared/client'
+
+export const PLUGIN_ID = '@dsh-plus/subagent-model'
+
+const extraCss = `
+.dsm-row{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);border-radius:10px;margin:12px 0 0;padding:4px 12px 10px}
+.dsm-rowHead{align-items:center;gap:8px;padding:8px 0 2px;display:flex}
+.dsm-rowName{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:13px;font-weight:600;line-height:1.5}
+.dsm-rowHint{color:var(--dsw-alias-label-tertiary);margin:0 0 4px;font-size:12px;line-height:1.5}
+.dsm-banner{background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);justify-content:space-between;align-items:center;gap:8px;border-radius:8px;margin-top:12px;padding:7px 8px;font-size:12px;line-height:18px;display:flex}
+.dsm-bannerRetry{color:inherit;font:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0;font-weight:600}
+.dsm-empty{color:var(--dsw-alias-label-tertiary);margin:12px 0 0;font-size:12px;line-height:1.5}
+@media (max-width:767px){
+.dsm-row{padding:2px 8px 8px}
+.dsm-rowHead{flex-wrap:wrap}
+}
+`
+
+export const cardCssAll = cardCss('dsm', extraCss)
+
+/** 幂等注入样式标签；返回标签（已存在或环境无 document 时为 null）。 */
+export function injectStyle(): HTMLStyleElement | null {
+  return injectCardStyle(PLUGIN_ID, cardCssAll)
+}

package/src/config-api.ts

@@ -0,0 +1,53 @@
+/**
+ * 自定义端点 HTTP 通道：配置读写已迁移到官方 settings RPC（rc7 起第三方
+ * 命名空间全量开放），这里只保留官方传输没有的「模型目录」端点。
+ * 仅监听 dsh web 同源（webserver 默认 127.0.0.1），与 GUI 其余面同等暴露面。
+ * @module subagent-model/config-api
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http'
+
+import type { Context } from '@deepseek-ai/cordis'
+
+import { buildModelCatalog, type ModelCatalog } from './catalog.ts'
+
+const ROUTE_CATALOG = '/dsh-plus/subagent-model/catalog'
+
+function sendJson(res: ServerResponse, status: number, body: unknown): void {
+  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' })
+  res.end(JSON.stringify(body))
+}
+
+async function handleCatalog(ctx: Context, res: ServerResponse): Promise<void> {
+  const catalog: ModelCatalog = await buildModelCatalog(ctx)
+  sendJson(res, 200, catalog)
+}
+
+/** 注册目录路由；返回是否注册成功（webServer 缺失时由调用方保证不调用）。 */
+export function registerCatalogApi(ctx: Context): void {
+  const logger = ctx.logger('subagent-model')
+  const guard = (
+    handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>,
+  ): ((req: IncomingMessage, res: ServerResponse) => Promise<void>) => {
+    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)
+    }),
+  })
+}

package/src/index.ts

@@ -4,7 +4,9 @@
  * 或选择从主代理继承；`default` 条目可让 spawn/fork 共享同一路由。
  * 主代理显式选择的路由（官方 subagent-model-selection 的 model 字段）优先，
  * 本插件只补"未选择时的强制默认"。
- * 配置经 settings 用户层（$DSH_HOME/settings.yaml）持久化并热生效。
+ * 配置经 settings 用户层（$DSH_HOME/settings.yaml）持久化并热生效；
+ * 配置 UI 位于 webui 设置-插件-插件配置（settings.plugin.item 卡片，
+ * 模型目录经 host webServer 同源端点下发）。
  * @module @dsh-plus/subagent-model
  */
 import type { Context } from '@deepseek-ai/cordis'
@@ -14,7 +16,7 @@ import { SubagentModelService } from './service.ts'
 
 export const name = 'dsh-plus-subagent-model'
 
-export const inject = ['subagents'] as const
+export const inject = ['subagents', 'llm'] as const
 
 export type {
   EntryConfig,

package/src/service.ts

@@ -5,11 +5,14 @@
  *   走 validateEntries 规则（model 不能脱离 provider 等），非法即拒。
  * - 委托挂钩：包装 ctx.subagents.start/startContinuable，按 provider 名
  *   （未命中回落 default 条目）注入 agentOptions（provider/model/effort）。
+ * - 自定义端点：ctx.webServer 仅注册模型目录路由（配置读写已走官方
+ *   remote.settings 直连，settings.plugin.item 卡片见 client 半）。
  * @module @dsh-plus/subagent-model
  */
 import { Context, Service } from '@deepseek-ai/cordis'
 
 import { Config, SETTINGS_NS, type SubagentModelConfig, validateEntries } from './config.ts'
+import { registerCatalogApi } from './config-api.ts'
 import { installDelegationHook } from './delegation.ts'
 
 declare module '@deepseek-ai/cordis' {
@@ -19,7 +22,7 @@ declare module '@deepseek-ai/cordis' {
 }
 
 export class SubagentModelService extends Service {
-  static [Context.inject] = ['subagents']
+  static [Context.inject] = ['subagents', 'llm']
 
   private current: () => SubagentModelConfig
 
@@ -41,6 +44,10 @@ export class SubagentModelService extends Service {
       })
     })
     installDelegationHook(ctx, () => this.current())
+    // 模型目录端点（卡片下拉数据源；仅监听 dsh web 同源）。
+    ctx.inject(['webServer'], (webCtx) => {
+      registerCatalogApi(webCtx)
+    })
   }
 
   /** 当前生效配置（settings 用户层解析结果或 cordis 行级 config）。 */