- DSH
- 0.1.5-rc.1
- 系统
- Windows / macOS / Linux
- 风险
- low
本页目录（10）
当前基线与首次验证
2026-09-10 复核：默认精确版本为 0.1.5-rc.1，仍为候选版；官方 Node 范围为 ^22.19.0 || >=24.0.0。本文命令依据固定 CLI（外部链接，在新标签页打开）审阅，未执行安装或真实模型调用。
新会话默认模型为 deepseek-flash，已有显式模型配置优先，不需要为跟随教程覆盖原设置。先在模型页确认实际 Provider 和模型，再做无敏感信息的简单任务；上传文件不代表已被读取。已有环境请先看升级与回退和新版专题。
一句话答案
DeepSeek Harness（命令名 dsh，简称 DSH）是 DeepSeek AI 开源的 Agent Harness。它不是一个新的 DeepSeek 大模型，而是负责把模型 Provider、工具、工作区、权限、会话、插件和用户界面组合成可运行 Agent 的软件框架。官方项目只有 DeepSeek AI 的 deepseek-harness 仓库（外部链接，在新标签页打开）；52DSH 是独立中文社区，不是 DeepSeek Harness 官网，也不代表官方提供支持或背书。
本文在 2026-09-10 重新核对官方 Release、固定提交和 npm 分发状态。普通用户当前通过 npm 默认安装的是 0.1.5-rc.1；GitHub 最新为 0.1.5-rc.1 候选预发布版，精确包已发布到 npm。本文项目定义与入门路径依据 rc.1 固定源码，属于源码审阅，未运行实测。
官方入口在哪里
| 入口 | 用途 | 判断方式 |
|---|---|---|
| DeepSeek Harness 官方 GitHub（外部链接，在新标签页打开） | 查看源码、Release、Issue 和官方说明 | 仓库所有者必须是 deepseek-ai |
npm：@deepseek-ai/dsh（外部链接，在新标签页打开） | 查看普通安装命令实际获得的分发版本 | 以 npm dist-tag 为准，不根据 GitHub 名称猜测 |
| GitHub v0.1.3-alpha.1 Release（外部链接，在新标签页打开） | 了解本文复核时的最新预发布变化 | 页面应显示 Pre-release，不等于稳定版 |
| 52DSH 中文知识库 | 阅读中文教程、插件资料和排障内容 | 独立社区内容，关键事实继续链接第一方来源 |
搜索“DeepSeek Harness 官网”时，项目的第一方入口是官方 GitHub 仓库和其中列出的官方资料。第三方中文站、插件目录和教程可以帮助理解与操作，但不能替代 Release、固定源码和 npm 元数据。
当前应该看哪个版本
| 通道 | 2026-09-10 状态 | 阅读方式 |
|---|---|---|
| npm latest／next | 0.1.5-rc.1 | 默认安装分发，仍为候选版 |
| GitHub 预发布 | 0.1.5-rc.1 | 与 npm 默认版一致，仍需核对 V3、插件和回退边界 |
| 52DSH 文章与插件 | 各自标注适用版本 | 旧文章没有因通道变化自动完成新版验证 |
最新变化见0.1.5-rc.1 更新与升级判断。此前 alpha.5 升级修复和 alpha.3 SQLite Session 风险保留历史事实；实际操作仍由更新与回退指南承接。
Harness 在这里是什么意思
“Harness”可以理解为把模型能力约束并接入真实工作环境的一套运行框架。模型负责理解和生成，Harness 负责准备系统提示、注册工具、发送请求、执行工具、记录结果、保存会话并应用权限策略。
因此，安装 DSH 不等于下载一个 DeepSeek 模型，也不意味着推理一定发生在本机。具体模型来自你选择的 Provider；费用、日志和数据处理方式也要按 Provider 分别判断。DSH 提供的是 Agent 的运行、扩展和交互层。
DSH 能做什么
依据 0.1.5-rc.1 的官方 README、CLI 参考和架构文档，DSH 可以把以下能力组合进 Agent：
- 选择模型 Provider 和凭据；
- 在已选择的 workspace 中读取或修改文件；
- 注册并调用命令、搜索和其他工具；
- 保存 Session、事件与运行上下文；
- 通过插件、Profile 和 Bundle 组合能力；
- 通过 Web UI 进行交互，或使用 Headless Profile 运行一次性任务；
- 按配置把任务委派给子 Agent Provider。
官方提供的 Web UI 快速启动命令是：
npx @deepseek-ai/dsh web
查询时 npm 默认分发为 0.1.5-rc.1；本地安装与缓存仍需单独核对，默认监听 http://127.0.0.1:3080。第一次操作请使用安装 DeepSeek Harness 并启动 Web UI；不要把 GitHub 预发布版名称自行拼进安装命令。
为什么官方强调“一切皆插件”
DSH 由 Cordis 驱动。模型适配器、工具注册表、Session、Agent Loop、Web 应用和权限策略都通过插件树组合，而不是全部固定在单一核心中。Profile 描述一次具体启动要加载哪些配置，Bundle 则把一组可复用能力组合起来。
这种设计使 Web、Headless、不同 Provider 和不同工具集可以共享基础能力，又保持各自的配置和运行边界。它也意味着“插件已经被收录”不等于“插件已经安全认证”：第三方包的来源、许可证、版本、构建脚本、文件与网络权限仍需单独审核。更完整的内部关系见DeepSeek Harness 架构解析和DSH 插件、Skills 与 MCP 的能力边界。
它和 DeepSeek 模型有什么区别
| 名称 | 主要角色 | 需要单独判断的事项 |
|---|---|---|
| DeepSeek 模型/API | 生成文本、推理和提出工具调用 | 模型版本、费用、数据处理与服务可用性 |
| DeepSeek Harness | 组织模型、工具、会话、权限与界面 | DSH 版本、Profile、工作区和运行权限 |
| Provider | 向 DSH 提供具体模型和凭据路由 | API Key、端点、区域、日志和计费 |
| Plugin/Bundle | 向 DSH 添加能力或组合配置 | 包来源、兼容版本、构建脚本和权限 |
| Skill 或 MCP Server | 提供说明资源或外部工具能力 | 运行位置、数据流、凭据和维护责任 |
DSH 可以接入 DeepSeek Provider，也可以按配置接入其他 Provider。项目使用 MIT 许可证不代表每个模型、API、插件或外部服务都采用相同条款。
当前阶段有什么限制
官方仍把 DeepSeek Harness 标为 Developer Preview，并提醒未来可能出现破坏兼容性的变化。这意味着：
- 命令、配置结构和插件兼容性可能变化；
- GitHub 预发布版与 npm 默认安装版本可能暂时不一致；
- 教程必须标注版本和复核日期，不能把源码审阅写成运行实测；
- 关键工作区需要先备份并使用最小权限；
- 第三方插件、MCP Server 和外部工具必须分别评估供应链、凭据与数据流风险。
下一步从哪里开始
| 你的目标 | 推荐入口 |
|---|---|
| 第一次了解和完成任务 | DeepSeek Harness 中文入门 |
| 安装并启动 Web UI | 安装 DeepSeek Harness 并启动 DSH Web UI |
| 配置模型和 API Key | 配置 DSH 模型、API Key 与 Provider |
| 查找和安装插件 | 安装和管理 DeepSeek Harness 插件 |
| 理解权限边界 | DSH 权限与沙箱指南 |
| 查看最新预发布变化 | 0.1.3-alpha.1 变化与获取条件 |
如果只需要一个判断：先使用 npm 默认分发和对应版本教程；只有明确需要预发布功能，并且准备好隔离 Profile、测试工作区和回退路径时，再评估 alpha 版本。
来源与维护信息
本文根据以下原始资料整理。版本变化后，请以官方资料和页面标注的验证日期为准。
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness 固定提交 README.zh.md（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness 固定提交 package.json（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness 固定提交 README.zh.md（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness 固定提交 package.json（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness 固定提交 README.zh.md（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness 固定提交 architecture.zh.md（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness 固定提交 README.zh.md（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- GitHub：deepseek-ai/deepseek-harness（外部链接，在新标签页打开）
- npm：@deepseek-ai/dsh（外部链接，在新标签页打开）