dshkit
EN
开发者预览版 · MIT

一切
皆插件。

DeepSeek Harness 把模型包成编程 agent——而这层包装的每一部分，都是你能覆盖的一行配置。这里是非官方手册：能跑通的安装步骤、你真会撞上的报错，以及官方文档没说的部分。

安装
npm install -g @deepseek-ai/dsh
然后
dsh web

web profile 首次启动按内置模板自建，服务开在 127.0.0.1:3080。

所有人都会栽的那一处

四个层决定了你的 agent 到底是什么

解析顺序

对所有 profile 生效，而且会盖掉 profile 自己的 patch 文件。这层最容易被忘掉——你刚改完的那行，会被这里的设置悄悄压过去。

打印组装结果dsh --profile web --dump-config
Agent 模式

四种包装，同一个模型

模式不是被特判的代码，而是一组特定的插件行组合——所以你才能造出第五种。

标准模式

文件编辑、shell、文件与网页搜索、skills、计划、目标、子 agent、workflow。

适用

默认档，也是几乎所有正经活的正确选择。

Code 模式

官方中文名 PTC 模式

能力相同，但工具经由 Code Mode SDK 暴露——模型写一段 TypeScript 程序，替代多轮工具往返。

适用

步骤事先可知的长链条机械任务。

极简模式

两个工具：常驻 bash 和 str_replace_editor。模型和 shell 之间不隔任何东西。

适用

诚实地给模型跑分。教学。

Creator 模式

标准模式 + 运行时自省与内存中的插件实验。

适用

发现这四个都差一点意思之后，造第五个。

本站全部内容

25 篇，对着源头写的

每一页都能追溯到上游仓库或官方文档。文档没写的地方，我们直说，不猜。

常见问题

DeepSeek Harness 免费吗？

harness 本体是 MIT 开源、免费运行的。模型 token 仍然要花钱——除非你把它指向本地模型或已有额度的服务商。

用 dsh 一定要 DeepSeek API key 吗？

需要模型凭证，但不必是 DeepSeek 的。Settings → Add provider 可以填 Anthropic、OpenAI 等目录内服务商的 key；自定义服务商则通过 apiKeyEnv 指定一个你自己命名的环境变量来读 key。

Code 模式和 PTC 模式有什么区别？

是同一个预设。自带预设目录名叫 code，而它自己的 preset.yml 里中文显示名就是「PTC 模式」——两个名字都是官方的，只是分属不同语言，不是社区起的外号。

稳定到能干正经活了吗？

它是 v0.1 开发者预览版，维护者明说核心插件和 API 会持续演进。锁死版本，把 profile 纳入版本控制。

这是 DeepSeek Harness 官网吗？

不是。官方仓库是 github.com/deepseek-ai/deepseek-harness。DSHKit 独立运营，无隶属关系。