这个站是怎么写的
DSHKit 存在的理由，是 DeepSeek Harness 的第一波报道基本都是照着通稿写的。这一页是本站的编辑准则，写得足够直白，好让你能检查我们有没有照做。
只有一条规矩
本站每一条技术论断都能追溯到上游仓库或官方文档。文档没写的地方，我们直说，不猜。
这听起来是废话。但它恰恰是第一周那批 DeepSeek Harness 文章没做到的事——它们互相转述，错误就这么传开了。我们自己也因为同样的原因改过两次页面，两次都是读到某个源文件、发现它和我们的推断相矛盾。
我们读了什么
以下是本站内容的一手来源，全部在上游仓库里，任何一条论断你都可以拿它们核对。
| 文件 | 我们从中取用的部分 |
|---|---|
README.md | 安装、npx、源码构建 |
docs/architecture.md | profile、bundle、四层 patch 顺序、--dump-config |
apps/cli/README.md | 全部子命令与 flag、$DSH_HOME 路径、退出码、参数顺序 |
docs/user/guide/providers.md | settings.yaml、.credentials.yaml、apiKeyEnv、provider ID |
docs/tool-catalog.md | 全部面向模型的工具及其所属包 |
docs/config-catalog.md | 可配置插件、字段、patch YAML 形态 |
docs/glossary.md | turn、step、round、seam、scope、goal、Ralph |
我们不会断言的东西
关于这个 harness 的一些流传说法，我们追溯不到来源。与其含糊其辞，不如先不写；等来源出现了再补页面。
- 任何「预设可以在对话中途随便换」的说法。切换只允许在 agent 还什么都没产出时进行，否则网关会回 agent-preset-locked——这是产品规则，不是能绕过去的限制。
- 环境变量 DEEPSEEK_API_KEY 是否被自动读取。provider 文档写的是：目录内服务商通过 Settings 存 key，自定义服务商读 apiKeyEnv 指定的变量。至于「环境变量里已有 key 就能免填」这个广为流传的说法，我们找不到来源。
- 任何「子 agent 会继承父会话对话」的说法。Codex 和 Claude Code 两个 provider 都报告 inheritsParentContext: false——它们只收到一段独立的文本任务和父会话的 cwd，别的没有。
- 任何跑分数字、延迟数据或模型定价。
更正
页面写错了，我们就改页面并更新修改日期，而不是悄悄绕过去。这是 v0.1 开发者预览版，预期会有破坏性变更，所以描述 flag、文件路径、插件名的页面一定会过时——本站和仓库对不上时，以仓库为准。
谁在写
本站目前没有署名维护者。这是我们知道的一个缺口，不是什么原则——匿名的技术写作更难被信任，也更难被问责。
我们统计什么
本站使用自建的 Plausible 实例做聚合流量统计：页面浏览、来源、国家，以及点击离站链接的次数。它不写 cookie、不采集个人数据、不生成跨站或持久化标识符——所以这里没有需要你同意的东西，也不会弹任何横幅。本站不投广告，也不出售或共享任何统计数据。
独立性
DSHKit 与 DeepSeek 无隶属、背书或赞助关系。我们不收 DeepSeek 或站内提及的任何厂商的钱，站内也没有任何联盟推广链接。「DeepSeek」「DeepSeek Harness」为其权利人所有的商标。官方项目在 github.com/deepseek-ai/deepseek-harness.