前言¶
在 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
