DAG总览 / 组目录 / G02 API 网关与控制器

dsh-api-job-controller · @deepseek-ai/dsh-api-job-controller

Layer 4G02L2 web-app
目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游(该插件依赖的前驱):
依赖链 · 下游(依赖该插件的节点):
同一拓扑层(Layer 4,层次遍历层序):
↑ Layer 3(24 插件)Layer 4↓ Layer 5(55 插件)

插件信息

包名@deepseek-ai/dsh-api-job-controller
分组G02 · API 网关与控制器
拓扑层Layer 4(层次遍历:被依赖方先于依赖方)
源码路径packages/api/job-controller
来源层L2 web-app bundle(base 之上装配)

① 实现逻辑

JobController 继承 TypertRemoteService,以 namespace 'job' 注册并注入 jobs/typert (src/index.ts:43-65)。list 与 follow 两个 stream 方法分别委托 streamJobRows / observeJobOutput,把 ctx.jobs 的可见任务集合与单个任务的保留输出投影成帧 (src/index.ts:75-96)。两个生成器都在首次读取前订阅 registry.events,先产出 opened/rows 基线,之后在唤醒后按 flushMs 合并突发;输出按 maxFrameBytes 软预算切分,任务到终态或收到 removed 时产出 status 后收尾 (src/observe.ts:41-93, src/rows.ts:26-52)。kill 先以 sessionId 做所有权查询再同步调用 jobs.kill,未知/越权统一映射为 job/not-found (src/index.ts:109-127)。

内部结构动态 DAG(深色主题:橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件)
本插件 上游依赖 下游依赖 外部 seam

② 注册/提供(provides)

③ 依赖(depends_on · 上游前驱)

dsh-api-gatewayE1
客户端 Remote 载体
src/client/service.ts:11 import + src/client/model.ts:5 import
dsh-sessionE1
客户端会话身份类型
src/client/model.ts:12 import type SessionId

④ 被依赖(dependents · 下游消费者)

dsh-api-remotes
装配 job 命名空间
src/client/index.ts:23 import remote
dsh-client-ui-jobs
作业注册表、观察流与 kill 的客户端服务
src/client/JobListAction.tsx:2 + src/client/index.ts:11 (ctx.jobs 服务来源)