插件化
全部能力
模型、工具、会话、沙箱、UI…
DeepSeek Harness · 中文版开源 Agent
DeepSeek Harness 在本地让 AI 改代码、跑命令、组合插件
DeepSeek Harness 不只是聊天：模型负责推理，Harness 把文件、终端和工具接到真实场景。一条命令启动本地界面，安装、模式与教程从这里开始。
- 开源 MIT
- 一条命令上手
- 本地运行
一条命令启动本地 Web UI — 复制后在终端运行
npx @deepseek-ai/dsh web Cordis
内核
只负责加载/卸载与依赖
4 种模式
预设
标准 · PTC · 极简 · 创造
npx
分钟级体验
@deepseek-ai/dsh web → :3080
Agent = Model + Harness
Harness 让 Agent 在真实环境里持续工作
模型负责推理
各类模型适配器完成推断——Harness 不替代你选用的 LLM。
Harness 连接环境
文件、终端、工具、会话、沙箱与本地 Web UI，让工作不止于聊天记录。
DeepSeek Harness 是什么？
DeepSeek Harness（DSH）是模型外的执行与编排层。Cordis 内核加载插件来提供模型、工具、技能、会话、沙箱、存储、调度乃至 UI；开发者用配置组合行为，在 Trajectory 中回看运行轨迹，并用社区 dsh-plugin 扩展能力。本站用结构化教程说明安装、安全配置与架构要点——命令与版本请以官方 GitHub 仓库为准。
为什么关注 DSH
可组合
换模型或工具不必重写核心，配置层选择插件即可。
可观测
仅追加会话日志记录提示词、工具调用与注入，支持回放与分叉。
多模式
完整编码 Agent、PTC 代码编排、极简评测、创造预设。
MIT 预览
可读源码、贡献插件，并掌控 Agent 如何触达本地仓库。
核心能力
一切皆插件
能力通过 Cordis 服务与事件协作，而不是单体 Agent 二进制。
源自公开设计说明，本站改写
Trajectory 可观测
查看模型所见：系统提示、工具结果、子 Agent、上下文注入。
恢复与回放共用事件流
四种实用模式
日常用标准，多步编排用 PTC，评测用极简，做预设用创造。
详见 /modes
一条命令 Web UI
准备好 Node.js 后 npx 启动本地界面，填 API Key、选工作区即可下发任务。
http://127.0.0.1:3080
适用场景
编码 Agent
- 改仓库与跑命令
- Skills 与工作流
- 长任务子代理
平台搭建
- 自定义 preset
- 内存中试验插件
- 配置层组合
评测与研究
- 最小工具面
- 可复现轨迹
- Harness / 模型消融
四种模式速览
需要细节请打开运行模式页，了解标准 / PTC / 极简 / 创造后再回到安装页动手。
Standard
完整编码 Agent 面
文件编辑、Shell、检索、Skills、计划、目标、子代理与工作流。这是你信任工作区权限、并在可丢弃目录上看过 Trajectory 之后的默认。多数「就改这个仓库」的提示词预期的就是它。请和 [安装](/zh-cn/install/) 里的工作区警告一起看：整个用户主目录是错误的第一目标。
适用: 你有意选中了根目录的日常补丁、测试与重构。
PTC
Code Mode 多步编排
具备标准级能力，但通过 Code Mode SDK 呈现工具，让模型用一段 TypeScript 一次组合多步。痛点是编排——本该是一个程序的许多次工具跳转——而不是单次闲聊式调用。若预览版 Code Mode 文档搬家，信 GitHub 不信本站博客日期。
适用: 该写成短 TypeScript 脚本、而不是二十轮聊天的流水线。
Minimal
双工具评测面
公开说明常见持久 bash 加 str_replace_editor。这个小表面用来在模型评测时停止自我欺骗。若网页搜索、市场 UI、外观包仍加载着，你测的是鸡尾酒。评测目录同样不要放密钥；bash 仍是 bash。
适用: 基准、钉住模型的回归，或讲清「模型能力」和「插件运气」的差别。
Creative
预设创作实验室
标准能力加上运行时检查与内存中 Cordis 试验，用来设计、记录新的 Agent 预设，而不假装这是生产会话。插件作者和皮肤作者应在这里待到「卸载」变得无聊。若打算发布 dsh-plugin 而不是截一张主题图，见 [参与贡献](/zh-cn/contribute/)。
适用: 做预设、检查 Cordis、试 UI 皮肤、写插件。
快速体验或源码安装
开发者预览版的官方路径——参数若变更，以 GitHub README 为准。
快速体验
Node.js 就绪后，一条 npx 启动本地 Web UI（常见 :3080）。
npx @deepseek-ai/dsh web 源码安装
克隆上游仓库并按 pnpm 构建——插件作者与贡献者常用。
git clone https://github.com/deepseek-ai/deepseek-harness 常见问题
FAQ →DeepSeek Harness、DSH、DS Harness 是不是一回事？
是。DSH、DS Harness 都是 DeepSeek Harness 的常用简称。本站标题用全称，正文与 FAQ 覆盖别名，便于检索。
DeepSeek Harness 是新模型吗？
不是。Agent = Model + Harness：模型负责推理，Harness 把文件、终端、工具和 UI 接到真实环境。本站讲的是这个开源执行层。
如何快速安装 DeepSeek Harness？
安装 Node.js 后执行 npx @deepseek-ai/dsh web，打开 http://127.0.0.1:3080，填入 DeepSeek API Key，选择工作区并发送任务。完整步骤见安装页。
「一切皆插件」是什么意思？
模型适配、工具、会话、沙箱、存储、循环、调度和 UI 都是 Cordis 插件，用配置组合，而不是去改单体源码。
DeepSeek Harness 的 PTC 模式是什么？
PTC（Programmatic Tool Calling）让模型写一小段程序，把多次工具调用编排成一次流程，而不是每一跳都靠对话。日常改仓库用标准模式。细节见运行模式页。
DeepSeek Harness 有在线版吗？能直接在浏览器里用吗？
没有托管在云端的在线版。用 npx @deepseek-ai/dsh web 在本机启动 Web UI，浏览器打开 http://127.0.0.1:3080。项目文件和 API Key 留在本机。操作清单见本站 Web UI 指南。
DeepSeek Harness 官网是哪个？
产品介绍在 https://www.deepseek.com/harness/，源码与参数以 github.com/deepseek-ai/deepseek-harness 为准。harness-ds.com 是社区门户，整理安装、PTC、插件与排错，不是厂商首页。
DeepSeek Harness 是字节跳动开发的吗？
不是。DeepSeek Harness（dsh）由 DeepSeek AI（深度求索）以 MIT 协议开源，与字节跳动及其智能体产品无关。
DeepSeek Harness 和 DeepSeek Chat 有什么区别？
DeepSeek Chat 是网页/App 对话产品；DeepSeek Harness 是本地开发者框架，用 Cordis 插件接文件、终端和 Web UI（:3080）。一个开箱即聊，一个用来搭自己的 Agent。
MIT 协议可以商用吗？
上游仓库 deepseek-ai/deepseek-harness 以 MIT 发布——请核对你钉住的 tag 上的 LICENSE。社区插件各有许可证。本站不另授许可。
和 Claude Code / Codex / OpenCode 有什么区别？
DSH 是 MIT、插件优先的预览 Harness。Claude Code 与 Codex 是商业编码智能体；OpenCode 是另一套开源编码智能体。本站维护的对照表在 vs Claude Code 页。
DeepSeek Harness 和 Claude Code 有何不同？
DSH 以 npm 插件 / Cordis 为中心；Claude Code 更强调 MCP。请看对比页按工作流选择，勿只看口号。
最新指南
2026-10-09
macOS 上跑 DeepSeek Harness：Homebrew、PATH 与完全磁盘访问
命令和其他系统一样是 npx——Mac 上真正容易踩的是哪个 node 在 PATH、TCC 弹窗，以及第一天别开完全磁盘访问。
2026-09-28
DeepSeek Harness 0.1.7 RC 操作核对
v0.1.7-rc.2 仍是 Pre-release。定时任务默认关，会话日志升到 V4，PTC 包名改为 ptc-runtime。
2026-09-28
无头跑 DeepSeek Harness：--json 与会话续跑
dsh --profile headless 不开端口。stdout 留给 --json，未知 session id 直接失败，多轮工作拆成多次运行。
加入 dsh-plugin 生态
预览版面向 Harness 开发者——模型、工具与 UI 皮肤都以 npm 插件交付。加载社区包前先读目录与安全清单。
权威来源
请在 GitHub 阅读 deepseek-ai/deepseek-harness。本站外链到源码，专注结构化教程、可收录说明与安全上手清单。
GitHub deepseek-harness →