Mod 制作与开放生态 / 开放生态

开放 API(ai_open)

已验证Web · 已验证代码更新于 2026-10-28

把对话与业务能力以开放接口暴露给企业自有系统,配套能力闭环测试。

功能价值

把对话与业务能力以开放接口暴露给企业自有系统,配套能力闭环测试。

使用方式

企业系统按开放 API 文档接入;支持能力探询与调用。

所属模块

Mod 制作与开放生态 / 开放生态

适用平台

Web · 已验证

已知限制

  • 接口令牌需企业侧妥善保管

平台验证状态

本项适用于 1 个平台,逐平台独立判定:平台状态只由该平台的实机验收记录产生,总体状态由平台状态自动汇总,目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物;当前源码或新安装包仍需独立验收。

Web

已验证

验收结果:PASS;通过 5 / 失败 0;产品版本 1.0.0.5;Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3;验证时间 2026-09-29。Acceptance JSON SHA-256 cf96b9b966aac417cbf3a0d3a70ea4df98d92e117089ee7dd0a7b0769bb2211c

实机录像 / 操作流程

媒体内容已复核,记录结论:验收结果:通过;画面内容:本轮真实浏览器会话录像(webm,17.92s,ffmpeg 实测):管理员登录 → manifest → guide → panel → keys → 闭环自检 → 缺 tool 400。;SHA-256:ff480af29f08d7958aabb0429977f05aaefe6f63297518fb5730f7495174f2eb(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-open-api/video/mods-open-api-web-20260929-142459.webm) 下载原始录像

实机截图

开放 API(ai_open) 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:管理端登录页「XCMAX 服务器后台 · 管理员登录」,账号框已填 admin、密码框为掩码。;SHA-256:2f5f26173889f35c4e5d3ac00917da0e19ea11921e137274d21fb80369db4df6(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-open-api/shot/00-login-form.png) 查看原图
开放 API(ai_open) 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:卡片汇总五处真实响应:manifest 200(name=AIOPEN、version=1.0.0.5、protocol 含 guide/mcp/rest_invoke);guide 200(base_url + endpoints);panel 200(routes 含 /api/ai/chat 等);keys 200(keys=[]);loop/verify 200(closed_loop=true、api_catalog/api_call 步骤 ok)。;SHA-256:721927f33fc8d5ca4fdaebbc259e5ede2523c0d8da611278ae3241c913822a05(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-open-api/shot/A1-openapi-surface.png) 查看原图
开放 API(ai_open) 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:本轮响应:POST /api/aiopen/invoke 空 body 返回 400,message=tool 不能为空。;SHA-256:14930ce0d4f2fafd805d26749014b73b8edc5caf0ecc23612257c2fdfeb60893(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-open-api/shot/A6-invoke-rejected.png) 查看原图

运行日志

下载原件:mods-open-api-web-20260929-142459.log;SHA-256:1f94df8c423d7ed215c9eb0ccb91b5a0a8b55ed77b6e2a40d0fdd60bfeba70e3(仓库路径:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-open-api/log/mods-open-api-web-20260929-142459.log)

安装包 / 部署产物 SHA-256:cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试(平台无关)

图片内容复核(2026-09-30,Mac 1.0.0.5):智能生态页有智慧分析、开放智控、生产员工和员工商店入口。

源码实现

  • FHD/app/fastapi_routes/ai_open.py

自动化测试

  • FHD/tests/test_aiopen.py
  • FHD/tests/test_aiopen_capability_loop.py

CI 门禁:FHD/.github/workflows/ci-cd.yml

CI 工作流定义

  • FHD/.github/workflows/ci-cd.yml

未标注平台的补充资料

下列资料未绑定到具体平台,仅作实现与历史资料参考,不计入任何平台状态,也不构成实机验收。

实机截图

开放 API(ai_open) 已复核截图
记录结论:资料收录(未绑定平台验收);SHA-256:5648abab79fb51759b2dc0ca0345bc1636e9f1f014da19b7943b7411edb08bdf(原始文件:FHD/docs/evidence/capabilities/mods-open-api-01-aiopen-platform.png) 查看原图

关联文档

  • FHD/docs/aiopen.md

证据原件存放于私有对象存储,页面通过短时效签名地址读取原图与原始录像; 「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本, 也可下载原件后用 sha256sum 自行核对。