DeepSeek Harness 是什么
DeepSeek Harness 就是 dsh 这个 Node 命令行工具:它启动一组分层的插件(profile),在本机跑 agent 会话。
DeepSeek Harness 是 dsh 命令背后的程序。它在本机跑 agent 循环,把每段对话存成磁盘上的会话文件,本体由插件拼成,而不是一个固定的二进制。
npm 包名是 @deepseek-ai/dsh,bin 指向 dsh,要求 Node.js 24.9.0 或更高版本。目前发布版本:0.2.2-rc.1(latest)、0.2.2-rc.3(next)、0.2.2-alpha.3(alpha)。
它是一个 profile,不是一种模式
dsh <名字> 启动 $DSH_HOME/profiles/<名字> 下的 profile。一个 profile 就是一个目录,里面两个文件:package.json(插件依赖,加一份 dsh.profile.bundles 清单)和 cordis.patch.yml(你自己的补丁层)。
随包提供的是 web、headless、sdk、sdk-minimal、acp 五个。desktop 这个名字留给 Electron 应用,命令行会拒绝启动它。这五个首次使用时会从模板自动初始化。
文件都放在哪
所有东西都在 $DSH_HOME 下,默认是 ~/.dsh。profile 在 profiles/,会话在 sessions/,工作区索引在 storages/。
一个会话不是一个文件:负载是 session*.jsonl.zstd,列表条目是 storages/workspace.json 里的一个 id,标题和统计在 storages/session_projcache.json。把这三样当成一样,就是「我的会话不见了」的来源。
它怎么拼起来
profile 树从空根开始叠:按 dsh.profile.bundles 顺序叠每个 bundle 的补丁,然后叠 profile 的 cordis.patch.yml,再叠 $DSH_HOME/cordis.patch.yml,最后叠你传的 --patch。
--dump-default-config、--dump-config、--dump-config-schema 可以在不启动的情况下打印这棵合成树,这是看某个插件到底改了什么最快的办法。
常见问题
DeepSeek Harness 和 DeepSeek 的聊天应用是一回事吗?
不是。聊天应用是托管服务。DeepSeek Harness 是本机命令行工具,会话跑在你自己的机器上,存在你自己的 ~/.dsh 目录里。
需要装 Node.js 吗?
需要。这个包要求 Node.js 24.9.0 或更高版本,没有绕开 Node 的独立安装包。
web profile 是做什么的?
dsh web 从本机提供浏览器界面,支持 --port、--host、--no-open、--public-url 和可选的 TLS 证书参数。
会话存在哪?
在 $DSH_HOME/sessions/ 下,文件名是 session*.jsonl.zstd。会话列表是另一个文件 storages/workspace.json。