前言¶
当你在 DSH 中接自己的网关时，模型往往只写了个名字。DSH 默认按“网关名 + 模型 id”去目录比对，由于自定义网关不在目录中，这些模型会被默认为“无能力”（上下文 256K、无推理等级、无视觉）。实际上，模型名在目录里是存在的。这个插件按模型名去目录查一次，把上下文长度、输出上限、推理等级、视觉能力补上。
插件简介¶
- 名称:
pgjh/dsh-model-metadata - 维护者: pgjh
- 类别: 模型推理
- 许可证: MIT
核心功能¶
- 按名查询与补全: 取 id 末尾的模型名进行查询，支持官方目录、pi-ai 目录、opencode 和 models.dev。
- 非破坏性: 仅补全缺失字段，不覆盖用户手动写入的字段。
- 图形控件: 提供推理等级和视觉能力的界面控件。
- 自动更新: 目录数据会自动更新。
安装与启用¶
- 确保环境满足 Node.js >= 22。
- 执行安装命令：
dsh plugin --profile web add dsh-model-metadata
- 重启 DSH 进程。
使用方法¶
- 在设置页编辑网关卡片，找到“自定义设置”下的“模型目录”区域。
- 每个模型行会出现“推理等级”和“视觉”控件，以及一行结论（如：
自动匹配：anthropic · 200K / 输出 64K · 有推理等级 · 视觉）。 - 修改控件后点击“写入”，将设置固化到配置文件中。
目录数据与配置¶
- 存储位置: 目录数据存储在
$DSH_HOME/models-dev-snapshot.json。 - 手动刷新: 可通过
node lib/refresh-snapshot.mjs手动刷新。 - 配置控制: 可通过环境变量
DSH_PI_AI_CATALOG_FALLBACK控制补全行为（如full,context,off）。
注意事项¶
- 需要配置 DSH Home。
- 更新插件不会覆盖已下载的目录数据。
