ChatGPTClaudeGrok / X / CursorGemini

dsh 安装文档地图:README、docs 与 Releases 各看哪一段,冲突时以谁为准

安装与快速上手发布于 2026-11-02作者: DeepSeek Plugin 插件市场
dsh 安装官方文档Releases版本对齐查阅方法
官方材料不止一个入口,看的段落不同结论就不同。本文按「你想知道什么」给出查阅顺序,并说明当 README、文档站与版本说明冲突时,应该相信哪一份。

同一件事在三份材料里可能有三种说法,原因通常不是谁写错了,而是它们描述的时间点不同。 先知道自己要查什么,再去对应的那一份。

dsh 文档按问题选材料与三份定位

先定位问题类型,再打开页面,比逐页翻快得多。 对照:

你想知道看哪里为什么
怎么最快跑起来README 的快速开始只给最短路径
某个参数的确切行为CLI 行为参考描述边界与优先级
这个版本改了什么Releases按版本记录
图形界面怎么用文档站的使用指南面向操作
当前版本支持哪些参数--help 输出由本机安装生成

最后一行的优先级最高。 网页可能滞后,帮助输出不会。

选之前先知道每份材料负责什么。 README 负责「能跑起来」,行为参考负责「为什么这样」,Releases 负责「什么时候变的」。三者分工:

  1. README:给出安装与启动的最短命令,适合第一次接触;它默认跟随主分支,不承诺覆盖所有边界。
  2. CLI 行为参考:写清参数边界、解析顺序、退出码与失败处理,是判断「某种写法是否合法」的依据。
  3. Releases:按版本列出变化,回答「我升级后行为变了,是不是预期内的」。

文档站是这三者的面向读者版本。 它更适合按任务阅读,但涉及参数细节时,仍应回到行为参考。

dsh 文档冲突优先级与版本对齐

判断顺序是:本机帮助输出 → 与版本匹配的行为参考 → Releases → README → 第三方教程。 理由:

  1. 本机帮助输出由你安装的那一份生成,最贴近实际;
  2. 行为参考与源码同步更新,边界描述最完整;
  3. Releases 锁定到具体版本,适合判断变更点;
  4. README 面向最新主分支,可能领先或落后于你的版本;
  5. 第三方教程连版本都没标,只能当线索。

遇到冲突先别改命令,先确认版本。 版本不同,两份文档可能都对。

版本对齐是比对的前提。 任何文档比对之前,先做三件事。步骤:

  1. dsh --version 记录本机版本;
  2. 在 Releases 里找到同名版本,读它的说明;
  3. 打开行为参考,确认描述的是否是同一代行为。

版本对不上时,文档只能参考不能照抄。 尤其参数名、默认端口、默认监听地址这三类信息,跨版本变化最频繁。

dsh 一个具体例子

假设你看到两种启动写法,想知道哪个对。 处理顺序:

  1. 执行 dsh --help,确认启动器自身支持哪些参数;
  2. 执行 dsh --profile web --help,确认 web 应用支持哪些参数;
  3. 用 --dump-config 查看组合后的配置,确认默认值;
  4. 启动一次,看输出里实际打印的地址;
  5. 只有在以上都得不出结论时,才回文档站按任务检索。

这个顺序的价值是「先本地、后远端」。 本地能验证的事,不要用阅读来解决。

dsh 易过期内容与 Releases 读法

不是所有内容都同样可信,下面几类衰减最快。 注意:

  1. 截图与界面路径:界面改版后立刻失效;
  2. 默认端口与默认监听地址:可能随版本或配置变化;
  3. 包名与命令简写:写法习惯容易在传播中变形;
  4. 插件数量与市场截图:随生态变化;
  5. 安装包文件名:随发布方式调整。

遇到这几类信息,一律回到命令与 Releases 核对。 截图只能帮你认出界面,不能作为操作依据。

Releases 正是核对时最该读的一页。 它不是变更日志的堆砌,读的时候抓三类信息:

  1. 先看版本号与日期,确认是否在你升级的区间内;
  2. 找「破坏性变更」或行为调整,这类最可能影响你的命令;
  3. 找安装与运行相关条目,插件生态变化可稍后再看。

只读标题不够。 很多行为变化写在正文段落里,标题只写「改进启动流程」。

dsh 核对清单

把「查什么去哪」写成三行,以后不用重新判断。 建议:

  1. 命令是否合法 → 本机 --help;
  2. 参数边界与优先级 → CLI 行为参考;
  3. 某个版本改了什么 → Releases 对应条目。

三行覆盖大多数安装期疑问。 剩下的界面操作类问题,再去文档站按任务找。

dsh 下一步

先对齐版本,再相信文档。 想看启动参数的实际用法,读 dsh 启动参数;想看启动失败怎么分层查,读 dsh 启动失败决策树;想看装完怎么验收,读 装完十分钟验收;想看求助时要准备什么,读 dsh 安装求助诊断包。

来源:DeepSeek Harness 官方文档、dsh CLI 行为参考、deepseek-harness Releases、deepseek-harness 仓库

ChatGPTClaudeGrok / X / CursorGemini

常见问题

安装 dsh 时,官方文档站和 GitHub README 该信哪一个?

安装 dsh 时该信哪一份,取决于问题类型:想知道怎么快速跑起来,用 README 的快速开始;想知道某个参数的确切行为,用 CLI 行为参考。两者冲突时以更接近源码、且与你的版本一致的那一份为准。

Releases 页面的说明和 README 命令不一致,是文档写错了吗?

README 与 Releases 命令不一致,多数情况是 dsh 的版本差异。Releases 描述的是那一个版本的变化,README 默认跟随主分支。先确认你装的版本,再去看对应版本的说明,不要拿主分支的写法套旧版本。

要怎么做才能确认文档里的 dsh 命令在当前安装版本中仍然有效?

用命令自带的帮助验证:dsh --help 看启动器参数,dsh --profile web --help 看 web 应用参数。帮助输出由当前安装生成,比任何网页都快且准。

为什么官方文档里写的 dsh 默认端口和我本机实际看到的不一样?

dsh 的默认端口可能随版本或 profile 组合变化,也可能被你的 patch 层覆盖。先看启动输出里实际打印的地址,再用 --dump-config 检查组合后的配置,而不是只依赖文档里的数字。

相关术语

快速开始
快速开始是文档里最短的一条可运行路径,目标是让你在几分钟内看到界面,不解释参数细节与边界情况。— DeepSeek Harness 官方文档
CLI 行为参考
CLI 行为参考是描述启动器与各 profile 参数确切行为的文档,包括参数边界、优先级与失败后的退出方式。— dsh CLI 行为参考
Releases
Releases 是仓库按版本发布的说明页,记录该版本的新增、变更与修复,描述的是某一个具体版本而不是当前主分支。— deepseek-harness Releases
dump-config
dump-config 是不启动服务、直接打印组合后配置树的检查手段,用来确认多层 patch 叠加后的实际取值。— dsh CLI 行为参考

来源