dsh-opencode-free-models

dsh-opencode-free-models 无限免费额度的deepseek harnes 免费模型插件-免费API

> DeepSeek Harness (DSH) 插件 — 在聊天界面里实时展示 OpenCode Zen 的最新免费模型，无需登录、无需密钥，直接在模型选择器选用即可对话。

---

目录

• [这是什么](#这是什么)
• [核心特性](#核心特性)
• [工作原理](#工作原理)
• [项目结构](#项目结构)
• [小白安装教程](#小白安装教程)
• [第一步：确认你已安装 DeepSeek Harness](#第一步确认你已安装-deepseek-harness)
• [第二步：下载插件包](#第二步下载插件包)
• [第三步：双击安装](#第三步双击安装)
• [第四步：重启 DeepSeek Harness](#第四步重启-deepseek-harness)
• [第五步：开始使用](#第五步开始使用)
• [手动安装（非 Windows / 服务器）](#手动安装非-windows--服务器)
• [从源码构建](#从源码构建)
• [配置说明](#配置说明)
• [后端 API](#后端-api)
• [架构详解](#架构详解)
• [安全说明](#安全说明)
• [常见问题](#常见问题)
• [无限额度使用技巧](#无限额度使用技巧)
• [卸载](#卸载)
• [开发指南](#开发指南)
• [许可证](#许可证)

---

这是什么

dsh-opencode-free-models 是一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件，它做的很简单：

1. 自动从后端拉取最新的 OpenCode Zen 免费模型列表

2. 把这些模型注册到 DSH 的模型选择器里

3. 你在输入框右下角直接选择模型就能对话

你不需要做任何额外操作 —— 装完插件，重启 DSH，免费模型就自动出现在模型选择器里了。

---

核心特性

• 零配置 — 安装即用，无需登录、无需 API Key
• 自动同步 — 模型列表自动从后端拉取，官方新增自动出现、弃用自动消失
• 双端支持 — 同时支持 DSH 桌面端和 Web 端
• 一键安装 — Windows 用户双击 install.bat 即可
• 安全可靠 — 无密钥收集、XSS 防护、fail-closed 授权
• 后台可控 — 站长可通过后端控制总开关、单模型上下架、可用时间窗

---

工作原理

┌─────────────────────────────────────────────────────────┐
│                    DeepSeek Harness                      │
│  ┌──────────────┐    ┌──────────────────────────────┐   │
│  │  模型选择器   │◄───│  opencode-free provider       │   │
│  │  (输入框右下) │    │  (宿主侧 adapter 注册)        │   │
│  └──────────────┘    └──────────────┬───────────────┘   │
│                                     │                    │
│  ┌──────────────┐    ┌──────────────▼───────────────┐   │
│  │ 🎁 免费模型   │    │  轮询后端 /api/models (30s)   │   │
│  │  面板 (抽屉)  │    │  获取最新模型列表             │   │
│  └──────────────┘    └──────────────┬───────────────┘   │
└─────────────────────────────────────┼────────────────────┘
                                      │
                          ┌───────────▼───────────┐
                          │   后端 API 服务        │
                          │   (站长维护)           │
                          │   free-api.gd7.cn     │
                          └───────────────────────┘

数据流

1. 插件加载 → 宿主半（index.js）向 DSH 的 llm 服务注册 opencode-free provider

2. 轮询同步 → 每 30 秒从后端 /api/models 拉取最新模型列表，更新模型选择器

3. 用户对话 → 选择 opencode-free/* 模型 → 请求发送到 opencode.ai/zen/v1 → SSE 流式返回

4. 暂停/恢复 → 后端关闭总开关 → provider 路由被移除 → 模型从选择器消失

认证方式

所有免费模型使用共享字面量密钥 Bearer public，由宿主在加载时自动注入环境变量 OPENCODE_ZEN_API_KEY=public。用户无需也不应填写任何 Key。

---

项目结构

dsh-opencode-free-models/
├── src/                          # 开发源码
│   ├── index.js                  # 宿主半（Node 侧）：注册 provider、轮询开关、跨进程授权桥
│   ├── provider.js               # OpenCode Zen 免 key 适配器：SSE 解析、流式转换、模型管理
│   ├── core.js                   # 纯函数：配置校验、URL 安全化、模型列表解析、YAML 生成
│   └── client/
│       └── index.js              # 浏览器半：面板 UI、分页、授权交互、XSS 防护
│
├── lib/                          # 运行时产物（由 build.mjs 从 src/ 原样复制）
│   ├── index.js                  # 宿主半
│   ├── provider.js               # 适配器
│   ├── core.js                   # 核心 helper
│   └── client.cjs                # 浏览器面板（CJS bundle）