fix: refine usage desk controls and selection

Author: linhay

docs-linhay/memory/2026-05-27.md

@@ -308,6 +308,23 @@
 - 写回：已更新 `.agents/skills/gettokens-domain-engineering/SKILL.md` 的 `Status Local CLI Config`，并补充 `docs-linhay/dev/20260426-relay-service-config-boundary.md` 第 8 节。
 - 不升级：该模式属于 Status 本地 CLI 配置域内规则，暂不升级 `AGENTS.md`。
 
+## Usage Desk controls single-row compaction
+
+- 用户反馈：`#frame=codex&workspace=usage-codex` 本地投影用量图表控制栏不应把 `7天/14天/30天/全部` 单独挤到上一行；应优先通过间距压缩保持一行，放不下时逐步收纳到菜单。
+- 修复：`UsageDeskFeature` 将 observed/projected 控制栏抽为共享紧凑 segmented 控件，外层改为 `usage-desk-control-bar` 单行 `flex-wrap: nowrap`；宽度不足时按 `项目汇总/会话列表`、`Tokens/请求数`、时间范围/分钟粒度的优先级进入 `更多` 菜单。
+- 验证：新增 `usage desk chart controls stay on one line and expose compact overflow` 门禁；`node --test frontend/src/features/accounts/tests/usageDesk.test.mjs`、`npm --prefix frontend run build`、`docs-linhay/scripts/check-docs.sh` 通过。`npm --prefix frontend run typecheck` 仍被既有 `CodexAccountDetailModal.tsx` 未定义组件阻塞，与本次 Usage Desk 改动无关。
+- 浏览器验收：in-app Browser 刷新 `http://localhost:5173/#frame=codex&workspace=usage-codex` 后，控制栏宽约 892px，主要子块 `childRows=1`，不再分两行。
+- 截图：`docs-linhay/spaces/20260429-usage-desk-controls-redesign/screenshots/20260527/usage-desk/20260527-usage-desk-controls-single-row-after-v01.png`。
+- 沉淀判断：这是 Usage Desk 局部控件密度修复，沿用现有 controls redesign space 和测试门禁，暂不新增项目 skill，也不升级 `AGENTS.md`。
+
+## Usage Desk summary default and toggle selection
+
+- 用户反馈：`#frame=codex&workspace=usage-codex` 默认选中第一条 `05-15` 会让页面直接进入明细态，无法先查看汇总；已经选中的数据也应支持再次点击取消选中。
+- 修复：`useUsageDeskFeature` 在明细数据刷新时只保留仍有效的当前选择，不再 fallback 到第一行；点击当前已选明细行或图点会清空 `selectedDetailRowKey` / `selectedChartPointKey`，本地投影会话面板回到图表汇总态；切换 range 时同步清空旧选择，切回 daily 不再自动把 `selectedDayKey` 写成图点选中。
+- 测试：新增 `usage desk detail selection starts from summary state and supports toggling off` 门禁，覆盖不自动选第一行和取消选中分支。
+- 文档：补充 `docs-linhay/spaces/20260429-usage-desk-controls-redesign/README.md` 的默认汇总态与取消选中 BDD 场景。
+- 沉淀判断：这是 Usage Desk 局部状态流转修复，沿用既有 Usage Desk 测试和 controls redesign space，暂不新增项目 skill，也不升级 `AGENTS.md`。
+
 ## Codex live-session sidecar timing summary implementation
 
 - 实施：CLIProxyAPI fork 的 live-session tracker 新增 session 级 `timingSummary`，基于 retained requests 返回样本数、sequence 范围、active 是否纳入、生成时间和 timing 均值；active request 只投影 `totalDurationMs`，历史 stale streaming/reconnecting request 不随刷新增长。

docs-linhay/spaces/20260429-usage-desk-controls-redesign/README.md

@@ -31,6 +31,38 @@
 3. 本期只保留一个 HTML 设计稿入口；若需要对比多个方向，也在同一个文件内完成，不拆平行 HTML。
 4. 进入实现后，Gemini 负责前端视觉与布局精写，Codex 负责领域边界、接口契约、状态流转、测试门禁与最终集成，职责不混淆。
 
+## 2026-05-27 控制栏单行收纳补充
+
+### 场景：宽屏工作台内控制栏优先保持一行
+
+Given 用户打开 `#frame=codex&workspace=usage-codex` 的本地投影用量页
+When 图表控制栏同时展示时间范围、视图切换和 `TOKENS / 请求数` 指标切换
+Then 控制栏应优先通过更紧凑的间距、固定控件高度和不可换行布局保持单行显示
+And 不应因为默认 `flex-wrap` 把时间范围单独挤到上一行。
+
+### 场景：宽度不足时逐步收纳到菜单
+
+Given 可用宽度不足以容纳全部控制项
+When 页面继续缩窄
+Then 低频的 `项目汇总 / 会话列表`、指标切换、时间范围/分钟粒度应按优先级进入 `更多` 菜单
+And 主控制栏仍保持一行，不改变原有点击后的状态流转。
+
+## 2026-05-27 默认汇总态与取消选中补充
+
+### 场景：进入页面默认展示汇总信息
+
+Given 用户打开 `#frame=codex&workspace=usage-codex` 的本地投影用量页
+When 页面加载出天级或分钟级明细数据
+Then 图表和明细表不应自动选中第一条数据
+And 标题/面包屑应停留在汇总态，便于用户先查看整体信息。
+
+### 场景：已选中的明细或图点可再次点击取消
+
+Given 用户已点击某一天、某一分钟或对应明细行进入下钻/选中态
+When 用户再次点击同一个图点或同一行
+Then 当前选择应被清空
+And 本地投影的会话下钻面板应回到图表汇总视图。
+
 ## 设计稿入口
 
 - 本期设计稿：`design-preview.html`