前言¶
在 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默认不执行任何破坏性操作。
