前言¶
DeepSeek Harness (DSH) 的插件化架构允许用户扩展原生功能。默认的模型选择器在处理大量服务商和模型时，界面空间有限，且分类逻辑固定。下面介绍 dsh-model-shelf。这是一个为 DSH 提供的模型选择器插件，它提供了一个宽大的、可折叠的模型面板，并允许用户手动管理“不常用”列表，以适应更复杂的模型管理需求。
核心功能¶
插件主要提供以下功能：
- 宽面板与分组：模型选择面板最大宽度为 640px，最大高度 720px，窗口较小时自动收缩。支持按服务商分组，并允许单独折叠、全部展开或全部折叠。
- 三栏管理：包含“主列表”、“不常用”和“收藏”三个独立标签页。首次使用时所有模型均在主列表，收藏列表为空。
- 手动分类：不进行自动使用频率统计。用户可手动点击“移至不常用”或“移回主列表”来调整分类。
- 账号备注：支持为服务商分组添加账号备注（如“工作账号”），备注按服务商配置 ID 保存。
- 模型身份展示：每行显示服务商名称、服务商 ID、模型名称和精确模型 ID。
- 思考强度恢复：支持一键恢复服务商默认的思考强度。对于未声明档位的模型，若安装了
dsh-workbuddy-connect，可在面板内就地检测档位。 - 上下文容量显示：若安装了
dsh-workbuddy-connect并打了 CTXPATCH 补丁，面板底部会显示每个模型声明的上下文容量（如 300K / 1M）。
安装与启用¶
本插件未发布到 npm，也不在 dsh-market 中。安装需指定版本号。
- 确保宿主 DSH 版本为 0.2.0-rc.2。
- 执行以下命令安装最新版本（v1.2.0）：
dsh plugin --profile desktop add "https://github.com/Hobartoakes/dsh-model-shelf/releases/download/v1.2.0/dsh-model-shelf-1.2.0.tgz" --ignore-scripts
如果网络受限，可先从 GitHub Release 下载 .tgz 文件，再使用本地路径安装。
安装后刷新 DSH 页面即可生效。卸载命令如下：
dsh plugin --profile desktop remove dsh-model-shelf
典型用法¶
启用插件后，点击输入框当前模型按钮即可打开选择面板。
- 管理不常用模型：在主列表找到模型，点击右侧“移至不常用”，该模型会被移动到独立标签页。在“不常用”列表中同样可以选择模型，或点击“移回主列表”。
- 使用收藏列表：点击模型旁的“☆ 收藏”按钮。收藏是快捷入口，不影响模型在主列表或不常用列表中的位置。切换到“收藏”标签页可快速使用已标记的模型。
- 添加账号备注：点击服务商标题旁的“账号备注”图标，输入备注内容并按 Enter 键保存。备注仅保存在当前浏览器，用于区分同一服务商下的不同 API 配置。
- 恢复思考强度默认值：在面板底部，如果当前模型被固定了思考强度，会出现“恢复服务商默认”选项。点击即可解除固定，恢复为服务商的默认设置。
注意事项¶
- 数据存储：插件的分类、收藏和备注偏好仅保存在浏览器的
localStorage中，键名为dsh-model-shelf.preferences.v1。不支持跨设备同步，更换浏览器或设备后需重新设置。 - 依赖要求：插件需要 DSH 0.2.0-rc.2。思考强度检测和上下文容量显示是可选功能，依赖于
dsh-workbuddy-connect插件及其补丁。 - 身份验证限制：插件无法验证上游 API 对模型 ID 的实际映射关系，仅显示 DSH 目录中声明的身份信息。
- 兼容性：目前未验证在其他 DSH 版本、macOS 或 Linux 上的兼容性。
结语¶
dsh-model-shelf 提供了一个结构化、可定制的模型选择界面，适合需要精细化管理多个服务商和模型配置的用户。通过手动分类和账号备注功能，可以更清晰地组织模型资源。更多技术细节和源码可查阅 GitHub 仓库。
