bryanchen463/dsh-openrouter-free

dsh-openrouter-free

标签: 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\\.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', '')(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