dsh 安装文档地图:README、docs 与 Releases 各看哪一段,冲突时以谁为准
同一件事在三份材料里可能有三种说法,原因通常不是谁写错了,而是它们描述的时间点不同。 先知道自己要查什么,再去对应的那一份。
dsh 文档按问题选材料与三份定位
先定位问题类型,再打开页面,比逐页翻快得多。 对照:
| 你想知道 | 看哪里 | 为什么 |
|---|---|---|
| 怎么最快跑起来 | README 的快速开始 | 只给最短路径 |
| 某个参数的确切行为 | CLI 行为参考 | 描述边界与优先级 |
| 这个版本改了什么 | Releases | 按版本记录 |
| 图形界面怎么用 | 文档站的使用指南 | 面向操作 |
| 当前版本支持哪些参数 | --help 输出 | 由本机安装生成 |
最后一行的优先级最高。 网页可能滞后,帮助输出不会。
选之前先知道每份材料负责什么。 README 负责「能跑起来」,行为参考负责「为什么这样」,Releases 负责「什么时候变的」。三者分工:
- README:给出安装与启动的最短命令,适合第一次接触;它默认跟随主分支,不承诺覆盖所有边界。
- CLI 行为参考:写清参数边界、解析顺序、退出码与失败处理,是判断「某种写法是否合法」的依据。
- Releases:按版本列出变化,回答「我升级后行为变了,是不是预期内的」。
文档站是这三者的面向读者版本。 它更适合按任务阅读,但涉及参数细节时,仍应回到行为参考。
dsh 文档冲突优先级与版本对齐
判断顺序是:本机帮助输出 → 与版本匹配的行为参考 → Releases → README → 第三方教程。 理由:
- 本机帮助输出由你安装的那一份生成,最贴近实际;
- 行为参考与源码同步更新,边界描述最完整;
- Releases 锁定到具体版本,适合判断变更点;
- README 面向最新主分支,可能领先或落后于你的版本;
- 第三方教程连版本都没标,只能当线索。
遇到冲突先别改命令,先确认版本。 版本不同,两份文档可能都对。
版本对齐是比对的前提。 任何文档比对之前,先做三件事。步骤:
dsh --version记录本机版本;- 在 Releases 里找到同名版本,读它的说明;
- 打开行为参考,确认描述的是否是同一代行为。
版本对不上时,文档只能参考不能照抄。 尤其参数名、默认端口、默认监听地址这三类信息,跨版本变化最频繁。
dsh 一个具体例子
假设你看到两种启动写法,想知道哪个对。 处理顺序:
- 执行
dsh --help,确认启动器自身支持哪些参数; - 执行
dsh --profile web --help,确认 web 应用支持哪些参数; - 用
--dump-config查看组合后的配置,确认默认值; - 启动一次,看输出里实际打印的地址;
- 只有在以上都得不出结论时,才回文档站按任务检索。
这个顺序的价值是「先本地、后远端」。 本地能验证的事,不要用阅读来解决。
dsh 易过期内容与 Releases 读法
不是所有内容都同样可信,下面几类衰减最快。 注意:
- 截图与界面路径:界面改版后立刻失效;
- 默认端口与默认监听地址:可能随版本或配置变化;
- 包名与命令简写:写法习惯容易在传播中变形;
- 插件数量与市场截图:随生态变化;
- 安装包文件名:随发布方式调整。
遇到这几类信息,一律回到命令与 Releases 核对。 截图只能帮你认出界面,不能作为操作依据。
Releases 正是核对时最该读的一页。 它不是变更日志的堆砌,读的时候抓三类信息:
- 先看版本号与日期,确认是否在你升级的区间内;
- 找「破坏性变更」或行为调整,这类最可能影响你的命令;
- 找安装与运行相关条目,插件生态变化可稍后再看。
只读标题不够。 很多行为变化写在正文段落里,标题只写「改进启动流程」。
dsh 核对清单
把「查什么去哪」写成三行,以后不用重新判断。 建议:
- 命令是否合法 → 本机
--help; - 参数边界与优先级 → CLI 行为参考;
- 某个版本改了什么 → Releases 对应条目。
三行覆盖大多数安装期疑问。 剩下的界面操作类问题,再去文档站按任务找。
dsh 下一步
先对齐版本,再相信文档。 想看启动参数的实际用法,读 dsh 启动参数;想看启动失败怎么分层查,读 dsh 启动失败决策树;想看装完怎么验收,读 装完十分钟验收;想看求助时要准备什么,读 dsh 安装求助诊断包。
来源:DeepSeek Harness 官方文档、dsh CLI 行为参考、deepseek-harness Releases、deepseek-harness 仓库
常见问题
安装 dsh 时该信哪一份,取决于问题类型:想知道怎么快速跑起来,用 README 的快速开始;想知道某个参数的确切行为,用 CLI 行为参考。两者冲突时以更接近源码、且与你的版本一致的那一份为准。
README 与 Releases 命令不一致,多数情况是 dsh 的版本差异。Releases 描述的是那一个版本的变化,README 默认跟随主分支。先确认你装的版本,再去看对应版本的说明,不要拿主分支的写法套旧版本。
用命令自带的帮助验证:dsh --help 看启动器参数,dsh --profile web --help 看 web 应用参数。帮助输出由当前安装生成,比任何网页都快且准。
dsh 的默认端口可能随版本或 profile 组合变化,也可能被你的 patch 层覆盖。先看启动输出里实际打印的地址,再用 --dump-config 检查组合后的配置,而不是只依赖文档里的数字。
相关术语
- 快速开始
- 快速开始是文档里最短的一条可运行路径,目标是让你在几分钟内看到界面,不解释参数细节与边界情况。— DeepSeek Harness 官方文档
- CLI 行为参考
- CLI 行为参考是描述启动器与各 profile 参数确切行为的文档,包括参数边界、优先级与失败后的退出方式。— dsh CLI 行为参考
- Releases
- Releases 是仓库按版本发布的说明页,记录该版本的新增、变更与修复,描述的是某一个具体版本而不是当前主分支。— deepseek-harness Releases
- dump-config
- dump-config 是不启动服务、直接打印组合后配置树的检查手段,用来确认多层 patch 叠加后的实际取值。— dsh CLI 行为参考
来源
- DeepSeek Harness 官方文档· deepseek-harness
- dsh CLI 行为参考· deepseek-ai
- deepseek-harness Releases· deepseek-ai
- deepseek-harness 仓库· deepseek-ai