项目管理 API
项目路由聚合模块，整合所有项目相关的子路由。
基础路径
/projects子模块索引
所有子路由均挂载在 /projects 前缀下，通过 /:projectId 区分项目。
| 子模块 | 路径前缀 | 端点数 | 说明 | 文档 |
|---|---|---|---|---|
| 项目密钥 | /:projectId/secrets | 5 | 密钥的增删改查 + 密钥名称列表 | project-secrets |
| MCP 服务 | /:projectId/mcp | 1 | MCP 服务连通性检测 | mcp |
| 数据库 | /:projectId/data | 12 | 数据行 CRUD、批量操作、回收站、导入导出 | database |
| Collection | /:projectId/collections | 10 | Collection 元数据、Schema、字段管理 | collections |
| 知识库 | /:projectId/kb | 20 | 节点 CRUD、向量操作、边操作、标签、搜索 | knowledge-base |
| Release | /:projectId/releases | 13 | Release CRUD、版本管理、别名管理 | releases |
| 文件存储 | /storage/:projectId | 8 | 文件上传/下载/删除、签名 URL、文件夹 | storage |
| 定时任务 | /:projectId/schedules | - | 定时任务管理（独立文档） | - |
认证方式
所有子模块均使用 combinedAuth 中间件，支持以下认证方式：
- JWT Bearer Token - 通过
Authorization: Bearer <token>请求头 - API Key - 通过
Authorization: Bearer <api_key>请求头
权限校验
请求者必须满足以下条件之一：
- 是项目的所有者（
owner_user_id） - 是项目所属团队的活跃成员（
team_members中未被软删除）
部分写入操作还会额外检查写入权限（write / admin）。
源码
- 路由聚合：
apps/backend/src/routes/projects.ts