dsh-subagent-profile 0.3.4 → 0.5.0

package/lib/core/evolution-draft.mjs

@@ -0,0 +1,333 @@
+// lib/core/evolution-draft.mjs — 进化建议 → 可应用候选资产的确定性生成器。
+// 纯函数 + 数据注入（catalog 快照 / 白名单 / 已占用 id 集），零 LLM、零 fs、零新依赖：
+// 同输入恒同输出，可裸 import 单测；只产出候选 config，落盘/审计由装配层负责。
+// 推导规则（确定性，一条建议 → ≤3 条互斥候选，保守 → 更激进排序）：
+//   降（能力轴只降）：单步 = 模型更低档 / 移除 persona·toolFilter 结构段 / 白名单内
+//       相邻低档预设；组合 = 单步并列补充（如模型低档 + 移除工具过滤）。
+//   升（预算轴只升）：推理强度升一级（阶梯与派发档位同源）、maxTokens ×2 封顶
+//       硬上限，可组合。跨方向禁止（全降或全升）；全无候选返回空表。平 → 空表。
+// 隐私：不引入 prompt/persona 原文；config 只含字段与值，basis 只含摘要文本。
+
+import { createHash } from 'node:crypto';
+import { MAX_TOKENS, sanitizeProfile } from './pure.mjs';
+import { profileKeyOf } from './evolution-summary.mjs';
+import { avgCostFor } from './prices.mjs';
+
+// 推理档位阶梯：升档「升一级」的口径与派发工具档位同源；未知档位不升（保守）。
+export const EFFORT_LADDER = ['off', 'low', 'medium', 'high', 'max'];
+
+const ID_MAX_LEN = 32;
+const ID_RETRY_MAX = 5;
+
+// profileKey 轴段解析（evolution-summary 的 L1 身份键口径）：
+// preset:<名> / provider:<名> / model:<名> / persona:1 / toolFilter:1。
+function parseProfileKey(profileKey) {
+  const parsed = { preset: null, provider: null, model: null, persona: false, toolFilter: false };
+  const text = typeof profileKey === 'string' ? profileKey : '';
+  for (const part of text.split('|')) {
+    if (part.startsWith('preset:')) parsed.preset = part.slice('preset:'.length);
+    else if (part.startsWith('provider:')) parsed.provider = part.slice('provider:'.length);
+    else if (part.startsWith('model:')) parsed.model = part.slice('model:'.length);
+    else if (part === 'persona:1') parsed.persona = true;
+    else if (part === 'toolFilter:1') parsed.toolFilter = true;
+  }
+  return parsed;
+}
+
+// 身份摘要：只保留小写字母/数字/连字符，供候选 id 使用（sanitize 友好）。
+export function lowerHyphen(text) {
+  return String(text ?? '').toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
+}
+
+// 候选 id 基名：evo-<方向>-<身份摘要>，总长 ≤32。摘要在长键时截断。
+function baseDraftId(direction, profileKey) {
+  const slug = lowerHyphen(profileKey).slice(0, 24) || 'inline';
+  return `evo-${direction}-${slug}`.slice(0, ID_MAX_LEN);
+}
+
+// id 冲突重试：与已占用 id（profiles + 资产）冲突时追加 -2、-3……（≤5 次），
+// 仍冲突返回 null（装配层放弃生成，不产出会撞名的候选）。基名可由调用方给定
+// （多候选在基名后追加 -c<N> 序号）。
+function nextIdForBase(base, taken) {
+  const ids = taken instanceof Set ? taken : new Set(Array.isArray(taken) ? taken : []);
+  if (!ids.has(base)) return base;
+  for (let i = 2; i <= ID_RETRY_MAX + 1; i += 1) {
+    const candidate = `${base}-${i}`.slice(0, ID_MAX_LEN);
+    if (!ids.has(candidate)) return candidate;
+  }
+  return null;
+}
+
+export function nextDraftId(direction, profileKey, taken) {
+  return nextIdForBase(baseDraftId(direction, profileKey), taken);
+}
+
+// 同 provider 单价更低且最接近的模型档。当前模型无单价或同 provider 无更低档时
+// 返回 null（调用方跳过该步，走更保守的降档策略）。
+function modelDowngrade(modelName, providerName, models) {
+  if (typeof modelName !== 'string' || modelName === '') return null;
+  const currentCost = avgCostFor(modelName);
+  if (currentCost === undefined) return null;
+  const list = Array.isArray(models) ? models : [];
+  let provider = providerName;
+  if (provider === null || provider === '') {
+    const current = list.find((m) => m && m.id === modelName);
+    provider = current !== undefined && typeof current.provider === 'string' ? current.provider : null;
+  }
+  if (provider === null) return null;
+  const candidates = list
+    .filter((m) => m && typeof m.id === 'string' && m.id !== modelName && m.provider === provider)
+    .map((m) => ({ id: m.id, provider: m.provider, cost: avgCostFor(m.id) }))
+    .filter((m) => m.cost !== undefined && m.cost < currentCost)
+    .sort((a, b) => b.cost - a.cost);
+  const pick = candidates[0];
+  return pick === undefined ? null : { provider: pick.provider, model: pick.id };
+}
+
+// 同 L1 身份键下的预算轴当前值（从 L2 键反查）：maxTokens 取组内最大值，
+// reasoningEffort 取组内阶梯最高档。
+function higherEffort(a, b) {
+  const ia = a === null ? -1 : EFFORT_LADDER.indexOf(a);
+  const ib = b === null ? -1 : EFFORT_LADDER.indexOf(b);
+  return ib > ia ? b : a;
+}
+
+function budgetFromL2(profileKey, l2) {
+  const source = l2 !== null && typeof l2 === 'object' ? l2 : {};
+  let maxTokens = null;
+  let effort = null;
+  for (const [axisKey] of Object.entries(source)) {
+    if (typeof axisKey !== 'string') continue;
+    const tokensPrefix = `${profileKey}:maxTokens:`;
+    if (axisKey.startsWith(tokensPrefix)) {
+      const value = Number(axisKey.slice(tokensPrefix.length));
+      if (Number.isFinite(value) && value > 0) maxTokens = maxTokens === null ? value : Math.max(maxTokens, value);
+      continue;
+    }
+    const effortPrefix = `${profileKey}:reasoningEffort:`;
+    if (axisKey.startsWith(effortPrefix)) effort = higherEffort(effort, axisKey.slice(effortPrefix.length));
+  }
+  return { maxTokens, reasoningEffort: effort };
+}
+
+// 变更前配置（审计 from 口径）：能力轴取值来自身份键，预算轴取值反查 L2。
+export function sourceConfigFromKey(profileKey, l2) {
+  const parsed = parseProfileKey(profileKey);
+  const budget = budgetFromL2(profileKey, l2);
+  const config = {};
+  if (parsed.preset !== null) config.preset = parsed.preset;
+  if (parsed.provider !== null) config.provider = parsed.provider;
+  if (parsed.model !== null) config.model = parsed.model;
+  if (parsed.persona) config.persona_present = true;
+  if (parsed.toolFilter) config.toolFilter_present = true;
+  if (budget.reasoningEffort !== null) config.reasoningEffort = budget.reasoningEffort;
+  if (budget.maxTokens !== null) config.maxTokens = budget.maxTokens;
+  return config;
+}
+
+// 候选名中的改动摘要（人话，零配置原文）：模型/预设给新值，结构移除按存在性组词。
+function structureChangeSummary(parsed) {
+  if (parsed.persona && parsed.toolFilter) return '去掉自定义人格与工具过滤';
+  if (parsed.persona) return '去掉自定义人格';
+  return '移除工具过滤';
+}
+
+// 保守度标签：按「保守 → 更激进」排序，两端为保守/更激进，三档时中间为均衡。
+function radicalLabel(index, total) {
+  if (total <= 1) return '保守';
+  if (index === 0) return '保守';
+  if (index === total - 1) return '更激进';
+  return '均衡';
+}
+
+// 白名单内相邻低档预设（名册口径）；无可用低档返回 null。
+function downPresetPick(parsed, whitelist, presets) {
+  if (parsed.preset === null) return null;
+  const roster = Array.isArray(presets) ? presets : [];
+  const index = roster.findIndex((p) => p && p.id === parsed.preset);
+  for (let i = index - 1; i >= 0; i -= 1) {
+    const candidate = roster[i];
+    if (candidate === null || candidate === undefined || typeof candidate.id !== 'string' || candidate.id === '') continue;
+    const allowed = whitelist instanceof Set ? whitelist.has(candidate.id) : Array.isArray(whitelist) && whitelist.includes(candidate.id);
+    if (allowed) return { id: candidate.id };
+  }
+  return null;
+}
+
+// 降档候选清单（能力轴只降，互斥替代）：单步（模型 → 结构移除 → 预设）在前，
+// 组合在后（候选 2 可含候选 1 全部改动再加一个）；同一建议只产同一方向。
+// 每个候选是完整 config 快照（身份键内其余能力字段保留、被移除的结构段缺席）。
+function downCandidateConfigs(parsed, models, whitelist, presets) {
+  const out = [];
+  const modelPick = parsed.model !== null ? modelDowngrade(parsed.model, parsed.provider, models) : null;
+  if (modelPick !== null) {
+    const config = { provider: modelPick.provider, model: modelPick.model };
+    if (parsed.preset !== null) config.preset = parsed.preset;
+    out.push({ config, summary: `模型改 ${modelPick.model}` });
+  }
+  if (parsed.persona || parsed.toolFilter) {
+    const config = {};
+    if (parsed.preset !== null) config.preset = parsed.preset;
+    if (parsed.provider !== null) config.provider = parsed.provider;
+    if (parsed.model !== null) config.model = parsed.model;
+    out.push({ config, summary: structureChangeSummary(parsed) });
+  }
+  const presetPick = downPresetPick(parsed, whitelist, presets);
+  if (presetPick !== null) {
+    out.push({ config: { preset: presetPick.id }, summary: `预设改 ${presetPick.id}` });
+  }
+  if (modelPick !== null && (parsed.persona || parsed.toolFilter)) {
+    const config = { provider: modelPick.provider, model: modelPick.model };
+    if (parsed.preset !== null) config.preset = parsed.preset;
+    out.push({ config, summary: `模型改 ${modelPick.model} + ${structureChangeSummary(parsed)}` });
+  }
+  if (modelPick !== null && presetPick !== null) {
+    out.push({ config: { provider: modelPick.provider, model: modelPick.model, preset: presetPick.id }, summary: `模型改 ${modelPick.model} + 预设改 ${presetPick.id}` });
+  }
+  return out;
+}
+
+// 推理强度下一档（阶梯同派发档位）；已在顶档或无值返回 null。
+function nextEffortOf(effort) {
+  if (typeof effort !== 'string' || effort === '') return null;
+  const index = EFFORT_LADDER.indexOf(effort);
+  if (index < 0 || index >= EFFORT_LADDER.length - 1) return null;
+  return EFFORT_LADDER[index + 1];
+}
+
+// maxTokens ×2 封顶硬上限；已在上限或无值返回 null。
+function nextTokensOf(maxTokens) {
+  if (typeof maxTokens !== 'number' || maxTokens <= 0) return null;
+  const capped = Math.min(maxTokens * 2, MAX_TOKENS);
+  return capped > maxTokens ? capped : null;
+}
+
+// 升档候选清单（预算轴只升）：单步（推理强度 → token 上限）在前、组合在后；
+// 每个候选是完整配置快照（未升级的预算字段保留现值）。
+function upCandidateConfigs(fromConfig) {
+  const out = [];
+  const effortNext = nextEffortOf(fromConfig.reasoningEffort);
+  const tokensNext = nextTokensOf(fromConfig.maxTokens);
+  if (effortNext !== null) {
+    const config = { reasoningEffort: effortNext };
+    if (typeof fromConfig.maxTokens === 'number' && fromConfig.maxTokens > 0) config.maxTokens = fromConfig.maxTokens;
+    out.push({ config, summary: '推理强度上调一档' });
+  }
+  if (tokensNext !== null) {
+    const config = { maxTokens: tokensNext };
+    if (typeof fromConfig.reasoningEffort === 'string' && fromConfig.reasoningEffort !== '') config.reasoningEffort = fromConfig.reasoningEffort;
+    out.push({ config, summary: 'token 上限上调' });
+  }
+  if (effortNext !== null && tokensNext !== null) {
+    out.push({ config: { reasoningEffort: effortNext, maxTokens: tokensNext }, summary: '推理强度上调一档 + token 上限上调' });
+  }
+  return out;
+}
+
+// 候选经 sanitizeProfile（strict）校验；有警告即返回 null（生成器输入受控，
+// 此分支只防御未来 schema 变更）。
+function validDraftOrNull(config, name, description) {
+  const { clean, warnings } = sanitizeProfile({ ...config, name, description }, { strict: true });
+  if (warnings.length > 0) return null;
+  return clean;
+}
+
+// 组装候选清单：一条建议 → ≤maxCandidates 条互斥候选（保守 → 更激进排序）。
+// 每条候选 = { config, name, description, basis }；config 含 id（必填非空）+ 能力/预算
+// 字段；name 是「改动摘要（保守度标签）」；basis 供「为什么生成」展示（只含摘要，
+// 无原文）。id = evo-<方向>-<摘要>-c<N>（N=1..3），冲突追加 -2/-3 同旧规则；
+// 跨方向禁止（全降或全升，方向由建议本身决定）。sanitize 不过的候选整条丢弃。
+export function buildEvolutionCandidates({ advice, l1Entry, l2, snapshot, whitelist, takenIds, now = Date.now(), maxCandidates = 3 } = {}) {
+  const a = advice !== null && typeof advice === 'object' ? advice : {};
+  const key = typeof a.profileKey === 'string' ? a.profileKey : '';
+  const suggestion = a.suggestion;
+  if (suggestion !== '降' && suggestion !== '升') return [];
+  const entry = l1Entry !== null && typeof l1Entry === 'object' ? l1Entry : {};
+  const snap = snapshot !== null && typeof snapshot === 'object' ? snapshot : {};
+  const from = sourceConfigFromKey(key, l2);
+  const direction = suggestion === '降' ? 'down' : 'up';
+  const steps = suggestion === '降'
+    ? downCandidateConfigs(parseProfileKey(key), snap.models, whitelist, snap.presets)
+    : upCandidateConfigs(from);
+  const taken = takenIds instanceof Set ? new Set(takenIds) : new Set(Array.isArray(takenIds) ? takenIds : []);
+  const base = baseDraftId(direction, key);
+  const directionText = suggestion === '降' ? '降级能力配置' : '上调预算';
+  const total = Math.min(steps.length, maxCandidates);
+  const out = [];
+  for (const [index, step] of steps.slice(0, maxCandidates).entries()) {
+    // -c<N> 序号与冲突重试后缀（-2）都必须完整落在 32 字符内：基名先让位再拼。
+    const suffix = `-c${index + 1}`;
+    const stem = base.slice(0, ID_MAX_LEN - suffix.length - 2);
+    const id = nextIdForBase(`${stem}${suffix}`, taken);
+    if (id === null) continue;
+    const name = `${step.summary}（${radicalLabel(index, total)}）`;
+    const description = `${a.performanceText ?? ''}；建议：${directionText}`;
+    const clean = validDraftOrNull({ ...step.config, id }, name, description);
+    if (clean === null) continue;
+    const configClean = { ...clean };
+    delete configClean.name;
+    delete configClean.description;
+    taken.add(id);
+    out.push({
+      config: configClean,
+      name,
+      description,
+      basis: {
+        profileKey: key,
+        suggestion,
+        confidence: a.confidence ?? entry.confidence?.level ?? '',
+        score: entry.score?.weighted_success ?? 0,
+        n: entry.confidence?.n ?? 0,
+        performanceText: a.performanceText ?? '',
+        generatedAt: now,
+      },
+    });
+  }
+  return out;
+}
+
+// 单候选兼容入口：取候选清单第一条（最保守）；无候选返回 null。
+export function buildEvolutionDraft(options = {}) {
+  const list = buildEvolutionCandidates(options);
+  return list.length > 0 ? list[0] : null;
+}
+
+// profile 配置 → 身份键口径（与聚合层同口径：persona/toolFilter 只认存在性）。
+export function configIdentityKey(profile) {
+  const cfg = {};
+  if (typeof profile.preset === 'string' && profile.preset !== '' && profile.preset !== 'inherit') cfg.preset = profile.preset;
+  if (typeof profile.provider === 'string' && profile.provider !== '') cfg.provider = profile.provider;
+  if (typeof profile.model === 'string' && profile.model !== '') cfg.model = profile.model;
+  if (typeof profile.persona === 'string' && profile.persona.length > 0) cfg.persona_present = true;
+  if (profile.toolFilter !== undefined && profile.toolFilter !== null) cfg.toolFilter_present = true;
+  return profileKeyOf(cfg);
+}
+
+// 注册表中与某 L1 身份键匹配的方案（净化后快照）——指纹输入，编辑任一方案都会使
+// 候选指纹失配（观察期人工编辑中止同源判据）。
+export function matchingRegistryProfiles(store, profileKey) {
+  const profiles = store.profiles instanceof Map ? [...store.profiles.values()] : [];
+  return profiles
+    .filter((p) => p !== null && typeof p === 'object' && configIdentityKey(p) === profileKey)
+    .map((p) => sanitizeProfile(p, { strict: false }).clean);
+}
+
+// 对象键排序归一（供指纹输入稳定化）。
+function canonicalEntry(entry) {
+  if (entry === null || typeof entry !== 'object') return entry;
+  const out = {};
+  for (const key of Object.keys(entry).sort()) out[key] = entry[key];
+  return out;
+}
+
+// 候选携带的「生成时刻 profile 指纹」：身份键 + 变更前配置 + 匹配该身份键的
+// 注册表方案（排序归一后哈希）。人工编辑方案或聚合数据变化都会使指纹失配，
+// 装配层据此拒绝应用（不静默应用过期候选）。
+export function profileFingerprint({ profileKey, from, registryEntries = [] } = {}) {
+  const entries = Array.isArray(registryEntries) ? registryEntries : [];
+  const sorted = entries
+    .map(canonicalEntry)
+    .sort((a, b) => String(a?.id ?? '').localeCompare(String(b?.id ?? '')));
+  const payload = JSON.stringify({ profileKey, from: canonicalEntry(from), registry: sorted });
+  return createHash('sha1').update(payload, 'utf8').digest('hex');
+}