UI 蓝图/开放平台 · 自动化/机器人目录与运行健康

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR08 · 9/21 PASS COMPLETEAdmin · 在组织内创建、安装、启停和调查机器人的开发者、Owner 与值班人员

机器人目录与运行健康

按组织资源边界管理机器人身份、安装上下文、运行主体、事件量和交付健康，不把 SDK 契约误标为已上线后端

/robot/listminiapp-open-platform

R08 · KNIFE 9 / 21

机器人目录与运行边界 · 页面级细化任务包

保留旧 UI 的用户名、昵称、可搜索、可邀请、菜单模式、隐私模式与状态信息架构，同时把 Bot 控制面、安装和交付健康明确升级为目标能力。

LEGACY / TARGET ROUTE

legacy source route @a86af60；当前生产无 React route / Bot API → /robot/list

ENTRY

从开放平台应用目录或目标组织上下文进入；当前生产只有 generic developer_app(kind=bot) 数据入口，没有机器人目录。

SUCCESS OUTPUT

返回 BotDefinitionIndex 与每个 Bot 的授权可见性、宿主绑定、Installation 和 delivery evidence；未知数据保持 unknown。

COMMAND MODEL

CURRENT LEGACY: POST /api/bots list contract；CURRENT PROD: none；TARGET: organization-scoped BotDefinitionIndex + DeliveryHealth read model。

RESPONSIVE + A11Y

桌面保留筛选表与 source-gap rail；平板卡表；390px 优先 username/status/current evidence，禁止显示无来源 KPI。

TELEMETRY

bot_index_view · filter_apply · bot_open · source_gap_open；不记录 Bot token、webhook、不可见名称或 payload。

LEGACY SOURCE + CURRENT PRODUCTIONa86af60 / e50cb8a / 404

2026-07-17 认证遍历 Gitea `reits` 组织共 20 个仓库；精确 `/openapi/v1/bot/*` 服务端实现数为 0
xtalk-open-source main@a86af60 含旧 React 机器人 UI 与 `/api/bots/*` 客户端合同，但没有部署证据
miniapp-open-platform source fa9283d / production fb1a1b：`developer_apps.kind=bot` 只是通用 App 字段，没有 Bot/Installation/Command/Credential/Event/Delivery 表或 handler
opensdk main@e50cb8a 提供 6 个 Bot 客户端路径、HMAC-SHA256 验签、5 分钟窗口与 1 MiB body 上限；go test/vet 通过
im-core origin/main@9849051 仍只提供 `/im/chat/create_bot` 的 typ=11 会话壳；最新提交只推进 iOS QA handoff，公网 Bot OpenAPI 探测仍为 404
reits-auth source/production@157b859 没有 Bot resource authorization、ServicePrincipal 或 workload exchange
旧列表真实列为 username/name/is_searchable/is_invitable/menu_mode/is_allow_forward/status；没有安装数、事件量或交付 SLO 来源

IMPLEMENTATION GAPTARGET ONLY

生产没有 `/api/bots`、BotDefinitionIndex 或 organization authorization
没有 Installation、ServicePrincipal binding 或 DeliveryHealth read model
旧 UI 的列表结构可参考，但旧 API 合同和状态数字不能标为 current production

63-STATE PROGRAM / THIS SCREEN

七页分别改变身份、配置、命令、凭证与交付证据边界

QA 0 / 5 VERIFIED

READY机器人目录合同可以评审

legacy columns + current gap

BOT-INDEX-READY→ 查看 Bot 控制面合同

LOADING正在读取机器人边界

identity / bot index / delivery health

BOT-INDEX-LOAD→ 返回应用目录

EMPTY生产尚无机器人目录模型

bot index

BOT-INDEX-NO-MODEL→ 查看实现缺口

PARTIAL ERRORBot 元数据可用，运行证据未知

delivery / host binding

BOT-INDEX-PARTIAL→ 重试运行证据

ERROR无法读取机器人目录

bot index

BOT-INDEX-503→ 重新读取目录

OFFLINE离线查看最近脱敏快照

redacted bot snapshot

BOT-INDEX-OFFLINE→ 重新连接

FORBIDDEN没有查看机器人资源的权限

bot visibility

BOT-INDEX-DENY→ 申请 Bot 读取权限

CONFIRM暂停目标机器人？

BotLifecycleImpact

BOT-PAUSE-CONFIRM→ 提交暂停命令

SUCCESS机器人状态变更已登记

lifecycle receipt

BOT-STATUS-UPDATED→ 查看传播证据

UI STUDIOtarget-open-bots

Admin1440 × 900100%

100%

/robot/list

TARGET UI1440 × 900FIT 100%

R08 DESIGN CANDIDATE · target-open-bots · TARGET ONLY · PROD BOT API 404

BOT DIRECTORY · LEGACY UI GROUNDED

机器人与自动化

沿用旧列表真实字段，但把 source-only UI、当前生产 404 与目标 Bot 控制面分轨展示；不再伪造机器人、安装、事件量或成功率。

Gitea repos20authenticated traversal

Legacy routes6source only

SDK client paths6contract only

Prod Bot routes0three probes = 404

Bot domain models0implementation gap

i

证据边界xtalk-open-source a86af60 有真实机器人 React 页面和 `/api/bots/*` 客户端，但生产 Nginx/service/route 均无 Bot 控制面；OpenSDK 也只有客户端。

⌕ 字段、模型或 revision

对象 / 字段证据授权范围模式状态来源

Lusernamelegacy fieldLEGACYsearchable / invitablemenu_modestatus

Cdeveloper_apps.kindcurrent schemaCURRENTowner_id onlykind=botgeneric app

TBotDefinitionIndextarget modelTARGETInstallationDeliveryHealthnot implemented

REFERENCE VIEWPORT1440 × 900Desktop first · responsive

PRIMARY TASK创建机器人主操作、权限与完成反馈必须同屏可验证

DATA CONTRACTBotDefinitionIndexready / loading / empty / error 使用同一 fixture

ACCESSIBILITYKeyboard + WCAG AA焦点顺序、可读名称、对比度进入 UI CI

VISUAL BASELINETARGET · 2026-07-17桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

目标定义与下一轮逐页细化入口

当前处于 B1/B2：可以拆出架构、设计、交互和 QA 任务，但完成 D01–D12、通过 B3/B4 之前，不得宣称页面已经可以照稿实现。

01

页面区域

组织与机器人上下文
自动化全局导航
目录任务头
运行 KPI
源码边界提示
机器人表格
选中机器人详情
启停与权限动作

02

用户动作

创建机器人
筛选机器人状态
打开机器人详情
查看有效权限
调查交付异常
暂停机器人
预览删除影响

03

必须状态

机器人目录就绪
目录与健康加载
尚无机器人
交付指标部分失败
机器人目录失败
离线只读目录
缺少 bot:read
暂停/删除确认
机器人状态已更新

04

数据契约

BotDefinitionIndex
BotDefinition
BotInstallationSummary
ServicePrincipalBinding
ResourceGrant
BotDeliveryHealth
BotLifecycleCommand
AuditReceipt

TARGET MODULES

目标页面必须交付的模块

01机器人索引与筛选
02状态/安装/事件 KPI
03当前实现边界提示
04BotDefinition 摘要
05Installation 范围
06运行主体与授权
07交付健康
08暂停/删除影响

PRODUCT ROUTE INDEX

开放平台 · 自动化的 38 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言，但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

开发者登录/login

我的小程序/apps

创建小程序/apps/new

应用发布/apps/:id/publish

应用索引与控制面健康/apps

三步创建应用/apps/new

上传、审核与原子发布/apps/:appId/releases/new

应用基本信息与生命周期/apps/:appId/settings

环境、回调与凭证/apps/:appId/config

版本历史、对比与回滚/apps/:appId/versions

接口、Scope 与使用量/apps/:appId/capabilities

能力申请与审核/apps/:appId/capability-requests

组织目录与企业边界/mini-company/list

创建与验证企业/mini-company/create

开发治理概览/console/development

开发者身份与资源关系/console/developer

成员、邀请与离职治理/console/member

角色、策略与有效权限/console/role

服务账号与工作负载身份/console/service-accounts

操作、授权与安全审计/console/log

机器人目录与运行健康/robot/list

创建机器人与最小授权/robot/create

机器人基本信息与生命周期/robot/baseInfo/:id

事件订阅与开发配置/robot/devConfig/:id

命令定义、权限与测试/robot/command/:id

Bot Token 与运行凭证/robot/token/:id

事件交付、重试与 Redelivery/robot/:id/deliveries

支付订单与资金生命周期/mini/:type/paymentOrders/:id

用户数据、授权与主体请求/mini/:type/userData/:id

支付能力申请与独立复核/mini/:type/payApply/:id

组织财务、结算与对账/console/finance

公共开发者首页与能力总览/

Mini App 产品、Quickstart 与宿主边界/mini

企业开发与组织治理介绍/mini-company

机器人、命令与事件自动化介绍/robot

商业合作、场景准入与能力边界/business

平台公告、变更影响与订阅中心/notice

个人账号、安全、授权与偏好中心/console/my

← 操作、授权与安全审计创建机器人与最小授权 →