dsh-subagent-profile 0.4.0 → 0.5.0

package/lib/core/http-routes.mjs

@@ -3,13 +3,13 @@
 // syncTool、catalog、logger；写路由各抽为模块级处理函数，工厂返回 scope.effect 设置函数。
 
 import { sanitizeProfile } from './pure.mjs';
-import { BUILTIN_SEEDS } from './profiles-store.mjs';
+import { BUILTIN_SEEDS, assertProfileDescription } from './profiles-store.mjs';
 import { detectVersions } from './shims.mjs';
 import { readSummaries } from './evolution-advice.mjs';
 import { profileStatsFromSummaries } from './profile-directory.mjs';
 import { costSummaryFromSummaries } from './cost-evidence.mjs';
 import { json, readBody, persistOk } from './http-helpers.mjs';
-import { handleEvolutionAssets, handleEvolutionApply, handleEvolutionRegenerate, handleAdviceSaveProfile, handleSettingsCandidate } from './evolution-routes.mjs';
+import { handleEvolutionAssets, handleEvolutionApply, handleEvolutionRollback, handleEvolutionRegenerate, handleAdviceSaveProfile, handleSettingsCandidate } from './evolution-routes.mjs';
 
 // 只有 loopback 接口可以驱动设置 HTTP 路由。
 const LOOPBACKS = new Set(['127.0.0.1', '::1', '::ffff:127.0.0.1']);
@@ -61,7 +61,9 @@ async function handleList(deps, res) {
       adviceDetails = result.adviceDetails !== null && typeof result.adviceDetails === 'object' ? result.adviceDetails : {};
     }
   } catch { /* 统计/建议是增量展示；失败不影响 /list 主响应 */ }
-  return json(res, 200, { ok: true, profiles: listClean(deps.store, stats), costSummary, advice, adviceGlobal, evolutionCandidates, adviceDetails });
+  // 冷启动状态（apply/防退化可用性 + 原因清单）：只读暴露，UI 展示归建议面板。
+  const evolutionStatus = typeof deps.evolution?.evolutionStatus === 'function' ? deps.evolution.evolutionStatus() : null;
+  return json(res, 200, { ok: true, profiles: listClean(deps.store, stats), costSummary, advice, adviceGlobal, evolutionCandidates, adviceDetails, evolutionStatus });
 }
 
 // 轻量摘要：enabled/advice 开关/模型目录/预设名册/审计分级。
@@ -247,6 +249,12 @@ async function handleAdd(deps, req, res) {
     const detail = warnings.map((w) => `${w.field}：${w.reason}`).join('；');
     return json(res, 400, { ok: false, error: `写入被拒绝：${detail}` });
   }
+  // description 落库契约（仅当请求显式携带 description 键：新建/编辑严格，未传
+  // 保留存量值不校验——存量宽容）。
+  if (Object.hasOwn(profile, 'description')) {
+    try { assertProfileDescription(profile.description); }
+    catch (error) { return json(res, 400, { ok: false, error: error instanceof Error ? error.message : String(error) }); }
+  }
   const hadToolFilter = profile.toolFilter !== undefined;
   // tokenTier 单独用 raw-body 守卫（sanitize 恒回填 balanced，进 merge 会破坏
   // 「未传→保留 existing」语义）；strict 下非法值已在上面 400 拒绝。
@@ -273,7 +281,7 @@ async function handleAdd(deps, req, res) {
   }
   if (hadTokenTier) merged.tokenTier = clean.tokenTier;
   if (merged.enabled !== undefined) merged.enabled = merged.enabled === false ? false : true;
-  deps.store.profiles.set(merged.id, { ...merged, ...(isBuiltin ? { builtin: true } : {}), persisted: true });
+  deps.store.saveProfile({ ...merged, ...(isBuiltin ? { builtin: true } : {}), persisted: true });
   deps.store.deletedBuiltins.delete(merged.id);
   return persistOk(res, { id: merged.id }, deps.store.persistProfiles());
 }
@@ -368,6 +376,7 @@ async function routeRequest(deps, req, res, url, sub) {
   if (req.method === 'POST' && sub === '/draft/preview') { const body = await readBody(req); return json(res, 200, { ok: true, ...(await deps.previewDraft(body)) }); }
   if (req.method === 'GET' && sub === '/evolution/assets') return handleEvolutionAssets(deps, res);
   if (req.method === 'POST' && sub === '/evolution/apply') return handleEvolutionApply(deps, req, res);
+  if (req.method === 'POST' && sub === '/evolution/rollback') return handleEvolutionRollback(deps, req, res);
   if (req.method === 'POST' && sub === '/evolution/regenerate') return handleEvolutionRegenerate(deps, req, res);
   if (req.method === 'POST' && sub === '/advice/save-profile') return handleAdviceSaveProfile(deps, req, res);
   if (req.method === 'POST' && sub === '/settings/candidate') return handleSettingsCandidate(deps, req, res);
@@ -404,7 +413,9 @@ export function createHttpRoutes({ webServer, store, getEnabled, setEnabled, syn
           return json(res, 403, { ok: false, error: `CSRF 防护拒绝：${violation.reason}` });
         }
       }
-      return routeRequest(deps, req, res, url, sub);
+      // 显式 await：async 路由的拒绝必须落入下方 catch（未 await 时 reject 会绕过
+      // catch 直接传播给 webServer，fail-loud 变成未捕获拒绝）。
+      return await routeRequest(deps, req, res, url, sub);
     } catch (error) {
       // 通用 500 不回显内部错误信息（防泄漏），详情只进宿主日志。
       deps.logger.error('[dsh-subagent-profile] settings route error:', error instanceof Error ? (error.stack ?? error.message) : String(error));

package/lib/core/model-policy.mjs

@@ -0,0 +1,77 @@
+// lib/core/model-policy.mjs — 官方子代理模型选择投影（subagentModelSelectionPolicy）
+// 的读取与生效路由断言。与官方工具链同源同 key（key 字符串照抄官方投影定义），
+// 无 @deepseek-ai 依赖，可被 bare-import 单测直接 import。
+//
+// 读取语义（与官方一致）：
+//   * sessionProjections 服务缺失 / stateOf 不可用 / 投影值 undefined 或 null
+//     （key 已注册但本会话未固化策略，官方视同未配置）→ { configured:false }，
+//     跳过、不抛错——插件行为与 0.4.0 完全一致。
+//   * 投影值为数组 → 形状校验（照官方 assertAllowedModelRoutes：数组、每项
+//     provider/model 为非空字符串、无重复路由、至少一条）→ 畸形 fail-loud，
+//     官方格式变更不得静默失效。
+//
+// 生效路由判定：判定输入是 per-call > profile > parent 解析链完成后的最终
+// provider/model（含继承带出的模型），与 allowedModels 精确成对匹配。
+
+const PROJECTION_SERVICE = 'sessionProjections';
+const POLICY_KEY = 'subagentModelSelectionPolicy';
+
+// 三层中文错误文案（定稿）：第一层说清越界事实与白名单，第二层说明与官方通道
+// 同策略，第三层给出行动路径。缺省侧（parent 未暴露路由）以 '(parent)' 占位。
+export function officialModelRejectMessage(provider, model, allowedModels) {
+  const shown = (value) => (typeof value === 'string' && value.length > 0 ? value : '(parent)');
+  const allowed = allowedModels.map((route) => `${route.provider}/${route.model}`).join('、');
+  return [
+    `dispatch: 模型 ${shown(provider)}/${shown(model)} 不在本会话允许的子代理模型白名单内（允许：${allowed}）。`,
+    '官方在其工具链执行同一策略，本插件同步执行，以保证两通道一致。',
+    '请改用允许的模型/方案，或在官方设置更新模型选择（本会话策略已固定，新会话生效）。',
+  ].join('\n');
+}
+
+// 形状校验：照官方 assertAllowedModelRoutes 语义（非空 provider/model 字符串、
+// 无重复路由），另按官方 stateSchema 的 min(1) 拒绝空数组。畸形即 fail-loud。
+function validateRoutes(routes) {
+  if (!Array.isArray(routes) || routes.length === 0) {
+    throw new Error('dispatch: 官方子代理模型选择投影形状不符（须为非空路由数组）');
+  }
+  const seen = new Set();
+  for (const candidate of routes) {
+    if (
+      candidate === null || typeof candidate !== 'object' || Array.isArray(candidate)
+      || typeof candidate.provider !== 'string' || candidate.provider.length === 0
+      || typeof candidate.model !== 'string' || candidate.model.length === 0
+    ) {
+      throw new Error('dispatch: 官方子代理模型选择投影形状不符（每项须为 provider/model 非空字符串）');
+    }
+    const key = `${candidate.provider}\0${candidate.model}`;
+    if (seen.has(key)) {
+      throw new Error(`dispatch: 官方子代理模型选择投影形状不符（路由 "${candidate.provider}/${candidate.model}" 重复）`);
+    }
+    seen.add(key);
+  }
+}
+
+// 读取官方模型选择投影。任何读取失败路径（ctx / 服务 / stateOf 缺失）与未固化
+// 状态（undefined / null）统一回退 { configured:false }（跳过语义）；投影存在则
+// 校验形状后返回路由表副本（返回值不得被调用方改写共享）。
+export function readModelSelectionPolicy(ctx, session) {
+  const projections = typeof ctx?.get === 'function' ? ctx.get(PROJECTION_SERVICE) : undefined;
+  const raw = projections !== null && typeof projections?.stateOf === 'function'
+    ? projections.stateOf(session, POLICY_KEY)
+    : undefined;
+  if (raw === undefined || raw === null) return { configured: false, enabled: false, allowedModels: [] };
+  validateRoutes(raw);
+  return {
+    configured: true,
+    enabled: true,
+    allowedModels: raw.map((route) => ({ provider: route.provider, model: route.model })),
+  };
+}
+
+// 生效路由断言：policy 未配置恒通过；否则 provider/model 与 allowedModels 精确
+// 成对匹配，不匹配 throw 三层中文错误（留痕与审计由调用方闸层负责）。
+export function assertOfficialModelRoute(policy, provider, model) {
+  if (policy === undefined || policy.configured !== true) return;
+  const allowed = policy.allowedModels.some((route) => route.provider === provider && route.model === model);
+  if (!allowed) throw new Error(officialModelRejectMessage(provider, model, policy.allowedModels));
+}

package/lib/core/presets-sync.mjs

@@ -2,7 +2,7 @@
 // 仅 node 内置，无 @deepseek-ai 依赖）。
 //
 // 宿主启动时插件把 bundled `presets/` 树同步进 DSH agent-presets 发现根
-// （~/.dsh/.agent-presets），使「编排者模式」无需手动复制就出现在新建会话
+// （~/.dsh/.agent-presets），使「编排者模式 V2」无需手动复制就出现在新建会话
 // 选择器里——与官方 dsh-liangshen bundle 相同的自安装模式。同步按目录、
 // 经哈希门控：per-target sidecar（.dsh-sync.json）记录 bundled 内容哈希与派生树
 // 快照哈希，下次运行跳过未变化的树、跳过（绝不覆盖）用户改过的树；两侧都变时
@@ -230,9 +230,26 @@ export function syncOnePreset(sourceDir, targetDir) {
   return 'synced';
 }
 
+// 旧预设收编归档（V2 取代）：bundled 已不再提供 `orchestrator`（由
+// `orchestrator-v2` 收编取代），发现根里若残留旧目录（旧版本自装、用户手工创建
+// 或恢复的），同步时改名归档为 orchestrator.removed-<stamp>——与卸载清理同一样式：
+// 只改名不删除（用户数据保留），幂等（归档后旧名即不存在，下次同步无操作）、
+// fail-soft（改名失败不抛不阻断，下次启动重试）。归档名含点号，不满足官方
+// PRESET_ID（^[a-z0-9][a-z0-9-]*$），不会出现在预设选择器。
+function archiveLegacyOrchestrator(targetRoot) {
+  const legacy = join(targetRoot, 'orchestrator');
+  if (!existsSync(legacy)) return false;
+  try {
+    renameSync(legacy, join(targetRoot, `orchestrator.removed-${Date.now()}`));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // 把 `presets/` 下每个 preset 目录同步进目标发现根。
 export function syncBundledPresets(targetRoot) {
-  const result = { synced: [], current: [], userModified: [], failed: [] };
+  const result = { synced: [], current: [], userModified: [], failed: [], archived: [] };
   const sourceRoot = bundledPresetsRoot();
   mkdirSync(targetRoot, { recursive: true });
   if (existsSync(sourceRoot)) {
@@ -250,5 +267,10 @@ export function syncBundledPresets(targetRoot) {
       }
     }
   }
+  // 旧名收编归档：仅当 bundled 侧确无 orchestrator 目录时处理（防御：未来若仓库
+  // 回补同名 bundled，以 bundled 为准、不误归档其派生树）。
+  if (!existsSync(join(sourceRoot, 'orchestrator')) && archiveLegacyOrchestrator(targetRoot)) {
+    result.archived.push('orchestrator');
+  }
   return result;
 }

package/lib/core/profile-directory.mjs

@@ -125,6 +125,23 @@ export function profileStatsFromSummaries(store, summaries) {
   return out;
 }
 
+// dispatch:profiles section 文本（模型可见的轻量目录，瘦身）：行格式
+// `- id: "描述" (tier: X)`——成本/成功率等统计只进 profiles_query 与人类面板，不进
+// 静态段。description 为空显示 (无描述)（存量宽容渲染）；note 一行查表式并指向
+// profiles_query 下钻。gate 由调用方（index.mjs 的 profileSectionGate）传入。
+export function profileSectionText(store, gate, context) {
+  if (!gate(context)) return '';
+  const rows = profileDirectoryRows(store);
+  if (rows.length === 0) return '';
+  const lines = rows.map((p) => {
+    const desc = typeof p.description === 'string' && p.description.length > 0 ? `"${p.description}"` : '(无描述)';
+    const tier = typeof p.tokenTier === 'string' && p.tokenTier !== '' ? ` (tier: ${p.tokenTier})` : '';
+    return `- ${p.id}: ${desc}${tier}`;
+  });
+  const note = '按任务复杂度匹配方案能力（查资料/汇总→cheap 或 flash；写/改代码→swap-standard；深度推理→premium；1-2 步可自查的小事直接做别派；可用方案与明细用 profiles_query 查询）';
+  return `Available dispatch profiles (dispatch.profile):\n${lines.join('\n')}\n${note}`;
+}
+
 // 用 stats map 为目录行补 avgCost/successRate（F 数据层 join）。stats 为
 // profileStatsFromSummaries 的返回值；行上已有 avgCost/successRate 时优先保留
 // 显式值（store 侧/测试注入），stats 只补缺失。

package/lib/core/profile-provider.mjs

@@ -31,6 +31,7 @@ import { resolveWhitelist } from './whitelist.mjs';
 import { assertCostGuard } from './cost-guard.mjs';
 import { DELEGATION_CONTEXT, buildDispatchMeta } from './delegation.mjs';
 import { readSessionEvents } from './session-read.mjs';
+import { applyOfficialModelProviderGate } from './dispatch-gates.mjs';
 
 // --- start 预检段（从 start 拆出）-------------------------------------------------
 
@@ -64,6 +65,9 @@ async function runStartPreflight(request, deps) {
   // 权威 cost guard（运行时推导；硬上限始终生效，llm 能力核验由 allowFailOpen 门控；
   // llm 目录读取走共享 catalog 快照）。
   await assertCostGuard(parent, profile, deps.store.getAllowFailOpen(), deps.logger, deps.catalog);
+  // 官方模型选择投影读取（服务/投影缺失或未固化 → configured:false 跳过）；生效
+  // 路由判定在 agentOptions 解析完成后——provider 渠道与 dispatch 预检同一白名单。
+  const policy = deps.readModelSelectionPolicy?.(parent.ctx, parent.session);
   // 委派深度：官方助手——先断言上限值，再解析子深度（父底 + 1）并执行上限。
   assertSubagentMaxDepth(profile.maxDepth);
   const childDepth = resolveChildDepth(parent, profile.maxDepth);
@@ -73,6 +77,7 @@ async function runStartPreflight(request, deps) {
   const swapPreset = typeof profile.preset === 'string' && profile.preset !== 'inherit' && profile.preset !== parentComposed;
   const meta = buildProviderMeta(parent, profile, swapPreset, childDepth);
   const agentOptions = buildProviderAgentOptions(parent, profile, childDepth);
+  applyOfficialModelProviderGate({ evoLedger: deps.evoLedger, sessionId: parent.session?.header?.id }, policy, agentOptions);
   return { parent, profile, delegated, childId, swapPreset, meta, agentOptions };
 }
 
@@ -234,8 +239,8 @@ function wireChildLifecycle(handle, request, childId, swapPreset, profile, logge
   };
 }
 
-export function createProfileProvider({ subagents, store, getEnabled, logger, catalog, getEscapeSet }) {
-  const deps = { store, getEnabled, logger, catalog, getEscapeSet };
+export function createProfileProvider({ subagents, store, getEnabled, logger, catalog, getEscapeSet, readModelSelectionPolicy, evoLedger }) {
+  const deps = { store, getEnabled, logger, catalog, getEscapeSet, readModelSelectionPolicy, evoLedger };
   return subagents.registerProvider({
     name: 'profile',
     capabilities: { outputSchema: false, depthLimit: true, toolFilter: true, persona: true },

package/lib/core/profiles-query.mjs

@@ -0,0 +1,178 @@
+// lib/core/profiles-query.mjs — profiles_query 工具（派发档案按需下钻）：入参全可选
+// （id / tier / provider+model 成对 / 无参全量），未知键由宿主 DSL 默认拒绝（键集闭合
+// 断言在 test/profiles-query.test.mjs）。数据源分布：profileDirectoryRows（档案）/
+// catalog-cache 快照（官方模型 + efforts，TTL 60s）/ summaries.json（统计，
+// mtime+指纹，fail-soft）。官方目录没有的 model 只标「未在册」（advisory，不判失效）；
+// 「未授权」联动官方模型选择投影（model-policy）：本会话投影配置了 allowedModels 且档案绑定路由不在
+// 其中时追加标注。本工具不复制任何策略逻辑——授权性以官方为准（工具描述首行已指向
+// list_subagent_models）。
+
+import { defineTool } from './shims.mjs';
+import { profileDirectoryRows, profileStatsFromSummaries } from './profile-directory.mjs';
+import { readModelSelectionPolicy } from './model-policy.mjs';
+import { readSummaries } from './evolution-advice.mjs';
+
+// 入参 schema：全可选；provider+model 成对约束在 execute 内校验（schema 层无法表达
+// 成对）。键集闭合 = 白名单 4 键（与 percall-spec 同口径：多出的键没有接受路径）。
+export const PROFILES_QUERY_PARAMETERS = {
+  id: { type: 'string', description: '按 id 查单个派发档案明细（其余入参被忽略）' },
+  tier: { type: 'string', enum: ['cheap', 'balanced', 'premium'], description: '按成本/深度档位过滤档案' },
+  provider: { type: 'string', description: '与 model 成对使用：先查该模型的官方 reasoning efforts，再列出绑定该模型的档案' },
+  model: { type: 'string', description: '与 provider 成对使用：官方模型目录中的模型 id' },
+};
+
+// 输出 schema：模型可见面只有 text 一行（render 把 text 包成内容块）。
+export const PROFILES_QUERY_OUTPUT_SCHEMA = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    text: { type: 'string', required: true, description: '模型可见的查询结果文本' },
+  },
+};
+
+// 列表行描述截断长度（单档案明细不截断）。
+const LIST_DESC_CHARS = 80;
+
+// 档案绑定的 provider/model 路由（两者齐备才绑定）；未绑定返回 null。
+export function boundRouteOf(row) {
+  const provider = row !== null && typeof row === 'object' && typeof row.provider === 'string' && row.provider !== '' ? row.provider : undefined;
+  const model = row !== null && typeof row === 'object' && typeof row.model === 'string' && row.model !== '' ? row.model : undefined;
+  return provider !== undefined && model !== undefined ? { provider, model } : null;
+}
+
+// 官方状态标注：在册（catalog models 含 provider+model）/ 未在册 / 未绑定。未在册只
+// 标不判失效（advisory）。
+export function catalogStatusOf(row, models) {
+  const route = boundRouteOf(row);
+  if (route === null) return '未绑定';
+  const listed = Array.isArray(models) && models.some((m) => m !== null && typeof m === 'object' && m.provider === route.provider && m.id === route.model);
+  return listed ? '在册' : '未在册';
+}
+
+// 未授权标注：投影配置且绑定路由不在 allowedModels → '未授权'；投影未配置或未绑定
+// → undefined（不加注）。授权性判定只读官方投影，不复制策略逻辑。
+export function unauthorizedMarkOf(row, policy) {
+  const route = boundRouteOf(row);
+  if (route === null || policy === undefined || policy === null || policy.configured !== true) return undefined;
+  const allowed = Array.isArray(policy.allowedModels) && policy.allowedModels.some((r) => r !== null && typeof r === 'object' && r.provider === route.provider && r.model === route.model);
+  return allowed ? undefined : '未授权';
+}
+
+// efforts 条件式文案：绑定 → 该模型官方 reasoning efforts（目录无数据 → 占位）；
+// 未绑定 → 继承父模型、档位以父为准。
+export function effortsTextOf(row, effortsByModel) {
+  const route = boundRouteOf(row);
+  if (route === null) return '继承父模型，档位以父为准';
+  const efforts = effortsByModel !== null && typeof effortsByModel === 'object' ? effortsByModel[route.model] : undefined;
+  if (!Array.isArray(efforts) || efforts.length === 0) return '（目录无该模型明细）';
+  return efforts.map((effort) => (effort !== null && typeof effort === 'object' && typeof effort.id === 'string' ? effort.id : String(effort))).join('/');
+}
+
+// 单档案明细（两行：主行 + efforts 行）。stats 为 profileStatsFromSummaries 的
+// Map；truncate=true 时描述截断 80 字符 + …（列表口径，单档案明细不截断）。
+export function profileDetailLines(row, { stats, models, effortsByModel, policy, truncate = false } = {}) {
+  const desc = row !== null && typeof row === 'object' && typeof row.description === 'string' && row.description !== '' ? row.description : '(无描述)';
+  const shown = truncate && desc.length > LIST_DESC_CHARS ? `${desc.slice(0, LIST_DESC_CHARS)}…` : desc;
+  const route = boundRouteOf(row);
+  const binding = route === null ? '继承父' : `${route.provider}/${route.model}`;
+  const tier = row !== null && typeof row === 'object' && typeof row.tokenTier === 'string' && row.tokenTier !== '' ? row.tokenTier : '未标注';
+  const stat = stats instanceof Map ? stats.get(row?.id) : (stats !== null && typeof stats === 'object' ? stats[row?.id] : undefined);
+  const cost = stat !== null && typeof stat === 'object' && typeof stat.avgCost === 'number' ? `平均 ¥${stat.avgCost}` : undefined;
+  const rate = stat !== null && typeof stat === 'object' && typeof stat.successRate === 'number'
+    ? `成功率 ${stat.successRate}${typeof stat.n === 'number' ? ` (N=${stat.n})` : ''}`
+    : undefined;
+  const status = catalogStatusOf(row, models);
+  const unauthorized = unauthorizedMarkOf(row, policy);
+  const meta = [binding, `tier ${tier}`, cost, rate, `官方状态:${status}${unauthorized !== undefined ? `·${unauthorized}` : ''}`].filter((part) => part !== undefined).join(' · ');
+  return [`${row?.id}: ${shown} — ${meta}`, `· efforts: ${effortsTextOf(row, effortsByModel)}`];
+}
+
+// 单次查询组装（纯函数）：id 单档案 > tier 过滤 > provider+model 成对 > 无参全量。
+// provider/model 只传其一 → fail-loud（成对约束）。
+export function buildProfilesQueryText({ args, rows, stats, models, effortsByModel, policy }) {
+  const hasProvider = typeof args?.provider === 'string' && args.provider !== '';
+  const hasModel = typeof args?.model === 'string' && args.model !== '';
+  if (hasProvider !== hasModel) throw new Error('profiles_query: provider 与 model 须成对提供');
+  const details = (row, truncate = false) => profileDetailLines(row, { stats, models, effortsByModel, policy, truncate });
+  if (typeof args?.id === 'string' && args.id !== '') {
+    const row = rows.find((r) => r !== null && typeof r === 'object' && r.id === args.id);
+    if (row === undefined) return { text: `未找到 profile "${args.id}"。可用 id：${rows.map((r) => r?.id).join('、') || '（暂无）'}` };
+    return { text: details(row).join('\n') };
+  }
+  if (typeof args?.tier === 'string' && args.tier !== '') {
+    const tierRows = rows.filter((r) => r !== null && typeof r === 'object' && r.tokenTier === args.tier);
+    if (tierRows.length === 0) return { text: `无 tier=${args.tier} 的方案` };
+    const lines = tierRows.flatMap((row) => details(row, true));
+    return { text: `tier=${args.tier} 的方案（${tierRows.length}）：\n${lines.join('\n')}` };
+  }
+  if (hasModel) {
+    const listed = Array.isArray(models) && models.some((m) => m !== null && typeof m === 'object' && m.provider === args.provider && m.id === args.model);
+    const rawEfforts = effortsByModel !== null && typeof effortsByModel === 'object' ? effortsByModel[args.model] : undefined;
+    const modelEfforts = Array.isArray(rawEfforts) && rawEfforts.length > 0
+      ? rawEfforts.map((effort) => (effort !== null && typeof effort === 'object' && typeof effort.id === 'string' ? effort.id : String(effort))).join('/')
+      : undefined;
+    const header = `模型 ${args.provider}/${args.model} 官方 reasoning efforts：${modelEfforts ?? '（目录无该模型明细）'}`;
+    const bound = rows.filter((r) => {
+      const route = boundRouteOf(r);
+      return route !== null && route.provider === args.provider && route.model === args.model;
+    });
+    if (bound.length === 0) return { text: `${header}\n无绑定该模型的方案${listed ? '' : '（该模型不在官方目录，未在册）'}` };
+    const lines = bound.flatMap((row) => details(row, true));
+    return { text: `${header}\n${lines.join('\n')}` };
+  }
+  if (rows.length === 0) return { text: '暂无可用派发档案（可在设置页「子 Agent 方案」创建）' };
+  const lines = rows.flatMap((row) => details(row, true));
+  return { text: `派发档案目录（${rows.length}）：\n${lines.join('\n')}` };
+}
+
+// 查询主体：catalog 快照（含官方 efforts）→ summaries 统计（fail-soft）→ 官方
+// 模型选择投影（未授权标注）→ 纯函数组装文本。
+async function runProfilesQuery(args, exec, deps) {
+  const agent = exec !== null && typeof exec === 'object' ? exec.agent : undefined;
+  const snapshot = await deps.catalog.getSnapshot(typeof agent?.ctx?.get === 'function' ? agent.ctx.get('llm') : undefined);
+  const models = snapshot !== null && typeof snapshot === 'object' && Array.isArray(snapshot.models) ? snapshot.models : [];
+  const effortsByModel = snapshot !== null && typeof snapshot === 'object' && snapshot.efforts !== null && typeof snapshot.efforts === 'object' ? snapshot.efforts : {};
+  let summaries = null;
+  try { summaries = readSummaries(deps.summariesFile, deps.logger, { onLoss: deps.onLoss }); } catch { /* 统计只增强，查询不因统计失败而失败 */ }
+  const stats = profileStatsFromSummaries(deps.store, summaries);
+  const policy = readModelSelectionPolicy(agent?.ctx, agent?.session);
+  return buildProfilesQueryText({ args, rows: profileDirectoryRows(deps.store), stats, models, effortsByModel, policy });
+}
+
+// 工厂返回 { syncTool, dispose }：与 dispatch 同款 syncTool 机制（随 enabled 开关
+// 注册/注销，工具列表自动可见，不依赖静态段）。
+export function createProfilesQueryTool({ register, store, catalog, summariesFile, onLoss, logger, getEnabled }) {
+  const deps = { store, catalog, summariesFile, onLoss, logger, getEnabled };
+  const tool = defineTool({
+    name: 'profiles_query',
+    description: '按方案查询派发档案与明细（值不值：描述/档位/统计）；授权路由（能不能用）请用官方 list_subagent_models。入参全可选：id 查单个档案；tier 按档位过滤；provider+model 成对查询（先查官方 efforts 再列绑定方案）；无参返回全量目录。',
+    parameters: PROFILES_QUERY_PARAMETERS,
+    output: {
+      schema: PROFILES_QUERY_OUTPUT_SCHEMA,
+      render: (_args, value) => [{ type: 'text', text: value.text }],
+    },
+    isConcurrencySafe: () => true,
+    execute: (args, exec) => runProfilesQuery(args, exec, deps),
+  });
+  let disposeTool;
+  function syncTool() {
+    if (getEnabled() && disposeTool === undefined) {
+      disposeTool = register(tool);
+    } else if (!getEnabled() && disposeTool !== undefined) {
+      const dispose = disposeTool;
+      disposeTool = undefined;
+      if (typeof dispose === 'function') dispose();
+    }
+  }
+  syncTool();
+  return {
+    syncTool,
+    dispose() {
+      if (disposeTool !== undefined) {
+        const dispose = disposeTool;
+        disposeTool = undefined;
+        if (typeof dispose === 'function') dispose();
+      }
+    }
+  };
+}

package/lib/core/profiles-store.mjs

@@ -34,15 +34,30 @@ export function dshHome() {
 // 1. Profile 注册表（per-instance 状态；bundle 行是进程级，故本 Map 是单例
 //    store，与动态插件完全一致）。内置种子带 `builtin: true`，reset/remove 可
 //    识别它们，改过的内置方案与纯用户 profile 可区分。
-//    description 是语义化的：一行定位 + 何时用，帮助模型选择。reasoningEffort
+//    description 是语义化的：一行定位 + 何时用，帮助模型选择；description
+//    须含适用场景词（落库契约，见 assertProfileDescription）。reasoningEffort
 //    档位经 llm-deepseek adapter 核验（off/high/max；见 resolveModel 对
 //    connection.defaults.thinking 的门控——本部署未设 thinking，
 //    故对 deepseek-v4-flash 全档位宣传）。
 export const BUILTIN_SEEDS = [
-  { id: 'swap-standard', name: '标准编码', description: '切换到 standard 预设的完整编码工具集。当父会话不是 standard、但子任务需要完整编码能力时用。', preset: 'standard', tokenTier: 'balanced', builtin: true },
-  { id: 'researcher', name: '调研检索', description: '关闭深度推理省 token，继承父工具。适合查资料、汇总、背景调研，不适合改代码。', reasoningEffort: 'off', persona: 'You are a research subagent: search, read, and summarize only. Do not modify code or files.', tokenTier: 'cheap', builtin: true }
+  { id: 'swap-standard', name: '标准编码', description: '写代码与重构场景：切换到 standard 预设的完整编码工具集，适合多文件改动、修复与测试；当父会话不是 standard、但子任务需要完整编码能力时选用。', preset: 'standard', tokenTier: 'balanced', builtin: true },
+  { id: 'researcher', name: '调研检索', description: '调研与汇总场景：关闭深度推理省 token，继承父工具；适合查资料、检索、背景调研与只读分析，不适合改代码。', reasoningEffort: 'off', persona: 'You are a research subagent: search, read, and summarize only. Do not modify code or files.', tokenTier: 'cheap', builtin: true }
 ];
 
+// description 落库契约词表：description 必须包含至少一个适用场景词（常量，可微调）。
+export const DESCRIPTION_SCENARIO_WORDS = ['查', '调研', '检索', '汇总', '代码', '重构', '修复', '审查', '只读', '审计', '生成', '测试', '翻译', '编写', '改', '脚本', '分析'];
+
+// description 落库校验（纯函数，zero-dep）：非空（trim）+ 长度 ≥10 字符 + 含适用
+// 场景词，任一不满足 fail-loud（文案定稿）。返回 trim 后的文本供调用方落库。
+export function assertProfileDescription(description) {
+  const text = typeof description === 'string' ? description.trim() : '';
+  const valid = text.length >= 10 && DESCRIPTION_SCENARIO_WORDS.some((word) => text.includes(word));
+  if (!valid) {
+    throw new Error('description 需写明适用场景（如：查资料/周报汇总、多文件重构、只读审计），当前描述不含可用场景词');
+  }
+  return text;
+}
+
 // --- 模块级 store 函数（从工厂拆出；per-apply 状态经 `state` 注入）---------------
 
 function resolveProfile(profiles, id) {
@@ -223,6 +238,20 @@ function persistState(state, patch, onGovernanceFailure) {
   }
 }
 
+// 落库保存路径：description 值发生变化（新建或编辑改写）必须过契约校验；
+// 与原值相同（存量未动）或未携带 description 时跳过——存量宽容不迁移。
+// 校验失败 fail-loud，不落 Map。
+function saveProfile(state, profile) {
+  if (profile !== null && typeof profile === 'object' && profile.description !== undefined) {
+    const existing = state.profiles.get(profile.id);
+    if (existing === undefined || existing.description !== profile.description) {
+      assertProfileDescription(profile.description);
+    }
+  }
+  state.profiles.set(profile.id, profile);
+  return profile;
+}
+
 // 构造一个 store 实例。`dshHome` 是已解析的主目录字符串（来自导出的
 // dshHome()）；`logger` 是 apply 时的 ctx.logger。`onGovernanceFailure`（可选）
 // 是任何 profile/state 持久化写失败时触发的审计钩子——一次治理审计丢失事件。
@@ -244,6 +273,7 @@ export function createProfileStore({ dshHome, logger, onGovernanceFailure = () =
     profiles,
     deletedBuiltins,
     resolveProfile: (id) => resolveProfile(profiles, id),
+    saveProfile: (profile) => saveProfile(state, profile),
     loadProfiles: () => loadProfiles(state, logger),
     persistProfiles: () => {
       const result = persistProfiles(state, logger);

package/lib/core/pure.mjs

@@ -369,7 +369,7 @@ export function sanitizeProfile(profile, options = {}) {
       case 'name':
       case 'description':
         // id/preset 与 name/description 同走文本采样：压平换行，阻断经 \n 注入
-        // orchestrator systemPrompt 的提示注入面（H1）。id/preset 此前走 default
+        // orchestrator-v2 systemPrompt 的提示注入面（H1）。id/preset 此前走 default
         // 分支原样拷贝，可注入换行破坏 dispatch:profiles 行。
         sanitizeTextField(key, value, clean, warnings);
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-subagent-profile",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "DeepSeek Harness 子 Agent 派发插件：按任务为子代理选模型、推理强度与工具范围，常用组合存成命名方案随时复用；内置安全检查、成本估算与节省分析、完整决策台账。",
   "repository": {
     "type": "git",
@@ -79,4 +79,4 @@
     "profiles"
   ],
   "license": "MIT"
-}
+}

package/presets/orchestrator-v2/NOTICE

@@ -0,0 +1,7 @@
+agent.cordis.yml 改编自 DeepSeek Harness 内置 Minimal 与 Standard preset（MIT）。
+tool-bootstrap.mjs 来自 https://github.com/xiaobright/dsh-anchored-standard（MIT），
+并包含 dsh-liangshen 的两阶段隔离扩展。
+custom-bash.mjs 移植自同一上游（xiaobright/dsh-anchored-standard，MIT）的
+combo-anchored/custom-bash.mjs，用于 win32 上以跨平台子进程通道提供同名
+`bash` 工具（Git Bash）。
+原始 DeepSeek 版权和 MIT 许可声明见开源仓库。