DeepSeek Harness 笔记

你写的「deephrness」对应的是 DeepSeek Harness（CLI：dsh）。

本地仓库：~/chyworkspace/deepseek-harness · 上游：deepseek-ai/deepseek-harness · 文档：deepseek-harness.github.io

它是什么

DeepSeek Harness 是 DeepSeek AI 的开源 agent harness：运行时建立在 everything-is-a-plugin 上，插件系统由 Cordis 驱动（论文：Spatiotemporal Composability）。

和「单个 Chat 客户端」不同：harness 管的是 Agent 怎么组插件、怎么跑、怎么扩展。当前处于 developer preview，会有破坏性变更——跟 upstream 时要看 CHANGELOG。

运行前先读仓库安全说明。

快速启动

npm 一键

npx @deepseek-ai/dsh web

默认 Web UI：http://127.0.0.1:3080。本机启动会尝试打开浏览器；SSH 场景只打印 URL（转发端口你自己管）。不要开浏览器：--no-open。

源码（你本机已有 clone）

cd ~/chyworkspace/deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build 准备产物；pnpm dsh web 用已构建产物，不会隐式全量重建。

心智模型：一切皆插件

概念	含义
Harness	宿主进程 + 生命周期
Plugin	能力单元（工具、UI、模型适配、存储…）
Cordis	时空可组合的插件编程范式

做扩展时：

先读官方文档 / 仓库 docs/architecture.md
Agent 向贡献跟 AGENTS.md
公开发布的插件打上 GitHub topic：dsh-plugin

和 OpenClaw / 其它 Agent 怎么分工

工具	更适合
DeepSeek Harness	研究 / 自建插件化 Agent 运行时，跟 DeepSeek 生态
OpenClaw	带人格的常驻助手 + 技能包
Adnify	桌面 IDE 内改代码、Plan/Agent
browser-search	给任意 Agent 的确定性联网技能

可以叠：Harness 或 OpenClaw 当宿主，browser-search 当联网插件——关键是 技能接口是否对得上，不要假设一份 SKILL.md 处处能用。

日常检查

想做什么	做法
升依赖后是否还能起	`pnpm run build && pnpm dsh web`
跟官方预览变更	看 Discussions + SAFETY
插件是否被发现	仓库加 `dsh-plugin` topic
安全	不把高权限 shell 插件默认全开；先本地、再放开网络

待补

本机常用插件列表与启动参数
和 OpenClaw 技能互通的实践笔记
一次完整「写插件 → 本地加载 → 回归」流程

Keep building2025 – ∞