---
title: "子 Agent 进度查询教程：固定 Git 安装与旁白范围"
seo_title: "子 Agent 进度查询教程：固定 Git 安装与旁白范围"
description: "在 DeepSeek Harness（DSH）以固定 Git 提交安装 what-sub-agents-doing-now 0.2.2，配置 stuckMs，使用进度查询工具，了解驻留会话投影、提示注入与卸载后的缓存边界。"
canonical: https://52dsh.com/tutorials/realoiyo-what-sub-agents-doing-now-install-config/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["Node.js 与 pnpm","独立 web Profile","可丢弃测试工作区"]
difficulty: intermediate
estimated_action_time: null
next_steps: null
published_at: 2026-11-01
updated_at: 2026-11-01
verified_on: 2026-11-01
maintenance_status: community
verification_level: source_reviewed
risk_level: medium
dsh_version: 0.2.1-rc.5
plugin_id: realoiyo-what-sub-agents-doing-now
tutorial_kind: plugin_configuration
related_plugin_url: https://52dsh.com/plugins/realoiyo-what-sub-agents-doing-now/
---

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

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

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 的功能、权限与兼容性说明](/plugins/realoiyo-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 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 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 秒静默提示阈值

证据：[固定来源](https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/lib/index.js)。按上方配置目标使用本段内容；如有占位符，替换为测试值。

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

### 主 Agent 调用 what_subagents_are_doing 的最小参数

证据：[固定来源](https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/lib/tool.js)。按上方配置目标使用本段内容；如有占位符，替换为测试值。

```json
{"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：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --profile web --dump-config
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 web
```

1. **确认固定 Git 目标的条目加载**

   ```bash
   npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --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 移除包：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile web remove what-sub-agents-doing-now
```

1. 停止测试 DSH，在同一 Profile 移除包名：`npx --yes @deepseek-ai/dsh@0.2.1-rc.5 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 复制过来。

## 固定来源证据

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

- [README.md](https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/README.md)

继续查看：[返回 what-sub-agents-doing-now 插件详情页](/plugins/realoiyo-what-sub-agents-doing-now/)，重新核对兼容性、权限、同类插件和来源状态。

## 原始来源

- https://github.com/REALOIYO/what-sub-agents-doing-now
- https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/package.json
- https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/lib/index.js
- https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/lib/tool.js
- https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/lib/collect.js
- https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/lib/projection.js
- https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/lib/projection-registry.js
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/boot/app-boot/src/plugin-compatibility.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/session/session-projection-cache/src/index.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/subagent/subagent/src/index.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/session/session-projection/src/index.ts
- https://github.com/REALOIYO/what-sub-agents-doing-now/blob/81aedb375637239240511216e5cb32f062330421/README.md