前言¶
當你在 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。
- 更新插件不會覆蓋已下載的目錄數據。
