DeepSeekDSH
独立社区指南与 DeepSeek 无隶属关系。下载版本与教程参考

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 开始。批量编排工具、简化评测环境或开发预设时,再选择对应模式。

详细比较 Standard、PTC、Minimal、Creator →

怎么运行 DeepSeek DSH

1. Windows / macOS:优先从桌面端入门

如果想先使用桌面应用、不想处理 Node 环境,可以下载 DeepSeek Harness 官方桌面预览版。已核实 Windows x64 与 Apple 芯片 Mac 安装包;Intel Mac 与 Linux 可使用命令行路径。

打开 DSH Desktop 下载说明 →

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 默认标签与源码分支不一定同步。排错时记录实际安装版本;升级前查看发布说明是否包含所需修复,并备份配置。

查看当前 DSH 版本时间线 →

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 组合,阅读 四种模式决策指南;如果你手里有明确报错字符串,直接进入 报错中心。