内容
# 天才工作台社区版
适用于 n8n 自动化的开源指挥中心。管理多个实例，监控错误，使用 AI 辅助编写代码，并从单个仪表盘连接知识源。
## 为什么选择天才工作台社区版
为客户或多个团队运行 n8n 意味着要处理多个登录账户、分散的日志和没有统一的故障图景。天才工作台社区版是一个轻量级控制平面，可以将所有实例集中在一个地方。
## 截图
每个 n8n 实例都有一个仪表盘：实时统计数据、执行时间线和实时错误馈送。
| 执行和错误 | 洞察 |
|:---:|:---:|
|  |  |
| **代码实验室** | **AI 模型** |
|  |  |
| **Harness** | **容器** |
|  |  |
## 包含内容
**多实例管理**
- 通过 URL 和 API 密钥添加任意数量的 n8n 实例
- 实例间快速切换
- 在一个地方查看所有工作流、最近的执行和错误历史
**错误可见性**
- 跨所有实例的实时错误馈送
- 按工作流、节点和错误类型分组的错误，附带出现次数
- 完整的节点级详细信息和最近一次查看的时间戳
**代码实验室**
- 用于编写 n8n Code-node 逻辑的 Monaco 基础编辑器
- 语法高亮、自动补全和 n8n 节点内省
- AI 辅助生成或解释代码
- 一键“发送到 n8n”直接部署
**AI 助手**
- 与来自工作流和错误历史的上下文聊天
- 支持 OpenRouter、OpenAI、Anthropic 或本地 Ollama
- 调用函数查询工作流、运行执行、查看错误
- 附加 MCP 服务器以使用外部工具扩展助手
- 与 [n8n-mcp](https://github.com/czlonkowski/n8n-mcp) 配合良好，czlonkowski 的 MCP 服务器为助手提供深入的 n8n 节点知识以及工作流搜索、验证和创建/更新工具（在“设置”>“MCP 服务器”下添加）
- 通过 Qdrant 可选地进行知识源的 RAG
**知识管理**
- 注册外部知识源（markdown 文件、API、文档）
- 编写和组织带有全文搜索和反向链接的 markdown 笔记
- 与 Obsidian 兼容的文件夹树结构
- 基于标签的组织和导航
**容器管理**
- 直接从仪表盘列出、检查和管理 Docker 容器
- 使用一键式模板部署新服务
- 社区模板库（将 JSON 文件放入 `data/templates/`）
- 工作流导入、导出和备份
**秘密存储**
- Fernet 加密的凭证存储
- 在实例 API 密钥和 MCP 服务器配置中引用秘密为 `$VAR_NAME`
- 解析顺序：首先是环境变量，然后是加密存储
**通知**
- 用于显示为 toast 消息的仪表盘的入站 webhook
- 可选的 Slack 和 Discord 集成（SLACK_WEBHOOK_URL，DISCORD_WEBHOOK_URL）
- 代码中没有嵌入 API 密钥
**洞察**
- 执行分析：成功率、错误趋势、最繁忙的工作流
- 每个实例的健康状态
**主题和音乐**
- 3 种内置主题（暗色、亮色、n8n）以及自定义主题支持
- 集成音乐播放器（Spotify、YouTube、SoundCloud、Apple Music、Tidal）
## 快速入门
### Docker（推荐）
```bash
git clone https://github.com/Mfrostbutter/ageniusdesk-ce.git
cd ageniusdesk-ce
cp .env.example .env
docker compose up -d --build
```
打开 http://localhost:3000。设置向导将指导您添加第一个 n8n 实例。
### 裸金属
需要 Python 3.10 或更高版本。
```bash
git clone https://github.com/Mfrostbutter/ageniusdesk-ce.git
cd ageniusdesk-ce
pip install '.[assistant]'
cp .env.example .env
python -m uvicorn backend.main:app --host 0.0.0.0 --port 3000
```
## 配置
通过环境变量和 `.env` 文件控制配置。完整的参考资料位于 [docs/CONFIG.md](docs/CONFIG.md)。
关键变量：
- `PORT` - 仪表盘端口（默认为 3000）
- `SECRET_KEY` - 机密加密的主密钥（如果未设置，则自动生成）
- `ANTHROPIC_KEY`、`OPEN_AI_KEY`、`OPEN_ROUTER_KEY`、`OLLAMA_URL` - AI 提供商凭证
- `QDRANT_URL`、`QDRANT_API_KEY` - 可选的 Qdrant RAG 后端
- `SLACK_WEBHOOK_URL`、`DISCORD_WEBHOOK_URL` - 可选的通知接收器
参见 [docs/CONFIG.md](docs/CONFIG.md) 获取所有选项。
## 错误处理程序设置
将您的 n8n 实例连接到实时向仪表盘报告故障。
**一键式（推荐）**：连接实例后，打开 **设置 > 错误处理程序 > 安装到活动实例**。这会导入并激活全局错误处理工作流（预填充仪表盘 URL）。然后执行 n8n 要求的一步：**设置 > 工作流 > 错误工作流** 并选择导入的工作流。为每个实例重复安装。
**手动**：从同一选项卡下载工作流 JSON（或 `backend/n8n_workflows/global-error-handler.json`），通过 **工作流 > 从文件导入** 在 n8n 中导入，将 HTTP 请求节点指向 `http://your-dashboard:3000/api/errors/webhook`，然后选择它作为错误工作流并激活。
## 安全注意事项
**身份验证**：天才工作台现在默认强制执行本地帐户登录。首次访问时，创建所有者帐户并保持 `AGD_DISABLE_LOGIN=false` 以适用于任何共享或公共部署。只有当应用仅通过受信任的代理可访问时，才信任 edge-auth 头；仅在应用仅通过受信任的代理可访问时启用 `AGD_TRUST_EDGE_AUTH=true`。
**秘密**：加密的秘密存储使用 Fernet（AES-128-CBC + HMAC-SHA256）。主密钥存储在 `data/.secret_key`（模式 600）。请将此文件与数据卷一起备份。丢失它将使所有加密值无法恢复。
**机器端点**：新集成应使用 `/api/v1/...` 和天才工作台 API 密钥。如果公开旧版 `/api/errors/webhook` 或 `/api/messages/webhook` 端点，请设置 `AGD_WEBHOOK_TOKEN`。
**社区模块**：社区模块可以从 `data/modules/` 加载和执行 Python 代码。仅从受信任的来源安装模块。
## 文档
完整文档位于 [docs/](docs/README.md)：面向任务的 **用户指南**（入门、实例、错误、代码实验室、AI 助手、秘密等）和 **架构和开发者参考**（模块系统、数据模型、身份验证/RBAC、前端、API、安全态势）。
## 部署
有关生产自托管，请参见 [docs/DEPLOY.md](docs/DEPLOY.md)，了解：
- 先决条件和系统要求
- TLS 设置和反向代理配置
- 身份验证姿态（内置或通过身份验证代理）
- 数据卷备份和恢复
- 更新工作流
## 贡献
欢迎贡献。请参见 [CONTRIBUTING.md](CONTRIBUTING.md) 获取开发设置、lint 和贡献指南。
## 路线图
请参见 [ROADMAP.md](ROADMAP.md) 获取计划功能和当前方向。
## 许可证
天才工作台社区版采用 MIT 许可证。请参见 [LICENSE](LICENSE) 获取详细信息。
## 致谢
- [n8n-mcp](https://github.com/czlonkowski/n8n-mcp) by [czlonkowski](https://github.com/czlonkowski)：我们推荐将 n8n-mcp 与 AI 助手配对，以获取深入的节点知识和工作流工具。
- [n8n](https://n8n.io)：天才工作台管理的 workflow 自动化引擎。
MCP 市场