totoTheCat：DeepSeek Harness Web 界面桌宠插件

DeepSeek Harness 的插件生态允许在 Web 界面中扩展功能。ZutoMayoo 的 totoTheCat 属于“趣味换装”类别，它向 Web 界面引入了一只名为 Toto 的桌宠，作为静态展示或陪伴工具。

插件概览¶

• 名称：toto-the-cat
• 维护者：ZutoMayoo
• 类别：趣味换装
• 许可证：MIT
• Star 数：0

核心功能¶

该插件主要提供以下能力：

• 序列帧动画：支持 idle-0.png 等多帧图片循环播放，或使用单帧静态立绘。
• 可拖拽：托托可被拖拽到屏幕任意位置，位置自动记忆。
• 番茄闹钟：点击托托出现入口，开启专注计时，完成后自动进入休息。
• 成长系统：专注时长产生经验值，经验值用于解锁“有关托托的30个事实”。
• 设置页：提供大小、动画速度、像素渲染等参数调整。
• 无障碍友好：尊重系统的“减少动态效果”偏好。

安装与启用¶

通过命令行安装插件：

dsh plugin --profile web add toto-the-cat

安装后必须重启 DeepSeek Harness Web 服务才能使插件生效：

dsh web

使用流程¶

1. 交互入口：点击托托，会显示两个文字入口（“番茄闹钟”与“有关托托的30个事实”）。
2. 面板操作：点击入口标题，可以开启或关闭对应的功能面板。
3. 外观自定义：将自定义图片放入插件的 assets/ 目录（例如 idle-0.png），重启 dsh web 后即可替换托托外观。
4. 控制：托托右上角有手动关闭按钮（×），点击后可隐藏托托，右下角会出现常驻唤醒药丸。

配置与自定义¶

外观资源¶

托托的外观完全由 assets/ 目录中的图片决定。支持格式为 PNG（带透明通道）。建议画幅比例为 4:5。

• 静态立绘：放置 idle.png
• 动画帧：放置 idle-0.png、idle-1.png 等连续帧，默认约 4 fps 循环。

设置项¶

进入设置页 → 托托桌宠，可调整以下参数：

• 显示托托：开关整体显示。
• 大小：0.6–1.8 倍缩放（默认约 180×225 px）。
• 动画：开关序列帧动画。
• 动画速度：帧间隔时间，范围 120–400ms。
• 像素渲染：开启后使用最近邻缩放，保持像素画锐利。

数据存储¶

经验进度和配置保存在主机目录中：

• 经验进度文件：$DSH_HOME/toto-the-cat-state.json
• 配置缓存：浏览器 localStorage (键名 toto-the-cat:config)

注意事项¶

• 环境依赖：仅支持 DeepSeek Harness 的 Web profile（dsh web）。依赖 Chromium 内核浏览器（Chrome / Edge）。
• 生效条件：安装或修改配置后，必须重启 dsh web 才能生效。
• 无运行时依赖：插件本身不依赖额外的 npm 包。
• 资源要求：若 assets/ 目录为空或文件名不符合规范，托托将不显示。

目录与链接¶

• GitHub 仓库：https://github.com/ZutoMayoo/totoTheCat
• 插件目录：https://www.skillhub.cn/plugins/ZutoMayoo/totoTheCat