跳到正文
阿里雲開發者社區 AI·· 8 小時前AI 評分54

DeepSeek Harness 常用插件清單與 Agent 工作流示例

DeepSeek Harness 常用插件清单和 Agent 工作流示例

AI 導讀

DeepSeek Harness(DSH)指南整理了在阿里雲 ECS 的部署步驟、常用插件清單和 Agent 工作流示例。文中列出 dsh-market、modlens 等插件,並示範多 Agent 協作、條件分支工作流及自訂 Skill。截至 2026 年 10 月中旬,文中稱其 GitHub Star 超過 24 萬,社區插件超過 1600 款。

正文

2026-11-19 8

版权

版权声明:

本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

简介: DeepSeek Harness(DSH)是DeepSeek AI开源的智能体运行框架,MIT协议,采用“一切皆插件”架构,由Cordis引擎驱动。GitHub Star超24万,插件生态超1600款。本文详解阿里云一键部署、常用插件及Agent工作流实战。

DeepSeek Harness(简称 DSH)是 DeepSeek AI 以 MIT 协议开源的智能体运行框架,采用"一切皆插件"的架构设计,由 Cordis 引擎驱动。模型调用、代码读写、终端执行、会话记忆、界面渲染……所有能力都可以通过插件自由组合。截至 2026 年 10 月中旬,其 GitHub Star 数已突破 24 万,社区插件生态超过 1600 款。

DeepSeek Harness.jpeg

本文将从阿里云一键部署教程、常用插件清单和Agent 工作流示例三个部分,带大家从零搭建属于自己的 AI 工作台。


一、阿里云 DeepSeek Harness 一键部署教程

将 DSH 部署到阿里云 ECS 上,可实现 7×24 小时云端运行、多设备同步和团队协作。整个流程只需三步,约 3 分钟即可完成。

第一步:获取阿里云百炼 API Key

  1. 登录 阿里云百炼大模型服务平台,右上角选择目标地域(每个地域 API Key 独立,不可跨域混用)。
  2. 点击"创建 API Key",密钥仅显示一次,务必立即复制保存。
  3. 同时复制 Base URL,后续配置模型时需要用到。

新用户完成实名认证后可领取免费 Token 额度,覆盖千问系列、DeepSeek 等主流模型,零成本即可启动。

第二步:计算巢一键部署

  1. 打开 阿里云计算巢 DeepSeek Harness 社区版一键部署服务平台,搜索"DeepSeek Harness"。
  2. 选择部署模板,配置以下参数:
参数 建议值
地域 与百炼 API Key 地域保持一致
付费类型 按量付费(测试)/ 包年包月(长期使用)
实例规格 最低 1 核 2G;多模型并发建议 2 核 4G 以上
实例密码 自行设置并妥善记录
  1. 确认订单,点击"立即创建",等待约 3 分钟资源交付完成。
  2. 在服务实例详情页的"输出"区域,点击 安全代理访问地址 即可打开 Web UI(默认端口 3080)。

安全亮点:计算巢安全代理基于实例输出地址访问,ECS 安全组仅放行安全代理出口网段,无需手动开放端口,安全性极高。

第三步:配置模型与工作区

  1. 打开 Web UI 后,点击左下角 设置 → Models / 模型。
  2. 点击"添加提供方",可选择:
    • DeepSeek 官方模型:填入 DeepSeek API Key
    • 阿里云百炼千问系列:填入百炼的 Base URL 和 API Key(推荐 Qwen3.8-Max / Qwen3.8-Flash)
  3. 勾选目标模型,点击"添加所选"并保存。
  4. 返回主页,点击 选择工作区,指定 Agent 可操作的目录。

配置完成后,即可开始对话、安装插件、创建工作流。


二、常用插件清单

以下插件按用途分类,均为社区中热度较高、实用性较强的代表。插件生态迭代极快,安装前建议核对版本兼容性和更新时间。

生态入口类

插件名称 核心能力 安装命令
dsh-market 插件市场,支持搜索、安装、升级、主题管理和配置备份还原 dsh plugin --profile web add dshmarket

新手第一步强烈推荐先装这款,后续所有插件几乎都可以从市场内一键安装,免去逐个翻 GitHub 的麻烦。

能力补全类

插件名称 核心能力 安装命令
modlens 图片 OCR、版面解析、截图识别,补齐视觉短板 npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.25.2
dsh-at-file @ 快速调取本地文件和目录,替代手动复制粘贴 dsh plugin --profile web add FSMargoo/dsh-at-file
dsh-web-search-pro 聚合 DeepSeek、Bing、Exa 等多源搜索,支持知乎/B站定向爬取 见插件市场
OpenViking 长期记忆系统,跨会话保存项目背景与个人偏好 见插件市场

界面体验类

插件名称 核心能力 安装命令
dsh-web-all 全功能控制台:任务看板、Git 图谱、Token 统计、桌面宠物 dsh plugin --profile web add @linxin666/dsh-web-all@latest
dsh-better-sidebar 侧边栏工作台:文件树、内置终端、Git 面板、子代理状态监控 dsh plugin --profile web add dsh-better-sidebar@latest

场景专属类

插件名称 核心能力 安装命令
dsh-agent-teams 多智能体团队,任务拆分、子 Agent 协同与调度 见插件市场
dsh-cost-meter 实时费用监控,峰谷电价切换前自动提醒 见插件市场
dsh-session-library 本地文档混合检索、PDF 长文自动精读拆解 见插件市场(替代工具:1-CellBio/dsh-okf)

三、Agent 工作流示例

1. 多智能体编排配置

DSH 支持在配置文件中声明多 Agent 团队,每个 Agent 只负责一个职责边界,再由协调 Agent 汇总验收。

# .harness/agents.yaml
agents:
  - name: frontend
    role: 前端开发
    model: deepseek-chat
    task:
      - 根据需求生成页面组件代码
      - 保证样式与设计稿一致

  - name: backend
    role: 后端开发
    model: deepseek-chat
    task:
      - 根据需求生成接口代码
      - 保障接口入参校验和异常处理

  - name: reviewer
    role: 代码评审
    model: deepseek-reasoner
    task:
      - 检查前后端代码的潜在问题
      - 输出修改建议清单

执行流程:协调 Agent 接收需求 → 拆分为前端/后端任务并行派发 → 两个 Agent 分别修改文件 → reviewer 执行代码评审 → 协调 Agent 汇总结果返回用户。

2. 动态工作流定义

工作流可以加入条件分支和并行节点,实现更复杂的自动化逻辑。

# workflows/review-workflow.yaml
name: review-workflow
description: 并行代码审查工作流
steps:
  - id: get_diff
    plugin: shell
    input: "git diff --stat"

  - id: parallel_review
    type: parallel
    agents: [frontend, backend, reviewer]
    input: "${get_diff.output}"

  - id: check_result
    type: condition
    condition: "${parallel_review.outputs} contains '高危' or '严重'"
    on_true: human_approval
    on_false: merge_report

  - id: merge_report
    plugin: file_write
    input: "合并三个 Agent 的审查结果为 review_report.md"

常见节点类型包括:Task(执行具体任务)、Condition(条件分支)、Parallel(并行执行)、Loop(循环)、Merge(合并结果)、Human Approval(人工审批)。

3. 自定义 Skill

Skill 是结构化的指令包,适合沉淀团队编码规范和安全红线。

---
name: my-code-review
description: 对当前项目的 Python 代码进行安全性和质量检查
---
1. 分析当前项目中所有 Python 文件的修改记录
2. 检查是否存在硬编码密钥、危险函数调用
3. 检查异常处理是否覆盖了文件读写和网络请求
4. 输出检查报告,标注严重等级

四、新手避坑建议

  1. 不要一口气装太多插件——先装 dsh-market 和 modlens 打好基础,再按需逐步添加。
  2. 锁定插件版本——安装时使用 --tag 指定稳定版本,避免拉到不稳定的 main 分支。
  3. Profile 隔离——工作用 work,个人实验用 lab,Web 服务用 web,避免依赖冲突。
  4. 升级前导出清单——执行 dsh plugin list --locked 保存当前插件版本,回退时不致于全乱。

DeepSeek Harness 的魅力在于它不是一个"固定功能"的工具,而是一个可以无限扩展的平台骨架。插件装完,你拥有的是一套响应快、切换顺、数据可控的个人 AI 作战系统。从阿里云计算巢一键部署起步,三分钟上线,再逐步装上心仪的插件——你的专属 AI 智能体之旅,现在就可以启程。

來源:阿里雲開發者社區 AI · developer.aliyun.com