Token 泡泡 (Token Pet) 🐻

DeepSeek Harness (DSH) 插件 · dsh-plugin

一个给 DeepSeek Harness (DSH) 用的插件，在会话头部右上角嵌一个卡通「布布」玩偶，实时展示当前会话的 Token 用量，并附带 今天日期/周几 + 实时天气 + 未来 3 天预报 + 极端天气预警，全程跟随主题色自适应深浅色。

功能特性

• 嵌入右上角，不悬浮：挂在 conversation.session.header.utilities（会话头部右上角工具区），和「下载日志」等原生按钮并排。
• 今天日期 / 周几：📅 8月15日 · 周五，浏览器本地时区实时计算，零网络。
• 实时天气：☀️ 晴 26°C（点击可刷新），IP 定位（ipwho.is）+ Open-Meteo，缓存 30 分钟，失败优雅降级。
• 未来 3 天预报：今天 / 明天 / 后天逐日天气（图标 + 最高/最低温）。
• 卡通用量小部件（展开态）：
  • 🎯 上下文占用：主题色进度条 + 已用 / 窗口上限。
  • 📊 本会话累计：输入 / 输出 / 缓存读 / 缓存写（含合计）。
  • 🧩 上下文构成：系统提示 / 工具定义 / 消息内容。
• 表情玩偶「布布」：内联 SVG 圆脸小布偶，表情随用量变化（闭眼微笑 → 大笑 → 微笑 → 皱眉 → 快满冒汗）。
• 极端天气预警：暴雨 / 雷暴 / 大雪触发红色警告条 + 动画雨滴（🌧）或雪花（🌨）粒子；未来 3 天有严重天气也提前预警，折叠药丸上亮闪烁图标。
• 跟随主题色：全部颜色走 --dsw-alias-* CSS 变量，深浅色自适应。
• Token 零请求：token 数据直接复用宿主已投射到前端的投影。

安装

💡 直接复制这个仓库的 GitHub 地址（github:pk7j7sqryy-ops/dsh-token-pet）发给 AI 助手，让它帮你安装，也可以按照以下方法：

方式 A（推荐）：作为包安装

dsh plugin --profile web add github:pk7j7sqryy-ops/dsh-token-pet

安装后重启 dsh --profile web，会话头部右上角就会出现布布。也可以 dsh plugin --profile web add dsh-token-pet（若已发布到 npm）。

方式 B：动态插件（进程内临时）

把 dynamic/client.js 粘进 cordis_define 的 code.client、dynamic/host.js 粘进 code.host，再 cordis_run 即可（重启失效）。详见 dynamic/ 下两份文件头部的注释。

日常使用

• 折叠态：右上角小药丸 = 布布玩偶 + 占用百分比；有极端天气/未来预警时多一个闪烁图标。
• 展开：点药丸打开卡片；点外部 / 按 Esc / 点 ✕ 收起。
• 天气刷新：点卡片里的天气那一格手动刷新（缓存 30 分钟）。

常见问题

• 天气显示「不可用」？ 本机 服务无 fetch provider 且 不可用/被沙箱拦截；token 部分不受影响。