前言¶

在 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。