@chaoset/adaptive-perf 0.3.1 → 0.4.0

package/README.md

@@ -20,6 +20,17 @@
 - **运行时上下文抑制**：对目标 preset 的会话调用 `suppressRuntimeContext()`
   （与极简模式的 `includeRuntimeContext: false` 同一机制），每次模型请求省掉
   "Current runtime context" 快照文本，**零功能损失**。
+- **极简提示词层（minimalPrompt）**：参考实现的完整锚定条件——首轮轨迹由
+  **Minimal 的完整 system prompt** 决定，只收窄工具 schema 不够（标准/PTC 的
+  系统提示仍带 `harness:identity` / `harness:source` / `app:web-surface` 三个
+  全局引导段与标准 persona，思维链仍是 standard-like 的 "Let me…" 叙述）。本层
+  对目标会话：
+  - 按名阴影屏蔽三个全局引导段（空段在装配时被丢弃，等同极简 `complete`
+    persona 的效果；plan-mode 与 PTC 的 SDK 段不受影响）；
+  - 按名阴影替换 `deployment:persona` 为极简语域 persona（默认与极简模式
+    逐字相同：`You are a helpful software engineer assistant.`）。
+  两处均为 agent 作用域的 prompt 段阴影，仅影响目标会话；**对已恢复/已晋升的
+  旧会话同样生效**（不依赖 bootstrap 阶段）。
 - **工具目录自适应精简**：会话启动时按"工具族"默认隐藏高开销低频工具
   （子代理 / 工作流 / ralph / goal 等编排类），只保留核心编码工具
   （bash / 文件读写编辑 / 检索 / jobs / todo / 提问 / 网页搜索 / 技能 / 计划）。
@@ -36,6 +47,7 @@
 |---|---|---|---|
 | 首轮轨迹（决定后续行为风格） | Minimal 工具对锚定（5/5） | 任何 standard 系 schema 落入 standard-like（11/11） | 请求 #1 收窄到真实 Minimal 工具对，首个持久信号后恢复 |
 | 首轮注入提醒 | 无 skill 目录/AGENTS.md 注入 | 自动注入（在场时锚定 0/9） | 请求 #1 剥离 `skill-catalog` + `agent-instructions` |
+| 系统提示语域（persona + 全局引导段） | 一句话 persona，无任何引导段 | identity/source/web-surface 引导段 + 标准 persona（"Let me…" 叙述来源） | minimalPrompt 层按名阴影屏蔽 3 个全局段 + 替换极简 persona（对旧会话同样生效） |
 | 运行时上下文快照 | 关闭（`includeRuntimeContext: false`） | 每次请求注入文件策略/审批策略等快照 | 同一机制：`suppressRuntimeContext()` |
 | 模型可见工具目录 | 2 个（bash、str_replace_editor） | ~22 个工具 schema 全部进请求 | bootstrap 后默认隐藏 4 个编排类工具族（~11 个工具），按需放行 |
 | PTC SDK 参考段 | 无 | 全部工具的类型+描述渲染进提示 | 随目录缩小（同一 `visible` 视图驱动） |
@@ -89,6 +101,26 @@ dsh plugin --profile web remove @chaoset/adaptive-perf
 | `escalateOnUnknownTool` | `true` | 工具调用失败（UNKNOWN_TOOL）→ 放行该族 |
 | `coreTools` | 核心编码工具 | 展示用：不进入任何限制族 |
 | `families` | 见下 | 工具族：`{ 族名: { enabled, tools, keywords } }` |
+| `bootstrap` | 见下 | 首轮锚定（工具对 / 晋升信号 / 剥离上下文 / 压缩恢复集 / 预算封顶） |
+| `minimalPrompt` | 见下 | 极简提示词层（语域锚定） |
+
+`minimalPrompt`（极简提示词层，0.4.0 新增）：
+
+```json
+{
+  "enabled": true,
+  "persona": "You are a helpful software engineer assistant.",
+  "suppressSections": true
+}
+```
+
+- `persona`：按名阴影替换 `deployment:persona`；默认与极简模式逐字相同，留空
+  （`""`）则不替换。
+- `suppressSections`：屏蔽 `harness:identity` / `harness:source` / `app:web-surface`
+  三个全局引导段（等同极简 `complete` persona 的效果；plan-mode 与 PTC 的
+  SDK 段不受影响）。
+- 生效范围：目标 preset 的全部会话，**包括已恢复/已晋升的旧会话**（不依赖
+  bootstrap 阶段）；配置保存后热生效。
 
 默认工具族（可整族禁用、改名、增删触发词）：
 

package/client/client.cjs

@@ -55,7 +55,13 @@ window.__ModuleLoader__.load({
       bootstrapCompactionTools: "压缩后工作集",
       fieldBootstrapCompactionTools: "compaction/end 之后、再次晋升前额外可用的工具（核心工作集）。逗号分隔。",
       bootstrapMaxTokens: "首轮输出预算封顶（token）",
-      fieldBootstrapMaxTokens: "请求 #1 的 maxTokens 封顶，晋升后自动剥离；0 = 不封顶（opt-in）"
+      fieldBootstrapMaxTokens: "请求 #1 的 maxTokens 封顶，晋升后自动剥离；0 = 不封顶（opt-in）",
+      minimalPromptEnabled: "极简提示词层（语域锚定）",
+      fieldMinimalPromptEnabled: "把系统提示拉回极简语域：屏蔽全局引导段 + 替换 persona。参考实现的完整锚定条件——仅收窄工具不足以翻转思维链风格（let me → let's/i'll/i need）",
+      minimalPromptPersona: "persona 文本",
+      fieldMinimalPromptPersona: "按名替换 deployment:persona；默认与极简模式逐字相同。留空 = 不替换（保留原 persona）",
+      minimalPromptSuppressSections: "屏蔽全局引导段",
+      fieldMinimalPromptSuppressSections: "屏蔽 harness:identity / harness:source / app:web-surface 三个全局段（等同极简 complete persona 的效果；plan-mode 与 PTC 的 SDK 段不受影响）"
     };
     const en = {
       title: "Adaptive performance (adaptive-perf)",
@@ -94,7 +100,13 @@ window.__ModuleLoader__.load({
       bootstrapCompactionTools: "Post-compaction work set",
       fieldBootstrapCompactionTools: "Extra tools available after compaction/end until a new promotion signal (core work set). Comma-separated.",
       bootstrapMaxTokens: "First-request output cap (tokens)",
-      fieldBootstrapMaxTokens: "maxTokens cap for request #1, stripped after promotion; 0 = no cap (opt-in)"
+      fieldBootstrapMaxTokens: "maxTokens cap for request #1, stripped after promotion; 0 = no cap (opt-in)",
+      minimalPromptEnabled: "Minimal prompt layer (register anchor)",
+      fieldMinimalPromptEnabled: "Pull the system prompt back to the minimal register: suppress the global orientation sections and replace the persona. The reference's full anchoring condition — tool narrowing alone does not flip the thinking style (let me → let's/i'll/i need)",
+      minimalPromptPersona: "Persona text",
+      fieldMinimalPromptPersona: "Shadows deployment:persona by name; defaults to the exact minimal-mode text. Empty = keep the original persona",
+      minimalPromptSuppressSections: "Suppress global orientation sections",
+      fieldMinimalPromptSuppressSections: "Shadow harness:identity / harness:source / app:web-surface to empty (same effect as minimal's complete persona; plan-mode and the PTC SDK sections are unaffected)"
     };
 
     // ── 表单字段 ─────────────────────────────────────────────────────────
@@ -317,6 +329,27 @@ window.__ModuleLoader__.load({
               setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), maxTokens: Number.isSafeInteger(n) && n > 0 ? n : 0 } });
             }
           }),
+          react.createElement(BoolField, {
+            label: t("minimalPromptEnabled"),
+            hint: t("fieldMinimalPromptEnabled"),
+            value: draft === null ? false : (draft.minimalPrompt && draft.minimalPrompt.enabled === true),
+            disabled: draft === null,
+            onChange: (v) => setDraft({ ...draft, minimalPrompt: { ...(draft.minimalPrompt || {}), enabled: v } })
+          }),
+          react.createElement(BoolField, {
+            label: t("minimalPromptSuppressSections"),
+            hint: t("fieldMinimalPromptSuppressSections"),
+            value: draft === null ? false : (draft.minimalPrompt && draft.minimalPrompt.suppressSections === true),
+            disabled: draft === null || (draft.minimalPrompt && draft.minimalPrompt.enabled === false),
+            onChange: (v) => setDraft({ ...draft, minimalPrompt: { ...(draft.minimalPrompt || {}), suppressSections: v } })
+          }),
+          react.createElement(TextField, {
+            label: t("minimalPromptPersona"),
+            hint: t("fieldMinimalPromptPersona"),
+            value: draft === null ? "" : ((draft.minimalPrompt && draft.minimalPrompt.persona) || ""),
+            disabled: draft === null || (draft.minimalPrompt && draft.minimalPrompt.enabled === false),
+            onChange: (v) => setDraft({ ...draft, minimalPrompt: { ...(draft.minimalPrompt || {}), persona: v } })
+          }),
           react.createElement(Field, {
             label: t("families"),
             hint: familiesInvalid ? t("invalidFamilies") + (familiesError !== null ? " — " + familiesError : "") : t("fieldFamilies")

package/lib/index.mjs

@@ -42,7 +42,9 @@
  *   - agent.ctx.systemPrompt.suppressRuntimeContext()  抑制上下文快照
  *   - agent.ctx.tools.schemas(agent)  读取该 agent 当前可见工具（限制交集）
  *   - agent.ctx.tools.restrict({ deny })  按 agent 作用域裁剪继承工具
- *   - system-prompt/assemble（waterfall） 按会话阶段收窄装配后的工具目录
+ *   - system-prompt/assemble（waterfall） 请求装配（早期实现；bootstrap 目录
+ *       收窄改用 tools.restrict——PTC 模式下 assembly.tools 只有 run_code，
+ *       过滤会降级失效，而 restrict 同时驱动 API 目录与 PTC SDK 参考段）
  *   - agent/pre-step（waterfall） 剥离自动注入的上下文消息（source.kind）
  *   - agent/request（waterfall） 首轮输出预算封顶
  *   - session/event  增量喂入持久事件（晋升 / compaction 纪元）
@@ -141,6 +143,27 @@ export const DEFAULT_CONFIG = {
     /** 请求 #1 的输出预算封顶（token）；0 = 不封顶（opt-in）。 */
     maxTokens: 0,
   },
+  /**
+   * 极简提示词层（语域锚定，参照 dsh-anchored-standard 的完整条件）。
+   *
+   * 参考实现指出：首轮"轨迹"（思维链风格）锚定需要 **Minimal 的完整 system
+   * prompt**——只收窄工具 schema 不够。本层对目标 preset 的会话：
+   *   - suppressSections：按名阴影屏蔽全局引导段（harness:identity、
+   *     harness:source、app:web-surface），空段在装配时被丢弃，等同极简
+   *     complete persona 的效果（plan-mode 段、PTC 的 SDK 段不受影响）；
+   *   - persona：按名阴影替换 deployment:persona 为极简语域的短 persona
+   *     （默认与极简模式逐字相同；留空则不替换）。
+   * 两处都是 agent 作用域的 prompt 段阴影，仅影响目标会话，随会话销毁自动
+   * 释放；对已恢复/已晋升的旧会话同样生效（不依赖 bootstrap 阶段）。
+   */
+  minimalPrompt: {
+    /** 是否启用极简提示词层。 */
+    enabled: true,
+    /** 替换后的 persona 文本；与极简模式相同可完全对齐语域。留空不替换。 */
+    persona: 'You are a helpful software engineer assistant.',
+    /** 屏蔽全局引导段（identity / source / web-surface）。 */
+    suppressSections: true,
+  },
 };
 
 /** 轻量配置校验/归一化：非法字段回退默认值，避免 config.json 或 remote.set
@@ -201,6 +224,15 @@ export function normalizeConfig(source, defaults = DEFAULT_CONFIG) {
     compactionTools: stringListOrEmpty(rawBootstrap.compactionTools, db.compactionTools),
     maxTokens,
   };
+  const rawMP = raw.minimalPrompt !== null && typeof raw.minimalPrompt === 'object' && !Array.isArray(raw.minimalPrompt)
+    ? raw.minimalPrompt
+    : defaults.minimalPrompt;
+  const dm = defaults.minimalPrompt;
+  const minimalPrompt = {
+    enabled: boolValue(rawMP.enabled, dm.enabled),
+    persona: typeof rawMP.persona === 'string' ? rawMP.persona.trim() : dm.persona,
+    suppressSections: boolValue(rawMP.suppressSections, dm.suppressSections),
+  };
   return {
     enabled: boolValue(merged.enabled, defaults.enabled),
     presets: stringList(merged.presets, defaults.presets),
@@ -211,6 +243,7 @@ export function normalizeConfig(source, defaults = DEFAULT_CONFIG) {
     coreTools: stringList(merged.coreTools, defaults.coreTools),
     families,
     bootstrap,
+    minimalPrompt,
   };
 }
 
@@ -268,10 +301,37 @@ export function validateConfig(partial) {
       }
     }
   }
+  if (partial.minimalPrompt !== void 0) {
+    const m = partial.minimalPrompt;
+    if (m === null || typeof m !== 'object' || Array.isArray(m)) {
+      throw new TypeError('adaptive-perf config field "minimalPrompt" must be an object');
+    }
+    if (m.enabled !== void 0 && typeof m.enabled !== 'boolean') {
+      throw new TypeError('adaptive-perf config field "minimalPrompt.enabled" must be a boolean');
+    }
+    if (m.suppressSections !== void 0 && typeof m.suppressSections !== 'boolean') {
+      throw new TypeError('adaptive-perf config field "minimalPrompt.suppressSections" must be a boolean');
+    }
+    if (m.persona !== void 0 && typeof m.persona !== 'string') {
+      throw new TypeError('adaptive-perf config field "minimalPrompt.persona" must be a string');
+    }
+  }
 }
 
 // ── 纯函数（导出便于回归测试）────────────────────────────────────────────
 
+/** 被极简提示词层屏蔽的全局引导段（name, order，与 dsh-app-boot /
+ * dsh-web-app / dsh-system-prompt 的注册一致）。 */
+export const SECTION_SHADOWS = [
+  ['harness:identity', -100],
+  ['harness:source', -99],
+  ['app:web-surface', -98],
+];
+
+/** persona 段的注册名与顺序（dsh-system-prompt 的 PERSONA_SECTION/PERSONA_ORDER）。 */
+export const PERSONA_SECTION_NAME = 'deployment:persona';
+export const PERSONA_SECTION_ORDER = 0;
+
 /** 提取一条用户消息的顶层文本（text 块拼接）。 */
 export function extractUserText(message) {
   if (message === null || typeof message !== 'object' || !Array.isArray(message.content)) return '';
@@ -457,9 +517,32 @@ export function apply(ctx, config) {
       }
     }
 
+    /** 应用/更新极简提示词层（persona 阴影 + 全局引导段屏蔽）。 */
+    function applyMinimalPrompt(a) {
+      for (const disposer of a.promptDisposers) {
+        try { disposer(); } catch {}
+      }
+      a.promptDisposers = [];
+      if (!cfg.enabled || !cfg.minimalPrompt.enabled) return;
+      const sp = a.agent.ctx.systemPrompt;
+      try {
+        if (cfg.minimalPrompt.suppressSections) {
+          for (const [name, order] of SECTION_SHADOWS) {
+            a.promptDisposers.push(sp.section({ name, order, text: '' }));
+          }
+        }
+        const persona = cfg.minimalPrompt.persona.trim();
+        if (persona.length > 0) {
+          a.promptDisposers.push(sp.section({ name: PERSONA_SECTION_NAME, order: PERSONA_SECTION_ORDER, text: persona }));
+        }
+        info(`agent ${a.agent.id}: minimal prompt layer active`);
+      } catch (error) {
+        warn(`minimalPrompt failed for agent ${a.agent.id}: ${error && error.message || error}`);
+      }
+    }
+
     /** 应用/更新工具族限制（lean 模式）。总开关关闭、族被禁用、已升级、
-     *  已从配置删除的族一律放行。 */
-    function applyFamilies(a) {
+     *  已从配置删除的族一律放行。 */    function applyFamilies(a) {
       if (!cfg.enabled || !cfg.leanByDefault) {
         for (const [id, disposer] of a.familyDisposers) {
           try { disposer(); } catch {}
@@ -519,7 +602,10 @@ export function apply(ctx, config) {
       const a = {
         agent,
         suppressDisposer: null,
+        promptDisposers: [],
         familyDisposers: new Map(),
+        bootstrapDisposer: null,
+        bootstrapKey: null,
         escalated: new Set(),
         visibleNames: new Set(),
       };
@@ -536,7 +622,9 @@ export function apply(ctx, config) {
       }
       agents.set(agent.id, a);
       applySuppression(a);
+      applyMinimalPrompt(a);
       applyFamilies(a);
+      syncBootstrap(a);
       info(`agent ${agent.id}: adaptive-perf active (preset ${String(agentPresets.composedPreset(agent.ctx))})`);
     }
 
@@ -549,6 +637,13 @@ export function apply(ctx, config) {
       if (a.suppressDisposer !== null) {
         try { a.suppressDisposer(); } catch {}
       }
+      for (const disposer of a.promptDisposers) {
+        try { disposer(); } catch {}
+      }
+      a.promptDisposers = [];
+      if (a.bootstrapDisposer !== null) {
+        try { a.bootstrapDisposer(); } catch {}
+      }
       for (const disposer of a.familyDisposers.values()) {
         try { disposer(); } catch {}
       }
@@ -635,37 +730,60 @@ export function apply(ctx, config) {
       return isTarget(agent);
     }
 
-    // 持久事件增量喂入：晋升信号 / compaction 纪元。
+    /**
+     * bootstrap 阶段的保留工具集：bootstrap 工具对 + PTC 的直接调用工具
+     * （run_code）+ compaction 后恢复期的工作集。已晋升返回 null。
+     *
+     * 注意：不能靠过滤 system-prompt/assemble 的 assembly.tools 来实现——
+     * PTC 模式下 assembly.tools 只有 [run_code]，Minimal 工具对不在其中，
+     * 过滤会触发降级（实测首轮模型仍看到 15 个工具）。正确做法是
+     * tools.restrict（与族限制同一机制）：它同时驱动 API 目录和 PTC 的
+     * SDK 参考段，且天然保留 run_code（不在 deny 里）。
+     */
+    function bootstrapKeepSet(a) {
+      const phase = bootstrapPhaseOf(a.agent);
+      if (phase.promoted) return null;
+      const keep = new Set(cfg.bootstrap.tools);
+      if (a.visibleNames.has('run_code')) keep.add('run_code');
+      if (phase.boundary >= 0) for (const name of cfg.bootstrap.compactionTools) keep.add(name);
+      return keep;
+    }
+
+    /** 按当前阶段同步 bootstrap 的临时 restrict（幂等；仅阶段/配置变化时重挂）。 */
+    function syncBootstrap(a) {
+      const keep = bootstrapKeepSet(a);
+      const key = keep === null ? null : [...keep].sort().join(',');
+      if (key === a.bootstrapKey) return;
+      if (a.bootstrapDisposer !== null) {
+        try { a.bootstrapDisposer(); } catch {}
+        a.bootstrapDisposer = null;
+        a.bootstrapKey = null;
+      }
+      if (keep === null) return;
+      const deny = [...a.visibleNames].filter((name) => !keep.has(name));
+      if (deny.length === 0) return;
+      try {
+        a.bootstrapDisposer = a.agent.ctx.tools.restrict({ deny });
+        a.bootstrapKey = key;
+        info(`agent ${a.agent.id}: bootstrap restrict deny=${deny.length} keep=[${[...keep].join(',')}]`);
+      } catch (error) {
+        warn(`bootstrap restrict failed for agent ${a.agent.id}: ${String((error && error.message) || error)}`);
+      }
+    }
+
+    // 持久事件增量喂入：晋升信号 / compaction 纪元；阶段变化时同步 bootstrap 限制。
     ctx.on('session/event', (session, event) => {
       if (session === null || typeof session !== 'object' || typeof session.id !== 'string') return;
+      const before = bootstrapState.get(session.id);
       observePhase(bootstrapState, session.id, event);
-    });
-
-    // 请求装配时按阶段收窄工具目录。请求 #1（未晋升）：只保留 bootstrap
-    // 工具对（compaction/end 之后额外放行 compactionTools 核心工作集）；
-    // 已晋升：放行（leanByDefault 的族限制仍由 tools.restrict 生效）。
-    ctx.on('system-prompt/assemble', async (assembly, _context, next) => {
-      const resolved = await next();
-      try {
-        const agent = agentsService?.currentInitiator?.() ?? void 0;
-        if (!bootstrapActiveFor(agent)) return resolved;
-        const phase = bootstrapPhaseOf(agent);
-        if (phase.promoted) return resolved;
-        const keep = new Set(cfg.bootstrap.tools);
-        if (phase.boundary >= 0) for (const name of cfg.bootstrap.compactionTools) keep.add(name);
-        const filtered = filterBootstrapTools(resolved, keep);
-        if (filtered.missing.length > 0) {
-          // 目录缺失 bootstrap 工具对：降级为全目录（一次告警），绝不能
-          // 把每个请求都卡死在空目录。
-          warnBootstrapOnce(`bootstrap tools missing from catalog (${JSON.stringify(filtered.missing)}); exposing the full catalog`);
-          return resolved;
+      const a = agents.get(session.id);
+      if (a !== void 0) {
+        const after = bootstrapState.get(session.id);
+        if (before === void 0 || after === void 0 || before.promoted !== after.promoted || before.boundary !== after.boundary) {
+          syncBootstrap(a);
         }
-        return { ...resolved, tools: filtered.tools };
-      } catch (error) {
-        warnBootstrapOnce(`bootstrap tool filter failed, exposing the full catalog: ${String((error && error.message) || error)}`);
-        return resolved;
       }
-    }, { prepend: true });
+    });
 
     // 首轮剥离自动注入的上下文（技能目录提醒 / AGENTS.md 摘要）。prepend +
     // 根作用域注册保证是最后一道变换（后注册的注入者无法再补回）。
@@ -722,7 +840,9 @@ export function apply(ctx, config) {
         cfg = normalizeConfig({ ...patchConfig, ...merged });
         info('config hot-updated; recomputing restrictions for live agents');
         // 补挂此前创建的会话（例如插件从 disabled 切换为 enabled，或新增了
-        // 目标 preset）：新符合条件的 agent 立即接管。
+        // 目标 preset）：新符合条件的 agent 立即接管（handleAgent 已应用全部
+        // 层，下面的重算只针对此前已接管的 agent，避免同一 onUpdate 内重复）。
+        const existing = new Set(agents.keys());
         if (agentsService !== void 0 && typeof agentsService.list === 'function') {
           try {
             for (const agent of agentsService.list()) handleAgent(agent);
@@ -730,9 +850,13 @@ export function apply(ctx, config) {
             warn(`config-update agent sweep failed: ${error && error.message || error}`);
           }
         }
-        for (const a of agents.values()) {
+        for (const agentId of existing) {
+          const a = agents.get(agentId);
+          if (a === void 0) continue;
           applySuppression(a);
+          applyMinimalPrompt(a);
           applyFamilies(a);
+          syncBootstrap(a);
         }
       },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaoset/adaptive-perf",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "DSH host plugin: bring standard / PTC presets to minimal-mode-level performance via runtime-context suppression and adaptive tool-catalog trimming with demand-driven escalation",
   "type": "module",
   "license": "MIT",