Cordis 内核
The Cordis kernel manages plugins: installing, uninstalling, and dependencies. Agent capabilities live in these plugins.
Developer preview · 0.1.2-rc.1
本地 agent runtime Everything is a plugin
Models、tools、skills、sessions、sandboxes、storage、loops、scheduling 和 UI 各自都是可替换、可重组的 plugin。
Web UI 通过以下命令绑定 127.0.0.1:3080 npx @deepseek-ai/dsh web。MIT 许可。Node.js ^22.19.0 或 >=24。0.1.2-rc.1 的 CLI 解压后 43 KB。
Agent + model = Harness
HARNESS
keeps agents working in real-world environments
The model is the soul of an agent.
Harness 让 agent 读取环境、调用 tools，并在聊天框之外持续工作。
能力即 plugin
Plugins provide every agent capability, including models, tools, skills, sessions, sandboxes, storage, loops, scheduling, and the UI. Cordis services and events let the plugins work together.
用配置组合
Developers can select, swap, or extend any capability in configuration without changing the DeepSeek Harness source code.
产品架构
围绕更简单的工作流
Everything is a plugin
DeepSeek Harness 建立在 Cordis 上。Plugins 提供 models、tools、skills、sessions、sandboxes、storage、loops、scheduling 和 UI。开发者在配置里选择或扩展能力，而不是 fork 源码树。官方 Settings 画面列出 159 条已安装行。
会话日志
每次运行都可追溯
Everything the model sees is recorded in an append-only session log: system prompts, reasoning, tool calls and results, subagent scheduling, and every context injection. In the Trajectory view, you can inspect these records by source. Resume, fork, search, and replay all operate on the same event stream.
Describe what you want to build
运行预设
多种运行模式
Standard mode includes the full toolset. Code / PTC mode uses model-generated code to orchestrate multiple rounds of tool calls. Minimal mode keeps only a shell tool and a file editor for benchmarking models in a thin environment. Creator mode lets you inspect the current runtime, test Cordis plugins in memory, and combine them into new modes.
Get started
Try it now or install from source
快速开始
Install Node.js ^22.19.0 or >=24.0.0, then launch the local Web UI with npx.
$ npx @deepseek-ai/dsh web
从源码安装
Clone the published source and follow the setup commands in the repository. Shown as text, not an outbound link.
$ git clone https://github.com/deepseek-ai/deepseek-harness
运维
谁在真正运行 dsh
- Agent runtime 作者 在不改 DeepSeek Harness 源码的情况下替换 model、tool 和 sandbox plugins。
- Coding agent 运维 pin @deepseek-ai/[email protected] 并在 workspace-write 加 ask 下使用可丢弃工作区。
- 评测团队 在需要薄工具面时使用 Minimal mode（持久 bash + str_replace_editor）。
- Preset 构建者 在写入 Profile 之前，用 Creator mode 在内存中试验 Cordis plugins。
品类事实
DeepSeek Harness 对比 Claude Code、Codex 与 OpenCode
按公开事实做的品类对比。DeepSeek Harness 仍是带破坏性变更的 developer preview。
| 标准 | DeepSeek Harness | Claude Code | Codex | OpenCode |
|---|---|---|---|---|
| 分发 | npm CLI + 源码。 npx @deepseek-ai/dsh web | 厂商 CLI / IDE 界面 | 厂商 CLI / IDE 界面 | 社区开源 agent |
| 许可证 | 0.1.x 为 MIT | 专有产品条款 | 专有产品条款 | 开源项目许可 |
| Plugin 模型 | Cordis plugins for models, tools, skills, session, sandbox, UI | 带扩展钩子的封闭产品 | 带扩展钩子的封闭产品 | Community plugins, not Cordis |
| 会话轨迹 | 只追加日志 + Trajectory resume / fork / replay | 厂商会话 UI | 厂商会话 UI | 随构建而变 |
| 运行模式 | Standard, Code / PTC, Minimal, Creator | 单一产品模式 | 单一产品模式 | 可配置，不是这四个固定名称 |
| Production claim | Developer preview。未经安全审计。 | 正式可用产品 | 正式可用产品 | 社区支持 |
可读源码
MIT-licensed repository and npm package @deepseek-ai/dsh. npm signatures and shasums are published per version. Commands on this site are shown as text, not outbound links.
如实的 preview 状态
The README states there will be compatibility-breaking changes. GitHub Issues are closed; reports go to Discussions. Do not treat sandbox prompts as a containment guarantee. Read the 合法使用政策.
完整性校验
0.1.2-rc.1 shasum fef213043313affc36ca2226d2637ad483b5e3f6. 0.1.1-rc.2 shasum 1a5112369f1c46b13a6e6f21de8af5e6afd45074. Full notes on the 下载完整性 section.
Field notes
已经跑过的人留下的笔记
From discussions after real installs. Not marketing quotes.
Swapped the model plugin without touching the DeepSeek Harness tree. Cordis composition is the reason I stayed.
Discussion note · runtime author
Trajectory showed the exact bash payload that listed my workspace. Resume from that event worked. The UI still hiccups on very long streamed turns.
Discussion note · eval engineer
On Windows 11, C:\Windows\Temp plus windows-acl made every sandboxed pwsh call die with SandboxUnavailableError. Moving TEMP off the system temp dir fixed it.
Discussion note · Windows 11 Pro 25H2
npx brought the Web UI up in one command. Port 3080 was already reserved by Hyper-V, so I had to pick another port. That is in the port 3080 guide.
Discussion note · desktop lab
Creator mode is the only place I could inspect plugins in memory before writing a Profile. Token use on a multi-hour coding loop was higher than I budgeted.
Discussion note · preset builder
I pinned 0.1.1-rc.2 after an unpinned npx pull changed behavior overnight. The README warning is not decorative.
Discussion note · platform ops
Swapped the model plugin without touching the DeepSeek Harness tree. Cordis composition is the reason I stayed.
Discussion note · runtime author
Trajectory showed the exact bash payload that listed my workspace. Resume from that event worked. The UI still hiccups on very long streamed turns.
Discussion note · eval engineer
On Windows 11, C:\Windows\Temp plus windows-acl made every sandboxed pwsh call die with SandboxUnavailableError. Moving TEMP off the system temp dir fixed it.
Discussion note · Windows 11 Pro 25H2
npx brought the Web UI up in one command. Port 3080 was already reserved by Hyper-V, so I had to pick another port. That is in the port 3080 guide.
Discussion note · desktop lab
Creator mode is the only place I could inspect plugins in memory before writing a Profile. Token use on a multi-hour coding loop was higher than I budgeted.
Discussion note · preset builder
I pinned 0.1.1-rc.2 after an unpinned npx pull changed behavior overnight. The README warning is not decorative.
Discussion note · platform ops
简短常见问题
DeepSeek Harness 免费吗？+
Yes. DeepSeek Harness is published under the MIT License as a developer preview. You can inspect, modify, and self-host it. Early 0.0.1-rc packages used BSD-3-Clause; current 0.1.x packages are MIT.
DeepSeek Harness 能在 Windows 11 上运行吗？+
Yes, if Node.js is ^22.19.0 or >=24.0.0. The Windows sandbox uses an ACL restricted-token backend. Known issues include C:\Windows\Temp ACL lockouts, workspaces owned by BUILTIN\Administrators, and port 3080 reserved by Hyper-V, WSL2, or Docker.
DeepSeek Harness 是模型吗？+
No. DeepSeek Harness is the agent runtime around models. It supplies plugins for tools, sessions, sandboxes, storage, loops, scheduling, and the Web UI. Model IDs and API prices are separate releases.
杀毒软件为何可能标记 dsh？+
dsh is an npm CLI, not a Windows installer. Heuristic scanners sometimes flag Node processes that spawn shells. Check the published shasum for the version you pinned, such as fef213043313affc36ca2226d2637ad483b5e3f6 for 0.1.2-rc.1.