UI 蓝图/开放平台 · 自动化/创建机器人与最小授权

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR08 · 9/21 PASS COMPLETEAdmin · 声明机器人用途、事件、动作和安装范围的组织开发者与安全 approver

创建机器人与最小授权

通过身份用途、最小能力、显式安装范围和确认回执创建机器人，默认拒绝未声明事件与动作

/robot/createminiapp-open-platform

R08 · KNIFE 9 / 21

创建机器人与最小授权 · 页面级细化任务包

从旧单页 BaseInfo + DevConfig 表单提炼 username、昵称、头像、描述、搜索/邀请/隐私/菜单/webhook，再拆成身份、能力、安装与确认四步。

LEGACY / TARGET ROUTE

legacy source route @a86af60；当前生产 Portal 不呈现 kind=bot → /robot/create

ENTRY

从机器人目录进入；当前 generic CreateApp API 可接收 kind=bot，但不会创建 host bot_uid、Token、Installation 或 EventSubscription。

SUCCESS OUTPUT

创建 BotDefinition draft 与独立 Approval/Installation drafts；返回 receipt，不在创建结果直接展示长期万能 Token。

COMMAND MODEL

BotDraft → username reservation → Media avatar ref → purpose/capability diff → InstallationDraft → approval；generic App identity 只能作为前置资源。

RESPONSIVE + A11Y

桌面主表单 + readiness rail；手机逐步全屏，username 校验不锁住输入，错误摘要与上传恢复置顶。

TELEMETRY

bot_create_view · username_check · draft_save · installation_submit；不记录表单正文、文件名、webhook 或 secret。

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
旧 UI 校验 `_bot` username、1–30 昵称、1–300 描述、1MB 头像与四个 DevConfig 字段，并把表单值写入 console.log
generic Developer API 创建只生成 appKey + owner_id

IMPLEMENTATION GAPTARGET ONLY

生产没有 BotDraft、username reservation、host provisioning、Installation 或 approval
旧表单取消即丢失且无 revision/草稿恢复；console logging 需删除
旧创建成功直接引导获取 Token，目标必须分离凭证发行

63-STATE PROGRAM / THIS SCREEN

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

QA 0 / 5 VERIFIED

READY机器人创建草稿可以填写

four-step target wizard

BOT-CREATE-READY→ 填写身份与用途

LOADING正在检查创建前提

username / app / capability prerequisites

BOT-CREATE-LOAD→ 保存非敏感草稿

EMPTY尚未声明事件与安装范围

capability / installation

BOT-CREATE-NO-SCOPE→ 选择最小能力

PARTIAL ERROR草稿可用，部分预检未知

username / Media / policy

BOT-CREATE-PREFLIGHT-PARTIAL→ 重试失败预检

ERROR机器人草稿未保存

BotDraft command

BOT-CREATE-SAVE-FAILED→ 安全重试保存

OFFLINE离线保留非敏感创建草稿

local non-sensitive draft

BOT-CREATE-OFFLINE→ 重新连接

FORBIDDEN没有创建机器人的权限

bot.create + app owner

BOT-CREATE-DENY→ 申请创建权限

CONFIRM创建 Bot draft 并提交安装申请？

BotDefinition + InstallationDraft

BOT-CREATE-CONFIRM→ 确认创建草稿

SUCCESSBot draft 已创建

creation receipt

BOT-CREATE-CREATED→ 进入开发配置

UI STUDIOtarget-open-bot-create

Admin1440 × 900100%

100%

/robot/create

TARGET UI1440 × 900FIT 100%

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

CREATE BOT · LEGACY FORM → TARGET WORKFLOW

创建机器人

旧 UI 把 BaseInfo 与 DevConfig 放在同一页且取消即丢失；目标按身份、能力、安装和确认分步，generic kind=bot 只作为 App 前置资源。

1身份与用途legacy grounded2能力与事件target only3安装与审批target only4创建回执no secret

STEP 1 / 4 · FIELD CONTRACT

从旧表单提取可复用字段，不复刻危险行为

generic Developer API 可以接收 kind=bot，但不会 provisioning host bot_uid、Installation 或 Token。

BOT

Bot identity draft · TARGETorganization、purpose、sponsor 和最小数据用途必须显式声明。

Legacy source fields

✓username7–20 chars · suffix _botlegacy source✓name1–30 charslegacy source✓description1–300 charslegacy source✓iconPNG/JPEG · ≤1MBlegacy source