QZdesk320 × 240 桌面 AI 终端

顶部状态栏显示时间与「本地工作台」，表示界面正在和本地核心通信；右侧是 Wi-Fi 与电池。往下依次是 AI 助手、当前安排、天气，以及进入应用中心的入口。屏幕没有常驻桌面和图标，一切按优先级排布：正在发生的事永远在中间。

应用中心把技能单列为一个工作区，其余六个工具按日常使用频率排列。列表纵向滚动，看到「时钟与天气」就到末尾了。

这个尺寸下，任何通用控件库的默认边距都会把版面撑爆。所以界面走自绘路线：坐标系按 320 × 240 硬性排版，字号、行高、圆角、触摸热区逐项定死；滚动、按压、页面切换都自己实现，不依赖平台控件。

设备上跑两个进程：核心 xiaozhi_linux_r 常驻，负责会话、技能、提醒、番茄钟与设备状态；界面 qzdesk_screen 只负责画和收触摸。两者通过本地接口通信，性能页可以分别看到它们的 CPU 与内存——排查「卡」的时候，第一件事就是分清是核心慢还是界面慢。

核心是唯一状态源。语音、设备界面和网页控制台读写同一份提醒与番茄钟数据，所以在设备上暂停的计时，网页里看到的也是暂停。

动效只有几条，但每条都有时长

主题切换做约 300 ms 的交叉淡化，底色、文字、描边和强调色一起过渡，不会整屏闪一下；按钮按下时轻微缩放并变色，约 120 ms，松开回弹；页面左右滑入、面板从右侧或底部滑入，用方向表达层级。

熄屏不是一刀切：无操作满 120 秒后开始渐暗，接下来 10 秒内用 smoothstep 曲线从当前亮度降到 1%。曲线两端更平缓，所以第一眼只是轻微变暗，最后也不会突然跳黑。触摸、按键或任何交互都会立即中止并恢复原亮度；提醒弹窗、配对对话框和通知中心打开时不熄屏。

设置 QZDESK_REDUCE_MOTION=1 可关闭非必要动画，只保留状态变化。

主技能在会话开始时把正文注入模型，决定身份、语气、回复格式与工作方法，只应该启用一个；备用技能只提供目录，模型需要时才检索正文，不会覆盖主技能的人格。没有设置主技能时对话照样能连，但页面会用红字提醒。

设备屏幕只负责选择和查看，新增、编辑、启停都在浏览器里完成：手机或电脑打开 http://<设备IP>:8080 进入技能控制台。改完保存后配置版本变化，下一次唤醒重建会话，新技能才生效。

八项陪伴能力

它们不是八个独立人格，也不会自动切换主技能：共用同一份对话上下文与设备工具，所以说话方式始终来自当前主技能。

优先走 UI Automation，而不是抢鼠标

推荐让助手使用 UiAction：它通过 Windows UI Automation 找到控件并执行动作，不移动鼠标、不抢键盘焦点，适合你还在用电脑时做后台操作。物理输入类工具会接管鼠标键盘，只在设备已授权且本机空闲时使用。

还有一个 USER_CONTROL 门控：你一动手操作鼠标或键盘，控制权立刻交还给你；也可以在连接器界面点「停止访问」直接断开。

安全边界写在默认值里

连接器默认只读，只有设备端明确授权后才启用控制；token 由 Windows DPAPI 加密保存，IP 白名单只放行已配对设备。它不提供 TLS，因此只适合可信局域网，不要把 8000 端口映射到公网——这一点写在手册和程序说明里，而不是留给用户猜。