way/pigway-frame-flow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 29 Wiki Activity

29 Releases 29 Tags

RSS Feed
  • v0.1.0 80c6bf3b7d
    Compare

    Pigway Frame Flow v0.1.0 Stable

    way released this 2026-10-11 08:23:12 +08:00 | 106 commits to main since this release

    简体中文

    Pigway Frame Flow 首个正式版本：可独立运行的智能画框自动化平台。

    功能

    • 中英文 Web UI、深浅色主题、账号登录与设备状态面板。
    • KoKonna API Key 接入；官方账号能力单独授权，不向外部调用方交付设备密钥。
    • 本地/云端图库、图片预览、星标、来源与任务筛选、批量操作和横竖方向选择。
    • 七种图片模板、天气 Provider、照片与文字、自动随机照片和定时任务。
    • 1–12 张图片的拼图/海报，以及可选的 OpenAI 兼容 AI 排版。
    • Synology Photos 人物筛选、NAS 文件夹、WebDAV 与可选网盘数据源。
    • 播放列表、优先级覆盖/恢复、SQLite 持久化和操作历史。
    • /api/v1、OpenAPI/Swagger、异步操作、幂等请求和外部客户端鉴权；Ticktar 集成为可选项。
    • Docker/NAS 部署、隔离 CI 与带健康检查和回滚的自动部署。

    验证与安装

    发布 commit：80c6bf3b7d28bc55608d03fb3ef6b2bd690df50e。CI #62 的 Verify/Deploy 全部通过，451 项自动测试通过；线上 /health、/ready 均为 HTTP 200。

    参见 中文安装说明。当前默认配置与已验证平台为 AMD64。
    附件 NAS 包是源码部署包，需要自行构建 Docker 镜像；不含密钥、私人配置、数据库或照片。SHA256 文件用于校验下载内容。

    已知边界

    云端同步不代表已确认物理屏幕刷新；KoKonna 云端上传会立即切换。结果未知的写请求不会自动重试。官方原生轮播成员编辑不可用。可选天气/AI/网盘等需单独配置授权；当前为单 Worker 服务，不面向多副本部署。

    English

    The first official release of Pigway Frame Flow, an independent self-hosted smart-frame automation platform.

    Features

    • Chinese/English Web UI, light/dark themes, account login and device dashboard.
    • KoKonna API-key integration and separately authorized official-account capabilities; device credentials stay server-side.
    • Local/cloud galleries, previews, stars, source/task filters, batch actions and orientation selection.
    • Seven image templates, weather providers, Photo + Text, scheduled random photos and automation.
    • Collages/posters with 1–12 images and optional OpenAI-compatible AI layout planning.
    • Synology Photos person filtering, NAS folders, WebDAV and optional cloud-drive sources.
    • Playlists, priority overrides/restore, SQLite persistence and operation history.
    • /api/v1, OpenAPI/Swagger, asynchronous operations, idempotency and client authentication. Ticktar integration is optional.
    • Docker/NAS deployment, isolated CI and health-checked automatic deployment with rollback.

    Validation and installation

    Release commit: 80c6bf3b7d28bc55608d03fb3ef6b2bd690df50e. CI #62 Verify/Deploy passed, including 451 tests; live /health and /ready returned HTTP 200.

    See the English installation guide. AMD64 is the current default configuration and verified platform.
    The NAS attachment is a source deployment package, not a prebuilt Docker image. It contains no keys, private configuration, databases or photos. Use the SHA256 file to verify it.

    Known limits

    Cloud sync does not prove physical screen refresh. KoKonna cloud uploads activate immediately. Uncertain writes are never automatically replayed; native slideshow membership editing is unavailable. Optional providers need separate configuration/authorization. The service uses a single worker and is not designed for multiple replicas.

    Downloads