Clarify template workflow and unify square image preview edges

This commit is contained in:
Pigway
2026-10-08 21:07:34 +08:00
parent 220521cf72
commit b90c4a700d
4 changed files with 37 additions and 6 deletions
+19 -3
View File
@@ -127,9 +127,25 @@ in the official API. Avoid having native and Frame Flow playback compete.
## Templates / 图片
Six JSON layout templates: daily-dashboard, weather, calendar, quote, photo-text,
system-alert. color and grayscale profiles. Photo data accepts photo_id = local asset
ID. Mock weather is clearly labeled; no unreliable lunar date is fabricated.
Seven JSON layout templates: daily-dashboard, weather, calendar, quote, photo-text,
daily-poetry and system-alert, with color and grayscale profiles. Every template
renders an image, including templates that contain only text.
使用流程:选择模板 → 编辑数据 → 生成预览 → 显示到画框。生成预览只创建本地图片;
保存默认数据只保存配置,两者都不会更新设备。自动化模板任务每次运行重新生成图片。
- **照片与文字 / Photo + Text**:所选照片铺满画面,底部叠加文字。
- **家庭早报 / Daily Dashboard**:日期、天气、事项、一句话与所选照片区域。
- **天气 / Weather**:当前天气与三天预报;天气 JSON 留空时使用配置的 Provider。
- **日历、每日诗词、一句话、系统告警**:将相应信息排版为图片,不自动选择图库照片。
Photos use a local asset ID (`photo_id`); without a selected photo, a placeholder
is rendered. Configure Open-Meteo and location coordinates in **Settings → Weather
source** for real weather. Forecasts are fetched on demand and cached for ten minutes;
unavailable/stale data is labeled explicitly. Weather remains static on the frame
until the next render and display, so use an Automation job for regular updates.
Official KoKonna widgets are a separate integration, not these local templates.
No unreliable lunar date is fabricated.
Contain preserves composition with margins; cover crops centrally; smart is an
edge-saliency heuristic. Always inspect preview; face-aware guarantees are not claimed.
Cloud uploads activate immediately, so gallery-only means **local staging**.