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

🐋 FreeDSH

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

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

非官方项目。 FreeDSH 与 DeepSeek 没有关联，也未获 DeepSeek 认可。

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 <(curl -fsSL https://raw.githubusercontent.com/marcosmmjr2023/dsh-h-v1/main/installer/dsh-setup.sh)

手动安装或服务器安装，见 docs/SERVER-MAP.md。

服务商凭据只留在本地，绝不能提交到仓库。把任何 FreeLLMAPI/admin 接口暴露到 localhost 之外前，先看 SECURITY.md。

已经跑着 DeepSeek Harness？

FreeDSH 也提供 DSH bundle 形式，适合已经有一套能用的 harness、只想要插件的人（Smart Router、OpenRouter 分组、模型可见性、FreeLLMAPI 快捷入口、右侧面板、版本徽标）。不用安装程序，也不用复制 overlay：

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 tag/历史，以及恢复工具。
- 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 原有的 overlay/tools/installer/docs：MIT —— 见 LICENSE。
- MIT 授权覆盖哪些内容（以及哪些明确不属于我们）：LICENSE-SCOPE.md。
- 第三方资源：见 THIRD_PARTY_NOTICES.md。
- DeepSeek Harness 单独安装，不作为本项目的核心再分发。

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