DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-wb-free-model

d

dsh-wb-free-model

Manifest valid

DSH Plugin · Ready-to-use free model lanes: no login, no API Key. Isolated OpenCode execution, automatically discovers and probes zero-cost models (OpenCode + Kilo), WB · auto weighted selection, envelope protocol for tool loops.

UI (client)hasBundlePatch

dsh-wb-free-model

在 DSH 里装上这个插件,无需登录、注册、填 API Key 或任何其它操作,就能使用免费模型。

插件进程直连两条免密免费车道(不下载任何运行时、不拉起任何子进程):

  • OC · 免密免费车道:opencode.ai 背后的匿名免费池,OpenCode 客户端自己用的同一条车道。线上的 v2 指纹契约(官方提示词、官方工具集、会话编码、请求头)收录自 dsh-our-free-model(MIT,src/o2a/ 逐字携带)。
  • KL · Kilo 免费池:Kilo AI 公共网关的 isFree 模型切片,完全无需凭据。

并额外提供 WB · auto:按实测耗时加权自动挑选当前可用的免费模型。业务逻辑移植自 wbBridge:免费模型发现与探测、加权自动选择、会话与权限边界。

因为整条车道都是插件进程内的出站 HTTPS,iOS 等无法派生子进程的宿主同样可用——这是本插件相对早期版本(本机拉起 OpenCode 运行时)的根本变化。在手机侧,这具体指 Fish Pocket(DSH Agent 的 TestFlight App):它把 DSH 引擎连同 Node 24 一起打包进 App,插件 Host 半身就在其中运行。iPhone 上的可用面与限制见 在 iPhone 上用。

它做什么

  1. 发现免费模型:每次刷新从 GET /inference/v1/models(免费车道)与 GET {KILO_BASE}/models 的 isFree 切片(Kilo 车道)重新拉取清单,插件内不保存静态快照。免费车道的 id 与一张本地能力表(上下文窗口 / 视觉 / 推理档位,随 dsh-our-free-model 的实测校准)合并成目录。
  2. 启动即探测:每个模型用一次真实对话验证「能否按请求返回一个 Read 动作」。探测通过的模型才发布;只会聊天、不会函数调用的模型按「仅对话」发布;超时或格式不支持则失败并记录原因。结果持久化。检测节拍:每模型每 24h 至多自动复检一次——到期后按 2 个/15 分钟排队补检,手动检测占用队列时顺延到下一个臂点,不跳过;今天被成功请求用过的模型视为已验证,不再重复探测。首次启动(状态里还没有任何探测证据)会立即全量探测;关闭「启动时自动检测」后启动不做任何立即探测,完全由 24h 节拍接管。探测经由同一完成路径发起,其证据只写一次,不会被记成一次「真实请求失败」。
  3. WB · auto:请求时按能力过滤(工具、图像、推理档位),在通过探测的模型里取权重最高者,权重相同随机选择(模型选择器按权重降序排列,同权重保持目录顺序)。权重语义是「近期最佳证据」:探测成功按实测耗时分档(≤2s 100、≤5s 80、≤10s 60、≤20s 40、≤40s 20、更慢 10);真实请求成功取「使用统计衰减值」与「本次耗时对应档位」两者的较高者——成功恒 ≥10,所以模型不会卡在 0;单次请求超过 30s 再扣 20;失败保留原权重。所有权重都跌到 0 时不再自动全量复探:恢复由日常请求成功按耗时重挂权重,以及 24h 定期复检的探测成功承担。
  4. 工具调用是原生的:模型经上游网关返回标准 tool-calls,适配器把它们转换成 DSH 原生 tool-call 块交给 harness 执行。上游网关是纯推理端点,不执行任何东西;工具的执行、权限与结果始终在 DSH 这一侧——这与早期信封协议的安全边界等价,且不再依赖托管运行时的 StructuredOutput。
  5. 免费车道指纹契约(src/o2a/):请求按 v2 客户端指纹塑形——官方系统提示词、官方 13 工具集(调用方同名工具按别名收编,其余以可逆改名收编并注入占位注记压住)、stream_options.include_usage、会话与项目头的稳定派生。对话到上游会话的映射持久化在插件数据目录(session-map.json),重试不换会话。
  6. 配额断路器:免费车道按出口 IP 计配额;一次真实 429 即开窗(Retry-After 缺省 6 小时),窗口内本插件本地拒绝新请求、不再向墙上送请求。成功即清窗。Kilo 车道不受影响。

安装

要求 Node.js ^22.19.0 || >=24(需要内置 fetch)。

# 作为插件装进一个 profile(web / desktop / 自建 profile 名)
dsh plugin --profile web add github:trexwb/dsh-wb-free-model

# 启动
npx @deepseek-ai/dsh web

桌面端也可以在「设置 → 插件」里从仓库地址安装,然后在「设置 → WB Free Model」查看模型列表。

iPhone 上没有命令行:在 Fish Pocket 的「设置 → 插件」里新增 bundle,规格填 github:trexwb/dsh-wb-free-model,由 App 内的包管理器拉取并启用。

启动后模型会出现在 DSH 的模型选择器里,供应商名为 WB Free Model,第一项是 WB · auto。没有首次下载:所有上游流量都是插件进程内的普通 HTTPS 请求。

在 iPhone 上用

Fish Pocket 运行插件的 Host 半身,不运行浏览器半身:client.js 与它的 React 面板、以及注入设置页的扩展槽,在原生界面里根本不渲染。因此本插件把手机上需要的东西全部放在 Host 侧:

  • 模型可用:模型经 adapter.listModels() 发布,原生选择器读 session/modelCatalog,WB · auto 与 OC · * / KL · * 一样出现在列表里,直接对话与工具调用都走同一条车道。
  • 开关可改:enabled(车道总开关)与 probeOnBoot(启动时自动检测)注册成设置 namespace dsh-wb-free-model,原生设置页按 schema 自动渲染成真实表单(开关于是 App 里的开关,不是网页)。开关翻转的后效(撤回模型 / 重新拉起车道)与网页端完全一致,走同一套代码。
  • 动作可做:七个工具让对话里就能管理车道——wb_free_model_status(状态,detail="models" 列逐个模型、健康状态与 24h 检修排期)、wb_free_model_refresh(刷新清单,可带 probe)、wb_free_model_probe(检测全部或单个)、wb_free_model_retry(清失败记录并解禁)、wb_free_model_recycle(移入回收站)、wb_free_model_restore(从回收站恢复并清记录)、wb_free_model_settings(改两个开关)。它们是异步动作的启动器,进度用 wb_free_model_status 追;状态里出现「建议移入回收站」时,用 wb_free_model_recycle 带上那个 id 即可,不必回网页。
  • 指令可点:/wb-free 注册进宿主的指令表,App 的输入框按 / 就能列出它(commands/list),提交后走 commands/execute,结果作为指令卡片渲染在对话里——不消耗模型回合,也不占系统提示词。子命令:status(默认)、models、refresh [probe]、probe [id]、retry [id]、recycle <id>、restore <id>、on、off、boot on|off、help。
  • 完整管理页:逐模型重试按钮、权重表、配额窗口提示在 React 面板里;手机上看它要走「探索 → 网页版」(面板调用的 /api/wb-free-model/* 只接受本机回环,App 内网页正是从回环访问的)。

设置分节、工具、/wb-free 与网页 API 四个入口都通过 src/actions.js 这一份动作实现,回答文本也共用 src/native.js 里的一层 answers(ok 决定指令卡片是成功还是失败),所以四处规则不会各自漂移。每个入口挂载在各自的 fiber 上:宿主缺少 settings / tools / commands / webServer 时,车道照常工作,只少那一个入口,而状态回答会如实列出「当前不可用的入口」是哪些(服务未就绪或不存在)——缺失的控件有解释,而不是一片空白。

尚未在真机上验证的一项:图像附件在 App 的文件视图里能否被 attachments.imageHostPath 正确解析(插件只把它读成 data URL,路径解析由 DSH 负责)。

模型标识

  • auto → WB · auto
  • OC · <名称> → 免密免费车道(如 OC · DeepSeek V4.1 Flash)
  • kilo/<org>/<模型> → Kilo 免费池,显示名带 KL · 前缀

推理档位只在该模型自己声明了档位菜单时出现(档位按原值随 reasoning_effort / Kilo reasoning 字段下发,上游会校验集合外的取值);WB · auto 的档位是全部模型声明档位的并集。

健康状态机

每个模型的结果记录除 ok 外还携带一个健康状态 state(与「仅对话」正交):

  • limited:429、限流、配额类失败——模型本身没问题,网关让等等;
  • down:超时及其它明确指向模型的失败(401/403/404/5xx、地区限制等)。超时计入 down 是有意取舍;残余风险是本机网络栈僵死也会被计入(罕见);
  • 不计状态:本机传输失败(TRANSPORT)、上游交互的协议破损(MALFORMED_RESPONSE)与免费车道的客户端级拒绝(INVALID_CREDENTIAL 池化凭据被拒、LANE_LOCKED 指纹门禁)——它们不是关于某个模型本身的证据,只记录失败原因,不推进连败计数。

状态只影响展示与 auto 的兜底池:一次失败不会让 auto 立即放弃一个模型;只有当没有任何模型探测通过、且某模型连续失败 ≥2 次时,auto 的兜底池才把它滤除,滤除后池子为空则回退为不过滤——任何输入下的选择结果都不差于从前。升级到带状态机的版本时,state.json 里的存量失败记录会在加载时按同一分类规则一次性补写 state 与 failStreak(记 1)并落盘,checkFails 不回填——回收计数只由本版本的 24h 节拍积累。

回收站

连续 3 个 24h 周期自动检测失败且期间无任何成功的模型会出现在设置页的「建议移入回收站」里。移入回收站后:模型从模型列表与选择器一并移除(设置页只在「回收站」折叠区块里渲染回收行)、停止自动检测、失败证据保留,每模型每天省下一次探测。恢复后模型回到模型列表的「未探测」状态、立即到期,≤15 分钟内被自动补检。回收站支持停用态查看与恢复;全量重试不会动回收站。对应的 POST 路由为 /recycle 与 /restore。

设置页

「设置 → WB Free Model」提供(面板自身为固定亮色卡片,深浅色主题下均可读):

  • 车道状态、清单更新时间、自动检测节拍与下次检测时间、模型总数;
  • 每个模型的可用性徽标(可用 / 受限 / 不可用 / 仅对话 / 探测失败 / 未探测,连败 ≥2 时旁注连败数)、探测耗时、权重、上次检测与下次自动检测时间、能力标签(工具 / 图像 / 推理);
  • 刷新目录、检测全部、重试失败(自动跳过回收站 / 已禁用行)、单模型重试;
  • 「建议移入回收站」横幅与「回收站」折叠区块(含恢复按钮);
  • 启用车道、启动时自动检测两个开关;
  • 免费车道配额窗口与客户端指纹拒绝的醒目提示。

启用车道开关是完整的启停开关:关闭后,全部模型(含 WB · auto)立即从 DSH 模型选择器移除,进行中的探测安静退出,状态接口如实显示停用;状态持久化,重启 DSH 不会自动拉起,直到重新开启。开启后走既有启动路径:清单刷新 → 按需探测 → 模型重新发布。

这两个开关同时注册为设置 namespace dsh-wb-free-model,因此在没有浏览器半身的宿主(iPhone)上仍然是原生表单里的两个开关;两边写的是同一份值,state.json 里保存的是它的镜像。

同一份数据也通过 GET /api/wb-free-model/status 暴露,POST 路由为 /refresh、/probe、/retry、/settings、/recycle、/restore。这些路由只接受本机回环地址、只接受 application/json。/refresh、/probe 是异步的:立即返回 202,进度与结果通过状态轮询获取。车道关闭时 /refresh、/probe、/retry、/settings 返回 409;/recycle 与 /restore 是例外,停用态也可操作。

数据与日志

默认数据目录:~/.dsh/dsh-wb-free-model(DSH_HOME 可覆盖)。

state.json                 目录快照、探测结果与开关镜像(0600)
session-map.json           对话 → 上游会话映射(免费车道配额按会话计)

开关(enabled / probeOnBoot)的权威位置取决于宿主:有设置服务时是设置文档的 dsh-wb-free-model 分节(原生表单与工具都写这里),state.json 只保存镜像;没有设置服务时 state.json 本身就是权威。组合配置(cordis.patch.yml 的 config)是二者的底座,优先级低于用户已保存的覆盖。

插件自身的日志走宿主注入的 ctx.logger(缺失时回退 console)。实测(DSH web 验收环境)这些插件日志不随 dsh web 进程的 stdout 落盘;排障时以「设置 → WB Free Model」状态接口(snapshot.lastError、maintenance 计数、runtime.error)为准。启动节流的决策会打一条 info 日志(boot maintenance armed: N fresh, M due; next check at <ts>),若宿主提供插件日志通道即可在其中查到。

可用的环境变量:

  • DSH_HOME:DSH 主目录。
  • WB_FREE_MODEL_BASE:替换免费车道网关地址(默认 https://opencode.ai,例如内网镜像或自建调试端点)。
  • WB_FREE_MODEL_KILO_BASE:替换 Kilo 网关地址(默认 https://api.kilo.ai/api/gateway)。

安全边界

沿袭 wbBridge 的红线:

  • 上游是纯推理端点:模型返回的 tool-calls 只是数据;执行、权限与结果始终在 DSH 这一侧。上游网关无从执行本地动作。
  • 插件自己不监听任何端口:没有子进程、没有 Basic 认证。设置 API 只是挂进 DSH 自带 web 服务的一个路由前缀,并且只接受回环来源与 application/json;出站只有对两条车道网关的 HTTPS,TLS 校验不关闭。
  • 免费车道的 authorization 是上游免费池的公共池化凭据(与 OpenCode 客户端自带的一致),不存在任何用户私有密钥;Kilo 车道完全不发送凭据。
  • 工具名在响应侧经可逆映射还原后才校验:不在调用方工具清单里的名字(含官方注入项)一律丢弃并告警,不会把未经检查的动作送进执行层。
  • 会话、请求、项目头的派生是确定性的,不携带任何宿主环境秘密;发往上流的系统提示词只包含插件自己的进程元数据(工作目录 / 平台 / 日期)。
  • 插件停用或进程退出时,进行中的探测被中止;没有需要回收的子进程。

已知限制

  • 免费模型由上游随时调整,某个模型探测失败或临时 5xx 是常态;探测与真实请求的失败都会记录在设置页(请求失败保留原权重,健康状态与滞后规则并存),重试即可恢复。手动检测失败不推进自动检测的计时与连败计数;回收建议只由连续 3 个周期的自动检测失败点亮。清单刷新失败时若缓存目录仍在,请求会用缓存目录继续服务,并在设置页提示刷新错误。
  • 插件拿到完整回复后一次性发出内容块(非 token 级流式);DSH 侧的工具循环不受影响。
  • 免费车道清单里走 /responses 与 Anthropic /messages 线型的 id(muse-spark、union-alpha)不发布:本插件只实现 Chat 线型。
  • 上游按出口 IP 计免费配额:一个烧掉的出口会以 429 + 小时级 Retry-After 回答;断路器会在窗口内本地拒绝,换出口即清窗。不支持配置出站代理。
  • Kilo 免费池由上游免费提供,其模型卡声明 prompt 可能被记录用于改进服务——请勿发送敏感内容。
  • 只发布免费模型。付费模型、需要用户自有 API Key 的供应商不会出现。
  • iPhone(Fish Pocket)上只有 Host 半身会运行:React 管理页要经 App 内的「探索 → 网页版」才看得到,原生侧能用的是设置表单里的两个开关、七个工具与 /wb-free 指令,详见 在 iPhone 上用。

开发

node --check index.js
node --check client.js
node --check src/*.js
node --check src/o2a/*.js

插件没有构建步骤,也没有运行时依赖:Host 半使用 Node 内置模块,浏览器半只 require('react')。cordis.patch.yml 负责把插件插进 profile 的 bundle 链,catalog/dsh-plugin.json 是 dsh.so 的发现清单。

src/o2a/ 与其资产来自 dsh-our-free-model(MIT)逐字收录,仅作格式化对齐;上游契约更新时以该仓库为准同步。

许可

MIT。信封协议(历史版本)与运行时隔离逻辑来自 MIT 许可的 wbBridge;免费车道线契约来自 MIT 许可的 dsh-our-free-model。

Comments

Loading…