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

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

这是什么

dsh-opencode-free-models 是一个 DeepSeek Harness 插件，它做的很简单：

自动从后端拉取最新的 OpenCode Zen 免费模型列表
把这些模型注册到 DSH 的模型选择器里
你在输入框右下角直接选择模型就能对话

你不需要做任何额外操作 —— 装完插件，重启 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     │
                          └───────────────────────┘

数据流

插件加载 → 宿主半（index.js）向 DSH 的 llm 服务注册 opencode-free provider
轮询同步 → 每 30 秒从后端 /api/models 拉取最新模型列表，更新模型选择器
用户对话 → 选择 opencode-free/* 模型 → 请求发送到 opencode.ai/zen/v1 → SSE 流式返回
暂停/恢复 → 后端关闭总开关 → 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）
│
├── one-click-install/            # 一键安装包（Windows 用户用）
│   ├── install.bat               # 安装/更新
│   ├── restart.bat               # 重启 DSH
│   ├── install.ps1               # PowerShell 安装脚本（核心逻辑）
│   ├── restart.ps1               # PowerShell 重启脚本
│   └── plugin/
│       └── dsh-opencode-free-models/
│           ├── package.json      # 插件元数据
│           ├── cordis.patch.yml  # DSH 补丁配置（后端地址、分页等）
│           ├── lib/              # 插件运行时文件（安装时复制到 DSH）
│           ├── README.md
│           └── LICENSE
│
├── scripts/
│   └── build.mjs                 # 构建脚本：src/ → lib/ + one-click-install
│
├── test/
│   ├── plugin.test.js            # 验收测试：core + provider + host + client
│   └── auth.test.mjs             # 授权流程测试
│
├── patches/                      # 可选补丁（仅特殊环境使用，正常安装无需）
├── docs/                         # 详细文档（架构、内部实现、运维手册）
├── package.json                  # 项目元数据
├── cordis.patch.yml              # DSH bundle 层补丁
├── DSH-PLUGIN-ARCHITECTURE.md    # 完整架构文档（对照 DSH 源码核验）
├── INSTALL.md                    # 安装说明
└── LICENSE                       # MIT 许可证

源码 vs 运行时

目录	用途	说明
`src/`	开发源码	宿主半、适配器、核心 helper、浏览器面板
`lib/`	运行时	由 `build.mjs` 从 `src/` 原样复制，与 DSH 运行中插件字节一致
`one-click-install/plugin/`	发布包	安装时复制到 DSH 的 `node_modules`

小白安装教程

预计用时：2 分钟
适用系统：Windows 10/11
前提：已安装 DeepSeek Harness

第一步：确认你已安装 DeepSeek Harness

DeepSeek Harness 是一个 AI 助手工具，本插件需要在它里面运行。

如果你还没有安装，请先到 DeepSeek Harness 官网下载安装。

第二步：下载插件包

从本页面的 Releases 下载最新版本的发布包。

或者直接克隆本仓库：

git clone https://github.com/yu-wenchao/dsh-opencode-free-models.git

下载后解压，你会看到一个 one-click-install 文件夹。

第三步：双击安装

打开 one-click-install 文件夹
双击 install.bat（或 安装.bat）

脚本会自动：

探测你电脑上 DeepSeek Harness 的安装位置
把插件复制到正确的位置
在 package.json 中注册插件

安装过程中会提示你选择要安装到哪个 DSH 目录（如果你有多个），输入编号即可。

如果脚本提示"没有找到 DeepSeek Harness"
请确认你已安装 DeepSeek Harness，或设置环境变量 DSH_HOME 指向 DSH 根目录（包含 profiles 文件夹的那个目录）。

第四步：重启 DeepSeek Harness

安装完成后，脚本会询问是否立即重启。选择 Y 即可。

如果没有选择自动重启，请：

完全关闭 DeepSeek Harness（包括系统托盘里的图标）
重新打开 DeepSeek Harness

第五步：开始使用

重启后，你会看到：

左侧边缘 出现一个绿色的 🎁 免费模型 按钮
输入框右下角 的模型选择器里自动出现了 opencode-free/* 系列模型

直接选择任意 opencode-free 模型，就可以开始免费对话了！

手动安装（非 Windows / 服务器）

如果你使用 macOS / Linux，或者需要在服务器上安装：

方法一：使用一键安装脚本（推荐）

# 克隆仓库
git clone https://github.com/yu-wenchao/dsh-opencode-free-models.git
cd dsh-opencode-free-models

# 运行安装脚本
node scripts/build.mjs  # 构建 lib/

然后把 one-click-install/plugin/dsh-opencode-free-models/ 文件夹手动复制到 DSH 的插件目录：

<DSH_HOME>/profiles/web/node_modules/dsh-opencode-free-models/

方法二：完全手动

把 one-click-install/plugin/dsh-opencode-free-models/ 整个文件夹复制到：
```
<DSH_HOME>/profiles/web/node_modules/dsh-opencode-free-models/
```

编辑该 profile 的 package.json，添加两处：

{
  "dependencies": {
    "dsh-opencode-free-models": "0.1.0"
  },
  "dsh": {
    "profile": {
      "bundles": ["dsh-opencode-free-models"]
    }
  }
}

重启 DSH

找不到 DSH 目录？
桌面端常见位置：

Windows: C:\Users\你的用户名\AppData\Roaming\DeepSeekHarness\

macOS: ~/Library/Application Support/DeepSeekHarness/

Linux: ~/.config/DeepSeekHarness/

从源码构建

需要 Node.js >= 18。

# 克隆仓库
git clone https://github.com/yu-wenchao/dsh-opencode-free-models.git
cd dsh-opencode-free-models

# 构建（把 src/ 原样复制到 lib/ 和 one-click-install/）
node scripts/build.mjs

# 验证构建产物与源码一致
node scripts/build.mjs --check

# 运行测试
node --test test/plugin.test.js

配置说明

插件配置通过 cordis.patch.yml 或 DSH 设置界面管理。

默认配置

# cordis.patch.yml（bundle 层）
- insert:
    - id: opencode-free-models
      name: dsh-opencode-free-models
      config:
        backendUrl: 'https://free-api.gd7.cn/opencode'  # 后端地址
        pageSize: 20                    # 每页模型数
        requestTimeoutMs: 10000         # 请求超时（毫秒）
        uiSlot: ''                      # UI 挂载位置（空=右侧抽屉）
        providerIdPrefix: opencode      # Provider ID 前缀
        footerLinks:                    # 面板底部链接
          - label: 技术笔记
            url: http://blog.4wc.cn
          - label: 插件开发
            url: https://blog.gd7.cn/
        debug: false                    # 调试日志

自定义后端

如果你有自己的后端服务：

修改 cordis.patch.yml 中的 backendUrl
或在 DSH 设置界面的插件配置中修改

分层覆盖

DSH 支持多层配置覆盖（后层优先）：

bundle 层（cordis.patch.yml）  ←  你在这里
    ↓
profile 层（profiles/web/cordis.patch.yml）
    ↓
home 层（$DSH_HOME/cordis.patch.yml）

后端 API

插件通过以下接口与后端通信：

GET /api/models

获取模型列表。

{
  "ok": true,
  "total": 42,
  "total_pages": 3,
  "page": 1,
  "page_size": 20,
  "opencode_enabled": true,
  "items": [
    {
      "id": 1,
      "title": "模型名",
      "api_base_url": "https://opencode.ai/zen/v1",
      "model_name": ["model-id-1", "model-id-2"],
      "status": "enabled",
      "usable": true,
      "available_from": "2025-01-01 00:00:00",
      "available_until": "2025-12-31 23:59:59"
    }
  ]
}

字段	说明
`opencode_enabled`	全局总开关，`false` 时所有模型不可用
`items[].status`	`disabled` 时该模型显示"已下架"
`items[].usable`	`false` 时该模型不可用
`items[].available_from/until`	可用时间窗

GET /api/version

检查后端版本。

{ "version": "0.1.0" }

GET /api/articles

获取公告/文章列表。

GET /api/license?act=status

获取授权状态。

{ "auth_enabled": false }

架构详解

双进程架构

插件分为两个独立部分：

部分	文件	运行环境	职责
宿主半	`lib/index.js`	Node.js（DSH 进程）	注册 provider、轮询开关、跨进程授权桥
浏览器半	`lib/client.cjs`	浏览器（WebView）	面板 UI、分页、授权交互

两者通过本机 HTTP 桥（127.0.0.1:18766）跨进程通信。

Provider 注册

ctx.llm.registerAdapter(['opencode-free'], adapter)
    │
    ├── listModels()     → 返回免费模型列表
    ├── resolveModel()   → 返回模型详情
    └── stream()         → SSE 流式对话

开关机制

插件有三层开关，取交集：

本地开关 (localEnabled) — DSH 设置界面的插件开关
2....

Navigation Menu

Release list

Choose a tag to compare

Sorry, something went wrong.

Sorry, something went wrong.

Uh oh!

No results found

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

目录

这是什么

核心特性

工作原理

数据流

认证方式

项目结构

源码 vs 运行时

小白安装教程

第一步：确认你已安装 DeepSeek Harness

第二步：下载插件包

第三步：双击安装

第四步：重启 DeepSeek Harness

第五步：开始使用

手动安装（非 Windows / 服务器）

方法一：使用一键安装脚本（推荐）

方法二：完全手动

从源码构建

配置说明

默认配置

自定义后端

分层覆盖

后端 API

GET /api/models

GET /api/version

GET /api/articles

GET /api/license?act=status

架构详解

双进程架构

Provider 注册

开关机制

Uh oh!

Releases: yu-wenchao/dsh-opencode-free-models

Release list

无限免费额度的deepseek harnes 免费模型插件

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

目录

这是什么

核心特性

工作原理

数据流

认证方式

项目结构

源码 vs 运行时

小白安装教程

第一步：确认你已安装 DeepSeek Harness

第二步：下载插件包

第三步：双击安装

第四步：重启 DeepSeek Harness

第五步：开始使用

手动安装（非 Windows / 服务器）

方法一：使用一键安装脚本（推荐）

方法二：完全手动

从源码构建

配置说明

默认配置

自定义后端

分层覆盖

后端 API

GET /api/models

GET /api/version

GET /api/articles

GET /api/license?act=status

架构详解

双进程架构

Provider 注册

开关机制

Uh oh!