4.6 KiB
description, kind
| description | kind |
|---|---|
| Web 后台任务表面：列出本会话可见任务的会话头部动作；供后台任务体验的用户与维护者阅读。 | package-reference |
@deepseek-ai/dsh-client-ui-jobs
English | 中文
概述
本包渲染 Web GUI 的后台任务表面：一个会话头部动作，打开后以弹层列出本会话可见的任务。它经运行时提供的 jobsBySession 镜像读取宿主计算的注册表状态，自身不发任何 RPC。触发器只在会话至少有一个任务时出现，角标计数运行中与停止中的任务；终态行保持可见并弱化，直到注册表把它们丢弃。模型对同一批任务的视角属于 dsh-tool-jobs；本包是给人类看的只读投影。
目录
使用本包
与运行时一起挂载本插件；只要会话至少有一个任务，任务动作就会出现在会话头部。点击打开弹层：活跃行在前按开始时间升序，随后终态行按结束时间降序，每行显示生产者 kind、标签、状态，以及一个活跃时每秒跳动、完成后冻结的已耗时。
关闭与边界
Escape 关闭列表并把焦点交还触发器，在其外部按下指针同理。列表展示的是「一个会话通过线路视图能看到什么」，因此别的会话拥有的任务在这里永不出现；进程重启会清空列表，而文本记录里启动这些任务的 run_in_background 卡片仍在。
理解实现
实现细节——点击展开
本包向 conversation.session.header.actions 贡献一个条目（JobListAction），数据完全来自 Session Controller binding 从 session/jobs 帧折叠出的 jobsBySession 列表镜像——不发 RPC，除弹层开合外不持有任何状态。角标计数 running 加 stopping，为零时省略。行序为活跃行在前按 startedAt 升序、终态行按 finishedAt 降序，毫秒并列按启动顺序打破；缺少 finishedAt 的终态行读作零而不是负数，超过一小时的耗时停留在小时单位。终态行保持可见，因为失败任务的 detail 是其失败唯一可读之处。行为由 Web 后台任务展示笔记 规定。
进一步探索
当任务表面不够用时阅读以下页面。它们从浏览器列表进入注册表与面向模型的工具。
- dsh-tool-jobs——同一注册表之上的面向模型任务工具。
- Session Controller——折叠出本包读取的
jobsBySession镜像。 - ui-subagent——subagent 目录，运行中的一次性后台 subagent 也会出现在那里。
- Web 客户端架构——浏览器插件行如何加载并注册槽位。
模型体验
无，因为本包为人类渲染宿主计算出的注册表状态，不触及 prompt、消息、schema、流或工具结果。
KV Cache 影响
无；本包从不组装或发送提供方请求。
已知限制与延期工作
这些限制界定了当前任务列表。它们是当前包约束，不是通用任务管理对比或任务积压。
- 行是只读的——任务的流式输出与人类发起的中断是各自独立的阶段。中断还额外欠一个 seam 没有回答的、面向模型的决策：
kill()会把终态投递标为已上报，所以照当前契约写出来的中断会让模型一直以为它的任务还在跑。 - 列表不等于注册表自己的集合——它展示的是一个会话通过线路视图能看到什么，因此别的会话拥有的任务在这里永不出现；进程重启会清空列表，而文本记录里启动这些任务的
run_in_background卡片仍在。无主任务（没有活体Agent时启动的）反过来会进入每个会话的列表，与list(caller)对每个调用方的报告一致。
开发备注
维护者的工作上下文——点击展开
无。