tongji
在 DSH 对话右侧查看当前会话统计
本地 Desktop UI 插件,读取 DSH 官方统计视图与会话投影,显示总计、每轮指标和步骤摘要。
简体中文 · English
Desktop 插件 · v0.1.3
tongji 将会话统计摘要放进 DSH 的右侧栏。它订阅当前 Session 的官方统计快照以及 sessionStats、tokenUsage 投影,不发起额外模型或工具调用。原生“统计”视图保持不变。
核心能力
| 会话总计 | 每轮摘要 | 步骤状态 |
|---|---|---|
| 上下文、缓存命中、输出、输出速度 | 同一组官方统计指标;轮次默认折叠,历史按官方分页完整加载 | 展开轮次查看步骤摘要;成功、失败、进行中分别用绿、红、黄标记 |
上下文与输出以 K / M 缩写展示,缺失值显示为 —。M 单位从 1,000,000 token 起使用。
工作方式
插件读取当前会话已有的统计快照和用量投影,使用独立右侧栏 Tab 渲染摘要。切换会话时,右侧卡片绑定到新的 Session;官方统计视图仍可从原位置打开。
安装
1. 前置条件
需要 DSH Desktop、本地插件目录和可编辑的 Desktop profile。此仓库未声明最低 DSH 版本;插件 API 可能随 DSH 版本变化。
2. 安装插件文件
将仓库克隆到本地插件目录:
git clone https://github.com/yueyexiayu/dsh-tongji.git ~/.dsh/plugins/tongji
若该目录已存在,不要覆盖其中已有文件;先备份或选择其他目录。
3. 注册到 Desktop profile
在 ~/.dsh/profiles/desktop/package.json 的 dependencies 中加入:
"tongji": "link:/Users/你的用户名/.dsh/plugins/tongji"
并在 dsh.profile.bundles 数组中加入 "tongji"。将示例路径中的用户名替换为本机实际路径,然后在 Desktop profile 目录运行:
cd ~/.dsh/profiles/desktop
pnpm install
完全退出并重新打开 DSH。进入一个会话后,右侧应出现标题为“统计”的 Tab。右侧栏关闭后可按 DSH 原有方式重新打开。
配置
插件 ID、包名与 bundle 名均为 tongji。右侧显示名称为“统计”。安装目录为 ~/.dsh/plugins/tongji;profile 依赖链接必须指向该目录。
此插件不提供额外设置项。轮次默认折叠;轮次区域有独立滚动条,打开卡片后会按官方 Session.loadOlder() 分页整理更早轮次,直到完整历史可见;卡片只在有当前会话时显示。
验证与限制
在 DSH 0.2.2-alpha.2-4dd5ab8 Desktop 环境中验证过插件加载、Session 切换、总计与官方统计视图的对照、轮次折叠/展开和状态颜色;插件 JS 通过 Node 语法检查。该验证记录不代表所有 DSH 版本均兼容。
- 插件使用 DSH 公开的客户端服务与统计快照;未来 API 变化可能需要适配。
- 无当前 Session 的首页不显示会话统计卡。
- 本仓库未附许可证文件;在仓库维护者明确选择前,不能假定它采用开源许可证。
- 公开仓库不包含 Desktop profile、用户会话、数据库或依赖目录。
社区与许可
问题与建议请使用 GitHub Issues。当前仓库没有声明许可证;在许可证明确之前,使用和再分发权限应视为未授予。
No comments yet. Be the first to write one.