MetaFlywheel：DSH 插件，提供元問題建模（MPM）認知飛輪引擎

DSH（DeepSeek Harness）插件體系旨在通過組合行插件擴展代理能力。對於構建需要嚴謹推理路徑和問題管理的 LLM 代理，MetaFlywheel 提供了一個常駐的認知引擎，將元問題建模（MPM）理論轉化爲可運行的代碼邏輯。

MetaFlywheel 是元問題建模（MPM）認知飛輪的 LLM 代理運行時實現。它不是獨立的 npm 包，而是 DSH 宿主的 Cordis 組合行插件。其核心價值在於將問題方法論論文轉化爲一個常駐引擎，負責持續記賬、自主審議和引導問題解決。

核心能力¶

插件提供了一套完整的問題生命週期管理機制：

六階段問題生命週期：問題經歷生成（G）、界定（F）、求解（S）、收斂（C）、沉積（D）、激發（E）六個階段，構成螺旋上升的認知飛輪。
雙重收斂判據：區分”理解對問題”（δ）與”解達到目標”（ε），識別誤界定收斂、模糊收斂等類型，並處理三種不可判定情形。
代謝賬本與總賬原則：每次工具調用自動累積代謝代價，無在輪題的賬外調用會被工具級門禁攔截。
導師規則層：包含證據門禁、誤界定守衛、總賬硬門禁、停滯擇題等規範性執行機構。
常駐巡檢：定時檢測陳舊問題、停滯狀態及量化漂移信號，並在睡眠期掛賬延遲交付。
個體層五塊磚：
- 委託人的思考方式：記錄判斷原話與約束對象，支持時間戳覆蓋與震盪守衛。
- 未核清單：跨代存活，必須寫退役條件，覈銷需帶證據。
- 命中迴流：記錄每次命中與處置，未處置數必須可見。
- 內生議程：基於賬本狀態計算”該做什麼”，級別爲 L2。
- 採用迴流：記錄真的採用行爲，與事後補鏈分開計算迴環率。

安裝與啓用¶

插件依賴 DSH 宿主環境。安裝後需重啓宿主使引擎生效。

一鍵安裝¶

推薦使用官方安裝腳本（需網絡連通 GitHub）：

# Windows PowerShell
irm https://raw.githubusercontent.com/NBagent-dev/metaflywheel/main/install/install.ps1 -OutFile install-mfw.ps1; .\install-mfw.ps1

手動掛載¶

複製引擎文件到用戶配置目錄：
- engine/host.js → ~/.dsh/mpm/engine/host.js
- install/cordis.patch.user.example.yml → ~/.dsh/mpm/cordis.patch.user.yml
編輯組合補丁文件，插入引擎行：

    - insert:
      - id: mpm-flywheel
        name: file:///<你的HOME>/.dsh/mpm/engine/host.js

同步引擎（若需更新）：運行 powershell -ExecutionPolicy Bypass -File install/sync-engine.ps1。

Bundle 形態¶

插件自 v0.1.1 起支持 DSH Bundle 契約：

dsh plugin add metaflywheel

啓用後，插件向系統注入 16 個工具，包括 mpm_generate（生成）、mpm_frame（界定）、mpm_solve（求解）、mpm_converge（收斂）等。

典型用法與配置¶

安裝成功後，可通過以下方式驗證疊加結果：

# 檢查配置疊加情況
dsh --dump-default-config

插件以 mpm-flywheel 爲 ID 註冊。若使用組合補丁掛載，需確保路徑正確。插件會自動向系統提示注入自我快照，包括問題狀態、代謝摘要及個體層五塊磚數據。

適用場景與注意¶

適用場景：需要嚴格區分”理解問題”與”解決問題”的複雜代理任務，或需要記錄代理決策依據與反思過程的工作流。
已知限制：
- 多工作區歸屬（C1）：狀態根目錄在多工作區場景下較脆弱，建議使用 mpm_setroot 顯式修正。
- 會話連續性（C2）：GUI 重載可能導致狀態與會話解耦。
- 常數均爲 v0 佔位：巡檢、節流等時間常數需根據實測史滿窗後導出替換。
- S(t) 爲序數代理：僅用於趨勢判斷，絕對值無義。
- 平臺依賴：開發與實測環境爲 Windows (PowerShell 5.1) + DSH 宿主。

結語¶

MetaFlywheel 爲 DSH 代理提供了一個結構化的問題處理框架。它通過常駐引擎和嚴格的規則層，幫助代理在解決複雜問題時保持認知的清晰與軌跡的可追溯。