前言¶

在 DeepSeek Harness（dsh）里用 Standard 预设跑 DeepSeek V4 系列时，常见两类启动问题：V4 Pro 在完整工具目录下容易滑向 Let me 轨迹、能力打折；V4 Flash 在默认无引导时思考偏浅、动手偏快。社区已有两阶段锚定、Flash persona 路由等方案，但多针对单模型或单渠道，长会话 compaction、resume 之后也容易二次失锚。

Miraculous Standard 是 rinDBeans 维护的 agent-plane 预设，把 V4 Pro / Flash 与官方 API、opencode-go 四种组合收进同一套路由逻辑，用首请求 Minimal 锚定加晋升后模型感知目录，在不放弃 Standard 完整工具面的前提下稳定启动轨迹，并用 epoch 管理长会话漂移。本文基于 GitHub 仓库 README 与 SkillHub 目录页 整理安装与配置要点。该项目为社区实验，与 DeepSeek 官方无关。

这是什么¶

Miraculous Standard 面向 dsh 的 agent 预设插件（dsh-miraculous-standard，当前版本 2.0.0，MIT 许可证）。一句话定位：在不放弃 Standard 完整工具面的前提下，把 DeepSeek V4 Pro / Flash 的启动环境稳定到 RL 对齐状态，并用 epoch 管理防止长会话轨迹漂移。

它把「首请求精确锚定」与「完整 Standard 工具能力」拆开：首请求只暴露官方 Minimal 的真实工具对 bash + str_replace_editor，系统提示保持 Minimal 原文并剥离自动注入；待首个 durable tool/call 或 assistant/message 触发晋升后，再按模型开放对应工具目录。路径选择只看路由模型 id（/flash/i），不看 provider，避免官方 API 与 opencode-go 渠道差异造成行为漂移。

核心功能¶

双模型、双渠道统一¶

同一预设覆盖 DeepSeek V4 Pro / Flash × 官方 API / opencode-go 四种组合。forcePath 可设为 auto（默认）、pro 或 flash 钉死路径。

首请求字节级 Minimal 锚定¶

首个请求仅暴露 bash 与 str_replace_editor，系统提示保持 Minimal 原文，并剥离所有自动注入。README 将其描述为社区多轮实验下 V4 Pro 轨迹锚定较稳定的条件。

模型感知晋升目录¶

• Pro：晋升后保持最小常驻集（默认 5 件套：bash、str_replace_editor、dev_tool_search、skill_search、skill_load），重型工具经 dev_tool_search 按需解锁，避免全目录倾倒把轨迹拉回 standard-like。
• Flash：persona 主导、目录免疫；晋升后默认开放完整 Standard 目录（flashPromotedCatalog: full），也可改为 resident 模式。

统一 context-gate¶

未晋升时采用 claimed-baseline 门：只保留用户消息与用户技能手势，任何第三方插件、hook、runtime context 都不能污染首请求。suppressedContextSources 默认过滤 agent-instructions 与 skill-catalog，统一门控已覆盖未知来源。

非命令式 instruction-hint¶

晋升后的 AGENTS.md 提示改为「参考文档、按需查阅」的中性措辞。README 记载：命令式「read first and follow them」会把锚定轨迹打回 let me；中性措辞既能保住轨迹，又不丢失环境文档可用性。

epoch 感知长会话稳定性¶

• compaction 后自动回退受控阶段；
• dev_tool_search 解锁集合按 epoch 重置，防止长对话目录单调膨胀；
• instruction-hint / discipline hint 按 epoch 重发；
• 进程重启后通过 durable 日志扫描去重，避免重复注入。

rc.7 就绪与 Windows 工程化¶

• 同步官方 rc.7 的 subagent 配置（backgroundMode: one-shot）；
• 受益于官方持久 Bash 延迟修复（Linux/macOS 每次调用从秒级降到百毫秒级）与 max-token replay 修复；
• custom-bash 自动探测 Git for Windows 安装位置，将 Git Bash 路径 /e/foo 归一化为 E:\foo；显式 workdir 不可用时回退会话 cwd 并给出提示。

零额外运行时开销¶

无 warmup 轮、无 replay、无第三方运行时依赖；插件为 Node.js ESM .mjs，不发起网络请求，不采集遥测。

安装与启用¶

环境要求¶

• DeepSeek Harness 0.1.0-rc.7（rc.5 / rc.6 亦可运行，README 推荐 rc.7）；
• Windows 需安装 Git for Windows；
• DeepSeek 官方 API key，或 opencode-go 订阅。

安装¶

方式一：克隆仓库后复制 preset 目录。

git clone https://github.com/rinDBeans/dsh-miraculous-standard.git
# Windows PowerShell:
#   Copy-Item -Recurse .\dsh-miraculous-standard\preset "$env:USERPROFILE\.dsh\.agent-presets\miraculous-standard"
# Linux / macOS:
#   cp -r dsh-miraculous-standard/preset "${DSH_HOME:-$HOME/.dsh}/.agent-presets/miraculous-standard"

方式二：通过 bundle 安装（README 官方命令）。

dsh plugin --profile web add github:rinDBeans/dsh-miraculous-standard

安装后完全重启 dsh，新会话中选择 Miraculous Standard (Pro/Flash unified, experimental)。

模型配置¶

在 dsh 配置中指定 provider、模型与默认预设：

# DeepSeek 官方 API 或 opencode-go 订阅
agent-default-model:
  provider: deepseek            # 或 opencode-go
  model: deepseek-v4-pro        # 或 deepseek-v4-flash
  reasoningEffort: max          # 建议 max；至少 high
agent-presets:
  default: miraculous-standard

配置要点¶

配置位于 preset/agent.cordis.yml。常用键如下。

请求生命周期¶

用户首条消息
    │
    ▼
┌ 请求 #1 ─ bootstrap 阶段 ─────────────────────────────────────┐
│ tools   : bash + str_replace_editor（Minimal 真实 schema）     │
│ context : context-gate 默认拒绝未知注入                         │
│ persona : Pro = Minimal 原文 / Flash = 神模式五锚               │
│ budget  : adapter 默认（bootstrapMaxTokens 可选）               │
└───────────────────────────────────────────────────────────────┘
    │ 首个 durable tool/call 或 assistant/message
    ▼ 晋升（durable 事件派生，resume/reload 安全）
┌ 请求 #2+ ─ resident 阶段 ─────────────────────────────────────┐
│ Pro   : 常驻 5 件套 + 已解锁工具（可配 residentTools）          │
│ Flash : 完整 Standard 目录（默认；可配 resident）               │
│ context : 注入恢复；中性 instruction-hint 按需提示 AGENTS.md    │
└───────────────────────────────────────────────────────────────┘
    │ compaction/end
    ▼ 回退受控阶段：bootstrap 对 + compactionTools，直至新晋升信号

典型用法与验证¶

日常使用时，按上文配置 provider 与模型后启动新会话即可；Pro 与 Flash 由模型 id 自动路由，无需手动切换预设。

仓库提供冒烟测试，可在克隆后本地执行：

node test/smoke.mjs

README 记载测试覆盖双路径锚定、晋升目录、解锁、compaction 回退、epoch 解锁隔离、hint 每 epoch 一次、context-gate 未知注入拦截、resume 去重、降级路径；全部通过时输出 ALL PASS。

适用场景与注意¶

适合谁

• 在 dsh 上用 V4 Pro，希望避免 Standard 全目录导致的 Let me 轨迹失锚；
• 在 dsh 上用 V4 Flash，希望获得更深规划 persona，同时保留完整 Standard 能力；
• 长会话、compaction、subagent、resume 场景下需要 epoch 感知的目录与 hint 管理；
• Windows 环境需要 Git Bash 路径归一化与 custom-bash 回退。

已知限制

• 轨迹锚定机制 README 称有强复现，但能力增益在独立复现中仍属未决；应以任务完成度、token/耗时等结果指标为准。
• Flash 紧密相关的多轮修改链上，静态引导可能为负；可设 flashGuidance: false。
• Windows PTY：rc7 的 node-pty 升级不改变 Windows process inspector 缺失，仍使用 custom-bash（每次调用新进程）；可将 read/grep 加入常驻以减少 bash 调用。
• compaction 摘要质量、token 计量等属 dsh 宿主能力，不在本预设边界内。

安全提示

插件以当前 dsh 进程的权限运行。安装前建议阅读 GitHub 源码 与 MIT 许可证及 NOTICE 中的派生来源说明。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

Miraculous Standard 把 V4 Pro / Flash 在官方 API 与 opencode-go 上的启动轨迹收进同一套两阶段锚定与 epoch 管理，在保留 Standard 完整工具面的前提下处理首请求失锚与长会话漂移。若你正在 dsh 上跑 DeepSeek V4 系列并遇到上述启动或长会话问题，可按 README 安装并在 agent.cordis.yml 中按需调整晋升目录与 Flash persona。

• 目录页：SkillHub — dsh-miraculous-standard
• 源码：github.com/rinDBeans/dsh-miraculous-standard