dsh-free-models-hub

dsh-free-models-hub

一键安装说明书 https://github.com/yu-wenchao/dsh-free-models-hub/blob/main/one-click-install/README-%E5%AE%89%E8%A3%85%E8%AF%B4%E6%98%8E.txt

English · 简体中文

免费模型排行榜 · DeepSeek Harness 社区插件

在 DeepSeek Harness (DSH) Web UI 右侧边缘提供「免费模型榜」抽屉面板：分页浏览免费模型， 点击标题展开 API 调用地址 / 模型名称 / 【点击这里申请免费密钥key】按钮， 支持一键配置 / 整页批量配置 到 设置 → 模型 → 自定义提供方 —— 用户只需自行粘贴免费 API Key。 支持多 Key 轮换：同一模型粘贴多条免费 Key，由本地代理自动轮询，一个 Key 失效自动换下一个。

插件通过只读 JSON API 拉取。插件全程不接触用户 Key（Key 只走 DSH 官方凭据通道）。 安装 🚀 一键安装（推荐给不会命令行的用户）

仓库内的 one-click-install/ 文件夹是免命令行的安装分发包，打包了 plugin/ 插件本体， 下载整个文件夹（或其中的 dsh-free-models-hub-一键安装.zip）后双击对应脚本即可，无需会敲命令、无需联网拉代码。 安装脚本均已用真实 DSH 启动流程验证：插件会被正确加载进 profile 的 bundle 层（loadProfile/composeEntries 通过）， 支持「安装 → 卸载 → 重装」完整闭环。 手动 / 命令行安装 两全其美：npm 源（主，国内直连）与 GitHub 源（备，开发者 / 翻墙）都保留、都有效。 插件市场的「一键安装」默认登记 npm 源（dsh-free-models-hub）， 这样市场里点安装的用户默认走 npm、国内直连即可装上；GitHub 源继续作为高级备选存在。 桌面版：在 DSH 的 设置 → 插件中心 / 插件配置 里添加 dsh-free-models-hub（npm 源）；或填 github:yu-wenchao/dsh-free-models-hub（GitHub 源）。 固定版本：dsh plugin --profile web add dsh-free-models-hub@0.3.1 更新：再次执行同一条 add 命令即可；卸载：dsh plugin --profile web remove dsh-free-models-hub 使用 数据源

面板默认已连接插件作者运营的官方数据源（https://free-api.gd7.cn），安装即可用，无需任何配置。 后台与数据库仅作者持有，不随仓库分发；普通用户无法也无需自建数据源。 用户侧（DSH 内）

1. 安装并重启后，DSH 窗口右侧边缘出现 🎁 圆形按钮 → 点击展开「免费模型榜」抽屉面板（再点收起，Esc 也可关闭）。 2. 面板顶部可展开 📖 使用教程，按三步指引操作；也可直接： 点一条模型展开 → 点「🔑 点击这里申请免费密钥key」去第三方平台注册拿 Key； 点「⚡ 一键配置到 DSH」把该模型提供方写入 设置 → 模型； 或点「⚡ 配置本页全部」一键批量写入本页全部模型。 3. 到 设置 → 模型 找到 freehub-* 提供方，把 Key 粘贴到「API Key」框并保存 —— 模型立即可用。 若报「no credential」或「API key is invalid」，回到提供方重新粘贴一次并保存。 4. 多 Key 轮换（可选）：在同一模型上点「🔄 多 Key 轮换」，把多条免费 Key 每行一个粘贴保存， 本地代理（默认端口 8787）会自动轮询；某条 Key 失效自动换下一条。 5. 回到聊天页，在顶部模型选择器切换到该提供方下的模型（如 glm-5.2、deepseek-v4-flash）即可免费对话。 提供方写入全程通过 DSH 官方 settingsScope 完成，由 DSH 自行持久化到 settings.yaml， 插件不直接改写 settings.yaml，不会损坏该文件，也不会覆盖你已有的其他提供方。 配置（cordis.patch.yml 覆盖 free-models-hub 行；也可在 DSH 设置的插件页里改） 功能特性 右侧边缘抽屉面板：独立的 🎁 开关按钮 + 滑入式面板，不依赖 DSH 内部侧边栏布局，兼容性稳定；开合状态与教程展开状态都会持久化。 一键配置 / 批量配置：单条一键写入，或「配置本页全部」一键批量写入整页模型到 设置 → 模型。 首次使用教程：面板内置三步引导（配置 → 填 Key → 使用），新用户无需猜测。 多 Key 轮换代理：本地代理为池内提供方自动轮询 API Key；DSH 凭据校验所需的占位环境变量由插件在启动时自动补齐。 分页与排序：服务端分页（首页/末页/页码窗口），标题升序排列，结果稳定可预期。 安全特性 用户 API Key 全程不经过本插件任何一端（只走 DSH 官方 write-only 凭据通道）； 面板渲染全部走安全 DOM API（无 innerHTML）；外链 noopener noreferrer；URL 仅接受 http/https； 提供方设置写入只用 DSH 官方 settingsScope，不直接改 settings.yaml，杜绝文件损坏； 后端单入口路由：全站干净 URL（/、/api/models、/admin），.php 直连 301/404， 无 X-Powered-By

License

MIT Free Models Leaderboard — a community plugin for DeepSeek Harness

A "Free Models" drawer panel for the DSH web UI, toggled by a 🎁 button on the right edge of the window. Expand a row to see the API base URL, model name and an "apply for your free key" button linking to the publisher's signup page; then one-click, or batch one-click across the whole page, write the custom provider into Settings → Models — you only paste your free API key afterwards. A built-in multi-key rotation proxy auto-cycles several free keys on the same model, falling over to the next key when one is exhausted.

The list is served by the author-operated backend (https://free-api.gd7.cn, PHP 7.4 + SQLite); the backend is a private component and is not distributed with this repository. The plugin never sees your API keys — it works out of the box right after install.