Issue 59 Validation
设计与范围 · Issue #59 · 关联 PR #91（草稿）。
日期：2026-09-22。所有截图与应用验证使用代码 59886de0cbf2eedd0e0670f37943f6c3d1b52ae2。本次只修改 README、工作区说明及 Wiki 资料。
- macOS arm64、Node.js 25.5.0、Electron 44.2.0。
- 最新 Release 为 v0.3.2（
3c2cc14）。开发基线包含 PR #89 的主题／减少动态效果和 PR #90 的窗口内全屏 Diff；它们尚未随 v0.3.2 发布。截图中的应用版本文字来自当前包版本，不表示这些开发能力已进入同号安装包。 - 执行
npm run build，5 个工作区构建成功（4 项命中构建缓存），保留现有大 bundle 提示。 - 首次上手路径用 Ego Lite 0.5.0.32 验证。其
Page.captureScreenshot持续超时，改用已构建桌面应用的现有--smoke-test隔离入口和webContents.capturePage()采集，产品源码与样式不作改动。 - 一次性数据目录，复用仓库测试 helper 的 loopback SSH 服务；扫描、Git 读写、SQLite、AI 设置均走生产实现。两个工作区为
alune-demo和alune-theme，提交作者为Alune Demo <demo@example.invalid>。远程 origin 是同一临时目录内的裸仓库，AI 使用本机 OpenAI 兼容模拟端点，无真实凭据和外部 AI 请求。 - 宽屏截图为 1440×900 CSS px，窄屏为文件名所示宽度 ×760；原生 2× 截图等比缩小为 1× PNG，未重绘界面或替换内容。
| 场景 | 实际结果 |
|---|---|
| 快速上手 1：添加连接 | 从 SSH 连接页填写演示连接，保存后“测试连接”显示成功／在线；未使用用户已有连接。 |
| 快速上手 2：扫描与打开 | 连接卡片“查看仓库 → 扫描并添加 → 扫描 → 添加 → 打开工作区”可找到并打开测试仓库。 |
| 快速上手 3：检查、暂存、提交 | 打开已暂存文本 Diff，取消暂存再暂存，经“提交已暂存内容”创建提交；Git 核对只提交 src/workspace.ts，README 与图片仍未暂存。 |
| 拉取、推送、获取 | 普通推送同步到临时 origin，origin/main...HEAD 为 0 0；拉取显示“拉取完成”；“更多推送选项 → 获取远程更新”显示“获取完成”。未执行强制推送或标签菜单。 |
| 快速上手 4：AI | UI 保存兼容服务、获取并启用演示模型，在“提交生成”保存默认模型。星光按钮同时填入摘要与描述；辅助栏显示模型与“仅分析已暂存改动 · 由你确认后提交”。点击模型确实进入提交生成设置。 |
| AI 数据与提交边界 | 本地模拟服务的请求包含已暂存 src/workspace.ts，不包含未暂存 README 和图片。生成前后 HEAD 不变；撤销恢复原摘要；编辑后由用户操作路径主动提交。模拟响应不代表真实模型生成质量。 |
| 状态栏导航 | 左栏隐藏后仍能打开底部工作区导航，查看仓库切换、浏览全部仓库、管理远程连接、设置、帮助与文档。 |
| 四档工具条 | 1440：完整文案；1000：同步按钮图标化且保留 Worktrees；820：Worktrees 在“更多仓库视图 → 关联 Worktree”；640：视图图标化，AI 模型与范围仍可见，无页面横向溢出。 |
| 分支与更多菜单 | 当前分支控件展开筛选／切换列表，“分支”进入管理视图；更多菜单含储藏、远程、分支管理和刷新仓库。只验证这些入口与既有代码，不宣称覆盖所有分支写操作。 |
| 提交历史 | 首次 50 条，滚动底部自动追加至 60 条，回到顶部选择提交可显示文件与 Diff；图包含本地分支、origin 跟踪引用、标签与合并关系。截图另选合并提交，展示上下布局。 |
| Worktree | 打开 feature/moonlight 的关联工作区，出现独立标签并登记到列表；切回主仓库草稿保留；重复打开主工作区仍为两个标签。关闭关联标签后登记仍在，磁盘目录未删除。 |
| 图片 Diff | PNG 修改显示前后两个 640×360 版本、文件大小与透明区域棋盘格；未更改已有格式／体积限制说明。 |
| 全屏 Diff | 全屏后 Diff 宽度为 1440，与应用内容区域一致；通过收起按钮及原生 Escape 键退出，草稿保留。 |
| 外观 | 初始“跟随系统”；通过 Electron nativeTheme.themeSource 模拟系统变化，跟随系统随之变化、显式浅色覆盖系统深色、选回系统恢复深色；显式深色与减少动态效果立即生效。 |
| 外观保存与草稿 | 主题切换并返回工作区后提交草稿保留；重启隔离 Electron 进程、后端更换 HTTP 端口后恢复深色和 data-reduced-motion=true。 |
| 文档格式与范围 |
prettier --check README.md docs/workspace.md、git diff --check；主仓库差异仅两份文档。未为纯文档变更新增测试。 |
截图复查时发现首次浅色采集处于 Diff 加载状态，已等待实际内容和绘制完成后重采；首次截图驱动以 Electron 自身版本显示设置页版本号，已按根包版本重新启动隔离采集入口并替换外观／导航素材。自动操作期间也修正了等待条件（如同步提示实际为“完成”），上述结果以最终 UI 与 Git 状态核验为准。
文档提交：e90d3c6，PR #91（草稿）。GitHub Markdown API 渲染通过，README 的 3 张表、6 个图片元素（含产品图标）和工作区说明的 2 张表均生成正常。
21 个本地文件／锚点检查通过，26 个引用 URL 全部可访问；9 个新 PNG 返回 200 且下载内容与本地文件逐字节一致，设计与验收页面可直接访问。v0.3.2 的 macOS arm64/x64、Windows x64、Linux x64 安装包及 SHA256SUMS 五项名称均与 README 对应。首次 Wiki 推送发生 HTTP 400，调整本次推送缓冲后成功；发布前的图片 404 已在发布后重新检查为通过。
PR GitHub Actions 的 web、server、desktop、ssh-client 单元测试及 commitlint 全部通过。此处 CI 结果不替代下面列出的真机验收。
本次不是跨平台发布验收。未重新执行 Windows／Linux、macOS x64 真机交互、真实远程网络、真实 AI 厂商服务、屏幕阅读器、200% 系统缩放、真实 OS 减少动态效果切换及大 Diff 性能测试。既有 Issue #86 验收 中的未验证项保持其状态；系统减少动态效果优先级与支持格式等保留说明另以当前代码及原验收记录核对。