Open ACE - 企业级 AI 工作平台

ACE = AI Computing Explorer（AI 计算探索器）

本文档提供了 Open ACE 的定位、核心功能和快速入门的简要概述。

项目定位

Open ACE 是一个企业级 AI 工作平台，旨在帮助组织高效地追踪、分析、管理和治理 AI 工具使用情况。它不仅仅是一个 Token 追踪器——而是一个全面的平台，连接了技术 AI 使用数据与业务决策之间的重要桥梁。

目标用户

用户类型	主要需求	平台功能
个人开发者	追踪个人使用情况、了解成本	工作模式仪表板、会话管理、提示库
团队负责人	监控团队使用情况、优化成本	分析、ROI 分析、配额管理
IT 管理员	用户管理、安全、合规	用户/租户管理、SSO、审计日志、合规控制
高管层	成本监督、ROI 衡量、战略决策	使用分析、趋势分析、ROI 报告

核心能力

1. 多工具 Token 追踪

支持主要 AI 工具的自动日志解析：

工具	收集数据
Claude	Token 使用量、请求次数、模型、输入/输出明细
Qwen	Token 使用量、请求次数、缓存使用量、模型
OpenClaw	Agent 会话数据、工具调用、对话历史

主要功能：

通过定时脚本自动收集数据
按工具、主机、用户进行细分
输入/输出 Token 追踪以优化成本
请求计数用于 API 配额管理

2. 双模式界面

Open ACE 根据用户角色提供两个不同的界面：

工作模式 (`/work/*`) - 适用于所有用户

工作空间：交互式 AI 工具界面
会话：查看和管理对话历史
提示：保存、组织和重用提示模板
仪表板：个人使用情况概览

管理模式 (`/manage/*`) - 适用于管理员

仪表板：团队/组织范围的统计数据
分析：趋势分析、异常检测、ROI 计算
消息：高级过滤和搜索
用户管理：创建、编辑、删除用户
租户管理：多租户组织结构
审计中心：全面的审计日志和分析
安全中心：内容过滤、访问控制
合规性：数据保留、报告

3. 高级分析

使用分析

每日/每周/每月使用趋势
显示使用模式的热力图
工具对比图表
模型使用细分

异常检测

识别异常使用模式
监控请求失败率
非工作时间活动警报
自动异常报告

ROI 分析

每次对话的成本
Token 效率指标
工具 ROI 计算
预算与实际支出对比

4. 企业治理

配额管理

每用户每日/每月 Token 配额
每日/每月请求配额
警报阈值（80% 警告，95% 严重）
实时配额状态监控

用户与租户管理

基于角色的访问控制（管理员、经理、用户）
多租户组织支持
团队协作功能
权限精细化

安全与合规

SSO/SAML 集成（OIDC、OAuth2）
全面的审计日志
内容过滤
数据保留策略
符合 GDPR 的数据导出

5. 工作空间与工具集成

统一工具连接器

工具健康监控：所有 AI 工具的实时状态
工具注册：动态工具发现和注册
功能检测：自动检测工具功能（流式传输、视觉、工具）
模型映射：每个工具支持多个模型

状态同步

会话持久化：保存并恢复对话
状态恢复：重新连接时自动恢复会话状态
跨设备同步：在不同设备上继续工作
标签管理：在工作空间内管理多个对话标签

工作空间配置

工作空间可以配置为连接到各种 AI 工具服务：

{
  "workspace": {
    "enabled": true,
    "url": "http://localhost:3000",
    "tool_urls": {
      "openclaw": "http://localhost:3001",
      "claude": "http://localhost:3002",
      "qwen": "http://localhost:3003"
    }
  }
}

提示库

模板分类：通用、编码、写作、分析、翻译、摘要
变量支持：模板变量用于动态内容
标签系统：使用自定义标签组织提示
使用追踪：查看最常用的提示
公开/私有共享：在团队内共享或保持私有
精选提示：突出显示推荐的模板

协作功能

会话共享：与团队成员共享对话
提示库：集中式提示存储库
团队工作空间：共享工作环境
协作注释：为对话添加注释

架构概述

┌─────────────────────────────────────────────────────────────┐
│                      数据收集层                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │ fetch_claude│  │ fetch_qwen  │  │fetch_openclaw│         │
│  │   (日志)    │  │   (日志)    │  │   (日志)    │         │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘         │
│         │                │                │                 │
│         └────────────────┼────────────────┘                 │
│                          ▼                                  │
│                  ┌─────────────────┐                        │
│                  │   数据库        │                        │
│                  │ (SQLite/PostgreSQL)                     │
│                  └─────────────────┘                        │
└─────────────────────────────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                    应用层                                    │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   路由       │  │  服务       │  │  模块       │         │
│  │  (API)      │  │ (业务逻辑)  │  │ (核心)      │         │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘         │
│         │                │                │                 │
│         └────────────────┼────────────────┘                 │
│                          ▼                                  │
│                  ┌─────────────────┐                        │
│                  │   Flask 应用   │                        │
│                  └─────────────────┘                        │
└─────────────────────────────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                      表现层                                  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   Web UI    │  │    CLI      │  │   API       │         │
│  │ (React)     │  │  (Python)   │  │ (REST)      │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
└─────────────────────────────────────────────────────────────┘

技术栈

层级	技术
后端	Python 3.9+, Flask
前端	React 18, TypeScript, Bootstrap 5, Chart.js
数据库	SQLite (开发), PostgreSQL (生产)
构建	Vite, TypeScript
测试	pytest, Playwright, Vitest
认证	基于会话, OIDC, OAuth2

快速入门

安装

# 克隆仓库
git clone https://github.com/open-ace/open-ace.git
cd open-ace

# 安装 Python 依赖
pip install -r requirements.txt

# 初始化配置
python3 cli.py config init

配置

编辑 ~/.open-ace/config.json：

{
  "host_name": "my-server",
  "tools": {
    "claude": { "enabled": true, "log_path": "~/.claude/projects" },
    "qwen": { "enabled": true, "log_path": "~/.qwen/projects" },
    "openclaw": { "enabled": true, "log_path": "~/.openclaw/agents" }
  },
  "email": {
    "smtp_host": "smtp.example.com",
    "smtp_port": 587,
    "sender": "noreply@example.com"
  }
}

启动服务器

# 启动 Web 服务器
python3 server.py

# 访问 http://localhost:5000
# 默认登录：admin / admin123

收集数据

# 从所有工具收集
python3 scripts/fetch_claude.py
python3 scripts/fetch_qwen.py
python3 scripts/fetch_openclaw.py

# 或设置 cron 进行自动收集
crontab -e
# 添加：30 0 * * * cd /path/to/open-ace && python3 scripts/fetch_*.py

CLI 命令

# 查看使用统计
python3 cli.py today        # 今天的使用情况
python3 cli.py today --tool qwen   # 特定工具今天的使用情况
python3 cli.py today --host myserver  # 特定主机的使用情况

python3 cli.py top          # 最近 7 天的使用情况
python3 cli.py top --days 14  # 最近 14 天
python3 cli.py summary      # 总结

# 生成报告
python3 cli.py report       # 生成邮件报告
python3 cli.py report --email user@example.com  # 发送到特定地址

API 端点

方法	端点	描述
GET	`/api/summary`	使用情况摘要
GET	`/api/today`	今天的使用情况
GET	`/api/messages`	带过滤的消息
GET	`/api/analysis/trend`	使用趋势
GET	`/api/analysis/anomaly`	异常检测
GET	`/api/analysis/roi`	ROI 分析
GET	`/api/users`	用户列表 (管理员)
POST	`/api/users`	创建用户 (管理员)
GET	`/api/tenants`	租户列表 (管理员)
GET	`/api/sessions`	会话列表
GET	`/api/prompts`	提示库

部署选项

单机（个人/小型团队）

# 所有组件在同一台机器上
python3 server.py          # Web 服务器
python3 cli.py config init  # 配置
crontab -e              # 定时数据收集

Docker（生产环境）

# 使用 Docker Compose 部署
docker compose up -d

# 管理服务
docker compose ps
docker compose logs -f
docker compose restart

中心服务器 + 远程收集器（企业）

┌───────────────────────┐       ┌───────────────────────┐
│   中心服务器           │       │    远程机器           │
│  ┌─────────────────┐  │       │  ┌─────────────────┐  │
│  │   server.py        │  │       │  │ fetch_openclaw  │  │
│  │   (仪表板)      │  │       │  │                 │  │
│  └────────┬────────┘  │       │  └────────┬────────┘  │
│           │           │       │           │           │
│           ▼           │       │           ▼           │
│  ┌─────────────────┐  │       │  ┌─────────────────┐  │
│  │   PostgreSQL    │◄─┼───────┼──│   SQLite        │  │
│  │   (中心)        │  │上传   │  │   (远程)        │  │
│  └─────────────────┘  │       │  └─────────────────┘  │
└───────────────────────┘       └───────────────────────┘

核心概念

概念	描述	示例
请求 (Request)	对 LLM 的单次 API 调用	用户消息 → 1 个请求
消息 (Message)	按角色划分的单条消息	user, assistant, toolResult
对话 (Conversation)	一轮对话	用户发送 → AI 回复
会话 (Session)	工具级别的会话	qwen 代码进程生命周期

关系：会话 → 对话 → 请求 + 消息

快速参考

默认登录凭据

用户名: admin
密码: admin123

重要：首次登录后立即更改！

默认端口

服务	端口	URL
Web 服务器	5000	http://localhost:5000
工作空间（如启用）	3000	http://localhost:3000

配置位置

配置文件: ~/.open-ace/config.json
数据库: ~/.open-ace/usage.db (SQLite) 或 PostgreSQL
日志: ~/logs/open-ace/

数据流

┌─────────────────────────────────────────────────────────────┐
│                    用户操作                                  │
│  • 向 AI 工具发送消息                                        │
│  • 使用提示模板                                              │
│  • 共享会话                                                  │
│  • 查询使用数据                                              │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                  AI 工具日志                                 │
│  • Claude: ~/.claude/projects/*.json                        │
│  • Qwen: ~/.qwen/projects/*.json                            │
│  • OpenClaw: ~/.openclaw/agents/*.json                      │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│              数据收集（定时）                                │
│  • fetch_claude.py                                          │
│  • fetch_qwen.py                                            │
│  • fetch_openclaw.py                                        │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                  数据库层                                    │
│  • daily_usage: 聚合的 Token 统计                           │
│  • daily_messages: 单条消息记录                             │
│  • sessions: 对话会话                                       │
│  • prompts: 提示模板                                        │
│  • users: 用户账户和配额                                    │
│  • audit_logs: 系统活动日志                                 │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                  应用层                                      │
│  • API 路由: REST 端点                                       │
│  • 服务: 业务逻辑                                            │
│  • 模块: 核心功能                                            │
│  • 仓库: 数据访问                                            │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                  表现层                                      │
│  • Web UI: React 仪表板                                      │
│  • CLI: 命令行查询                                           │
│  • 邮件: 自动报告                                            │
└─────────────────────────────────────────────────────────────┘

数据库模式

核心表

表名	用途	关键字段
`daily_usage`	Token 使用统计	date, tool_name, host_name, tokens_used, input_tokens, output_tokens
`daily_messages`	单条消息	message_id, role, content, tokens_used, sender_id, conversation_id
`sessions`	对话会话	session_id, session_type, status, created_at, tool_name
`prompts`	提示模板	name, category, content, variables, is_public, use_count
`users`	用户账户	username, email, role, is_active, daily_token_quota
`audit_logs`	系统活动	action, user_id, timestamp, details
`quotas`	配额追踪	user_id, period, tokens_used, requests_made, quota_limit
`teams`	团队协作	team_id, name, owner_id, members

功能状态

✅ 已实现

多工具 Token 追踪（Claude、Qwen、OpenClaw）
带有交互式可视化的 Web 仪表板
用于快速查询的 CLI 工具
邮件报告生成
用户认证和基于角色的访问控制
配额管理和警报
SSO/SAML 集成（OIDC、OAuth2）
审计日志和合规功能
租户管理
提示库和会话管理
分析和 ROI 分析
异常检测
多语言支持（英语、中文）

🔄 进行中

高级协作功能
实时通知
移动端响应式改进

📋 计划中

Kubernetes 部署
高级工作流自动化
自定义报告构建器
AI 驱动的成本优化建议

文档

文档	用途
INTRO.md	本文档 - 快速概览和入门
ARCHITECTURE.md	系统架构和数据模型
CONCEPTS.md	核心概念和术语
DEPLOYMENT.md	部署指南（本地、Docker、企业）
DEVELOPMENT.md	开发设置和贡献指南
FEISHU_CONFIG.md	飞书集成配置

总结

Open ACE 是一个全面的企业 AI 工作平台，提供：

类别	功能
追踪	多工具 Token 使用、请求计数、输入/输出细分
分析	趋势、异常、ROI、热力图、对比
管理	用户、租户、配额、角色、权限
治理	审计日志、安全、合规、保留
协作	会话共享、提示库、团队工作空间
集成	SSO/SAML、工具连接器、状态同步

个人开发者：追踪个人使用情况和优化成本团队：监控使用情况、共享提示、协作会话企业：完整的治理、安全、合规和多租户支持

获取帮助

文档：查看 docs 目录获取详细指南
问题：在 GitHub 上报告 bug 或请求功能
贡献：参见 CONTRIBUTING.md 了解开发指南
许可证：Apache 2.0 - 可免费用于商业用途

为什么选择 Open ACE？

功能	Open ACE	自定义解决方案
设置时间	15 分钟	2-4 周
多工具	内置	自定义编码
分析	开箱即用	从头开始
治理	企业就绪	构建复杂
维护	活跃社区	需要完整团队
成本	免费 (Apache 2.0)	高总拥有成本

项目定位​

目标用户​

核心能力​

1. 多工具 Token 追踪​

2. 双模式界面​

工作模式 (/work/*) - 适用于所有用户​

管理模式 (/manage/*) - 适用于管理员​

3. 高级分析​

使用分析​

异常检测​

ROI 分析​

4. 企业治理​

配额管理​

用户与租户管理​

安全与合规​

5. 工作空间与工具集成​

统一工具连接器​

状态同步​

工作空间配置​

提示库​

协作功能​

架构概述​

技术栈​

快速入门​

安装​

配置​

启动服务器​

收集数据​

CLI 命令​

API 端点​

部署选项​

单机（个人/小型团队）​

Docker（生产环境）​

中心服务器 + 远程收集器（企业）​

核心概念​

快速参考​

默认登录凭据​

默认端口​

配置位置​

数据流​

数据库模式​

核心表​

功能状态​

✅ 已实现​

🔄 进行中​

📋 计划中​

文档​

总结​

获取帮助​

为什么选择 Open ACE？​