前言¶

DeepSeek Harness 是一个功能强大的本地模型运行环境。但在日常开发或测试中，如果依赖单一模型或提供商，成本可能会上升，环境也可能变得脆弱。FreeDSH（dsh-h-v1）作为 DeepSeek Harness 的社区扩展，在原有基础上增加了一层实用的分发机制，旨在解决模型成本和稳定性问题。

是什么¶

FreeDSH 是一个由 marcosmmjr2023 维护的插件，专注于免费优先的多模型路由、本地网关集成以及安全的核心更新。它不隶属于 DeepSeek 官方，仅作为扩展层存在。

核心功能¶

该插件主要提供以下能力：

1. 智能模型路由：采用免费优先策略，支持任务感知和自动故障转移。
2. FreeLLMAPI 集成：作为本地网关，连接多个免费/低成本提供商。
3. UI 覆盖层：在 DeepSeek Harness 界面中显示状态徽章、快捷键和模型控制。
4. 安全核心更新：支持并行 A/B 风格实例测试，避免直接覆盖工作环境。
5. 版本化覆盖层：将设置、插件和预设作为代码管理。
6. 同步与回滚工具：提供本地快照和 git 历史记录，支持环境恢复。
7. 多语言支持：包含巴西葡萄牙语（pt-BR）本地化。

安装与启用¶

根据你的系统环境，可以通过以下命令进行安装。

Windows¶

在 PowerShell 中运行：

powershell -ExecutionPolicy Bypass -Command "$f=\"$env:TEMP\dsh-setup.ps1\"; irm https://raw.githubusercontent.com/marcosmmjr2023/dsh-h-v1/main/installer/dsh-setup.ps1 -Headers @{'Cache-Control'='no-cache'} -OutFile $f; & $f"

Linux¶

在终端中运行：

bash <(curl -fsSL https://raw.githubusercontent.com/marcosmmjr2023/dsh-h-v1/main/installer/dsh-setup.sh)

作为 DSH Bundle 安装¶

如果你已经拥有可运行的 DeepSeek Harness，且只需插件功能，可以直接注册：

dsh plugin --profile web add github:marcosmmjr2023/dsh-h-v1

典型用法¶

安装完成后，可以通过以下命令进行管理：

dsh up          # 打开 GUI 界面
dsh update      # 更新仓库/核心/覆盖层
dsh doctor      # 运行诊断检查
dsh env list    # 列出并行实例

若需卸载 Bundle 插件：

dsh plugin --profile web remove freedsh

注意事项与适用场景¶

• 非官方项目：FreeDSH 不隶属于 DeepSeek 或幻方AI，仅供社区使用。
• 凭证安全：所有凭证必须保持在本地，绝不可提交到代码仓库。
• 免费层级限制：免费层级会随时间变化，插件不会绕过提供商的条款。
• 环境稳定性：设计原则是绝不静默破坏现有工作环境。
• 运行权限：插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证（MIT）。

短结尾¶

FreeDSH 适合希望降低模型调用成本、提升环境配置管理能力的 DeepSeek Harness 用户。更多技术细节请参考项目目录或 GitHub 仓库。