ODC Teams Monitor

Trello 风格的只读监控看板，可视化展示 acpx-teams-mcp 的团队、任务和消息数据。

功能特性

• 团队总览 — 左侧边栏展示所有团队，支持状态筛选（在线/阻塞/离线）
• 成员视图 — 按成员分列的 Trello 看板，展示每个成员的任务卡片
• 任务视图 — 按任务状态分列（Pending / In Progress / Completed）
• 消息侧栏 — 右侧实时消息 feed，按类型标签分类（任务分配/关闭请求/空闲通知等）
• 自动轮询 — 数据每 5-10 秒自动刷新，无需手动操作
• 可拖拽布局 — 团队列表和消息栏宽度可自由调整

快速开始

使用 npx（推荐）

npx acpx-teams-monitor

使用 npm 全局安装

npm install -g acpx-teams-monitor
acpx-teams-monitor

从源码运行

git clone https://github.com/open-deep-crew/acpx-teams-monitor.git
cd acpx-teams-monitor
npm install
npm run dev

打开浏览器访问 http://localhost:7201（生产模式）或 http://localhost:5173（开发模式）。

命令行参数

acpx-teams-monitor [选项]

选项:
  -p, --port <port>      服务端口 (默认: 7201)
  --acpx-dir <path>      ACPX 数据目录 (默认: ~/.acpx)
  -h, --help             显示帮助信息

URL 查询参数

| 参数 | 说明 | 示例 | |------|------|------| | teamname | 直接打开指定团队 | ?teamname=my-team | | cwd | 按工作目录过滤团队 | ?cwd=/path/to/project |

两个参数可组合使用：?teamname=my-team&cwd=/path/to/project

前提条件

• Node.js 20+
• 本机已运行过 acpx-teams-mcp（数据存储在 ~/.acpx/ 目录）

数据源

从 ~/.acpx/ 目录读取 acpx-teams-mcp 写入的 JSON 文件（纯只读，不做任何写操作）：

| 数据 | 路径 | |------|------| | 团队配置 | ~/.acpx/teams/<team>/config.json | | 任务 | ~/.acpx/tasks/<team>/<id>.json | | 消息 | ~/.acpx/teams/<team>/inboxes/<agent>.json |

技术栈

• 后端: Node.js + Express + TypeScript
• 前端: React 19 + TypeScript + Vite + TailwindCSS + TanStack Query
• 测试: Vitest

开发

# 同时启动前后端（开发模式）
npm run dev

# 构建生产版本
npm run build

# 运行测试
npm test

# 生产模式启动
npm start

API

全部为 GET 端点，纯只读：

| 路径 | 说明 | |------|------| | GET /api/teams | 团队列表（支持 ?cwd= 过滤） | | GET /api/teams/:name/config | 团队完整配置 | | GET /api/teams/:name/tasks | 团队任务列表 | | GET /api/teams/:name/messages | 团队消息 |

License

MIT