DeepSeek Harness (dsh) 下载、安装、配置一篇搞定（2026最新整理，附赠常用插件）
DeepSeek Harness（命令行简称 dsh）是 DeepSeek AI 于 2026 年开源的 Agent 运行框架。它基于 Cordis 内核，采用“一切皆插件”（Everything is a Plugin）的架构，模型、工具、沙箱、UI 等所有能力均可自由替换和重组。
轻量应用服务器入口：https://www.aliyun.com/product/swas
云服务器ECS入口：https://www.aliyun.com/product/ecs
GPU云服务器入口：https://www.aliyun.com/product/egs
云数据库入口：https://www.aliyun.com/product/polardb
截至 2026 年 11 月，dsh 已积累超百万日活用户，第三方插件生态突破 3.5 万个。无论你是想用它辅助编程、自动化办公，还是构建自己的 Agent 应用，这篇 2026 年最新整理的指南都能帮你从零开始，快速跑通全流程。
一、 下载与安装：Web 端 vs 桌面端
dsh 提供 Web 端和桌面端两种主要形态。桌面端内置了 Node.js、pnpm 和 Python 环境，开箱即用；Web 端则需要系统预装 Node.js（建议 v20+）。
1. Web 端：三平台通用，一行命令启动
适合有一定开发基础、习惯命令行或需要通过 SSH 远程使用的用户。
# 临时运行（自动拉取最新包并启动） npx @deepseek-ai/dsh web # 全局安装（推荐，后续直接使用 dsh 命令） npm install -g @deepseek-ai/dsh dsh web
注：本地启动会自动打开浏览器；若通过 SSH 连接，需手动配置端口转发并访问打印出的地址。若不想自动打开浏览器，可加 --no-open 参数。
2. 桌面端：原生体验，支持后台运行
适合普通用户，无需配置环境。请前往官网（deepseek.com/download 或 deepseek.com/harness）或 GitHub Releases（deepseek-ai/deepseek-harness）获取安装包。
| 平台 | 系统要求 | 安装包格式 | 安装与运行注意事项 |
| Windows | 64位 Win10 及以上 | .exe |
关闭主窗口不会退出应用，程序会收进系统托盘继续运行任务。需右键托盘图标才能彻底退出。 |
| macOS | Apple M系列芯片，macOS 13+ | .dmg |
不支持 Intel 芯片。首次启动需授权文件夹等权限，建议先指向测试目录。 |
| Linux | 主流发行版 | .AppImage |
赋予执行权限后运行（chmod +x）。Ubuntu 22.04+ 若报错需先安装 FUSE：sudo apt install libfuse2。 |
💡 进阶提示：安装 CLI 命令行工具桌面端用户可在应用顶部菜单选择 Manage dsh Command… -> Install，将 dsh 注册到系统 PATH 中。macOS 会创建 /usr/local/bin/dsh 符号链接（需管理员密码）。
二、 首次配置：模型接入与工作区设置
1. 配置 DeepSeek 官方 API Key
Harness 本身是运行框架，需接入模型才能工作。
- 打开 dsh，进入 Settings -> Models。
- 找到 DeepSeek 卡片，填入你在
platform.deepseek.com创建的 API Key。 - 点击保存（无需重启，下一个请求即生效）。安全机制：Key 会加密存入
$DSH_HOME/.credentials.yaml，界面仅显示脱敏信息，不回显明文。
2. 接入第三方模型（Kimi、OpenAI、火山方舟等）
dsh 内置了多家提供商配置。在 Settings -> Models -> Add model provider 中：
- 内置支持：直接选择
moonshotai(Kimi)、anthropic、openai、zai(智谱) 等，填入 Key 即可。 - 自定义端点：选择 Custom model API，填入 Provider ID、Base URL、API Protocol（支持 OpenAI Chat/Responses 或 Anthropic Messages）及 API Key。
- 火山方舟接入：可在插件市场搜索安装官方插件
dsh-volcengine-plugin，一键接入方舟 Coding Plan 或后付费模型。
3. 选择工作区（极其重要）
首次启动时，系统会要求选择工作区（Agent 获准读写的本地目录）。 ⚠️ 安全警告：请勿直接选择整个用户主目录、密钥目录或核心财务资料。建议首次使用时选择一个测试目录，并发送只读指令（如：“阅读当前目录中的 Markdown 文件，输出结构摘要，不要修改文件”）以验证 Agent 行为。
三、 运行模式解析：选对模式事半功倍
在界面中，dsh 提供了四种预设模式：
- 标准模式：提供文件、终端、检索、子智能体等完整工具链，适合日常开发与复杂任务（新手首选）。
- PTC 模式：让模型生成 TypeScript 代码来编排多步工具调用，适合多步骤自动化任务。
- 极简模式：仅保留 Shell 和文件编辑，适合做模型基准测试（Benchmark）。
- 创造模式：用于检查运行时、在内存中试验 Cordis 插件，甚至通过自然语言让 AI 帮你写一个新插件。
四、 插件安装指南与 2026 必装插件推荐（福利）
dsh 的核心魅力在于“一切皆插件”。目前社区已有约 3.5 万个第三方插件。
插件怎么装？（三种方式）
- UI 安装（推荐）：在桌面版 Settings -> Plugins 页面，直接搜索 npm 包名点击 Install。
- CLI 安装：完全退出桌面版后，在终端执行
dsh plugin --profile desktop add <包名>，重开应用生效。（注意：桌面端和 Web 端的插件目录是隔离的，操作桌面端必须加--profile desktop）。 - 本地开发：通过
cordis.yml补丁文件使用--patch参数加载本地未发布的插件。
🎁 2026 常用/热门插件精选清单
以下插件均在社区获得极高关注度或官方推荐，可直接在插件页搜索包名安装：
| 插件包名 | 功能亮点 | 适用场景 |
dsh-our-free-model |
44,000+ Star 的超级热门。无需 API Key 即可免费调用 DeepSeek V4.1 Flash 和 Kimi，提供 OpenAI 兼容本地端口。 | 零成本体验、学生党、轻度测试 |
dsh-media-desk |
自媒体创作者工作台。将 dsh 变成日常自媒体工作台，支持分镜头脚本生成、自动化任务流。 | 自媒体运营、短视频脚本创作 |
dsh-guizang-design |
歸藏设计。将文章一键转化为网页、图文卡片或封面，支持统一设计系统（杂志风/瑞士风），作品可复用。 | 内容排版、PPT/卡片设计、图文创作 |
dsh-context |
上下文洞察。可视化查看 Agent 工作时使用的上下文信息、Token 占比及多 Agent 团队协作的底层细节。 | 插件开发者、Prompt 工程师、深度调试 |
agentero-dsh |
论文阅读助手。接入 Agentero，在同一个窗口内完成文献管理、高亮、翻译、笔记和 AI 思路梳理。 | 科研人员、学生、文献综述 |
dsh-volcengine-plugin |
火山方舟官方插件。简化火山方舟 Agent Plan / Coding Plan 的接入流程，支持豆包等模型。 | 需使用火山方舟算力或模型的用户 |
dsh-market |
官方插件市场。提供语义搜索和智能分类，方便在命令行或 UI 中快速发现和安装其他插件。 | 所有用户（探索生态必备） |
五、 常见问题 (FAQ) 与避坑指南
Q1：dsh 的数据和配置文件存在哪里？所有配置、会话历史和插件都存储在 $DSH_HOME 目录下。macOS/Linux 默认为 ~/.dsh/，Windows 默认为 %USERPROFILE%\.dsh\。可通过设置环境变量 DSH_HOME 修改路径。
Q2：更新桌面版后，终端里的 dsh 命令报错版本不匹配？这是因为 CLI 符号链接未更新。请打开桌面端，进入 Manage dsh Command -> Repair 重建链接即可。
Q3：当前版本稳定吗？截至 2026 年 11 月，dsh 仍处于开发者预览阶段（当前 npm 版本如 0.2.1-rc.2）。官方明确提示“存在破坏兼容性的更新（COMPATIBILITY-BREAKING CHANGES）”，建议在升级大版本前务必查阅 CHANGELOG。
Q4：可以和 Claude Code 或 Kimi Code 同时安装吗？完全可以。dsh 拥有独立的数据目录和 CLI 命名空间，三者互不干扰，可共存于同一台开发机中。
免责声明：本文信息基于 2026 年 8 月至 11 月 DeepSeek 官方发布内容及开源社区资料整理。dsh 迭代迅速，具体界面 UI、命令参数及插件兼容性请以您下载时的官方 GitHub 仓库（
deepseek-ai/deepseek-harness）及 npm 文档为准。使用第三方插件时，请务必确认插件来源，防范安全风险。
