Base URL: http://localhost:9335
Project: /ai_future_vision

================================================================================
[auth] auth_login
================================================================================
auth_login - 管理员登录
URI: POST /ai_future_vision/api/auth/login
模块: auth

请求参数:
- username (string, 必填): 管理员用户名
- password (string, 必填): 管理员密码

请求示例:
POST /ai_future_vision/api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "admin123"
}

成功响应:
{
  "code": 0,
  "msg": "登录成功"
}

失败响应:
{
  "code": 1,
  "msg": "用户名或密码错误"
}

说明: 登录成功后通过 session 维持认证状态。

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文auth_login - 管理员登录（集中认证）
URI: POST /ai_future_vision/api/auth/login
模块: auth

说明: 通过集中认证服务 (fly_admin_login_service) 验证管理员身份。
登录成功后返回 JWT token 并写入浏览器 Cookie。

请求参数:
- username (string, 必填): 管理员用户名
- password (string, 必填): 管理员密码

请求示例:
POST /ai_future_vision/api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "***"
}

成功响应:
{
  "code": 0,
  "msg": "登录成功"
}

失败响应:
{
  "code": 1,
  "msg": "用户名或密码错误"
}

认证服务不可用:
{
  "code": 1,
  "msg": "认证服务不可用: ..."
}

说明: 认证凭据由集中认证服务统一管理，本站不再存储管理员密码。
登录成功后会设置 admin_jwt Cookie，后续请求自动携带该 Cookie 进行身份验证。

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文
auth_login - 管理员登录
URI: POST /ai_future_vision/api/auth/login
模块: auth

请求参数:
- username (string, 必填): 管理员用户名
- password (string, 必填): 管理员密码

请求示例:
POST /ai_future_vision/api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "admin123"
}

成功响应:
{
  "code": 0,
  "msg": "登录成功"
}

失败响应:
{
  "code": 1,
  "msg": "用户名或密码错误"
}

说明: 登录成功后通过 session 维持认证状态。

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文


================================================================================
[auth] auth_logout
================================================================================
auth_logout - 退出登录
URI: POST /ai_future_vision/api/auth/logout
模块: auth

请求参数: 无需参数（发送空JSON即可）

请求示例:
POST /ai_future_vision/api/auth/logout
Content-Type: application/json

{}

响应示例:
{
  "code": 0,
  "msg": "已退出登录"
}

说明: 清除当前 session 中的登录状态。

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文auth_logout - 退出登录
URI: POST /ai_future_vision/api/auth/logout
模块: auth

请求参数: 无需参数（发送空JSON即可）

请求示例:
POST /ai_future_vision/api/auth/logout
Content-Type: application/json

{}

响应示例:
{
  "code": 0,
  "msg": "已退出登录"
}

说明: 清除当前 session 中的登录状态，同时删除 admin_jwt Cookie。
退出后需重新通过集中认证服务登录。

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文
auth_logout - 退出登录
URI: POST /ai_future_vision/api/auth/logout
模块: auth

请求参数: 无需参数（发送空JSON即可）

请求示例:
POST /ai_future_vision/api/auth/logout
Content-Type: application/json

{}

响应示例:
{
  "code": 0,
  "msg": "已退出登录"
}

说明: 清除当前 session 中的登录状态。

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文


================================================================================
[vision] vision_create
================================================================================
vision_create - 创建新的未来认知
URI: POST /ai_future_vision/api/vision/create
模块: vision
权限: 需要登录 或 create_api_key 认证（安全级别1/2）

认证方式（二选一）:
- 方式1: 管理后台 session 登录
- 方式2: 提供 create_api_key（与 config.yml 中配置一致）
  - Header: X-API-Key: <your_create_api_key>
  - 或 Form 参数: api_key=<your_create_api_key>

请求方式: multipart/form-data

请求参数:
- title (string, 必填): 未来认知标题
- tags (string, 可选): 标签，逗号分隔，如 "AI, 未来, 协作"
- site_zip (file, 可选): 静态网站 ZIP 文件，需包含 index.html
- api_key (string, 可选): create_api_key 认证（若未通过 Header 传递）

请求示例:
POST /ai_future_vision/api/vision/create
Content-Type: multipart/form-data
X-API-Key: rrtaaaddd

title=AI协作未来&tags=AI,未来&site_zip=<zip文件>

响应示例:
{
  "code": 0,
  "msg": "创建成功",
  "data": {
    "id": "a3f2c1",
    "title": "AI协作未来",
    "tags": ["AI", "未来"],
    "created_at": "2026-05-28T10:00:00",
    "updated_at": "2026-05-28T10:00:00"
  }
}

错误响应:
{
  "code": 1,
  "msg": "标题不能为空"
}

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文


================================================================================
[vision] vision_delete
================================================================================
vision_delete - 删除未来认知
URI: POST /ai_future_vision/api/vision/delete
模块: vision
权限: 需要登录（安全级别2）

请求参数:
- id (string, 必填): 要删除的未来认知ID（6位hex）

请求示例:
POST /ai_future_vision/api/vision/delete
Content-Type: application/json

{
  "id": "a3f2c1"
}

响应示例:
{
  "code": 0,
  "msg": "删除成功"
}

错误响应:
{
  "code": 1,
  "msg": "未找到该记录"
}

注意: 删除操作将同时删除对应的静态网站文件，不可撤销。

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文


================================================================================
[vision] vision_detail
================================================================================
vision_detail - 获取未来认知详情
URI: POST /ai_future_vision/api/vision/detail
模块: vision

请求参数:
- id (string, 必填): 未来认知ID（6位hex）

请求示例:
POST /ai_future_vision/api/vision/detail
Content-Type: application/json

{
  "id": "a3f2c1"
}

响应示例:
{
  "code": 0,
  "data": {
    "id": "a3f2c1",
    "title": "AI 协作未来",
    "tags": ["AI", "协作"],
    "created_at": "2026-05-28T10:00:00",
    "updated_at": "2026-05-28T10:00:00"
  }
}

错误响应:
{
  "code": 1,
  "msg": "未找到该记录"
}

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文


================================================================================
[vision] vision_list
================================================================================
vision_list - 获取所有未来认知列表
URI: POST /ai_future_vision/api/vision/list
模块: vision

请求参数: 无需参数（发送空JSON即可）

请求示例:
POST /ai_future_vision/api/vision/list
Content-Type: application/json

{}

响应示例:
{
  "code": 0,
  "data": [
    {
      "id": "a3f2c1",
      "title": "AI 协作未来",
      "tags": ["AI", "协作"],
      "created_at": "2026-05-28T10:00:00",
      "updated_at": "2026-05-28T10:00:00"
    }
  ]
}

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文


================================================================================
[vision] vision_update
================================================================================
vision_update - 更新未来认知
URI: POST /ai_future_vision/api/vision/update
模块: vision
权限: 需要登录（安全级别2）

请求方式: multipart/form-data

请求参数:
- id (string, 必填): 未来认知ID（6位hex）
- title (string, 可选): 新标题
- tags (string, 可选): 新标签，逗号分隔
- site_zip (file, 可选): 新的静态网站 ZIP 文件（上传后替换原有文件）

请求示例:
POST /ai_future_vision/api/vision/update
Content-Type: multipart/form-data

id=a3f2c1&title=新标题&tags=标签1,标签2

响应示例:
{
  "code": 0,
  "msg": "更新成功",
  "data": {
    "id": "a3f2c1",
    "title": "新标题",
    "tags": ["标签1", "标签2"],
    "created_at": "2026-05-28T10:00:00",
    "updated_at": "2026-05-28T11:00:00"
  }
}

错误响应:
{
  "code": 1,
  "msg": "未找到该记录"
}

GET 访问: 返回本接口简介
GET ?api 访问: 返回本文档全文