前言¶

在 DeepSeek Harness 中运行智能体时，一次任务可能包含用户提示、Agent 可见回复、工具调用、子 Agent、文件读取或写入、外部资源访问，以及这些事件之间的关系。若只把它理解为一串线性消息，事件发生的位置、触发关系和最终产物来源往往不够直观。

下面介绍一个 DeepSeek Harness 客户端插件：Rgndmln/dsh-agent-astra。它把 Harness 会话事件投影为可穿行的空间化视图，用于查看 Agent 运行过程中的关键节点、因果通道和信息层级。

这是什么¶

Rgndmln/dsh-agent-astra 是一个面向 DeepSeek Harness 的客户端插件。已核实资料中给出的产品名称为 AgentAstra，包名与 Harness 标识符为 spatial-trajectory。

该插件的核心目标是把一次 Agent 运行组织成可读、可浏览的空间化轨迹：用户消息和最终回复仍作为可读卡片存在，工具、子 Agent、文件、外部资源以及读取、写入、调用、委派、流转关系则被投影到同一视图中。

基础信息如下：

• 仓库路径：Rgndmln/dsh-agent-astra
• 分类：客户端
• 许可证：MIT
• README 自述为实验性交互插件
• 目标兼容：@deepseek-ai/dsh 0.1.0-rc.6
• 使用 Harness 客户端模块加载器
• package.json 中 react、react-dom、three 依赖写为 latest

核心功能¶

AgentAstra 提供以下已核实能力：

1. 将 DeepSeek Harness 会话事件投影为可穿行的空间化视图。
2. 用语义时间（Z）、因果通道（X）、信息层级（Y）组织运行过程。
3. 展示 Agent 运行开始/结束、用户提示、Agent 可见回复、工具、子 Agent、文件、外部资源，以及读取、写入、调用、委派、流转关系。
4. 将用户消息和最终回复投影为可阅读卡片，并可打开完整 Markdown 内容。
5. 支持键盘、时间条、节点点击/双击等交互。
6. 可拖动精确文件快照到原生聊天框草稿。
7. 视图与会话绑定，只渲染当前选中对话，并在视图卸载时释放 WebGL 场景。
8. WebGL 不可用时，保留周围控件和文本 fallback。

安装与启用¶

先安装插件到 web profile。可使用 GitHub 短格式：

dsh plugin --profile web add github:Rgndmln/dsh-agent-astra

也可以使用 HTTPS 形式：

dsh plugin --profile web add https://github.com/Rgndmln/dsh-agent-astra.git

安装完成后，打开 DeepSeek Harness 中的对话，选择 Spatial 视图。视图只跟随当前活动会话；切换会话后，已离开会话不会继续后台渲染。

如果在 macOS 本地 Harness 开发过程中遇到文件监听上限，可临时使用轮询方式启动：

CHOKIDAR_USEPOLLING=1 dsh web

典型用法¶

经过上面的步骤后，可以按以下方式查看和穿行一次 Agent 运行轨迹。

1. 在 DeepSeek Harness 对话中选择 Spatial。
2. 使用键盘切换语义事件或消息：
   - ↑ / ↓：前一个 / 后一个语义事件
   - Shift + ↑ / Shift + ↓：前一条 / 后一条可见用户或 Agent 消息
3. 浏览历史：
   - 暂停
   - 拖动时间条
   - 使用 Home / End
4. 查看节点详情：
   - 单击节点：打开浮动详情卡
   - 双击节点：将镜头聚焦到该节点
5. 将文件内容放入聊天框：
   - 拖动精确文件快照到原生聊天框草稿

这里有一个限制：历史文件只有在 Harness 事件提供精确源快照时才可推入 composer；只有元数据的历史不可用。

适用场景与注意¶

该插件适合在 DeepSeek Harness 的 web profile 中查看 Agent 运行轨迹，尤其适合需要观察以下内容的场景：

• 用户提示、Agent 回复、工具调用之间的关系
• 子 Agent 委派过程
• 文件读取、写入及外部资源访问
• 一次运行中哪些事件先发生，哪些事件由其他事件触发

使用前需要注意：

• 该插件被自述为实验性交互插件，不是正式稳定组件。
• 插件会随当前 dsh 进程权限运行。安装前应检查源码、依赖和许可证。
• package.json 中 react、react-dom、three 依赖写为 latest，建议在受控环境中确认最终锁定的依赖版本。
• 浏览器视图不会自行写入工作区文件。
• 视图只渲染当前选中对话，卸载时释放 WebGL 场景。
• WebGL 不可用时，会保留周围控件和文本 fallback，而不是完全不可用。

链接¶

• GitHub 仓库：https://github.com/Rgndmln/dsh-agent-astra
• 插件目录页线索（未独立核实）：https://www.skillhub.cn/plugins/Rgndmln/dsh-agent-astra