前言¶
DeepSeek Harness 的模型选择界面在处理多个来源和渠道时，容易出现层级冗长、分类不清的问题。本地界面插件「自定义列表」通过将平铺的模型列表重新组织为来源、类型和渠道的分层结构，让模型选择更直观。
插件介绍¶
「自定义列表」由 YOUYA 维护，为 DeepSeek Harness 提供来源分类、分层模型导航及 Our Free Model 四类型目录。插件版本 1.2.1 为预发布候选。
插件不提供 API 服务，也不附带账号或模型额度，仅作为本地界面增强组件运行。
核心功能¶
来源前缀与层级展示¶
- 来源前缀分为【官方】【插件】【中转】三类
- 当前会话选中的来源前缀以绿色显示，其余为灰色
- 一级菜单只显示来源名称和模型总数，不展开冗长层级摘要
分层结构¶
不同来源采用不同的层级结构：
- 官方/中转：来源 → 模型
- 普通插件：来源 → 渠道 → 模型
- Our Free Model：来源 → 四类型 → 渠道 → 模型
Our Free Model 的四类型包括：
- 免费模型
- EAC 模型
- 白嫖模型接入
- 聚合渠道
空分类保留入口与空状态。
保持底层信息¶
插件保留 provider/model/reasoningEffort 字段，不合并不同渠道的同名模型，不改变调用路径。
交互功能¶
支持模型搜索、推理等级调整、刷新、逐层返回及 Escape 操作。
设置与配置¶
在设置左侧提供独立配置页面，可进行以下操作：
- 新增分组
- 调整名称与顺序
- 选择来源类别
- 指定提供商归组
- 导入导出设置
- 恢复默认
关闭「启用分层模型选择器」可恢复官方选择器；此操作不删除模型或账号。
安装方法¶
通过插件管理器安装¶
在 DSH 插件管理器中，选择「从 GitHub 安装」，输入仓库地址：
https://github.com/youyaemmm-pixel/dsh-custom-lists
安装后刷新 GUI 生效；如界面未更新，完整退出并重开 DSH。
本地安装（开发/测试）¶
- 将本目录解压到稳定的本地插件目录，确保目录内直接包含
package.json、index.js、client.js。 - 在目标 profile 的
cordis.patch.yml中新增以下条目，将示例 file URL 替换为实际绝对路径：
- insert:
- id: custom-lists
name: "file:///ABSOLUTE/PATH/dsh-custom-lists/index.js"
Windows 路径需使用正确的 file URL，例如 file:///C:/Plugins/dsh-custom-lists/index.js。
- 刷新原 GUI；必要时完整退出并重开 DSH。
- 设置左侧进入「自定义列表」确认启用和提供商归组。
本地安装方式只用于开发/测试，会绕过 bundle 声明直接挂载入口文件。
数据与隐私¶
设置仅保存显示规则至浏览器 localStorage，按当前 profile 名称隔离；不包含凭据。换浏览器或清除站点数据前请导出设置。profile 名称在运行时由本机注入，不是本发布包内置的数据。插件不主动上传分组、profile 名称或诊断。
兼容性与限制¶
- 插件基于 DSH 官方模型组件
0.2.0-rc.2的接口实现，不承诺兼容所有未来版本 - 使用
conversation.input.model、settings.section、modelDirectories、sessions和remote.session；选择器优先级为 -10 - 不要与其他替换同一槽位的插件同时启用
/model命令维持官方样式- OFM 无公开可靠的渠道归属接口：使用已核实 provider ID 表和其 EAC/Kilo 展示标签
- 四类型归属依据当前可见目录及已知规则推导，不是 OFM 完整后台分类 API 的镜像
- 未知提供商不保证自动正确归类
- 不会在没有可用模型时伪造模型或连接；空目录不代表执行过网络连通性探测
故障与卸载¶
出现「自定义列表异常/会话错误」时记录完整错误，可尝试错误界面的重试或开关一次启用设置。提交 issue 前请去除账号、端点、密钥及本地路径。
卸载前建议导出显示规则。通过插件管理器禁用/卸载，或删除本地安装时新增的 custom-lists 补丁条目，然后刷新 GUI。不要覆盖整个 profile；那可能撤销其他配置修改。
许可¶
MIT。选择器适配自 DeepSeek Harness 官方组件，保留 DeepSeek 原许可。导航理念参考 dsh-model-picker。
适用场景¶
插件适合需要管理多个模型来源和渠道的用户，特别是使用 Our Free Model 等需要四类型分类的场景。使用前请检查插件源码与许可证，确认符合你的使用场景。
总结¶
「自定义列表」通过分层结构和来源分类，为 DeepSeek Harness 的模型选择界面提供更清晰的组织方式。插件安装简单，配置灵活，适合需要在多个模型来源间高效导航的用户。
