前言¶

在机器学习项目的开发与迭代中，模型或 Agent 经常会声称“已完成数据处理”或“模型已收敛”，但往往缺乏切分检查、泄漏验证、指标文件或验证脚本留下的客观证据。这种依赖口头陈述的状态管理容易导致返工或质量失控。

DeepSeek Harness 的机器学习阶段闸门插件通过将 ML 项目拆分为 M0–M8 阶段，将状态管理从“模型自述”转变为“证据驱动”。插件读取项目当前声明的阶段，执行项目提供的验证脚本，并根据检查结果和工件状态计算真实阶段、差距与下一出口，最终在 DSH 界面中直观展示。

这是什么¶

这是一个为 DeepSeek Harness (DSH) 设计的机器学习阶段闸门插件，由开发者 lerqian883-alt 维护。

插件的核心价值在于提供一套可验证的流程管理机制。它不替用户编写 ML 代码，也不凭空判断阶段完成，而是依赖用户提供的验证脚本和工件。通过读取项目状态、执行检查并计算证据，它让“做到哪一步”有据可查。

插件遵循 MIT 许可证。

核心功能¶

1. 阶段管理：将 ML 项目拆分为 M0–M8 阶段进行管理。
2. 状态读取：读取项目当前声明的阶段。
3. 验证执行：执行项目提供的验证脚本和检查脚本。
4. 证据计算：根据证据计算真实阶段、差距和下一出口。
5. 界面展示：在 DSH 界面显示阶段轨道和审计信息。
6. 命令行工具：提供 ml_phase_status、ml_phase_phases、ml_phase_advance、ml_phase_defer 等命令。
7. 项目引导：支持通过 bootstrap 创建标准化的项目结构。
8. 跨平台支持：支持 verify.cmd、verify.ps1、verify.mjs、verify.sh 作为验证入口。

安装与启用¶

安装前需确保环境已安装 Node.js 20 或更高版本。

使用 DSH 的 profile（例如 web）将插件链接到本地目录：

dsh plugin --profile web add link:"$PWD"

安装完成后，可通过以下命令确认插件已注册：

dsh --profile web --dump-config

典型用法¶

1. 初始化项目结构
   在项目目录下执行引导脚本，生成标准的 .dsh-ml-phase、work 和 outputs 目录：

    node scripts/bootstrap-project.mjs --root <path> --template standard

2. 启动 DSH
   进入项目目录并启动 DSH：

    dsh --profile web

3. 查看当前状态
   在 DSH 中使用命令查看当前声明的阶段、证据证明的阶段、差距以及下一阶段：

    ml_phase_status

4. 查看阶段定义
   查看阶段定义和证据判定结果：

    ml_phase_phases

5. 推进阶段
   当所有检查和工件通过后，使用命令推进阶段：

    ml_phase_advance

6. 记录延期
   需要人工延期时，记录原因：

    ml_phase_defer reason="等待外部数据确认"

适用场景与注意¶

该插件适用于需要严格阶段管理和证据追踪的机器学习工作流。

• 依赖用户脚本：插件不会编写 ML 代码，必须由用户提供符合约定的验证脚本。
• 退出码约定：验证脚本的退出码约定为 0=pass, 1=fail, 2=skip，其他值为 error。
• 配置默认值：默认配置 watchAutoRun 为 false，文件变化不会自动执行脚本，需手动触发。
• 安装兼容性：不同版本的 DSH 可能存在安装语法差异，请以当前版本帮助为准。
• 运行权限：插件以当前 DSH 进程的权限运行，请确保安装前已检查源码与许可证。

结尾¶

通过将阶段闸门从主观描述转变为客观检查，该插件为 DeepSeek Harness 下的机器学习项目提供了一种更严谨的开发流程保障。更多实现细节与文档可参考项目源码。