前言¶
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 倉庫。
