dsh-plugin-session-insights
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 <YYYY-MM> 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。
已知边界
