dsh-live-stats 使用指南
在 DSH Web 会话状态行显示实时输入输出 token 估算与生成吞吐速率,响应流式输出时持续更新。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-ui-web
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add @captain1275/dsh-live-stats
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 毛玻璃输入框:高斯模糊(backdrop-filter 30px)+ 半透明玻璃底 + 细边框 + 内高光
- 自定义背景:URL / 本地图片 / 动图(GIF/WebP)/ 视频(mp4/webm) / 透明度 / 模糊调节,
- 仿Claude Code推理等级滑块:点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、
- 用户消息气泡毛玻璃:与输入框统一的玻璃质感
- 图片资源(社区同人资源,codex-pet-DeepSeek-girl)
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
安装后需要重启 DSH Web 吗?
需要。安装完成后必须重启 dsh web 会话状态行才会出现 TPS 组;浏览器端硬刷新不替代宿主侧重启,因为投影是注册在 host 进程里的。
它会不会改变实际发送给模型的 token 数?
不会。插件只消费持久化事件流并渲染估算读数,不注入提示段、不注册工具、不发出 session 事件,每个请求对模型端的 token 影响为零,也不影响 KV 缓存稳定性。
配置项里的 charsPerToken 应该填多少?
默认 4 个字符折算 1 个 token,对纯英文足够。中文密度更高,默认值会低估;可在设置面板或 ~/.dsh/config.yaml 里把它调到 1.5 左右再观察估算误差。
估算值前面那个波浪号 ~ 是什么意思?
表示是启发式估算(按字符数推算)。当 provider 真正返回 usage 时,估算会被精确值替换;重试会替换该步骤之前的估算,被中止的回合会移除其未结算估算。
卸载后需要清理数据吗?
插件本身不持久化任何数据,卸载后下次重启 dsh web 即不再注册 liveTokenUsage 投影,会话状态行自动回到未含 TPS 组的样式,无需手动清缓存或数据。
支持 TUI 或桌面端吗?
暂不支持。当前仅渲染在 DSH Web 的会话状态行(composer dock),TUI、桌面端和移动端没有等价显示位置。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 0.1.0-rc.6+
- Node: 未声明
- Platforms: macOS, Windows, Linux
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则