TARGETF4B2 PARTIALQA 0/5 VERIFIEDR08 · 9/21 PASS COMPLETEAdmin · 维护机器人展示身份、owner、宿主绑定、运行主体和生命周期的资源管理员

机器人基本信息与生命周期

稳定 Bot ID、宿主 bot_uid、展示 revision、组织 owner、Installation 和 ServicePrincipal 关联但不混合生命周期

/robot/baseInfo/:idminiapp-open-platform
R08 · KNIFE 9 / 21

机器人身份与生命周期 · 页面级细化任务包

把旧 Robot 对象的 username、name、icon、description、bot_user_id 与状态拆成稳定身份、展示 revision、宿主绑定和受控生命周期。

LEGACY / TARGET ROUTE

legacy source route @a86af60;当前生产无 Bot detail handler → /robot/baseInfo/:id

ENTRY

从目录或创建 receipt 进入;legacy source 的 `/api/bots/get_by_id` 只是一份未部署客户端合同。

SUCCESS OUTPUT

保存 BotProfileRevision 或返回 pause/deletion job receipt;资料更新不改变 Subscription、Command、Credential 或 Installation。

COMMAND MODEL

GET BotDefinition + POST profile revision + lifecycle job;host_bot_uid 由受控 provisioning/binding 产生,不能由页面手填。

RESPONSIVE + A11Y

桌面设置导航 + form + impact rail;手机先稳定 ID/状态/风险,危险命令全屏确认。

TELEMETRY

bot_identity_view · profile_diff · lifecycle_preview · lifecycle_submit;不记录 description、token、webhook 或 host PII。

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
  • 旧 Robot type 把 bot_user_id、commands JSON、token、webhook、状态和展示资料放在单一对象;IM `create_bot` 不负责机器人 provisioning
IMPLEMENTATION GAPTARGET ONLY
  • 生产没有 BotDefinition/ProfileRevision/HostBotBinding
  • 没有 sponsor、runtime principal、Installation impact 或 deletion job
  • 旧 enable/disable/delete 直接命令缺 revision、影响预览、补偿与审计证据
六个 legacy React 路由不是 current production;交付中心是 R08 新增。OpenSDK 客户端合同与 IM 会话壳都不能作为 Bot 平台上线证据。
63-STATE PROGRAM / THIS SCREEN

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

QA 0 / 5 VERIFIED
READY机器人身份合同可以评审

legacy fields + target identity split

BOT-IDENTITY-READY→ 查看身份分层
LOADING正在读取机器人身份

definition / profile / binding / impact

BOT-IDENTITY-LOAD→ 返回机器人目录
EMPTY尚未建立宿主机器人绑定

host binding

BOT-IDENTITY-NO-HOST→ 开始受控绑定
PARTIAL ERROR资料可用,生命周期影响未知

installation / principal impact

BOT-IDENTITY-IMPACT-PARTIAL→ 重试影响预览
ERROR机器人资料未保存

profile revision

BOT-IDENTITY-SAVE-FAILED→ 重新读取最新 revision
OFFLINE离线查看机器人资料

redacted identity snapshot

BOT-IDENTITY-OFFLINE→ 重新连接
FORBIDDEN没有管理机器人身份的权限

bot.manage

BOT-IDENTITY-DENY→ 申请管理权限
CONFIRM暂停或删除机器人?

BotLifecycleJob

BOT-LIFECYCLE-CONFIRM→ 提交生命周期任务
SUCCESS机器人变更已记录

profile/lifecycle receipt

BOT-IDENTITY-UPDATED→ 查看变更回执
AUTOMATION BOUNDARY本刀只细化 developer.reits.tech 的 Bot 与事件自动化目标 UI;不创建机器人,不调用 legacy `/api/bots/*`,不签发/复制/轮换 Token,不注册 webhook,不发送测试事件,不暂停或 redeliver 交付,也不把 xtalk 旧 UI、OpenSDK 合同或 IM typ=11 会话壳冒充为 current production Bot 平台。
UI STUDIOtarget-open-bot-base
Admin1440 × 900100%
100%
/robot/baseInfo/:id
TARGET UI1440 × 900FIT 100%
R08 DESIGN CANDIDATE · target-open-bot-base · TARGET ONLY · PROD BOT API 404
LEGACY SOURCE / CURRENT PROD / TARGETAutomation Control Plane Blueprint
R8
BOT IDENTITY · LEGACY OBJECT DECOMPOSITION

基本信息与生命周期

旧 Robot 对象混合展示资料、bot_user_id、commands、token、webhook 与状态;目标拆成 BotDefinition、ProfileRevision、HostBinding 和生命周期 Job。

LEGACY PROFILE · SOURCE ONLY

username / name / icon / description

这些字段来自 a86af60 的真实表单,但没有 current production Bot detail API。

LEGACY
—
头像资产旧 UI 通过 heartbeat s3_public_url 拼接;目标改用 Media asset ref。
IDENTITY BOUNDARIESdeveloper_app(kind=bot) ≠ BotDefinitionbot_user_id ≠ platform Bot ID/im/chat/create_bot = typ 11 shell
No current revision · no fabricated actor/time
REFERENCE VIEWPORT1440 × 900Desktop first · responsive
PRIMARY TASK保存新 revision主操作、权限与完成反馈必须同屏可验证
DATA CONTRACTBotDefinitionready / 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

页面区域

  • 机器人与环境上下文
  • 设置导航
  • 身份任务头
  • 展示资料表单
  • 稳定标识
  • 生命周期侧栏
  • 保存冲突
  • 危险操作
02

用户动作

  • 保存新 revision
  • 更换展示头像
  • 修改 sponsor
  • 查看 Installation
  • 预览暂停影响
  • 暂停机器人
  • 开始删除流程
03

必须状态

  • 机器人身份就绪
  • 身份与绑定加载
  • 展示资料不完整
  • Installation 部分失败
  • revision 保存失败
  • 离线只读资料
  • 缺少 bot:manage
  • 暂停/删除确认
  • 身份 revision 已保存
04

数据契约

  • BotDefinition
  • BotProfileRevision
  • HostBotBinding
  • ServicePrincipalBinding
  • BotInstallationIndex
  • BotLifecycleImpact
  • BotLifecycleJob
  • AuditReceipt

TARGET MODULES

目标页面必须交付的模块

  1. 01BotDefinition revision
  2. 02头像/名称/username
  3. 03组织与 sponsor
  4. 04稳定 ID 与 bot_uid
  5. 05ServicePrincipal 绑定
  6. 06Installation 分布
  7. 07暂停影响
  8. 08异步删除流程

PRODUCT ROUTE INDEX

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

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

01
开发者登录/login
Web
02
我的小程序/apps
Web
03
创建小程序/apps/new
Web
04
应用发布/apps/:id/publish
Web
05
应用索引与控制面健康/apps
Admin
06
三步创建应用/apps/new
Admin
07
上传、审核与原子发布/apps/:appId/releases/new
Admin
08
应用基本信息与生命周期/apps/:appId/settings
Admin
09
环境、回调与凭证/apps/:appId/config
Admin
10
版本历史、对比与回滚/apps/:appId/versions
Admin
11
接口、Scope 与使用量/apps/:appId/capabilities
Admin
12
能力申请与审核/apps/:appId/capability-requests
Admin
13
组织目录与企业边界/mini-company/list
Admin
14
创建与验证企业/mini-company/create
Admin
15
开发治理概览/console/development
Admin
16
开发者身份与资源关系/console/developer
Admin
17
成员、邀请与离职治理/console/member
Admin
18
角色、策略与有效权限/console/role
Admin
19
服务账号与工作负载身份/console/service-accounts
Admin
20
操作、授权与安全审计/console/log
Admin
21
机器人目录与运行健康/robot/list
Admin
22
创建机器人与最小授权/robot/create
Admin
23
机器人基本信息与生命周期/robot/baseInfo/:id
Admin
24
事件订阅与开发配置/robot/devConfig/:id
Admin
25
命令定义、权限与测试/robot/command/:id
Admin
26
Bot Token 与运行凭证/robot/token/:id
Admin
27
事件交付、重试与 Redelivery/robot/:id/deliveries
Admin
28
支付订单与资金生命周期/mini/:type/paymentOrders/:id
Admin
29
用户数据、授权与主体请求/mini/:type/userData/:id
Admin
30
支付能力申请与独立复核/mini/:type/payApply/:id
Admin
31
组织财务、结算与对账/console/finance
Admin
32
公共开发者首页与能力总览/
Web
33
Mini App 产品、Quickstart 与宿主边界/mini
Web
34
企业开发与组织治理介绍/mini-company
Web
35
机器人、命令与事件自动化介绍/robot
Web
36
商业合作、场景准入与能力边界/business
Web
37
平台公告、变更影响与订阅中心/notice
Web
38
个人账号、安全、授权与偏好中心/console/my
Admin