DeepSeek Harness 下载、安装、配置一篇搞定（2026最新整理，附常用插件指南）
轻量应用服务器入口：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年下半年，AI Agent 赛道迎来了真正的“基础设施级”开源作品——DeepSeek Harness（简称 dsh）。它不是简单的套壳对话工具，而是由 DeepSeek 官方开源、基于 Cordis 内核构建的 Agent 运行框架。其核心设计理念是 “一切皆插件”：模型、工具、沙箱、存储、UI 甚至 Agent 循环，全部由插件组合而成。
自 2026 年 9 月底官方正式推出桌面端以来，dsh 已成为开发者本地部署 Agent 的首选。本文基于 2026 年 10 月最新官方资料与社区实践，为你梳理一份从零开始的“下载-安装-配置-插件”全链路指南。
一、 下载与安装：桌面端 vs Web端
dsh 目前提供两种主要形态：桌面端（适合绝大多数用户，开箱即用）和 Web/CLI 端（适合开发者与服务器部署）。
1. 桌面端（推荐：免环境配置，内置运行时）
2026年9月29日，DeepSeek 正式发布了 Harness v0.2 预览版桌面端。它本质上是用 Electron 封装的完整应用，内置了 Node.js、pnpm 和 Python 环境（含 numpy、pandas 等数据处理库），无需你手动配置系统环境。
- Windows：
- 要求：64位 Windows 10 及以上。
- 下载：前往
deepseek.com/download或 GitHub Releases 下载.exe安装包。 - 注意：点击窗口关闭按钮不会退出应用，而是最小化到系统托盘，后台任务会继续运行。右键托盘图标才能彻底退出。
- macOS：
- 要求：Apple 芯片（M系列）且 macOS 13 及以上（官方明确不支持 Intel 芯片）。
- 下载：下载
.dmg文件并拖入 Applications。 - 注意：首次启动若提示“无法验证开发者”，请前往“系统设置 → 隐私与安全性”中点击“仍然打开”。
- Linux：
- 下载：下载
.AppImage文件，赋予执行权限（chmod +x）后运行。 - 注意：Ubuntu 22.04+ 用户可能需要先安装 FUSE 支持（
sudo apt install libfuse2）。
💡 进阶技巧（安装 CLI 命令）： 桌面端安装后，可在应用顶部菜单找到 Manage dsh Command… 并点击 Install。这会将
dsh命令注册到系统 PATH 中，让你可以在终端直接使用dsh命令。
2. Web / CLI 端（适合开发者与远程服务器）
如果你习惯命令行，或者需要在远程服务器（SSH）上运行，只需准备 Node.js（v20+ 或 v22.19+） 环境。
- 一行命令极速体验（无需全局安装）：
npx @deepseek-ai/dsh web
- (注：Windows PowerShell 若报执行策略错误，请改用
npx.cmd @deepseek-ai/dsh web) - 全局安装：
npm install -g @deepseek-ai/dsh dsh web
- 无头模式（Headless）：适合 CI/CD 或一次性脚本任务，执行完直接输出结果并退出。
dsh --profile headless "分析当前目录下的CSV文件并输出摘要"
二、 首次配置：API、工作区与安全
安装完成后，必须进行两项核心配置才能让 Agent 真正为你工作。
1. 配置模型与 API Key
dsh 本身是 Agent 框架，不包含免费的模型额度，你需要接入大模型 API。
- DeepSeek 官方 API：进入
Settings → Models，找到 DeepSeek 卡片，填入从platform.deepseek.com获取的 API Key。保存后即时生效，无需重启。 - 接入第三方模型（Kimi、OpenAI、智谱等）：在
Add model provider中选择对应的 Provider ID 并填入 Key 即可。 - 接入阿里云百炼（Token Plan）： 若使用百炼的 Token Plan，可选择
Custom model API，或手动编辑~/.dsh/settings.yaml：
agent-default-model: provider: bailian-tpp model: auto llm-pi-ai: providers: bailian-tpp: api: openai-completions baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 apiKeyEnv: BAILIAN_API_KEY models: - id: auto - id: qwen3.8-max
(注：所有凭据均加密保存在本地的 $DSH_HOME/.credentials.yaml 中，界面仅显示脱敏信息。)
2. 配置 Workspace（工作区）—— 极其重要！
工作区就是 Agent 获准读写的本地目录。 出于安全考虑，绝对不要一上来就把整个用户主目录（~）或系统盘根目录设为工作区。
- 最佳实践：单独创建一个目录（如
D:\DeepSeekWorkspace或~/dsh-projects），将其设为工作区。 - 首次试跑建议：先给 Agent 发送只读指令，例如：“阅读当前目录中的 Markdown 文件，输出结构摘要，不要修改文件，也不要运行网络请求。” 确认行为符合预期后，再开放写文件和执行命令的权限。
三、 四大运行模式：选对模式事半功倍
dsh 内置了四种 Agent 运行模式，可在界面右上角或设置中切换：
- 标准模式（Standard）：提供文件、终端、检索、子智能体等完整工具链，适合 90% 的日常办公与代码开发任务。
- PTC 模式：模型不直接调用工具，而是生成一段 TypeScript 代码来编排多步工具调用。适合多步骤、批量处理、数据清洗等自动化任务。
- 极简模式（Minimal）：仅保留一个 Shell 工具和一个文件编辑工具。主要用于模型基准测试或极简环境下的能力评估。
- 创造模式（Creative）：dsh 的灵魂所在。允许 Agent 检查当前运行时、在内存中试验 Cordis 插件，你甚至可以用自然语言让它当场为你写一个新模式或新插件。
四、 常用插件指南（2026 整理）
dsh 的插件生态正在爆发，官方统计已有约 60% 的用户在使用第三方插件。在 Settings → 插件 页面，你可以直接输入 npm 包名进行安装、停用或卸载。
🎁 官方内置/高频必备插件
以下插件通常已内置或可在官方插件库中一键开启：
- Subagent（智能体团队）：允许主 Agent 将复杂任务拆分，调度多个子 Agent 并行处理。支持设置递归层级和所用模型，是处理大型项目的利器。
- Web Search（网页搜索）：接入 DeepSeek 自研搜索提供方，让 Agent 具备实时联网检索和交叉查证能力。
- Agent Loop（智能体循环）：赋予 Agent 持续反思、纠错和规划下一步行动的能力，避免单轮对话中断。
- Terminal & Sandbox（终端与沙箱）：提供安全的本地命令行执行环境，可限制单条命令的最长运行时间和最大输出，防止死循环或任务失控。
- Automation（自动化任务）：支持定时调度或后台长任务运行，适合跑爬虫、定时数据汇总等场景。
🛠️ 进阶：用“创造模式”手搓专属插件
如果你找不到满足需求的社区插件，可以直接在创造模式下让 dsh 自己写。实操案例：
你的 Prompt：“帮我写一个「番茄时钟」插件，要求有悬浮窗，并且能记录我的专注时长到本地 CSV。”dsh 的执行流：
- 加载
cordis-plugin-development技能。- 查询运行时 Slots，确定 UI 挂载点。
- 自动编写
package.json和client.js代码。- 调用
plugin_manager自动安装并验证。(全程仅需几分钟，一个专属的 Cordis 插件即刻生效。)
五、 常见问题与避坑指南 (FAQ)
Q1：Windows 下 npx 报错“无法加载文件...因为在此系统上禁止运行脚本”？A：这是 PowerShell 的安全策略限制。请改用 npx.cmd @deepseek-ai/dsh web，或以管理员身份运行 Set-ExecutionPolicy RemoteSigned。
Q2：dsh 需要本地显卡（GPU）吗？A：不需要。dsh 是 Agent 调度框架，大模型的推理全部在云端（DeepSeek API 或百炼等）完成。本地 CPU 和内存（建议 8GB+）仅用于运行 Node.js 环境、执行 Python 脚本和工具调用。
Q3：桌面端更新后，终端里的 dsh 命令报错版本不匹配？A：打开桌面端应用，进入 Manage dsh Command 点击 Repair，重建符号链接即可。
Q4：dsh 和 Claude Code / Kimi Code 会冲突吗？A：完全不会。dsh 拥有独立的数据目录（默认 ~/.dsh/），CLI 命令也不重名，三者可以在同一台开发机上和平共存。
结语DeepSeek Harness 的出现，标志着 AI 工具从“对话框里的聊天机器人”正式进化为“操作系统级的数字员工”。当前 dsh 仍处于开发者预览阶段（v0.2.x），官方明确提示后续会有 Breaking Changes，但其展现出的插件化架构与本地控制力，已足以让它成为 2026 年每位开发者电脑里必备的 AI 基础设施。
(注：本文数据与版本信息基于 2026 年 10 月官方 GitHub 仓库及公开资料整理。如遇版本更新，请以 deepseek.com/harness 官网及 npm 最新版本为准。)
