DeepSeek DSH — DeepSeek Harness
DeepSeek Harness 为模型提供文件、终端等工具,让它在指定项目中读代码、改文件和运行任务。使用前需要配置模型、选择工作区并确认权限。
本页内容
DeepSeek DSH 是什么?
DeepSeek DSH 通常指 DeepSeek Harness,官方 npm 包名为 @deepseek-ai/dsh。它是开源的 Agent 运行环境,不是新的 DeepSeek 模型。
例如,你提出“修复这个项目的一个报错”后,模型可以通过 DSH 读取相关文件、提出修改、调用工具执行命令,再根据输出继续处理。能访问哪些文件、运行哪些操作,取决于工作区、工具配置和权限。
任务涉及真实文件和命令。第一次使用时,选择不含敏感信息的测试目录;修改重要项目之前保留可恢复的版本。
DSH 相比“直接调用模型”多了什么?
DSH 在模型之外提供执行任务所需的工具和记录:
工作区与工具
指定项目目录,通过文件、终端和搜索工具执行操作。
模式预设
为新会话选择 Standard、PTC、Minimal 或 Creator,使用对应的工具和提示词组合。
插件扩展
按需要添加工具、模型服务商或其他入口,安装前检查插件来源和权限。
会话记录
查看任务进度、工具调用与返回结果,用于检查操作和排查失败。
DeepSeek DSH 不是以前 Linux 里的 dsh
dsh 这个短名字在互联网上本身就有歧义。早在 DeepSeek Harness 出现之前,Linux/Unix 生态里就有叫 dsh 的 distributed shell 工具,用于把同一条 Shell 命令发到多台机器执行。这类工具和 DeepSeek AI 没有关系。
如果你看到的页面在讲集群主机、Debian 的 dsh 包、同时向多台服务器执行命令,那通常是旧的 Linux 含义;如果页面里出现 @deepseek-ai/dsh、Agent Preset、Plugin、Web UI、DeepSeek Harness,那么才是这里讨论的 AI Agent 项目。
DeepSeekDSH 是本站名称,与 DeepSeek 没有隶属关系。DeepSeek Harness 是上游项目,官方仓库为 deepseek-ai/deepseek-harness。
开始任务前需要配置什么?
- 模型:使用哪个服务商、模型和凭证。
- 工作区:这次任务要处理哪个项目目录。
- 预设:为模型提供哪些工具和提示词。
- 权限:允许访问哪些资源、执行哪些操作。
这几项彼此独立。换成 Minimal 不会自动减少文件权限;修改预设后,也需要新建会话验证,已有会话仍保留启动时的预设。
DeepSeek Harness 当前有四种内置 Agent 模式
以下按 0.1.5-rc.2 / c291e79 源码快照说明。四种预设改变工具与提示词,不改变模型本身。
Standard
日常编码预设,提供编辑、终端、搜索、Skills、计划、目标、子 Agent 和工作流工具。
PTC
通过 PTC SDK 用 TypeScript 编排多步工具操作,默认不提供 workflow 工具。
Minimal
单工具预设,仅提供持久 Shell:macOS/Linux 使用 Bash,Windows 使用 PowerShell。
Creator
在 Standard 基础上增加运行时检查、插件实验和预设编写指导。
读代码、改文件和运行测试,可以从 Standard 开始。批量编排工具、简化评测环境或开发预设时,再选择对应模式。
怎么运行 DeepSeek DSH
1. Windows / macOS:优先从桌面端入门
如果想先使用桌面应用、不想处理 Node 环境,可以下载 DeepSeek Harness 官方桌面预览版。已核实 Windows x64 与 Apple 芯片 Mac 安装包;Intel Mac 与 Linux 可使用命令行路径。
2. 官方 npm / npx 路径
官方 CLI 包是 @deepseek-ai/dsh。安装 Node.js 后,常用 Web UI 启动命令是:
npx @deepseek-ai/dsh web默认地址为 http://127.0.0.1:3080;浏览器应打开终端实际打印的完整链接。Node 版本、安装步骤和常见报错见系统教程。
3. 从源码运行
需要修改 DSH 本身、开发插件或调试未发布的修复时,可以克隆官方仓库并按该版本要求安装依赖、构建。
npm 发布版与源码快照有什么区别?
截至 2026-09-11,本站记录的 npm 默认发布基线为 0.1.5-rc.1,源码快照为 0.1.5-rc.2,对应提交 c291e79。
npm 默认标签与源码分支不一定同步。排错时记录实际安装版本;升级前查看发布说明是否包含所需修复,并备份配置。
DeepSeek DSH 官方链接
DeepSeek DSH 常见问题
DeepSeek DSH 是一个模型吗?
不是。它是连接模型与文件、终端等工具的运行环境,使用时仍需选择模型并配置凭证。
DeepSeek DSH 和 DeepSeekDSH.com 是一回事吗?
不是。DeepSeekDSH.com 是本站这个独立社区文档站;上游项目维护在 deepseek-ai/deepseek-harness 官方仓库。
dsh 是不是 Linux distributed shell?
它们是两个不同的项目,只是命令名称相同。DeepSeek Harness 的官方 npm 包名是 @deepseek-ai/dsh。
新手应该选 Standard 还是 PTC?
先用 Standard。PTC 适合你已经明确知道某个任务为什么需要“用代码编排多次工具调用”的时候,它不是万能的更快模式。
一定要升级 Alpha 吗?
不一定。Alpha 可能带来重要修复,但仍是开发者预览版本。先看具体 Release 是否解决你的问题,再决定是否切换版本线。
安装或排错从哪里开始?
如果你要安装,进入 教程;如果 DSH 已经能运行、你在选 Agent 组合,阅读 四种模式决策指南;如果你手里有明确报错字符串,直接进入 报错中心。