-
Pigway Frame Flow v0.1.4 Stable
way released this
2026-10-16 12:25:16 +08:00 | 95 commits to main since this release简体中文
错误与重试策略
- 根据官方文档区分 HTTP 500 中明确的业务拒绝与真正未知结果，避免无效密钥、图片不存在或参数错误误锁设备。
- 只读临时失败、连接建立超时和明确的限流拒绝最多尝试 3 次；普通退避 1/2 秒，遵守 Retry-After 和本地 18 次/分钟预算，超过等待上限不提前请求。
- 写入读取超时、一般连接异常、通用 5xx 或无效成功响应均不重发；保留只读核对和写入保护。
恢复与可观测性
- 持久化恢复原因、检查次数、检查时间与人工处理状态，随 Operation API 返回。
- 长期未解决的操作生成一次 operation.blocked 事件和 MANUAL_REVIEW_REQUIRED 历史记录；重启不会重复升级。可选择配置 Webhook 通知，未订阅不会自动对外通知。
- 单条核对异常不会中断其他后台工作。无效布尔上传 ID 不会被当成有效图片 ID。
- 新增中文错误矩阵和操作手册，更新 OpenAPI 与契约快照。
验证
本地 505 项测试、Ruff、格式检查、mypy 和差异检查通过；CI #78 的 505 项测试、静态检查、25 个依赖漏洞审计、隔离 Docker 构建/冒烟/重启验证及生产部署全部通过。线上 9 个只读端点和恢复状态 API 契约已验证。
发布提交：a843d4de9bc34a709a1261d61839e2bebd3b3054。
完整错误与恢复策略。
附件为 NAS 源码包及 SHA256 校验文件，不含运行配置、密钥、数据库或私人照片。需自行构建 Docker 镜像。边界
厂商未提供幂等写入和可靠的上传状态查询契约。没有证据的未知写入仍需人工核对，不能靠超时无条件解除保护，也不能保证网络故障时所有任务都自动成功。
English
Add documented failure classification, bounded retries for read-only requests and writes proven unsent or rate-limit rejected, and durable recovery progress/escalation. Ambiguous writes are never replayed. Operation recovery metadata, a one-time operation.blocked event, updated OpenAPI, and a Chinese recovery guide make unresolved blocks visible and actionable.
CI #78 passed all 505 tests, static checks, the 25-dependency vulnerability audit, isolated Docker smoke/restart checks and production deployment. Nine live read-only endpoints and the recovery API contract were verified. Release commit:
a843d4de9bc34a709a1261d61839e2bebd3b3054. NAS source package and SHA256 checksum included. Unknown outcomes without sufficient evidence still require manual review.Downloads