dsh-usage-tab 0.1.0 — 首个公开发布版

dsh-usage-tab 0.1.0

DSH（DeepSeek Harness）Web 插件：给会话页签加一个 「时间统计」 tab，把会话的时间面貌画出来。
纯本地计算、零网络请求、零运行依赖。

English: A DSH (DeepSeek Harness) web plugin that adds a "Time Stats" tab to the session view.
Entirely local computation, no network requests, zero runtime dependencies.

这一版有什么 / What's in this release

• 概览：挂钟跨度 · 活跃 / 空闲拆分 · 每轮甘特 · 每小时分布 · 最慢的几轮 · 步骤时间线 · 时段分布（24×7）· KPI
• 日历：今日 / 本周 / 本月累计 · 近 12 周热力图 · 近 14 天柱状 · 环比（等长对位）· 连续使用段
• 会话：A 按工作区分组 / B 逐日活动带 / C 主从双栏 · 子代理构成 · 工作区趋势 · 导出 Markdown 报告
• K 线：每天一根蜡烛（开 = 前一天、收 = 当天），纵轴固定 0~24h
• 设置：空闲阈值 · 时区 · 数据范围 · 每周目标
• 宿主半：usageDaily 会话投影单元 —— 逐日活跃 / 日内小时桶 / 按工具名统计 / 按模型 / 回合结束原因 / 压缩次数

English: Overview (wall-clock span, active/idle split, per-turn Gantt, hourly distribution, slowest turns, step timeline, 24×7 distribution, KPIs) · Calendar (today/week/month totals, 12-week heatmap, 14-day bars, period-over-period comparison with equal-length alignment, continuous-use segments) · Sessions (grouped table / daily strip / master-detail, subagent breakdown, workspace trend, Markdown export) · K-line (one candle per day, open = previous day, close = current day; fixed 0–24h axis) · Settings (idle threshold, time zone, data range, weekly goal) · Host half: the usageDaily session projection (per-day activity, intraday hour buckets, per-tool calls+time, per-model turns, turn outcomes, compaction count).

安装 / Install

# 客户端半边 + 宿主半边都要重启 DSH 桌面版才生效
node tools/install.mjs            # 默认干跑，先看它会做什么
node tools/install.mjs --apply    # 真装（自动枚举已装过本插件的 profile）

English: Both the client and host halves require a DSH desktop restart to take effect. node tools/install.mjs dry-runs by default; add --apply to install (it auto-enumerates the profiles that already have this plugin).

验证 / Verification

node test/self-test.mjs                 # 101 passed / 0 failed
node tools/struct-check-subnav.mjs      # OK=91 / BAD=0
node tools/counterfactual-subnav.mjs    # OK=121 / BAD=0（在 %TEMP% 副本上拆修复点，验证断言真的生效）

English: 101 self-tests, 91 structural checks, and 121 counterfactual variants (each variant removes one fix and asserts that the relevant check goes red).

权限与依赖 / Permissions & Dependencies

运行时零依赖、不发起网络请求、不执行外部命令、不读取凭据。
宿主半读插件偏好与会话投影缓存；冷会话回填只读会话日志补投影，从不改写会话文件。
⚠️ 仓库里的开发工具（tools/）会用 spawnSync 起子进程、会在系统临时目录建副本并把日志写到 out/（已被 .gitignore 覆盖）—— 那只在开发时用。
⚠️ 以上是源码面的保守自述："未发现"不等于"绝对不访问"，请以实际源码为准。

English: Zero runtime dependencies, no network requests, no external commands, no credential reads. The host half reads plugin preferences and the session projection cache; cold-session backfill only reads session logs and never rewrites them. ⚠️ The development tools under tools/ do use spawnSync, build copies in the system temp directory, and write logs to out/ (gitignored) — development only. ⚠️ The above is a conservative statement about the source surface: "not found" does not mean "never accesses" — refer to the actual source.

非官方 / Not official

本插件非官方插件，与 DeepSeek 官方无隶属关系。

English: This is not an official plugin and is not affiliated with DeepSeek.

MIT © CNyaotian-Lunar