- Original macOS visual target:
design-concepts/threaddock-macos-final.png - Updated same-state task workspace:
design-qa/task-tabs-same-state.jpeg - Pre-change consolidated settings source:
design-qa/settings-consolidated-usage-final.png - Final settings without a global top bar:
design-qa/settings-usage-no-global-topbar.png - Final task workspace without a global top bar:
design-qa/task-no-global-topbar.png - Notification keyboard focus state:
design-qa/settings-notification-focus-final.png - Same-state combined comparison:
design-qa/task-tab-comparison.jpeg - Same-state top-bar comparison:
design-qa/topbar-before-after.png
The baseline and updated captures embedded in the comparison images are 1101×768 pixels and were placed directly beside each other without density resampling. The Electron window measured 1290×900 CSS pixels at device pixel ratio 2; Sky normalized both captures identically for inspection.
States:
- Task comparison: Simplified Chinese, completed
重构设置页交互Fake Agent task, Conversation selected, inspector closed. - Top-bar comparison: Simplified Chinese,
用量与预算selected, six stored runs, no configured cost or token limit.
No actionable P0, P1, or P2 differences remain.
- The global
用量洞察destination is removed from the single macOS source-list sidebar. - The task workspace now contains only
对话 / 活动 / 变更; task execution and review remain together without a configuration/statistics tab. - Settings contains three contained subpages:
通用 / 通知 / 用量与预算. - Existing language, notification, budget, usage refresh, metrics, and run-history behavior remains connected.
- Each global run now shows its workspace and an abbreviated task reference, so repeated run generations stay distinguishable.
- The layout retains one global sidebar; Settings uses horizontal section tabs rather than adding a second permanent navigation column.
- The separate 54px global title bar is removed. The sidebar and active page now begin at the top of the window.
- A local 54px sidebar masthead preserves the macOS traffic-light and drag region without consuming height across the content area.
- New Task moved into that sidebar masthead. Approval Inbox and Settings remain in the source list, so no global destinations were lost.
- Share, More, Stop, and Inspector controls live in the task workspace header; Share now copies a task reference while Fork remains in More.
- The 1160px responsive rule collapses budget inputs to one column and usage metrics to two columns.
- Typography: existing Inter and macOS system fallbacks, weights, hierarchy, and compact UI sizes are preserved.
- Spacing and layout: the content region gains the former 54px global row, while Settings header, 43px section tabs, card radii, margins, and main-column width keep the current macOS shell rhythm.
- Colors and tokens: selected tabs, primary actions, notifications, and status treatments reuse the existing accent and semantic tokens.
- Images and assets: no raster assets were required; existing Phosphor icons are retained. The usage empty state uses a Phosphor icon, and budget progress uses a native semantic
progresselement. - Copy and content: English and Simplified Chinese strings cover the new Settings navigation and unified Settings description.
- Opened Settings from the global sidebar.
- Switched among General, Notifications, and Usage & Budget.
- Refreshed global usage successfully.
- Confirmed the first notification switch receives a visible focus ring when reached with the keyboard.
- Confirmed global run rows expose full workspace/task context to assistive technology and a compact visible reference in the table.
- Returned to a task and confirmed the remaining Conversation, Activity, and Changes tabs.
- Confirmed the sidebar New Task control opens the composer.
- Confirmed Share copies the task reference, More exposes Fork/Rename/Pin/Archive, and Inspector opens and closes from the task header.
- Accessibility tree exposes Settings navigation, form labels, checkboxes, usage table headers, and named controls.
- After clearing historical HMR messages and exercising the revised navigation, the renderer console remained at 0 messages. DevTools reports only Vite's expected development-only CSP issue for
eval.
The first implementation review found four P2 issues: usage events refreshed on every Settings subpage without coalescing, notification switches lacked a visible keyboard focus state, global run rows lacked task/workspace context, and pagination could race with a fresh summary request.
The final implementation:
- marks global usage stale outside the Usage & Budget section and coalesces live updates over 300ms only while that section is active;
- assigns summary and pagination requests to the same request generation so stale results cannot overwrite a newer view;
- draws a focus-visible ring on the rendered macOS-style switch;
- shows workspace, task reference, provider, and model in every run row.
The final desktop inspection found no remaining P0, P1, or P2 issues.
The user identified the full-width top row as wasted space. The final pass removed that row, moved New Task into the sidebar's traffic-light-safe masthead, and restored task-specific actions to the task header. The same-state topbar-before-after.png comparison confirms that Settings begins 54px higher while the sidebar, typography, controls, cards, and table retain their established scale.
The task workspace pass also corrected the previous Share icon's hidden Fork behavior: Share now performs the advertised copy action, and Fork is available in the adjacent More menu. No P0, P1, or P2 findings remain after this iteration.
- TypeScript check: passed.
- Electron production build: passed.
- Tests under Electron's Node runtime: 98 passed, 1 skipped.
git diff --check: passed.- Final visual and interaction QA: passed after one corrective iteration.
final result: passed