OpenAPI 令牌采用细粒度的 资源:操作 权限模型。每个令牌在创建时可以指定一组权限键，接口请求时会校验令牌是否拥有该路由所需的权限。
权限以逗号分隔的字符串存储，例如 cron:query,env:query,env:manage。
不携带任何权限字段或权限字段为空字符串时，令牌将自动使用默认安全权限集，不会继承全部权限。
新建令牌时若不指定 permissions 字段，将使用以下默认权限集（仅包含只读与低风险操作）：
| 权限键 | 说明 |
|---|
cron:query | 查询定时任务 |
env:query | 查询环境变量 |
env:manage | 管理环境变量 |
file:list | 列出文件目录 |
| 权限键 | 说明 | 默认启用 | 危险 |
|---|
cron:query | 查询、分页列表、获取标签和运行状态 | ✅ | — |
cron:manage | 创建、修改、删除定时任务及调整排序 | — | ⚠️ |
cron:run | 手动触发或终止定时任务的执行 | — | ⚠️ |
| 接口路径 | 方法 | 所需权限 |
|---|
/cron/v1/page | GET | cron:query |
/cron/v1/query | GET | cron:query |
/cron/v1/runningTasks | GET | cron:query |
/cron/v1/tagsList | GET | cron:query |
/cron/v1/create | POST | cron:manage |
/cron/v1/update | POST | cron:manage |
/cron/v1/delete | POST | cron:manage |
/cron/v1/order | POST | cron:manage |
/cron/v1/run | POST | cron:run |
/cron/v1/terminate | POST | cron:run |
| 权限键 | 说明 | 默认启用 | 危险 |
|---|
env:query | 查询、分页列表及获取环境变量详情 | ✅ | — |
env:manage | 创建、修改、删除、排序及批量导入导出 | ✅ | — |
| 接口路径 | 方法 | 所需权限 |
|---|
/env/v1/page | GET | env:query |
/env/v1/query | GET | env:query |
/env/v1/queryMember | GET | env:query |
/env/v1/queryById | GET | env:query |
/env/v1/tags | GET | env:query |
/env/v1/create | POST | env:manage |
/env/v1/update | POST | env:manage |
/env/v1/delete | POST | env:manage |
/env/v1/order | POST | env:manage |
/env/v1/changeStatus | POST | env:manage |
| 权限键 | 说明 | 默认启用 | 危险 |
|---|
file:list | 获取目录列表、文件树和文件属性 | ✅ | — |
file:read | 读取任意文件内容及下载文件 | — | ⚠️ |
file:write | 创建、修改、重命名、移动、删除文件 | — | ⚠️ |
| 接口路径 | 方法 | 所需权限 |
|---|
/file/v1/list | GET | file:list |
/file/v1/info | GET | file:list |
/file/v1/content | GET | file:read |
/file/v1/download | GET | file:read |
/file/v1/content | POST | file:write |
/file/v1/rename | POST | file:write |
/file/v1/move | POST | file:write |
/file/v1/create | POST | file:write |
/file/v1/delete | POST | file:write |
/file/v1/upload | POST | file:write |
| 权限键 | 说明 | 默认启用 | 危险 |
|---|
exec:cmd | 执行 Shell 命令 | — | ⚠️ |
exec:file | 运行指定路径的代码代码文件 | — | ⚠️ |
exec:status | 查询命令或代码文件的当前运行状态 | — | ⚠️ |
| 接口路径 | 方法 | 所需权限 |
|---|
/exec/v1/cmd | POST | exec:cmd |
/exec/v1/cmd/stream | POST | exec:cmd |
/exec/v1/file | POST | exec:file |
/exec/v1/file/stream | POST | exec:file |
/exec/v1/file/stop | POST | exec:file |
/exec/v1/status | GET | exec:status |
危险权限（⚠️）在创建令牌时默认禁用，需显式传入权限键方可启用。请仅在必要时授予，并严格控制令牌的分发范围。
