openclaw-agent-dashboard 1.0.21 → 1.0.23

package/frontend/src/types/task.ts

@@ -1,38 +0,0 @@
-// 任务状态类型定义
-
-export type TaskStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled'
-
-export interface Task {
-  id: string
-  name: string
-  task?: string // 完整任务内容（用于显示全量）
-  status: TaskStatus
-  progress: number // 0-100
-  startTime?: number
-  endTime?: number
-  agentId?: string
-  agentName?: string
-  agentWorkspace?: string  // Agent 工作区路径
-  taskPath?: string
-  subtasks?: Task[]
-  error?: string
-  output?: string // 任务成功时 Agent 的输出内容
-  generatedFiles?: string[] // 本次任务生成/修改的文件路径
-  metadata?: Record<string, unknown>
-}
-
-export interface TaskStatusSummary {
-  tasks: Task[]
-  total: number
-  completed: number
-  failed: number
-  running: number
-  pending: number
-  cancelled: number
-}
-
-export interface TaskFilters {
-  status?: TaskStatus[]
-  search?: string
-  agentId?: string
-}

package/frontend/vite.config.ts

@@ -1,18 +0,0 @@
-import { defineConfig } from 'vite'
-import vue from '@vitejs/plugin-vue'
-
-export default defineConfig({
-  plugins: [vue()],
-  server: {
-    proxy: {
-      '/api': {
-        target: 'http://localhost:8000',
-        changeOrigin: true
-      },
-      '/ws': {
-        target: 'ws://localhost:8000',
-        ws: true
-      }
-    }
-  }
-})

package/legacy_code_anatomy.md

@@ -1,518 +0,0 @@
-# OpenClaw Agent Dashboard - 存量代码摸排报告
-
-## 1. 技术栈与框架识别
-
-### 1.1 前端技术栈
-- **核心框架**: Vue 3 (3.4.0+) - Composition API 为主
-- **构建工具**: Vite 5.0+ - 现代化前端构建工具
-- **类型系统**: TypeScript 5.3+ - 类型安全开发
-- **开发语言**: JavaScript/TypeScript
-- **版本管理**: npm 包管理，版本 1.0.10（最新）
-
-### 1.2 后端技术栈
-- **Web框架**: FastAPI 0.109.0 - 现代 Python Web 框架
-- **异步服务器**: Uvicorn 0.27.0 - ASGI 服务器
-- **数据验证**: Pydantic 2.5.0 - 数据建模和验证
-- **文件监控**: watchdog 3.0+ - 文件变更监听
-- **Python版本**: 支持 3.8+（Python 依赖：fastapi、uvicorn、pydantic、python-multipart、watchdog、tzdata）
-
-### 1.3 实时通信
-- **WebSocket**: 原生 WebSocket 支持，包含心跳检测和断线重连
-- **HTTP轮询**: WebSocket 失败时的回退机制
-- **文件监听**: watchdog 监听 OpenClaw 配置文件变更，触发实时推送
-
-### 1.4 数据存储
-- **OpenClaw原生**: 读取 `~/.openclaw/` 目录下的配置和会话文件
-- **Dashboard自定义**: `~/.openclaw-agent-dashboard/` 目录存储任务历史等数据
-- **文件格式**: 主要使用 JSON 格式（.json, .jsonl）
-
-## 2. 目录结构梳理
-
-```
-openclaw-agent-dashboard/
-├── frontend/                    # Vue 3 前端项目
-│   ├── dist/                   # 构建输出（生产版本）
-│   ├── src/
-│   │   ├── components/         # Vue 组件（21个）
-│   │   │   ├── chain/          # 任务链路相关组件
-│   │   │   ├── collaboration/  # 协作流程组件
-│   │   │   ├── performance/    # 性能监控组件
-│   │   │   ├── tasks/          # 任务状态组件
-│   │   │   └── timeline/       # 时序分析组件
-│   │   ├── composables/       # Vue 3 组合式函数
-│   │   ├── managers/          # 前端管理器
-│   │   │   ├── RealtimeDataManager.ts  # 实时数据管理
-│   │   │   ├── StateManager.ts          # 状态管理
-│   │   │   └── EventDispatcher.ts       # 事件分发
-│   │   └── types/             # TypeScript 类型定义
-│   ├── package.json           # 前端依赖配置
-│   └── vite.config.ts         # Vite 构建配置
-├── src/backend/                # FastAPI 后端项目
-│   ├── api/                   # API 路由（12个模块）
-│   │   ├── agents.py          # Agent 状态 API
-│   │   ├── collaboration.py   # 协作流程 API
-│   │   ├── performance.py     # 性能监控 API
-│   │   ├── timeline.py        # 时序分析 API
-│   │   ├── chains.py          # 任务链路 API
-│   │   ├── websocket.py       # WebSocket 路由
-│   │   ├── errors.py          # 错误分析 API
-│   │   ├── agent_config_api.py # Agent 配置 API
-│   │   ├── subagents.py       # 子 Agent API
-│   │   ├── agents_config.py   # Agent 配置管理
-│   │   └── debug_paths.py     # 调试路径 API
-│   ├── data/                  # 数据读取层（7个核心模块）
-│   │   ├── config_reader.py   # 配置读取器
-│   │   ├── subagent_reader.py # 子 Agent 数据读取
-│   │   ├── session_reader.py  # 会话数据读取
-│   │   ├── task_history.py    # 任务历史管理
-│   │   ├── error_analyzer.py  # 错误分析器
-│   │   ├── chain_reader.py    # 链路数据读取
-│   │   └── timeline_reader.py  # 时序数据读取
-│   ├── status/                # 状态计算模块
-│   │   └── status_calculator.py # Agent 状态计算
-│   ├── watchers/              # 文件监听模块
-│   │   └── file_watcher.py    # 文件变更监听
-│   ├── requirements.txt       # Python 依赖
-│   └── main.py                # FastAPI 应用入口
-├── plugin/                     # 插件打包配置
-│   ├── dashboard/             # 后端打包目录
-│   ├── frontend-dist/         # 前端构建输出
-│   ├── openclaw.plugin.json   # 插件元数据配置
-│   └── package.json          # 插件 npm 配置
-├── scripts/                    # 构建和安装脚本
-│   ├── build-plugin.js       # 插件打包脚本
-│   ├── install.js            # 安装脚本（跨平台）
-│   ├── install.sh            # 一键安装脚本
-│   ├── bundle.sh             # 分发打包脚本
-│   └── lib/                  # 公共函数库
-├── docs/                      # 项目文档
-├── .github/workflows/         # CI/CD 配置
-└── .staging/                  # 工作区暂存目录
-```
-
-## 3. 核心模块与文件说明
-
-### 3.1 后端核心模块
-
-#### 3.1.1 API 路由模块（12个）
-- **`agents.py`**: Agent 状态查询、输出获取
-- **`collaboration.py`**: 协作流程数据、模型配置、多任务并行展示
-- **`performance.py`**: 性能监控（TPM/RPM）、调用统计
-- **`timeline.py`**: 时序分析、执行步骤追踪
-- **`chains.py`**: 任务链路分析、Agent间任务派发关系
-- **`websocket.py`**: WebSocket 实时通信、状态广播
-- **`errors.py`**: 错误状态查询
-- **`agent_config_api.py`**: Agent 配置管理（读取/更新）
-- **`subagents.py`**: 子 Agent 状态查询
-- **`agents_config.py`**: Agent 配置管理
-- **`debug_paths.py`**: 调试路径查询
-
-#### 3.1.2 数据读取层（7个核心模块）
-- **`config_reader.py`**: OpenClaw 配置读取，支持环境变量（`OPENCLAW_STATE_DIR`, `OPENCLAW_HOME`）
-- **`subagent_reader.py`**: 子 Agent 运行记录读取（`runs.json`）
-- **`session_reader.py`**: 会话数据读取，工具调用分析
-- **`task_history.py`**: 任务历史持久化，避免 `runs.json` 清空后数据丢失
-- **`error_analyzer.py`**: 错误分析，根因追溯，修复建议
-- **`chain_reader.py`**: 任务链路数据读取和构建
-- **`timeline_reader.py`**: 时序数据读取，步骤解析
-
-#### 3.1.3 状态计算模块
-- **`status_calculator.py`**: Agent 状态计算逻辑，支持子状态（空闲/工作中/异常）
-
-#### 3.1.4 文件监听模块
-- **`file_watcher.py`**: 使用 watchdog 监听关键文件变更，触发 WebSocket 推送
-
-### 3.2 前端核心模块
-
-#### 3.2.1 Vue 组件（21个）
-- **协作流程组件**: `CollaborationFlowWrapper.vue`, `CollaborationFlowSection.vue`
-- **任务链路组件**: `TaskChainView.vue`, `ChainNode.vue`, `ChainEdge.vue`
-- **时序分析组件**: `TimelineView.vue`, `TimelineStep.vue`, `TimelineConnector.vue`
-- **性能监控组件**: `PerformancePanel.vue`, `PerformanceMonitor.vue`
-- **任务状态组件**: `TaskStatusSection.vue`
-- **错误分析组件**: `ErrorAnalysisView.vue`, `ErrorCenterPanel.vue`
-- **Agent 组件**: `AgentCard.vue`, `AgentDetailPanel.vue`, `AgentConfigPanel.vue`
-
-#### 3.2.2 前端管理器
-- **`RealtimeDataManager.ts`**: WebSocket 连接管理，HTTP 轮询回退，事件订阅
-- **`StateManager.ts`**: 集中状态管理和数据缓存
-- **`EventDispatcher.ts`**: 事件分发机制
-
-#### 3.2.3 组合式函数
-- **`useRealtime.ts`**: 实时数据处理钩子
-- **`useState.ts`**: 状态管理钩子
-- **`useDebounce.ts`**: 防抖处理
-- **`useThrottle.ts`**: 节流处理
-- **`useVirtualScroll.ts`**: 虚拟滚动支持
-
-### 3.3 构建和部署
-
-#### 3.3.1 构建脚本
-- **`build-plugin.js`**: 插件打包流程：
-  1. 构建前端（`npm run build`）
-  2. 复制 backend 到 `plugin/dashboard`
-  3. 复制 frontend/dist 到 `plugin/frontend-dist`
-- **`install.js`**: 跨平台安装脚本，支持本地和远程模式
-- **`bundle.sh`**: 生成可分发的压缩包
-- **`install.sh`**: Linux/macOS 一键安装脚本
-
-#### 3.3.2 版本管理
-- **主版本控制**: `plugin/openclaw.plugin.json` 和 `plugin/package.json`
-- **自动发布**: GitHub Actions 根据 git tag 自动创建 Release
-- **一键安装**: `npx openclaw-agent-dashboard` 从 GitHub Release 下载安装
-
-## 4. 现有功能清单
-
-### 4.1 核心功能
-
-#### 4.1.1 协作流程可视化
-- **工位视图**: 以卡片形式展示主 Agent 和子 Agent 状态
-- **实时连线**: 展示主 Agent 与子 Agent 的任务派发链路
-- **多任务并行**: 支持展示 Agent 同时执行多个任务的状态
-- **模型配置可视化**: 展示各 Agent 配置的模型及使用关系
-- **最近调用光球**: 展示最近的模型调用记录
-
-#### 4.1.2 任务状态监控
-- **实时状态**: Agent 状态实时更新（空闲/工作中/异常）
-- **任务进度**: 显示当前执行的任务名称和进度
-- **子状态展示**: 详细的子状态（思考中/工具执行/等待模型/等待子代理）
-- **异常检测**: 自动检测 Agent 异常状态并提供警告
-
-#### 4.1.3 性能监控
-- **TPM/RPM统计**: 实时统计每分钟Token数和请求数
-- **调用详情**: 按分钟查看具体的调用记录和触发内容
-- **模型使用分析**: 各模型的使用频率和性能表现
-- **性能趋势图**: 可视化展示性能变化趋势
-
-#### 4.1.4 错误分析
-- **错误分类**: 自动分类错误类型（API认证、限流、模型错误、超时等）
-- **根因分析**: 追溯错误发生的上下文和工具调用链
-- **修复建议**: 根据错误类型提供具体的修复建议
-- **错误统计**: 按类型、严重程度统计错误分布
-
-#### 4.1.5 时序分析
-- **执行时序图**: 展示用户与 Agent 的完整交互时序
-- **LLM轮次分组**: 将交互按LLM轮次分组展示
-- **步骤详情**: 显示每个步骤的详细信息（用户消息、思考、工具调用、结果）
-- **性能统计**: 显示总时长、Token使用量、工具调用次数等
-
-#### 4.1.6 任务链路分析
-- **链路可视化**: 展示 Agent 间的任务派发链路
-- **链路追踪**: 追踪任务从主 Agent 到子 Agent 的完整执行路径
-- **进度监控**: 显示链路中各节点的执行状态和进度
-- **产物展示**: 展示各节点生成的文件和产出物
-
-### 4.2 辅助功能
-
-#### 4.2.1 Agent 配置管理
-- **配置查看**: 查看各 Agent 的详细配置信息
-- **模型配置修改**: 在线修改 Agent 的主模型和备用模型
-- **模型列表**: 获取所有可用模型列表（支持白名单过滤）
-- **配置验证**: 配置修改前的有效性验证
-
-#### 4.2.2 实时通信
-- **WebSocket 连接**: 支持实时数据推送
-- **断线重连**: 自动重连机制，支持指数退避
-- **HTTP 轮询**: WebSocket 失败时的回退机制
-- **心跳检测**: 定期心跳检测连接状态
-
-#### 4.2.3 文件监听
-- **配置监听**: 监听 OpenClaw 配置文件变更
-- **会话监听**: 监听会话文件变更
-- **实时更新**: 文件变更时自动推送更新
-- **防抖处理**: 避免短时间多次变更触发频繁推送
-
-#### 4.2.4 调试支持
-- **调试路径**: 显示重要的文件路径信息
-- **详细日志**: 支持调试级别的日志输出
-- **会话详情**: 查看完整的会话交互记录
-- **工具调用追踪**: 追踪工具调用的完整过程
-
-## 5. 架构图（文字描述）
-
-### 5.1 整体架构
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    OpenClaw Agent Dashboard                │
-├─────────────────────────────────────────────────────────────┤
-│  前端层 (Vue 3 + TypeScript)                                │
-│  ├── App.vue (主应用)                                        │
-│  ├── 组件层 (21个Vue组件)                                    │
-│  │   ├── 协作流程组件                                       │
-│  │   ├── 任务链路组件                                       │
-│  │   ├── 性能监控组件                                       │
-│  │   ├── 时序分析组件                                       │
-│  │   └── 其他功能组件                                       │
-│  ├── 管理器层                                               │
-│  │   ├── RealtimeDataManager (实时数据)                    │
-│  │   ├── StateManager (状态管理)                          │
-│  │   └── EventDispatcher (事件分发)                       │
-│  └── 组合式函数                                             │
-├─────────────────────────────────────────────────────────────┤
-│  通信层 (WebSocket + HTTP)                                  │
-│  ├── WebSocket 连接管理                                     │
-│  ├── HTTP 请求封装                                         │
-│  ├── 断线重连机制                                           │
-│  └── 心跳检测                                               │
-├─────────────────────────────────────────────────────────────┤
-│  后端层 (FastAPI + Python)                                  │
-│  ├── API 路由层 (12个模块)                                  │
-│  │   ├── agents API                                        │
-│  │   ├── collaboration API                                 │
-│  │   ├── performance API                                   │
-│  │   ├── timeline API                                      │
-│  │   ├── chains API                                        │
-│  │   ├── websocket API                                     │
-│  │   └── 其他 API                                          │
-│  ├── 数据读取层 (7个核心模块)                              │
-│  │   ├── config_reader (配置读取)                          │
-│  │   ├── subagent_reader (子Agent数据)                    │
-│  │   ├── session_reader (会话数据)                        │
-│  │   ├── error_analyzer (错误分析)                        │
-│  │   ├── chain_reader (链路数据)                          │
-│  │   └── timeline_reader (时序数据)                        │
-│  ├── 业务逻辑层                                             │
-│  │   ├── status_calculator (状态计算)                     │
-│  │   └── file_watcher (文件监听)                          │
-│  └── FastAPI 应用入口                                       │
-├─────────────────────────────────────────────────────────────┤
-│  数据存储层                                                 │
-│  ├── OpenClaw 原生数据                                     │
-│  │   ├── ~/.openclaw/openclaw.json                       │
-│  │   ├── ~/.openclaw/agents/*/sessions/                   │
-│  │   ├── ~/.openclaw/subagents/runs.json                  │
-│  │   └── ...                                               │
-│  └── Dashboard 自定义数据                                   │
-│      └── ~/.openclaw-agent-dashboard/                      │
-├─────────────────────────────────────────────────────────────┤
-│  插件部署层                                                 │
-│  ├── 构建脚本 (build-plugin.js)                            │
-│  ├── 安装脚本 (install.js, install.sh)                    │
-│  ├── 插件配置 (openclaw.plugin.json)                      │
-│  └── CI/CD (.github/workflows/)                            │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### 5.2 数据流向
-
-```
-用户浏览器 ←→ 前端Vue应用 ←→ WebSocket/HTTP ←→ FastAPI后端 ←→ 数据存储层
-     │                │                  │                  │
-     │                │                  │           ┌──────┴──────┐
-     │                │                  │           │  OpenClaw   │
-     │                │                  │           │   原生数据  │
-     │                │                  │           └─────────────┘
-     │                │                  │                  │
-     │                │                  │           ┌──────┴──────┐
-     │                │                  │           │ Dashboard  │
-     │                │                  │           │   自定义数据│
-     │                │                  │           └─────────────┘
-     │                │                  │                  │
-     │                │         ┌────────▼─────────┐         │
-     │                │         │  文件监听服务    │         │
-     │                │         │ (watchdog)      │         │
-     │                │         └──────────────────┘         │
-     │                │                                        │
-     │         ┌─────▼─────┐                                   │
-     │         │ 实时数据   │                                   │
-     │         │ 管理器     │                                   │
-     │         └───────────┘                                   │
-     │                                                        │
-└─────┬────────────┘
-      │
-   用户界面展示
-```
-
-### 5.3 实时通信架构
-
-```
-┌─────────────────┐    WebSocket连接    ┌─────────────────┐
-│   前端组件      │ ←────────────────→ │ FastAPI后端      │
-│                 │                    │                 │
-│  • Realtime     │                    │  • WebSocket    │
-│    DataManager  │                    │    路由         │
-│  • 状态更新     │                    │  • 文件监听     │
-│  • 事件订阅     │                    │    触发推送     │
-└─────────────────┘                    └─────────────────┘
-         │                                      │
-         │                                      │
-         ▼                                      ▼
-   HTTP轮询回退                              数据变更监听
-   (WebSocket失败时)                          (watchdog)
-```
-
-## 6. 扩展点分析
-
-### 6.1 高优先级扩展点
-
-#### 6.1.1 新增可视化面板（UI扩展）
-**位置**: `frontend/src/components/` 和 `frontend/src/App.vue`
-**扩展方式**: 新增 Vue 组件并在主应用中注册
-**优势点**:
-- 组件化架构清晰，易于扩展
-- 已有统一的样式系统和布局管理
-- 实时数据管理器支持新模块的事件订阅
-
-**建议扩展**:
-- 日志分析面板：实时展示 Agent 执行日志
-- 资源监控面板：CPU、内存、磁盘使用率
-- 网络监控面板：API 响应时间、成功率统计
-
-#### 6.1.2 新增 API 数据源（后端扩展）
-**位置**: `src/backend/api/` 和 `src/backend/data/`
-**扩展方式**: 新增 API 路由模块和数据读取模块
-**优势点**:
-- 现有 API 架构规范，易于遵循
-- 数据读取层有成熟的配置读取模式
-- WebSocket 实时推送机制完善
-
-**建议扩展**:
-- 系统监控 API：读取系统性能指标
-- 日志分析 API：解析和分类日志文件
-- 告警管理 API：配置和管理告警规则
-
-#### 6.1.3 新增分析模块（算法扩展）
-**位置**: `src/backend/data/` 和 `src/backend/status/`
-**扩展方式**: 新增分析器模块，遵循现有错误分析器模式
-**优势点**:
-- 已有错误分析器的完整实现模式
-- 状态计算器支持复杂的状态判断逻辑
-- 结果可通过 WebSocket 实时推送
-
-**建议扩展**:
-- 性能瓶颈分析器：识别性能问题的根因
-- 异常行为检测器：基于历史数据检测异常模式
-- 智能推荐分析器：基于错误类型提供智能优化建议
-
-### 6.2 中优先级扩展点
-
-#### 6.2.1 配置管理增强
-**位置**: `src/backend/data/agent_config_manager.py` 和相关 API
-**扩展方式**: 扩展现有的配置管理功能
-**优势点**:
-- 已有完整的配置读写机制
-- 支持配置备份和回滚
-- 前端有现成的配置界面组件
-
-**建议扩展**:
-- 批量配置修改：支持同时修改多个 Agent 的配置
-- 配置模板管理：创建和应用配置模板
-- 配置版本管理：跟踪配置变更历史
-
-#### 6.2.2 告警功能扩展
-**位置**: 新增 `src/backend/api/alerts.py` 和相关组件
-**扩展方式**: 基于现有的状态计算和错误分析机制
-**优势点**:
-- 可复用现有的状态计算逻辑
-- 错误分析已提供分类基础
-- WebSocket 支持实时告警推送
-
-**建议扩展**:
-- 告警规则配置：支持自定义告警条件和阈值
-- 告警通知渠道：邮件、Webhook、钉钉等
-- 告警历史和统计分析
-
-#### 6.2.3 数据导出功能
-**位置**: 扩展现有 API 模块，新增导出端点
-**扩展方式**: 在现有 API 基础上增加数据导出功能
-**优势点**:
-- 现有数据读取层提供完整的数据访问
-- 支持多种数据格式（JSON、CSV、Excel）
-- 可基于现有查询结果进行导出
-
-**建议扩展**:
-- 性能数据导出：支持不同时间范围的性能数据导出
-- 错误日志导出：支持按时间、类型筛选的错误日志导出
-- 任务报告导出：生成任务执行报告并导出
-
-### 6.3 低优先级扩展点
-
-#### 6.3.1 主题和样式定制
-**位置**: `frontend/src/` 样式文件
-**扩展方式**: 扩展现有的样式变量系统
-**优势点**:
-- 已有完整的 CSS 变量系统
-- 组件样式统一管理
-- 支持响应式设计
-
-**建议扩展**:
-- 多主题支持：浅色/深色主题切换
-- 自定义主题：用户自定义颜色和样式
-- 布局定制：支持拖拽调整布局
-
-#### 6.3.2 权限管理
-**位置**: 新增认证和权限模块
-**扩展方式**: 基于现有的 FastAPI 框架集成权限管理
-**优势点**:
-- FastAPI 内置支持认证和授权
-- 可与 OpenClaw 现有用户系统集成
-- API 级别的权限控制
-
-**建议扩展**:
-- 基于角色的访问控制（RBAC）
-- 操作权限细化到具体功能
-- 审计日志记录
-
-#### 6.3.3 插件系统
-**位置**: 扩展现有的插件架构
-**扩展方式**: 基于现有插件机制开发扩展插件
-**优势点**:
-- 已有完整的插件打包和分发机制
-- 支持热插拔和动态加载
-- 标准化的插件接口
-
-**建议扩展**:
-- 第三方插件支持：允许开发者扩展功能
-- 插件市场：插件的发布和发现平台
-- 插件开发工具包：简化插件开发
-
-### 6.4 技术架构扩展建议
-
-#### 6.4.1 微服务化改造
-**考虑因素**: 当前是单体应用，可根据需要逐步拆分
-**拆分建议**:
-1. 数据采集服务：负责从 OpenClaw 采集数据
-2. 分析引擎服务：负责数据分析和状态计算
-3. API 网关服务：统一的 API 入口和路由
-4. 前端资源服务：静态资源和前端应用
-
-#### 6.4.2 数据库集成
-**当前状态**: 主要基于文件系统存储
-**集成建议**:
-- 时序数据库：存储性能指标和时序数据
-- 关系型数据库：存储配置和结构化数据
-- 缓存层：提高数据访问性能
-
-#### 6.4.3 容器化部署
-**考虑因素**: 当前支持插件化部署，可进一步容器化
-**建议方案**:
-- Docker 容器化：打包应用和依赖
-- Kubernetes 编排：支持大规模部署
-- Helm 图表：标准化部署流程
-
----
-
-## 总结
-
-OpenClaw Agent Dashboard 是一个架构清晰、功能完善的 Agent 可视化监控系统。项目采用现代化的技术栈，具有良好的模块化设计和扩展性。
-
-**主要优势**:
-1. **技术栈现代化**: Vue 3 + FastAPI，支持 TypeScript
-2. **架构设计合理**: 前后端分离，模块化清晰
-3. **实时性能优秀**: WebSocket + 文件监听，实时性强
-4. **功能覆盖全面**: 涵盖监控、分析、调试等主要场景
-5. **部署方式灵活**: 支持插件化部署和一键安装
-
-**关键扩展点**:
-1. **高优先级**: 新增可视化面板、API 数据源、分析模块
-2. **中优先级**: 配置管理增强、告警功能、数据导出
-3. **低优先级**: 主题定制、权限管理、插件系统
-
-**建议的增量开发方向**:
-1. 优先从高优先级扩展点入手，快速增加业务价值
-2. 遵循现有架构模式，保持代码风格一致性
-3. 充分利用现有的实时数据管理和状态管理机制
-4. 注重用户体验，提供直观的可视化界面
-
-此摸排报告为后续的业务分析（BA）和系统架构（SA）工作提供了详细的技术基础和扩展指导。

package/plugin/README.md

@@ -1,99 +0,0 @@
-# OpenClaw Agent Dashboard 插件
-
-多 Agent 可视化看板 - 作为 OpenClaw 插件安装后，随 OpenClaw 启动自动运行。
-
-## 快速开始
-
-克隆仓库后，在项目根目录执行：
-
-```bash
-npm run deploy
-```
-
-该命令会自动完成：
-1. 检查前置条件（Node.js、Python 3、OpenClaw）
-2. 构建前端
-3. 打包并安装插件到 `~/.openclaw/extensions/`
-4. 自动安装 Python 依赖（fastapi、uvicorn 等）
-
-**前置要求**：
-- Node.js（构建前端）
-- Python 3.10+
-- OpenClaw（`npm install -g openclaw`）
-
-安装完成后，执行任意 `openclaw` 命令即可自动启动 Dashboard。
-
----
-
-## 命令说明
-
-| 命令 | 说明 |
-|------|------|
-| `npm run deploy` | 打包 + 安装到 OpenClaw（首次安装或升级） |
-| `npm run upgrade` | 拉取最新代码 + 部署（推荐用于升级） |
-| `npm run pack` | 仅打包插件，不安装（开发调试用） |
-| `npm run bundle` | 生成可分发的压缩包（离线分发） |
-
-### 升级插件
-
-```bash
-cd openclaw-agent-dashboard
-npm run upgrade
-```
-
-输出示例：
-```
-=== OpenClaw Agent Dashboard 插件升级 ===
-
-  1.0.0 → 1.1.0
-
-✓ 前置条件检查通过
->>> 1/4 构建前端...
->>> 2/4 打包插件...
->>> 3/4 移除旧版本...
->>> 4/4 安装新版本...
->>> 检查 Python 依赖...
-✓ Python 依赖已就绪
-
-=== 升级完成 (1.0.0 → 1.1.0) ===
-```
-
----
-
-## 使用
-
-插件加载后（执行任意 `openclaw` 命令时）会自动启动 Dashboard 服务。
-
-**访问地址**：http://localhost:38271（或你配置的端口）
-
-### 端口配置（便于移植，无需改 openclaw.json）
-
-优先级从高到低：
-
-1. **环境变量**：`DASHBOARD_PORT=38271`
-2. **独立配置文件**：`~/.openclaw-agent-dashboard/config.json`（可与 `OPENCLAW_AGENT_DASHBOARD_DATA` 环境变量配合）
-   ```json
-   { "port": 38271 }
-   ```
-3. **openclaw.json**：`plugins.entries.openclaw-agent-dashboard.config.port`
-4. **默认**：38271
-
-端口被占用时会自动尝试 38272、38273...
-
----
-
-## 手动安装（故障恢复）
-
-若 `npm run deploy` 失败，可分步执行：
-
-```bash
-# 1. 打包
-npm run pack
-
-# 2. 安装插件
-openclaw plugins install ./plugin
-
-# 3. 安装 Python 依赖（通常不需要，脚本会自动完成；Debian/Ubuntu 请用 venv）
-cd ~/.openclaw/extensions/openclaw-agent-dashboard/dashboard
-python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
-```

package/plugin/config.json.example

@@ -1 +0,0 @@
-{"port":38271}