跳到主内容

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

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则