前言¶
DeepSeek Harness（DSH）采用插件化架构，社区开发者可以扩展其功能。但对于桌面端用户来说，DSH 原生界面相对简洁，缺少一些日常高频使用的功能，如快捷栏、起始页、消息通知和插件管理等。这些分散的需求需要逐个寻找插件实现，集成成本较高。
黎猫工具箱（Tanuki Toolbox）作为 DSH 的客户端增强插件，将上述功能集成在单一插件中，通过可独立开关的组件提供统一的交互体验。插件支持日间/夜间主题，随 DSH 语言自动切换中英文。
插件定位¶
这是一个社区维护的 DSH 客户端增强插件，提供快捷栏、起始页、对话框、模型设置、消息通知与插件管理等功能，并包含 Windows 启动保护。插件为模块化设计，各组件可按需加载与开关，不强制开启全部功能。
核心功能¶
模型屏蔽¶
启用「设置优化 → 模型」后，可以在「设置 → 模型」中管理服务与模型的开关。关闭后模型会从 DSH 模型目录和选择列表中隐藏，并在宿主请求准备及实际派发前拦截。已有对话选中该模型时，显示灰色占位项并禁止发送，切换其他模型后移除占位并恢复发送。限制保存在当前 profile，重新开启即可恢复。
组件列表¶
| 组件 | 功能 |
|---|---|
| 启动 | 优化启动处理，保护启动控制第三方插件检查、旧认证 Cookie 整理与快捷方式接管，开机启动可独立开启 |
| 快捷栏 | 编辑左侧入口的顺序与显示状态，工作区可收起、拖动调整宽度并保存，支持一键重启 |
| 起始页 | 查看日期、对话/任务概览、昨日已记录 Token、近期活动与受支持的账号额度 |
| 会话优化 | 时间统计、模型与推理等级卡片、受支持的速度控制，任务文件的右键操作 |
| 回收站 | 使用工作区式任务列表和原生对话/轨迹页面，保留 30 天，支持右键永久删除和确认后清空 |
| 规则 | 每个任务独立编辑规则，自动保存，每轮正式请求加入当前完整规则 |
| 连接 | 手机扫码连接，电脑之间同步会话索引、历史副本并实时查看和继续会话 |
| Agent接口 | 显示当前电脑的地址、密钥和连接说明，供本机 Agent 后台管理 DSH |
| 设置优化 | 紧凑的模型管理，支持服务与模型排序、开关、默认选择及独立编辑弹窗 |
| 消息中心 | 顶部灵动岛、系统通知、持久气泡与提示音，可按来源控制通知和对应气泡 |
| 插件中心 | 区分官方与第三方插件，提供搜索、版本号、自定义名称、更新入口及「插件市场」集成 |
消息中心¶
消息中心的「允许通知」使用插件、任务、系统更新三个按钮，点亮为绿色。灵动岛、系统通知、全局气泡与提示音分别开关。关闭灵动岛只隐藏应用内顶部消息，不影响其余通道。通知来源按钮同时控制对应提醒和气泡：关闭「插件」隐藏插件入口、插件详情及「更新全部」等相关气泡；关闭「任务」隐藏任务相关气泡。全局气泡总开关仍需开启，气泡状态颜色不变。
插件中心¶
插件中心提供昵称/原名搜索，官方插件以等高卡片区分正式版与实验性插件。更新查询状态只在插件中心显示文字。关闭组件会自动收起细分设置；重新展开查看时，下属选项变灰且不可修改，已保存的子项选择保留。
规则编辑¶
启用「规则」组件后，对话框中「工作区内修改」的右侧显示天平图标和规则数。点击向上展开，逐行编辑并自动保存；回车新增一行，点击外部或再次点击按钮收起。每个任务分别保存，空白规则不改变原生请求。规则右侧的绿点可逐条停用或启用，垃圾桶直接删除。分叉会话在创建时复制当前规则的内容、顺序和启停状态，之后父子会话独立修改。
规则只在正式任务请求派发时加入一次，不写入聊天记录或压缩来源。拖动编辑栏顶部可打开 Windows 原生独立窗口，拖动边缘改变大小。关闭独立窗不删除规则。关闭组件会停用注入并关闭编辑窗，已保存的规则保留供重新开启。
速度控制¶
开启「设置优化 → 模型」后，兼容 OpenAI Chat Completions 的服务可读取 {baseURL}/models 的 capabilities.service_tiers。只有明确包含 priority 或 fast 的直接模型显示速度选择。模型卡片的闪电按钮直接切换「标准／快速」。标准明确发送 service_tier=default，快速发送 priority。偏好按会话、提供商和模型保存。
Agent接口¶
在工具箱设置开启并展开「Agent接口」，把连接说明复制给这台电脑上的 Agent。每台电脑生成自己的连接信息；关闭组件立即禁止连接，重新开启、重启或更新工具箱保留地址与密钥。可查看状态、调整工具箱设置、切换组件、安装/更新插件及重新加载。
安装与启用¶
在 DSH 的「插件 → 添加插件」中填写仓库地址：
https://github.com/TanukiRei/dsh-tanuki-toolbox
安装后启用「黎猫工具箱」，再按需要开关各组件。仓库包含构建结果，不需要在安装时编译。直接填写仓库地址需要本机可用的 Git；如果电脑没有 Git，请使用 最新 Release 说明中的「免 Git 安装地址」。这个地址直接从 GitHub 下载指定提交，插件市场也能据此识别仓库更新。
本项目保留包名 dsh-local-plugin-center。从旧版本更新时请直接安装上述地址，无需卸载，以保留现有组件设置。离线安装包见 Releases。
兼容性¶
插件支持 DSH >=0.2.0-rc.2 <0.3.0。部分界面功能依赖 DSH 当前页面结构，宿主更新后可能需要适配。快捷方式接管、登录自启动和强制重启工具用于 Windows；macOS 会禁用这些专用操作，并保留运行中明确版本不兼容插件检查。Mac 界面按窗口/全屏状态避让标题栏，系统通知激活使用系统应用打开机制。
启动保护仅检查明确声明的版本不兼容，不保证拦截未声明的运行时故障。直接启动 DSH 原始程序不会经过快捷方式保护；Windows 缓存的固定入口可能需要重新固定。
适用场景¶
适合需要统一管理 DSH 界面交互增强、消息通知和插件管理的用户。插件为模块化设计，各组件可按需加载，适合对功能有选择性需求的用户。注意插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
结尾¶
黎猫工具箱通过模块化组件将 DSH 的界面增强、消息通知、插件管理和启动保护等功能集成在单一插件中，降低了集成成本。适合需要在 DSH 中统一管理这些功能的用户。
- 插件目录页：https://www.skillhub.cn/plugins/TanukiRei/dsh-tanuki-toolbox
- GitHub：https://github.com/TanukiRei/dsh-tanuki-toolbox
