@chaoset/adaptive-perf — DSH 极简性能自适应插件

> 默认策略（0.7.0，首轮锚定、晋升后 resident 目录）：只提高性能，不减少功能。 > 非极简模式会话的请求 #1 按极简模式条件组装——真实 Minimal 工具对 > 锚定首轮轨迹、极简 persona + 屏蔽全局引导段对齐语域、剥离技能目录/指令 > 摘要注入、抑制运行时快照；首个持久晋升信号（首个 tool/call 或 > assistant/message）后进入 resident 阶段——保留 bootstrap 工具对 + > 常驻发现工具（dev_tool_search / skill_search / skill_load），完整 > 目录经 dev_tool_search 按需解锁，常规上下文注入恢复可见（与 > dsh-anchored-standard > 语义一致：晋升按会话记忆化，compaction 不重置；晋升时一次性倒出完整目录 > 会把轨迹拉回 standard-like，故完整目录按需取用）。工具目录默认零裁剪 > （编排类工具族始终可用）；leanByDefault 是省 token 的 opt-in 开关， > suppressInjectedContext 默认开启（注入剥离由发现工具承担可见性）， > 设置页按需调整。

让 标准模式（standard）、PTC 模式（code） 与 创造模式（cordis） 达到 极简模式（minimal） 级别的高性能，同时保留完整能力——不是静态裁剪， 而是动态自适应：

• 真实 Minimal 工具对（realPair）：首轮"轨迹"由请求 #1 可见的工具 schema

逐字决定——只有与 Minimal 完全相同的 schema 能锚定（参照 dsh-anchored-standard 实测：真实工具对 5/5 锚定，任何 standard 系 schema——包括 sandboxed bash/read——11/11 落入 standard-like）。本插件把官方 minimal preset 同款插件 （持久 PTY bash + str_replace_editor，含逐字相同的描述）挂进会话作用域， 按名阴影 standard 的 sandboxed bash——不是只把目录收窄到同名工具。

• 首轮锚定（bootstrap）：决定首轮"轨迹"（思维链风格）的是请求 #1 可见的

工具 schema 与自动注入的上下文提醒。因此： - 请求 #1 的工具目录 = 真实 Minimal 工具对（bash + str_replace_editor）； - 请求 #1 剥离自动注入上下文（技能目录提醒 skill-catalog、AGENTS.md 摘要 agent-instructions，用户主动的技能手势不过滤）； - 会话出现首个持久晋升信号（首个 tool/call 或 assistant/message， promoteOn 可选 either/tool-call/assistant-message）后进入 resident 阶段：保留 bootstrap 工具对 + 常驻发现工具（0.7.0 语义： 只锚定首轮，不减少后续功能；完整目录经 dev_tool_search 按需解锁—— 晋升时一次性倒出完整目录会把轨迹拉回 standard-like，anchored-standard 实测的"晋升后回退"问题），常规注入（技能目录提醒 + AGENTS.md 摘要） 恢复可见；阶段从持久会话事件推导，resume / reload 不丢状态，晋升 信号持久（compaction/end 不重置，与 dsh-anchored-standard 一致）； - maxTokens > 0 时可给请求 #1 封顶输出预算（晋升后自动剥离）。

• 常驻上下文抑制（suppressInjectedContext，默认开启）：整个会话持续

剥离技能目录提醒 + AGENTS.md 摘要注入——实测晋升后恢复注入会把轨迹拉回 standard-like（"Let me…" 叙述回归），且每请求多耗数千 token。功能可见性 由常驻发现工具承担：dev_tool_search 搜索完整目录并按名解锁、 skill_search / skill_load 按需搜索/加载技能说明。设为 false 时只剥 离请求 #1，晋升后恢复常规注入（功能不减少但轨迹回退，opt-in）。

• 运行时上下文抑制：对目标 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.）； - 挂载真实工具对时按名阴影 tool:bash 引导段（与可见工具一致）。 各处均为 agent 作用域的 prompt 段阴影，仅影响目标会话；对已恢复/已晋升的 旧会话同样生效（不依赖 bootstrap 阶段）。

• 工具目录自适应精简（leanByDefault，0.7.0 起为 opt-in）：默认 false =

工具目录零裁剪，编排类工具族（子代理 / 工作流 / ralph / goal）始终可用。 设为 true 时会话启动按"工具族"隐藏高开销低频工具，只保留核心编码工具 （bash / 文件读写编辑 / 检索 / jobs / todo / 提问 / 网页搜索 / 技能 / 计划）， 标准模式的工具目录因此逼近极简；PTC 模式系统提示里的 SDK 参考段同步缩小。

• 需求信号自动放行（会话内单调升级，只升不降，限制请求缓存失效次数）：

- 关键词信号：用户消息命中工具族触发词（如"子代理"、"工作流"）→ 放行该族； - 失败信号：PTC 程序调用被隐藏工具报 UNKNOWN_TOOL → 放行该族，下次即可调用。

所有开关与工具族可在设置页配置、随时放行；配置保存后热生效（无需重启）。

为什么极简模式最快（源码对照 + 社区实测结论）

安装（npm 生态方式）

本包是 DSH bundle：自带 cordis.patch.yml，使用 dsh plugin 安装后会 自动加入 profile 的 dsh.profile.bundles，无需手改 cordis.patch.yml。

> 给 AI agent：直接执行下面的 dsh plugin ... 命令即可，不要手动编辑 cordis.patch.yml。

# 安装到默认 web profile
dsh plugin --profile web add @chaoset/adaptive-perf

# 指定其他 profile
dsh plugin --profile tui add @chaoset/adaptive-perf

# 卸载
dsh plugin --profile web remove @chaoset/adaptive-perf

也可以从其他来源安装：

• GitHub：如果该包有独立 Git 仓库或 Release tarball，可用

dsh plugin --profile web add github:owner/repo 或 dsh plugin --profile web add https://github.com/owner/repo/releases/download/v1.0.0/adaptive-perf.tgz

• 镜像站：dsh plugin --profile web add @chaoset/adaptive-perf --registry=https://registry.npmmirror.com

更完整的说明见仓库根目录 README.md 的「安装来源」。

安装后重启 harness 生效（或等待 DSH 对配置层变更的响应）。

配置

生效顺序（后者覆盖前者）：

1. 插件内置默认值 2. bundle patch 中 cordis.patch.yml 的 config 3. 用户 profile/home 的 cordis.patch.yml 覆盖 4. DSH 设置页 → 插件配置 → 极简性能自适应（保存到 $DSH_HOME/plugins/adaptive-perf/config.json，立即热生效）

bootstrap（首轮锚定）：

{
  "enabled": true,
  "realPair": true,
  "tools": ["bash", "str_replace_editor"],
  "promoteOn": "either",
  "suppressedContextSources": ["skill-catalog", "agent-instructions"],
  "discoveryTools": ["dev_tool_search", "skill_search", "skill_load"],
  "maxTokens": 0
}

• realPair（0.5.0）：把官方 minimal preset 同款插件（持久 PTY bash +

str_replace_editor）挂进会话作用域，按名阴影 standard 的 sandboxed bash——请求 #1 的 schema 与 Minimal 逐字相同（只有逐字相同的 schema 能 锚定）。依赖 @deepseek-ai 官方插件包（optionalDependencies）；缺失或 Windows（无 PTY 后端）时自动降级为"仅收窄目录"并告警。

• tools：请求 #1 可见的工具（真实 Minimal 对）。
• promoteOn：either（默认）/ tool-call / assistant-message。
• suppressedContextSources：首轮剥离的自动注入 source.kind；[] 关闭剥离。
• discoveryTools：晋升后 resident 目录的常驻发现工具——dev_tool_search

（搜索完整目录并按名解锁，解锁结果下一请求生效且会话内保持）、 skill_search / skill_load（无门控，按需搜索/加载技能说明，替代常驻 ~9KB 技能目录）。

• maxTokens：请求 #1 输出预算封顶（0 = 不封顶，opt-in）。

> 0.7.0 破坏性变更：移除 skillDiscovery / instructionHint / > bootstrap.compactionTools 三个字段（resident 语义下不再需要： > dev_tool_search 常驻提供按需发现，无压缩回退、无指令提示补偿）； > bootstrap.discoveryTools 恢复为 resident 目录的常驻发现工具 > （默认 dev_tool_search / skill_search / skill_load）。已保存的旧配置 > 会自动忽略被移除字段。

minimalPrompt（极简提示词层，0.4.0 新增）：

{
  "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 阶段）；配置保存后热生效。

默认工具族（可整族禁用、改名、增删触发词）：

{
  "delegation": { "tools": ["subagent", "subagent_fork", "send_message", "list_agents", "interrupt_agent"], "keywords": ["子代理", "子agent", "委托", "分派", "subagent", "delegate"] },
  "workflow":   { "tools": ["workflow"], "keywords": ["工作流", "workflow", "编排"] },
  "ralph":      { "tools": ["ralph"], "keywords": ["ralph"] },
  "goal":       { "tools": ["create_goal", "get_goal", "update_goal"], "keywords": ["长期目标", "跨轮次", "goal"] }
}

> 工具名只在目标 preset 目录中实际存在时才被隐藏（运行时取交集），preset > 升级改名/删除工具不会导致插件报错；tools.restrict() 的限制按 agent 作用域 > 生效，子代理同样遵循自适应策略（其自身注册的委托机制工具不受影响）。

实现要点

• 监听 host 根作用域的 agent/created / agent/disposed / agent/inbox/inserted

/ tools/result（与 dsh-agent-presets 自身同款事件用法），按 agentPresets.composedPreset(agent.ctx) 识别目标 preset

• 真实工具对：agent.ctx.plugin() 把 dsh-terminal + dsh-terminal-bash

+ dsh-tool-bash-persistent（Minimal 逐字描述）+ dsh-fs-local + dsh-tool-str-replace-editor 挂进 agent 作用域；scoped registration 按名 阴影继承的 sandboxed bash，且 view() 对 own layer 豁免 restrict——首轮 目录 = 真实工具对 + 被 deny 的其他继承工具；每个挂载是独立 fiber， agent 销毁/插件卸载/配置关闭时全部撤销

• 限制通过 agent.ctx.tools.restrict({ deny }) 逐族注册：多族限制自动取交集，

升级 = 释放该族 disposer（单会话单调、一次性目录变化，缓存失效有界）

• 发现工具（dev_tool_search / skill_search / skill_load）同样注册在

agent 作用域：已解锁工具写入会话状态并重算 deny 集；技能经宿主 skills 服务按 agent scope 查询，skill_load 用 agent.inject 以 skill-invocation 来源注入（用户技能手势同款，不被默认抑制集剥离）

• 上下文剥离与 instruction-hint 都在 agent/pre-step（prepend 注册，最后

一道变换）：剥离失败绝不吞用户上下文；指令文件探测走宿主 fs，失败不注入

• 会话启动/插件重载时用 tools.schemas(agent) 记录可见目录，限制与之取交集
• 全部副作用（抑制器、限制、工具注册、提示段、监听）随 agent 销毁或插件

卸载自动释放

• fail-safe：插件任何内部错误只记日志，不拖垮 harness；官方插件包缺失

时自动降级