前言¶

在 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