fix(docs): align accepted App conversation RFC and entry validation - #5150
Conversation
Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
huangruiteng
left a comment
There was a problem hiding this comment.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
Reviewed exact head: 5150@211f8ede947e0b0c71e0c313bf5fd71591318514; base: 6d971272f69d146d10f81cb5f272e5ec9e99bda6.
动机
发布预检复现会话 RFC 缺少中文镜像、合入后重新使用 Draft,以及首页 smoke 仍要求已取消的浏览器意图分类。该差异对齐已经接受的设计和入口合同,使贡献者能认领设计工作、维护者能验证真实路径;这只是发布前置修复,完整连续性、异步 inbox 和小队验收仍未关闭。
改动思路
复用现有 lifecycle enum、状态索引生成器、Chat callback 和显式 typed form;不恢复关键词分类或放宽门禁。完整中文镜像保留所有阶段、反例、权限和未验证边界,英文 Accepted 描述区分已交付入口与开放验收;README 去掉缓存状态,两个索引由原生成器重建。未来改动便利性检查已移除重复状态和旧归属,无需新抽象。
具体改动
完整6文件差异为198行增加、9行删除,主要是必需语义镜像;生产 handlers、forms、CSS、路由布局和权限实现均无变化。docs governance、索引检查、实际 dashboard demo skip-browser、home-route 和 workspace contract 通过。现有 conversation-input 真浏览器场景通过:解释、引用、否定和中英混合文本完整进入所选 Chat 且只发送一次,不由浏览器生成 preview 或写入;显式表单仍验证 interval0、超长字段、read-only 权限、heartbeat 关闭、503后草稿保留、重试、取消和窄屏 Escape。19项原生预合入/公开边界检查及当前质量回执通过。首次原生检查缺少 root npm/typescript,安装依赖后原门禁完整重跑通过。没有查询或等待 GitHub CI。
对主干的风险
风险是文档把 accepted design 误写为全面验收,或静态检查存在 callback 却隐藏浏览器效果。逐项比对镜像,保留 managed/attached、小队、跨 host、generic inbox 的开放状态,membership、注册和 ACK 都不增加权限或证明 running。实际浏览器以独立请求、session、preview/write 计数验证负例,静态 presence 检查不是唯一证据。runtime 和首屏呈现字节未改,原权限和用户操作成本保持,没有新的生命周期名、default-off 声明、heuristic gate 或持久迁移。最终干净发布提交的打包和真实模型资格仍需独立完成。
我的整体评价
这是完整、必要、可回滚的文档/既有测试修复。所选入口到预览、错误恢复和取消保持原语义,持续工作与用户体验未退化;没有通过合入 RFC 宣称尚未交付的 runtime 能力。当前精确差异没有 blocker,可按低风险文档/测试规则合入。剩余发布资格和远端产物由当前授权发布操作继续负责。
English verdict: APPROVE
The merged App conversation RFC still used Draft, lacked its required Chinese semantic mirror, and cached lifecycle in the README. Add the complete mirror, mark the merged design Accepted with unfinished continuity/inbox acceptance explicit, and regenerate the existing status indexes.
Update the existing home-route smoke to follow free text into the selected Chat and explicit creation/scheduling into typed forms. No rendering, runtime, permissions, scheduling rules or stored schemas change.
Validation: docs governance/RFC index, actual dashboard demo readiness (skip-browser), existing personal-workspace contract and home-route smoke pass. The unchanged conversation browser scenario retains explanation/quote/negation, original scoped message, no browser-manufactured preview/write, explicit forms, invalid input, failure draft retention and cancel coverage. Final clean release packaging/browser qualification follows.
Bounded simplification: remove cached lifecycle and obsolete classifier assumptions; reuse canonical form, mirror and generator owners.