Skip to content

feat(workspace): 实现浮动窗口与 Schema V3 - #75

Merged
wubing7755 merged 1 commit into
mainfrom
feat/floating-window
Nov 3, 2026
Merged

wubing7755 merged 1 commit into
mainfrom
feat/floating-window

Conversation

@wubing7755

Copy link
Copy Markdown
Member

Summary

实现 REQ-F-152 页内浮动窗口,并将持久化升级到 Schema V3。

  • Core:新增 committed Floating placement、FloatingWindowState/几何/返回书签;新增 FloatToolOperation、SetFloatingWindowGeometryOperation、DockFloatingToolOperation;MoveToolOperation 支持 Floating 来源;浮窗上限 8,错误码 FloatingWindowLimit = 17。空 Dynamic Group 在浮窗期间临时以 Persistent 锚点保留,取消浮动时恢复 Dynamic。
  • Blazor:新增 floating layer 与 AtlasFloatingWindow,复用 Panel Header 与内容 outlet;支持 dialog 语义、焦点进入/回退、ToolBar 浮窗 Entry、点击置顶、关闭取消浮动和八向 resize。
  • TypeScript:新增 floating-geometry 模块;v1 additive 协议支持 floating-window source/target、float-item 与 set-floating-geometry;支持拖出、移动、resize、拖回 Dock 和取消。
  • Persistence:新增 urn:atlas:workspace:3 / 3.0 schema;仅接受 V3,V2/V1 返回 LayoutVersionIncompatible;删除 V1 Legacy 读取器与 V2 XSD,新增 V3 golden fixtures。
  • Docs/Showcase:SRS F-152 正式化,HLD 新增 DES-DOM-013/DES-OP-010/DES-INT-009/DES-RND-011/DES-PER-009,ADR-0043 Accepted;新增 /floating-windows Showcase 页面与三浏览器证据。
  • 顺带修复 Showcase 面板管理器状态消息在 Changed 事件晚到时被“布局已更新”覆盖的偶发竞态。

Breaking change

Schema V3 拒绝 V2/V1:已有 V2 自动保存/预设布局升级后不可恢复。按维护者决定,发布说明中明确提示 consumer。

Verification

  • 382 Core + 181 Blazor + 13 Showcase = 576 .NET 测试全绿;80 JS 测试全绿。
  • Debug/Release build、test、dotnet format --verify-no-changes、Release pack 通过。
  • 真实浏览器:Chrome(CDP)、Edge 156(CDP)、Firefox 159(WebDriver BiDi)完成浮出/移动/八向缩放/拖回 Dock/关闭取消浮动;Edge/Firefox console error/exception 为空,Chrome 最终交互无产品级异常。
  • 聚焦验证:浮出后焦点进入浮窗内容 outlet;关闭后回到目标 ToolBar Entry。
  • 证据与截图:docs/zh/evidence/floating-window.md

Requirement traceability

AI assistance disclosure

  • 阅读文档:AGENTS.md、CONTRIBUTING.md、docs/zh/SRS.md、docs/zh/HLD.md、docs/zh/adr/README.md、docs/zh/security/content-threat-model.md 及相关 ADR。
  • Agent 工作:完成 Core/持久化/Blazor/TS/Showcase 实现、测试、文档与 ADR 修订,并驱动 CDP/BiDi 浏览器验证。
  • 人工验证:维护者批准了实现范围与 ADR-0043;浏览器交互由自动化脚本驱动,未逐项人工点击。请在评审中确认发布说明与 Schema V3 破坏性变更提示。

Test plan

  • dotnet build Atlas.sln
  • dotnet test Atlas.sln
  • dotnet format Atlas.sln --verify-no-changes
  • npm run typecheck && npm run test:js && npm run build:js
  • Release build/test/pack
  • Chrome / Edge / Firefox 交互与截图

- 新增 committed Floating placement、几何/返回书签与专用 operation
- Blazor 浮窗层、ToolBar Entry、焦点/ARIA 与八向 resize
- v1 additive 拖拽协议与 floating geometry 模块
- 持久化升级 V3 并拒绝 V2/V1,补充 golden fixtures
- Showcase 页面、三浏览器证据与文档/ADR-0043
@wubing7755
wubing7755 merged commit f2def23 into main Nov 3, 2026
9 checks passed
@wubing7755
wubing7755 deleted the feat/floating-window branch November 3, 2026 08:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant