前言¶

在 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