dsh-free-models-hub
DeepSeek Harness 的免费模型排行榜：带分页的侧边栏面板，一键设置自定义提供商（只需粘贴您的免费 API 密钥），由您自己的 PHP 7.4 + SQLite 后端提供支持。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yu-wenchao/dsh-free-models-hub#3c98fc5dfba7d69a2b96713739b5bdea99c9b5f4
Free Models Hub 以 dsh-free-models-hub 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness (DSH) Web UI 右侧边缘提供「免费模型榜」抽屉面板：分页浏览免费模型，
点击标题展开 API 调用地址 / 模型名称 / 【点击这里申请免费密钥key】按钮，
支持一键配置 / 整页批量配置 到 设置 → 模型 → 自定义提供方 —— 用户只需自行粘贴免费 API Key。
支持多 Key 轮换：同一模型粘贴多条免费 Key，由本地代理自动轮询，一个 Key 失效自动换下一个。
插件通过只读 JSON API 拉取。插件全程不接触用户 Key（Key 只走 DSH 官方凭据通道）。
┌──────────────────────────┐
│ 🎁 免费模型榜 ▾ │ ← DSH 窗口右侧边缘的悬浮抽屉面板
├──────────────────────────┤
│ [📖 使用教程] │ ← 三步引导：配置 → 填 Key → 使用
│ 1. GLM-5-Flash 免费额度 ›│
│ ├ API 地址 https://… │
│ ├ 模型名 glm-5-flash │
│ ├ [🔑 申请免费密钥key] │
│ └ [⚡ 一键配置到 DSH] │
│ 2. Kimi K2 Free │
│ 首页 < 1 [2] 3 … 9 > 末页│
│ [⚡ 配置本页全部] [🔄 刷新]│ ← 批量配置 / 多Key轮换
├──────────────────────────┤
│ 技术笔记·插件开发·联系站长│
└──────────────────────────┘
仓库内的 one-click-install/ 文件夹是免命令行的安装分发包，打包了 plugin/ 插件本体，
下载整个文件夹（或其中的 dsh-free-models-hub-一键安装.zip）后双击对应脚本即可，无需会敲命令、无需联网拉代码。
| 你的使用方式 | 运行哪个脚本 | 说明 |
|---|---|---|
| 桌面版（双击 exe） | install-free-models-hub.bat | 自动扫描本机 DSH 安装位置（含 DSH_HOME、.dsh、各盘 dsh-home），离线复制插件 + 自动注册，小白首选 |
| 命令行 / npx 版 | install-npm-cli.bat | 经 dsh plugin --profile web add + pnpm 安装（需本机能跑 dsh 和 pnpm） |
| 卸载（任何方式） | uninstall-free-models-hub.bat | 一键移除插件及注册项 |
安装脚本均已用真实 DSH 启动流程验证：插件会被正确加载进 profile 的 bundle 层（
loadProfile/composeEntries通过）， 支持「安装 → 卸载 → 重装」完整闭环。
# ✅ 方式一（推荐·国内直连）：npm 源，无需翻墙
dsh plugin --profile web add dsh-free-models-hub
# 指定版本 / 走国内镜像（更稳）：
dsh plugin --profile web add dsh-free-models-hub@0.3.1 --registry https://registry.npmmirror.com
# 🔁 方式二（备选·开发者）：GitHub 源，需能直连 GitHub
dsh plugin --profile web add github:yu-wenchao/dsh-free-models-hub
# 固定版本：
dsh plugin --profile web add github:yu-wenchao/dsh-free-models-hub#v0.3.1
# 📦 本地分发包（one-click-install\plugin\dsh-free-models-hub）：
dsh plugin --profile web add "one-click-install\plugin\dsh-free-models-hub"
两全其美：npm 源（主，国内直连）与 GitHub 源（备，开发者 / 翻墙）都保留、都有效。 插件市场的「一键安装」默认登记 npm 源（
dsh-free-models-hub）， 这样市场里点安装的用户默认走 npm、国内直连即可装上；GitHub 源继续作为高级备选存在。
dsh-free-models-hub（npm 源）；或填 github:yu-wenchao/dsh-free-models-hub（GitHub 源）。dsh plugin --profile web add dsh-free-models-hub@0.3.1dsh plugin --profile web remove dsh-free-models-hub面板默认已连接插件作者运营的官方数据源（https://free-api.gd7.cn），安装即可用，无需任何配置。
后台与数据库仅作者持有，不随仓库分发；普通用户无法也无需自建数据源。
设置 → 模型；freehub-* 提供方，把 Key 粘贴到「API Key」框并保存 —— 模型立即可用。
8787）会自动轮询；某条 Key 失效自动换下一条。glm-5.2、deepseek-v4-flash）即可免费对话。提供方写入全程通过 DSH 官方
settingsScope完成，由 DSH 自行持久化到settings.yaml， 插件不直接改写settings.yaml，不会损坏该文件，也不会覆盖你已有的其他提供方。
free-models-hub 行；也可在 DSH 设置的插件页里改）| 键 | 默认 | 说明 |
|---|---|---|
backendUrl | '' | 数据源接口地址（留空则用作者运营的 https://free-api.gd7.cn；也可面板内填写） |
pageSize | 20 | 每页条数（服务端钳制 1–50） |
requestTimeoutMs | 10000 | 拉取超时（1000–60000） |
uiSlot | '' | 注入的侧边栏 slot；留空默认使用右侧边缘抽屉面板（所有 DSH 构建一致） |
providerIdPrefix | freehub | 生成的 Provider ID 前缀（形如 freehub-glm-5） |
proxyPort | 8787 | 本地多 Key 轮换代理端口（仅 127.0.0.1） |
footerLinks | 三条固定菜单 | 底部菜单 {label,url} 数组（最多 6 条） |
debug | false | 是否输出详细日志 |
设置 → 模型。noopener noreferrer；URL 仅接受 http/https；settingsScope，不直接改 settings.yaml，杜绝文件损坏；/、/api/models、/admin），.php 直连 301/404，
无 X-Powered-By 指纹——技术栈对用户不可见；docs/05-安全审查与验收.md。| 文档 | 内容 |
|---|---|
docs/01-策划书.md | 产品定位、功能规格、原型 |
docs/02-技术方案.md | 架构、bundle/client 规范、风险登记 |
docs/03-开发计划.md | 里程碑与流程约定 |
docs/04-代码审查清单.md | PR 审查清单 |
docs/05-安全审查与验收.md | 威胁建模、安全/功能验收矩阵 |
docs/06-发布与升级指南.md | GitHub topics、发版、市场更新 |
docs/07-修复清单.md | 已知问题、根因分析与修复记录 |
npm run build # regenerate lib/ from src/
npm run verify # CI check: lib/ in sync with src/
npm test # node --test unit tests (33)
php -l server-php/**/*.php # PHP syntax gate (PHP >= 7.4)
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.
dsh plugin --profile web add github:yu-wenchao/dsh-free-models-hub
Provider writes go exclusively through DSH's official settingsScope (never editing settings.yaml
directly), so existing providers are never wiped and no config file corruption can occur. A collapsible
in-panel tutorial walks first-time users through configure → paste key → use.
Prebuilt artifacts are committed, so installation never asks for pnpm build-script permissions.
See the Chinese sections above for full docs; the security review and acceptance matrices live under
docs/.