主题编辑与发布
制作屏幕主题,导入图片和视频,绑定数据,并管理三个设备槽位。
主题决定设备主页的显示内容。电脑上的“本地主题”是可编辑项目,设备槽位保存的是已经发布的显示内容。保存本地项目不会自动更新设备。
创建第一个主题
- 打开 App“主题编辑器”,选择“更多 → 新建主题”。
- 在“主题设置”修改名称,选择纯色、图片或视频背景。
- 从左侧“组件”添加文字、矩形、线段、图片、圆弧或动态数据。
- 在画布上移动、缩放图层;选中图层后,在右侧“图层属性”调整位置、尺寸、颜色等参数。
- 点击“保存”,确认顶部状态变为“已保存”。
画布使用 320×240 逻辑坐标,不支持旋转图层。可以使用“撤销”“重做”调整编辑结果;“更多 → 复制主题”可创建独立副本。
支持 Cmd/Ctrl+S 保存;画布编辑状态下,Cmd/Ctrl+Z 撤销、Cmd/Ctrl+Shift+Z 重做。在输入框或弹层内编辑时,优先使用对应控件的操作。切换项目或关闭 App 前,确认本地修改已保存。
图层与动态数据
“图层”面板越靠上的项目越晚绘制,会覆盖下方图层。背景始终在最底层。可拖动图层排序或使用面板中的移动按钮。
动态字段可来自设备传感器、时间、天气、番茄钟,也可以来自电脑指标、Codex、本地插件和设备 HTTP 数据源。
- 文字可设置前缀、后缀、小数位和溢出方式。
- 支持范围显示的字段可用进度条或进度环,设置最小值与目标值。
- 圆弧可调整起始角度、扫过角度和圆心填充色;不要把圆心填充理解为扇形进度。
- “条件显示”中的多条条件需要全部满足。
- “过期策略”决定数据不可用时显示占位、隐藏,或保持最后值。“保持最后值”可能保留旧数值,不代表数据仍在刷新。
编辑器会使用实时值或预览样例。看到预览数字不代表设备已经收到对应数据。外部数据如何配置见数据源与本地插件。
条件样式与数字格式
文字、矩形进度条与进度环支持条件样式。选择数值判断源,设置比较符与阈值,再覆盖文字或填充颜色;文字还可按条件替换或清除前后缀。
每层最多四条规则,按从上到下第一条命中生效;未覆盖的属性沿用基础值,判断数据无效时使用基础样式。这与“条件显示”不同,显示条件仍需全部满足。
使用数字格式设置正负号与小数位,避免同时手写加号前缀。先检查预览和设备效果,新样式能力需要配套固件。编辑器两侧面板可拖动边界调整宽度,方便查看图层和属性。
旧主题中的心率、呼吸字段已移除,需删除或改绑后重新发布。希望让 Agent 辅助创作,可阅读 AI Agent / MCP。
文字和图片
静态文字支持回车换行。文字图层的“文本布局”可选择“裁切”“自动换行”或“换行并省略”, 动态文字更新后也会重新排版。宽度决定折行位置,高度决定可见行数;16px 中文字体 显示两行需要至少 40 像素高度。自动换行超出高度时裁切,“换行并省略”在最后可见行 显示省略号。静态及外部动态文字最多 127 个 UTF-8 字节,约 42 个普通汉字。 新自动换行模式需要支持该能力的固件,发布提示不支持时先升级;已有主题仍可继续使用。
动态文字使用设备支持的字体:中文/英文/数字 16px,以及英文/数字 14、24、40px。动态中文内容请选择支持中文的字体;遇到缺字或编译提示时,先按提示调整文字或字体。
图片可以用作背景或普通图层。适配方式包括“裁切铺满”“完整显示”和“拉伸”,分别适合铺满画面、保留全图和允许变形的场景。检查预览中的裁切结果后再发布。
静态文字选中后,符合条件时可点击“转为背景”,将它及下方可合并的静态图层合成背景图片;合并后的这些内容不再是独立可编辑图层。建议先复制主题,方便保留可编辑版本;按钮不可用时查看提示原因。
视频主题
每个主题最多一个视频,可以作为背景或可缩放图层。当前设备能力上限为 15 FPS、30 秒;App 会按设备规则处理素材,不按电脑上的原始帧率直接播放。
视频图层必须位于全部动态数据和条件图层下方。性能不足时设备可能降低实际播放帧率。三个主题槽位共享约 3 MiB 主题资源空间,视频越大,留给其他主题的空间越少。
视频处理失败时,先查看 App 错误信息,并使用完整桌面安装包。空间不足时换用更短或更简单的视频、图片背景,或删除不需要的设备槽位,再重新发布。
发布到设备
- 先完成配对,确认目标设备在线。
- 打开本地主题,点击“发布”。
- 在“目标槽位”选择槽位 1、2 或 3,查看该槽位是否已有主题。
- 点击“发布并激活”,等待编译、传输和设备回读确认。
- 看到“发布成功”后,检查设备是否显示新主题。
发布到已有主题的槽位会先删除旧主题,再写入新主题。 如果随后上传失败,目标槽位可能为空,设备会保持内置主页,不会自动恢复旧主题。需要保留旧效果时先选空槽位,并保留旧主题的本地项目或导出包。
发布期间 App 的实时连接可能短暂断开,完成后会自动恢复。这是设备腾出传输资源的行为;保持供电和 App 运行,不要同时执行 OTA 或恢复出厂设置。
提示“设备正在完成历史写入”时等待当前任务完成后重试。缺少字体、图形或数据源能力时,需要配套升级固件,而不是反复发布同一个不兼容主题。
切换和删除
- 设备主页按“下一项”,可循环切换内置主页和可用主题。
- 也可进入设备“功能 → 设备设置 → 主页”,选择“内置主页”或已保存的一号、二号、三号主题。
- App 的发布面板可对已保存槽位点击“激活”或“删除”。删除当前显示的主题时,会先切回内置主页。
- “更多 → 删除本地主题”只删除电脑项目及其素材,不删除设备主题。
- 删除设备槽位不会删除电脑上的本地项目。
导出与导入
选择“更多 → 导出主题”,保存为 .deskpulse-theme 文件,其中包含项目和原始素材。另一台电脑可以通过“更多 → 导入主题”打开,再选择设备槽位发布。
V4 主题包包含当前主题的 HTTP 请求、字段和个人参数定义;个人参数值单独保存在本机,不进入导出包。导入后填写自己的参数,电脑字段所需的插件也需在目标电脑安装。公开 URL 和 Header 会随包分享,令牌应放在个人参数中。见HTTP 配置教程。主题包不包含设备全部设置或历史记录。
App 0.1.7 起使用 V4 工程,旧 V3 工程与旧全局 HTTP 配置不迁移,需要重新创建;旧市场主题包须由作者重新发布为 V4。
主题市场下载与分享
需要个人参数的主题会提示使用前配置。获取同一市场主题的新版时会创建独立本地副本,原主题和原有个人参数保留;请在新副本中核对配置后再发布到设备。
- 在“主题编辑器”点击“主题市场”,通过搜索、分页和“最新发布 / 最近更新”寻找作品。
- 打开详情,查看图库、介绍、使用说明、配置要求和协议兼容提示。
- 无需登录,点击“添加到我的主题”,等待下载与校验完成,再点击“在编辑器中打开”。
- 按作者说明补齐数据源或插件配置,检查预览,再按上文步骤发布到设备。
添加只导入电脑主题库,不会自动写入设备,也不会因市场作品更新而自动覆盖本地项目。已有本地导入可直接在编辑器打开。
分享时先登录账号并保存本地主题,再到市场点击“发布主题”,选择已保存主题,填写名称、简介、展示图片和富文本使用说明。封面可由主题预览生成;需要外部配置时打开“需要使用前配置”,并写清操作步骤。点击“预览详情”核对内容后提交,等待上传和校验完成。
在“我的发布”中可编辑资料、选择新的已保存主题包更新,或下架作品。下架后公共列表不再显示,作者仍可编辑并重新发布。上传失败可按提示重试;切换账号前请先处理未保存修改。
市场需要网络和在线服务;本地创建、导入、导出和局域网发布可独立使用,见在线服务。