前言¶

DeepSeek Harness（DSH）的插件化设计让智能体开发更灵活，但在 0.2.x 版本中，模型看到的工具定义、提示词分段和预设组合往往会膨胀，导致上下文占用过多。在 DSH 中，如果不做控制，工具清单、提示层和预设配置可能被持续累积，影响推理效率与成本。dsh-max-compact 插件的目标是：在不改变部署能力的前提下，减少模型需要感知的信息量。

插件定位¶

dsh-max-compact 是 DeepSeek Harness（DSH >= 0.2）的模型输入压缩插件，由 20genesis14-sys 维护，归类为「模型推理」。它通过五个机制实现输入瘦身：延迟工具发现、可编辑提示层与人格阴影、预设克隆、受控提示分段，以及 Ponytail 最小代码模式。所有功能默认为配置门控，未配置时保持静默。

核心功能¶

插件提供以下能力，均通过 /mc 命令集和配置项启用：

• 延迟工具发现（Lazy tool surface）
• 模型先看到一个较小的常驻工具表（文件系统、Shell、消息），其余工具隐藏在 mc_discover 后面，按需激活。
• 通过 /mc lazy on|off 切换整体开关，/mc lazy keep|hide|default <tool> 调整具体工具的可见策略。
• 激活的工具在会话中保持可见，可通过 /mc lazy release <tool> 或 reset 重新隐藏。

• /mc lazy list 显示当前会话中隐藏与激活的工具状态。

• 可编辑提示层与人格阴影（Editable prompt layer + persona shadow）

• 支持在系统提示词末尾追加自定义文本，可内联写入或通过外部 prompt.md 风格文件（每次步骤重新读取，mtime 缓存）。
• 使用 /mc prompt set <text...> 或 /mc prompt file <path|off> 指定内容。
• /mc prompt profile save|use|rm|list 对提示层进行命名配置管理。
• 支持按作用域限制：/mc prompt scope all|subagents|<id>，/mc persona scope all|subagents|<id>。

• 人格阴影通过 /mc persona set <text...> | off 为每个代理覆盖预设的人格前缀，不影响预设本身。

• 预设克隆（Preset composer）

• 通过 agentPresets.list() 查看完整预设清单（官方、外部、托管）。
• 使用 /mc preset clone <src> <newId> [name] 克隆任意预设为托管实例。
• /mc preset toggle <id> <row> [on|off] 切换克隆预设中某行的 disabled 标记，并重新注册。

• /mc preset rm <id> 卸载托管预设。

• 受控提示分段（Managed prompt sections）

• 通过 /mc section 列出受管分段。
• /mc section diet 一次性应用推荐的分段隐藏/阴影/修剪规则。
• 支持按作用域限定：/mc section hide <name>[,<name>…] [scope]、/mc section trim <name> <keep…>、/mc section scope <name> all|subagents|<id>[,<id>…]、/mc section off <name>|all [mode] [scope]。

• 这些规则独立于延迟工具开关，每次提示组装瀑布流都会应用。

• Ponytail 最小代码模式（Ponytail minimal-code mode）

• 默认激活一个冻结的 maxcompact:ponytail 基线分段。
• /mc pt 查看基线与当前生效状态。
• /mc pt lite|full|ultra|off 在当前会话切换 Ponytail 模式，/mc pt default <mode> 持久化基线设置。
• /mc pt skills 显示插件 vendored 的技能（来自 @wenaixi/dsh-ponytail）：ponytail-review、ponytail-audit、ponytail-debt。
• 模型可通过技能名称调用，也可直接触发技能。

所有功能在能力缺失时不会崩溃，而是通过 /mc status 诚实报告。

安装与启用¶

插件通过 npm 安装：

npm install dsh-max-compact
# 或直接从 GitHub 安装
npm install github:20genesis14-sys/dsh-max-compact

安装后，插件会挂载一个全局行 id: max-compact，默认仅启用 Ponytail 的 lite 基线，其他功能需通过配置或命令激活。要关闭默认基线，可设置 ponytailDefault: off 或使用 /mc pt default off。

典型用法¶

• 启用延迟工具发现：

  /mc lazy on
  /mc lazy list

模型会看到较小的常驻工具表，未激活的工具需要通过 mc_discover 请求。

• 为特定代理设置人格阴影：

  /mc persona set "你是一个专注于代码审查的助手。"
  /mc persona scope all

• 克隆预设并禁用某一行：

  /mc preset clone official-code-reviewer custom-reviewer
  /mc preset toggle custom-reviewer web_fetch on

• 使用提示文件作为提示层：

  /mc prompt file /path/to/prompt.md

• 应用推荐的分段隐藏规则：

  /mc section diet

• 在会话中切换 Ponytail 模式：

  /mc pt ultra
  /mc pt skills

适用场景与注意¶

• 适合需要控制模型输入大小、优化上下文成本、对预设与提示层有精细管理需求的 DSH 0.2.x 智能体开发场景。
• 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
• 所有配置项仅在启用后生效，未配置的功能保持静默，不会引入额外开销。

结语¶

dsh-max-compact 通过延迟发现、提示层编辑、人格阴影、预设克隆与受控分段，为 DSH 0.2.x 提供了一套紧凑输入方案，在不牺牲部署能力的前提下减少模型感知的信息量。更多信息与源码可访问：
- 目录页：https://www.skillhub.cn/plugins/20genesis14-sys/dsh-max-compact
- GitHub：https://github.com/20genesis14-sys/dsh-max-compact