dsh-full-stats 使用指南
覆盖 DSH 官方会话统计行:完整展示轮/步/耗时/缓存/token,加运行状态指示点,并允许自定义思考中/工作中/完成时三种状态文本。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-full-stats
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add @captain1275/dsh-full-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 GUI 任意项目会话,对话框下方会多出一行不省略的统计行(轮/步/LLM 与工具耗时/首 token/速度/缓存命中/输入输出 token),行首带琥珀色或绿色状态点;DSH Web 设置页的「Web UI 插件」分组里也会出现一张「完整统计行(状态文本)」可折叠配置卡(src/client/index.ts:208-216、src/client/FullStatsSettingsCard.tsx:57-103)。
配置保存到哪?卸载或换机器会丢吗?
三项文本字段(thinkingText/workingText/doneText)写到宿主进程侧的 ~/.dsh/full-stats.json(默认读取 $DSH_HOME 环境变量,回退 ~/.dsh),PUT 接口在写入前会校验字段类型并覆盖式写回,因此换机器需要手动迁移这个 JSON 文件;卸载插件不会删除该文件(src/index.ts:31-47、src/index.ts:76-90)。
「思考中状态文本」是覆盖官方哪段话?
覆盖官方 ChatView 内联 JSX 硬编码的「Deep diving...」占位文本。客户端用 MutationObserver 监听 [class*="turnStatus"] 节点,匹配到该字符串后原位替换为用户配置;保留时钟 span,仅替换文本节点(src/client/index.ts:74-91)。
三种状态文本要怎么触发显示?
会话运行中 + workingText 非空时显示「工作中」前缀;会话空闲且非空白 + doneText 非空时显示「完成时」前缀;任意一种配置为空串就退回原始统计行,不显示自定义前缀(src/client/index.ts:152-159)。
它会替代 DSH 官方的统计行吗?其他插件(如 dsh-live-stats)冲突怎么办?
是覆盖而非并存。浏览器半区以同 id=stats、更低 priority=-1 在 conversation.composer.dock 插槽里重新注册(src/client/index.ts:208-216)。先注册的官方组件与后注册的并存时按 priority 决定渲染顺序;与 dsh-live-stats 等其他同时改 stats 插槽的插件的取舍取决于各包的 priority 与注册顺序,源码中未做特殊互斥。
配置接口有大小限制吗?
有。PUT /api/full-stats/config 的请求体超过 100,000 字节会被服务端直接 reject(new Error('body too large')) 并 req.destroy();实际上三个文本字段加起来远低于该阈值,常规输入不会触发(src/index.ts:54-67)。
必须 DSH Web 才能用吗?
是。package.json#dsh.client.platform 字段为 web,浏览器半区依赖 @deepseek-ai/dsh-client-runtime 与 @deepseek-ai/dsh-client-ui-conversation 的客户端运行时;宿主路由 /api/full-stats/config 同样挂在 DSH Web 的 webServer 上,headless / CLI 模式不会加载(package.json:18-23、src/index.ts:95-99)。
卸载后统计行会自动恢复成官方样式吗?
会。本插件以 priority=-1 顶替官方 id=stats,移除插件后该覆盖项随插件卸载消失,DSH Web 自带的统计行即恢复显示——但因为本插件设置了 whiteSpace:normal 与运行状态点,官方原始样式仍然是被截断的 whiteSpace:nowrap 行(src/client/index.ts:163-196)。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 0.1.0-rc.6+(devDependencies 锁定 @deepseek-ai/dsh-client-runtime 与 @deepseek-ai/dsh-client-ui-conversation 为 ^0.1.0-rc.6)
- Node: 未声明(仓库根 package.json 与本包 package.json 均未声明 engines 字段)
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则