dsh-session-live
在 DSH 会话悬停卡片中实时预览活动：每个会话当前正在进行什么、花费了多少，以及最后处理的图像。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lilcandi/dsh-session-live#a4c90de676fbd8ab1d086740cb6fcab45ebba49aSession Live 以 dsh-session-live 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH 侧边栏的会话悬停卡片里，直接看到这个会话此刻在干什么。
DSH 自带的悬停卡片只显示：标题、相对时间、一个圆点、运行中/空闲。
本插件在「相对时间」与「状态行」之间插入一块实时活动面板，回答这些问题：
面板刻意保持小而快：一行概况取代了原先独立的模型行与工具条标题行，缩略图默认尺寸也收紧了。
外加一个独立设置页，可逐项开关、调密度、调最近工具条长度，改动即时生效并随 profile 持久化。
| 插件 | 回答的问题 |
|---|---|
@comecaramelos/dsh-hover-information | 这个会话花了多少（turns / tokens / cache / context window） |
dsh-ballast | 上下文窗口占用多满 |
dsh-git-badge | 这个会话需要你做什么动作 |
| dsh-session-live（本插件） | 这个会话此刻正在做什么、卡在哪，顺带一行总量（轮数 / token 合计 / 模型短名） |
总量只取一行，且刻意不做 cache 明细、上下文占用条与成本计算 —— 那是别人的地盘，同时装也不会出现两份一样的数字。token 值直接读宿主内置的 tokenUsage 投影（@deepseek-ai/dsh-token-meter），本插件不自己算、不自己折、不新增取数请求。
dsh plugin --profile web add file:J:/plugin/dsh-session-live
在 %DSH_HOME%\profiles\web\package.json 里做两件事，两件都要做：
dependencies 增加 "dsh-session-live": "file:J:/plugin/dsh-session-live"dsh.profile.bundles 数组追加 "dsh-session-live"漏掉第 2 步是这类插件"装了但没跑"的经典坑：cordis.patch.yml 只能 patch 一个已被插入的条目，从未 insert 的行 patch 了也不会启动。
安装完重启 DSH（dsh web），刷新页面。
设置 → 会话实时预览，共 12 项：
| 项 | 默认 | 说明 |
|---|---|---|
| 启用悬停实时预览 | 开 | 总开关，关掉后卡片不插入任何内容 |
| 显示当前活动行 | 开 | 正在跑的工具 + 参数摘要 + 已运行时长 |
| 显示最近工具序列 | 开 | 最近若干次工具调用的小图标条 |
| 显示内容预览 | 开 | 最近一条提问与回复摘要 |
| 显示耗时 | 开 | 本轮 / 当前步 / 当前工具的时间 |
| 显示异常 | 开 | 工具失败、轮次异常终止、被中断 |
| 显示压缩标记 | 开 | 上下文压缩时给一条提示 |
| 显示图片缩略图 | 开 | 会话最近一张用户上传图片的缩略图 |
| 显示模型名称 | 开 | 用量行里的模型短名（关掉后该行不含模型） |
| 显示用量概况 | 开 | 一行概况：对话轮数 · 累计 token · 模型短名 |
| 紧凑模式 | 关 | 更小字号与间距 |
| 最近工具条长度 | 5 | 0–12，0 表示隐藏 |
设置写入 profile 的插件条目（ctx.settings，与 dsh config 同源），因此跨浏览器、跨设备一致。宿主的 SettingsForms 不可用时自动降级到插件自己的路由，再不可用则退回 localStorage，设置页底部会显示当前用的是哪条通道。
设置页的位置：账号菜单 → 设置 → 侧栏最末的「会话预览」。这一节靠 settings.section 注册描述里的 label 出现在导航中，缺了 label 就是一条点不到的空白项 —— 官方各节（dsh-client-ui-settings-models 等）写的是 label: () => t('nav')，本插件与之对齐。改这个字段属于注册期元数据，必须重启 dsh web 才生效。
┌─────────────────── 宿主（Node） ───────────────────┐
│ index.js / src/index.js │
│ ├─ src/activity.js 折叠器：事件流 → 活动状态 │
│ ├─ 注册 liveActivity 投影单元（wire → 客户端） │
│ └─ 挂 /session-live/api/{health,overview,detail,settings,image}
└────────────────────────────────────────────────────┘
│ 投影值随会话列表快照下发
┌─────────────────── 浏览器 ─────────────────────────┐
│ client.js（手写 CJS，零构建） │
│ ├─ sidebar.session.row.hover → 实时活动面板 │
│ ├─ settings.section → 独立设置页 │
│ └─ 读 byId[sessionId].projectionValues.liveActivity│
└────────────────────────────────────────────────────┘
useProjectionsidebar.session.row.hover 插槽的 owner 只给 sessionId（官方注释解释了原因：Session 作用域的 seat 会强制激活列表里每一个会话）。而 useProjection(key) 绑定的是"当前会话"，拿不到任意会话的值。
所以数据必须由宿主提前算好、按 sessionId 随列表快照推送 —— 这也正好满足"悬停不引发 I/O"的纪律：打开卡片时读的是已在内存里的整值，零往返。
apply 同步、纯函数、返回纯 JSON。Object.is 抑制发布。wire.view 也做引用缓存，状态不变时返回同一个对象。Date.now()：耗时字段交给客户端用边界时间戳现算。user/message（扫 data.content 里的 {type:'image', attachment}，取最后一张）与 model/selection（data.provider/model/reasoningEffort），状态新增 image / model 两字段，stateVersion 1→2。旧 checkpoint 行 ver 不匹配时宿主从 seq 0 全量重放 —— 零误杀，冷会话在下一次事件推进后自愈。/session-live/api/image?ref=sha256:<64hex>&type=<mediaType> 直读 $DSH_HOME/attachments/v1/objects/<前2位>/<sha>：ref 整体匹配白名单正则（无任何用户可控路径成分，穿越不可能），type 过 MIME 白名单否则回落 image/png，内容寻址字节永不变化故带 immutable 缓存头。该路由不依赖宿主附件服务，插件自己读文件。src/shared.js 的 SETTINGS_SPEC 是唯一真源，宿主 Config 与客户端文案全部从它派生。src/client/viewer.js）。原因：宿主的悬停卡片在鼠标离开会话行时会卸载整棵插件组件树——遮罩若挂在树里，用户连大图都来不及看就会跟着消失。遮罩直接 appendChild 到 body，生命周期自己管：Esc / 点遮罩空白处关闭，关闭时摘掉 keydown 监听（不摘就是泄漏，自检里有一条专门盯它）。preventDefault + stopPropagation 两者都必须：会话行自身带点击处理，冒泡过去会顺带把会话打开。z-index:1300，高于宿主全部客户端包的最大值（实测聚合宿主最高 1250）。--dsw-alias-bg-mask-drop——这是本插件唯一主题感知的颜色。遮罩底下是整页，必须跟随明暗主题；而悬停面板必须钉死颜色，因为宿主卡片自己硬编码深色底。两处规则相反，别照抄。面板变小的方式是合并而不是堆叠：原先独立的模型行、以及「最近 ›」独立标题行都去掉了，改成尾部一行概况；缩略图默认从 96px 收到 72px（紧凑模式 56px）。行数从最多 7 行降到 4 行。
UsageLine）：轮数 · token 合计 · 模型短名，例：131 轮 · 6.9M · deepseek-v4.1-flash。悬停该行看细分（输入 / 输出 / 推理力度）。row.projectionValues.tokenUsage（宿主内置 @deepseek-ai/dsh-token-meter 的 tokenUsage 投影，key tokenUsage，stateVersion 2）。输入 = uncachedInputTokens + cacheReadTokens + cacheWriteTokens，输出 = outputTokens。零新路由、零新折叠、零新请求。
dsh-api-session-controller/lib/types/list.js:282 调 projectionsFor 时不传 keys，而 dsh-session-projection/lib/index.js:243-261 viewCheckpoint 在 keys 省略时全量返回所有带 wire 的注册投影 —— 宿主已把 tokenUsage 算好放在同一份快照里。tokenUsageOf 返回 null 时该行少一项，绝不因缺数据让整块消失（hasContent 里 token 只是加分项，不是必需项）。全零也当「还没用量」处理，不显示 0。liveActivity.turn（turn/start 计数）。已与宿主权威 sessionStats.turns 逐条比对（24/24 吻合）；唯一差异是宿主只计「有闭合 step 的轮」，本插件计 turn/start 次数，一轮差属正常。plainText / isInjectedText）：
<system-reminder> / <untrusted-memory> / <available_skills> / <project_instructions> / <skill_content> 等。Image "…"、Normalized copy、Source dimensions、[folded images:…]、[Compressed conversation section]。user/message 里先用 isInjectedText 判定，整条都是注入就跳过，保持「问」是他说的话。已覆盖四大类（均于 2026-10-19 在真实会话输出里实测命中）：
current runtime context. / this snapshot supersedes earlier runtime-context snapshots. / time sampled while preparing turn / current working directory:[compressed conversation section]（这类标记行会被元信息过滤先删掉，所以判定必须发生在剥壳之前）[model changed:[schedule reminder（大小写都算）cd J:\plugin\dsh-session-live
# 全量 29 套（推荐）
Get-ChildItem test -Filter *.mjs | Where-Object { $_.Name -notmatch 'probe-ctx' } | ForEach-Object { node $_.FullName }
# 或跑主要几套
node test/load-check.mjs # 客户端 bundle 27 项
node test/activity-check.mjs # 宿主折叠与路由 + 视图净化 47 项
node test/host-e2e.mjs # 宿主端到端
node test/probe-image-route.mjs # 图片路由实测（字节级比对 + 穿越拦截）
node test/probe-usage-snapshot.mjs # token 用量与轮数在真实链路上可读 15 项
node test/probe-zoom.mjs # 点击放大：假 DOM 行为断言 20 项
node test/accept-live-render.mjs # 真实宿主值 → 真 bundle → 渲染闭环（需 DSH 在跑）
绝大多数自检不需要启动 DSH：客户端用 node:vm + mock __ModuleLoader__/require('react')，宿主用 mock ctx。只有 accept-live-render.mjs 依赖活实例（不可达时 SKIP 而非 FAIL）。
index.js / src/*.js）：dsh-client-hmr 会在文件变更时重建，但投影注册这类宿主侧变更仍建议重启 dsh web 以确保干净。client.js）：HMR 会重算 artifact revision 并发布给浏览器，通常无需重启。test/probe-bundle.mjs）；② 响应体形状。不要用 PID / 启动时间推断 —— 本插件曾因此误判「未生效」，实际早已生效。DSH 加载的是 C:\Users\candi\.dsh\profiles\web\node_modules\dsh-session-live（实体目录，不是 junction），源码目录的改动不会自动过去：
Copy-Item J:\plugin\dsh-session-live\client.js `
C:\Users\candi\.dsh\profiles\web\node_modules\dsh-session-live\client.js -Force
# 其余文件同理；可先跑 test/accept-runtime-copy.mjs 验收副本
dsh-session-live/
├─ index.js 宿主入口（纯具名 re-export，禁止 default）
├─ client.js 浏览器 bundle（零构建 CJS）
├─ src/
│ ├─ index.js 投影注册 + 路由 + 设置通道
│ ├─ activity.js 事件 → 活动状态折叠器
│ ├─ shared.js 两侧共享的设置规格（SETTINGS_SPEC，唯一真源）
│ ├─ config-schema.js 宿主 Config（从 SETTINGS_SPEC 派生，逐字段 volatile）
│ └─ client/ 组件、样式、文案、store（参考实现）
├─ cordis.patch.yml bundle patch
├─ package.json
└─ test/ 29 套零依赖自检
src/client/*是同一份逻辑的可读版本，实际交付的浏览器代码是client.js（手写 CJS）。改逻辑时两处都要动，或只改client.js并跑test/load-check.mjs验证。
Config必须静态求值 + 具名导出：宿主cordis-plugin-loader的unwrapExports会执行exports = exports.default ?? exports，一旦加了default导出，Config立刻丢失 → 设置页读空 + 写入报错。src/config-schema.js用createRequire同步解析 schemastery，不能用顶层 await。
>=0.2.0-rc.1 <0.3.0-0（在 0.2.1-rc.2 上开发与验证）。slots / locale / webServer / settings / sessionProjections / sessions。
任何一项缺失时对应能力静默降级，不会让插件卡在 pending。require 宿主 seed 白名单里的 react，不 value-import 任何 @deepseek-ai/* 包。assistant/assistant-stream 帧）暂未接入，面板显示的是最后一次落盘的状态。接它是下一步（见路线图 P1 后半）。MIT
background job <id> (<cmd>)stateVersion 保持 2：v4 只改取值语义，行结构（字段集合与类型）没变，旧 v2 行经 stateSchema.parse 依然合法，因此不升版本号。升版本会让所有老会话的磁盘行在直读路径被丢弃（viewCheckpoint 先比 ver），造成画面永久空白。旧行里的注入文本会在下一次 user/message 到达时被新值覆盖，自愈。cleanPreview）：stateVersion 保持 2 意味着宿主不会重放旧行，v2 时期写进 checkpoint 的注入文本会永远留在里面。所以 buildView 在只读路径上对 prompt / reply 再洗一遍（isInjectedText 为真直接置空，否则 plainText + 截断），状态本身不动 —— 历史脏值立刻干净，Object.is 发布抑制也不受影响。清洗是幂等的，新折叠器产出的干净值原样透出。formatTokens（0 / 999 / 1K / 15K / 1.2M）与 shortModel（provider/a/b/model 取末段、去掉 -YYYYMMDD 与 -YYYY-MM-DD 后缀、超 20 字符截断）—— 都不碰 DOM，test/load-check.mjs 与 test/probe-usage-snapshot.mjs 直接断言。