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 代理提供了一个结构化的问题处理框架。它通过常驻引擎和严格的规则层，帮助代理在解决复杂问题时保持认知的清晰与轨迹的可追溯。