feat(web): 完善 Peer 与 Extension 使用体验 - #118
Conversation
|
第四组交付收尾:最终 head 1123105(最后两笔仅 task packet 及其格式)检查全部通过。Client checks:https://github.com/InKCre/client-web/actions/runs/35870597735 ,数据库 E2E 12/12(16.7 秒),Webext 1/1;同 head 的 Pages preview:https://github.com/InKCre/client-web/actions/runs/35870594806 。正式依赖为 @inkcre/ui-web@2.2.0,未使用本地链接包。公开联网验收与人工矩阵边界见 PR 描述及 task packet。docs#31 同步步骤和桌面截图,继续保持 Draft;本 PR 亦不合并。 |
|
启动空白修复已完成,当前 head:632b3ea。 App 立即显示三点式启动状态,Core 初始化成功后才挂载业务页面;失败显示 Retry,等待和失败均可整页进入 Settings。Retry 保留深链,Settings 保留原配置;不新增初始化重试或改变 SDK 传输行为。 验收:
合并门禁:Workspace contract 的所有步骤已成功,但 GitHub 的 job/check 元数据仍为 in_progress,PR 暂报 BLOCKED;不会绕过门禁。三个关联 PR 尚未合并,Registry 手动生产发布授权仍待确认,本地开发环境清理尚未开始。 |
|
最终交付:本 PR 已合并为 7307dda,生产发布成功:https://github.com/InKCre/client-web/actions/runs/35881211712 。最终 Client checks 的真实隔离数据库 E2E 为 13/13;启动等待、失败重试和 Settings 恢复已验证。生产浏览器已复核 RSS 0.2.1 精确版本确认、未连接时禁止安装、Settings 无 Peer ID。真实 Heroku/Neon 联网数据面验收在合并前的公开预览完成,未将生产只读复核冒充生产安装验收。本任务本地 Web、设计稿和 Histoire 服务已停止;保留 worktree、截图与任务材料,未额外删除云端或用户数据。 |
目标
让用户主要通过 client-web 连接、管理 Peer、安装与配置 Extension,并在浏览和操作信息时获得一致、清晰的反馈。
本 PR 承载本轮全部分组,已转为 Ready for review;最终启动恢复回归通过后与 ext-reg#56、docs#31 一起交付。
已完成:Peer 身份与生命周期
/livez。peer-runtime-identity-v1数据库契约与本地技术文档。已完成:Extension 发现与安装
/extensions?install=<name>&version=<exact>后,Web 重新读取 Release、展示 Host 信息并等待确认;打开链接不安装。未连接部署时显示 Settings 入口,已安装版本不会被静默替换。@inkcre/core状态。已完成:配置表单
<form>。凭据遮蔽只依据 schema 的format: password,不改变读写语义。InkAutoForm五处数组/可空字段动作已在 UI #52 修正为 InkButton,由正常 Version PR docs(governance): record completed workflow rollout #53 发布 2.1.1;第四组已将全部消费者统一升级到正式 2.2.0。第四组:交互质量
UI #54 与正常 Version PR #55 已合并,
@inkcre/ui-web@2.2.0正式发布且由全部五个消费者精确锁定。此前正式包的完整pnpm check、数据库 E2E 12/12 与浏览器扩展 E2E 通过;最新启动恢复修复正重新执行全部门禁。公开预览另发现首屏短暂显示翻译键,已改为同步载入两份约 21.8 KB 的语言资源,并在既有首次连接 E2E 增加首份页面文案检查;未引入启动加载框架。
最终跨站验收发现 Core 初始化等待远程 Peer 时整页空白。现改为立即挂载应用根的三点式等待界面,初始化成功后才挂载业务页面;失败提供 Retry,等待与失败均可整页进入 Settings。重试保留当前深链,不自动重试、不重置连接、不复用半初始化状态。新增真实数据库 E2E 的受控网络失败旅程验证这些恢复路径。
验证
pnpm checkpnpm check再次通过,包括 Web 与三个 MF Extension 的类型、构建和包边界检查。第三组源码联调已在浏览器检查嵌套/可空字段、未知字段保留、无效 JSON、单一原生 form 和 Tabs 历史。关联:InKCre/ext-reg#56、InKCre/ext-reg#48、InKCre/core-py#118、InKCre/ui#50、InKCre/ui#51、InKCre/core-py#120、InKCre/core-py#121、InKCre/docs#31。
交付边界与回退
Core
peer-runtime-identity-v1、UI 2.2.0 与 GitHub/Mail/Telegram Source wheel 0.3.2 已交付;本 PR等待最终启动恢复验收后合并。此分组无数据库迁移或新外部权限。若发布后表单回归,
可回退本 PR 的 Web 提交;既有 JSON 模式保留为不丢配置的操作路径。