dsh 安装求助前准备什么:版本、日志、目录树与网络四件套,外加一道必须自己先做好的脱敏再发
求助的效率不取决于描述得多详细,而取决于材料是否覆盖那四个判断点。 版本、日志、目录结构、网络端口,四件齐了,多数问题不用来回追问。
dsh 求助材料为什么决定速度
「装不上」这三个字对应至少六种原因,材料的作用是帮你快速排除,而不是证明自己操作正确。
dsh 求助材料一与二:版本环境与启动日志
版本信息是唯一能界定「你面对的是哪一代行为」的材料。 需要提供:
dsh --version的输出,或说明当前只有 npx;node -v与npm -v;- 操作系统与架构;
- 安装方式:npx、全局 npm、桌面端;
which -a dsh的输出。
最后一条最容易被忽略。 它直接暴露是否存在多份安装,而多份并存是「版本对不上」的主要原因。
版本说不清,就用日志补上。 日志要取「第一条错误及其上下文」,不是最后一行。采集方法:
- 复现一次失败,保留终端完整输出;
- 打开
$DSH_HOME/logs/,按时间找到最新的startup-*.log; - 从第一条错误往前保留十几行,往后保留完整堆栈;
- 记录退出码,失败通常是 1;
- 若终端有「Full diagnostics:」提示,按它指向的路径取文件。
诊断文件是完整版,终端输出是摘要。 两者都给最好,只给一个时优先给诊断文件;如果启动失败但没有生成日志,也要说明,它本身就是一条有效信息。
dsh 求助材料三与四:目录结构与网络端口
目录结构回答的是「profile 有没有初始化、插件装在哪」。 采集方法:
- 打印 DSH_HOME 实际路径:
echo $DSH_HOME,空值时说明用默认~/.dsh; - 列出
profiles/下的目录名; - 对目标 profile 列一层目录,看是否有
package.json与 patch 文件; - 确认
logs/是否存在; - 只保留层级与文件名。
不要提供文件内容,但目录名本身就是线索。 配置里有设置、凭据文件里有密钥,都不该出现在求助材料里;而只有 web 没有 headless 这类差异,能立刻缩小问题范围。
目录说明装在哪,剩下的交给网络与端口。 网络与端口决定「包能不能拿到、服务能不能起来」。需要提供:
npm config get registry的输出(内网地址可打码);- 是否设置代理:只回答「有/无」,不要贴完整代理地址;
lsof -i :3080的结果,或你实际使用的端口;curl -I http://127.0.0.1:<端口>的状态行;- 是否能访问 registry:一句话说明即可。
端口冲突与网络不通的表现很像。 一个看进程占用,一个看 registry 可达性,两者都要有结论。
dsh 一次采集与脱敏
按下面顺序执行,输出可以直接整理成一份材料。 步骤:
- 采集版本与环境五条命令;
- 复现失败,保存终端输出;
- 取最新诊断文件;
- 打印目录结构(只到文件名);
- 采集端口与网络状态;
- 统一脱敏,再发送。
顺序固定,材料才完整。 想到哪采到哪,往往会漏掉最关键的端口状态。
采完还差最后一步。 官方明确说明诊断报告不做脱敏,这一步只能由你自己做。必须处理:
| 内容 | 处理方式 |
|---|---|
| API Key、令牌 | 整段删除,不要只遮中间几位 |
| 内网主机名与 IP | 替换为占位符 |
| 个人目录路径 | 替换为 ~ 或 <home> |
| 会话正文 | 全部删除,只留条数 |
| 代理地址与账号 | 删除或替换 |
只遮住中间字符不算脱敏。 前缀与后缀同样能定位到具体账号,尤其是密钥类信息。
删完再通读一遍。 报告里可能出现你没想到的字段,例如启动参数中包含的路径。
dsh 提交求助的写法
材料齐了,描述也要能对上。 建议结构:
- 一句话目标:想做什么;
- 一条命令:你实际执行的完整命令;
- 一句现象:看到什么,期望什么;
- 已排除项:试过哪些、结果如何;
- 附件:四件套。
「已排除项」能省掉一半往返。 对方知道你试过什么,就不会重复建议。
不要把多个问题混在一条里。 一个问题一份材料,定位更快。
dsh 下一步
先把四件套备齐,再描述问题。 想看启动失败怎么自己先分层排查,读 dsh 启动失败决策树;想看文档该查哪一份,读 dsh 安装文档地图;想看装完怎么验收,读 装完十分钟验收;想看端口冲突怎么处理,读 修复 dsh 端口冲突。
常见问题
必需插件启动失败时,CLI 会在终端列出失败插件与堆栈,并把完整诊断写到 $DSH_HOME/logs/ 下唯一的 startup-<时间戳>-<uuid>.log,随后以退出码 1 结束。终端提示只是摘要。
dsh 的诊断报告不能直接发,官方说明该报告不做脱敏,可能包含配置值甚至凭据片段。发送前必须逐段检查,删除密钥、令牌、内网地址与个人路径。
dsh 求助时,贴第一条错误附近的完整段落最有用,通常从第一条报错往前保留十几行上下文即可。整屏日志会淹没关键信息,只贴最后一行又常常是连锁失败的尾声。
只需要目录层级与文件名,用来判断 profile 是否初始化、插件装在哪个 profile。文件内容一律不发,配置和凭据都在里面。
相关术语
- 诊断报告
- 诊断报告是启动失败时 CLI 自动写出的文件,包含版本、平台、profile、未激活插件状态与原始错误,不做脱敏。— dsh CLI 行为参考
- 四件套
- 四件套是求助时最有用的四类材料:版本与环境、启动日志、目录结构、网络与端口状态,覆盖绝大多数判断。— DeepSeek Harness 官方文档
- 脱敏
- 脱敏是在发送材料前删除或替换密钥、令牌、主机名、内网地址与个人路径,避免在求助过程中泄露凭据。— dsh CLI 行为参考
- profile
- profile 是 DeepSeek Harness 的具名组装环境,位于 $DSH_HOME/profiles/<名称>,各自维护独立依赖与配置。— dsh CLI README
来源
- dsh CLI 行为参考· deepseek-ai
- dsh CLI README· deepseek-ai
- DeepSeek Harness 官方文档· deepseek-harness