前言¶
智能体开发过程中，开发者往往只能看到控制台日志或简单的状态输出，难以直观了解代理的思考过程、工具调用和等待状态。如果代理需要人工审批，审批进度和等待原因也不容易追踪。
DSH（DeepSeek Harness）采用「一切皆插件」的理念，允许通过插件扩展功能。dsh-agent-office 是一个客户端插件，它将代理的运行状态可视化为一个像素风格的虚拟办公室，让代理像真实的同事一样出现在屏幕上。
这是什么¶
dsh-agent-office 是一个为 DeepSeek Harness 提供的实时代理办公看板插件。由 xx-ytg 维护，分类为客户端。它不改变代理的执行逻辑，只是通过 WebSocket 接收 Harness 的会话事件，在前端渲染代理的桌面、工具使用、等待审批和休息状态。
插件本身零运行时依赖，不依赖额外的 API 密钥，也不需要额外的模型调用。
核心功能¶
1. 实时会话可视化¶
代理的工作状态会以像素风格的同事形象展示在屏幕上。每个代理有自己的工位，工位上有工具实验室、审批角、沙发和植物等元素。代理会离开工位去使用工具，使用完毕后回到工位；需要审批时进入审批角等待；每轮对话结束后会去沙发上休息。
2. 会话追踪与层级关系¶
支持主会话和子代理会话的实时投影。通过父链接表示会话的层级关系（session lineage），而不是推断出的对话关系。
3. 状态分类¶
代理有多种状态：完成（turn 完成）、错误、阻塞、暂停、空闲。「完成」指一轮对话结束，不代表项目通过验收测试。
4. 交互与导出¶
- 可点击代理名单，将任意会话带到当前视图
- 查看活动流、每轮步骤、工具调用、令牌使用量
- 导出 PNG 场景截图
- 支持中英文界面、日间/夜间主题、移动端布局和无障碍支持
5. 独立等待状态¶
独立跟踪待处理的工具和审批任务。并行请求不会提前清除等待状态。
安装与启用¶
前置要求¶
- Node.js >=22.19.0
- DeepSeek Harness >=0.2.1-alpha.4
安装命令¶
在包含 dsh-agent-office 文件夹的目录下执行：
dsh plugin --profile office add ./dsh-agent-office
dsh --profile office web
如果 CLI 未全局安装，可使用 npx @deepseek-ai/dsh@0.2.1-alpha.4 替代 dsh。
安装后需要重启 Harness。启动后访问 http://127.0.0.1:4319。插件会在终端输出其 URL。
配置¶
通过 profile overlay 编辑已安装的插件配置：
- id: agent-office
config:
port: 4320
maxAgents: 48
maxEvents: 120
| 设置 | 默认值 | 范围 | 用途 |
|---|---|---|---|
port |
4319 | 1024–65535 | 仅绑定到本地的办公室服务器 |
maxAgents |
48 | 1–200 | 跟踪的会话数；不活跃的会话优先被清除 |
maxEvents |
120 | 10–500 | 内存中的活动历史 |
最多同时绘制 12 名同事，所有跟踪的会话仍可在名单中选择。如果跟踪上限已满，新会话会被忽略直到有空位。计数器自插件启动后累计，非生命周期总数。UI 活动流显示最近 6 条事件。
典型用法¶
10 秒预览演示¶
在下载仓库后，直接运行：
cd dsh-agent-office
node src/demo.mjs
打开 http://127.0.0.1:4319。演示模式使用模拟事件，不会连接到正在运行的 Harness。
连接真实代理¶
在 Harness profile 中配置模型，然后启动 Harness 和办公室看板：
dsh --profile office web
在另一个终端启动 Harness，开始任务。办公室会自动从 Harness 的事件流中读取数据。点击名单中的代理可以查看其活动。
源码覆盖安装¶
如果不想安装插件，可以使用覆盖方式加载：
node scripts/make-patch.mjs > office.local.patch.yml
dsh --profile office web --patch ./office.local.patch.yml
适用场景与注意¶
适合需要可视化代理运行状态、调试工具调用和审批流程的开发者。它不会拦截或修改代理执行，只观察和展示 Harness 的事件。
注意：
- 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证
- HTTP 服务器仅绑定到
127.0.0.1，不暴露到公网 - 状态存储在内存中，重启后清除
- 没有写入端点，不会向第三方发送数据
- 不支持跨 Harness 进程的会话（不同进程的代理不可见）
短结尾¶
dsh-agent-office 提供了一种直观的方式观察代理的思考过程和工具使用情况。它不改变代理逻辑，只是将 Harness 的事件投影到像素风格的办公场景中，帮助开发者更好地理解代理的行为。
更多详情请访问：https://www.skillhub.cn/plugins/xx-ytg/dsh-agent-office
源代码：https://github.com/xx-ytg/dsh-agent-office
