198 lines
17 KiB
Markdown
198 lines
17 KiB
Markdown
# 版本记录
|
||
|
||
以下为已有版本记录，不代表当前生产运行状态。当前安装与开发说明见项目首页。
|
||
|
||
## v0.1.19
|
||
|
||
- 修正 v0.1.18 的群晖照片方向筛选：Photos 返回的 resolution 已按显示方向转正，不能再按 EXIF 交换宽高。横向来源排除竖图，竖向来源保留竖图。
|
||
- 保留下载后、裁剪前对实际图片的 EXIF 方向校验，防止预览或元数据不一致导致错误裁剪。
|
||
- 使用共享与个人空间的合成数据覆盖 EXIF 5–8，验证已转正尺寸不会重复旋转。
|
||
- 不修改 NAS 原图，不自动重新生成或发送已有图库照片；发行制品保留 LICENSE、NOTICE，私有配置和验证回执留在仓库外。
|
||
|
||
## v0.1.18
|
||
|
||
- Synology Photos 列表显式请求照片方向信息；按 EXIF 旋转后的宽高筛选横向、竖向和自动方向，避免存储像素为横向的竖拍照片误入横图来源。
|
||
- 渲染前复核实际取得图片的 EXIF 方向；若元数据或缓存预览与来源方向不符，则跳过该候选。显式选择方向不符的照片时返回明确错误。
|
||
- 保持既有水印和铺满布局，不修改 NAS 原照片、来源设置或现有图库；修复不自动重新生成、上传或切换已显示图片。
|
||
- 源码及镜像保留 LICENSE、NOTICE；公开验证只使用合成照片和通用示例，私有部署参数与回执保存在仓库之外。
|
||
|
||
## v0.1.17
|
||
|
||
- 总览预览改用原图，避免放大低分辨率缩略图。
|
||
- 云端图库缩略图升级为最大 860×860，等比缩放、JPEG 质量 88；原位替换旧缓存，仍只保留一档。点击放大继续读取原图。
|
||
- 照片源新增最小短边、最小长边参数，同时检查源照片和实际取得的预览尺寸，默认 0 不限制。
|
||
- 本地图库显示 NAS 原照片完整路径并支持换行，保留原文件名大小写和后缀；历史四张图片已按照片 ID 核实并补齐来源。
|
||
- 自动化新增“目标相框”列；历史记录的状态、结果、调用方及操作按钮垂直居中。
|
||
- 左上角统一显示 PIGWay Frame Flow，移除图标和重复品牌前缀。
|
||
- 设置与鉴权保持左右并排、卡片等高，鉴权内部单列。图片预览弹窗保留原有布局。
|
||
|
||
不修改 NAS 原照片，不主动切换真实画框。清理仅针对项目临时构建物及过期镜像，保留持久数据和近期回滚资源。
|
||
|
||
## v0.1.16
|
||
|
||
统一 PIGWay 品牌写法，优化图库、自动化、历史记录、设置、连接中心和拼图页面布局。
|
||
|
||
- 图库直接点击图片查看，移除重复的查看按钮；缩略图底框为正方形，卡片宽度适配单行操作按钮。
|
||
- 全站共用更宽的内容区域，宽屏图库可一行显示三张卡片；搜索、排序、来源和任务筛选合并排列。
|
||
- 自动化与历史记录状态改为仅保留颜色的文字，优化列宽与操作对齐。
|
||
- 设置与鉴权信息保持左右并排，鉴权卡片内部信息改为单列；相关设置控件紧凑排列。
|
||
- 连接中心和自动拼图短字段合并排列，按钮按内容宽度显示，空结果提示不再占据额外空间。
|
||
- 窄屏自动换行，保留图片预览、长文本和表格所需空间。
|
||
|
||
本轮界面检查覆盖 11 个主页面、本地图库及弹窗，中英文、明暗主题和四种屏幕宽度共 289 项布局检查通过；隔离环境拼图流程 8 项检查通过。生产部署后的界面复查使用隔离数据，没有执行真实画框写入。
|
||
|
||
## v0.1.15
|
||
|
||
自动照片、拼版、模板及数据模板任务在上传失败后，持久保存同一张暂存图片，并在下一次计划之前安排最多 5 次额外重试。间隔按 1、2、4、8、16 权重递增，随剩余窗口缩放，计划时间集中在窗口前半段，为上传与设备同步留出时间。重试不移动原定计划，也不复用旧操作 ID；每次独立记录操作及事件。成功后取消剩余重试，重启后沿用已有计数与截止时间；停用任务不再追加重试，删除任务取消其重试计划。
|
||
|
||
若额外重试均失败，下一次计划仍先上传同一张图；若这一次仍失败，只删除该任务未入库、未星标的生成缓存，再按照片源生成并上传新图。NAS 原照片、用户上传文件和成功图库图片不由此流程删除。新图仍失败时，进入它自己的下一轮恢复窗口。
|
||
|
||
上传结果未知不再阻塞后续独立上传。每次重试前先只读核对设备及云图库，精确确认已成功的上传不再重传；需继续尝试时关闭旧尝试并保留错误和核对审计。删除、恢复及自动清理仍保留各自的保护条件。重试窗口到期后不再启动额外上传，待同步尝试经核对结束后交给原计划执行。
|
||
|
||
任务生成图片先保存在缓存，确认任务成功后才进入本地图库；失败不会产生看似成功的本地图库记录。额外重试仍归属原任务的云端保留规则，任务列表显示最近尝试结果。
|
||
|
||
## v0.1.14
|
||
|
||
底部文字仅显示日期、已命名人物（使用 & 连接）、文件夹主题及地点，不显示原始文件名。原始文件名仍用于图库和诊断记录。
|
||
|
||
上传传输区分明确的 DNS/连接建立失败与已建立连接中断：前者尚未发送 HTTP 写入，最多重试三次，失败后结束该次操作，不进入阻塞后续写入的 UNKNOWN；读超时或连接中断等不确定结果继续保留核对保护，不盲目重放上传。既有未知操作通过只读设备/图库核验后使用原有 acknowledge 流程关闭，保留原始错误和审计记录。
|
||
|
||
## v0.1.13
|
||
|
||
照片底部同时显示所有已识别且已命名的人物，人物之间使用 ` & `；日期、人物、主题、地点及文件名之间继续使用 ` · `。例如 `2026-10-18 · Alice & Bob · Family · one.jpg`。人物仍来自 Photos 实际相册归属，未命名人物不显示；历史生成图片不自动重绘。
|
||
|
||
## v0.1.12
|
||
|
||
修复临时展示到期或手动恢复后，“上一张图片”仍指向当前图片，导致已确认删除仍被恢复保护拦截的问题。只有设备已确认同步到受管理的当前图片、且没有基础恢复目标、临时展示或待确认写入时，才清除这条自身引用；不同图片的有效恢复引用继续受保护。既有残留引用在读取设备状态或删除校验时自动修正，不需要强制删除图片或重置数据库。
|
||
|
||
有效恢复引用仍拒绝删除，并通过结构化原因显示中英文提示。保留当前图片删除确认，不主动删除照片或切换画框。
|
||
|
||
## v0.1.11
|
||
|
||
照片底部单行按“日期 · 已命名人物 · 主题 · 地点 · 文件名”排列，空项省略，人物之间也使用 ` · `。主题、日期和地点沿用最近的日期文件夹解析；没有结构化日期目录时仍保留文件名。人物来自 Synology Photos 已命名人物相册的实际图片归属，按账号会话和空间缓存 15 分钟，不显示未命名人物编号。人物查询失败时保留图片及其他描述。
|
||
|
||
新建照片源默认开启底部文字，既有来源保留明确设置。横向来源继续同时约束选图和生成画布，不拉伸图片。更新来源表单说明与浏览描述顺序。
|
||
|
||
使用既有 Ubuntu Server 发布流程，备份配置、数据库与 Compose，从提交源码构建并核验部署哈希；失败恢复旧 Compose。发布过程不主动切换真实画框，不重绘历史图库图片。
|
||
|
||
## v0.1.9
|
||
|
||
照片来源通过 Synology Photos API 按账号权限读取，共享/个人空间、人物 any/all 筛选和有界 XL 预览缓存可用。生产拒绝文件系统照片来源及 /photos 挂载；本地上传、生成图片和 Server 本地图库继续保留。NAS 原图下载接口曾被拒绝，本版不宣称支持原图下载。
|
||
|
||
自动化新增 1～10080 分钟的真实间隔，跨整点与跨天不按 Cron 字段重置，既有 Cron 任务保持原样。显示时长明确为到期恢复期限。统一来源快捷创建任务编辑器，改善登录及来源表单响应式布局、设备显示名与历史记录中英文；诊断详情保留原始标识。
|
||
|
||
## 生产部署
|
||
|
||
生产已迁至 Ubuntu Server，由 systemd 管理 Docker；业务、Docker 数据和恢复资料位于 T7，并有 UUID 与挂载依赖保护。NAS 旧 Frame 专属资源已清理且独立复核 PASS。CI 保留隔离验证，移除 NAS 自动生产部署任务，不再向 NAS 发布。
|
||
|
||
正式发布使用 scripts/server-release.py：仅在既有 Ubuntu Server 环境运行，从已提交源码包构建，校验依赖锁、源码哈希、T7 UUID、容器安全约束和真实写入设置；备份 SQLite、配置及 Compose 后切换镜像，失败恢复旧 Compose，不自动回写旧数据库。它不执行上传、显示、删除或恢复图片等设备操作。成功后记录正式提交号、保存源码包及审计回执，删除本次暂存目录；白名单内的 Frame 旧迁移输入归档到本次 recovery，清除无恢复引用的临时镜像别名，共享 Console 资料不动。旧镜像及历史恢复资料保留供回滚，不执行全局 prune。
|
||
|
||
脚本要求由 git archive 生成的源码放在 <FRAME_FLOW_ROOT>/migration-inbox 的独立子目录；目录内同时提供 RELEASE_COMMIT、RELEASE_HASHES.json 和原始 source.tar.gz。哈希清单涵盖源码与源码包，不含自身。执行 sudo python3 <暂存目录>/scripts/server-release.py；成功后读取 <FRAME_FLOW_ROOT>/apps/pigway-frame-flow/release-verification.json 并独立检查线上接口。
|
||
|
||
## 验收范围
|
||
|
||
完整后端测试、静态检查与桌面/平板/手机的中英文浏览器回归纳入发布检查。线上历史补丁已核验，真实写入保持开启；本轮正式发布不重复真实设备写入测试。隔离浏览器验证与真实设备写入证据由维护者私下保管。
|
||
|
||
局域网 HTTPS、独立加密备份及恢复演练仍是后续工作；T7 recovery 不属于独立备份。没有执行 USB 断连、服务器重启或压力测试。
|
||
|
||
## PIGWay Frame Flow v0.1.8
|
||
|
||
增加 NAS 本地图库反选、放大总览图片，并统一图片查看器与界面表达。
|
||
|
||
- 反选只切换当前页可见图片的勾选状态；隐藏勾选项的批量操作范围明确提示。
|
||
- 总览当前图片预览增大，点击或键盘打开与图库相同的查看器，读取原图并支持适应屏幕、原始尺寸和 Esc 关闭。
|
||
- 修正图库排序、播放顺序、型号信息来源、云端确认状态等标签，补齐天气与连接状态翻译。
|
||
- 区分本地与云端删除影响，解释星标保留规则，避免对未知来源作无依据判断。
|
||
- 修正数据源空态、路径与凭据说明；同步 README 和操作文档中的共享 Photos 登录机制与入口。
|
||
|
||
验证：305 项布局检查、8 组星标与反选检查、12 组总览查看器检查、45 项图片加载检查及新增中英文文案检查通过。全套后端与静态检查由本次发布流水线再次验证。检查不涉及真实照片删除、设备写入或收费 AI 调用。
|
||
|
||
Improve NAS gallery selection, dashboard image viewing and UI wording. Invert selection affects visible items on the current page. Dashboard previews open the same full-image viewer as the gallery. Storage destinations, deletion scope, server-side stars, cloud confirmation and shared Photos credentials are clarified in both languages.
|
||
|
||
## PIGWay Frame Flow v0.1.7
|
||
|
||
## 简体中文
|
||
|
||
修复首次打开图库时内容区空白、必须等待云端图片列表返回才出现控件的问题。
|
||
|
||
- 目的地标签、搜索、排序、刷新和上传按钮立即初始化，图片列表独立请求。
|
||
- 仅在工具栏提示正在读取列表；未知数量时不生成图片卡片，不提前显示“图库为空”。实际图片仍在自己的区域内独立加载。
|
||
- 启动使用轻量设备身份目录，完整设备状态在后台更新，避免厂商状态请求阻塞首屏。
|
||
- 慢请求期间可以切换到 NAS 图库；过期响应不会覆盖当前页面。
|
||
- 列表失败时保留控件并在工具栏显示错误，仍可刷新或切换目的地。
|
||
- 保留等待期间输入的搜索词和排序选择；本地任务筛选请求在同一次导航内复用。
|
||
|
||
### 验证
|
||
|
||
本地 508 项 Python 测试、Ruff、格式检查、mypy 和 JavaScript 语法检查通过。
|
||
新增首次未缓存列表的控件就绪、输入保留、慢云端切换和列表失败回归。
|
||
不增加图库列表的服务端缓存，不修改厂商请求重试、照片、生成内容或设备写入策略。
|
||
|
||
## English
|
||
|
||
Fix the blank gallery on its first uncached visit. Destination tabs and gallery controls initialize before metadata requests complete.
|
||
Slow or failed cloud listing does not prevent switching to NAS storage. Search and sort choices survive list arrival, and stale responses cannot replace the active destination.
|
||
Only a small toolbar status indicates metadata loading; real images keep independent loading indicators.
|
||
|
||
## PIGWay Frame Flow v0.1.6
|
||
|
||
## 简体中文
|
||
|
||
- 图库使用具体目的地标签：`KoKonna 云端图库` 与 `<NAS 名称> 本地图库`，NAS 名称通过 `FRAME_FLOW_STORAGE_NAME` 配置。
|
||
- Settings API 增加目的地元数据，标签仅展示连接已配置、明确支持保存且存在适配器的目的地；全局写入保护保持独立。
|
||
- 后续网盘须实现读取/保存适配器并完成连接后才能加入标签栏，显示具体服务商/实例名称。当前只读照片来源不会作为保存目的地展示。
|
||
- 长标签在手机上换行，避免整页横向溢出；中英文保持相同目的地身份。
|
||
- Compose 和自动部署透传 NAS 展示名称；分支 CI 完整验证后发布标签，避免相同提交的标签推送重复占用构建队列。
|
||
|
||
### 验证
|
||
|
||
本地 507 项 Python 测试、Ruff、格式检查、mypy、JavaScript 语法检查通过。
|
||
图库目的地标签与能力过滤 18 项浏览器检查通过；覆盖 320–1440 像素、中英文、明暗主题和长 NAS 名称。
|
||
本次不增加任何网盘写入功能，不改变画框写入策略。
|
||
|
||
### 升级
|
||
|
||
Compose 设置 `FRAME_FLOW_STORAGE_NAME`；Actions 设置同名仓库 Variable。
|
||
名称只描述实例，不作为路径或授权凭据。未设置时回退为 NAS。
|
||
默认访问端口仍为 6005，容器内部端口仍为 18787。
|
||
NAS 源码包与 SHA256 附件不含运行配置、密钥、数据库或私人照片，需自行构建镜像。
|
||
|
||
## English
|
||
|
||
Gallery tabs identify the concrete destination: KoKonna cloud gallery and the configured NAS name plus Local gallery.
|
||
Destination metadata includes connection and upload capabilities; only implemented writable adapters are shown.
|
||
Existing read-only cloud photo sources are not presented as save destinations. Long labels wrap on mobile.
|
||
Set FRAME_FLOW_STORAGE_NAME in Compose or the Actions repository Variables. No cloud-drive write support or device write policy is changed.
|
||
|
||
## PIGWay Frame Flow v0.1.5
|
||
|
||
## 简体中文
|
||
|
||
- 图片仅在真实图片区域内居中显示加载动画，无页面骨架、虚构图片卡片或人为展示延时；请求及解码完成后立即显示，失败时显示局部提示。
|
||
- 图库搜索、排序、卡片操作及写入保护先于图片请求初始化，复用真实列表元数据；本地任务筛选异步填充，不阻塞其他控件。
|
||
- 手动拼版改为并行加载，各图独立完成或失败；固定区域容器保留坐标和拖动交互，加载前后位置一致。
|
||
- 修复手机底栏文字裁切、窄屏页头拥挤和横屏导航可达性，支持底部安全区域，补齐表单标签和当前导航无障碍状态。
|
||
- 默认对外访问端口改为 **6005**。本地启动、Compose、测试地址及文档同步；容器内部仍监听 18787。
|
||
|
||
### 验证
|
||
|
||
本地 505 项 Python 测试、Ruff、格式检查、mypy、JavaScript 语法和差异检查通过。
|
||
浏览器回归：布局 305 项、图片加载 45 项、图库加载顺序 14 项、手动拼版 31 项通过。
|
||
先行 UI 部署的生产静态文件哈希、health/ready 和拦截测试数据下的浏览器交互已验证；
|
||
不代表真实 AI 生成、画框写入、手机实机或软键盘测试。
|
||
|
||
### 升级说明
|
||
|
||
已有安装须更新私有环境配置中的 `WEB_PORT=6005`，并重建服务后生效。
|
||
自动部署的 `PROD_WEB_PORT` 必须与现有实例的映射一致；仅修改该变量不能迁移端口。
|
||
NAS 附件是源码部署包，需自行构建 Docker 镜像，不含密钥、运行配置、数据库或私人照片。
|
||
|
||
## English
|
||
|
||
Image loading indicators stay inside real image regions, without page skeletons or artificial delays.
|
||
Gallery controls initialize before image requests. Manual collage images load independently in parallel,
|
||
with stable regions and working coordinate/drag controls. Mobile navigation, safe-area spacing and form
|
||
accessibility are improved. The default published port is now **6005**, mapped to container port 18787.
|
||
Existing installations must update their private port configuration and recreate the service.
|
||
NAS source package and SHA256 checksum are included; this is not a prebuilt Docker image.
|