前言¶

在 DeepSeek Harness（DSH）里，Composer 选模型时看到的列表，和 Settings → Models 里某条路由下的模型顺序，来自同一份配置：该路由在 cordis.patch.yml 中的 providers.<route>.models 数组。数组里谁先谁后，设置页编号和 Composer 分组内的顺序就一致。

路由里模型一多，常用模型往往排在后面；若只改 YAML，既要找文件又要保证和 UI 一致。社区插件 dsh-model-order（维护者 Wany-i，分类：模型推理）在官方 Models 页每条 llm-pi-ai 路由的 provider 卡片上增加排序区域，用按钮调整顺序并写回配置，Composer 模型菜单无需单独处理。

这是什么¶

dsh-model-order 面向 DSH 中已声明 models 列表的 llm-pi-ai 路由。插件不新增第二套排序存储，只改写现有 models 数组元素的先后顺序；DeepSeek 官方路由、DeepSeek 账号路由及非 pi-ai 适配器族不在作用范围内。

插件当前版本 0.1.0，许可证 MIT，仓库：https://github.com/Wany-i/dsh-model-order。社区目录页：https://www.skillhub.cn/plugins/Wany-i/dsh-model-order（独立站点，与 DeepSeek / 幻方无官方从属关系）。

核心功能¶

下面介绍 README 中已说明、且与 DSH 模型链路一致的能力。

顺序的唯一来源是配置里的 models 数组。经 dsh-llm-pi-ai 的 resolveRouteModels()、ctx.llm.listModels()、buildModelCatalog() 到 Models 设置页与 Composer 模型菜单，下游均保持该顺序，因此改设置页顺序即改 Composer 展示，插件不必 patch Composer。

恢复 行为取决于路由类型：

• 对 pi-ai 自带目录的路由（如 anthropic、openai 等）：Restore default order 会移除该路由的 models 列表，回退到 pi-ai shipped 的默认顺序。
• 对手动声明的路由（如 router、中继、自托管端点）：Undo this change 仅恢复到打开卡片时的顺序，不删除配置项；对手动路由清空 models 可能导致零模型与 catalog 错误，故插件不在此处提供破坏性重置。

同一张卡片上仍可用官方编辑器增删模型；本插件区域只改顺序，不修改 id、name、contextWindow 等字段内容。

插件无独立配置命名空间；不访问网络；写入带 settings revision 校验，只替换对应路由的 models 数组；只读部署下控件会禁用并说明原因。

安装与启用¶

兼容 DSH >=0.2.0-rc.1 <0.3.0-0（README 注明在 0.2.0-rc.2 验证）；Node >=20 仅构建时需要，GitHub 发布含预构建 lib/。支持 web 与 desktop profile，安装后需重启 DSH，并对页面硬刷新（Ctrl+F5）以拉取客户端部分。

从 GitHub 安装（资料原文命令，--profile 可按实际 profile 替换为 web）：

dsh plugin --profile desktop add github:Wany-i/dsh-model-order

升级：重新执行 add 后重启。卸载：

dsh plugin --profile desktop remove dsh-model-order

插件以当前 DSH 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证。DSH 生态强调「一切皆插件」；目录来自社区，非官方应用商店。

典型用法¶

1. 打开 Settings → Models。
2. 找到已配置 models 的路由（例如 router），展开 provider 卡片。
3. 用箭头移动模型，或使用 Sort by name。
4. 打开 Composer 的模型菜单，确认同一路由分组内顺序与设置页一致。

若卡片显示 「This route has no model list of its own…」 而非排序区域，说明该路由未在配置中声明 models，当前使用 pi-ai 默认目录，无法排序直至自行声明模型列表。

适用场景与注意¶

适合：频繁在 Composer 切换模型、希望常用模型排在前列的 DSH 用户；使用 llm-pi-ai 族且已在 YAML 或设置 UI 中维护 models 数组的场景。

注意：

• 排序区域不出现：确认已安装并重启、硬刷新；若所有卡片都没有，可能是 pi-ai 族在设置中的 entry id 不是 llm-pi-ai（见 README Troubleshooting）。
• 依赖官方 Models 页为外部插件声明的 settings.models.provider-card 扩展槽，不修改 DSH 官方仓库文件。
• 无网络、无额外持久化偏好；Concurrent 编辑可能被 revision 拒绝，需刷新后重试。

结尾¶

dsh-model-order 把模型顺序编辑放在 Settings → Models 可见处，与 Composer 共用 providers.<route>.models 这一配置源，避免两套顺序不同步。进一步了解可访问社区目录页与 GitHub 仓库。

• 目录：https://www.skillhub.cn/plugins/Wany-i/dsh-model-order
• 源码：https://github.com/Wany-i/dsh-model-order