# Bloom Desktop UI

> Bloom 本机 UI 调试：通过 DSH 官方开发者工具与原生 Accessibility 操作真实菜单、截图、核验配色和材质；成功路径入 skill，失败原因入统一台账。

- Skill: `webkubor/bloom-desktop-ui` (Agent Skill)
- Install (CLI): `npx get-skill add webkubor/bloom-desktop-ui`
- Raw SKILL.md: https://api.skillmd.com/api/skills/webkubor/bloom-desktop-ui/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: webkubor (https://skillmd.com/u/webkubor)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/webkubor/bloom-desktop-ui

---


# Bloom 桌面 UI 调试

先读 AGENTS.md、CONTRIBUTING.md、docs/lessons.md。复用有效 CS Run 和工作树；本机桌面先于 Web。未经用户确认 UI，不提交、推送或发布。

## 默认路径：真实菜单与窗口

原生菜单和截图无需另开浏览器，也不读取 Cookie 或凭据。不要改 body 属性冒充用户选择。

```sh
swiftc scripts/ui/native-ui.swift -o /tmp/bloom-native-ui
osascript -e 'tell application "DeepSeek Harness" to activate'
/tmp/bloom-native-ui window
/tmp/bloom-native-ui list 'Bloom 主题'
/tmp/bloom-native-ui press 'Bloom 主题 ·*' AXPopUpButton
/tmp/bloom-native-ui list
```

- `window` 返回当前活动窗口的 id、bounds、onscreen。检查窗口自身时可按实时 id 用 `screencapture -x -l <id> <file>`；它不证明屏幕合成效果。确需 `-R` 截取合成画面时，截图前后均核对目标窗口与前台应用，焦点或窗口变化就删除该截图而不打开，以免误采其他应用。不要复用旧 id 或坐标。重要证据存用户私有的持久目录，不依赖 `/tmp`。
- 触发器为 AXPopUpButton；help 是 `Bloom 主题 · vX`，label 是当前配色，expanded 是菜单可见性。先查状态再切换。
- 配色项为 AXStaticText，help 是「配色 · 诗句」。按下后菜单关闭，应读回触发器 label。
- 深浅和「毛玻璃 / 磨砂玻璃 / 液态玻璃」为 AXCheckBox；背景为 AXRadioButton。按下后等待并核对选中值，不能只看命令 exit 0。
- 用 `cordis_inspect_list` 发现 `BloomDiagnostics.snapshot`，以 JSON **对象**传 `target: desktop`、`foreground: true`；取得原生 AX 编辑器的位置和宽度，将窗口相对坐标作为 `editorLeft` / `editorWidth` 一并传入。只有原生编辑器与 DOM 坐标匹配，才能把该 `page.id`、样式和截图归属为同一窗口。诊断只读，不提供业务操作。
- 用户正在其他应用工作时不要抢占焦点；不发送测试消息、不停止任务、不覆盖草稿。输入检查前确认当前编辑器为空且窗口/焦点正确；只允许一个执行者输入自己的测试文字，不按 Enter，确认内容归属后再清除。

快捷入口（自动编译辅助程序）：

```sh
node scripts/ui/desk.mjs /tmp/bloom-ui/current.png
node scripts/ui/desk.mjs /tmp/bloom-ui/menu.png --menu
node scripts/ui/matrix.mjs /tmp/bloom-ui/representatives representatives
node scripts/ui/matrix.mjs /tmp/bloom-ui/palettes palettes
node scripts/ui/matrix.mjs /tmp/bloom-ui/full full
node scripts/ui/matrix.mjs /tmp/bloom-ui/full full --resume
```

`desk` 用于原生截图。矩阵工具只有在能够完整记录和恢复偏好、检测自动轮换且校验每次读回后才能运行；`native-material-matrix.py` 当前对不具备这些条件的运行主动停止。不能把旧版材质的截图算作新版验收，也不能仅凭 AX 选中状态区分隐式 auto 和显式选择。

记录当前窗口、配色、外观、材质偏好、浅深背景和轮换间隔；确认还原能力后再操作。菜单和选中状态使用有上限的等待；截图用 `read_image` 逐张检查，并区分“已采集”和“已目视通过”。自动轮换发生时标记并重拍受影响组合。

## 官方开发者工具：用于 DOM/CSS 诊断

入口是桌面应用菜单「DeepSeek Harness → 开发者工具」，选择 Console。打开前检查是否已打开，不盲目 toggle。实际桌面 origin 为 `dsh-app://app`。

`native-console.swift` 是后备：确认 Console AX 焦点后才输入；找不到时 JSON 报错并退出。剪贴板在所有出口恢复。曾成功读出真实 origin/variant/material，但长脚本尚不稳定；最多尝试两次，转回 AX，不用它阻塞截图与菜单验证。

9230 是 DSH 跨运行时 Inspector，不等于 Electron renderer CDP。只看到 Host context 时，不能宣称控制了桌面。不能读取 Cookie 数据库另开 headless 副本来替代本机验收。

## 修改、安装与核验

1. 大区块（背景、侧栏、顶栏）→中区块（输入框、菜单、消息）→小区块（按钮、图标）。每步看真实截图。
2. 先 build，通过官方 plugin_manager 安装本候选路径。按 application/nextStep 执行；若返回 already-installed 且要求 remove/install，顺序完成两步，不在卸载状态结束。
3. applied 证明管理操作完成；还要核对实际材质、菜单与选中状态。桌面不是普通浏览器，不要求用户用 ⌘R。
4. 对宽表/长会话、菜单溢出、hover/focus/typing/pending 做额外核验。动画至少连续帧，不拿单帧证明流星运动。
5. 检查降级：减少动效、减少透明度、高对比、强制颜色。折射像素测试只证明实现，不证明好看。

## 覆盖与视觉评审

原生显式组合为 12 配色 × 2 明暗 × 4 对应氛围 × 3 材质 = 288。自动档/系统媒体查询另测；不能把不存在的第四个材质按钮算进原生覆盖。记录实际数量、清单与失败，不把采样写成全覆盖。

多模型评审给相同真实截图、相同中性标准，保留原意见。可用 `cs look <image> --ask <question>` 本地视觉；另一模型只使用已配置工具。请求路由与实际模型分开记录，无法确认填 unknown。意见不一致就不宣称一致通过；修有证据的问题，复拍再评审，不追求措辞更好听的答案。

## 经验维护

成功路径更新本 skill；通用错误只更新 docs/lessons.md，代码仅留 LES 索引。失败的 Cookie/强改 dataset 脚本已撤出默认入口。未完成的视觉复核、组合覆盖或 Web 验证必须留在交接里。

