前言¶

在官方 DeepSeek Harness（@deepseek-ai/dsh-agent-loop）上跑多轮智能体时，常见负担来自三方面：默认系统提示体量大、单轮里重复读改多个文件效率低、以及 Windows 环境下链式 shell 与无进展重试带来的超时或浪费。社区插件 dsh-awesome-optimizer 以非侵入方式挂接 DSH 流水线，在 cordis.patch.yml 默认可用前提下提供精简提示、PTC 复合批工具、防御性运行时策略与 A/B 遥测。下面按定位、能力、安装与配置说明如何使用。

这是什么¶

dsh-awesome-optimizer 由维护者 Jaylor-Wang 发布，在 SkillHub 目录中归类为「工作流」。项目自述为：面向官方 DeepSeek Harness 的高性能、非侵入式运行时策略、PTC 支持的复合批处理工具、独立精炼系统提示引擎（约 80% token 节省）以及客观的轮次 A/B 遥测插件。当前 npm 包版本为 1.5.0（MIT 许可证）；GitHub 仓库星标数为 2。

核心功能¶

精炼系统提示与文件驱动热重载（customPrompt）¶

插件在 DSH system-prompt/assemble 瀑布流中工作。placement: "replace-all" 模式下会剥离官方冗长区块（harness:*、deployment:*、tool:*、deliverable:*、web:* 等），以用户提供的 SYSTEM.md 作为独立权威来源。资料中的对比表写明：默认约 2000 tokens/轮可降至约 380 tokens/轮，约 82% 减量。

路径约定如下：

• 全局：~/.dsh/SYSTEM.md 或 $DSH_HOME/SYSTEM.md
• 工作区：项目内 .dsh/SYSTEM.md 或 SYSTEM.md

保存文件后通过 debounced fs.watch 在下一轮即时生效，无需重启 DSH。级联策略支持 concat（默认，全局与工作区拼接）与 workspace-override（仓库级完全覆盖全局）。另提供 lintPrompt / fixPrompt / lintPromptFile 等 API，并按已加载插件做工具指令校验。

PTC 原生复合批工具（compositeTools）¶

• read_batch：单轮内并发检视最多 10 个目标文件片段，适合多文件排查与依赖追踪。
• edit_batch：单轮内顺序执行最多 10 处字面替换，可跨文件；部分失败时保留已成功的前序编辑。参数语义与官方 edit 对齐（须先 file_path，再 old_string / new_string）。

子动作经官方 ToolExecutionPipeline（tool/ptc-dispatch-start / tool/ptc-dispatch）分发，继承文件策略锁、变更守卫与审计钩子。

防御性运行时策略与自愈（runtimePolicy / failureRecovery）¶

• NO_PROGRESS：对工具调用做确定性指纹；相同失败调用重复达到 noProgressLimit（默认 2）时在 tools/pre-execute 拦截。
• EMBEDDED_SHELL_PAYLOAD_TOO_LARGE：拦截超过 4096 字节的命令，或内联脚本（node -e、python -c、pwsh -Command）超过 512 字节的情形。
• CHAINED_NETWORK_COMMAND：阻止将网络/凭据类操作（如 npm publish）与本地操作在同一复合命令中链式执行；本地可用 && 链式，网络操作单独执行，以降低 Windows 进程挂起与 120s 超时风险。
• failureRecovery：在可用 edit 时抑制对大文件的破坏性 write 覆盖；大尺寸 write 因未配对 justification 被拒时，可注册 retry_failed_write 做一次性恢复。

v1.5.0 起强化 RFC 2119 限制性措辞（如 NEVER、ONLY）在引导与拦截原因中的一致性；edit_batch schema 与官方 edit 契约对齐。

轻量收敛与 A/B 遥测（convergence / telemetry）¶

• convergence：在接近步数预算间隔（默认 stepInterval: 8，每轮最多 4 条）时追加软性收敛提示；调试场景下可抑制以免打断排错。
• telemetry：采集模型请求、工具调用、复合并行比（parallelismRatio）、首 token 时延（TTFT）、token 消耗与前缀缓存稳定性（prefixChanges）等指标。

安装与启用¶

通过 DSH 插件命令（推荐）¶

将插件加入当前 web profile：

dsh plugin --profile web add dsh-awesome-optimizer

通过包管理器¶

npm install dsh-awesome-optimizer

或：

pnpm add dsh-awesome-optimizer

安装后优化项默认全部开启，无需在全局 cordis.patch.yml 中额外写配置。运行环境要求：node >= 22.0.0，dsh >= 0.2.2-rc.1。

仅在自定义路径或关闭子系统时，再在 cordis.patch.yml 中声明覆盖，例如：

- id: agent-optimizer
  config:
    customPrompt:
      enabled: false
    compositeTools:
      maxBatchFiles: 15
      maxBatchEdits: 15
    runtimePolicy:
      noProgressLimit: 3

典型用法¶

1. 安装插件后保持默认配置，即可同时获得运行时策略、批工具与提示优化（若使用 replace-all，在 ~/.dsh/SYSTEM.md 或项目 .dsh/SYSTEM.md 编写规则）。
2. 多文件阅读：在 agent 轮次中调用 read_batch，一次提交最多 10 个片段请求。
3. 多文件小步编辑：使用 edit_batch 集中提交替换列表，由流水线顺序执行并保留部分成功结果。
4. 需要恢复官方冗长系统提示时，在 cordis.patch.yml 将 customPrompt.enabled 设为 false。

README 中还提供面向生产的 SYSTEM.md 推荐（截断前可见），完整正文见仓库 README.zh.md。

适用场景与注意¶

适合：长期在官方 DSH agent loop 上开发、希望压低每轮系统提示 token、需要 read_batch / edit_batch 减少往返，或在 Windows 上希望降低链式 shell 与超大内联脚本风险的团队与个人。

注意：

• 插件与 DSH 同进程、同权限运行；安装前请阅读 GitHub 源码 与 MIT 许可证，确认策略拦截与批处理上限符合你的安全与合规要求。
• SkillHub（https://www.skillhub.cn/plugins/Jaylor-Wang/dsh-awesome-optimizer）为社区目录，与 DeepSeek / 幻方无官方从属关系；版本与配置以仓库与 npm 为准。
• token 节省比例、测试通过数（资料标明 21 passed）来自项目自述，实际会话仍取决于模型、插件组合与 SYSTEM.md 内容。

结尾¶

dsh-awesome-optimizer 把精简提示、PTC 批工具、运行时断路器与遥测收敛到单一 DSH 插件中，默认零配置即可启用。查阅目录与源码：

• 目录页：https://www.skillhub.cn/plugins/Jaylor-Wang/dsh-awesome-optimizer
• GitHub：https://github.com/Jaylor-Wang/dsh-awesome-optimizer