前言¶
在 DeepSeek Harness（DSH）里同时开多个会话时，侧边栏列表很快变长：哪条在跑、哪条在等你点「继续」、哪条跑完还没点开，要靠记忆或逐个切换才能对齐。任务看板能跟踪它自己发起的执行，但手动开的会话、以及看板之外的其它会话不会自动进看板视图。
下面介绍的 dsh-session-dashboard（包名 @local/runtime-overview）是维护者 sandwich-xz 发布的客户端 Web GUI 插件：把当前与最近需要的会话排成四宫格，每格约占面板四分之一，点卡片进入会话；标题栏「总览」、Alt+R 或侧边栏「运行总览」可随时回到这一页。插件只读运行时数据，不写会话。
这是什么¶
dsh-session-dashboard 是 DSH 的 Web 界面插件，核心价值是「运行会话的一屏总览 + 一键进出」。它直接读取客户端会话目录里的会话列表，不依赖任务看板才能看到手动开的会话；与任务看板配合时，属于看板执行的会话会标注「看板任务」并显示对应卡片标题。
生态上，DSH 奉行「一切皆插件」；插件目录站 skillhub.cn 是社区收录页面，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
四宫格与排序¶
- 四宫格视图，每屏 4 个会话，超出自动分页。
- 排序优先级：需要你处理 → 运行中 → 已完成未查看 → 其余会话。
- 运行中的会话有状态点动画；已完成未查看、等待处理的会话会留在页面上，直到你进入看过。
- 子智能体会话不显示，避免网格被派生会话占满。
卡片信息¶
每张卡片可展示（视数据是否可用）：
- 最近一条用户输入、目标与待办进度；
- 上下文占用、费用估算、累计 Token、运行时长或最近活动。
费用不是从事件流重新累计：使用上下文洞察插件已折叠的计费 Token 桶，按 client.js 内 MODEL_PRICES（models.dev DeepSeek 挂牌价）折算；高峰 2 倍、非高峰挂牌价，人民币按 1 元 = 0.15 美元。口径与上下文洞察「总预估费用」一致（含子智能体）。未收录模型显示「—」。
导航¶
- 点击卡片进入该会话；进入后标题栏出现「总览」按钮。
- 侧边栏有「运行总览」入口；
Alt+R可随时返回总览页。
数据来源（只读）¶
插件不写会话数据，主要来源如下：
| 数据 | 来源 |
|---|---|
| 会话列表、运行状态、标题、工作目录 | 客户端会话目录 sessions.list |
| 需要你处理、已完成未查看 | ui-session 的 useSessionStatus |
| 目标、待办、上下文占用、Token、最近输入、计费 Token 桶 | 会话投影 goal、todos、contextPressure、tokenUsage、contextTimeline |
| 看板任务标题 | 任务看板只读接口 /api/task-board/state |
除可选的同源请求 /api/task-board/state 外，无遥测、不上传数据。
安装与启用¶
插件通过本地目录挂进 profile。README 给出的步骤是先克隆仓库，再 link 到当前 profile（请按你环境替换 <你的 profile>）：
git clone https://github.com/sandwich-xz/dsh-session-dashboard.git
dsh plugin --profile <你的 profile> add link:$(pwd)/dsh-session-dashboard
Windows PowerShell 下将 $(pwd) 换成该目录的绝对路径。安装后若未看到「运行总览」，刷新 DSH 页面或重启 dsh web。
卸载：
dsh plugin --profile <你的 profile> remove @local/runtime-overview
兼容性（来自 README）：
- 需要 DeepSeek Harness 0.2.0-rc.2 或更新版本。
- 费用与最近输入依赖已安装的 dsh-context；未安装时对应位置为「—」，其余功能仍可用。
- 着色使用主题变量，跟随 DSH 明暗主题与皮肤。
安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证；插件以当前 dsh 进程权限运行，与所有本地插件一样需信任维护者代码。
典型用法¶
- 按上文完成
link安装并刷新 Web 界面。 - 打开侧边栏「运行总览」，或在使用会话时按
Alt+R回到四宫格。 - 根据排序优先处理「需要你处理」和「运行中」的卡片；点卡片进入会话，处理完毕后再
Alt+R扫一眼未读完成项。 - 若同时使用任务看板，带「看板任务」标签的卡片可与看板卡片标题对照，避免和手动会话混淆。
适用场景与注意¶
适合：经常在 DSH Web 里并行多个会话、需要一屏看清状态并快速跳转的开发者。
限制（README 原文）：
- 运行时长从插件首次观察到该会话「运行中」起算，刷新后通过 localStorage 续算；插件安装前已在跑的会话只能从安装时刻起算。
- 费用为估算，仅对
MODEL_PRICES收录模型有效，不含未上报用量的请求。 - 子智能体不会出现在网格中。
结尾¶
dsh-session-dashboard 用四宫格补齐「任务看板看不到的手动会话」这一缺口，并把状态、待办与（在装有 dsh-context 时）费用类指标压进四分之一卡片，减少在侧边栏里盲搜会话的次数。
