DeepSeek Harness 插件

dsh-tui-subagents

Read-only live subagent viewer for dsh-TUI: /subagents lists a session's subagents and opens a full-screen, real-time trajectory view.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
FUSU123fusu/dsh-tui-subagents
最近更新
2026年8月17日
分类
自动化与任务
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/FUSU123fusu/dsh-tui-subagents
插件名:dsh-tui-subagents
作者:FUSU123fusu

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-tui-subagents

dsh-TUI 的子 agent 会话视图:/subagents 列出当前会话的子 agent,Enter 进入全屏轨迹视图,实时跟着子 agent 的思考、工具调用和回复滚动;对可续(continuable)子 agent 可以直接发消息纠偏、中断当前轮。对应上游 issue dsh-TUI#223

[English](#english) below.

用法

/subagents            " 列出当前会话的子 agent,选择后进入轨迹视图
/subagents a1b2       " 按 id 前缀直接进入某个子 agent 的轨迹

轨迹视图按键:

作用
↑ / ↓滚动(滚动后退出跟随模式)
PgUp / PgDn翻页
e展开/收起思考
i给可续子 agent 发消息(排入其下一个 turn)
x中断运行中子 agent 的当前轮(3 秒内按两次确认)
G跳到末尾并恢复实时跟随
← / →在兄弟子 agent 间循环切换
Esc返回列表(列表里再按退出)

一次性(one-shot)子 agent 保持只读,与官方 Web 端行为一致。

列表视图:↑/↓ 选择 · Enter 查看 · r 刷新 · Esc 退出。

原理

  • 子 agent 与会话事件走同一个 cordis 事件树:插件在根作用域监听 session/event,按 session id 过滤出目标子 agent 的事件流(assistant/chunk 逐 token、tool/calltool/result、思考流全有)。
  • 历史回填:子 agent 存活时读 live session 快照;已归档时走 sessionPersistence.inspect() 非破坏读取(不会 resume 子 agent)。
  • 发消息走 ctx.subagents.followup(parent, childId, blocks)(用户身份 source,排队不抢断当前 turn);中断走 ctx.subagents.interrupt(childId, { kind: 'user', parentSessionId })
  • UI 走 dsh-TUI 的 scene 注册缝(tuiScenes),全屏展示,崩溃只关界面不拖垮 TUI;流式渲染 50ms 帧对齐节流。
  • 机制层零改动:全部走 dsh 本体既有宿主服务(in-process cordis)。

宿主不支持 scene(web、headless)时退化为文本列表,和内置 /agents 一致。

安装

dsh plugin --profile <你的profile> add dsh-tui-subagents

或从源码:npm packdsh plugin --profile <你的profile> add file:<tgz路径>

开发

node --test              " 单元测试(事件折叠、列表解析、视口切片)
node scratch/replay-real-log.mjs <session目录>   " 用真实 session 日志冒烟

---

English

A subagent session view for dsh-TUI. /subagents lists the current session's subagents; Enter opens a full-screen trajectory that backfills from the persisted log and follows the child live — reasoning, tool calls, and replies as they stream. Continuable subagents accept follow-up messages (i) and turn interrupts (x); one-shots stay read-only, matching the official Web UI. Implements dsh-TUI#223.

  • Realtime via the cordis session/event feed (child-scope events bubble up the scope tree), 50ms frame-aligned re-renders.
  • Backfill via the live session snapshot or a non-mutating sessionPersistence.inspect() (never resumes the child).
  • Messaging via ctx.subagents.followup; interrupts via ctx.subagents.interrupt with user authority.
  • Full-screen UI through the host's tuiScenes seam; degrades to the plain text list on hosts without it.
  • Zero mechanism-layer change: everything rides existing dsh host services.

MIT