前言¶

在 DeepSeek Harness（DSH）里写提示、调智能体时，计时往往靠系统闹钟或浏览器标签页，和输入区是分离的；专注段结束后也缺少一个可留在同一界面里的正反馈。番茄钟盲盒（Pomodoro Blind Box）是维护者 WU55UY 发布的 Web UI 插件，归类为趣味换装类扩展：在 composer 输入框下方 挂一条番茄钟 dock，每 自然走完 一个专注段才触发一次可收集盲盒，进度与图鉴落在本机 localStorage，不发网络请求。下面介绍它是什么、能做什么，以及如何安装与日常使用。

这是什么¶

插件 npm 包名为 dsh-pomodoro-box，仓库 WU55UY/dsh-pomodoro-box，许可证 MIT。实现方式为纯前端 Bundle：client.js 作为 Client module 下发，在 conversation.composer.dock 与 shell.overlay 两个 Slot 注册 UI。

一句话定位：在 DSH composer dock 上提供 15 / 25 / 45 / 60 分钟专注与可配置休息节奏，专注段结束后开箱获得 15 件藏品（4 个稀有度），并在设置面板里维护可翻看的图鉴。

核心功能¶

番茄钟与休息节奏¶

专注可选 15、25、45、60 分钟；短休息与长休息各有 3、5、10、15 分钟档位。支持开始、暂停、继续、跳过、重置。每完成 4 个专注段会自动进入一次长休息（长休息时长可在设置里配置）。

盲盒与图鉴¶

只有 完整走完 的专注段才发盲盒；点跳过 不会 发盒。开箱带摇晃、开盖、弹出动画，并适配 prefers-reduced-motion。

藏品共 15 件，稀有度与整体出现概率为：普通 60%、稀有 25%、史诗 12%、传说 3%；先抽稀有度，再在档位内等概率抽一件，无保底、不去重，重复是正常的。设置面板提供 5×3 图鉴网格，已收集项按稀有度着色，未发现为锁定；点格子可看名称、稀有度与描述。集齐 15 件后显示「已集齐」，开箱卡也会标注「图鉴已集齐」。

双语、主题与持久化¶

中英文运行时词典；颜色、圆角、阴影走 Harness Theme token，随明暗主题变化。除进行中的计时外，设置、统计、图鉴与未领取盲盒均写入浏览器 localStorage（键名 dsh.pomodoro-box.v1），刷新不丢收集进度。插件不发送网络请求，也不读取 Harness 会话内容。

安装与启用¶

需要 DeepSeek Harness 0.2.x，package.json 中声明 engines.dsh 为 >=0.2.1-rc.2 <0.3.0-0。

推荐从 npm 安装（将 desktop 换成你实际使用的 profile，Web 版多为 web）：

dsh plugin --profile desktop add dsh-pomodoro-box

安装会写入该 profile 的 dsh.profile.bundles，重启一次 Harness 后生效。也可使用官方 README 中的预打包 tarball 或 git 钉 tag 源，例如：

dsh plugin --profile desktop add https://github.com/WU55UY/dsh-pomodoro-box/releases/download/v1.2.4/dsh-pomodoro-box-1.2.4.tgz

dsh plugin --profile desktop add "git+https://github.com/WU55UY/dsh-pomodoro-box.git#v1.2.4"

若使用插件市场：在 插件 → 发现 → 添加索引源 填入：

https://cdn.jsdelivr.net/gh/WU55UY/dsh-pomodoro-box@main/market/index.json

再在发现页安装。当前包版本在资料中为 1.2.4。

启用后，输入框下方应出现番茄钟一栏（例如 🍅 番茄钟 25:00 专注）；若未出现可刷新页面，或在插件列表中确认 Pomodoro Blind Box 已启用。

典型用法¶

盲盒卡可用 Esc 关闭；设置面板点外部或 Esc 收起。折叠后点胶囊可恢复。README 中按当前权重模拟，集齐 15 件中位数约 90 个番茄钟，平均约 109 个，供规划收集预期时参考。

本地数据示例结构（资料节选）：

{
  "version": 2,
  "settings": { "focus": 25, "shortBreak": 5, "longBreak": 15 },
  "stats": { "total": 12, "boxes": 12, "owned": ["coffee", "star"] },
  "pending": null
}

需要清空收集与设置时，可在 DevTools 控制台执行：

localStorage.removeItem('dsh.pomodoro-box.v1')

然后刷新页面。

适用场景与注意¶

适合希望在 DSH 同一界面内做 Pomodoro、并用轻量收集玩法强化「完成一段再休息」习惯的开发者。插件以当前 Harness 进程与浏览器权限运行，安装前建议阅读仓库源码与 MIT 许可证，确认符合你对本地插件的信任要求。

DSH 生态强调「一切皆插件」；SkillHub 目录页 等社区站点为独立收录，与 DeepSeek / 幻方无官方从属关系，本文安装命令与行为均以 GitHub README 与 package.json 为准。

结尾¶

经过上面的步骤，你可以在 composer 下方固定一条与主题一致的番茄钟，用盲盒与图鉴把「做完一个专注段」留在本机、留在当前工作台里。进一步细节与动图演示见 GitHub 仓库 README，目录介绍见 SkillHub：dsh-pomodoro-box。