AI 业务独立调试

AI 业务独立调试

Saber-AI 的开发外壳用于独立调试 AI 业务页面。它提供本地菜单、展示身份、主题和标签页，接口连接真实后端。

1. 启动开发服务

完成 开发环境准备，核对后端代理与 SM2 公钥后，在 Saber-AI 目录运行：

pnpm dev

打开 http://localhost:1881/，默认进入 /ai/dashboard。

独立开发：左侧是 AI 开发菜单，顶部显示远端标识与版本。

2. 检查开发凭证

开发凭证面板从外壳右上角的钥匙图标打开。手动填入的凭证优先；未填入时沿用同一主机名下 Saber 的会话 cookie，过期后自动续期。

开发凭证面板：来源为本机 Saber 会话，并显示有效期、自动续期、账号与租户。

沿用 http://localhost:1888/ 的登录会话时，1881 与 1888 使用相同主机名。手动凭证可粘贴登录接口返回的 JSON（过期后可自动续期），也可粘贴 access_token、带 bearer 前缀的值或 Blade-Auth 请求头整行；凭证只用于开发，不写入工程文件。

开发菜单位于 src/dev/menus.json，展示身份与按钮清单位于 src/dev/fixtures.ts。这些配置决定外壳展示，业务接口仍检查后端身份和资源权限。

3. 打开同一个应用

从“智能应用 → 编排台”进入宿主中使用的 DOCS_咨询受理流程，核对节点、输入和最终输出配置。

独立开发：资源与业务组件相同，外部布局由开发外壳提供。

开发外壳内可查看同一应用的发布版本记录，当前草稿与线上快照分别列出。

独立开发 · 群星：同一应用的版本历史与线上标记。

4. 确认构建边界

src/dev/main.ts 只由开发 index.html 加载。生产联邦构建暴露 ./remote，不包含开发外壳入口；分享入口单独构建。

现象	检查内容
列表或保存返回未登录	开发凭证来源、会话有效期、后端代理地址
凭证接口提示公钥缺失	本机 VITE_APP_PUBLIC_KEY 是否与后端一致
平台句柄未安装	共享单例、契约包预构建、MF 插件版本与重复开发进程
共享版本检查不通过	重新生成宿主矩阵，按检查结果对齐依赖

继续阅读 联调与运行验证 或 平台契约与联邦装载。