前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的理念。新用户在首次启动时，常因环境配置问题（如缺少 Node.js、API Key 未设置、工作区权限等）无法顺利开始。现有的诊断工具多关注插件健康或网络，缺少一个面向用户的“新手引导”清单。dsh-firstrun 旨在解决这一环节。
是什么¶
这是 DeepSeek Harness (dsh) 的首次运行健康检查工具。它是一个单一命令，能告诉新用户当前缺少什么以及下一步应该运行什么。由用户 zoahdev 维护，采用 MIT 许可证。
核心功能¶
核心功能包括：
* 工具链验证：检查 Node.js、pnpm、dsh CLI 是否在 PATH 中。
* 配置校验：检查 Home 目录、dsh Profile、API Key（仅校验名称，不打印值）、工作区可写性及 npm 注册表配置。
* 引导输出：输出可执行的下一步建议。
* 运行模式：零运行时依赖，以只读模式运行，不会输出任何敏感的 API Key 值。
* 接口支持：提供命令行工具和 agent 可调用接口，并返回 dsh-firstrun/v1 格式的结构化报告。
安装与启用¶
安装插件：
dsh plugin add dsh-firstrun
也可以直接作为独立命令运行：
npx dsh-firstrun
典型用法¶
在命令行中，直接运行：
dsh-firstrun
# 或输出 JSON 格式
dsh-firstrun --json
在 DSH agent 中，可以直接对话：
帮我体检一下环境，看看还缺什么。
这将触发 quickstart 工具，返回 dsh-firstrun/v1 报告。
适用场景与注意¶
适合刚安装 DeepSeek Harness、不确定环境是否配置正确的新用户使用。
- 前置要求：需确保 Node.js 版本 >= 18。
- 权限说明：插件运行时以当前 dsh 进程权限为准。
- 安全性：具有零运行时依赖，以只读模式运行，不会输出任何敏感的 API Key 值。
- 源码审查：源码托管在 GitHub，使用 MIT 许可证，可自行审查。
结尾¶
dsh-firstrun 通过一条命令闭环了环境配置的排查流程，避免了新手在环境问题上浪费时间。完整的配置与源码可查阅其 GitHub 仓库。
