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

快速上手

dsh-ui-web

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @captain1275/dsh-usage-dashboard

复制以上命令在 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 吗？

需要。宿主半体注册的 /api/usage/* 路由依赖 host 进程，加载完成后必须重启 dsh web 路由才会被注册；浏览器硬刷新不会触发 host 侧重载。

数据存在哪里？怎么清理？

数据落在 ~/.dsh/usage.json（DSH_HOME 环境变量可改写路径）。删除该文件即可完全清空历史；插件下次启动仍会重新按日累计，不会自动迁移旧文件。

估算费用是按什么单价算的？准确吗？

按模型名匹配 DeepSeek 官方公开档位（v4-flash、v4-pro、reasoner、legacy），未识别模型回退到通用档。属于看板展示估算，并非计费依据，缓存命中单独走缓存档单价不重复计费。

计费会不会把一次会话的 token 重复算多次？

不会。客户端按会话累计快照替换语义上报，宿主为同会话保留最新一次快照；后续快照与上次做差值累加，刷新页面/切换会话不会重新把整段历史当新增算入。

看板里"今日"对应哪个时区？

用本地时区。每条记录按 Date#getFullYear/Month/Date 拼出 YYYY-MM-DD 键，凌晨切换日期时新一天的柱状图与汇总才会出现该日数据。

卸载后需要做什么吗？

卸载插件并重启 dsh web 即可；侧边栏三个入口（用量 / 手机端查看 / 检查更新）会随 dispose 一起移除，路由也会一并注销，历史 JSON 文件不会被自动删除。

侧边栏的"手机端查看"是怎么工作的？

点击后调 /api/usage/lan 让宿主枚举本机 IPv4，192.168 网段优先排序，挑出首个地址结合当前端口渲染二维码与可复制链接，方便手机扫码在同一 Wi-Fi 下访问。

支持 TUI、桌面端或移动端吗？

暂不支持。看板与侧边栏入口都依赖 DSH Web 的 sidebar / composer dock，TUI、桌面端、移动端没有等价挂载位置，宿主侧 /api/usage/* 路由在非 Web 形态下也无 UI 渲染。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: 未声明
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则