Files
deepseek-harness/packages/client/ui-subagent/README.zh.md
T

8.2 KiB
Raw Blame History

description, kind
description kind
dsh Web 客户端的 subagent 对话目录、续接路由 UI 与 '@' 引用 source。 package-reference

@deepseek-ai/dsh-client-ui-subagent

English | 中文

概述

使用本包可浏览父会话下的每个 subagent 对话、打开任意后代,并查看其是否正在运行以及 token 用量和活跃轮次耗时。已完成的 one-shot 对话会作为只读执行记录打开。可继续对话在运行期间按提交顺序接收后续提示词,并独立提供 Stop。普通会话侧边栏会省略 subagent 对话,因此父会话页头目录是它们的导航入口。独立的 @ source 会把运行中 child 的 label 插入用户消息,但不会把它解析成继续执行地址。

目录


使用本包

会话页头保留当前会话 title 作为谱系面包屑,并在直接目录有子项或读取失败时追加 / 数量触发器。目录缺席、空目录加载中或成功加载为空时,均隐藏数量触发器。触发器打开该直接目录,报告总数与运行数,并且只在行展开时加载嵌套目录。选择任意深度,即可用该子会话的确切 {parentSessionId, childSessionId, mode} 地址打开其对话;也可以使用行尾箭头在右侧 Sidebar 打开同一地址,并在空间允许时优先使用独立分栏。

本包注册 dsh-resource://subagentchat/session/<child>?parent=<parent>&mode=<mode> 资源与 builtin Sidebar tab 类型。资源先刷新直接 parent 目录,再保留 child 的 SessionReference,并在 tab 记录关闭时释放 reference。tab 通过 sidebar.chat.conversation 渲染共享 conversation.content Factory,把局部 View 固定为 Chat,并省略主 Conversation 的 Header 与宽度控制。

浏览目录

行显示 mode、活动状态与由日志支撑的可选 title;running 使用共享 ongoing loading,最近一个已结束轮次正常完成的 inactive child 使用共享 success 绿点,其他 inactive child 使用共享 idle 灰点。每行都为状态图标预留相同的 14px 列宽,并将较小的圆点居中,使 title 与 loading 状态对齐。紧凑的页头触发器会垂直居中活动图标与数量,并保留 4px 水平间距。尾随列在上行显示提供方的持久化 token 用量总计,在下行显示活跃轮次耗时。键盘导航:ArrowRight/ArrowLeft 展开和折叠分支;ArrowUp/ArrowDown、Home、End 与 Escape 用于导航或关闭树。没有 label 的 one-shot 行回退到其会话 id。只有一行自身的目录加载为空后,它才是已知叶子。

续接对话

确切 parent 存活时,可继续 child 保留普通输入 chrome:child 运行期间输入和 Send 保持可用,因为每条后续消息都会进入 child 的 FIFO inbox,而独立的 Stop 经由 subagents/interruptByParent 路由。确切 parent 不可用且 child 未在运行的可继续 child 会选用说明恢复路径的只读编辑器;此类 child 仍在运行期间,selector 会让位给普通编辑器——输入区与 Send 被禁用,但独立的 Stop 保持可用。

@ 引用 source

@ source 仍然刻意保持独立且惰性:候选是从 ctx.sessions.list 零 RPC 得到的运行中 child;pick 会插入字面文本 @label ,codec 投影为 @label。它不参与命令裁决,也不会把 label 解析成继续执行地址。


理解实现

实现细节——点击展开

目录与编辑器行为由 Web subagent 对话笔记 与当前轮次中断笔记 规定。

目录派生

页头谱系 renderer 通过标准 useSessions 钩子读取 projectionsBySession。renderer 从每个 Session 的共享值中选择 subagentCatalog,用于成员关系、展开控件与数量;活动状态优先使用统一 UI status,缺少时使用 Session 摘要;摘要提供标题与用量。展开行会按需加载初始目录。实时 projection 帧更新所有已加载层级,无需菜单订阅或重复成员查询。行在目录缺席、加载中或失败时保持可展开,并在目录就绪且为空后成为已知叶子。

面包屑地址从 Provider 所绑定的 Session 地址和已加载的 parent 目录推导,也包括从未选中过的祖先。

耗时、完成状态与 token

每个可见目录层在包含运行中 child 时独立推进时钟;折叠该层或关闭菜单会释放时钟。token 用量总计为四个互不重叠的 tokenUsage 桶之和。subagentTiming 投影会累加已结束轮次的耗时,并记录最近一个已结束轮次是否以 completed 结束;新轮次开始时会清除该完成状态,直到自身的 turn/end 到达。耗时仅在运行中 child 存在未结束轮次时每秒递增一次,并在 child 变为 inactive 后冻结;被中断的未结束轮次以其同一切面的 active.through 为上界,绝不使用更新的会话元数据。

编辑器选举

one-shot child 始终选用只读编辑器。可继续 child 仅在其确切 parent 不可用且 child 未在运行时选用只读编辑器;否则普通编辑器的会话会经 subagents/prompt 路由提示词。本包绝不接收宿主上下文,也不调用面向模型的工具。

模式未知的目录项仍可见、可点击,没有标签时显示子会话 id。读取子历史并确认受支持模式前,输入区保持只读;读取失败在该子会话中报告。


进一步探索

以下页面覆盖对话界面、宿主 seam 与设计笔记。


模型体验

用户提示词中的 subagent label 文本

模型看到的内容

只有 @ 引用 source 会影响模型输入:pick 的候选以字面文本 @label 进入普通用户消息,没有专用内容块或宿主侧解析。浏览目录、导航 child 与查看持久化 transcript(文本记录)都不会添加提示词 section;已接收的继续交互内容会经宿主 subagent 适配器成为普通 FIFO 用户消息。

Token 影响

有条件且仅追加:字面 @label 或用户后续消息只会向对应的新用户消息增加 token。目录与 transcript 操作增加零模型 token。

KV Cache 影响

仅追加。本包绝不改写更早的请求 token。

已知限制与延期工作

这些限制定义目录能显示什么、@ 引用意味着什么;它们是当前包约束。

  • 非完成的 inactive 结果仍合并显示:目录能区分最近一次正常完成与其他 inactive 状态,但不区分失败、取消、拒绝、token 耗尽或尚无已结束轮次的 child;UI 不公开 Activation 身份,停止能力仅限编辑器上针对运行中可继续 child 的当前轮次 Stop。
  • @ 引用仍是显示标题文本:重复或改名后的 label 会有歧义,因此它们刻意不获得继续执行语义。

开发备注

维护者的工作上下文——点击展开

无。

运行时不变式: 不发布伴生入口。插件只注册一个 slash source,其资源释放已由 HMR(热模块替换)安全规范验证;它不发出 Cordis 事件,也不持有跨插件可变状态。