免费模型聚合 STARKTANG108/dsh-free-models

dsh-free-models

一键把 5 家免费大模型接入 DeepSeek Harness（DeepSeek 推理框架），不花一分钱、不绑信用卡。

通过本地代理 Free Claude Code（FCC）聚合 5 家服务商的免费额度，自动写入 DeepSeek Harness 的模型配置，模型直接出现在 Harness 的模型选择下拉列表中。

⚠️ 本项目不包含任何 API Key。所有 key 都需要你按 README 的指引自行注册获取（免费、不绑卡），填写到本地 ~/.fcc/.env。

✨ 效果

安装后，DeepSeek Harness 的模型选择器里会出现以下 5 个模型：

| 下拉列表显示名 | 模型 ID | 服务商 |
| Gemini 3.1 Flash Lite (FCC, free) | gemini/models/gemini-3.1-flash-lite | Google Gemini |
| OpenRouter Free (FCC, free) | open_router/openrouter/free | OpenRouter |
| GitHub Models GPT-4.1 (FCC, free) | github_models/openai/gpt-4.1 | GitHub Models |
| Groq Llama 3.3 70B (FCC, free) | groq/llama-3.3-70b-versatile | Groq |
| NVIDIA NIM Nemotron 3 Super (FCC, free) | nvidia_nim/nvidia/nemotron-3-super-120b-a12b | NVIDIA NIM |
| GLM-4.7-Flash (FCC, free, 200K ctx) | zai_api/glm-4.7-flash | 智谱 Z.ai |

🚀 快速开始

1. 一键安装

curl -fsSL https://raw.githubusercontent.com/STARKTANG108/dsh-free-models/main/install.sh | sh

脚本会自动完成：

1. 安装 uv（Python 包管理器，如未安装）
2. 安装 Free Claude Code（自动下载 Python 3.14，首次约需几分钟）
3. 启动 FCC 本地代理（127.0.0.1:8082）
4. 把 5 个免费模型写入 ~/.dsh/settings.yaml（幂等，可重复执行）
5. 写入代理凭证 FCC_DSH_API_KEY=freecc 到 ~/.dsh/.credentials.yaml

2. 注册并获取 API Key（约 5 分钟）

每家都是免费注册、不绑信用卡。 按表格获取路径注册后，把 key 写入 ~/.fcc/.env：

| 服务商 | Key 获取路径 | 环境变量 | 免费额度 |
| Google Gemini（免费额度最大） | https://aistudio.google.com/apikey | GEMINI_API_KEY | Flash 系模型，约 15 RPM / 千次请求每天 |
| OpenRouter（免费模型池） | https://openrouter.ai/keys | OPENROUTER_API_KEY | :free 模型池，几十个模型按需切换 |
| GitHub Models | https://github.com/marketplace?type=models | GITHUB_MODELS_TOKEN | 免费档，含 GPT-4.1 等，需 GitHub 账号 |
| Groq | https://console.groq.com/keys | GROQ_API_KEY | 免费档约 30 RPM / 1.4 万次请求每天 |
| NVIDIA NIM | https://build.nvidia.com/settings/api-keys | NVIDIA_NIM_API_KEY | 注册送免费请求额度 |
| 智谱 GLM（免费额度大） | https://z.ai/manage-apikey/apikey-list | ZAI_API_KEY | GLM-4.7-Flash 永久免费（200K 上下文，约 200 RPM） |

~/.fcc/.env 格式（一行一个，不要加引号）：

GEMINI_API_KEY=AIza...
OPENROUTER_API_KEY=sk-or-...
GITHUB_MODELS_TOKEN=ghp_...
GROQ_API_KEY=gsk_...
NVIDIA_NIM_API_KEY=nvapi-...
ZAI_API_KEY=...

3. 重启代理使 key 生效

pkill -f fcc-server; sleep 1; fcc-server

4. 在 Harness 中选择模型

打开 DeepSeek Harness 的模型选择器，在 "Free Claude Code" 服务商下选择任意免费模型即可开始使用。

🏗️ 工作原理

DeepSeek Harness (dsh-llm-pi-ai 插件) │ OpenAI Responses 协议 ▼ FCC 本地代理 (127.0.0.1:8082, 自动故障转移) │ 按模型路由 ├──► Google Gemini (免费档) ├──► OpenRouter (:free 模型池) ├──► GitHub Models (免费档) ├──► Groq (免费档) └──► NVIDIA NIM (免费额度)

- Harness 侧只配置一个 provider free-claude-code，指向本地 FCC 代理
- FCC 负责聚合各家的免费额度、自动故障转移（某家限流自动切下一家）
- 模型 ID 即 FCC 的路由标识：服务商/模型

📁 项目结构

dsh-free-models/
├── install.sh # 一键安装脚本（幂等，可重复执行） ├── uninstall.sh # 卸载脚本（只移除本项目添加的配置） ├── config/ │ └── free-claude-code.yaml # 手动安装用的配置片段 └── README.md

🧹 卸载 bash
curl -fsSL https://raw.githubusercontent.com/STARKTANG108/dsh-free-models/main/uninstall.sh | sh

只移除 ~/.dsh/settings.yaml 中的 provider 块和 ~/.dsh/.credentials.yaml 中的 FCC_DSH_API_KEY，不影响其他配置。Free Claude Code 本体如需卸载：uv tool uninstall free-claude-code。

❓ 常见问题

Q: 为什么模型能选但请求报错？
A: 上游 key 未配置或代理未重启。确认 ~/.fcc/.env 已填写 key，并执行 pkill -f fcc-server; fcc-server。

Q: 重启电脑后怎么恢复？
A: 重新运行 fcc-server 即可（建议加到登录启动项）。Harness 的配置已持久化，无需重新安装。

Q: 免费额度用完了怎么办？
A: 各家额度独立计算，FCC 会自动故障转移。也可在 ~/.dsh/settings.yaml 的 free-claude-code provider 下增删模型。

Q: 为什么没有 OpenAI / DeepSeek 官方？
A: 它们要么收费（DeepSeek 充值制）、要么需绑卡，不符合本项目"全免费、不绑卡"的原则。

⚠️ 免责声明

- 本项目与 Anthropic、OpenAI、DeepSeek 等均无任何隶属关系。
- 免费额度由各提供商自行控制，可能随时调整；请遵守各家的服务条款（ToS）。
- 本项目仅提供配置模板与安装脚本，不含任何 API Key 或付费资源。
- 使用本项目产生的任何费用、封号、合规风险由使用者自行承担。

📄 License

MIT