前言¶
在 DeepSeek Harness（DSH）里跑 AI Agent 时，工具调用、子代理切换和 Token 消耗往往散落在对话与日志里，想一眼看清「当前在第几步、谁在干活、队列里还有什么」并不直观。社区插件 Agent Ops / Dispatch Center（仓库 xinranmn-wq/dsh-agent-ops）挂在 DSH Web UI 上，把同一会话里的运行元数据收成一块可交互的全屏面板：记忆云、旋转卡片环和多条 HUD 信息流，并在有真实事件时用 LIVE FEED，空闲时自动切到 SIMULATION 演示，画面不会停住。下面介绍它是什么、能看什么、怎么装、怎么用，以及安装时要注意什么。
这是什么¶
Agent Ops 是维护者 xinranmn-wq 发布的 DeepSeek Harness（DSH）客户端插件（MIT 许可，package.json 版本 0.1.0，包名 @local/dsh-agent-ops）。安装后 DSH 页面右下角会出现发光圆环，点开即 Agent 运行可视化面板；插件在设置里显示为「Agent Ops 调度中心 / Agent Ops Dispatch Center」。
它解决的是 Agent 可观测性：不替代 DSH 本体，而是在本机 DSH 进程内监听 session/event，折叠成只读快照，由浏览器侧 HUD 轮询展示工具调用、Token 用量、子代理与事件日志，并用 Canvas 2D + React 做记忆云与 42 张状态卡的环状 HUD。仓库已带构建好的 client.js，安装不需要 Node.js 或构建步骤；只有改 src/*.js 时才需要 Node.js 22+ 执行 node build.mjs。
环境上依赖带插件系统的 DSH（Desktop 或 Web），需提供 shell.overlay 插槽、客户端模块加载（dsh.client），以及 Host 端的 webServer、sessions 与 session/event 事件。
核心功能¶
可视化与交互¶
- 可交互记忆云：当前会话中的工具调用、文件读写、模型回复与思考等会变为记忆云节点；悬停看标签，点击钉住并在右侧
MEMORY INSPECTOR查看详情，拖动旋转、滚轮缩放。 - 旋转卡片环：42 张状态卡绕圆心旋转；每张卡作为「粒子喷嘴」，粒子从卡的一端进入、另一端扇出射向远方（数量与手感可在
src/scene.js中通过CARD_N等常量调整）。 - 记忆与卡片联动：选中记忆云节点时，关联卡片转到可见位置并亮起，整环平滑减速；取消选中后恢复旋转。
- 完整运行 HUD：包括
GLOBAL STATUS、AGENT ROSTER、DISPATCH BUFFER、AGENT REGISTRATION、MEMORY INSPECTOR，以及底部TASK FEED、WORKER PROFILE、TOOL CHANNEL / QUEUE、TELEMETRY。
你能从面板里读到什么¶
- Agent 当前轮次、步骤，正在调用的工具、目标及成功/失败；
- 各会话/子代理（Lead / Worker / Subagent）的状态与活动；
- Token 输入/输出及最近一次回复用量；
- 近期文件读写、工具调用队列与完整事件日志；
- 一次运行从开始到结束的轨迹，以及工具调用与文件、记忆之间的关联。
数据与隐私（本地优先）¶
Host 半监听本机 session/event，通过同源、只读的 GET /dsh-agent-ops/state 暴露紧凑快照；浏览器每 1100 ms 轮询该路由，不向外部服务器发送数据，无遥测与第三方请求。快照仅含运行元数据（会话/代理状态、工具名与目标、事件日志、Token 计数等），不读取、不上传文件内容。
顶栏 LIVE FEED 表示当前 DSH 会话真实事件流；会话空闲或数据不可达时自动进入 SIMULATION 演示模式（展示的是内置演示数据，不是真实运行记录）。
安装与启用¶
插件以 本地 bundle 方式安装为主；资料未给出 dsh plugin add github:owner/repo 这类远程一键命令。任选下列方式之一即可。
方式 A（推荐）：让 DSH 里的 Agent 安装本地目录¶
- 将仓库下载或解压到本机任意目录（README 示例路径请换成你的绝对路径）。
- 在 DSH 对话中说明要把该目录作为本地插件 bundle 安装到当前 profile，例如：
帮我把
C:\path\to\dsh-agent-ops这个目录作为本地插件 bundle 安装到当前 profile。
DSH Agent 会通过 plugin_manager → install_bundle 写入当前 profile。
- 安装完成后 强制刷新 页面（
Ctrl+Shift+R）。右下角出现发光圆环；每次页面加载也会自动打开一次面板。
方式 B：命令行（若本机 DSH 提供）¶
dsh plugin --profile <你的 profile 名> add link:C:\path\to\dsh-agent-ops
将路径改为你本机插件目录的绝对路径。
方式 C：图形界面¶
打开 DSH 设置 → 插件，按当前版本入口添加本地插件目录或启用 Agent Ops 调度中心，然后强刷页面。
安装后可在 设置 → 插件 确认条目已启用；显示名、描述与图标来自 locale/{zh,en}.json 与 icon.svg。
典型用法¶
| 操作 | 效果 |
|---|---|
| 点击右下角发光圆环 | 打开 / 关闭面板 |
ESC 或右上角 × |
关闭面板 |
| 悬停记忆云节点 | 显示标签，MEMORY INSPECTOR 同步 |
| 点击记忆云节点 | 钉住记忆；关联卡片转向可见并亮起；整环减速 |
| 拖动记忆云 | 旋转（松手带惯性） |
| 滚轮（指针在场景上） | 缩放记忆云 |
| 点击卡片 | 聚焦该卡，整环减速 |
| 点击空白处 | 取消选中，恢复旋转 |
点击 TASK FEED / DISPATCH BUFFER 行 |
选中对应记忆，与场景双向联动 |
工作原理简述：Host 在 index.js 中维护快照并注册 /dsh-agent-ops/state；浏览器侧 client.js 经 src/entry.js 挂到 shell.overlay，HUD 轮询快照并驱动 Canvas 场景（src/scene.js、src/hud.js）。
适用场景与注意¶
适合谁：在 DSH 里开发或调试多步 Agent、子代理与工具链，希望在本机 Web UI 内实时看运行轨迹与 Token/队列，而不是只靠滚动日志的开发者。
权限与安全：插件随 当前 DSH 进程权限 运行，Host 半会订阅本会话事件并在本机 HTTP 上暴露只读状态路由。安装前应阅读仓库源码与 MIT 许可证，确认符合你的环境与合规要求；DSH 大版本升级后可能因内部插件 API 变化需要适配。
性能：目标约 1920×1080 / 60fps；设备较弱时可降低 CARD_N 或粒子池大小。
卸载：在 设置 → 插件 禁用或移除「Agent Ops 调度中心」，或让 Agent 执行 plugin_manager 的 remove_bundle（包名 @local/dsh-agent-ops），然后强刷页面。
生态说明：DSH 社区插件目录（如 SkillHub 上的条目页）是独立站点，与 DeepSeek / 幻方无官方从属关系；本文事实以仓库 README 与 package.json 为准。
结尾¶
Agent Ops 把 DSH 会话里的 Agent 运行元数据收进一块本地、可交互的可视化 HUD，适合需要工具调用、子代理与 Token 一览的 Harness 用户。进一步了解可访问插件目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/xinranmn-wq/dsh-agent-ops
- GitHub：https://github.com/xinranmn-wq/dsh-agent-ops
