dsh-openrouter-free

Openrouter Free

OpenRouter free model panel: automatically fetches a live list of free models (overall capability rated 1–5★ and sorted with the best first), installs them into the openrouter route and switches the current conversation model with one click (writes both the global default and session-level settings;

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add dsh-openrouter-free@0.2.2

Description

Compatibility and provenance

Description

README

dsh-openrouter-free

OpenRouter 免费模型面板（DeepSeek Harness / DSH 持久插件）。特性：综合能力 1-5★ 分级标星 · 最优三优先排序 · 一键切换（会话级 + 全局双写，推理档自动预校验）。

自动拉取 openrouter.ai 的实时免费模型清单（输入/输出单价均为 $0），一键安装进本机 openrouter 路由并设为当前对话模型——免去手动编辑 settings.yaml 配置模型的麻烦。

功能

免费清单面板：GUI 会话视图新增「免费模型」标签页，实时列出 OpenRouter 全部免费模型（名称 / ID / 上下文窗口 / 是否支持图片与推理），10 分钟内存缓存，可手动强刷。
一键切换（会话级 + 全局双写）：点击任意行 → 该模型被 upsert 进 llm-pi-ai.providers.openrouter.models，同时经原生 sessionController.selectModel() 写入当前会话的模型选择并更新 agent-default-model。下一次请求即生效，无需重启（对有请求历史的会话，只改全局默认不够——三层优先级 pending→lastUsed→default 会压住它）。
推理档自动预校验：切换时从高到低试选该模型真正支持的档位（low/medium/high）；不支持推理的模型自动摘掉 reasoningEffort，避免请求以 UNSUPPORTED_REASONING_EFFORT 失败。
凭据面板：内置 OpenRouter API Key 设置入口，缺密钥时直接提示补填。
全部装进选择器：一次把所有免费模型写入路由，之后也能用 DSH 自带模型选择器切换。
安全保留手工条目：同步/切换单个模型时，所有非免费的手工条目（如 stealth/ox-alpha 的精调条目）原样保留；「全部装进选择器」也只刷新免费条目。

前置条件

本机 settings.yaml 已有 llm-pi-ai.providers.openrouter 路由（baseURL: https://openrouter.ai/api/v1）+ 环境变量 OPENROUTER_API_KEY（使用免费模型也需要密钥）。
拉取清单本身是公开 API，无需密钥。

安装

# 源码在本仓库；把包复制进运行中的 profile 并注册 bundle
Copy-Item -Recurse -Force . "C:\Users\73618\.dsh\profiles\web\node_modules\dsh-openrouter-free"
# 在 profile 的 package.json 里给 dsh.profile.bundles 追加 "dsh-openrouter-free"
# 然后重启 DSH（host 改动需重启；client 改动硬刷新即可）

HTTP API（POST /__orfree/api，body: {method, args}）

method	说明
`free.list({refresh})`	免费清单（缓存 10 分钟，refresh 强刷）
`current()`	当前 agent-default-model 与已装入的模型 id 列表
`model.use({id})`	安装单个免费模型并设为当前对话模型
`sync.all()`	全部免费模型装入 openrouter 路由
`free.remove({id})`	移除某个免费模型（当前选中者拒绝）

设计依据

DSH llm-pi-ai 适配器的 models 列表即"替换该路由 catalog"，且 settings 分节更新在下一次请求生效、无需重启（见 packages/llm/llm-pi-ai/README.zh.md）。
该适配器明确声明"路由的 catalog 不会自我刷新"——本插件就是补上这个自动化缺口。

License

MIT

README

dsh-openrouter-free

功能

免费清单面板：GUI 会话视图新增「免费模型」标签页，实时列出 OpenRouter 全部免费模型（名称 / ID / 上下文窗口 / 是否支持图片与推理），10 分钟内存缓存，可手动强刷。
一键切换（会话级 + 全局双写）：点击任意行 → 该模型被 upsert 进 llm-pi-ai.providers.openrouter.models，同时经原生 sessionController.selectModel() 写入当前会话的模型选择并更新 agent-default-model。下一次请求即生效，无需重启（对有请求历史的会话，只改全局默认不够——三层优先级 pending→lastUsed→default 会压住它）。
推理档自动预校验：切换时从高到低试选该模型真正支持的档位（low/medium/high）；不支持推理的模型自动摘掉 reasoningEffort，避免请求以 UNSUPPORTED_REASONING_EFFORT 失败。
凭据面板：内置 OpenRouter API Key 设置入口，缺密钥时直接提示补填。
全部装进选择器：一次把所有免费模型写入路由，之后也能用 DSH 自带模型选择器切换。
安全保留手工条目：同步/切换单个模型时，所有非免费的手工条目（如 stealth/ox-alpha 的精调条目）原样保留；「全部装进选择器」也只刷新免费条目。

前置条件

本机 settings.yaml 已有 llm-pi-ai.providers.openrouter 路由（baseURL: https://openrouter.ai/api/v1）+ 环境变量 OPENROUTER_API_KEY（使用免费模型也需要密钥）。
拉取清单本身是公开 API，无需密钥。

安装

# 源码在本仓库；把包复制进运行中的 profile 并注册 bundle
Copy-Item -Recurse -Force . "C:\Users\73618\.dsh\profiles\web\node_modules\dsh-openrouter-free"
# 在 profile 的 package.json 里给 dsh.profile.bundles 追加 "dsh-openrouter-free"
# 然后重启 DSH（host 改动需重启；client 改动硬刷新即可）

HTTP API（POST /__orfree/api，body: {method, args}）

method	说明
`free.list({refresh})`	免费清单（缓存 10 分钟，refresh 强刷）
`current()`	当前 agent-default-model 与已装入的模型 id 列表
`model.use({id})`	安装单个免费模型并设为当前对话模型
`sync.all()`	全部免费模型装入 openrouter 路由
`free.remove({id})`	移除某个免费模型（当前选中者拒绝）

设计依据

DSH llm-pi-ai 适配器的 models 列表即"替换该路由 catalog"，且 settings 分节更新在下一次请求生效、无需重启（见 packages/llm/llm-pi-ai/README.zh.md）。
该适配器明确声明"路由的 catalog 不会自我刷新"——本插件就是补上这个自动化缺口。

License

MIT

Openrouter Free

Description

Compatibility and provenance

Openrouter Free

Description

README

dsh-openrouter-free

功能

前置条件

安装

HTTP API（POST /__orfree/api，body: {method, args}）

设计依据

License

Compatibility and provenance

README

dsh-openrouter-free

功能

前置条件

安装

HTTP API（POST /__orfree/api，body: {method, args}）

设计依据

License

Versions

Related plugins