dsh-subagent-profile 0.4.0 → 0.5.1

package/lib/core/dispatch-tool.mjs

@@ -1,29 +1,20 @@
 // lib/core/dispatch-tool.mjs — `dispatch` 工具（defineTool schema + execute）、
 // 结果 schema 一致性锁与 syncTool 注册/注销逻辑，从 index.mjs 逐字拆出。
-// 仅引用 lib + shims；无 @deepseek-ai 依赖（shims 是唯一入口）。
-//
-// 注入：所有 apply 闭包 / ctx 依赖都是显式参数——
-//   register    ctx.tools.register（工具由 syncTool 注册/注销，设置开关可运行时移除），
-//   store       profile store（resolveProfile 取基方案、getAllowFailOpen 供 cost guard），
-//   getEnabled  读取 apply 闭包 `enabled` 标志（continuable fail-loud 门 + syncTool 注册条件），
-//   getService  请求时服务 getter（ctx.get('toolResultPruner') / ctx.get('jobs')
-//               按次读取，绝不在 apply 时读），
-//   logger      ctx.logger（决策级派发日志 + continuable 告警），
-//   subagents   ctx.subagents（start / startContinuable 驱动子 Agent），
-//   guard       dispatch guard（execute 入口 acquire / 结算 release+记账 / syncTool 禁用时 cancelAll+reset）。
-// 工厂返回 { syncTool, dispose }：syncTool 交给 HTTP 路由（/set-enabled），dispose 在插件卸载时运行。
-//
-// execute 按预检段 + 三分支拆为模块级私有函数；parameters/output schema 拆至 dispatch-schema.mjs，预检闸拆至 dispatch-gates.mjs（守文件行门），零漂移。
+// 仅引用 lib + shims；无 @deepseek-ai 依赖（shims 是唯一入口）。注入全是显式参数
+// （register/store/getEnabled/getService/logger/subagents/guard/catalog/ledger/
+// evoLedger/backgroundLedger/adoptionTracker/getEscapeSet/getEvolutionAdvice）。
+// 工厂返回 { syncTool, dispose }；execute 按预检段 + 三分支拆为模块级私有函数，
+// parameters/output schema 拆至 dispatch-schema.mjs，预检闸拆至 dispatch-gates.mjs。
 
 import { defineTool } from './shims.mjs';
 import { textFrom, stopReasonError, withPartialText, pruneBlocks, assertResultSchemaConsistency, trustLabel, trustAudit, dispatchLabel } from './pure.mjs';
 import { resolveWhitelist } from './whitelist.mjs';
 import { recordEscapeAllow } from './escape.mjs';
-import { settleStart, collectChildUsage, collectChildCalls } from './delegation.mjs';
-import { DISPATCH_OUTPUT_SCHEMA, DISPATCH_PARAMETERS, DISPATCH_RENDER } from './dispatch-schema.mjs';
+import { settleStart, collectChildUsage, collectChildCalls, measureChildTokens } from './delegation.mjs';
+import { DISPATCH_OUTPUT_SCHEMA, DISPATCH_PARAMETERS, DISPATCH_RENDER, imageTextOf, normalizeReasoningEffort } from './dispatch-schema.mjs';
 import { createDecisionTrace, finalizeTrace, assertTraceSize, parentContextOf, requestedOf, effectiveMeta, recordApprovalGate, recordFailure, profileSnapshotOf } from './decision-trace.mjs';
 import { profileDirectoryRows } from './profile-directory.mjs';
-import { applyWhitelistGate, applyCostGuardGate, applyIntersectionGate, assertContinuableEnabled, readParentToolNames, applyBudgetGate } from './dispatch-gates.mjs';
+import { applyWhitelistGate, applyCostGuardGate, applyIntersectionGate, assertContinuableEnabled, readParentToolNames, applyBudgetGate, runOfficialModelPreflight } from './dispatch-gates.mjs';
 import { trackForegroundInflight, trackBackgroundInflight, trackContinuableInflight } from './dispatch-guard.mjs';
 import { finishForegroundLedger, finishBackgroundLedger, finishContinuableLedger } from './evolution-ledger.mjs';
 import { profileKeyOf } from './evolution-summary.mjs';
@@ -36,6 +27,7 @@ const ENVELOPE_SKELETON = '完成前按以下骨架输出：## 结论（1-2 句
 
 // 解析基方案（旁路），再叠加显式参数。
 function mergeProfileArgs(args, store) {
+  args = normalizeReasoningEffort(args); // 字段双名归一（merge 前）：官方名 reasoning_effort→reasoningEffort；同送两义 fail-loud。
   const base = args.profile !== undefined ? store.resolveProfile(args.profile) : {};
   const merged = { ...base };
   for (const key of ['preset', 'model', 'provider', 'reasoningEffort', 'persona', 'toolFilter', 'maxTokens', 'maxDepth', 'tokenTier']) {
@@ -154,6 +146,7 @@ async function runContinuable(args, merged, meta, parent, exec, deps, trace, eff
     model: meta.model,
     reasoningEffort: meta.reasoningEffort,
     tokenTier: meta.tokenTier,
+    imageText: imageTextOf(meta),
     ignored: ['preset', 'reasoningEffort']
   };
   finalizeTrace(trace, {
@@ -208,28 +201,12 @@ async function runBackground(args, merged, meta, request, parent, deps, pruneRes
   });
   trackBackgroundInflight(deps.guard, jobs, jobId, parent);
   deps.adoptionTracker?.register({ parentSessionId: parent.session?.header?.id, id: jobId, ledgerKey: profileKeyOf(base.effective), mode: 'background', dispatchedAt: t0, promptExcerpt: promptExcerptOf(args?.prompt), requestedModel: merged.model, parentModel: parent.options?.model }); // 后台结算经 job 结果携带，不入会话块。
-  const out = { kind: 'background', jobId, ...meta };
+  const out = { kind: 'background', jobId, ...meta, imageText: imageTextOf(meta) };
   finalizeTrace(trace, { effective: effectiveMeta(meta, []), execution: { kind: 'background', parentSessionId: parent.session?.header?.id, jobId, mode: 'one-shot' } });
   out.decisionTrace = assertTraceSize(trace);
   return out;
 }
 
-// childTotalTokens：宿主 tokenMeter 启发式估算（surface 口径，非计费 usage）；仅
-// completed 结算时测量，服务缺失/非函数/抛错均返回 undefined（fail-soft）。
-function measureChildTokens(getService, session) {
-  if (session === undefined || session === null) return undefined;
-  const meter = getService('tokenMeter');
-  if (meter === undefined || typeof meter.measure !== 'function') return undefined;
-  try {
-    const measured = meter.measure(session);
-    return measured !== null && typeof measured === 'object' && typeof measured.totalTokens === 'number'
-      ? measured.totalTokens
-      : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
 // 仅 completed 结算时测量一次（tokenMeter 估算 + usage 分解 + 调用明细），dispose
 // 前读子 session 保证事件流完整；全 fail-soft（缺失/抛错 → undefined）绝不阻断结算。
 function measureForegroundRun(deps, run) {
@@ -268,6 +245,7 @@ async function runForeground(meta, request, parent, deps, pruneResultOutput, t0,
   if (failure !== undefined) throw new Error(withPartialText(failure, result.output));
   const metaOut = {
     ...meta,
+    imageText: imageTextOf(meta),
     ...(childTotalTokens !== undefined ? { childTotalTokens } : {}),
     ...(childUsage !== undefined ? { childUsage } : {}),
     elapsedMs,
@@ -304,7 +282,7 @@ async function prepareTrace(args, parent, deps) {
   // enabled、cheap-first）——「模型当时看到哪些候选」是回答「为什么这么选」的记录面。
   const rows = profileDirectoryRows(deps.store);
   const snapshot = profileSnapshotOf(rows, { chosenId: args.profile });
-  const advicePresent = typeof deps.getEvolutionAdvice === 'function' && deps.getEvolutionAdvice() === true && parentComposed === 'orchestrator';
+  const advicePresent = false; // advice 模型侧下架，trace 门控恒 false（保留埋点键与面板数据源，勿恢复注入）。
   const trace = createDecisionTrace(
     parentContextOf({
       parentPreset: parentComposed,
@@ -334,14 +312,14 @@ async function runDispatch(args, exec, deps) {
   let guardHandle = { release: () => {} };
   try {
     const merged = mergeProfileArgs(args, deps.store);
-    // 信封模式 opt-in：三分支创建子 Agent 前，把信封骨架追加进子 persona（systemPrompt
-    // 影子段、模型可见），不触碰 descriptor；既有 persona 非空时以空行衔接追加。
+    // 信封模式 opt-in：把信封骨架追加进子 persona（systemPrompt 影子段、模型可见），不触碰 descriptor；既有 persona 非空时空行衔接。
     if (args.envelope === true) {
       const hasPersona = merged.persona !== undefined && merged.persona.trim() !== '';
       merged.persona = hasPersona ? `${merged.persona}\n\n${ENVELOPE_SKELETON}` : ENVELOPE_SKELETON;
     }
     assertContinuableEnabled(deps, args);
     applyWhitelistGate(trace, merged, whitelist, parentComposed, escapeSet, baseWhitelist);
+    runOfficialModelPreflight({ trace, evoLedger: deps.evoLedger, sessionId: parent.session?.header?.id }, parent, merged, args);
     // Cost guard（运行时推导；硬上限始终生效，llm 能力核验由 allowFailOpen 门控）。
     await applyCostGuardGate(trace, merged, parent, deps);
     // 交集闸（三分支统一闸序，见 dispatch-gates.mjs）；continuable 的 effectiveAllow
@@ -351,15 +329,16 @@ async function runDispatch(args, exec, deps) {
     const meta = buildMeta(args, merged, parent);
     const request = buildRequest(args, merged, parent, exec.signal);
     const adoptionBase = { promptExcerpt: promptExcerptOf(args?.prompt), requestedModel: merged.model, parentModel: parent.options?.model };
-    // 结果回收默认剪枝：在 textFrom 前复用宿主 toolResultPruner.pruneContent 预剪；
-    // pruner 缺失时 pruneBlocks 回退为不剪（剪枝是增强、非硬依赖）。
+    // 结果回收默认剪枝：textFrom 前复用宿主 toolResultPruner.pruneContent 预剪；pruner 缺失时 pruneBlocks 回退为不剪（增强、非硬依赖）。
     const pruneResultOutput = (blocks) => pruneBlocks(blocks, deps.getService('toolResultPruner'));
     logDispatchDecision(deps.logger, args, merged, parent);
     // 总预算守卫：前/后台在 execute 入口占并发额度（continuable 不占），结算处 release
     // + recordTokens。guardHandle 传入分支用于释放与父 sessionId 记账。
-    guardHandle = applyBudgetGate(deps, parent, args, trace);
+    guardHandle = applyBudgetGate(deps, parent, args, merged, trace);
     // 派发台账静态元数据（双栏 cfg/task 指纹），分支结算处补 child_id+outcome 写盘。
-    const base = deps.evoLedger.baseEntry({ parent, args, merged, mode });
+    const base = deps.evoLedger.baseEntry({ parent, args, merged, mode, effectiveModelSource: trace.requested.source });
+    // 配置快照（开关关恒跳过；失败绝不阻断派发）：记录完整 config 供「保存为方案」复现。
+    if (deps.snapshots !== undefined && typeof deps.snapshots.capture === 'function') { try { deps.snapshots.capture({ profileKey: profileKeyOf(base.effective), config: merged, mode }); } catch { /* fail-soft */ } }
     recordEscapeAllow(deps, parent, merged, trace);
     if (args.continuable === true) return await runContinuable(args, merged, meta, parent, exec, deps, trace, effectiveAllow, base);
     if (args.run_in_background === true) return await runBackground(args, merged, meta, request, parent, deps, pruneResultOutput, t0, trace, guardHandle, base, exec);
@@ -371,17 +350,22 @@ async function runDispatch(args, exec, deps) {
   }
 }
 
-export function createDispatchTool({ register, store, getEnabled, getService, logger, subagents, catalog, ledger, guard, evoLedger, backgroundLedger, adoptionTracker, getEscapeSet, getEvolutionAdvice }) {
-  const deps = { store, getEnabled, getService, logger, subagents, catalog, ledger, guard, evoLedger, backgroundLedger, adoptionTracker, getEscapeSet, getEvolutionAdvice };
+export function createDispatchTool({ register, store, getEnabled, getService, logger, subagents, catalog, ledger, guard, evoLedger, backgroundLedger, adoptionTracker, getEscapeSet, getEvolutionAdvice, snapshots }) {
+  const deps = { store, getEnabled, getService, logger, subagents, catalog, ledger, guard, evoLedger, backgroundLedger, adoptionTracker, getEscapeSet, getEvolutionAdvice, snapshots };
   const dispatchTool = defineTool({
     name: 'dispatch',
-    description: '派发子任务给派生子 Agent，可逐个覆盖其 preset、model、provider、推理档位、persona、工具白名单、token 预算或递归深度。优先使用已保存的 profile，仅少数字段需要临时覆盖时才传 per-call 参数；未指定 model 时子代理继承父模型，查资料/汇总/读文件等轻任务请优先考虑 cheap 方案或显式 model=flash。前台等待结果；run_in_background: true 启动后台任务（单轮即弃）；continuable: true 启动持久子 Agent，后续轮次经 send_message 工具延续对话。前瞻：continuable 模式忽略 preset 换用与 reasoningEffort（结果以 ignored 提示）。',
+    description: '派发子任务给派生子 Agent，可逐个覆盖其 preset、model、provider、推理档位、persona、工具白名单、token 预算或递归深度。优先使用已保存的 profile，仅少数字段需要临时覆盖时才传 per-call 参数；未指定 model 时子代理继承父模型，查资料/汇总/读文件等轻任务请优先考虑 cheap 方案或显式 model=flash。细粒度路由/授权发现请用官方 subagent 工具 + list_subagent_models（provider/model 成对、受本会话官方模型选择白名单）；dispatch 只管方案（profile）及方案内覆盖。前台等待结果；run_in_background: true 启动后台任务（单轮即弃）；continuable: true 启动持久子 Agent，后续轮次经 send_message 工具延续对话；失败经结算通知回报；超时可 send_message 追问。失败动作映射：stopReason=max-tokens→用 profiles_query 降档或 profile 加 maxTokens；error→换 profile/preset；refusal→重述任务；连续失败→告知用户。前瞻：continuable 模式忽略 preset 换用与 reasoningEffort（结果以 ignored 提示）。',
     parameters: DISPATCH_PARAMETERS,
     output: {
       schema: DISPATCH_OUTPUT_SCHEMA,
       render: DISPATCH_RENDER,
-      // 决策轨迹经 presentationMeta 投影进会话块 meta（客户端台账数据源），不进 render 行。
-      presentationMeta: (_args, value) => value.decisionTrace,
+      // 决策轨迹经 presentationMeta 投影进会话块 meta（客户端台账数据源），不进
+      // render 行；imageText（一句话生效画像）随轨迹一起投影，卡片可见、UI 留后续。
+      presentationMeta: (_args, value) => {
+        const trace = value.decisionTrace;
+        if (trace === undefined) return undefined;
+        return { ...trace, ...(typeof value.imageText === 'string' ? { imageText: value.imageText } : {}) };
+      },
     },
     isConcurrencySafe: () => true,
     execute: (args, exec) => runDispatch(args, exec, deps),

package/lib/core/evolution-advice.mjs

@@ -1,8 +1,10 @@
 // lib/core/evolution-advice.mjs — evolution:advice 派发优化建议链（从 evolution-summary.mjs
 // 拆出以守文件行门）：suggestAdvice（纯函数四条件 + 升/降轴硬规则）、readSummaries /
-// refreshSummaries / computeAdvice / buildAdviceText（生产聚合触发与注入文本）。
+// refreshSummaries / computeAdvice / renderAdviceText（人类面板数据源）。
 // 聚合本体（computeSummaries/writeSummaries）仍驻 evolution-summary.mjs；本模块只读
 // 台账并调度聚合，绝无写回台账路径。fail-soft 纪律与 evolution-summary 同源。
+// 本轮起模型侧注入已下架（index.mjs 的 evolution:advice section 恒空）：本链只为
+// 人类面板（建议卡/提醒中心/审计行）服务，不再生成模型可见文本。
 //
 // 依赖方向：本模块 → evolution-summary.mjs（单向，无环）。
 
@@ -18,7 +20,7 @@ import { loadWithMigration } from './evolution-persistence.mjs';
 //   （平）。阈值 successThreshold / confidenceMinLevel / cooldownMs 为建议初值，
 //   待实测后校准。
 const CONFIDENCE_RANK = { low: 0, medium: 1, high: 2 };
-// 置信度级别中文映射（注入文本人话化，与客户端 ZH.confidenceZh 同口径）。
+// 置信度级别中文映射（面板文本人话化，与客户端 ZH.confidenceZh 同口径）。
 const CONFIDENCE_ZH = { low: '低', medium: '中等', high: '高' };
 
 function hasCapabilityAxis(profileKey) {
@@ -53,7 +55,7 @@ function performanceText(entry) {
   const perf = entry?.perf ?? {};
   const parts = [
     `过去 ${entry?.deployments_total ?? 0} 次：完成 ${outcome.completed ?? 0}、失败 ${outcome.failed ?? 0}、终止 ${outcome.killed ?? 0}`,
-    `加权成功分 ${entry?.score?.weighted_success ?? 0}`,
+    `近期表现分 ${entry?.score?.weighted_success ?? 0}`,
   ];
   if (perf.avg_elapsed_ms !== null && perf.avg_elapsed_ms !== undefined) parts.push(`平均耗时 ${perf.avg_elapsed_ms}ms`);
   if (perf.avg_output_len !== null && perf.avg_output_len !== undefined) parts.push(`平均输出 ${perf.avg_output_len} 字符`);
@@ -117,7 +119,7 @@ function downReasonText(segments, entry) {
   if (segments.toolFilter) return '移除工具过滤后，子 Agent 的工具面回到父会话范围，配置更简单';
   if (segments.model) return '同类任务改用更低档模型，成本通常更低';
   if (segments.preset) return '相邻低档预设能力相近，成本通常更低';
-  return `近期表现低于预期（加权成功分 ${entry?.score?.weighted_success ?? 0}），降低能力配置是更稳妥的方向`;
+  return `近期表现低于预期（近期表现分 ${entry?.score?.weighted_success ?? 0}），降低能力配置是更稳妥的方向`;
 }
 
 function upReasonText(profileKey, l2) {
@@ -170,7 +172,7 @@ export function suggestAdvice({
   };
 }
 
-// --- 派发优化建议（evolution:advice 注入段，默认关）----------------------------
+// --- 派发优化建议（面板侧；模型侧注入下架，注入段恒空）-------------------
 
 // 读 summaries.json（存在才读）。版本化经通用持久化机制：v 低于当前版本时内存
 // 前向迁移后原子写回；损坏/形状不符/未知或超前版本 fail-soft 返回 null，并告警
@@ -213,7 +215,8 @@ function summariesStale(dispatchFile, summariesFile) {
   }
 }
 
-// 注入段文本：全局聚合摘要 + 各 profile 一条确定性建议（人类读、非指令）。
+// 面板侧文本：全局聚合摘要 + 各 profile 一条确定性建议（人类读、非指令；
+// 只供人类面板渲染，不再进模型侧注入段）。
 export function renderAdviceText(advice, global) {
   const direction = (value) => (value === '升' ? '可上调预算' : value === '降' ? '建议降级' : '维持现状');
   const lines = advice.map((a) => {
@@ -229,8 +232,9 @@ export function renderAdviceText(advice, global) {
 
 // 建议产出后把各 profile 的新 cooldown.until_ts 写回 summaries.json（原子写、
 // fail-soft）。写前重读磁盘再合并：并发注入各自基于最新磁盘态写回，把互相覆盖
-// 窗口压到最小（残余竞态：读-写间隙，彻底解决需进程内锁，成本不值）。
-function writeBackCooldowns(file, data, produced, logger) {
+// 窗口压到最小（残余竞态：读-写间隙，彻底解决需进程内锁，成本不值）。回滚冷却
+// 注入（suggestion-rollback 后同键冷却）复用同一写入口。
+export function writeBackCooldowns(file, data, produced, logger) {
   const fresh = readSummaries(file, logger);
   const base = fresh !== null && typeof fresh === 'object' ? fresh : data;
   const l1 = { ...(base.l1 ?? {}) };
@@ -244,7 +248,23 @@ function writeBackCooldowns(file, data, produced, logger) {
   }
 }
 
-// 结构化建议（读+算，不写回 cooldown、不渲染文本）：供注入段与只读面板共用。
+// 滞后防振荡 streak 写回 summaries.json（原子写、fail-soft）：与 cooldown 同口径
+// 重读磁盘再合并；写入失败只 warn，内存计数仍驱动本轮生成。
+export function writeBackStreaks(summariesFile, streaks, logger) {
+  const fresh = readSummaries(summariesFile, logger);
+  if (fresh === null || typeof fresh !== 'object') return;
+  const l1 = { ...(fresh.l1 ?? {}) };
+  for (const streak of streaks) {
+    const group = l1[streak.profileKey];
+    l1[streak.profileKey] = { ...group, streak: { axis: streak.axis, direction: streak.direction, count: streak.count, last_ts: streak.last_ts } };
+  }
+  const res = writeSummaries(summariesFile, { l1, l2: fresh.l2 ?? {} });
+  if (res.persisted !== true) {
+    logger.warn(`[dsh-subagent-profile] evolution:advice streak 写回失败：${res.error ?? '未知错误'}`);
+  }
+}
+
+// 结构化建议（读+算，不写回 cooldown、不渲染文本）：供人类面板与只读展示共用。
 export function computeAdvice({ summariesFile, dispatchFile, whitelist, logger, onLoss }) {
   if (dispatchFile !== undefined && summariesStale(dispatchFile, summariesFile)) refreshSummaries({ dispatchFile, summariesFile, logger });
   let data = readSummaries(summariesFile, logger, { onLoss });
@@ -276,7 +296,8 @@ export function computeAdvice({ summariesFile, dispatchFile, whitelist, logger,
   return { advice, global: { ...global, total: global.completed + global.failed + global.killed }, produced, summaries: data };
 }
 
-// 派发优化建议段文本生成：computeAdvice → 写回 cooldown（防每请求重复注入）→ 渲染；空建议返回空串。
+// 面板侧建议文本生成：computeAdvice → 写回 cooldown（防每请求重复注入）→ 渲染；空建议返回空串。
+// 仅供人类面板（/list 建议区）调用；模型侧注入段已下架（index.mjs 恒空）。
 export function buildAdviceText({ summariesFile, dispatchFile, whitelist, logger, onLoss }) {
   const { advice, global, produced, summaries } = computeAdvice({ summariesFile, dispatchFile, whitelist, logger, onLoss });
   if (advice.length === 0) return '';

package/lib/core/evolution-assets.mjs

@@ -81,6 +81,18 @@ function sweepExpiredAssets() {
   return 0;
 }
 
+// 数据维护清理：删除全部资产文件 + 索引置空（审计由调用方记）。返回删除条数；
+// 单个文件删除失败不阻断其余（best effort）。
+function purgeAllAssets(state) {
+  const count = state.index.assets.length;
+  for (const entry of state.index.assets) {
+    try { rmSync(join(state.dir, `${entry.id}.json`), { force: true }); } catch { /* best effort */ }
+  }
+  state.index.assets = [];
+  state.persistIndex();
+  return count;
+}
+
 // 状态流转：资产文件先行（合并 patch + 状态 + updatedAt），成功后同步索引。
 function transitionAsset(state, id, nextState, patch) {
   const safe = safeAssetId(id);
@@ -161,6 +173,7 @@ export function createEvolutionAssets({ dshHome, logger, onGovernanceFailure = (
       .filter((e) => e.profileKey === profileKey && UNRESOLVED_STATES.has(e.state))
       .map((e) => ({ ...e })),
     countBySource: (source) => state.index.assets.filter((e) => e.source === source).length,
+    purgeAll: () => purgeAllAssets(state),
     ids: () => state.index.assets.map((e) => e.id),
     sweepExpired: (now) => sweepExpiredAssets(state, now),
   };