dsh-subagent-profile 0.3.0 → 0.3.2

package/README.md

@@ -4,7 +4,7 @@
 <div align="center">
   <b style="font-size: 1.15em;">Subagent dispatch, profiled — the right agent for the right task (preset / model / reasoning effort)</b><br /><br />
   <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" />
-  <img alt="Version: v0.3.0" src="https://img.shields.io/badge/Version-v0.3.0-blue.svg" />
+  <img alt="Version: v0.3.2" src="https://img.shields.io/badge/Version-v0.3.2-blue.svg" />
   <img alt="npm" src="https://img.shields.io/npm/v/dsh-subagent-profile.svg" />
   <img alt="DSH" src="https://img.shields.io/badge/DSH-0.1.0--rc.6%20~%200.1.1--rc.2-blue.svg" />
 </div>

package/README.zh.md

@@ -4,7 +4,7 @@
 <div align="center">
   <b style="font-size: 1.15em;">子 Agent 派发方案化插件 —— 用对的人（预设 / 模型 / 推理强度）干对的事</b><br /><br />
   <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" />
-  <img alt="Version: v0.3.0" src="https://img.shields.io/badge/Version-v0.3.0-blue.svg" />
+  <img alt="Version: v0.3.2" src="https://img.shields.io/badge/Version-v0.3.2-blue.svg" />
   <img alt="npm" src="https://img.shields.io/npm/v/dsh-subagent-profile.svg" />
   <img alt="DSH" src="https://img.shields.io/badge/DSH-0.1.0--rc.6%20~%200.1.1--rc.2-blue.svg" />
 </div>

package/index.mjs

@@ -1,4 +1,4 @@
-// index.mjs — dsh-subagent-profile 宿主侧正式插件 bundle（只做装配）。
+// index.mjs — dsh-subagent-profile 宿主侧正式插件 bundle（只做装配）。
 // 源自原型动态插件 `code.host` 主体；宿主导入面（registerTool/defineTool/
 // handle）收敛在 lib/core/shims.mjs，装配块按模块拆分驻留 lib/core/（catalog /
 // presets-sync / profiles-store / cost-guard / whitelist / intersection /
@@ -13,6 +13,8 @@ import { dshHome, createProfileStore } from './lib/core/profiles-store.mjs';
 import { createHttpRoutes } from './lib/core/http-routes.mjs';
 import { createProfileProvider } from './lib/core/profile-provider.mjs';
 import { createDispatchTool } from './lib/core/dispatch-tool.mjs';
+import { createCatalogCache } from './lib/core/catalog-cache.mjs';
+import { tierSortKey } from './lib/core/pure.mjs';
 
 export const name = 'dsh-subagent-profile';
 export const inject = ['subagents', 'tools', 'agents'];
@@ -98,12 +100,13 @@ function profileSectionText(store, gate, context) {
   if (!gate(context)) return '';
   const rows = [...store.profiles.values()]
     .filter((p) => p.enabled !== false)
+    .sort((a, b) => tierSortKey(a.tokenTier) - tierSortKey(b.tokenTier))
     .map((p) => {
       const desc = typeof p.description === 'string' && p.description.length > 0 ? `"${p.description}"` : '(无描述)';
       return `- ${p.id}: ${desc}${p.preset !== undefined ? ` (preset: ${p.preset})` : ''}`;
     });
   if (rows.length === 0) return '';
-  const note = '- 别把 1-2 步即可自查/可搜完的小事委派出去 —— 几分钟内能自查完的直接做。';
+  const note = '- 选择方案时先匹配任务复杂度与方案描述的能力边界，成本只在能力都胜任的方案之间比较——复杂任务不得为省 token 改用能力不足的便宜方案。\n- 别把 1-2 步即可自查/可搜完的小事委派出去 —— 几分钟内能自查完的直接做。';
   return `Available dispatch profiles (dispatch.profile):\n${rows.join('\n')}\n${note}`;
 }
 
@@ -141,7 +144,7 @@ function registerSystemPromptSections(ctx, store, getEnabled) {
 // (listen) is async and may not be ready when this plugin's inject deps
 // resolve, so register inside an inject sub-scope that waits for it
 // (ctx.get would read undefined at apply time).
-function registerSettingsRoutes(ctx, store, getEnabled, setEnabled, syncTool) {
+function registerSettingsRoutes(ctx, store, getEnabled, setEnabled, syncTool, catalog) {
   ctx.inject(['webServer'], (scope) => {
     scope.effect(createHttpRoutes({
       webServer: scope.webServer,
@@ -149,14 +152,24 @@ function registerSettingsRoutes(ctx, store, getEnabled, setEnabled, syncTool) {
       getEnabled,
       setEnabled,
       syncTool,
-      getLlm: () => ctx.get('llm'),
-      getAgentPresets: () => ctx.get('agentPresets'),
-      getTools: () => ctx.tools,
+      catalog,
       logger: ctx.logger,
     }), 'dsh-subagent-profile: settings routes');
   });
 }
 
+// 进程级共享 catalog 快照工厂：一处快照同时喂 /options 三路由与 dispatch 的
+// cost guard（cost guard 经 parent.ctx.get('llm') 传父实例，同一 host llm 下
+// 命中同一条目）。
+function createSharedCatalog(ctx) {
+  return createCatalogCache({
+    getLlm: () => ctx.get('llm'),
+    getAgentPresets: () => ctx.get('agentPresets'),
+    getTools: () => ctx.tools,
+    logger: ctx.logger,
+  });
+}
+
 export async function apply(ctx) {
   // Enable/disable switch (default on, runtime-toggled by the settings
   // page, persisted across restarts) + profile registry — lib/profiles-store
@@ -167,6 +180,8 @@ export async function apply(ctx) {
   store.loadProfiles();
   // Self-install the bundled "orchestrator" preset (idempotent, fail-soft).
   syncBundledPresetsToHome(ctx);
+  // 进程级共享 catalog 快照（/options 三路由 + dispatch cost guard 共用）。
+  const catalog = createSharedCatalog(ctx);
   // `dispatch` tool — lib/core/dispatch-tool.mjs: defineTool block (schema +
   // execute), the result-schema consistency lock and the syncTool
   // register/unregister logic.
@@ -179,6 +194,7 @@ export async function apply(ctx) {
     getService: (name) => ctx.get(name),
     logger: ctx.logger,
     subagents: ctx.subagents,
+    catalog,
   });
   // subagent-profiles service over the store's per-apply profiles Map.
   provideProfileService(ctx, store);
@@ -191,10 +207,11 @@ export async function apply(ctx) {
     store,
     getEnabled: () => enabled,
     logger: ctx.logger,
+    catalog,
   });
   if (typeof disposeProvider === 'function') ctx.effect(() => disposeProvider);
   // HTTP loopback routes for the Client settings UI — lib/core/http-routes.mjs.
-  registerSettingsRoutes(ctx, store, () => enabled, (next) => { enabled = next; }, dispatch.syncTool);
+  registerSettingsRoutes(ctx, store, () => enabled, (next) => { enabled = next; }, dispatch.syncTool, catalog);
   // Teardown: unregister the dispatch tool (if still registered).
   ctx.effect(() => dispatch.dispose);
 }

package/lib/client.js

@@ -14,8 +14,10 @@
  * bordered card per row with a layered name / description / meta layout, and a
  * dashed "+ 新增" button that expands an inline form card instead of a
  * permanently-visible input row. Dropdown options (preset / provider / model /
- * reasoning effort) are served by the host `/options` route from the live
- * presets roster and llm directory.
+ * reasoning effort) are served by the host `/options/summary` (models + presets,
+ * on settings open), `/options/efforts` (per-model, lazy on model select) and
+ * `/options/tools` (tool directory, lazy when the restriction panel opens)
+ * routes from the live presets roster and llm directory.
  *
  * 结构：纯数据（CSS/ZH 文案表）与纯函数（api/解析/文案映射等）驻留模块作用域
  * （load 调用之前的顶层声明）；依赖 React 的组件经参数注入的 maker 函数装配
@@ -40,6 +42,7 @@ const CSS = [
   '.sap-rowActions{align-items:center;gap:4px;margin-left:auto;display:inline-flex}',
   '.sap-desc{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px;line-height:18px}',
   '.sap-warn{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}',
+  '.sap-versionWarn{background:var(--dsw-alias-state-warn-tertiary);border:1px solid var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label);border-radius:8px;flex-direction:column;gap:4px;padding:10px 12px;font-size:12px;line-height:18px;margin:0;display:flex}',
   '.sap-chips{flex-wrap:wrap;gap:6px;display:flex}',
   '.sap-chip{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:6px;flex:none;align-items:center;gap:5px;padding:2px 8px;font-size:12px;line-height:18px;display:inline-flex}',
   '.sap-chipLabel{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}',
@@ -86,6 +89,10 @@ const CSS = [
   '.sap-switch input:checked::before{left:18px}',
   '.sap-toolview{flex-direction:column;align-items:flex-start;gap:6px;padding:4px 8px;display:flex}',
   '.sap-toolText{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);white-space:pre-wrap;word-break:break-word}',
+  '.sap-toolSummary{align-items:center;gap:6px;flex-wrap:wrap;display:flex}',
+  '.sap-detailToggle{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);background:0 0;border-radius:10px;font:inherit;font-size:11px;line-height:16px;height:20px;padding:0 8px;cursor:pointer;flex:none;align-items:center;display:inline-flex}',
+  '.sap-detailToggle:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}',
+  '.sap-toolDetail{font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary);display:flex}',
   '.sap-toolModes{flex-wrap:wrap;gap:4px 16px;display:flex}',
   '.sap-toolGroups{flex-direction:column;gap:8px;display:flex}',
   '.sap-toolLayerCard{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px 10px}',
@@ -116,12 +123,21 @@ const ZH = {
   chipDisabled: '已禁用',
   ignoredMark: '已忽略',
   toolLabel: '派发子 Agent',
+  detailOpen: '详情',
+  detailClose: '收起',
   cont: 'continuable 子 Agent',
   canContinue: '可续跑',
   toolBackground: '后台任务',
   toolForeground: '前台',
   toolRunning: '运行中',
   tierZh: { cheap: '省 token（cheap）', balanced: '均衡（balanced）', premium: '高成本（premium）' },
+  stopReasonZh: { completed: '完成', 'max-tokens': '超出预算', aborted: '已中止', refusal: '已拒绝', error: '出错' },
+  cacheHit: '缓存命中',
+  usageInput: '输入',
+  usageOutput: '输出',
+  usageCacheRead: '缓存读',
+  usageCacheWrite: '缓存写',
+  usageReasoning: '推理',
   persistFail: '已保存但未持久化',
   persistFailHint: '（磁盘写入未成功，重启 dsh web 后该改动可能丢失）'
 }
@@ -225,7 +241,7 @@ function readDispatchRequest(block) {
 // 生效值来源——结构化 value 只存在于执行局部（dsh-tools 约定），且宿主未
 // 定义 output.presentationMeta（block.meta 为空）。解析成功返回
 // {kind, id, fields, ignored}；任何一步不符预期返回 null，调用方回退请求值。
-const DISPATCH_RESULT_KEYS = ['profile', 'preset', 'provider', 'model', 'reasoningEffort', 'tokenTier']
+const DISPATCH_RESULT_KEYS = ['profile', 'preset', 'provider', 'model', 'reasoningEffort', 'tokenTier', 'childTotalTokens', 'childUsage', 'elapsedMs', 'stopReason']
 function parseDispatchText(text) {
   if (typeof text !== 'string') return null
   const firstLine = text.split('\n')[0] ?? ''
@@ -280,6 +296,103 @@ function readDispatchResult(block) {
   return null
 }
 
+// childTotalTokens 文本后缀：宿主 render 行里的 `childTotalTokens=<number>` 经
+// parseDispatchText 解析为字符串，此处归一为「≈N tokens」。仅前台/后台 completed
+// 结算携带；无值返回空串（不显示）。渲染位置紧邻后续的耗时显示。
+function tokensSuffix(result, block) {
+  let raw = null
+  if (result && result.fields && result.fields.childTotalTokens !== undefined && result.fields.childTotalTokens !== '') {
+    raw = result.fields.childTotalTokens
+  } else if (block && block.meta && typeof block.meta === 'object' && block.meta.childTotalTokens !== undefined) {
+    raw = block.meta.childTotalTokens
+  }
+  const n = typeof raw === 'number' ? raw : (typeof raw === 'string' && raw !== '' ? Number(raw) : NaN)
+  return Number.isFinite(n) ? ` · ≈${n} tokens` : ''
+}
+
+// 耗时 + 结束原因后缀：宿主 render 行里的 `elapsedMs=<n>` / `stopReason=<enum>`
+// 经 parseDispatchText 解析为字符串，此处归一为「耗时=<n>ms · stopReason=<中文映射>」。
+// 仅前台 completed 结算携带；后台结算经 job 结果呈现（不进 dispatch 卡片），
+// continuable 不结算、不携带。任一字段缺失即省略该段。
+function observabilitySuffix(result, block) {
+  let elapsedRaw = null
+  let stopRaw = null
+  if (result && result.fields) {
+    if (result.fields.elapsedMs !== undefined && result.fields.elapsedMs !== '') elapsedRaw = result.fields.elapsedMs
+    if (result.fields.stopReason !== undefined && result.fields.stopReason !== '') stopRaw = result.fields.stopReason
+  } else if (block && block.meta && typeof block.meta === 'object') {
+    // 运行中（无结果）或旧版结果：回退调用块 meta（向前兼容，与 tokenTier 同口径）。
+    if (block.meta.elapsedMs !== undefined) elapsedRaw = block.meta.elapsedMs
+    if (block.meta.stopReason !== undefined) stopRaw = block.meta.stopReason
+  }
+  const ms = typeof elapsedRaw === 'number' ? elapsedRaw : (typeof elapsedRaw === 'string' && elapsedRaw !== '' ? Number(elapsedRaw) : NaN)
+  const stopZh = typeof stopRaw === 'string' ? (ZH.stopReasonZh[stopRaw] || stopRaw) : ''
+  if (!Number.isFinite(ms) && stopZh === '') return ''
+  let out = ''
+  if (Number.isFinite(ms)) out += ` · 耗时=${ms}ms`
+  if (stopZh !== '') out += ` · stopReason=${stopZh}`
+  return out
+}
+
+// 把 childUsage 的（render 行 JSON 字符串或 block.meta 对象）归一为五段对象；
+// 非 object / 非 number 段忽略，无任何有效段返回 null。可选字段（缓存读/写/推理）
+// 缺值省略键，与 host 侧 collectChildUsage 输出对齐。
+function parseChildUsage(raw) {
+  if (raw === undefined || raw === null || raw === '') return null
+  let usage = raw
+  if (typeof raw === 'string') {
+    try { usage = JSON.parse(raw) } catch { return null }
+  }
+  if (typeof usage !== 'object' || Array.isArray(usage)) return null
+  const out = {}
+  let any = false
+  for (const key of ['inputTokens', 'outputTokens', 'cacheReadTokens', 'cacheWriteTokens', 'reasoningTokens']) {
+    const value = usage[key]
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
+      out[key] = value
+      any = true
+    }
+  }
+  return any ? out : null
+}
+
+// 读取真实计费五段分解：result.fields.childUsage（render 行 JSON 串）优先，回退
+// block.meta.childUsage（对象，向前兼容旧结果/未来 presentationMeta 投射）。
+function usageFrom(result, block) {
+  if (result && result.fields && result.fields.childUsage !== undefined && result.fields.childUsage !== '') {
+    const parsed = parseChildUsage(result.fields.childUsage)
+    if (parsed !== null) return parsed
+  }
+  if (block && block.meta && typeof block.meta === 'object' && block.meta.childUsage !== undefined) {
+    return parseChildUsage(block.meta.childUsage)
+  }
+  return null
+}
+
+// 缓存命中后缀：childUsage.cacheReadTokens 存在且 >0 时追加「 · 缓存命中 M」到
+// ≈N tokens 之后（前导分隔符与 tokensSuffix/observabilitySuffix 同口径，即使
+// tokens 段缺失也不会粘在一起）；无分解或缓存读为 0/缺失时返回空串。
+function cacheHitSuffix(usage) {
+  if (usage === null) return ''
+  const cacheRead = usage.cacheReadTokens
+  return typeof cacheRead === 'number' && cacheRead > 0 ? ` · ${ZH.cacheHit} ${cacheRead}` : ''
+}
+
+// 五段分解行文案（纯函数，供卡片详情区渲染）；无任何有效段返回空串。
+function usageBreakdownText(usage) {
+  if (usage === null || typeof usage !== 'object') return ''
+  const parts = []
+  const push = (label, value) => {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) parts.push(`${label} ${value}`)
+  }
+  push(ZH.usageInput, usage.inputTokens)
+  push(ZH.usageOutput, usage.outputTokens)
+  push(ZH.usageCacheRead, usage.cacheReadTokens)
+  push(ZH.usageCacheWrite, usage.cacheWriteTokens)
+  push(ZH.usageReasoning, usage.reasoningTokens)
+  return parts.join(' · ')
+}
+
 // ── dispatch 工具卡（React 依赖经参数注入）─────────────────────────────────
 
 // 生效值：结果解析成功用结果（优先），字段缺失回退请求值。
@@ -331,7 +444,7 @@ function buildDispatchChips(el, chip, eff, result, block, ignored, request) {
   const m = rawOrInherit(eff.model)
   chips.push(chip('providerModel', `${ZH.chipProvider}·${ZH.chipModel}`, p === ZH.inherit && m === ZH.inherit ? ZH.inherit : `${p} / ${m}`, { dim: p === ZH.inherit && m === ZH.inherit }))
   chips.push(chip('effort', ZH.chipEffort, effortZh(eff.reasoningEffort), { dim: eff.reasoningEffort === '' || eff.reasoningEffort === '(default)' }))
-  // tokenTier：宿主当前渲染结果尚未产出该字段；字段一旦出现即渲染（向前兼容）。
+  // tokenTier：宿主 render 行已产出；result.fields 缺失时回退 block.meta（向前兼容旧结果）。
   let tier = ''
   if (result && result.fields && typeof result.fields.tokenTier === 'string' && result.fields.tokenTier !== '') {
     tier = result.fields.tokenTier
@@ -367,7 +480,7 @@ function makeChip(el) {
   return chip
 }
 
-function makeDispatchToolview(el, chip) {
+function makeDispatchToolview(el, chip, useState) {
   function DispatchToolview(props) {
     const block = props && props.block
     const request = readDispatchRequest(block)
@@ -375,12 +488,33 @@ function makeDispatchToolview(el, chip) {
     const settled = !!(block && typeof block === 'object' && 'kind' in block)
     const { eff, ignored, kindLabel } = resolveDispatchState(request, result, settled)
     const chips = buildDispatchChips(el, chip, eff, result, block, ignored, request)
-    const p = rawOrInherit(eff.provider)
-    const m = rawOrInherit(eff.model)
-    const text = `${ZH.toolLabel}：${kindLabel} · 方案=${profileZh(eff.profile)} · 预设=${presetZh(eff.preset)} · 提供方=${p} · 模型=${m} · 推理强度=${effortZh(eff.reasoningEffort)}`
+    const usage = usageFrom(result, block)
+    const [open, setOpen] = useState(false)
+    // 摘要行只承载动态结果（成本/耗时/结束原因/缓存命中）；静态配置（方案/预设/
+    // 提供方/模型/推理强度/档位）全部在 chip 行——避免同一组信息重复两遍。
+    const text = `${ZH.toolLabel}：${kindLabel}${tokensSuffix(result, block)}${cacheHitSuffix(usage)}${observabilitySuffix(result, block)}`
+    // 详情折叠入口：仅当存在真实计费分解（childUsage）时渲染；无分解数据
+    // （旧结果/无 usage 会话）不显示折叠区，向前兼容。
+    const detailToggle = usage === null ? null : el('button', {
+      type: 'button',
+      className: 'sap-detailToggle',
+      'aria-expanded': open,
+      onClick: () => setOpen((prev) => !prev)
+    }, open ? ZH.detailClose : ZH.detailOpen)
+    // 无分解数据时保持原摘要行结构（零漂移）；有分解时才加折叠入口与详情行。
+    const summary = usage === null
+      ? el('div', { className: 'sap-toolText' }, text)
+      : el('div', { className: 'sap-toolSummary' },
+          el('div', { className: 'sap-toolText' }, text),
+          detailToggle
+        )
+    const detailBody = open && usage !== null
+      ? el('div', { className: 'sap-toolDetail' }, usageBreakdownText(usage))
+      : null
     return el('div', { className: 'sap-toolview' },
       el('div', { className: 'sap-chips' }, chips),
-      el('div', { className: 'sap-toolText' }, text)
+      summary,
+      detailBody
     )
   }
   return DispatchToolview
@@ -404,7 +538,7 @@ function makeApplyWrite(s) {
   return applyWrite
 }
 
-function makeFormActions(s) {
+function makeFormActions(s, loadEfforts, loadTools) {
   const setField = (key) => (event) => {
     const value = event && event.target ? event.target.value : ''
     s.setForm((prev) => {
@@ -412,8 +546,14 @@ function makeFormActions(s) {
       if (key === 'model') next.reasoningEffort = '' // 换模型时重置推理强度
       return next
     })
+    if (key === 'model' && value !== '') {
+      loadEfforts(value) // 选中模型 → 懒拉该模型 efforts
+    }
+  }
+  const setToolMode = (mode) => () => {
+    if (mode !== 'none') loadTools() // 工具限制面板启用 → 拉完整工具目录
+    s.setForm((prev) => ({ ...prev, toolMode: mode }))
   }
-  const setToolMode = (mode) => () => s.setForm((prev) => ({ ...prev, toolMode: mode }))
   const toggleTool = (name) => () => {
     s.setForm((prev) => {
       const cur = Array.isArray(prev.toolList) ? prev.toolList : []
@@ -439,7 +579,7 @@ function makeFormActions(s) {
   return { setField, setToolMode, toggleTool, selectLayer, clearLayer, invertLayer }
 }
 
-function makeEditActions(s) {
+function makeEditActions(s, loadEfforts, loadTools) {
   const openAdd = () => {
     s.setError('')
     s.setSavedNotice('')
@@ -454,6 +594,10 @@ function makeEditActions(s) {
     const allowArr = Array.isArray(tf.allow) ? tf.allow.slice() : []
     const denyArr = Array.isArray(tf.deny) ? tf.deny.slice() : []
     const toolMode = allowArr.length > 0 ? 'allow' : (denyArr.length > 0 ? 'deny' : 'none')
+    if (toolMode !== 'none') loadTools() // 编辑含 toolFilter 的 profile → 预拉工具目录
+    if (typeof profile.model === 'string' && profile.model !== '') {
+      loadEfforts(profile.model) // 编辑含 model 的 profile → 预拉该模型 efforts（下拉不空白）
+    }
     s.setForm({
       id: profile.id,
       description: typeof profile.description === 'string' ? profile.description : '',
@@ -547,10 +691,41 @@ function makeRowActions(api, s, refresh, applyWrite) {
   return { toggleEnabled, setProfileEnabled, resetAll, remove }
 }
 
-function makeProfilesActions(api, s, refresh, applyWrite) {
+// 选中模型 → 懒拉 /options/efforts（按模型 id 存入 options.efforts）。
+function makeEffortsLoader(api, setOptions) {
+  return (model) => {
+    const q = `?model=${encodeURIComponent(model)}`
+    api(`/options/efforts${q}`)
+      .then((data) => {
+        const list = Array.isArray(data.efforts) ? data.efforts : []
+        setOptions((prev) => ({ ...prev, efforts: { ...prev.efforts, [model]: list } }))
+      })
+      .catch(() => {})
+  }
+}
+
+// 工具限制面板启用 → 拉 /options/tools（完整工具目录）。
+function makeToolsLoader(api, setTools) {
+  return () => {
+    api('/options/tools')
+      .then((data) => setTools(Array.isArray(data.tools) ? data.tools : []))
+      .catch(() => {})
+  }
+}
+
+// 版本探测 → 拉 /options/versions；warnings 非空时设置页顶部常驻 amber 提示条。
+function makeVersionsLoader(api, setVersionWarnings) {
+  return () => {
+    api('/options/versions')
+      .then((data) => setVersionWarnings(Array.isArray(data.warnings) ? data.warnings : []))
+      .catch(() => {})
+  }
+}
+
+function makeProfilesActions(api, s, refresh, applyWrite, loadEfforts, loadTools) {
   return {
-    ...makeFormActions(s),
-    ...makeEditActions(s),
+    ...makeFormActions(s, loadEfforts, loadTools),
+    ...makeEditActions(s, loadEfforts, loadTools),
     ...makeSubmitActions(api, s, refresh, applyWrite),
     ...makeRowActions(api, s, refresh, applyWrite),
   }
@@ -700,11 +875,14 @@ function buildAddCard(el, s, actions, toolSection) {
     ),
     buildSelectField(el, s, actions.setField, '模型（子 agent 使用的模型）', 'model', s.options.models,
       (m) => el('option', { key: m.id, value: m.id }, m.name && m.name !== m.id ? `${m.name}（${m.providerName || m.provider}）` : m.id)),
+    s.options.models.length === 0 ? el('p', { className: 'sap-metaValueDefault', style: { margin: '0' } }, '未检测到模型目录（headless 部署）——派发成本护栏将按「兼容模式」开关决定放行或拒绝') : null,
     el('details', { className: 'sap-customized' },
       el('summary', { className: 'sap-customizedSummary' }, '高级选项'),
       el('div', { className: 'sap-customizedBody' },
+        el('p', { className: 'sap-metaValueDefault', style: { margin: '0' } }, 'continuable 模式忽略 preset 换用与推理强度（子 Agent 继承父预设），派发结果以「ignored」标注'),
         buildSelectField(el, s, actions.setField, '目标预设（切换子 agent 使用的 Agent 预设）', 'preset', s.options.presets,
           (p) => el('option', { key: p.id, value: p.id }, p.name && p.name !== p.id ? `${p.name}（${p.id}）` : p.id)),
+        s.options.presets.length === 0 ? el('p', { className: 'sap-metaValueDefault', style: { margin: '0' } }, '未检测到 system-trust 预设名册（rosterless）——目标预设下拉不可用') : null,
         buildSelectField(el, s, actions.setField, '提供方（模型服务商）', 'provider', providers,
           (p) => el('option', { key: p.id, value: p.id }, p.name && p.name !== p.id ? `${p.name}（${p.id}）` : p.id)),
         s.form.model === ''
@@ -734,6 +912,9 @@ function buildSectionReturn(el, s, actions, rows, addCard) {
         el('span', null, s.enabled ? '已启用' : '已禁用')
       )
     ),
+    s.versionWarnings.length > 0
+      ? el('div', { className: 'sap-versionWarn' }, s.versionWarnings.map((warning, index) => el('span', { key: index }, warning)))
+      : null,
     el('p', { className: 'sap-intro' }, '在此管理「派发子 Agent」工具可用的 profile。内置方案可编辑、可删除、可点下方按钮批量重置回默认；每个方案可单独启用/禁用。'),
     el('div', { className: 'sap-addActions', style: { margin: '4px 0' } },
       el('button', { type: 'button', className: 'sap-secondaryButton', style: { height: '28px', padding: '0 12px', fontSize: '12px', borderRadius: '14px' }, onClick: actions.resetAll }, '重置所有内置方案')
@@ -763,32 +944,38 @@ function makeProfilesSection(el, api, chip, useState, useEffect, useCallback) {
     const [persistWarning, setPersistWarning] = useState('')
     const [form, setForm] = useState(EMPTY_FORM)
     const [tools, setTools] = useState([])
-    const s = { profiles, options, enabled, adding, editingId, error, savedNotice, persistWarning, form, tools,
-      setProfiles, setOptions, setEnabled, setAdding, setEditingId, setError, setSavedNotice, setPersistWarning, setForm, setTools }
+    const [versionWarnings, setVersionWarnings] = useState([])
+    const s = { profiles, options, enabled, adding, editingId, error, savedNotice, persistWarning, form, tools, versionWarnings,
+      setProfiles, setOptions, setEnabled, setAdding, setEditingId, setError, setSavedNotice, setPersistWarning, setForm, setTools, setVersionWarnings }
     const refresh = useCallback(() => {
       api('/list')
         .then((data) => setProfiles(Array.isArray(data.profiles) ? data.profiles : []))
         .catch((err) => setError(String((err && err.message) || err)))
     }, [])
     const loadOptions = useCallback(() => {
-      api('/options')
+      api('/options/summary')
         .then((data) => {
           setEnabled(data.enabled !== false)
           setOptions({
             models: Array.isArray(data.models) ? data.models : [],
-            efforts: data.efforts && typeof data.efforts === 'object' ? data.efforts : {},
+            efforts: {},
             presets: Array.isArray(data.presets) ? data.presets : []
           })
-          setTools(Array.isArray(data.tools) ? data.tools : [])
         })
         .catch(() => {})
     }, [])
+    const loadEfforts = makeEffortsLoader(api, setOptions)
+    const loadTools = makeToolsLoader(api, setTools)
+    // 版本探测只挂载时拉一次：useCallback([]) 稳定引用，防 effect 依赖恒变
+    // 导致设置页打开期间无限重取（与 loadOptions 同款稳定化）。
+    const loadVersions = useCallback(() => makeVersionsLoader(api, setVersionWarnings)(), [])
     useEffect(() => {
       refresh()
       loadOptions()
-    }, [refresh, loadOptions])
+      loadVersions()
+    }, [refresh, loadOptions, loadVersions])
     const applyWrite = makeApplyWrite(s)
-    const actions = makeProfilesActions(api, s, refresh, applyWrite)
+    const actions = makeProfilesActions(api, s, refresh, applyWrite, loadEfforts, loadTools)
     const rows = buildProfileRows(el, chip, s, actions)
     const toolSection = buildToolSection(el, s, actions)
     return buildSectionReturn(el, s, actions, rows, buildAddCard(el, s, actions, toolSection))
@@ -809,7 +996,7 @@ window.__ModuleLoader__.load({
     const inject = ['slots']
 
     const chip = makeChip(el)
-    const DispatchToolview = makeDispatchToolview(el, chip)
+    const DispatchToolview = makeDispatchToolview(el, chip, useState)
     const ProfilesSection = makeProfilesSection(el, api, chip, useState, useEffect, useCallback)
 
     function apply(ctx) {