dsh-model-context-catalog

<a id="top"></a>

<h1>Model Context Catalog</h1>

一键匹配模型上下文，勾选后批量配置。

主要功能 · 一键匹配 · 手动管理 · 匹配规则 · 开发

dsh-model-context-catalog 是 DSH 的模型上下文配置插件。点击 一键匹配，即可为模型目录中已添加的模型查找上下文容量，查看模型厂家、服务商与资料来源，勾选后批量配置，省去逐个查询和填写的工作。

已有上下文窗口的模型也能纳入管理。 默认保留当前值；需要改值时，可选择参考容量或手动填写。添加后可以集中编辑、启停和持续同步。

主要功能

功能	你可以做什么
一键匹配模型上下文	扫描 DSH 已配置模型，自动查找上下文窗口及容量来源
勾选后批量配置	逐项勾选或全选，确认后一次添加所选模型并启用管理
CLIProxyAPI 容量获取	从已配置的 CLIProxyAPI 接口读取模型上下文容量，按模型 ID 匹配并展示来源
自动获取容量资料	点击一键匹配时自动获取 models.dev 资料，涵盖 GPT、Claude、Gemini、DeepSeek、GLM、Qwen Coder、Kimi、MiniMax 等系列；缓存 24 小时，过期自动更新
服务商容量匹配	优先使用对应服务商的容量；未命中时使用模型目录默认值，并展示来源链接
模型名称与别名匹配	支持 k3、m3 等短名称、astra-gpt 等乱序名称，以及大小写、分隔符、服务商前缀和日期后缀
管理已有窗口	已填写窗口或使用 DSH 内置窗口的模型也能添加，默认保留当前容量
手动编辑与持续同步	手动添加、修改窗口、记录来源和备注；按启用条目持续同步模型配置

安装后，点击 一键匹配 查看候选；点击 添加并启用 N 个模型 才会保存所选条目并同步窗口。

工作方式

%%{init: {"theme": "base", "themeVariables": {"fontSize": "18px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 28, "htmlLabels": false, "wrappingWidth": 420}}}%%
flowchart TB
    A["点击「一键匹配」"] --> B["获取 models.dev 容量资料<br/>首次或缓存超过 24 小时：在线获取<br/>否则：使用本地缓存"]
    B --> C["匹配 DSH 已配置模型<br/>优先使用对应服务商的容量<br/>查不到时：参考模型目录默认容量"]
    C --> D["核对容量与来源，勾选模型<br/>默认保留当前窗口<br/>需要改值时：选择参考容量"]
    D --> E["点击「添加并启用」<br/>保存所选模型的上下文窗口<br/>按启用条目持续同步到 DSH"]

    classDef action fill:#e8f0fe,stroke:#5675a6,color:#172b4d,stroke-width:1.5px;
    classDef step fill:#f8fafc,stroke:#94a3b8,color:#1e293b,stroke-width:1px;
    class A,E action;
    class B,C,D step;

插件通过 DSH 原生配置接口同步已有模型的 contextWindow，保留模型名称、API 地址、凭据、协议和输出上限。每个 provider / model 路由独立管理，同名模型在不同服务商下可以使用不同窗口。

安装与使用

安装

需要 DSH 0.2 系列与 Node.js 22 或以上版本。

dsh plugin --profile web add dsh-model-context-catalog

在 DSH 插件管理器中确认插件已启用。若尚未加载，重启 DSH 并刷新 Web 页面。

一键匹配模型上下文

1. 先在 DSH 模型设置中添加服务商和模型，配置好 API 地址、调用协议与凭据。
2. 打开 设置 → 上下文窗口 → 一键匹配。
3. 查看当前窗口、可选容量与来源，选择要使用的容量，再勾选需要管理的模型。
4. 点击 添加并启用 N 个模型，批量保存并同步到 DSH 模型配置。

模型当前的情况	如何添加
当前窗口未声明	使用匹配到的参考容量；模型 ID 匹配明确且只有一个参考值时，默认勾选
已有上下文窗口	默认保留当前值，勾选即可纳入管理；需要改值时，在下拉栏选择参考容量
没有公开资料，但已有窗口	直接使用现有窗口添加，来源标为当前配置
没有公开资料，也没有窗口	点击 手动填写，输入容量后保存

下拉选项会注明服务商或模型厂家；有多个参考值时，由你选择。全选会勾选已有可选容量的模型。模型配置在预览期间发生相关变更时，页面会提示重新匹配。

已由插件管理的模型不重复添加，包括停用条目。删除条目后，模型原有窗口仍保留，再次点击一键匹配即可重新添加。

自动获取 CLIProxyAPI（CPA）提供的模型容量

CLIProxyAPI（CPA） 是一款模型 API 代理软件，可以接入 Claude、Gemini、Codex 等渠道，并通过模型列表接口提供上下文容量。

点击 一键匹配，插件读取 DSH 中已配置服务商的 baseURL，通过服务端使用已有凭据和请求头，发送 GET {baseURL}/models?client_version=1 请求。查询用于 OpenAI Completions 和 Responses 路由；协议未填写时按 OpenAI Completions 查询。每个服务商查询一次。

插件将响应中的 models[].slug 与该服务商下已配置的模型 ID 精确匹配，读取 context_window 作为上下文容量；该字段缺失或无效时，使用 max_context_window。匹配结果展示在容量下拉框中，来源标为 CLIProxyAPI。

• 同时按模型名称匹配 models.dev 资料，将两种来源的容量一起展示。
• 已有窗口默认保留；尚未设置窗口时，优先推荐 CLIProxyAPI 返回的容量。两种来源容量不同时，可以在下拉框中选择。
• 接口查询失败或没有可用容量时，使用 models.dev 资料和当前配置。
• 点击 添加并启用，保存所选容量并同步到 DSH。扫描后修改服务商配置，需要重新匹配。

手动管理

点击 添加模型，选择已配置模型，填写上下文窗口的 token 数（正整数）后保存；来源链接和备注可选。已有条目点击 编辑 修改容量，保存会保留原启停状态。

查看手动编辑界面

操作	结果
编辑并保存	保存窗口；已启用的条目会自动同步
关闭启用开关	保留条目并停止同步；模型已有窗口保持原值
打开启用开关	恢复按该条目保存的窗口同步
删除条目	停止管理并保留模型窗口；之后可通过一键匹配重新添加

条目启用期间，请在插件中修改窗口。若希望直接在 DSH 模型设置中维护，先关闭该条目的启用开关。窗口尚未同步、模型已移除或保存失败时，页面会显示相应提示。

匹配与容量来源

…