dsh-maf：Microsoft Agent Framework (MAF) 的 DeepSeek Harness 插件

前言¶

DeepSeek Harness (DSH) 采用了「一切皆插件」的理念。Microsoft Agent Framework (MAF) 是微软当前的企业级 agent 编排框架（基于 Semantic Kernel，v1.0 已发布），核心能力在于 YAML 声明式的 agents 与 workflows。目前 MAF 没有内置的 DSH 适配。

dsh-maf 插件填补了这一空白，它通过原生 dsh 工具链，为开发者提供了一套工具，用于验证、运行和搭建 MAF 的 declarative agents 与 workflows。

核心功能¶

插件提供了以下五个核心工具：

maf_status：检查 MAF 包版本与环境状态。
maf_validate：校验 declarative agent YAML 文件（通过 AgentFactory 解析）。
maf_run_agent：运行 declarative agent（基于 YAML 定义和 prompt）。
maf_run_workflow：运行 declarative workflow sample（通过 main.py 执行）。
maf_scaffold：生成 agent 或 workflow 的 YAML 模板。

前置要求¶

在使用前，需要安装 MAF 相关的 Python 依赖：

pip install agent-framework agent-framework-declarative python-dotenv

Agent YAML 文件中的 model.id 通常引用环境变量（例如 =Env.OPENAI_CHAT_MODEL_ID），运行前需配置好 .env 文件或系统环境变量，填入 provider 密钥。

安装与启用¶

该插件通过 Cordis patch 的方式集成。在 profile 的 cordis.patch.yml 中添加以下配置：

- insert:
    - id: maf
      name: './src/index.js'
      config:
        pythonCmd: python
        enginePath: scripts/maf.py

然后执行安装命令：

pnpm dsh web --patch ./dsh-maf/cordis.patch.yml

配置项¶

在 cordis.patch.yml 的 config 节点下，可调整以下参数：

pythonCmd：Python 解释器路径，默认为 python。
enginePath：引擎脚本路径，默认为 scripts/maf.py。
timeoutMs：单次调用超时时间（毫秒），默认为 180000（3 分钟）。

典型用法¶

安装完成后，可以在 DSH 中直接调用工具。例如，检查环境并校验 YAML 文件：

maf_status
maf_validate ./agents/Assistant.yaml

已知限制¶

maf_run_agent 和 maf_run_workflow 会消耗配置的 provider API 额度。
declarative agents API 官方标注为 experimental，接口可能随版本变动。
输出原样返回，包含模型生成的内容。

结语¶

dsh-maf 让开发者能够利用 DSH 的工作流能力，直接管理 MAF 的声明式定义。该插件由 WODE25500 维护，采用 MIT 许可证。