dsh-client-ui-job-stats
DeepSeek Harness 的会话后台作业统计：右侧边栏标签页，汇总会话运行的所有作业（按状态统计总数、成功率、耗时、保留的输出以及每项任务的详细信息），支持简体中文和英语。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kahomesl/dsh-client-ui-job-stats#c9827d49601327d28287eb2315797fce5abb25ae
Client Ui Job Stats 以 dsh-client-ui-job-stats 发布，当前版本为 1.4.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 的会话后台任务统计：右侧边栏的一个标签页，累计记录本会话跑过的每一个任务。
中文 | English
这两张图由 pnpm preview 用插件自己的组件渲染而成 —— 与宿主实际提供的 client/client.js 是同一个文件，按渲染器组装的 props 挂载、配色取应用真实深色主题的 token 值，只有任务行是示例数据（真实会话的截图会暴露那个会话跑过什么）。它们声明在 screenshots.json 里，插件市场读的就是它。
Harness 自带的会话头部「后台任务」列表是一张实时名册：只列会话当前还看得到的任务，而前台命令一旦被调用方取走输出，它的记录就会从名册里消失。所以它适合看"现在在跑什么"，不适合当统计 —— 任务会闪一下就没了。
本插件在右侧边栏里补了一个统计席位：
Ctrl+Alt+B），栏内「开始」页会多出第 4 张卡片 「后台任务统计」，与随附的「工作区文件 / 新建终端 / 浏览器」并列；点开即在栏内以标签页形式显示面板。| 计数 | 合计 / 运行中 / 已完成 / 已失败 / 已取消 / 已结束 |
| 指标 | 完成率（只统计已上报结果的任务）、累计耗时、最长耗时、保留输出字节数 |
| 明细 | 每任务一行：状态点、概述、类型 · 状态 · 原因、耗时；列表自身可滚动（表头固定） |
| 说人话 | 能识别的命令显示"在干什么"—— 等待 75 秒 / 提交代码 / 跑测试 / 安装依赖 —— 而不是把代码原样贴出来 |
| 点击展开 | 点一下任务行展开：完整命令、任务 ID、类型、状态、开始/结束时刻、结束原因、保留输出 |
| 实时 | 有任务在跑时，耗时每秒刷新 |
| 台账 | 按会话分开、按 job id 合并、写入浏览器存储（上限 300 条，超出先淘汰最早已结束的） |
| 健壮 | 未知状态、缺 id、字段异常、台账损坏都不会抛错，也不会让面板变空 |
插件就是一个普通的 Harness 组合包（bundle），从源码目录以 link 方式装进某个 profile：
git clone https://github.com/kahomesl/dsh-client-ui-job-stats.git
在该 profile 目录（package.json 里列着 dsh.profile.bundles 的那个，例如 ~/.dsh/profiles/desktop）中，把它加为本地依赖并选为组合包：
{
"dependencies": {
"dsh-client-ui-job-stats": "link:/本机绝对路径/dsh-client-ui-job-stats"
},
"dsh": {
"profile": {
"bundles": [
// …原有的组合包…
"dsh-client-ui-job-stats"
]
}
}
}
安装：
pnpm install
展开右侧边栏，「开始」页上就有 「后台任务统计」 卡片。宿主会自行重新读取变更过的客户端 bundle，面板本身不需要重启。
重启一次 DSH。 宿主侧半成品（终态记录器）是一条 Loader 行，而 bundle patch 里的行是在启动时组合的；重启之前面板照常工作，但只能讲名册自己知道的故事（见"已知限制"）。每次安装需要重启一次，之后的更新不需要。
包内的 cordis.patch.yml 只做两件事：向组合插入两条 Loader 行 —— job-stats → 本包（由它发布浏览器半侧）与 job-stats-recorder → 本包的 ./recorder 子路径（宿主半侧）；不改动 profile 里的其它任何东西。
停用 / 卸载 —— 从 dsh.profile.bundles 里删掉包名即可停用（保留依赖随时可再打开）；两处都删掉再 pnpm install 即卸载。
依赖 组合里需要有 @deepseek-ai/dsh-client-ui-sidebar-right 与 @deepseek-ai/dsh-api-job-controller。没有它们时插件保持"未激活"，不会激活失败。
面板读 ctx.jobs（@deepseek-ai/dsh-api-job-controller 暴露给浏览器的任务名册镜像），并在其之上加了一层台账：
ctx.jobs.watchRows(sessionId)）；流的首帧就是完整事实。dsh-job-stats/v2/<sessionId> 下（写入有节流；存储写满或损坏时自动退回"仅内存"）。只有终态记录会被读回，刷新页面不会复活一条假的"运行中"。settled 事件（前台命令终态的唯一见证者），把它们持久化在 profile 内的 .job-stats/ledger.json。面板每 2 秒轮询该路由（按 document.baseURI 相对解析）并合并：名册抛弃的行会变成真实的 已完成/已失败/已取消（带结束原因），标签页没见过运行过程的任务也会带着结局补进来。因为台账在宿主侧，重启后再打开面板仍能看到上一次运行结算的任务 —— 这条链路不依赖浏览器存储。| 路径 | <DSH_HOME>/profiles/<profile>/.job-stats/ledger.json（与 profile 自己的文件并列；环境里没有 DSH_HOME/DSH_PROFILE 时只留在内存，不往别处写） |
| 条数 | 每会话最多 200 条，超出先淘汰最早的结算；最多 32 个会话，超出先淘汰最久没结算的 |
| 体积 | 200 条真实命令 ≈ 53 KB；最坏情况（每条命令都到 2000 字符上限）≈ 420 KB |
| 写入 | 每次结算后写一次、每秒最多一次，行卸载时再刷一次；先写临时文件再改名，崩溃不会留下半个文件 |
| 删除 | 任何时候都可以删：它只是已结算任务的记录，后续结算会重新建立 |
任务行的第一行是"这个任务在干什么"，由面板本地从 label（shell 任务的 label 就是命令本身）归纳：先把命令拆成语句、跳过准备动作（cd …、变量赋值、重定向），再识别真正的动作 —— git commit → 提交代码、pnpm install → 安装依赖、Start-Sleep -Seconds 75 → 等待 75 秒、Get-Content → 读取文件、vitest → 跑测试；git、包管理器、解释器、PowerShell cmdlet、容器与构建工具都有覆盖。
识别在两个方向上都刻意保守：认不出来的命令原样显示；label 本身就是描述的任务（有些 producer 会这么写）不会被改写 —— 归纳错了比显示原文更糟。完整命令永远只差一次点击，也保留在行的悬浮提示里。
两侧、零构建：
| 文件 | 作用 |
|---|---|
package.json | 清单：dsh.bundle.patch（组合补丁）+ dsh.client（浏览器半侧，platform web） |
cordis.patch.yml | 插入两条 Loader 行：job-stats → 本包（发布浏览器半侧）、job-stats-recorder → ./recorder 子路径（宿主半侧） |
lib/index.js | 宿主半侧：Loaders 可见的空实现；界面在浏览器侧 |
lib/recorder.js | 宿主半侧：从注册表事件流记录任务终态，并在 /dsh-job-stats/outcomes 上提供 |
client/client.js | 浏览器半侧：标签类型、开始页卡片、统计面板 |
三处注册，全部走公开契约：
| 注册 | 席位 | 效果 |
|---|---|---|
ctx.sidebarRightTabs.register({ id, kind: 'job-stats', title, guide }) | 右侧边栏标签注册表 | 标签类型、标签条标题、开始页卡片 |
sidebar.right.pane.tab（以类型 id 为键） | 栏内面板（session 作用域） | 面板正文；sessionId 由宿主从标签页传入 |
sidebar.right.pane.tab.title（以类型 id 为键） | 标签条 | 类型标签前的自定义图标 |
实现遵守的几条规则：
require('react')），面板自绘控件，宿主升级不会让入口变空。--dsw-*，附字面量兜底），亮/暗色自动适配。ctx.inject(['sidebarRightTabs'], …) 内，没有右侧边栏的组合只是不激活，而不是抛错。ctx.effect 持有，卸载后注册表干净。pnpm install
pnpm test # 34 个用例：包清单、标签类型与席位注册、面板行为、台账
规格刻意用真实实现而不是桩：浏览器半侧按页面加载它的方式载入（一段经典脚本向 window.__ModuleLoader__ 注册一个惰性 factory），slot 注册表是 @deepseek-ai/dsh-client-ui-slots 里生产的 SlotCore，面板由真实 React 以渲染器组装的 props 渲染。于是"清单写错""注册了外壳寻址不到的席位"这类问题会在 CI 里失败，而不是在运行中的页面里翻车。
改动前的验证清单见 CONTRIBUTING.md。
已在 DeepSeek Harness 0.1.7-rc.2（DSH Desktop，Windows 11，125% 显示缩放）验证：Loader 行能组合、宿主按匹配的 revision 提供浏览器半侧、开始页卡片与栏内面板均正常渲染。