dsh-api3d

LIMITATIONS

Known limitations

- **单站。** 只支持一个基础地址。多站请用通用网关 provider 类插件。 - **模型目录只来自向导导入。** 目录存在插件设置 `models` 里（落进 profile 补丁层，重启仍 生效），每条可以带自己的 `input` / `contextWindow` / `maxTokens` / `reasoningEfforts`。 **没导入就一条路由都不声明** —— pi-ai 不允许空模型路由，所以刚装好时选择器里没有 API3D；清空设置后要重启一次才撤下已装上的路由。适配器自带的自动发现仍然不用 —— 它去哨兵主机发现必然失败，见「坑二」。 - **能力初值来自本插件的能力模板，不是站点声明。** `api3d.cn` 的 `/v1/models` 不报能力， 所以向导里看到的上下文窗口、最大输出与推理档位都来自 `MODEL_TEMPLATE`，需要按站点实际 能力逐条改；勾错了由上游拒绝。 - **密钥由向导代写。** 向导把这把 key 写进 `$DSH_HOME/.credentials.yaml` 的 `API3D_API_KEY`；也可以手动在设置卡或「设置 → 模型 → API3D」里填，两条路等价。 已配置后卡片上才出现「清除密钥」。 - **密钥与历史在磁盘上都是明文。** 密钥框失焦时显示成 `api3d-…cdef` 只是**界面上的**打码， `$DSH_HOME/.credentials.yaml` 里存的仍是明文（和 DSH 里其它密钥一样）；最近 5 把历史 密钥也在同一文件里（`<apiKeyEnv>_HISTORY`），点向导里的「清空历史」才会删掉。 但明文只在宿主进程与这个文件之间流动：浏览器拿到的永远只是打码标签与一个序号， 密钥值本身不会被页面读到（凭据 Remote 单向）。 - **余额 / 用量 / 计费 / 健康探测未接入。** 接缝已就位，见上。 - **`directMode: never` 在站点 WAF 拦截数据中心出口时会失败**，这是预期行为。