前言¶
在 DSH 裏跑 agent,常見界面是 session 聊天窗:人跟着滾動流實時盯輸出,拍板往往混在對話裏,事後也難還原「當時 agent 做了什麼、人在哪一步做了決定」。DeepSeek 在《Exploring Super-agent Design》(2026-10-31,dsh-superagent-prototype)裏也提到:基於 session 聊天窗口的設計,存在路徑依賴。
React Monitor Agent(RMA)把協作單位改成「審查回放 + 檢查點」:agent 照常工作,人在結構化時間線上回放過程,在關鍵幀上批准、否定或改向。下面介紹它是什麼、和 dsh-superagent 如何分工,以及如何在本機把操作板跑起來。
這是什麼¶
RMA 是給 agent 配的一塊可交互操作板(Operation Board),維護者爲 Lumos-789。倉庫同時是 DSH 的 skill 殼型插件(bundle 不內嵌產品源碼,通過 bundled skill 引導克隆倉庫並按快速開始啓動 core/ 與 app/)。
產品本體分兩塊:
- rma-core(
core/):零依賴 Node 服務,默認端口 8790,事件寫入~/.rma/,提供 localhost API 與檢查點引擎。 - rma-board(
app/):React Web 操作板,默認端口 5173,承載審查回放與檢查點交互。
許可證爲 MIT。社區目錄頁:skillhub.cn/plugins/Lumos-789/react-monitor-agent(獨立社區站點,與 DeepSeek / 幻方無官方從屬關係)。
三個核心概念¶
操作板上的兩條軌道¶
操作板只承載兩類一等目標:
- Context Track(上下文建設):非業務產出,如知識、規則、流程定義。
- Work Track(業務執行):coding 及一切真業務。
審查回放(Review Replay)¶
agent 工作過程被整理成結構化時間線敘事,節點可混合錄屏、截圖、diff、文本等;隨時回放,而不必實時盯聊天滾動流。
檢查點(Checkpoint)¶
回放裏等人決策的關鍵幀;類型決定可用按鈕子集。官方表格如下:
| 檢查點 | 觸發 | 動作 |
|---|---|---|
| Plan | 方案/選型待拍板 | 批准 / 否定 / 改向 / 補充 |
| Progress | 里程碑成果 | 批准 / 改向 / 補充 |
| Risk | agent 自報拿不準 | 批准 / 否定 / 補充 |
| Delivery | 交付物最終審查 | 完工 / 否定 / 補充 |
檢查點採用模板保底 + agent 可追加;否定或改向後,舊分支灰掉保留,便於審計完整。
與 dsh-superagent 的關係¶
二者互補、不互斥:
- DSH 管 agent 側自律:准入、授權、自治邊界;panel 側重工單列表,目標是讓 agent 少打擾人。
- RMA 管人側審查帶寬:敘事回放、交互更豐富;讓人在被打擾時看得快、答得快。
安裝與啓用¶
DSH 插件形態¶
倉根即 bundle:package.json 聲明 dsh.bundle(patch 指向 cordis.patch.yml),index.js 以 bundledSkillDir 掛載 skills/react-monitor-agent/。引擎要求 DSH >=0.2.1-rc.2 <0.3.0,peer 依賴 @deepseek-ai/dsh-skill-filesystem >=0.1.0-rc.6 <0.3.0。
資料中的說明是:DSH 與 ZCode 兩條渠道都只是安裝、配置、排障入口;產品始終通過克隆倉庫並使用 core/ + app/ 運行。README 未給出形如 dsh plugin add github:… 的單行安裝命令,啓用時應以 bundled skill 指引及倉庫文檔爲準。
本機啓動(快速開始)¶
先在倉庫根目錄分別啓動 core 與 board:
# rma-core: 零依賴 Node 服務(端口 8790, 事件存 ~/.rma/)
cd core && npm ci && npm run dev
# rma-board: Web 操作板(端口 5173)
cd app && npm ci && npm run dev
瀏覽器打開 http://localhost:5173 即可看到操作板。
改動後可在倉庫根目錄自檢:
npm run verify
該命令會跑 core 測試,並對 app 做類型檢查相關校驗(與 README「core 測試全綠,app 類型檢查+構建通過」一致)。
典型用法¶
FIXTURE 演示模式(默認)¶
前端默認 FIXTURE 演示模式:離線可跑,內置三個演示工程(二維碼名片生成器、競品調研報告、superagent docs 蒸餾)。回放中的檢查點決策可真實點擊,選擇會改變時間線走向。
連接 live core¶
需要連真實 rma-core 時,在 app 目錄用 live 模式啓動:
VITE_RMA_MODE=live npm run dev
演示視頻見 B 站:《DeepSeek 問:agent 爲什麼只有聊天窗?我做了個操作板》。
倉庫結構¶
core/ rma-core — 事件庫(JSONL append-only) + 檢查點引擎 + localhost API
app/ rma-board — React 操作板 + 審查回放 + 完工態三屏
demo-projects/ 演示工程事件流
適用場景與注意¶
適合誰:需要在 agent 長跑任務中,用時間線審查而非純聊天流做拍板;希望 Plan / Progress / Risk / Delivery 等檢查點有固定交互語義的團隊或個人。
使用前請知悉:
- 插件以當前 DSH 進程權限運行;安裝 bundle 或按 skill 克隆倉庫前,應自行閱讀源碼與 MIT 許可證,確認事件落盤路徑(如
~/.rma/)與本地 API 端口符合你的安全策略。 - 路線圖包含 DSH bundle 原生適配器(agent 進程內插件、自動事件採集),以倉庫 README 狀態節爲準;當前仍以 core + app 手動啓動爲主。
結尾¶
RMA 把「人機協作」從單一聊天窗,落到審查回放 + 檢查點的可操作界面;與 dsh-superagent 分工後,agent 自律與人側審查可以分開優化。