Valtheron/valtheron-agentic-workspace
GitHub: Valtheron/valtheron-agentic-workspace
一款用于管理、监控和协调多领域自主 AI Agent 的统一编排与管控平台。
Stars: 1 | Forks: 0
# Valtheron — Agentic Workspace
编排自主 AI Agent 的核心平台
## 愿景
**Valtheron Agentic Workspace** 是一个用于管理、监控和协调**专业 AI Agent** 的生产级 Web 平台 —— 通过一个仪表板进行管理，标准集包含 **200 个 AI Agent**，高级开发者集包含 **290 个专业 AI Agent**。
该平台本身不是 AI 系统，而是自主 AI 操作的**控制室**：具备实时监控、紧急 Kill-Switch、加密 Secrets Vault 和完整的 Audit-Trail。
[](https://github.com/Valtheron/valtheron-agentic-workspace/actions/workflows/ci.yml)
[](CHANGELOG.md)
[](LICENSE)
[](docs/DEVELOPER_GUIDE.md)
[](docs/DEVELOPER_GUIDE.md)
[](https://www.typescriptlang.org/)
[](https://reactjs.org/)
[](docker-compose.yml)
[快速开始](#schnellstart) · [文档](#dokumentation) · [架构](#architektur) · [参与贡献](#mitmachen) · [赞助商](#sponsoren)
## 关于发起人
本项目由 **[BlackIce Secure Inc.](https://blackice-secure.space/)** 发起 —— 这是一家在自然语言处理、网络安全以及企业和机构 AI 开发领域提供专业解决方案的领先供应商。
## 什么是 Agentic Workspace？
**Valtheron Agentic Workspace** 是一个用于管理、监控和协调**专业 AI Agent** 的生产级 Web 平台 —— 通过一个仪表板进行管理，标准集包含 **200 个 AI Agent**，高级开发者集包含 **290 个专业 AI Agent**。
该平台本身不是 AI 系统，而是自主 AI 操作的**控制室**：具备实时监控、紧急 Kill-Switch、加密 Secrets Vault 和完整的 Audit-Trail。
## 功能
### 核心特性
| 功能 | 描述 |
|---|---|
| **Agent 管理** | 10 个类别中的 290 个预定义 Agent —— CRUD、状态、个性档案 |
| **看板** | 具有 5 列的任务管理：Backlog → In Progress → Review → Done → Archived |
| **实时聊天** | 通过 Anthropic、OpenAI 或 Ollama 与 Agent 直接沟通 |
| **分析仪表板** | 6 个指标标签页：趋势、吞吐量、错误、容量、SLA、成功率 |
| **Kill-Switch** | 立即停止所有正在运行的操作 —— 手动或自动触发 |
| **Secrets Vault** | AES-256-GCM 加密的 Key-Value 存储，支持密钥轮换 |
| **MFA 认证** | 通过验证器 App 进行 TOTP + 8 个备用代码 |
| **自动备份** | 每 6 小时一次，最多 10 次轮换，RTO < 5 分钟 |
| **Workflow 引擎** | 具有执行历史记录的顺序和并行 Workflow |
| **Audit-Trail** | 完整的活动日志记录，支持 CSV 导出 |
### Agent 类别
```
Trading (30) Security (30) Development (30) QA (30)
Documentation Deployment Analyst (30) Support (20)
Integration (20) Monitoring (30)
```
### 技术栈
| 领域 | 技术 |
|---|---|
| **后端** | Express 5.1 · TypeScript 5.9 · SQLite (WAL) |
| **前端** | React 19 · Vite 7.3 · TailwindCSS · shadcn/ui |
| **实时通信** | WebSocket (ws) |
| **认证** | JWT · TOTP (MFA) · RBAC (Admin / Operator / Viewer) |
| **LLM 集成** | Anthropic Claude · OpenAI · Ollama |
| **基础设施** | Docker Compose · GitHub Actions CI/CD |
## 快速开始
### 前置条件
- [Node.js](https://nodejs.org/) 22+
- [Docker](https://www.docker.com/) & Docker Compose (推荐)
- 可选：用于 LLM 聊天的 Anthropic 或 OpenAI API Key
### 选项 1 — Docker Compose (推荐)
```
# 克隆 Repository
git clone https://github.com/Valtheron/valtheron-agentic-workspace.git
cd valtheron-agentic-workspace
# 配置 Umgebungsvariablen
cp backend/.env.example backend/.env
# 调整 .env：JWT_SECRET、ANTHROPIC_API_KEY 等
# 启动
docker-compose up -d
# 打开 Dashboard
open http://localhost:8080
```
### 选项 2 — 本地开发
```
# 克隆 Repository
git clone https://github.com/Valtheron/valtheron-agentic-workspace.git
cd valtheron-agentic-workspace
# 安装 Abhängigkeiten
npm run install:all
# 配置 Umgebungsvariablen
cp backend/.env.example backend/.env
# 并行启动 Backend + Frontend
npm run dev
# Backend: http://localhost:3001
# Frontend: http://localhost:5173
```
### 首次登录
启动后默认未创建任何用户。请在 `http://localhost:8080` 注册。第一个用户将自动获得管理员权限。
## 架构
```
┌─────────────────────────────────────────────────────┐
│ React Frontend │
│ 19 Views · shadcn/ui · TailwindCSS · WebSocket │
└────────────────────┬────────────────────────────────┘
│ REST API + WebSocket
┌────────────────────▼────────────────────────────────┐
│ Express Backend │
│ 14 API-Module · 10 Services · 6 Middleware-Module │
│ JWT Auth · RBAC · Rate Limiting · Audit Logger │
└────────────────────┬────────────────────────────────┘
│
┌────────────────────▼────────────────────────────────┐
│ SQLite (WAL-Modus) │
│ 17 Tabellen · 23 Indexes │
└─────────────────────────────────────────────────────┘
```
完整架构文档：[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
## 文档
| 文档 | 描述 |
|---|---|
| [用户指南](docs/USER_GUIDE.md) | 用户手册 —— 解释所有功能 |
| [API 文档](docs/API.md) | 88 个 Endpoint 及示例 |
| [部署指南](docs/DEPLOYMENT_GUIDE.md) | Docker, Nginx, PM2, Bare Metal |
| [开发者指南](docs/DEVELOPER_GUIDE.md) | 开发者工作流、代码规范、测试 |
| [管理员指南](docs/ADMIN_GUIDE.md) | 系统管理、监控 |
| [架构](docs/ARCHITECTURE.md) | 系统架构、数据模型、ADR |
| [故障排除](docs/TROUBLESHOOTING_GUIDE.md) | 常见问题及解决方案 |
| [更新日志](CHANGELOG.md) | 版本历史 |
| [发布说明 v1.0.0](RELEASE_NOTES.md) | Genesis Release 亮点 |
## 安全
本项目按照 **OWASP Top 10** 开发并经过审核：
- 敏感数据采用 AES-256-GCM 加密
- JWT 具有可配置的过期时间
- TOTP 多因素认证
- Rate Limiting（滑动窗口，Auth Endpoint 限制为 20 req/60s）
- 所有安全相关事件的完整 Audit-Trail
- 35+ 自动化安全测试（SQL 注入、XSS、CSRF、Auth Bypass）
- 通过 GitHub Actions 进行 SAST 扫描
请通过[安全策略](.github/SECURITY.md)报告安全漏洞。
## 测试
```
# Backend-Tests
cd backend && npm test
# Frontend-Tests
cd frontend && npm test
# 带 Coverage-Report
cd backend && npm run test:coverage
```
| 类别 | 数量 | 覆盖率 |
|---|---|---|
| 后端单元测试 | 280+ | 87.8% Lines |
| 前端单元测试 | 98 | ~70% Lines |
| 集成测试 | 35 | — |
| 性能测试 | 27 | — |
| 安全测试 | 35+ | — |
| **总计** | **475+** | |
## 路线图
| 版本 | 状态 | 亮点 |
|---|---|---|
| **v1.0.0** | 已发布 | Genesis Release —— 完整功能集 |
| **v1.1.0** | 2026 年 Q2 | PostgreSQL 迁移，可选 Redis 缓存 |
| **v1.2.0** | 2026 年 Q3 | Kubernetes 支持，短信 MFA |
| **v2.0.0** | 2026 年 Q4 | 国际化 (EN/DE)，企业 SSO |
## 许可证
本项目基于 **MIT 许可证** —— 详情见 [LICENSE](LICENSE)。
```
Copyright (c) 2026 Valtheron / BlackIceSecure
```
**Valtheron Agentic Workspace** — 为自主操作而生
[网站](https://valtheron.github.io/valtheron-agentic-workspace) · [Issues](https://github.com/Valtheron/valtheron-agentic-workspace/issues) · [讨论区](https://github.com/Valtheron/valtheron-agentic-workspace/discussions)
标签：Agentic Workspace, AI安全, AI编排平台, API集成, Chat Copilot, DLL 劫持, DNS解析, Docker, FTP漏洞扫描, Go, HTTP工具, IP 地址批量处理, MIT许可, PE 加载器, PyRIT, Python, React, Ruby工具, SOAR, Syscalls, TypeScript, 中间件, 仪表盘, 任务自动化, 低代码, 可观测性, 多智能体系统, 大语言模型, 安全插件, 安全编排, 安全防御评估, 审计日志, 工作流引擎, 库, 应急响应, 开源项目, 微服务架构, 无后门, 网络安全, 网络安全审计, 自动化攻击, 自动化运维, 请求拦截, 金融交易, 隐私保护