前言¶
DeepSeek Harness（DSH）的「一切皆插件」理念让用户可以按需扩展功能。但原生界面在快捷入口、消息汇总、模型管理和插件生态等方面仍有改进空间。黎猫工具箱为 DSH 提供模块化的 UI 增强与交互优化，通过独立开关各组件，在不改变宿主逻辑的前提下补充快捷栏、起始页、消息中心、插件管理及 Windows 启动保护等能力。
插件定位与维护¶
该插件为社区项目，由维护者 TanukiRei 维护，遵循 MIT 许可证，非 DeepSeek 官方产品。它通过独立模块化方式扩展 DSH 功能，当前版本为 0.7.9，包声明支持 DSH >=0.2.0-rc.2 <0.3.0。
核心组件¶
工具箱默认提供模型屏蔽功能：启用「设置优化 → 模型」后，在「设置 → 模型」的服务和模型行旁管理开关。关闭后该模型将从 DSH 模型目录和选择列表隐藏，并在宿主请求准备及实际派发前拦截。已有对话仍选中该模型时，仅显示灰色、不可再选择的占位项，禁止发送并提示「该模型已禁用」；切换其他模型后移除占位并恢复发送。限制保存在当前 profile，重新开启即可恢复；关闭设置优化不会清除已保存的开关，关闭工具箱本体后不再拦截。
主要组件包括：
- 启动保护：启动前检查明确声明的版本不兼容，停用符合条件的第三方插件；Windows 支持快捷方式保护和登录后自启动。长按 1 秒可触发一键重启。
- 快捷栏：编辑左侧入口的顺序与显示状态；工作区可收起、拖动调整宽度并保存，支持一键重启。
- 起始页：查看日期、对话与任务概览、昨日已记录 Token、近期活动与受支持的账号额度。
- 对话框优化：提供时间统计、模型与推理等级卡片、受支持的速度控制，以及任务文件的右键操作。
- 设置优化：紧凑的模型管理，支持服务与模型排序、开关、默认选择及独立编辑弹窗。
- 消息中心：顶部灵动岛、系统通知、持久气泡与提示音；可按来源控制通知和对应气泡。
- 插件中心：区分官方与第三方插件，提供搜索、版本号、自定义名称、更新入口及「插件市场」集成。
组件按需加载；关闭组件不会在冷启动时预载该组件的功能代码。已加载模块可能仍保留在引擎缓存中。
安装与启用¶
在 DSH 的「插件 → 添加插件」中填写仓库地址：
https://github.com/TanukiRei/tanuki-toolbox
安装后启用「黎猫工具箱」，再按需开关各组件。仓库包含构建结果，不需要在安装时编译。直接填写仓库地址需要本机可用的 Git；如果电脑没有 Git，请使用 Releases 中的「免 Git 安装地址」。离线安装包见 Releases。
从旧版本更新时请直接安装上述地址，无需卸载，以保留现有组件设置。
速度接口接入¶
开启「设置优化 → 模型」后，兼容 OpenAI Chat Completions 的服务可读取 {baseURL}/models 的 capabilities.service_tiers。只有明确包含 priority 或 fast 的直接模型显示速度选择；服务商 ID 和完整模型 ID 保持原样。展开服务可点击「重新读取速度能力」；「获取可用模型」也会同步读取能力。模型卡片的闪电按钮直接切换「标准／快速」，未启用模型卡片时显示于原生模型选择旁。标准明确发送 service_tier=default，快速发送 priority；默认/还原保留继承中枢（省略速度参数），首次点击明确请求快速。偏好按会话、提供商和模型保存，每轮任务捕获快照；重试、工具续写和继承的子任务不受其他会话改档影响。
点亮的蓝色实心闪电表示 DSH 请求快速，配色与推理等级一致；实际执行档位以接口返回为准。闪电按钮的悬停说明显示中枢 SSE 的实际确认：未返回实际档位时只显示「等待确认／未确认」，不会把按钮点亮当作上游已生效。凭据仅由 DSH 宿主读取；能力失败保留配置并提供重读入口，不切换其他账号或模型。
适用场景与注意¶
适合需要统一管理模型、查看概览与历史、聚合通知以及通过插件市场管理扩展的用户。工具箱以当前 DSH 进程权限运行，安装前应检查源码与许可证。启动保护仅检查明确声明的版本不兼容，不保证拦截未声明的运行时故障；直接启动 DSH 原始程序不会经过快捷方式保护。
总结¶
黎猫工具箱通过模块化组件为 DSH 补充了快捷栏、起始页、对话框与模型设置优化、消息通知、插件管理及 Windows 启动保护等能力。它不改变 DSH 核心逻辑，而是通过独立开关和配置持久化提供渐进式增强，适合希望精细化控制界面与工作流的用户。
