前言¶
在 DeepSeek Harness (DSH) 開發中，環境問題常導致操作失敗。與其猜測，不如先探明環境。dsh-envkit 是一個環境工具插件，旨在解決網絡、代理、可寫性和 Git 元數據丟失等常見問題。
插件信息¶
- 名稱: dsh-envkit
- 所有者: Caoran1314
- 類別: 工作流
- 許可證: MIT
核心功能¶
env_probe¶
一次性探明環境狀態，包括：
- 網絡端點（npm / GitHub API / raw / codeload / jsDelivr / PyPI）
- 代理環境變量
- 臨時目錄 / 家目錄 / 當前目錄可寫性
- 子進程管道 spawn 能力
- 平臺 / Node 版本
探測方式爲只讀（GET 請求 + 臨時文件寫入後立即刪除），並返回針對性建議。
safe__edit¶
用於安全改寫 JSON 文件，主要解決 UTF-8 BOM 導致的解析錯誤。
- 讀取時容忍 BOM
- 寫回時保證無 BOM、原子替換
- 默認留一份備份
- 支持點路徑操作
- 支持 inspectOnly 選項（僅檢查，不改文件）
git_repair¶
檢測並重建丟失的 .git 元數據。
- 識別 metadata-lost-objects-intact 狀態（objects/refs 完整但 HEAD/config/index 缺失）
- 提供重建步驟
- 默認 dryRun: true，只列命令不執行
- 僅執行 init / fetch / reset，不刪除任何內容
安裝與啓用¶
安裝命令如下：
dsh plugin --profile desktop add dsh-envkit
安裝完成後重啓 DSH。設置頁會出現「環境工具」面板，可視化展示探測結果及檢查 BOM 與 bundles 狀態。無 UI 時也可使用命令：
- env-probe
- env-json-check <file>
- env-git-check [dir]
典型用法¶
safe__edit 示例¶
{
"file": "C:\\Users\\you\\.dsh\\profiles\\desktop\\package.json",
"set": { "dsh.profile.bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-edict"] },
"del": ["dependencies.something-old"]
}
git_repair 重建步驟¶
git init
git branch -M main
git remote add origin <remote>
git fetch origin
git reset --mixed origin/main
注意事項¶
env_probe僅做只讀探測。safe__edit會改文件，安裝前請確認。git_repair默認不執行任何破壞性操作。
