Liquid 推理路由 architect-xyz/liquid-dsh-plugin

dsh-liquid-inference

Liquid Inference 接入 DeepSeek Harness：提供 liquid 模型路由，外加一组只读的市场工具。

安装

尚未发布到 npm。从 GitHub 或打包好的 tarball 安装，然后导出一个带 spend 权限的买家密钥，重启配置档：

export LIQUID_API_KEY=sk-liquid-...

从 GitHub 安装。 包会在安装时自行构建，pnpm 默认拦截这一步，需要你先放行：

dsh plugin --profile web add github:architect-xyz/liquid-dsh-plugin

首次运行会报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED。在 $DSH_HOME/profiles/web/pnpm-workspace.yaml 的 allowBuilds 下加上这个包，再跑一次命令：

allowBuilds:
dsh-liquid-inference: true

放行之后，包就能在安装时于你的机器上运行构建脚本，不受任何沙箱限制。请固定到某个 commit（github:architect-xyz/liquid-dsh-plugin#<sha>），这样后续推送无法改变实际运行的代码。

从 tarball 安装。 不需要构建权限：

git clone https://github.com/architect-xyz/liquid-dsh-plugin.git
cd liquid-dsh-plugin && pnpm install && pnpm pack
dsh plugin --profile web add ./dsh-liquid-inference-0.1.0.tgz

在模型选择器里选 Liquid Auto（liquid.auto）。

新增内容

模型路由 liquid —— 没有适配器代码。bundle 补丁把自带的 llm-pi-ai 适配器配置为 api: openai-completions、baseURL: https://router.inference.ai.exchange/v1 和 apiKeyEnv: LIQUID_API_KEY。

- 费用上限。 每个请求都带 x-liquid-cap-usd，表示这次请求最多花多少钱，在第一个 token 之前锁定。默认 1 USD；在启动环境里设置 LIQUID_CAP_USD 可以改。
- 模型。 liquid.auto 及其排序变体 :cheapest、:economy、:balanced 和 :premium（见 GET /v1/exchange/routers 的描述），以及固定模型 deepseek-v4-flash。想加 GET /v1/models 里的任何 id，在配置档的 cordis.patch.yml 里写一条 models 即可。
- 推理。 low、medium、high 三档以 reasoning_effort 发送。交易所原样透传，不做校验，所以中标服务商不接受的档位会让该请求失败。

工具（插件 liquid-inference）

| 工具 | 端点 | 需要密钥 |
| liquid_get_book | GET /v1/exchange/offers | 否 |
| liquid_get_markets | GET /v1/exchange/markets | 否 |
| liquid_get_routers | GET /v1/exchange/routers | 否 |
| liquid_get_job | GET /v1/jobs/{id} | 是 |

对话、图像、语音和视频购买刻意不做成工具：花钱的地方只有 harness 自己的模型路由这一处。

数据流

完整提示词和工具结果都会发往 router.inference.ai.exchange，再由它转发给竞价胜出的第三方服务商。密钥按请求读取：配置档挂载了凭据存储时从存储读取，否则从 LIQUID_API_KEY 读取（无头配置档会禁用存储）。密钥绝不会写入配置。

说明

- 补丁会替换 llm-pi-ai 这一行的整个 config。如果其他 bundle 也配置了 pi-ai 服务商，请在配置档的 cordis.patch.yml 中重新声明它们。
- 开发：pnpm install && pnpm run check。pnpm run test:install 会打包 bundle，把 tarball 安装到真实 dsh 的隔离配置档中并启动它（DSH_VERSION 指定版本，默认 next）；该命令需要网络访问。