dsh-subagent-profile 0.4.0 → 0.5.1

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) {
@@ -169,11 +184,12 @@ function persistProfiles(state, logger) {
 // （派发优化建议注入，默认关，需显式开）+ escapeEnabled（逃生舱放行，默认关——信任
 // 底板，仅设置页显式 opt-in 可放开）+ applyEnabled（进化候选生成与应用写路径，默认
 // 关——应用能力只由人显式开启）+ candidateMode/candidateTtlH（候选方案更新策略与
-// 有效期，用户可配置）。开关共用同一 state.json，读写整份对象以互不覆盖；
+// 有效期，用户可配置）+ snapshotEnabled（派发配置快照，默认关——本机私有域，仅
+// 设置页显式 opt-in 开启）。开关共用同一 state.json，读写整份对象以互不覆盖；
 // 缺失文件回退默认值（全新部署），损坏文件 fail-closed（全关，绝不静默回退
 // enabled:true —— 安全禁用会被撤销），内存态仍驱动本进程。
-const STATE_DEFAULTS = { enabled: true, evolutionAdvice: false, escapeEnabled: false, applyEnabled: false, candidateMode: 'auto', candidateTtlH: 24 };
-const STATE_FAIL_CLOSED = { enabled: false, evolutionAdvice: false, escapeEnabled: false, applyEnabled: false, candidateMode: 'auto', candidateTtlH: 24 };
+const STATE_DEFAULTS = { enabled: true, evolutionAdvice: false, escapeEnabled: false, applyEnabled: false, candidateMode: 'auto', candidateTtlH: 24, snapshotEnabled: false };
+const STATE_FAIL_CLOSED = { enabled: false, evolutionAdvice: false, escapeEnabled: false, applyEnabled: false, candidateMode: 'auto', candidateTtlH: 24, snapshotEnabled: false };
 
 // 候选有效期小时数归一：0（不自动过期）或 1~8760（一年内）的整数原样保留，
 // 其余值回退默认 24 小时（读取与写入共用同一口径，防坏值落盘）。
@@ -193,6 +209,7 @@ function loadState(state) {
       applyEnabled: parsed.applyEnabled === true,
       candidateMode: parsed.candidateMode === 'manual' ? 'manual' : 'auto',
       candidateTtlH: validCandidateTtlH(parsed.candidateTtlH),
+      snapshotEnabled: parsed.snapshotEnabled === true,
     };
   } catch (error) {
     // fail-closed（S2）：损坏的 state.json 若回退 enabled:true，会把「安全禁用」静默撤销。
@@ -223,6 +240,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 +275,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);
@@ -264,6 +296,8 @@ export function createProfileStore({ dshHome, logger, onGovernanceFailure = () =
     persistCandidateMode: (value) => persistState(state, { candidateMode: value === 'manual' ? 'manual' : 'auto' }, onGovernanceFailure),
     loadCandidateTtlH: () => loadState(state).candidateTtlH,
     persistCandidateTtlH: (value) => persistState(state, { candidateTtlH: validCandidateTtlH(value) }, onGovernanceFailure),
+    loadSnapshotEnabled: () => loadState(state).snapshotEnabled,
+    persistSnapshotEnabled: (value) => persistState(state, { snapshotEnabled: value === true }, onGovernanceFailure),
     // getAllowFailOpen：cost guard 必须在派发时读取迁移标志；
     // loadProfiles/persistProfiles 持有该写入。
     getAllowFailOpen: () => state.allowFailOpen,

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/lib/core/reminder-store.mjs

@@ -65,6 +65,10 @@ function loadState(stateFile, state, warn) {
         createdAt: Number.isFinite(raw.createdAt) ? raw.createdAt : 0,
         action: typeof raw.action === 'string' ? raw.action : null,
         actedAt: Number.isFinite(raw.actedAt) ? raw.actedAt : null,
+        // 归档标记：数据维护「归档已处理提醒」置位；归档只移出活动列表、绝不物理删除
+        // （提醒=审计记录，存储与 governance-audit 保留）。
+        archived: raw.archived === true,
+        archivedAt: Number.isFinite(raw.archivedAt) ? raw.archivedAt : null,
       });
     }
   } catch (error) {
@@ -117,6 +121,8 @@ function recordReminder(state, persist, audit, { severity, kind, title, detail,
     createdAt: Date.now(),
     action: null,
     actedAt: null,
+    archived: false,
+    archivedAt: null,
   };
   state.reminders.push(reminder);
   if (state.reminders.length > state.maxReminders) state.reminders.shift();
@@ -153,8 +159,34 @@ function actOnReminder(state, persist, audit, id, action) {
 }
 
 function listReminders(state, unreadOnly) {
-  const all = [...state.reminders].reverse();
-  return unreadOnly ? all.filter((r) => r.unread === true) : all;
+  const active = state.reminders.filter((r) => r.archived !== true).reverse();
+  return unreadOnly ? active.filter((r) => r.unread === true) : active;
+}
+
+// 归档视图：只读、按处理时间倒序、分页（防大量已处理条目一次性渲染卡 UI）。
+// 返回 { reminders, total, offset, limit }；坏参数归一安全值。
+function listArchivedReminders(state, offset, limit) {
+  const off = Number.isInteger(offset) && offset >= 0 ? offset : 0;
+  const lim = Number.isInteger(limit) && limit > 0 ? Math.min(limit, 100) : 20;
+  const archived = state.reminders
+    .filter((r) => r.archived === true)
+    .sort((a, b) => (b.archivedAt ?? b.actedAt ?? 0) - (a.archivedAt ?? a.actedAt ?? 0));
+  return { reminders: archived.slice(off, off + lim), total: archived.length, offset: off, limit: lim };
+}
+
+// 归档已处理条目：action 非空且未归档的一并置 archived（只移出活动列表、保留存储）。
+// 返回本次归档条数；审计由调用方按一次清理记一条（数据维护口径）。
+function archiveActedReminders(state, persist) {
+  const now = Date.now();
+  let count = 0;
+  for (const reminder of state.reminders) {
+    if (typeof reminder.action !== 'string' || reminder.action === '' || reminder.archived === true) continue;
+    reminder.archived = true;
+    reminder.archivedAt = now;
+    count += 1;
+  }
+  if (count > 0) persist();
+  return count;
 }
 
 export function createReminderStore({ dshHome, audit = () => {}, warn = () => {}, maxReminders = MAX_REMINDERS } = {}) {
@@ -167,6 +199,8 @@ export function createReminderStore({ dshHome, audit = () => {}, warn = () => {}
     ack: (ids) => ackReminders(state, persist, audit, ids),
     actOn: (id, action) => actOnReminder(state, persist, audit, id, action),
     list: ({ unreadOnly = false } = {}) => listReminders(state, unreadOnly),
-    unreadCount: () => state.reminders.filter((r) => r.unread === true).length,
+    listArchived: ({ offset = 0, limit = 20 } = {}) => listArchivedReminders(state, offset, limit),
+    archiveActed: () => archiveActedReminders(state, persist),
+    unreadCount: () => state.reminders.filter((r) => r.unread === true && r.archived !== true).length,
   };
 }

package/lib/core/snapshots.mjs

@@ -0,0 +1,148 @@
+// lib/core/snapshots.mjs — 派发配置快照域（subagent-evolution/snapshots/）。
+// 开关开启后每次 dispatch effective 形成后写一条完整 config 快照（含 persona 原文
+// 与 toolFilter 全量），供「保存为方案」事后完整复现该笔派发；快照是用户显式
+// opt-in 的本机私有域（不是台账，dispatch.jsonl 不落原文——隐私红线保持）。
+// 原子写（tmp+rename）；索引 snapshots.index.json 记录元数据（无原文），按 ts
+// 倒序读取；损坏文件/索引 fail-soft 跳过；总量护栏：快照 ≤200 条，到上限停止
+// 新写并提示清理（不自动删旧）。import-free（仅 node 内置），可被裸 CI 单测。
+// 审计：snapshot-written（写）/ snapshot-used（保存为方案命中，由调用方记）。
+
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+// 快照总量护栏（B7 定稿值）：到上限停止新写（不自动删旧，提示清理）。
+export const SNAPSHOT_CAP = 200;
+
+// 完整 config 字段集：与 dispatch merged 同源（persona 原文、toolFilter 完整对象）。
+const CONFIG_FIELDS = ['preset', 'provider', 'model', 'reasoningEffort', 'maxTokens', 'maxDepth', 'persona', 'toolFilter'];
+
+// profileKey 摘要（文件名安全前缀，非可逆）。
+function digestOf(profileKey) {
+  return createHash('sha256').update(String(profileKey)).digest('hex').slice(0, 12);
+}
+
+// 原子写（tmp+rename）：崩溃不产生截断文件；失败清理 tmp + warn + 治理审计钩子。
+function atomicWrite(file, payload, logger, onGovernanceFailure) {
+  const tmp = `${file}.tmp`;
+  try {
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(tmp, JSON.stringify(payload, null, 2), 'utf8');
+    renameSync(tmp, file);
+    return { persisted: true };
+  } catch (error) {
+    try { rmSync(tmp, { force: true }); } catch { /* best effort */ }
+    if (logger !== undefined && typeof logger.warn === 'function') {
+      logger.warn(`[dsh-subagent-profile] 配置快照写入失败：${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof onGovernanceFailure === 'function') onGovernanceFailure();
+    return { persisted: false, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+// 读索引；缺失回退空表，损坏/形状不符 fail-soft 从空起步（快照文件仍在，索引可重建）。
+function readIndex(indexFile, logger) {
+  if (!existsSync(indexFile)) return [];
+  try {
+    const parsed = JSON.parse(readFileSync(indexFile, 'utf8'));
+    if (parsed !== null && typeof parsed === 'object' && parsed.v === 1 && Array.isArray(parsed.entries)) {
+      return parsed.entries.filter((e) => e !== null && typeof e === 'object' && typeof e.id === 'string');
+    }
+  } catch { /* fail-soft */ }
+  if (logger !== undefined && typeof logger.warn === 'function') {
+    logger.warn('[dsh-subagent-profile] 配置快照索引损坏，按空索引处理（快照文件保留）');
+  }
+  return [];
+}
+
+// 读单个快照文件；缺失/损坏/形状不符返回 null（fail-soft，调用方跳过）。
+function readSnapshotFile(file, logger) {
+  if (!existsSync(file)) return null;
+  try {
+    const parsed = JSON.parse(readFileSync(file, 'utf8'));
+    if (parsed !== null && typeof parsed === 'object' && parsed.v === 1 && typeof parsed.id === 'string' && parsed.config !== null && typeof parsed.config === 'object') {
+      return parsed;
+    }
+  } catch { /* fail-soft */ }
+  if (logger !== undefined && typeof logger.warn === 'function') {
+    logger.warn(`[dsh-subagent-profile] 配置快照文件损坏，跳过：${file}`);
+  }
+  return null;
+}
+
+// dispatch effective 形成后调用：开关关恒跳过；到护栏上限停止新写（不自动删旧）。
+// 幂等键 = 摘要+ts；同键碰撞跳过。审计只记元数据（无 persona/prompt 原文）。
+function captureSnapshot(deps, { profileKey, config, mode }) {
+  if (!deps.getEnabled()) return null;
+  if (deps.state.index.length >= SNAPSHOT_CAP) {
+    if (deps.logger !== undefined && typeof deps.logger.warn === 'function') {
+      deps.logger.warn(`[dsh-subagent-profile] 配置快照已达 ${SNAPSHOT_CAP} 条护栏上限，停止新快照（可在设置页数据维护区清理）`);
+    }
+    return null;
+  }
+  const key = typeof profileKey === 'string' ? profileKey : '(inline)';
+  const ts = Date.now();
+  const id = `${digestOf(key)}-${ts}`;
+  if (deps.state.index.some((e) => e.id === id)) return null;
+  const payload = { v: 1, id, ts, profileKey: key, from: typeof mode === 'string' && mode !== '' ? mode : 'dispatch', config: {} };
+  for (const field of CONFIG_FIELDS) {
+    if (config !== null && typeof config === 'object' && config[field] !== undefined) payload.config[field] = config[field];
+  }
+  const size = Buffer.byteLength(JSON.stringify(payload));
+  const file = join(deps.dir, `${id}.json`);
+  const written = atomicWrite(file, payload, deps.logger, deps.onGovernanceFailure);
+  if (!written.persisted) return null;
+  deps.state.index.push({ key, ts, size, id, from: payload.from });
+  deps.persistIndex();
+  deps.recordAudit({ kind: 'snapshot-written', profile_key: key, file: `${id}.json`, size });
+  return { id, ts, profileKey: key };
+}
+
+// 索引元数据列表（ts 倒序；无 config 原文）。
+function listSnapshots(state) {
+  return [...state.index].sort((a, b) => b.ts - a.ts);
+}
+
+// 单条完整快照（只读查看用；含 persona 原文，UI 默认折叠）。
+function viewSnapshot(deps, id) {
+  if (typeof id !== 'string' || id === '' || !deps.state.index.some((e) => e.id === id)) return null;
+  return readSnapshotFile(join(deps.dir, `${id}.json`), deps.logger);
+}
+
+// 「保存为方案」数据源：按 profileKey 匹配最近一条快照（ts 倒序首条命中）。
+function latestSnapshot(deps, profileKey) {
+  for (const entry of listSnapshots(deps.state)) {
+    if (entry.key !== profileKey) continue;
+    const snapshot = readSnapshotFile(join(deps.dir, `${entry.id}.json`), deps.logger);
+    if (snapshot !== null) return { ...snapshot, file: `${entry.id}.json` };
+  }
+  return null;
+}
+
+// 一键清理：删除全部快照文件 + 索引置空。返回删除条数（审计由调用方记）。
+function clearSnapshots(deps) {
+  const count = deps.state.index.length;
+  for (const entry of deps.state.index) {
+    try { rmSync(join(deps.dir, `${entry.id}.json`), { force: true }); } catch { /* 单个删除失败不阻断其余 */ }
+  }
+  deps.state.index = [];
+  try { rmSync(deps.indexFile, { force: true }); } catch { /* best effort */ }
+  return count;
+}
+
+export function createSnapshotStore({ dshHome, logger, getEnabled = () => false, recordAudit = () => {}, onGovernanceFailure = () => {} } = {}) {
+  const dir = join(dshHome, 'subagent-evolution', 'snapshots');
+  const indexFile = join(dir, 'snapshots.index.json');
+  const state = { index: readIndex(indexFile, logger) };
+  const deps = { dir, indexFile, state, logger, getEnabled, recordAudit, onGovernanceFailure, persistIndex: () => atomicWrite(indexFile, { v: 1, entries: state.index }, logger, onGovernanceFailure) };
+  return {
+    dir,
+    indexFile,
+    capture: (input) => captureSnapshot(deps, input),
+    list: () => listSnapshots(state),
+    view: (id) => viewSnapshot(deps, id),
+    latestByProfileKey: (profileKey) => latestSnapshot(deps, profileKey),
+    count: () => state.index.length,
+    clear: () => clearSnapshots(deps),
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-subagent-profile",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "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 许可声明见开源仓库。

package/presets/{orchestrator → orchestrator-v2}/agent.cordis.yml

@@ -1,4 +1,4 @@
-# `orchestrator` 编排者预设：主 Agent 协调模式。
+# `orchestrator-v2` 编排者预设 V2：主 Agent 协调模式 + 梁神 V2 两阶段引导。
 #
 # 与官方 `standard` 预设逐行一致，仅 persona 段改写为「主协调 Agent」身份：
 # 拆解任务、经宿主注册的 `dispatch` 工具（按场景选方案/预设/模型/推理强度）
@@ -6,8 +6,27 @@
 # 再集成结果。`dispatch` 工具本身由 dsh-subagent-profile 宿主行注册，对所有
 # 预设可见；本预设只补下面的委派工具。
 #
-# 改编自官方 `standard` 预设（仅 persona 段不同）；原始 DeepSeek 版权与
-# MIT 许可声明见开源仓库。
+# V2 改造（模仿梁神模式 V2，适配当前 DSH >= 0.1.2）：
+# - 引入两阶段引导 `./tool-bootstrap.mjs`：第一个持久工具/调用事件之前，
+#   模型只看到 Minimal 双工具（`bash` + `str_replace_editor`）与本预设的
+#   persona 段，无运行时上下文、只放行白名单消息来源；锚定（或四步兜底、
+#   或首轮结束）后升入 PTC 模式（单 `run_code` 工具）并恢复全量目录，
+#   工作区指令与技能目录延迟一步注入。压缩后回落到受控阶段
+#   （双工具 + compactionTools 核心工作集，含 dispatch/subagent 以维持委派），
+#   等待新的升态信号。
+# - tool-bootstrap.mjs 已适配 0.1.2：经 `session.snapshotEvents()` 读事件日志
+#   （旧 `session.events` 属性已移除，直接读会每轮崩 "Cannot read properties
+#   of undefined (reading 'length')"）；persona 已含 `{{cwd}}` 模板时不再追加
+#   字面工作目录行。
+# - 补 `str_replace_editor`（phase-1 编辑器）；win32 下补 `custom-bash`
+#   （Git Bash `bash` 工具）以保住 phase-1 的 `bash` 锚点——官方 tool-bash
+#   在 win32 禁用、tool-pwsh 不叫 bash，没有它 phase-1 会退化成全量目录。
+#   posix 下官方 tool-bash 本身就叫 bash，无需补行。
+# - 补 `command-goal`（/goal 人机命令，对齐当前官方 standard）；spawn 行补
+#   `modelSelectionSettings: true`。
+#
+# 改编自官方 `standard` 预设与梁神模式 V2（liangshen-v2）；原始 DeepSeek
+# 版权与 MIT 许可声明见开源仓库与随附 NOTICE。
 #
 # 本文件是 agent 平面组成：由 roster 挂载一次到 standing scope，引用它的会话
 # 经 scope 父系加入，本文件注册的工具与 prompt 段覆盖每个加入的 agent；会话
@@ -37,6 +56,35 @@
 
       边界：子 Agent 能力 ⊆ 你，派发不豁免父会话的审批要求；子 Agent 失败或超出权限时自己接手重做，或用 ask_user_question 向用户澄清。
 
+# 两阶段输入引导（同梁神 V2 的 tool-bootstrap）：在第一个持久 tool/call 事件
+# 之前，模型只看到 `bash` + `str_replace_editor` 双工具与本预设 persona 段、
+# 无运行时上下文、只放行白名单消息来源（直接用户消息 + goal 自动轮次）。
+# anchorGate 让升态保持到首个 minimal-like 推理块（四步兜底）；
+# promoteAfterFirstResponse 避免无工具首答后永久双工具，并在首轮结束时释放
+# 锚门会话。升态后目录以 PTC 模式呈现（线上单一 run_code 工具，步边界切换），
+# 工作区指令与技能目录延迟一步；bootstrapMaxTokens 封顶 phase-1 输出预算
+# （1024），升态后再剥离。压缩后回落到受控阶段（双工具 + compactionTools），
+# 直到新升态信号——本预设把 dispatch/subagent 加进 compactionTools，
+# 让压缩后的编排者仍能继续委派。
+- id: tool-bootstrap
+  name: ./tool-bootstrap.mjs
+  config:
+    shellTools: [bash]
+    commonTools: [str_replace_editor]
+    messageSources: [user, goal]
+    anchorGate: true
+    maxBootstrapSteps: 4
+    promoteAfterFirstResponse: true
+    bootstrapMaxTokens: 1024
+    compactionTools: [read, write, edit, glob, grep, todo_write, ask_user_question, dispatch, subagent]
+    deferredSources: [agent-instructions, skill-catalog]
+    deferredGraceSteps: 1
+    promotedPresentation: code
+    # 升态后以一次性非指令式提示替代 AGENTS.md 全文注入（梁神 V2 保留的
+    # issue #388 设定），知识经 read / skill_load 可达。设 false 恢复全文注入。
+    instructionHint: true
+
+# 工作区指令在 phase 1 被 tool-bootstrap 隔离，升态后延迟一步注入并保持更新。
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:
@@ -57,8 +105,25 @@
   name: '@deepseek-ai/dsh-tool-pwsh'
   disabled: !!js process.platform !== 'win32'
 
+# win32 专用 `bash` 工具（custom-bash.mjs，同梁神 V2）：官方 tool-bash 在
+# win32 禁用、tool-pwsh 又不叫 bash，phase-1 的 Minimal 锚点（shellTools:
+# [bash]）会找不到 shell 而退化成全量目录。此工具经跨平台 subprocess 缝隙
+# 执行 Git Bash（`bash -c`），保住锚点；posix 下官方 tool-bash 已提供
+# 同名工具，此行走禁用。非零退出上报不抛；调用间状态不持久；Windows 无
+# OS 沙箱限制。`bashPath` 可选（缺省按 Git 安装根推断）。
+- id: custom-bash
+  name: ./custom-bash.mjs
+  disabled: !!js process.platform !== 'win32'
+
 # ── filesystem ──────────────────────────────────────────────────────────────
 
+# Phase-1 编辑器（同梁神 V2）：顶层直排，复用宿主沙箱 ctx.fs 而非裸本地
+# 文件系统，schema 与官方 Minimal `str_replace_editor` 一致。
+- id: str-replace-editor
+  name: '@deepseek-ai/dsh-tool-str-replace-editor'
+  config:
+    maxOutputChars: 16000
+
 # 两者都注册进宿主 tools 注册表且不提供服务，无需 realm；fs 服务与其策略留在宿主。
 - id: tool-fs
   name: '@deepseek-ai/dsh-tool-fs'
@@ -90,10 +155,15 @@
 
 # ── goals ───────────────────────────────────────────────────────────────────
 
-# 只放模型可见的工具。goal 服务、会话驱动与 /goal 命令留在宿主平面：
-# Gateway 以 Remote endpoint 服务 goal 域，接收方来自生成描述符，条目本地
-# realm 会隐藏它。注册表本就按会话键控，一个宿主实例服务所有会话；预设
-# 只决定其 agent 能否调用 goal 工具。
+# goal 服务与会话驱动留在宿主平面，Gateway 在那里解析它们。人机命令与
+# 模型可见工具注册进本预设的 scope 层。
+- id: command-goal
+  name: '@deepseek-ai/dsh-command-goal'
+
+# 只放模型可见的工具。goal 服务与会话驱动留在宿主平面：Gateway 以 Remote
+# endpoint 服务 goal 域，接收方来自生成描述符，条目本地 realm 会隐藏它。
+# 注册表本就按会话键控，一个宿主实例服务所有会话；预设只决定其 agent
+# 能否调用 goal 工具。
 - id: tool-goal
   name: '@deepseek-ai/dsh-tool-goal'
 
@@ -182,6 +252,7 @@
       config:
         provider: spawn
         toolName: subagent
+        modelSelectionSettings: true
         backgroundMode: continuable
 
     - id: tool-subagent-fork