Ulanzi Deck 通过 Ulanzi Studio 应用配置 Ulanzi 流控台的按键布局，核心思路不是逐个点击应用界面，而是在简短的布局文件中描述 profile，由脚本渲染一致的按键图、生成预览，并在应用停止时直接写入 profile，重启应用后生效。设备相关参数（数据目录、设备 id、应用路径、已安装应用）由 scripts/ulanzi.py 在运行时发现，不写入布局或说明。
主要能力
命令分为只读和写入两类。只读命令包括 state（安装/运行状态、数据目录及是否已验证、设备、当前 profile、profile 列表、备份）、keymap（按 profile 汇总每个按键）、find-apps（本机可启动应用及名称/路径）、export（把现有 profile 转为可编辑布局）、build（校验布局、解析应用、打印每键功能、渲染按键图和 preview.png）；写入命令包括 apply（构建、备份数据目录、写入并激活 profile、重启应用、验证）和 restore（恢复 apply 生成的备份）。
布局格式
按键以“列_行”命名（列在前，5x3 网格），D200/D200H 的宽幅小屏占用 3_2 与 4_2，剩 13 个键。启动应用建议用显示名称（如 "OBS Studio"），以便布局跨平台；路径仅在名称有歧义时使用。每个键需短标签、#RRGGBB 品牌色，非应用键可用 Material Icons 图标。共享布局前需替换 export 留下的机器路径。
使用方式
以技能目录的绝对路径调用脚本：uv run "<skill dir>/scripts/ulanzi.py" <command> ...（首选，uv 会按脚本头部提供 Pillow），或 python "<skill dir>/scripts/ulanzi.py" <command> ...（需 Python 3.10+ 并安装 pillow）。Windows 上回退解释器为 py -3 或 python；Windows 辅助脚本需执行策略绕过，如 powershell -NoProfile -ExecutionPolicy Bypass -File "<skill dir>/scripts/win/capture_window.ps1" -Out <png>。
典型流程：先运行 state 了解环境；若未安装，Windows 可运行 scripts/win/install.ps1（从 Ulanzi CDN 下载并拒绝非 Ulanzi 签名文件），macOS 指向官方应用页面，Linux 无官方应用；然后编写布局、运行 build 查看预览，用户确认后再 apply；出问题用 restore 恢复备份。apply 会先停止应用、备份整个数据目录、完整写入新 profile 后再移除被替换项、设为当前并重启应用；VERIFY ... OK 表示应用已重新保存该 profile，UNCONFIRMED 表示文件已就位但应用尚未确认加载，此时不要重复 apply，应打开 Ulanzi Studio 再确认。
适用场景与限制
适用于批量创建或修改 Ulanzi 流控台按键布局、从现有 profile 导出再编辑、按主题分页与文件夹组织按键、在设备上显示 AI 代理状态（如 Claude Code、Codex，需修改代理配置文件并取得明确同意）、OBS 按键（需配置 OBS WebSocket）等。限制包括：D200H 已验证，其他型号需按参考文档校准；D200X 与 Dial 的旋钮布局暂不支持，仅只读；macOS 数据目录位置或型号网格尚未验证时须先校准；布局无法表达的动作（OBS 场景、多动作、插件）需先在应用中创建单个按键再导出；不要在 Ulanzi Studio 运行时手工编辑 JSON，否则会被覆盖且跳过备份；不修改内置 profile，不自行删除备份，不深究固件与调试接口。
参考文件包括 references/layout-schema.md（布局文件、字段、校验与可移植性规则）、references/profile-format.md（Ulanzi Studio 磁盘 JSON、动作目录、网格、校准）、references/platforms.md（各平台细节与已验证项）、references/integrations.md（OBS WebSocket 与 AI 代理状态监控）。