DeepSeek Harness 插件

dsh-maf

Microsoft Agent Framework (MAF) integration for DeepSeek Harness: validate, run and scaffold declarative agents and workflows defined in YAML, through native dsh tools.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
WODE25500/dsh-maf
最近更新
2026年8月20日
分类
自动化与任务
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-21

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/WODE25500/dsh-maf
插件名:dsh-maf
作者:WODE25500

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-maf

Microsoft Agent Framework (MAF) 的 DeepSeek Harness (dsh) 插件 —— 让 dsh 智能体验证、运行和搭建 MAF 的 declarative agents / workflows(YAML 声明式定义)。

> 独立社区项目,非官方。基于 microsoft/agent-framework(MIT)。 > MAF 是 Semantic Kernel 的企业级继任者(v1.0 已发布)。

为什么做

MAF(13k★,Python/.NET)是微软当前的 agent 编排框架,没有 DSH 适配。它的核心是 YAML 声明式 agent/workflow——正好适合 agent 生成、验证和运行:

工具行为
maf_statusMAF 包版本 + 环境检查
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 模板

前置要求

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

Agent YAML 的 model.id 常引用环境变量(=Env.OPENAI_CHAT_MODEL_ID), 运行前配置好 .env / 环境变量(provider 密钥)。

安装

# 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

然后问 agent:"maf_status 检查环境,maf_validate 校验 ./agents/Assistant.yaml"。

引擎实现

scripts/maf.py 包装 MAF SDK:

  • AgentFactory(safe_mode=False).create_agent_from_yaml_path(path)await agent.run(prompt)
  • workflow 用 python main.py 标准 sample 布局(workflow.yaml + main.py)

配置项

默认说明
pythonCmdpythonPython 解释器
enginePathscripts/maf.py引擎脚本路径
timeoutMs180000单次调用超时(agent 运行可能较慢)

已知限制

  • maf_run_agent / maf_run_workflow 消耗配置的 provider API 额度
  • declarative agents API 官方标注为 *experimental*(可能变动)
  • 输出原样返回(含模型生成内容)

目录结构

dsh-maf/
  src/index.js            # 5 个工具 + 配置
  scripts/maf.py          # MAF SDK 引擎(status/validate/run/scaffold)
  skills/maf/SKILL.md
  docs/
  cordis.patch.yml

许可

MIT。