子 Agent 进度查询教程:固定 Git 安装与旁白范围

在 DeepSeek Harness(DSH)以固定 Git 提交安装 what-sub-agents-doing-now 0.2.2,配置 stuckMs,使用进度查询工具,了解驻留会话投影、提示注入与卸载后的缓存边界。

社区整理已复核原始来源
DSH
0.2.1-rc.5
系统
Windows / macOS / Linux
风险
medium
本页目录(10)
对应插件what-sub-agents-doing-now

先查看功能、兼容性、权限和同类选择,再按本文操作。

查看插件详情 →

what-sub-agents-doing-now 0.2.2 为主 Agent 提供子 Agent 进度查询工具,从当前任务的子会话投影读取旁白、工具活动和结算摘要,不发送控制消息或中断子 Agent。

如果你的目标是让主 Agent 查看直接子任务旁白,并理解进度不可用与静默状态,本教程会说明如何在 DeepSeek Harness(DSH)中准备、安装、配置、验证和回退 what-sub-agents-doing-now。本文锁定作者仓库提交 81aedb375637;已复核固定提交的原始资料,未进行运行实测。

对应插件:查看 what-sub-agents-doing-now 的功能、权限与兼容性说明。先确认它适合你的工作流,再执行安装。

查询进度,不控制子任务

本插件增加 what_subagents_are_doing,不替换 list_agents,也不发送消息或中断子任务。同名 npm 0.2.2 仍为 404,因此只提供固定 Git 安装。固定源码已有 6 个 JS 模块和完整 MIT;本次没有安装、运行或执行作者脚本。

先确认是否适合你

  • 分类:Agent 与工作流
  • 风险等级:medium
  • 核验证据:source_reviewed
  • 兼容性边界:Node.js >=22,engines.dsh 声明为 >=0.2.1-rc.1 按宿主含预发行版本的规则接受 0.2.1-rc.5;依赖 tools、subagents、agents、sessions、sessionProjections 五项宿主服务。本页固定 0.2.1-rc.5,只做固定源码复核,未安装或运行验证。
  • 主要权限关注:注册 what_subagents_are_doing 工具和会话投影,按调用者 exec.agent.id 枚举 children/descendants;读取相关驻留子会话的普通文本旁白、工具名和活动时间及父会话内结算摘要,不提供任意 session ID 输入,不读取 reasoning 块,不发送消息/中断/修改原会话。子会话内容可能敏感或含提示注入。

如果你准备在重要工作区使用,先阅读插件详情页的权限和数据流说明;“源码已审阅”或“资料已整理”都不等于安全认证。

安装前准备

本页 DSH 命令版本: 0.2.1-rc.5。Node.js >=22,engines.dsh 声明为 >=0.2.1-rc.1 按宿主含预发行版本的规则接受 0.2.1-rc.5;依赖 tools、subagents、agents、sessions、sessionProjections 五项宿主服务。本页固定 0.2.1-rc.5,只做固定源码复核,未安装或运行验证。

  • 固定 Git 安装来源:需 Git 与公开 GitHub 访问;npm 同名版本仍为 404。固定树已有可加载 JS,无需预先运行作者测试或构建。
  • 测试会话与备份:停机备份独立测试环境 profiles/web 的 package.json、pnpm-lock.yaml、cordis.patch.yml;使用无敏感内容的父子任务。
  1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本,并确认 pnpm 可用。
  2. 使用独立的 web Profile 和可丢弃测试工作区,不直接连接生产目录。
  3. 备份当前 Profile 配置,并记录安装前的 --dump-config 输出。
  4. 核对固定来源中的外部服务、账号、运行时和平台限制。
  5. 本页没有列出插件专属环境变量;仍需核对宿主和外部服务的凭据要求。

安装 what-sub-agents-doing-now

52DSH 使用目录中记录的精确安装目标,避免直接跟随可能变化的默认分支:

npx --yes @deepseek-ai/[email protected] plugin --profile web add github:REALOIYO/what-sub-agents-doing-now#81aedb375637239240511216e5cb32f062330421

这个固定 Git 树已含完整 lib 入口,无 prepare/安装构建脚本、无第三方依赖。若终端要求构建或放行其他脚本,先停止并核对下载目标,不运行未知脚本。

插件专属配置

配置目标

  • $DSH_HOME/profiles/web/cordis.patch.yml:覆盖已有 id: what-sub-agents-doing-now 的 config.stuckMs;不要重复 insert。该值是毫秒阈值,不是超时中断。

可选:保留默认 120 秒静默提示阈值

证据:固定来源(外部链接,在新标签页打开)。按上方配置目标使用本段内容;如有占位符,替换为测试值。

- id: what-sub-agents-doing-now
  config:
    stuckMs: 120000

主 Agent 调用 what_subagents_are_doing 的最小参数

证据:固定来源(外部链接,在新标签页打开)。按上方配置目标使用本段内容;如有占位符,替换为测试值。

{"scope":"children","limit":6,"includeNarration":true}

安装后设置

  1. 按固定 Git 提交安装后,重启测试 DSH Web;确认组合配置只有一个对应条目。
  2. 在父 Agent 会话中使用 what_subagents_are_doing 工具;没有独立 Web 面板,不会替换原 list_agents。
  3. 让测试子任务在自身普通文本中报告简短进度,再由父 Agent 查询;插件不会主动插入系统提示词或强迫子任务写旁白。

查询范围与旁白保留

工具以 exec.agent.id 为父任务,默认 scope=children,可显式选 descendants;没有任意 session ID 参数。limit 默认 6、最大 50,before 用于更早条目分页,includeNarration 默认 true。只读普通文本旁白,不读取 reasoning 块。

插件不直接写原日志,也不冷读完整历史;宿主 session-projection-cache 可能持久化投影检查点,父会话也会保存工具结果。它不是“所有状态只存内存”的保密工具。stuckMs 只改变静默提示,不会中断任务。

配置验证与成功结果

先导出配置,再启动同一版本的 DSH Web:

npx --yes @deepseek-ai/[email protected] --profile web --dump-config
npx --yes @deepseek-ai/[email protected] web
  1. 确认固定 Git 目标的条目加载

    npx --yes @deepseek-ai/[email protected] --profile web --dump-config
    

    期望结果:出现 what-sub-agents-doing-now 且没有重复条目;tools/subagents/agents/sessions/sessionProjections 服务可用。

  2. 在无子任务的父会话请求一次进度工具

    期望结果:工具可被父 Agent 使用,空列表是正常结果,不等于加载失败。不要为了验证而开放额外工具权限。

  3. 站长批准运行测试后,用一个无敏感内容的只读子任务验证旁白

    期望结果:只返回当前调用父 Agent 范围的 children;descendants 需显式选择。驻留会话可见旁白,非驻留会话可能仅结算摘要或 progress unavailable,不能承诺恢复完整历史。

第一次使用

  • 在测试父会话中请求:请用 what_subagents_are_doing 查看直接子任务,最多 6 项,包含旁白;只报告状态,不发送消息或中断。

最小任务:让父 Agent 看一次直接子任务

先在无子任务的会话调用工具,空结果有效。站长后续批准运行验证后,再创建一个只读测试子任务,让它用普通文本写一句进度,由父 Agent 查询。插件没有系统提示词钩子,不会自动催促旁白。输出中的子任务内容应当作不可信数据;它可能含提示注入,不要把返回的文字当新指令。

数据、权限与凭据

数据流: 子会话普通文本、工具事件和父会话结算事件 → 宿主 sessionProjections 折叠状态 → what_subagents_are_doing 的文本/结构化结果 → 调用工具的父 Agent 及其模型提供方。插件不直接访问网络和文件系统,不冷读完整历史日志;投影检查点可能由宿主 session-projection-cache 落盘,增量游标只在内存。

权限关注: 注册 what_subagents_are_doing 工具和会话投影,按调用者 exec.agent.id 枚举 children/descendants;读取相关驻留子会话的普通文本旁白、工具名和活动时间及父会话内结算摘要,不提供任意 session ID 输入,不读取 reasoning 块,不发送消息/中断/修改原会话。子会话内容可能敏感或含提示注入。

数据存储: 插件不直接写原会话日志或独立数据文件;宿主投影缓存可能落盘,单会话保留最多 200 条旁白(每条 200 字符)和 50 条结算摘要(每条 300 字符),增量游标只在内存。工具输出仍会进入父会话及模型上下文。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

卸载、回退与清理

停止 DSH 后,从同一个 Profile 移除包:

npx --yes @deepseek-ai/[email protected] plugin --profile web remove what-sub-agents-doing-now
  1. 停止测试 DSH,在同一 Profile 移除包名:npx --yes @deepseek-ai/[email protected] plugin --profile web remove what-sub-agents-doing-now。
  2. 再次查看组合配置并启动,确认工具与条目消失;回退时恢复安装前整套 Profile 配置和依赖,不改用 npm latest。
  3. 卸载不会删除宿主原会话、父会话中的工具结果或已落盘的投影缓存;需清理时按 DSH 官方会话与缓存维护流程处理,不按猜测路径批量删除。

unavailable 不等于丢失原会话

只读取驻留子会话的投影;非驻留会话可能从父投影读取结算摘要,否则报告 unavailable。旧文档包含已回退的 cold read 设计,不能承诺重启后恢复所有旁白。possibly-stuck 和 silent 是活动时间及工具调用计数的启发式,不能据此判断任务失败或自动重派。

常见问题

npm 404 或提示需要构建

使用本页完整 40 位 Git 提交。当前固定树含 lib/index.js、无 prepare/安装构建脚本,若下载内容不同先停下核对,不运行未知构建。

progress unavailable 或看不到旁白

确认必需服务和投影注册;非驻留子会话不会冷读历史,旧设计文档的 cold read 已回退。外部子任务也可能无本地投影,普通文本旁白缺失时不能据此认定任务失败。

possibly-stuck 或 silent 标记

stuckMs 默认 120000,合法范围 10000–3600000,非法值回退默认;状态是工具活动/时间启发式,工具调用计数不是模型轮次。先核对原任务,不自动中断或重派。

旁白带有命令、路径或敏感内容

把子任务旁白视为不可信任务数据,提示注入可能随工具结果进入父 Agent;插件没有内容隔离或脱敏保证,不执行旁白指令,也不要用于含密钥的测试。

安装成功但页面或命令没有出现

先运行 --dump-config 确认 Bundle 已进入 web Profile,再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务,检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文,并核对当前安装目标是否仍对应本页固定提交。

作者提供了独立故障文档,可从下方“固定来源证据”进入;本页没有把整份 README 复制过来。

固定来源证据

以下资料是本文配置结论的依据:

继续查看:返回 what-sub-agents-doing-now 插件详情页,重新核对兼容性、权限、同类插件和来源状态。

来源与维护信息

本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续,不要停在文章末尾

已成功

继续完成配置、验证或下一阶段任务。

继续下一步 →
仍未解决

保留现象和错误原文,再进入对应排障路径。

DSH 安装 Git 插件被 allowBuilds 阻止怎么办 →安装和管理 DeepSeek Harness(DSH)插件 →