DeepSeek DSH — DeepSeek Harness
DeepSeek DSH、DeepSeekDSH 和 dsh 是用户搜索 DeepSeek Harness 时常见的写法。本页先把项目本身讲清楚，再进入安装、模式和排错页面。
本页内容
DeepSeek DSH 是什么？
DeepSeek DSH 通常指 DeepSeek Harness，官方 npm 包名是 @deepseek-ai/dsh。它不是一个新的 DeepSeek 模型，而是一个开源 Agent Harness：负责把 LLM 和 Workspace、工具、插件、Session、Permission 以及界面组合在一起，让模型能执行多步骤任务，而不只是返回一段文字。
可以用一句话理解：模型负责推理，DSH 负责给模型提供可工作的运行环境。 当你让 DSH 检查仓库、编辑文件、运行命令或委派任务时，Harness 决定这个 Session 能看到哪些能力，并记录这些能力之间的交互。
DeepSeek Harness 目前仍处于快速迭代阶段。Alpha 版本可能改变 API、默认行为和持久化方式，所以本站所有与版本有关的说明都会标出实际核验的源码快照。
DSH 相比“直接调用模型”多了什么？
模型 API 主要解决输入和输出；Harness 解决的是“怎么让模型持续做事”。把 DSH 拆成几层就容易理解：
Workspace + Tools
Agent 可以操作文件、Shell、搜索和其他挂载工具，而不是只能聊天。
Agent Preset
Session 会从 Standard、PTC、Minimal、Creator 等 Preset 启动，Preset 决定模型能看到的 Agent 工具组合。
Plugin 与扩展点
DSH 使用“Everything is a Plugin”的组合思路，能力可以按工作流挂载，而不是全部硬编码到同一个 Agent 里。
Session 与控制
长时间任务需要 Session 状态、日志、重连机制和可观察界面，用户才能知道 Agent 到底在做什么。
所以 DeepSeek Harness 和 DeepSeek 模型 不是同义词。模型只是 Harness 内部的一层，Harness 负责围绕模型搭建完整 Agent 工作流。
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 Harness 才是上游项目。本站与 DeepSeek 没有隶属关系，下面会直接给出官方 GitHub 与 npm。
一个 DSH Session 到底由什么组成？
普通用户不需要先理解完整 Cordis 架构。先记住下面这个模型就够了：
Model
+ Agent Preset（工具组合）
+ Workspace
+ Host Services / Permission
+ 已安装 Plugin 与 Provider
= 一个 DSH Agent Session其中最容易混淆的是 Preset：它决定模型在 Session 中看到哪些 Agent 能力，但它不等同于 Model，也不等同于 Host Permission。这个区别在比较 Standard、PTC、Minimal、Creator 时尤其重要。
已经运行的 Session 会继续保留启动时的 Preset。如果你复制或修改 Preset，应该新建 Session 做验证，而不是假设旧 Session 会自动重组。
DeepSeek Harness 当前有四种内置 Agent 模式
当前 Web UI 提供四个 Built-in Preset。它们不是四种不同 LLM，而是四种不同 Agent 组合。
Standard
日常开发默认模式，包含编辑、Shell、文件/网页搜索、Skills、Planning、Goals、Subagents 与 Workflows。
PTC
完整 Coding Agent，但多数工具通过 PTC SDK 暴露，让模型能在 TypeScript run_code 内组合多步骤操作。
Minimal
刻意缩小到两个工具：persistent bash + str_replace_editor。
Creator
Standard 能力再加运行时检查、Plugin 实验和 Preset 编写指导，面向自定义 Agent 组合。
对绝大多数用户来说，Standard 应该是第一选择。只有当工作流出现明确需求时，再切换到其他 Preset。
怎么运行 DeepSeek DSH
1. Windows / macOS：优先从桌面端入门
如果你的目标只是先体验 DSH，不想先处理 Node 环境，可以从社区维护的 DSH Desktop 路径开始。它把本地运行流程包装成桌面客户端。注意它是独立社区软件，不是 DeepSeek 官方桌面产品。
2. 官方 npm / npx 路径
官方 CLI 包是 @deepseek-ai/dsh。安装 Node.js 后，常用 Web UI 启动命令是：
npx @deepseek-ai/dsh web默认 Web UI 地址是 http://127.0.0.1:3080。如果需要完整操作步骤，建议直接进入系统教程，不要靠记忆逐条排错。
3. 从源码运行
源码方式更适合贡献者、Plugin 作者或需要未发布功能的人。它会增加仓库和包管理复杂度，因此不应该成为普通用户第一次体验 DSH 的默认路径。
现在到底哪个 DSH 版本算“最新”？
这里需要分开两条线。本站当前记录的 npm 默认发布基线是 0.1.1-rc.2，而最新核验的源码/预发布快照是 0.1.2-alpha.5，对应 commit 49a606b。
这个区别很重要：Alpha 可能已经包含最新修复和新行为，但 npm 的 latest 默认基线不一定同步。所以讨论“最新版 DSH”时，必须说明你指 npm 默认 tag，还是更快的 Alpha/源码线。
DeepSeek DSH 官方链接
DeepSeek DSH 常见问题
DeepSeek DSH 是一个模型吗？
不是。DeepSeek Harness 是围绕模型工作的 Agent Harness，负责 Session、Tools、Preset、Plugin 和工作流；Model Routing 是另一层。
DeepSeek DSH 和 DeepSeekDSH.com 是一回事吗？
不是。DeepSeekDSH.com 是本站这个独立社区文档站；上游项目维护在 deepseek-ai/deepseek-harness 官方仓库。
dsh 是不是 Linux distributed shell？
在本文语境里不是。DeepSeek Harness 和旧的 distributed-shell 工具只是名字碰巧相同，官方 AI Agent 包名是 @deepseek-ai/dsh。
新手应该选 Standard 还是 PTC？
先用 Standard。PTC 适合你已经明确知道某个任务为什么需要“用代码编排多次工具调用”的时候，它不是万能的更快模式。
一定要升级 Alpha 吗？
不一定。Alpha 可能带来重要修复，但仍是开发者预览版本。先看具体 Release 是否解决你的问题，再决定是否切换版本线。
看完这一页下一步去哪里？
如果你要安装，进入 教程；如果 DSH 已经能运行、你在选 Agent 组合，阅读 四种模式决策指南；如果你手里有明确报错字符串，直接进入 报错中心。