外部任务上下文 LiFenrir/dsh-external-task-context

外部任务上下文（dsh-external-task-context）

在 DSH Web 右侧栏查看外部子代理任务（Claude Code、Codex、ACP）的委派提示词、运行时上下文和返回结果。

功能与位置

- 会话标题栏按钮：当前会话记录过外部任务时，标题栏会出现「外部任务 N」按钮。点击后，在右侧栏打开本插件页面（布局空间足够时新开一栏）。
- 右侧栏面板：左栏列出外部任务（标签或短 id、状态、开始时间）；右栏显示选中的任务。默认选中最新任务；手动选中的任务只要还在就保持选中，消失后回落到最新任务。
- 详情：状态、开始/完成时间、工具名、委派提示词、工作目录、服务商/模型/推理强度/智能体预设、返回内容、结算摘要。提示词和回答超过 64 KiB 时截断，并显示本地化提示。

数据来源

展示的内容全部已记录在父会话日志中；插件不新增会话事件，也不改变模型可见行为：

1. tool/call：委派工具的参数 JSON。description 是目录标签；prompt 是委派的任务；可选的 cwd、provider、model、reasoning_effort、agent_preset 是运行时上下文。
2. subagent/catalog v2：{ version: 2, childId, childCreatedAt, mode: 'external', label? }，用来确定稳定的子任务 id。
3. 之后一条 user/message，其 source.kind === 'subagent-settled'：source.summary 说明任务如何结束；文本块依次是摘要行、Its closing message: 或 It left no closing message.、子任务的最终文本、可选的 Structured result: ...、可选的诊断信息。

宿主把这些事件折叠进 externalTaskContexts 投影；客户端只读这个投影。

已知限制

外部服务商（Claude Code、Codex、ACP）在进程外运行；DSH 不持久化它们的内部步骤或工具调用记录，外部子任务也没有本地会话或转录。因此本插件只能显示委派上下文和返回结果——永远看不到外部智能体的私有上下文、内部推理或完整工具调用链。

在 DSH 0.2.1-rc.2 中，Claude Code 服务商使用 persistSession: false，连它进程内的会话都不会保留。

另外：

- 只在匹配无歧义时才按标签配对：取最早一个同目录标签、尚未配对的调用；没有标签匹配时，用唯一一个未配对的调用；有多个候选时，提示词和选项留空，不做猜测。
- 只保留最新的 20 个未配对委派调用。
- Fork 继承的事件（seq < inheritedEventCount）不计入当前会话。

安装

需要 DSH 0.2.1-rc.2 或更新版本，以及 Node ^22.19 || >=24。

从 npm 安装

dsh plugin add @lifenrir/dsh-external-task-context

从 git 安装

dsh plugin add git+https://github.com/LiFenrir/dsh-external-task-context.git

从本地目录安装

git clone https://github.com/LiFenrir/dsh-external-task-context.git
cd dsh-external-task-context
pnpm install
pnpm run build
dsh plugin add /absolute/path/to/dsh-external-task-context

本地构建会生成 lib/index.js（宿主端）和 lib/client.js（Web 客户端）。

然后在该配置档里启用这个 bundle。重启应用，或重新打开会话，让宿主端投影和客户端 bundle 加载。

用法

1. 让模型通过外部子代理工具派活（Claude Code、Codex 或 ACP）。
2. 派活出现后，页头会显示「External tasks」按钮，点它。
3. 在左栏选一个任务，查看它的提示词、运行时上下文和返回结果。

隐私

投影会随会话投影缓存一起持久化，所以提示词和返回内容会在会话日志之外再存一份（这些内容在会话日志里本来就有）。在共享环境里，或导出会话时，请按同样的敏感级别对待它们。