dsh-plugin-session-insights
> 🧩 dsh 插件家族（22 件）：总目录 dsh-plugin-family ｜ 明星插件：ide-hub 跨 IDE 统一管理 · task-forge 跨窗口无损交接 · quota 实时用量仪表
EN · Cross-session activity stats: every model call — priced or not — is appended to a monthly JSONL sidecar; /insights prints daily trend bars, priciest sessions and model mix, and /insights-export writes a BOM+CRLF CSV. The model/provider pair is read from the assistant message's own source, verified against 132 assistant/message events in 20 real persisted sessions. · 12 node --test green · host-side only, no web UI · not live-mounted.
DeepSeek Harness (dsh) 插件：跨会话活动统计。host 侧把每个会话的每次模型调用累计进按月 JSONL 边车文件，提供 /insights 汇总（每日趋势 / 最贵会话 / 模型分布）与 /insights-export CSV 导出（支持按月过滤）。
与 dsh-plugin-cost-ledger 的分工：cost-ledger 管钱（未计价事件直接丢弃），本插件管活动（token/轮次/模型分布，未计价模型照常统计，花费只是顺带字段）。
功能
/insights：会话总数与 token 总量、近 N 天每日趋势（ASCII 条形）、最贵会话 Top 榜、模型分布。/insights-export：明细 CSV（BOM + CRLF，Excel 直开）。- 容错：崩溃半行跳过并计数，文件不改写，
/insights里提示损坏行数。
安装
三步，实测于 @deepseek-ai/dsh@0.1.7-alpha.1（需 pnpm 在 PATH 上）：
# ① 装进 profile：dsh plugin 把参数原样转发给 pnpm，git 包会自动跑 prepare 构建 lib/
dsh plugin --profile web add github:121212165/dsh-plugin-session-insights
② 把本仓库根目录 cordis.patch.yml 的内容并进 $DSH_HOME/profiles/web/cordis.patch.yml。
该文件默认是 []，所以要么整份替换，要么把 insert 条目并进同一个数组；不要直接追加——
追加会形成两个 YAML 文档，启动即报
failed to parse overlay ... end of the stream or a document separator is expected（本机实测踩过）。
③ 重启 dsh。配置层与 client 半都要重启才生效（客户端按 boot 时算出的内容 rev 下发，硬刷新浏览器没用）。
自检挂载：dsh --profile web --dump-config | grep dsh-plugin-session-insights，应看到该条目。
数据模型
边车文件 ~/.dsh/session-insights/insights-YYYY-MM.jsonl，每行：
{"v":1,"sessionId":"…","at":"2026-09-15T02:00:00.000Z","day":"2026-09-15",
"modelId":"deepseek-v4-pro","provider":"deepseek","turn":3,
"buckets":{"uncachedInput":100,"cacheRead":900,"output":50,"cacheWrite":0},
"costMicros":1200000,"currency":"CNY"}
计价仅当模型命中价表（内置 DeepSeek 价目 + prices 覆盖）；未计价时 costMicros/currency 缺省，token 统计不受影响。
配置
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
|
dataDir |
~/.dsh/session-insights |
边车目录 |
exportDir |
dataDir |
CSV 导出目录 |
topSessions |
10 |
最贵会话榜行数 |
recentDays |
14 |
每日趋势窗口 |
prices |
[] |
形状与 price-aware.prices 一致 |
验证状态
- 已验证：
session/event（assistant/message usage）、session/disposed、ctx.commands.register——与 price-aware 相同的事件面； - 查证后放弃：官方
sidebar.panellist/session-query跨会话查询 API 在官方仓库文档中未找到插件侧可用的注册路径（session-query-sqlite是 composition 内部包），故跨会话数据走自己的 JSONL 边车而不是读 harness 会话库。本插件看不到它安装之前的历史会话，从安装那一刻开始累计。 - 未验证：未在运行中的 dsh 里 live mount。
已知边界
- 无历史回填；边车只含安装后的数据。
