dsh-openrouter-free

Tags: dsh-plugin · openrouter · free-models · deepseek-harness · openai-compatible

为 DeepSeek Harness (DSH) 接入 OpenRouter 免费(:free)模型的轻量配置包: 配置片段 + 实时拉取免费模型清单的脚本。不含任何 API key / 密钥。

DeepSeek Harness 的模型通道(llm-pi-ai)支持 OpenAI 兼容端点。注册一个 openrouter provider 路由后,免费模型即可出现在会话/子代理的模型选择器里。

先决条件

• DeepSeek Harness(配置热加载于 $DSH_HOME/settings.yaml, Windows 默认 C:\Users\<you>\.dsh\settings.yaml)。
• OpenRouter API key —— 免费模型同样需要 key,只是单价为 $0 (https://openrouter.ai/keys)。
• Python 3.8+(仅用于可选的刷新脚本,纯标准库、无第三方依赖)。

安装

1. 把 provider-openrouter.yml 中的 openrouter provider 合并进 settings.yaml 的 llm-pi-ai.providers 下 (与已有的 providers: 条目并列)。harness 检测到文件变化后热加载,无需重启。

2. 提供 key(任选其一):

   • 设置环境变量 OPENROUTER_API_KEY,或
   • 存入 harness 凭据库:Models 页面填写,或 ctx.credentials.set('OPENROUTER_API_KEY', '<your key>')(DSH 内动态插件调用),
   • 也可以直接编辑 $DSH_HOME/.credentials.yaml 的 refs(不推荐手改)。

   不要用明文提交任何 key;apiKeyEnv 只是引用名。

3. (可选)刷新免费模型清单:

   python scripts/fetch_free_models.py --api-key sk-or-v1-...
   # 或:OPENROUTER_API_KEY=sk-or-v1-... python scripts/fetch_free_models.py
   # 输出当前全部 :free 模型,追加到 settings.yaml 的 models: 下
   

4. 新开一个会话,在模型选择器里选择 OpenRouter (Free) 组下的模型即可。

验证

在 DSH 里确认路由与调用链路(以本仓库示例模型为例):

llm.listProviders()          # 应包含 id: openrouter
llm.prepareCall({provider:'openrouter', model:'cohere/north-mini-code:free'})  # ok

注意事项

• OpenRouter :free 端点随时可能上下架,且有频率/额度限制(通常数十~上千 请求/天,取决于端点)。请以 fetch 脚本的实时结果为准。
• 本机网络若通过代理访问 openrouter.ai,需保证代理对该域名放行。
• 本项目与 DeepSeek / OpenRouter 官方无关联,纯配置示例,按 MIT 许可提供。

License

MIT