🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

Xyanxhu/kilo-zen2dsh

DeepSeek Harnessspec-screened扫描:中风险在 GitHub 查看 ↗
需源码安装

在 DSHDeepSeek Harness中原生使用 Kilo Gateway 与 OpenCode Zen 免费模型。

暂不能直接安装(需源码编译或环境不满足):缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。 · 最近上游提交 2026/9/24 · 已提供中文文档

Kilo Gateway 为 DeepSeek Harness(DSH)提供的免费模型

综合分
36.2
GitHub 分
36.2
用户评分
—
★ Stars
4
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add Xyanxhu/kilo-zen2dsh
缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装,改用 GitHub 源安装
信任档位:需留意静态安装检查未通过
是什么
dsh 原生插件 · other
装得上吗
静态安装检查未通过,可能需要源码安装
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 1 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

数据截至 2026/9/25(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包kilo-zen2dsh(未发布到 npm,仅可源码安装)
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明

缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/22 11:29:14

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
kilo-zen2dsh

在 DSH(DeepSeek Harness)中原生使用 Kilo Gateway 与 OpenCode Zen 免费模型。

Kilo 免费层无需 Key;OpenCode Zen 是独立的兼容线路,匿名可用性由 Zen
网关决定。

npm
license

kilo-zen2dsh 向 DSH 注册两个彼此独立的原生 LlmAdapter:

- kilo2dsh:Kilo Gateway,模型发现 /api/gateway/models,对话
/api/gateway/chat/completions
- opencode2dsh:OpenCode Zen,模型发现 /zen/v1/models,按模型使用
/chat/completions 或 /responses

Kilo 默认免费通道是真正的无鉴权请求:插件内部为兼容 pi-ai/OpenAI SDK 使用空
Key,并在发送前抑制 SDK 自动生成的 Authorization 头。Zen 兼容通道默认使用
Bearer public 和 OpenCode 兼容请求标记;是否允许匿名、额度和账号要求仍由
Zen 网关决定。两条线路都不绕过认证或计费。

特性

- 原生 adapter:发布包不拉起子进程、不监听本地端口。
- 动态免费模型目录:优先使用 Kilo 返回的 isFree/is_free;兼容
kilo-auto/free、openrouter/free 和 :free/-free 命名。
- 独立的 OpenCode Zen 目录和 opencode2dsh adapter;包含文档列出的免费
模型,并为 muse-spark-1.2-contributor-free 自动使用 Responses API。
- 默认只显示文本输出且支持 tools 的模型,适合 DSH agent 调用。
- 启动重试、周期刷新、7 天磁盘缓存和健康快照。
- 可选显式 Kilo/Zen token;默认不会读取环境中的账号密钥。

安装

dsh plugin --profile web add @huanx/kilo-zen2dsh

如果 npm 包尚未发布,可在当前代码库中打包后安装:

cd packages/plugin
pnpm install
pnpm pack
dsh plugin --profile web add ./huanx-kilo-zen2dsh-0.4.0.tgz

重启 dsh web,打开模型选择器,在 kilo2dsh(Kilo)或 opencode2dsh
(Zen)分组中选择模型即可。要求 Node.js 20 或更高版本。

配置

默认配置会注册 Kilo 和 Zen 两个 adapter;Kilo 线路无 Key,Zen 使用公共
兼容占位凭据:

- id: kilo2dsh
name: '@huanx/kilo-zen2dsh'
config:
mode: adapter
providerId: kilo2dsh
gatewayBaseUrl: https://api.kilo.ai/api/gateway
refreshSeconds: 300
requireTools: true
zenEnabled: true

如需使用已认证的兼容网关,显式设置对应的环境变量。Kilo 的
upstreamApiKeyEnv 和 Zen 的 zenApiKeyEnv 默认都为空,不会误读环境中的
其他密钥。

| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| mode | adapter | 原生 adapter;sidecar 是可选的旧版 Go bridge。 |
| providerId | kilo2dsh | Kilo 在 DSH 中的 provider 名称。 |
| gatewayBaseUrl | https://api.kilo.ai/api/gateway | Kilo 兼容网关地址。 |
| refreshSeconds | 300 | 模型目录刷新间隔(秒)。 |
| requireTools | true | 是否隐藏未声明 tools 的免费模型。 |
| upstreamApiKeyEnv | 空 | 显式指定后才从该环境变量读取 Kilo Token。 |
| anonymousKey | 空 | Kilo 私有兼容网关的可选 Token;为空则不发送鉴权头。 |
| zenEnabled | true | adapter 模式下是否注册 OpenCode Zen。 |
| zenProviderId | opencode2dsh | Zen 在 DSH 中的 provider 名称。 |
| zenBaseUrl | https://opencode.ai/zen | OpenCode Zen 根地址。 |
| zenUserAgent | 空 | 可选兼容 User-Agent;为空时按 OpenCode 格式生成。 |
| zenApiKeyEnv | 空 | 可选的 Zen 账号 Token 环境变量。 |
| zenAnonymousKey | public | Zen 公共占位凭据;私有无鉴权部署可设为空。 |

只使用 Kilo 时设置 zenEnabled: false。sidecar 是旧版 Go bridge,目前只
暴露 Kilo;双 provider 功能在原生 adapter 模式中提供。

请求行为

Kilo:
GET  https://api.kilo.ai/api/gateway/models
POST https://api.kilo.ai/api/gateway/chat/completions
(默认免费层不带 Authorization)

OpenCode Zen:
GET  https://opencode.ai/zen/v1/models
POST https://opencode.ai/zen/v1/chat/completions
(Bearer public + OpenCode 兼容请求头)
POST https://opencode.ai/zen/v1/responses
(Responses-only 免费模型使用)

Kilo 请求使用普通 OpenAI 兼容 JSON/SSE,并附带 Kilo 关联头:
X-KILOCODE-EDITORNAME、X-KILOCODE-TASKID、X-KILOCODE-PROJECTID。
Zen 请求附带当前匿名线路要求的 OpenCode 兼容标记;这只是上游兼容要求,
不保证 Zen 永久接受第三方客户端。

免费模型筛选顺序:

1. 有 isFree/is_free 时以服务端字段为准(包括显式 false)。
2. 没有字段时,Kilo 接受 kilo-auto/free、openrouter/free 及以 :free 或
-free 结尾的 ID;Zen 接受文档中的 big-pickle 和 :free/-free ID。
3. 默认排除图片输出模型和未声明工具调用能力的模型。

自动校正上下文与输出上限

Kilo 模型目录的限制字段并不总是在同一层:它可能出现在顶层记录、
top_provider 或嵌套的 limit(s) 对象中,不同兼容网关的字段拼写也可能不同。
adapter 会合并这些声明并取所有正数限制中的最小值作为有效上下文窗口;输入上下文
窗口与输出预算分开计算。

当前目录把 minimax/minimax-m3:free 的最大输出报成 943,718,但后端实际拒绝大于
524,288 的请求。因此 adapter 对 defaultMaxTokens 以及发到网关前的
max_tokens/max_completion_tokens 统一施加 524,288 的网关兼容上限(模型自身更
小的限制优先)。即使 DSH 传入过大的默认值,也会自动下调,无需手工改模型配置;
同时保留目录声明的 1M 输入上下文窗口,避免因为这个错误把可用上下文一并缩小。
这个兼容上限只用于 Kilo;OpenCode Zen 仍使用自己的目录限制。

Zen 的公开 /v1/models 记录目前只有最小 OpenAI 字段,实时目录成功后会替换
源码内的 bootstrap 列表;目录不可用时会使用独立的 Zen 缓存和静态列表。

健康状态与限额

Kilo 健康快照:~/.kilo2dsh/adapter-status.json,Zen 健康快照:
~/.kilo2dsh/zen-adapter-status.json;对应缓存为 kilo-models.json 和
zen-models.json。

匿名免费额度由 Kilo 控制并按出口 IP 限流;Kilo 当前文档说明为每个 IP 每小时
200 次。遇到 429 或模型暂时不可用时,请稍后重试、换另一个免费模型,或自行
配置认证 Token。

Zen 免费模型是限时推广,可能撤下或限流;部分部署会对非 OpenCode User-Agent
返回 429 FreeUsageLimitError。请将 Zen 视为尽力服务,不要向免费模型发送
敏感数据;需要账号时设置 zenApiKeyEnv。

旧版 sidecar 可选构建:

cd legacy
go build ./cmd/agent
go test ./...

sidecar 对 DSH 保留本地带 Key 的 /v1 接口,但访问 Kilo 上游时使用同样的
无鉴权语义和 /api/gateway 路径。需要 Zen 时请使用原生 adapter 模式。

改造来源

本项目基于 FishBottle7/opencode2dsh
的 DSH/OpenCode 适配原型改造:Kilo 是迁移目标,原有 Zen 免费层作为独立的
原生 adapter 保留,没有混入 Kilo 的无 Key 传输。Kilo、Zen 和 QwenPaw 的协议
参考见下方“参考资料”。

开发

cd packages/plugin
pnpm install
pnpm typecheck
pnpm test
pnpm build

参考资料

- Kilo Gateway Authentication
- Using Kilo for Free
- Kilo Gateway API Reference
- OpenCode Zen 文档
- OpenCode provider 源码(apiKey: public 免费线路)
- OpenCode issue:Zen 匿名 User-Agent 行为
- QwenPaw Kilo provider
- @earendil-works/pi-ai

许可证

MIT © FishBottle7

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群