soft_quay/docs/tasks/T-003.md

id, title, phase, deps, status, created, issue, context_ref, claim_branch, work_branch, write_paths

id	title	phase	deps	status	created	issue	context_ref	claim_branch	work_branch	write_paths
T-003	建立 Gio 空窗口 AppShell 与平台层 stub	0	T-001	DONE	2026-07-16	null	0e20dd76b2	null	agent/codex/T-003	docs/tasks/T-003.md app-modern/cmd/softbox/ app-modern/ui/gio/ app-modern/platform/windows/ app-win7/cmd/softbox/ app-win7/ui/gio/ app-win7/platform/windows/ scripts/check_core_boundaries.py go.work.sum docs/current-state.md

问题 / 背景

两个应用模块当前只有控制台占位入口,尚不能打开桌面窗口;平台层也只有空包。需要建立 modern 与 Win7 各自适配 Gio 版本的最小 AppShell,并为后续 Windows 能力注入提供可在非 Windows 环境编译的接口/stub。

方案

1. modern 使用 Gio v0.10.1 API,win7 使用 Gio v0.6.0 API,各自建立窗口事件循环和 ui/gio.AppShell。
2. AppShell 只展示高对比标题、版本标识与占位说明,使用 8dp 间距节奏,不做业务 IO、动画或交互。
3. 两个 platform/windows 包定义最小 Platform 接口,分别提供 Windows 实现与 !windows stub。
4. 新增离线边界检查脚本,通过 go list -json 拒绝 core 直接 import Gio、Windows 专属包或 SQLite。
5. 生成并提交两个 app 模块所需的依赖校验文件。

验收要点

• modern 与 win7 两个 Windows amd64 目标都能编译为 GUI EXE。
• 两个窗口均有 AppShell 骨架;Win7 版明确显示 Legacy 标识。
• Gio 代码只位于 ui/gio 与 cmd 装配层;Layout 不包含磁盘、网络或哈希操作。
• platform/windows 在 Windows 有实现,在非 Windows 有 stub,包级测试可在当前环境运行。
• python scripts/check_core_boundaries.py 与 --self-test 通过,并能检测禁止依赖前缀。
• core vet/test 与治理检查继续通过。

边界（不改什么）

• 不实现软件列表、搜索、下载队列或其他业务页面。
• 不让 modern 与 win7 共享 Gio 控件代码;只保持布局语义一致。
• 不新增 Windows API 调用或第三方依赖。
• 不引入装饰动画、图标或品牌资产。

协作约束

未启用 Gitea;本任务在 agent/codex/T-003 分支串行执行。UI 采用 ui-ux-pro-max 的工具型桌面应用原则,但以 Gio/Windows 任务边界和仓库架构为最高约束。

执行记录

• 2026-07-16:modern 使用 Gio v0.10.1、win7 使用 Gio v0.6.0 建立各自窗口事件循环与 AppShell;两个版本共享相同布局语义,Win7 标题和页脚明确显示 Legacy。
• 2026-07-16:依据 ui-ux-pro-max 的工具型产品建议,采用高对比语义色、16sp 正文、8dp 间距节奏与 44dp 交互基线;本任务没有交互控件,因此不添加动画、图标或装饰效果。
• 2026-07-16:两个 platform/windows 包建立 Platform 接口、Windows 实现与 !windows stub,并添加包级契约测试。
• 2026-07-16:新增 scripts/check_core_boundaries.py,通过 go list -json 检查 core 的普通/测试 import,拒绝 Gio、Windows、SQLite 与 app 反向依赖;--self-test 验证前缀匹配器。
• 2026-07-16:go mod tidy 会忽略 workspace 本地替换并尝试下载 softbox.local/core;为避免把 replace ../core 写入 go.mod,保留 go.work 作为唯一替换源,由实际 test/build 生成 go.work.sum。
• 验证通过:modern Go 1.25.0 执行 go vet ./...、UI/platform 测试与 Windows amd64 构建。
• 验证通过:win7 Go 1.20.14 执行 go vet ./...、UI/platform 测试与 Windows amd64 构建。
• 验证通过:两个 EXE 在当前 Windows 环境启动后保持运行,随后由 smoke 脚本关闭。
• 验证通过:python scripts/check_core_boundaries.py --self-test、python scripts/check_core_boundaries.py、core vet/test 与治理检查。