🖥️ 主界面布局
DK-Suite 主窗口由五个区域组成：顶部 TitleBar、左侧快捷指令库、中间 8×2 快捷宫格（选中格子时底部弹出设置面板）、右侧预置应用库，以及贯穿全屏的设备画面预览。
上图：v0.4.95 主窗口，当前激活的是「快捷操作」Profile
① TitleBar（标题栏）
| 区域 | 功能 | 说明 |
|---|---|---|
| LOGO | DECOKEE 品牌标志 | 纯展示 |
| AI 工作台 | 打开 Quake AI 工作台 | 内含 OpenClaw / 会议 / AI Emoji / 快捷键 / Quake 等入口 |
| 窗口按钮 | 最小化 / 最大化 / 关闭 | 全平台 |
已不在标题栏的两项
- 设备选择、Profile 名称不再放在标题栏：设备在进入主界面之前的设备选择页选，Profile 名称显示在中间面板顶部，切换在设备端旋钮或「旋钮配置」面板完成。
- 用户头像、⚙ 设置已移到左侧快捷指令库底部的账号面板。
② 左侧 — 快捷指令库（ShortCutLib）
可拖拽的指令库，交互类似 Elgato Stream Deck 的左侧面板。顶部有搜索框，支持按名称过滤。
实测 v0.4.95 的一级分组为 5 类（安装插件或检测到 OBS 后会再多出分组）：
| 一级分类 | 实测内容 |
|---|---|
| DK-Quake | 定时器、设备亮度、蜂鸣器、设备麦克风、创建子页面、家居助手、龙虾代理、AI 角色、AI 聊天显示、龙虾对话显示、龙虾输入、语音机器人 |
| 快捷操作 | 网站、热键、打开、关闭、文本、播放音频、停止播放音频、多项操作 |
| 设备控制 | 摄像头画面、Home Assistant、3D 打印机等 |
| 多媒体 | 播放/暂停/切曲、音量、静音、亮度 |
| 系统 | 系统信息（CPU/GPU/内存/磁盘/进程/网络/蓝牙/电源）、锁定、截图等 |
分组名与内容以界面实际显示为准；每一项都带图标 + 名称，拖拽到中间宫格即完成配置。
底部账号面板
左侧快捷指令库底部是账号面板（截图左下角）：左侧头像 + 用户名/角色，右侧 ⚙ 齿轮就是系统设置入口（详见 系统设置）。
③ 中间 — 快捷宫格 + 底部设置面板
8×2 快捷宫格（Shortcut Grid）
- 单击 → 选中该格，底部弹出设置面板
- 双击 → 打开该格的参数配置窗口（修改现有配置）
- 拖拽 → 同 Profile 内排序，或从左右侧拖入新项目
- 顶部显示当前 Profile 名称，右侧是 Knob 设置入口
底部设置面板（OperationConfiguration）
| 设置项 | 说明 |
|---|---|
| 图标 | 显示当前图标 + 更换按钮（选内置图标 / 自定义图片 / 重置） |
| 标题 | 修改显示文字，最多 20 字符，带字数计数器 |
| 尺寸 | 1×1 / 2×1（横跨两列）/ 1×2（竖跨两行）/ 2×2（四格合并） |
| 动作配置 | 根据指令类型动态渲染不同配置表单（见下表） |
| 时间 | 按压时长 / 按键间隔（毫秒滑块） |
| 删除 | 移除该指令 |
动作配置类型一览
| 类型 | 组件 | 配置项 |
|---|---|---|
hotkey 热键 | HotkeyConfig | 按键录制、修饰键、单击/长按 |
website 网站 | WebsiteConfig | URL、打开方式 |
app 应用 | AppConfig | 路径、启动参数 |
text 文本 | TextConfig | 文本内容、键入速度 |
multiActions 多项操作 | MultiActionsEditor | 动作编排（含延时、排序） |
pluginAction 插件 | PluginActionConfig | 插件动态表单 |
homeAssistant 智能家居 | HAConfigContent | 选实体 + 动作 |
clawbot AI 智能体 | ClawbotConfig | 选 Agent |
knob 旋钮 | KnobVoiceChatConfig | 旋钮 + 语音路由 |
aiChat AI 对话 | AIChatConfig | 角色选择 |
colorfulScreenSettings 彩屏 | ColorfulScreenSettings | 彩屏主题 |
④ 右侧 — 预置应用库（LibraryPanel）
三类来源：
| 来源 | 说明 |
|---|---|
| 预置 App | Discord、Premiere Pro、OBS 等预设指令集 |
| AI 生成 | 用户一句话描述，AI 自动生成指令配置 |
| 表情包 | 用户导入的自定义图标库 |
顶部 [+] 用于新建 AI 插件 / 表情包；从任意分组拖拽项目到中间宫格，自动完成配置。
⑤ 系统状态图标
CPU 占用、内存、磁盘、GPU、网络、电池、蓝牙、进程监控等都可以作为指令拖进宫格，在 DK-Quake 屏幕上实时显示对应的系统状态。温度单位（℃ / ℉）在系统监控设置页切换。
⑥ 子窗口体系
DK-Suite 的每个独立功能都有专属窗口：
| 窗口 | 打开方式 | 用途 |
|---|---|---|
| 主窗口 | 启动应用 | 主面板和宫格配置 |
| AI 助手 | TitleBar AI → AI Chat | AI 对话聊天 |
| 设置 | TitleBar ⚙️ | 通用 / 设备两页 |
| AI 工作台 | TitleBar 右上「AI 工作台」 | Quake AI 工作台：OpenClaw / 会议 / AI Emoji / 快捷键 / Quake |
| 新手向导 | 首次启动自动弹出 | 引导完成初始设置（见 首次使用向导） |
| 图标库 | 编辑宫格图标时 | 选择内置图标 |