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

本文将从阿里云一键部署教程、常用插件清单和Agent 工作流示例三个部分,带大家从零搭建属于自己的 AI 工作台。
一、阿里云 DeepSeek Harness 一键部署教程
将 DSH 部署到阿里云 ECS 上,可实现 7×24 小时云端运行、多设备同步和团队协作。整个流程只需三步,约 3 分钟即可完成。
第一步:获取阿里云百炼 API Key
- 登录 阿里云百炼大模型服务平台,右上角选择目标地域(每个地域 API Key 独立,不可跨域混用)。
- 点击"创建 API Key",密钥仅显示一次,务必立即复制保存。
- 同时复制 Base URL,后续配置模型时需要用到。
新用户完成实名认证后可领取免费 Token 额度,覆盖千问系列、DeepSeek 等主流模型,零成本即可启动。
第二步:计算巢一键部署
- 打开 阿里云计算巢 DeepSeek Harness 社区版一键部署服务平台,搜索"DeepSeek Harness"。
- 选择部署模板,配置以下参数:
| 参数 | 建议值 |
|---|---|
| 地域 | 与百炼 API Key 地域保持一致 |
| 付费类型 | 按量付费(测试)/ 包年包月(长期使用) |
| 实例规格 | 最低 1 核 2G;多模型并发建议 2 核 4G 以上 |
| 实例密码 | 自行设置并妥善记录 |
- 确认订单,点击"立即创建",等待约 3 分钟资源交付完成。
- 在服务实例详情页的"输出"区域,点击 安全代理访问地址 即可打开 Web UI(默认端口 3080)。
安全亮点:计算巢安全代理基于实例输出地址访问,ECS 安全组仅放行安全代理出口网段,无需手动开放端口,安全性极高。
第三步:配置模型与工作区
- 打开 Web UI 后,点击左下角 设置 → Models / 模型。
- 点击"添加提供方",可选择:
- DeepSeek 官方模型:填入 DeepSeek API Key
- 阿里云百炼千问系列:填入百炼的 Base URL 和 API Key(推荐 Qwen3.8-Max / Qwen3.8-Flash)
- 勾选目标模型,点击"添加所选"并保存。
- 返回主页,点击 选择工作区,指定 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. 输出检查报告,标注严重等级
四、新手避坑建议
- 不要一口气装太多插件——先装 dsh-market 和 modlens 打好基础,再按需逐步添加。
- 锁定插件版本——安装时使用
--tag指定稳定版本,避免拉到不稳定的 main 分支。 - Profile 隔离——工作用
work,个人实验用lab,Web 服务用web,避免依赖冲突。 - 升级前导出清单——执行
dsh plugin list --locked保存当前插件版本,回退时不致于全乱。
DeepSeek Harness 的魅力在于它不是一个"固定功能"的工具,而是一个可以无限扩展的平台骨架。插件装完,你拥有的是一套响应快、切换顺、数据可控的个人 AI 作战系统。从阿里云计算巢一键部署起步,三分钟上线,再逐步装上心仪的插件——你的专属 AI 智能体之旅,现在就可以启程。