前言¶

在 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）¶

回放里等人决策的关键帧；类型决定可用按钮子集。官方表格如下：

检查点采用模板保底 + 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 自律与人侧审查可以分开优化。

• 社区目录：https://www.skillhub.cn/plugins/Lumos-789/react-monitor-agent
• 源码与文档：https://github.com/Lumos-789/react-monitor-agent