跳到主内容

dsh-live-stats 使用指南

在 DSH Web 聊天状态行实时显示输入/输出 token 估算和生成吞吐（TPS），等待 provider 真实用量到达后自动替换。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-live-stats

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
  • 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
  • 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
  • Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
  • 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件会增加每次请求的 token 消耗吗？

不会。插件只消费持久化事件流与投影数据，不注入提示段落、不注册工具、也不发送任何 session 事件，每个请求的 token 影响为零。

用 charsPerToken=4 估算中文是不是偏低？

是的。默认 4 字符/token 会低估中文（中文实际更密集），同时高估纯 ASCII 文本。可以通过设置面板或在 overlay 配置中调整 charsPerToken，建议中文密集场景调到 1.5-2 之间。

TPS 数字是怎么算出来的？为什么有时候不显示？

TPS 由某个活跃步骤的输出 token 除以墙钟耗时得出，且遵循"常驻"策略：只要某个步骤测得过速率，状态行就会持续显示，在新步骤尚未产出或遇到无速率步骤时回退到最近测得值，避免闪烁。只有刚开始从未测得时才会不显示。

估算值 ~ 什么时候会被替换成真实数据？

~ 表示启发式估算。当 provider 返回 usage chunk 或最终响应消息落地时，估算值会被真实用量替换；精确的缓存统计始终来自 DSH 自带的持久化 token 用量投影，不依赖本插件。

它是 Web 限定还是所有客户端都支持？

目前是 Web 限定。TPS 状态行渲染在 DSH Web 的会话统计行内，暂无 TUI/CLI 等价物。安装时 dsh.client.platform 字段也固定为 web。

怎么调整字符密度参数？配置文件在哪里？

推荐在 DSH Web 的插件设置面板里直接修改（一个 staging 表单绑到 live-stats 命名空间）。也可以在 ~/.dsh/config.yaml 的 overlay 里加 charsPerToken / blockOverhead / roleOverhead 三个字段，保存即热加载。

关闭插件后再开启需要重启吗？

不需要。设置面板的 enabled 开关或 overlay 配置变化时，宿主侧会销毁旧投影并按新参数重新注册投影折叠，下一次会话日志重放即生效，无需重启 dsh web。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.7+
  • Node: >=22.19.0
  • Platforms: Web

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则