空间轨迹视图 Rgndmln/dsh-agent-astra

AgentAstra

一个面向 DeepSeek Harness 的空间化对话视图。观察智能体在时间中穿行，触碰工具与文件，并在身后留下可读的轨迹。

AgentAstra 是产品名称。spatial-trajectory 仍是包名和 Harness 标识符。

一段五秒回放：提示词 → 工具调用 → 回复

大多数智能体 UI 会把一次繁忙的运行变成一长串消息和折叠的工具行。这个插件走了另一条路：它保留对话本身，但把工作铺展成一小片可以穿行的空间。一次回复、一条命令、一次文件编辑、一个委派任务，不再只是记录里的行——它们拥有位置、关系和时刻。

空间视图中一次已完成的运行

一眼可见的内容

- 语义时间（Z）——在有意义的事件之间移动，而不是每个流式 token。过去逐渐淡出，当下被标记，未来结构则刻意保持不透明。
- 因果通道（X）——输入、控制与结果被分隔开，因此更容易看出是什么触发了工具调用，以及它产生了什么。
- 信息层（Y）——执行、对话与产物占据不同的高度，而不是在一条扁平的信息流中相互竞争。
- 一个活跃的工作台——当智能体正在读取、写入或调用工具时，智能体及其真实目标会移入一个共享工作区，并由一条小小的动画系绳相连。
- 对话仍然在那里——用户消息和智能体的最终回复会以可读卡片的形式呈现。选中一张卡片即可打开其完整的 Markdown 内容；没有任何重要内容会被装饰性的可视化所取代。

上面的 GIF 录制自一个全新的、只读的 Flash 模型会话。它跟随两条简短提示词经过它们的语义检查点，其中包括一次 pwd 工具调用。录制过程中没有读取或更改任何仓库文件。

作为 DeepSeek Harness 插件安装

这是一个 DeepSeek Harness 插件。它面向 @deepseek-ai/dsh 0.1.0-rc.6，并使用 Harness 客户端模块加载器。

使用以下任一形式从 GitHub 将其安装到 web 配置文件中：

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

然后在 DeepSeek Harness 中打开一个对话并选择 Spatial。该视图以会话为作用域：它只渲染当前选中的对话，并在视图卸载时释放其 WebGL 场景。

如果在本地 Harness 开发过程中 macOS 达到其文件监视器上限，CHOKIDAR_USEPOLLING=1 dsh web 是一个实用的临时解决方法。

在运行中穿行

| 操作 | 结果 |
| ↑ / ↓ | 上一个 / 下一个语义事件 |
| Shift + ↑ / Shift + ↓ | 上一条 / 下一条可见的用户或智能体消息 |
| 暂停、拖动轨道，或使用 Home / End | 在不重置环绕或缩放的情况下查看历史 |
| 单击节点 | 选中它并打开其浮动详情卡片 |
| 双击节点 | 有意将相机聚焦到它上面 |
| 拖动精确的文件快照 | 将其真实内容放入原生编辑器草稿 |

当详情卡片与编辑器重叠时，可以拖动它。文件路径在场景中被压缩显示；完整路径和 Markdown 预览仍可在卡片中查看。

什么会成为节点

投影是有意选择性的。它保留人们会认为是工作一部分的内容：

- 智能体运行的开始和结束；
- 人类提示和助手可见的回复文本；
- 工具、委派的智能体、文件和外部资源；
- 显式的读取、写入、调用、委派和流转关系；
- 流式回复的聚合活动记录，这样长回答不会变成成千上万个微小节点。

内部推理、工具参数、使用记录、注入的上下文和原始流式片段不会成为对话气泡。视觉视图应该增加方向感，而不是暴露实现残渣。

它是如何组合的

Harness session events
↓
normalization + semantic projection
↓
scene state (entities, relations, activity, checkpoints)
↓
React controls + Three.js renderer

src/projection.ts 是语义含义的唯一真相来源。src/App.tsx 将选中的时间转换为有界、可读的窗口。src/spatial-renderer.ts 只关注渲染和交互。这种分离使得回放逻辑无需 WebGL 即可测试，并防止 UI 细节改变事件事实。

有意设定的边界

- 浏览器视图从不自行写入工作区文件。
- 只有当 Harness 事件具有精确的源快照时，历史文件才能被推送到编辑器。仅含元数据的历史保持不可用，而不是凭空捏造附件。
- 视图跟随活动会话。切换离开后，后台对话不会继续渲染。
- 画布纹理和动画链接是有界的；密集的工具爆发会折叠为安静的执行轨迹，而不是重复几何体的云团。
- 如果 WebGL 不可用，周围的控件和文本回退仍然可用。

仓库结构

src/
projection.ts semantic event → spatial state
temporal-window.ts bounded time-window and message lingering rules
station-layout.ts stable semantic coordinates
spatial-renderer.ts Three.js scene, interaction, disposal
harness/ DeepSeek Harness host/client integration
assets/ the lightweight README demo media

许可证

MIT。

状态

这是一个实验性的交互插件，并非试图将每次智能体运行变成电子游戏。目标更简单：当智能体忙碌时，你应该能够瞥一眼这个空间，理解它正在做什么、正在接触什么，以及答案来自哪里。

AgentAstra
面向 DeepSeek Harness 的空间化对话视图。让智能体在时间中移动、触碰工具和文件，并留下可以阅读的工作轨迹。

AgentAstra 是产品名称；spatial-trajectory 仍是技术包和 Harness 标识符。

五秒回放：用户请求 → 工具调用 → Agent 回复

多数 Agent 界面会把一次忙碌的运行压成很长的消息列表和折叠的工具行。AgentAstra 想走另一条路：保留完整对话，同时把工作铺展成一个可以穿行的小空间。回复、命令、文件修改和子任务不再只是文本流中的一行——它们都有位置、关系和发生的时刻。

一次已完成的空间化运行

一眼能看到什么

- 语义时间（Z） — 按有意义的事件而非每个流式 token 穿行。过去渐隐、现在被标出，未来只保留结构，不提前泄露内容。
- 因果通道（X） — 输入、主控和结果被分开，更容易看出某次工具调用由什么触发，又带来了什么。
- 信息层级（Y） — 执行、对话和工件位于不同高度，不再挤在单一平面。
- 活动工作区 — Agent 正在读取、写入或调用工具时，它和实际目标会进入共享工作区，并用一条轻量动画连接。
- 对话仍然可读 — 用户消息和最终回复会投影为可阅读卡片；点击即可打开完整 Markdown 内容，重要信息不会被可视化替代。

上方 GIF 来自一个全新的只读 Flash 模型会话。它按语义检查点回放两条短提示，其中包含一次 pwd 工具调用；录制过程没有读取或修改任何仓库文件。

作为 DeepSeek Harness 插件安装

这是一个 DeepSeek Harness 插件，目标版本为 @deepseek-ai/dsh 0.1.0-rc.6，使用 Harness 客户端模块加载器。

可以通过以下任一方式从 GitHub 安装到 web profile：

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

然后打开 DeepSeek Harness 中的任意对话，选择 Spatial。视图与会话绑定：它只渲染当前选中的对话，并会在视图卸载时释放 WebGL 场景。

如果 macOS 在本地 Harness 开发时达到文件监听数量上限，可临时使用 CHOKIDAR_USEPOLLING=1 dsh web。

在轨迹中穿行

| 操作 | 效果 |
| ↑ / ↓ | 前一个 / 后一个语义事件 |
| Shift + ↑ / Shift + ↓ | 前一条 / 后一条可见的用户或 Agent 消息 |
| 暂停、拖动时间条，或使用 Home / End | 浏览历史，同时保留你已调整的旋转和缩放视角 |
| 单击节点 | 选中节点并打开浮动详情卡 |
| 双击节点 | 有意地将镜头聚焦到该节点 |
| 拖动精确文件快照 | 将真实内容放入原生聊天框草稿 |

详情卡可拖动，以免遮住聊天框。场景中会压缩长文件路径；完整路径与 Markdown 预览仍可在详情卡内查看。

哪些内容会成为节点

投影层会刻意筛选，只保留人能理解为工作过程一部分的内容：

- 一次 Agent 运行的开始和结束；
- 用户输入，以及 Agent 实际显示给用户的回复文本；
- 工具、子 Agent、文件和外部资源；
- 明确的读取、写入、调用、委派和流转关系；
- 为流式回复聚合出的活动记录，避免一段长回复膨胀成几千个小节点。

内部推理、工具参数、usage、注入上下文和原始流式片段不会成为对话气泡。可视化应该帮助定位，而不是展示实现噪声。

实现结构

Harness 会话事件 ↓ 规范化 + 语义投影 ↓ 场景状态（实体、关系、活动、检查点） ↓ React 控制层 + Three.js 渲染器

src/projection.ts 负责语义事实；src/App.tsx 将选中的时间点转成一个有限、可读的窗口；src/spatial-renderer.ts 只处理渲染与交互。这样的分层使回放逻辑无需 WebGL 即可测试，也避免 UI 细节反过来改变事件事实。

有意保留的边界

- 浏览器视图不会自行写入工作区文件。
- 历史文件只有在 Harness 事件提供精确源快照时，才可推入聊天框；只有元数据的历史会明确保持不可用，而不是伪造附件。
- 视图跟随当前会话；切换走后，后台对话不会继续渲染。
- Canvas 纹理和动画连接都有上限；密集工具调用会压成安静的执行痕迹，而不是重复几何体组成的云团。
- WebGL 不可用时，周围控制和文本回退仍然可用。

仓库结构

src/
projection.ts 语义事件 → 空间状态 temporal-window.ts 有界时间窗口与消息停留规则 station-layout.ts 稳定的语义坐标 spatial-renderer.ts Three.js 场景、交互和资源释放 harness/ DeepSeek Harness 的主机/客户端接入 assets/ README 使用的轻量演示媒体

许可证

MIT。

状态

这是一个实验性的交互插件，并不打算把每次 Agent 运行做成游戏。目标很简单：当 Agent 正在工作时，用户应该能一眼看懂它在做什么、触碰了什么，以及最终回答从哪里来。