前言¶
在 DeepSeek Harness（DSH）里给 agent 配备用模型，常见做法是自行搜索各家「免费 API」、逐个注册、记下 base URL 和 model ID，再手工写进配置。步骤多、信息分散，一家 endpoint 变更就要重新查文档。社区插件 dsh-freeapi-panel（维护者 qianai05233，分类：模型推理）把「找 provider、领 key、测连通、多路备用」收进 DSH Web 界面，面向需要 OpenAI 兼容免费额度与自动故障转移的开发者。
这是什么¶
dsh-freeapi-panel 是 DSH 的 Web 侧插件：Free-API aggregator panel，整合 29 家正规免费 LLM provider（README 称 30 家 provider / 29 家 base URL 可直接用 / 30 个免费模型，全部 OpenAI 兼容），支持卡片式领 key、最小请求测试、按优先级自动故障转移。
目录数据来自开源项目 open-free-llm-api/awesome-freellm-apis（MIT；其 README 自报 495+ free LLM APIs / 30 providers）。仓库内脚本 tools/extract-free-apis.cjs 解析 README 四个锚点区块，产出 data/free-api-catalog.json（永久免费档、可再生额度、Base URL 与领 key 链接、最佳免费模型与限速等）。
插件自身版本见 package.json 为 1.0.0，许可证 MIT；各 provider 使用条款需遵循其官网。
核心功能¶
卡片式配 key¶
每个 provider 一张卡片：
- 领 Key：跳转官网申请页（例如 NVIDIA NIM 对应
https://build.nvidia.com/settings/api-keys等）。 - 在密码框粘贴 key 后保存。
- 测试：发送最小
chat/completions请求，确认是否可用。
面板对常见 HTTP 状态给出可读说明：401/403 表示 key 无效或无权限；429 表示 key 有效但被限速；404 表示模型名或路径不对。
自动故障转移¶
配置多家 provider 后，故障转移测试 按设定优先级依次尝试，返回第一个可用的 provider。单家不可用不影响其他家，结果中会附带各家失败原因。
筛选¶
支持 全部 / 免信用卡 / 已配置，便于在没有信用卡的情况下先跑通可用线路。
数据规模（目录快照）¶
按免费模型数排序的部分头部 provider（摘自 README 表格）：
| Provider | 模型数 | Base URL |
|---|---|---|
| NVIDIA NIM | 132 | https://integrate.api.nvidia.com/v1 |
| ModelScope | 61 | https://api-inference.modelscope.cn/v1 |
| Cloudflare Workers AI | 40 | https://api.cloudflare.com/client/v4/accounts/{id}/ai/run |
| OpenRouter | 34 | https://openrouter.ai/api/v1 |
| OpenCode Zen | 33 | https://opencode.ai/zen/v1 |
| LLM7.io | 20 | https://api.llm7.io/v1 |
| Google Gemini | 19 | https://generativelanguage.googleapis.com/v1beta |
| Groq | 12 | https://api.groq.com/openai/v1 |
安装与启用¶
前置要求：DSH >= 0.1.7-rc.1。
在终端执行官方安装命令：
dsh plugin --profile web add github:qianai05233/dsh-freeapi-panel
重启 dsh web 后，界面右下角会出现 免费 API 胶囊，由此进入面板。
DSH 社区插件目录页：SkillHub - dsh-freeapi-panel。该站点为社区目录，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」的扩展方式。
典型用法¶
- 安装插件并重启
dsh web，打开右下角 免费 API。 - 用 免信用卡 等筛选缩小列表，对目标 provider 点 领 Key 完成官网注册，将 API key 粘贴到卡片并保存。
- 点 测试 确认该 key 与默认模型可用。
- 重复为多家 provider 配 key，设置优先级后运行 故障转移测试，确认备用链路顺序符合预期。
Key 存储与访问方式见下文「安全与边界」；面板请求直连各家官方 endpoint，不经第三方代理。
安全与边界¶
- Key 仅保存在本地：
$DSH_HOME/storages/dsh-freeapi-panel/keys.json（文件权限0600）。 - 面板 API 只返回掩码形式（如
gsk_…_000），不回明文。 - 项目声明只整合正规免费额度（官方免费 tier、注册赠送、社区公开的 public key），不做抓取他人泄露密钥或对站点做反代绕过访问控制；此类行为风险由使用者账号承担。
插件在 当前 dsh 进程权限 下运行，安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，并理解本地 key 文件的敏感性。
维护者若需更新目录，可在有 git 的环境下按 README 从 awesome-freellm-apis 拉取 README 并用 node tools/extract-free-apis.cjs 重新生成 data/free-api-catalog.json（纯本地解析 markdown，不消耗 LLM token）。普通使用者通过 dsh plugin add 安装即可，无需自行 clone 本插件仓库。
适用场景与注意¶
适合：希望在 DSH Web 里快速试用多家 OpenAI 兼容免费 API、需要可视化测 key 与多 provider 故障转移的 agent 开发者。
注意：免费额度与限速以各 provider 官网为准；Cloudflare Workers AI 等 base URL 含 {id} 占位，需按官方文档替换账户信息。同维护者另有 dsh-codex-preset、dsh-codex-panel 等配套插件，与本面板无强制依赖。
结尾¶
dsh-freeapi-panel 把分散的免费 LLM 注册与配置流程收成 Web 面板上的领 key、测试与故障转移，数据源于社区维护的 awesome-freellm-apis 目录。安装命令为 dsh plugin --profile web add github:qianai05233/dsh-freeapi-panel，要求 DSH >= 0.1.7-rc.1。
- 目录页：https://www.skillhub.cn/plugins/qianai05233/dsh-freeapi-panel
- GitHub：https://github.com/qianai05233/dsh-freeapi-panel
