免费模型路由marcosmmjr2023/dsh-h-v1

🐋 FreeDSH

使用免费和低成本 AI 模型运行 DeepSeek Harness —— 具备自动路由、回退和安全更新功能。

FreeDSH 是本仓库（dsh-h-v1）面向社区的名称。它在 DeepSeek Harness 之上添加了一个实用的分发层：免费模型路由、本地提供商网关、更友好的 UI、pt-BR 支持、版本化配置以及可安全回滚的更新。

非官方项目。 FreeDSH 与 DeepSeek 无关联，也未获得其认可。

Windows
Linux
Contributions welcome
License
Latest release
Discussions

Português: README.pt-BR.md

FreeDSH 实际运行效果 —— FreeLLMAPI、Smart Router、模型控制和安全核心更新

为什么选择 FreeDSH？

DeepSeek Harness 功能强大，但当你依赖单一模型/提供商时，日常使用可能会变得昂贵或脆弱。FreeDSH 专注于一种不同的体验：

| | FreeDSH 新增功能 |
|---|---|
| 🎁 免费优先路由 | 在付费回退之前，优先使用 FreeLLMAPI、OpenRouter :free、OpenCode free/zen 以及其他已配置的提供商。 |
| 🔁 自动回退 | 如果某个提供商失败或变得不可用，路由器可以切换到另一个已配置的选项。 |
| 🧠 任务感知路由 | auto、eco 和 ultra 配置文件让路由器可以为不同工作负载选择不同的模型层级。 |
| 🖥️ 集成面板 | 在 Harness UI 中显示提供商/路由器/核心状态、最近文件和模型控制。 |
| 🛡️ 更安全的核心更新 | 在并行实例中测试新核心，而不是覆盖正在工作的环境。 |
| ↩️ 回滚 | 本地快照 + git 历史/标签使返回已知良好配置成为可能。 |
| 🌎 国际化 UI | 支持巴西葡萄牙语、英语和中文，并尽可能跟随操作系统语言。 |
| 💻 Windows + Linux | 为两个平台提供交互式单行安装程序。 |

一张图说明理念

flowchart LR
U[You / DeepSeek Harness] --> R[FreeDSH Smart Router]
R --> F[FreeLLMAPI]
R --> O[OpenRouter :free]
R --> C[OpenCode free / zen]
R --> P[Optional paid fallback]
F --> G[Groq / Cerebras / Mistral / others]
免费套餐会随时间变化。FreeDSH 不会绕过提供商条款，也不会在不存在免费访问的情况下创建免费访问；它只是集成并路由你配置的提供商/密钥。

1 分钟安装

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"

交互式安装程序会检测现有安装，并可以安装、更新、保留本地配置、管理并行实例或打开 GUI。

安装后，打开一个新的 PowerShell：

dsh up          # open the GUI
dsh update      # update repo/core/overlay
dsh doctor      # diagnostics
dsh env list    # list parallel instances

Linux

类 Debian/Ubuntu 系统：

bash  提供商凭据保留在本地，绝不能提交。在将任何 FreeLLMAPI/admin 接口暴露到 localhost 之外前，请参阅 SECURITY.md。

已经运行 DeepSeek Harness？

FreeDSH 也以 DSH bundle 形式发布，适合那些已经有可用 harness、只想获取插件（Smart Router、OpenRouter groups、模型可见性、FreeLLMAPI 快捷方式、右侧面板、版本徽章）的用户。无需安装程序，无需复制 overlay：
bash
dsh plugin --profile web add github:marcosmmjr2023/dsh-h-v1

使用 dsh plugin --profile web remove freedsh 将其移除。该 bundle 仅注册插件——它绝不会触碰你的密钥、提供商或设置。要求、包含内容、状态存放位置及常见问题：docs/INSTALL-BUNDLE.md。

里面有什么？

- Smart Model Router — 免费优先、任务感知的模型选择与运行时回退。
- FreeLLMAPI 集成 — 面向多个免费/低成本提供商的本地网关。
- UI overlay — DeepSeek Harness 内的状态徽章、快捷方式和模型控件。
- 安全核心更新器 — 并行 A/B 式核心实例，带实时进度。
- 版本化 overlay — 将设置、插件和预设作为代码进行管理。
- 同步 + 回滚工具 — 本地快照、git 标签/历史记录及恢复工具。
- pt-BR 本地化 — 实验性的 DeepSeek Harness 本地化及翻译文档。

技术概览：docs/ARCHITECTURE.md

文档

| 主题 | 指南 |
|---|---|
| Windows | docs/WINDOWS.md · Português |
| 作为 DSH bundle 安装（dsh plugin add） | docs/INSTALL-BUNDLE.md |
| Linux / 服务器 | docs/SERVER-MAP.md |
| 核心更新 / 并行实例 | docs/CORE-UPDATE.md |
| 双向同步 / 回滚 | docs/SYNC.en.md · Português |
| 架构 | docs/ARCHITECTURE.md |
| 路线图 | ROADMAP.md |
| 更新日志 | CHANGELOG.md |

帮助构建 FreeDSH

你不需要成为整个项目的专家。有用的贡献包括：

- 测试一个免费提供商并报告兼容性；
- 添加或改进提供商适配器；
- 改进 Windows/Linux 安装；
- 添加翻译；
- 复现 bug；
- 改进文档；
- 提出更好的路由规则或基准测试。

从 CONTRIBUTING.md 开始，然后寻找标记为 good first issue 或 help wanted 的 issue。

问题、想法以及“这个能和 X 一起用吗？”请发到 Discussions。Bug 和具体提案请发到 Issues —— 一份最小的报告（操作系统、PowerShell 版本、dsh doctor 输出）会更快得到修复。

如果你使用 FreeDSH 并且它对你有所帮助，在仓库上点一个 ⭐ 可以帮助其他 DeepSeek Harness 用户发现它。

项目原则

1. 免费优先，而非不惜一切代价免费。 尊重提供商条款，并在付费回退是可靠选择时使用它。
2. 绝不静默破坏可用的环境。 在替换前创建快照，并让回滚切实可行。
3. 凭据保留在本地。 密钥、会话和运行时状态不应进入 git。
4. 上游优先。 FreeDSH 扩展 DeepSeek Harness；它并不假装自己是上游项目。
5. 社区优先于私人定制。 可复用的改进应成为有文档、可审查的贡献。

许可证与署名

- 原始 FreeDSH 覆盖层/工具/安装程序/文档：MIT —— 见 LICENSE。
- 该 MIT 授权涵盖的内容（以及明确不属于我们的内容）：LICENSE-SCOPE.md。
- 第三方资源：见 THIRD_PARTY_NOTICES.md。
- DeepSeek Harness 单独安装，不作为本项目的核心进行再分发。

安全报告：SECURITY.md · 社区准则：CODE_OF_CONDUCT.md