dsh-our-free-model-fish

dsh-our-free-model-fish

简体中文 | [English](README_EN.md)

> 这是上游项目的社区改版，不是原创项目。 本仓库 fork 自

> [Ebony-Vinyl/dsh-our-free-model](https://github.com/Ebony-Vinyl/dsh-our-free-model)：代码、界面、

> 文档与发布流程的绝大部分由上游作者 Ebony-Vinyl 及其贡献者完成，本仓库只在其基础上做增量修改，

> 并以 dsh-our-free-model-fish 的包名发布到 npm，以免占用上游的包名。上方徽章与榜单成绩、

> 文末 Star 曲线均属于上游仓库。逐项差异见[这是什么](#这是什么)。

> 你只需在 dsh 里装上这个插件，无需登录、注册、填 API Key 或任何其它操作，

> 就能用上包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿模型——完全免费，不限量。

>

> *All you do is install this plugin in dsh: no login, no sign-up, no API key, nothing

> else. The frontier models are just there — DeepSeek V4.1 Flash, Kimi K3 and the rest.

> Free, with no usage cap.*

>

> 模型清单跟随上游刷新，可用性由你自己这台机器的网络出口实测得出，

> 思考强度下发的是真实预算而不是提示词，另附一个 OpenAI 兼容的本地转发端口。

>

> 纯插件挂载：不改内核、无构建步骤、零依赖。

---

交流群

QQ 群：386179533（AI 技术交流学习群）

扫码加入群聊，一起交流插件使用心得、反馈问题与分享玩法。

---

这是什么

**本仓库是上游 [Ebony-Vinyl/dsh-our-free-model](https://github.com/Ebony-Vinyl/dsh-our-free-model) 的

社区改版（fork），不是原创项目。** 上游作者是 Ebony-Vinyl，插件的能力、界面与绝大部分代码都由

上游与其贡献者完成；这里做的是在其基础上叠加若干改动，再用一个自己的 npm 包名

dsh-our-free-model-fish 发布，以免占用上游的 dsh-our-free-model。

| | 上游 dsh-our-free-model | 本改版 dsh-our-free-model-fish |

| --- | --- | --- |

| 仓库 | [Ebony-Vinyl/dsh-our-free-model](https://github.com/Ebony-Vinyl/dsh-our-free-model) | [Fish-under-sea/dsh-our-free-model-fish](https://github.com/Fish-under-sea/dsh-our-free-model-fish) |

| npm 包名 | dsh-our-free-model | dsh-our-free-model-fish |

| 维护者 | Ebony-Vinyl 及上游贡献者 | Fish-under-sea（仅维护本改版） |

| 榜单 / Star 数 | 属于上游仓库 | 与本仓库无关，不应据此评价本改版 |

本改版相对上游的增量（截至 2.2.0）：

• 免费通道按面积计价（src/image-pricing.js）——缺少厂商视觉计价协议时，按图片真实像素估算

视觉 token，替代上游固定 1024 的兜底估算；已移出请求的图片只计描述文本。

• 渠道目录可见性总开关（src/channel-visibility.js）——渠道包 13 个 provider 的分组可一次性收起，

不必逐个模型关闭，也不受远端新增模型影响。

• 公告改挂 body 并补齐键盘可达——公告正文渲染与焦点顺序按无障碍要求调整。
• 包名与发布身份独立——dsh-our-free-model-fish，行 id 与数据目录名仍为 our-free-model，

因此从上游切换过来不会丢失设置（数据仍在 $DSH_HOME/our-free-model/）。

• 去掉了上游 package.json 的 private 标记，使 npm 安装可用。

上游的发布私钥不在本机，所以本仓库无法签发自己的自升级清单（feed/manifest.json、

catalog/integrity.json 沿用上游签名，不随本改版刷新）。由此产生一个必须知道的风险：

• 应用内「检查更新」读的是上游仓库的清单。实测该清单能通过本插件内置公钥的验签

（上游与本改版共用同一个信任根），且上游版本（写作时为 2.5.1）高于本改版的 2.2.0，

因此设置页会提示有更新。

• 一旦按下「立即升级」，升级器会把上游的 74 个文件写进本插件的安装目录，并删掉本改版独有的

文件（如 src/channel-visibility.js、src/image-pricing.js）；package.json 会被换成上游的

"name": "dsh-our-free-model" 与 "private": true，与 dsh.profile.bundles 里写的

dsh-our-free-model-fish 失配，启动即报找不到 bundle。

• 结论：本改版的升级请一律走 npm（npm i dsh-our-free-model-fish@latest），不要点应用内的升级按钮。

回滚办法：$DSH_HOME/our-free-model/rollback/ 里保留了升级前的完整副本，覆盖回插件目录即可。

上游的 issue、PR、讨论与 Star 都请提交到[上游仓库](https://github.com/Ebony-Vinyl/dsh-our-free-model)；

只有本改版自身引入的问题才提到本仓库。

---

亮点

• 开箱即用，无配置环节——不需要账号、不需要 Key、不需要在后台申请配额。
• 上游来源公开透明——免费车道来源为 OpenCode 的 Zen 网关（https://opencode.ai），Kilo 渠道来源为 Kilo AI 的公共网关（https://kilo.ai），均直连、不经任何第三方中转。请求由谁处理、数据发往何处，见「上游是哪些源」与「免责声明」。
• 清单跟随上游——模型集合、上下文长度与能力在每次刷新时向上游重新拉取，插件内不保存静态快照。
• 选择器只广播可用的模型——上游清单已声明但网关明确拒绝路由的模型（返回 Model is unavailable、或 404 找不到该 id）从下拉框移除，仅在设置页保留记录并注明拒因；网关自身故障（5xx）、配额限制（429）、超时与断网不属于对模型的判定，一律保持可达；被地区策略拦截的模型归入 region-limited 分组。整轮探测全部被拒时同样保留，选择器不会为空。
• 公告中心 + 实时推送——仓库维护者在仓库中编辑 JSON 并推送后，所有已安装实例最迟在一个轮询周期内收到；正文为白名单约束下的 HTML，支持图文排版；urgent 级别触发全屏弹窗；可选系统级通知。
• 应用内升级——设置页一键升级：下载 → SHA-256 校验 → 备份 → 原子替换 → 校验回读 → 热重载，任一步失败自动回滚至上一版本。
• 热重载——升级与代码变更即时生效，无需重启应用；也可在设置页手动触发，或启用文件监视自动重载。
• 按响应体形状判定流式响应——网关在高负载下会以 application/json 的 content-type 返回完整的 SSE 帧序列。插件按响应体形状判定，并将已嗅探的字节重新注入流，既不会导致整轮失败，也不会因 header 与实际内容不符而将可用模型判为不可用。
• 思考强度实际生效——Light / Balanced / Deep 对应输出 token 预算 2 048 / 8 192 / 模型上限，且逐次调用留痕。思考不可关闭的模型（MiMo V2.6 等）三档整体翻倍为 4 096 / 16 384 / 模型上限，因为思考与正文共享同一输出额度；设置页每张模型卡均标注该档位实际下发的上限。该能力通过硬性输出上限实现，不依赖上游的 effort 参数（原因见「为什么用预算，而不是 reasoning_effort」）。
• 不依赖浏览器界面——插件仅将 llm 作为硬依赖，在没有 web server 的 composition（如 dsh-tui）中同样完成启动并输出模型；看板模块挂载在独立的 fiber 上，待 webServer 就绪后再注册路由，因此既不会阻塞模型车道，也不会因插件先于 web 服务加载而永久丢失设置页。
• 用量看板，数据全部留在本机——Token 热力图、总量曲线（支持总计与单模型视图）、输出速度与首字延迟逐次采样。不上传任何数据。
• OpenAI 兼容转发端口——本机其它工具通过 base URL 与 Key 即可调用这些模型。
• EAC 渠道（桌面端专属）——在 DeepSeek Harness 桌面端与 DSHEAC AIO 桌面端中自动解锁一条协付通道，模型以 EAC 前缀显示（如 EAC DeepSeek V4.1 Flash）；凭据加密密封，由宿主指纹闸门把守；该渠道在服务器侧校验 GitHub 授权（登录并 star 本仓库）后才放行对话；在命令行及其它宿主中该通道完全不存在。详见「EAC 渠道」。
• Kilo 渠道（免密免费池）——内置 Kilo AI 公共网关的免费模型池（isFree 清单实时拉取，含 kilo-auto/free 自动路由），无需任何账号或 Key；模型卡带 Kilo 徽章。思考强度与 EAC 渠道同款：模型自身的档位菜单（Off / Low / Medium / High，默认 High），经网关统一的 reasoning 参数真实下发——Off 已逐家族实测将思考归零（nemotron、ling、dots、poolside、apodex、cohere）；stepfun 与 liquid 端点强制思考（对关闭请求返回 400）、两个自动路由不透传关闭，这些模型的菜单不含 Off 档。该池由上游免费提供，上游会在其模型卡中声明 prompt 可能被记录用于改进服务——请勿发送敏感内容，详见「免责声明」。
• 聚合渠道，自带 Key——设置页新增一页，把第三方端点接进同一条模型清单：注册表内置 76 家提供商（NVIDIA NIM、OpenRouter、Groq、Cerebras、SambaNova、Gemini、DeepSeek、Mistral、Together、Fireworks、SiliconFlow、Nebius、Chutes、Hugging Face、Cloudflare、Z.ai、Kimi、MiniMax、QwenCloud/Alibaba、Bedrock、Vertex、Vercel AI Gateway、Azure OpenAI，以及无需账号的 Ollama、LM Studio、llama.cpp），写入 Key（本机免账号的提供商不需要）后其模型即以 provider/model 出现在选择器里，也可经本地网关调用。Key 只写入本机 0600 的 settings.json，API 只回显 hasKey 与 …abcd 指纹；每家可单独启停、测试（列表探测，不花一次生成）、发现模型、覆盖 Base URL 与模型清单。OAuth 与 ADC 认证的提供商照常列出，但标注为不可驱动。
• 省 Token——三件事：工具输出压缩（RTK）在请求发出前就地重写 tool_result（git diff / status / log、grep、find、ls、tree、构建日志、编号转储、搜索清单、重复日志行），实测 40 KB 的 git diff 移除 90% 的字节且模型仍能就它作答；提示词瘦身有 caveman 与 ponytail 两族、默认全关；另有五个不占用上游请求的本地应答。设置页用与用量图表同一批统计行显示压缩前后字节、节省比例、压缩块数与统计调用数。
• 路由（降级链）——把任意车道的模型串成一条命名链，以 combo: 作为虚拟模型出现在选择器与网关上；fallback 固定从链首开始，round-robin 轮换起点并连续 N 轮粘滞。链接在输出任何正文之前失败会被整段丢弃，切换对调用方不可见；思考增量不算正文，因此「想了很久才撞上配额墙」正是降级最有价值的场景。
• 本地网关原生说 Anthropic——新增 POST /v1/messages（流式与非流式，含 thinking / tool_use 块、真实 stop_reason 与流内 error 事件）与 POST /v1/messages/count_tokens（本地估算）；/v1/models 广播全部车道，含聚合行与链路。网关页新增「接入客户端」分区，按实际绑定的端口与真实要求的密钥生成 Claude Code、Codex、OpenAI SDK、Anthropic SDK、curl 与局域网的可复制配方。
• 接口具备鉴权围栏——