前言¶
開發過程中常遇到端口被殘留進程佔用、環境配置不清晰或需頻繁確認系統狀態的情況。dsh-env-inspector 是一個面向 DeepSeek Harness (DSH) 的環境自檢插件，提供系統環境、CLI 工具鏈、模型 Key 狀態以及活躍端口的可視化儀表盤，支持一鍵安全釋放端口。
核心能力¶
端口探測與釋放¶
插件基於系統底層 API 實時探測所有監聽端口。界面區分核心服務端口與動態端口，高位動態端口支持摺疊與展開。對於佔用的端口，支持一鍵安全釋放（Kill 進程）。
* 安全機制：核心端口（如 DSH 的 :3080）及 DSH 宿主進程被永久鎖定，禁止終止；系統核心 PID 也會被強制攔截。
* 狀態同步：釋放端口後，頁面會自動刷新，無需手動重載。
環境與工具鏈看板¶
頂部 Tab 獨立展示環境概覽，包含：
* 系統狀態：操作系統信息。
* CLI 工具鏈：實時探測 12 款常用開發 CLI（如 Node、Git、Docker 等）的就緒狀態。
* 大模型 Key：全局展示已配置模型 Key 的存在性，不輸出明文。
插件與網絡接口¶
- 插件列表：列出當前 Web / Local profile 下加載的 DSH 擴展插件及其實際生效版本。
- 網絡信息：區分展示局域網 IP 與公網出口 IP。公網出口 IP 僅在用戶點擊時檢測。
安裝與啓用¶
通過 DSH 插件管理器安裝：
npx @deepseek-ai/dsh plugin --profile <你的 profile> add @dsh-plugins/dsh-env-inspector
安裝完成後，進入頁面，點擊頂部導航欄中的 「🖥️ 電腦環境」 Tab，即可開始使用。
安全與架構¶
- 零運行時依賴：代碼完全基於 Node.js 原生 API 與純 React 構建，無第三方包膨脹。
- 本地自檢：默認不聯網，本地自檢不訪問外部服務；網絡出口檢測僅在用戶點擊時發生。
- 隱私保護：所有接口與組件絕不輸出、不讀取、不傳遞任何密鑰明文；所有接口強制校驗
Sec-Fetch-Site: same-origin，杜絕惡意跨站探測。
適用場景¶
該插件適用於需要快速排查端口占用、確認開發環境一致性或檢查大模型配置的場景。插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
結尾¶
dsh-env-inspector 通過可視化儀表盤，將系統狀態與端口管理集成在 DSH 界面中，減少了頻繁切換終端或查閱文檔的時間。
- 項目主頁：https://github.com/webkubor/dsh-env-inspector
- 插件目錄：https://www.skillhub.cn/plugins/webkubor/dsh-env-inspector
