前言¶
在 DeepSeek Harness (DSH) Web 端使用會話時，上下文佔用、本會話累計 Token、上下文構成這類信息需要在頭部附近查看。dsh-token-pet 是一個 DSH 插件，把這些信息放進會話頭部右上角，同時附帶日期周幾、即時天氣、未來 3 天預報和極端天氣預警。下面介紹它的定位、安裝方式和日常用法。
這是什麼¶
dsh-token-pet 由 pk7j7sqryy-ops 維護，許可證爲 MIT。它的一句話定位是：在 DeepSeek Harness (DSH) 會話頭部右上角展示卡通 Token 用量玩偶“布布”，並附日期周幾、即時天氣、未來 3 天預報和極端天氣預警。
核心功能¶
1、嵌入會話頭部右上角工具區，不懸浮。
2、展示今天日期/周幾，使用瀏覽器本地時區即時計算。
3、展示即時天氣，使用 IP 定位 + Open-Meteo，緩存 30 分鐘，失敗時優雅降級。
4、展示未來 3 天逐日天氣，包含圖標和最高/最低溫。
5、展示卡通用量小部件：上下文佔用、本會話累計輸入/輸出/緩存讀/緩存寫、上下文構成。
6、表情玩偶“布布”隨 Token 用量變化表情。
7、提供極端天氣預警，包括暴雨/雷暴/大雪等，並覆蓋未來 3 天嚴重天氣提前預警。
8、跟隨 --dsw-alias-* CSS 變量主題色，深淺色自適應。
9、Token 數據複用宿主已投射到前端的投影，前端零請求。
安裝與啓用¶
推薦作爲包安裝。下面的命令把插件加入 web profile：
dsh plugin --profile web add github:pk7j7sqryy-ops/dsh-token-pet
安裝完成後，重啓 Web 端：
dsh --profile web
經過上面的步驟，會話頭部右上角就會出現“布布”。
如果只做臨時驗證，還可以使用動態插件方式。需要把 dynamic/client.js 粘進 cordis_define 的 code.client，把 dynamic/host.js 粘進 code.host，再執行 cordis_run。這個方式是進程內臨時生效，重啓後失效。
典型用法¶
1、查看摺疊態：右上角小藥丸爲“布布”玩偶加佔用百分比。
2、打開卡片：點擊藥丸打開卡片；點擊外部、按 Esc 或點擊 ✕ 收起。
3、手動刷新天氣：點擊卡片裏的天氣那一格；天氣緩存爲 30 分鐘。
適用場景與注意¶
適合在 DSH Web profile 中查看當前會話 Token 用量，同時希望附帶日期和天氣信息的人。使用前注意：
- 天氣數據依賴
ipwho.is與Open-Meteo，緩存 30 分鐘，失敗時優雅降級。 - 本機 web 服務無 fetch provider 且
curl不可用或被沙箱攔截時，天氣可能顯示不可用；token 部分不受影響。 - 定位使用 IP，掛 VPN/代理可能導致定位漂移；可通過修改
lib/index.js的locate()固定經緯度。 - 未直連官方預警 API；官方預警需要 API key，當前基於 WMO 代碼判斷當前和未來 3 天嚴重天氣。
- 動態插件方式重啓後失效。
package.json聲明 Node.js>= 18，並聲明 peerDependencies@deepseek-ai/cordis ^4.0.0與react ^18.2.0。- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
來源¶
DSH 的理念是“一切皆插件”。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不等同於官方應用商店。
- GitHub：https://github.com/pk7j7sqryy-ops/dsh-token-pet
- 目錄頁（來自插件線索，未在本次資料中核驗）：https://www.skillhub.cn/plugins/pk7j7sqryy-ops/dsh-token-pet
