dsh-subagent-profile 0.3.4 → 0.5.0

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) {
@@ -167,11 +182,19 @@ function persistProfiles(state, logger) {
 
 // 插件开关态（state.json）：enabled（默认开，禁用即关派发工具）+ evolutionAdvice
 // （派发优化建议注入，默认关，需显式开）+ escapeEnabled（逃生舱放行，默认关——信任
-// 底板，仅设置页显式 opt-in 可放开）。三开关共用同一 state.json，读写整份对象
-// 以互不覆盖；缺失文件回退默认值（全新部署），损坏文件 fail-closed（三开关全关，
-// 绝不静默回退 enabled:true —— 安全禁用会被撤销），内存态仍驱动本进程。
-const STATE_DEFAULTS = { enabled: true, evolutionAdvice: false, escapeEnabled: false };
-const STATE_FAIL_CLOSED = { enabled: false, evolutionAdvice: false, escapeEnabled: false };
+// 底板，仅设置页显式 opt-in 可放开）+ applyEnabled（进化候选生成与应用写路径，默认
+// 关——应用能力只由人显式开启）+ candidateMode/candidateTtlH（候选方案更新策略与
+// 有效期，用户可配置）。开关共用同一 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 };
+
+// 候选有效期小时数归一：0（不自动过期）或 1~8760（一年内）的整数原样保留，
+// 其余值回退默认 24 小时（读取与写入共用同一口径，防坏值落盘）。
+function validCandidateTtlH(value) {
+  return typeof value === 'number' && Number.isInteger(value) && (value === 0 || (value >= 1 && value <= 8760)) ? value : 24;
+}
 
 function loadState(state) {
   if (!existsSync(state.stateFile)) return { ...STATE_DEFAULTS };
@@ -182,6 +205,9 @@ function loadState(state) {
       enabled: parsed.enabled !== false,
       evolutionAdvice: parsed.evolutionAdvice === true,
       escapeEnabled: parsed.escapeEnabled === true,
+      applyEnabled: parsed.applyEnabled === true,
+      candidateMode: parsed.candidateMode === 'manual' ? 'manual' : 'auto',
+      candidateTtlH: validCandidateTtlH(parsed.candidateTtlH),
     };
   } catch (error) {
     // fail-closed（S2）：损坏的 state.json 若回退 enabled:true，会把「安全禁用」静默撤销。
@@ -212,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 持久化写失败时触发的审计钩子——一次治理审计丢失事件。
@@ -233,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);
@@ -246,6 +287,13 @@ export function createProfileStore({ dshHome, logger, onGovernanceFailure = () =
     persistEvolutionAdvice: (value) => persistState(state, { evolutionAdvice: value === true }, onGovernanceFailure),
     loadEscapeEnabled: () => loadState(state).escapeEnabled,
     persistEscapeEnabled: (value) => persistState(state, { escapeEnabled: value === true }, onGovernanceFailure),
+    loadApplyEnabled: () => loadState(state).applyEnabled,
+    persistApplyEnabled: (value) => persistState(state, { applyEnabled: value === true }, onGovernanceFailure),
+    // 候选更新策略与有效期（state.json 同源读写，坏值归一默认）。
+    loadCandidateMode: () => loadState(state).candidateMode,
+    persistCandidateMode: (value) => persistState(state, { candidateMode: value === 'manual' ? 'manual' : 'auto' }, onGovernanceFailure),
+    loadCandidateTtlH: () => loadState(state).candidateTtlH,
+    persistCandidateTtlH: (value) => persistState(state, { candidateTtlH: validCandidateTtlH(value) }, 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/session-read.mjs

@@ -0,0 +1,17 @@
+// lib/core/session-read.mjs — 会话事件统一读取口（双轨兼容）。
+//
+// 读取会话事件的两个不兼容环境：
+//   * 稳定线：session.events 是数组（本插件当前发布环境的形状）；
+//   * 新线：session.events 属性被移除，改为按需读取 session.snapshotEvents()。
+// 直接改成新 API 会让稳定线崩溃；直接保留旧读法会在新线崩溃。因此本 helper
+// 逐次 feature-detect：events 数组优先，snapshotEvents() 其次，两轨都不可用
+// 时返回空数组（fall-soft，绝不抛出）。
+//
+// 返回语义：稳定线分支返回 session.events 原数组引用（不拷贝），保持既有
+// identity 语义与零开销；新线分支返回 snapshotEvents() 的返回值（默认全量快照）。
+export function readSessionEvents(session) {
+  if (session === null || session === undefined) return [];
+  if (Array.isArray(session.events)) return session.events;
+  if (typeof session.snapshotEvents === 'function') return session.snapshotEvents();
+  return [];
+}

package/lib/core/shims.mjs

@@ -23,6 +23,7 @@ import { createRequire } from 'node:module';
 // 导出缺失会在 apply 能运行之前就以明确错误中止模块加载——这正是本类存在的隔离。
 import { assertSubagentMaxDepth, resolveChildDepth } from '@deepseek-ai/dsh-subagent';
 import { toStopReason } from './pure.mjs';
+import { readSessionEvents } from './session-read.mjs';
 
 // warn：模块顶层没有 ctx / logger，降级用 console.warn。
 // 前缀让来源在共享宿主日志中可辨认。
@@ -162,7 +163,7 @@ const [foldConsumedWork, finalAssistantOutput, createUserMessage, appendDelegate
 // finalAssistantOutput（最后一个非空 assistant/message，否则拼接的 text-delta
 // 分片，再否则 undefined -> []）。
 function readResult(child, boundary, cancelled) {
-  const own = child.session.events.slice(boundary);
+  const own = readSessionEvents(child.session).slice(boundary);
   const end = foldConsumedWork(own).end;
   const recorded = toStopReason(end?.data.reason);
   const stopReason = cancelled && recorded !== 'completed' ? 'aborted' : recorded;

package/package.json

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

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