lixi
0b0317415b
CI / docs-build (push) Successful in 39s
记录从官方文档实际读到的事实，供实现与排查引用，并把开工时「待服务商文档确认 的五项」逐条落定。实现在 patbond-ai（58 测试）。 要点（详见正文）： - **不支持幂等键**：ADR-023 §4 设想的「透传为厂商幂等头」对本供应商不成立， 风险窗口只能由 max_attempts 兜住。但厂商支持 callback_url，孤儿任务会通过 回调把 ID 送回——回调在此供应商上是**孤儿回收通道**而非仅延迟优化， §4「M4 只做轮询」值得据此复评。 - **产物 URL 仅 24 小时有效**（2.5 另有 100 次下载上限）：厂商 URL 不能当存储 用，存成 external_url 会变死链。**这对挂起中的存储决策是硬约束**——无论选 本地还是云，都必须在 24 小时内把文件复制到我们自己的存储。 - **两处文档自身的矛盾**已登记并按宽实现：状态枚举在查询文档与回调说明里 不一致（后者多一个 expired）；QuotaExceeded 一码两义（排队超限 vs 额度耗尽， 只能按 message 判别）。 - 两个免费收益：last_frame_url 可直接作视频封面（R13 把缩略图列为视频成本项， 实际免费）；查询返回 ratio/resolution/fps/duration，Worker 写产物时维度与 时长在手、无需解码，widthPx/heightPx 债在 AI 产物上零成本可修。 - 取消语义：厂商只支持取消 queued 状态，已 running 的任务取消后仍计费。 - 用户提供的两份文档**文件名与内容装反了**（火山错误码.md 里是查询 API）， 已按实际内容归档并注明，避免他人按文件名读错。 另：V7 目录种子仍待确认账号实际开通的 model ID——文档里的示例值不能直接当种子， 否则 provider_model_name 会指向无权访问的模型（InvalidEndpointOrModel.NotFound）。 验证：secret-scan exit 0；mkdocs build --strict exit 0（已挂导航）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
126 lines
10 KiB
YAML
126 lines
10 KiB
YAML
site_name: Patbond Docs
|
|
theme:
|
|
name: readthedocs
|
|
nav:
|
|
- 首页: index.md
|
|
- 开发文档:
|
|
- 开发实施计划: development/development-plan.md
|
|
- Git 工作流规范: development/git-workflow.md
|
|
- 功能完成清单: development/feature-checklist.md
|
|
- 真机验证清单: development/device-verification.md
|
|
- 发布记录: development/releases.md
|
|
- 服务器暴露面清单: development/server-exposure.md
|
|
- CI Runner 部署手册: development/ci-runner-setup.md
|
|
- 服务商接口:
|
|
- 火山方舟 Seedance（视频）: development/providers/volcengine-seedance.md
|
|
- 第一迭代:
|
|
- 进展看板: development/iterations/iteration-1/index.md
|
|
- 01 任务分解: development/iterations/iteration-1/01-pm-task-breakdown.md
|
|
- 02 技术评估: development/iterations/iteration-1/02-dev-technical-assessment.md
|
|
- 03 现状核实: development/iterations/iteration-1/03-reality-check.md
|
|
- 04 登录 UI 设计规范: development/iterations/iteration-1/04-ui-login-design-spec.md
|
|
- 05 埋点规划: development/iterations/iteration-1/05-experiment-tracking-plan.md
|
|
- 06 质量审计: development/iterations/iteration-1/06-evidence-audit.md
|
|
- 07 后端基线改造报告: development/iterations/iteration-1/07-backend-baseline-report.md
|
|
- 08 Flutter 主题迁移报告: development/iterations/iteration-1/08-flutter-theme-report.md
|
|
- 09 任务板更新: development/iterations/iteration-1/09-pm-board-update.md
|
|
- 10 持久化纵切报告: development/iterations/iteration-1/10-backend-persistence-report.md
|
|
- 11 第一波复核: development/iterations/iteration-1/11-reality-recheck.md
|
|
- 12 UI QA 与登录组装稿: development/iterations/iteration-1/12-ui-design-qa-and-assembly.md
|
|
- 13 埋点实现规范: development/iterations/iteration-1/13-tracking-implementation-spec.md
|
|
- 14 里程碑证据档案: development/iterations/iteration-1/14-evidence-milestone-dossier.md
|
|
- 15 Git 收尾报告: development/iterations/iteration-1/15-git-workflow-report.md
|
|
- 16 后端认证会话报告: development/iterations/iteration-1/16-backend-auth-report.md
|
|
- 17 Flutter 登录纵切报告: development/iterations/iteration-1/17-flutter-login-report.md
|
|
- 18 真机联调 E2E 报告: development/iterations/iteration-1/18-e2e-integration-report.md
|
|
- 19 埋点系统实现报告: development/iterations/iteration-1/19-analytics-implementation-report.md
|
|
- 20 第一迭代收官总结: development/iterations/iteration-1/20-iteration-1-summary.md
|
|
- 第二迭代:
|
|
- 进展看板: development/iterations/iteration-2/index.md
|
|
- 01 任务分解: development/iterations/iteration-2/01-pm-task-breakdown.md
|
|
- 02 后端技术评估: development/iterations/iteration-2/02-backend-technical-assessment.md
|
|
- 03 Flutter 技术评估: development/iterations/iteration-2/03-flutter-technical-assessment.md
|
|
- 04 现状核实: development/iterations/iteration-2/04-reality-check.md
|
|
- 05 健康档案 UI 设计规范: development/iterations/iteration-2/05-health-record-ui-spec.md
|
|
- 06 埋点规划: development/iterations/iteration-2/06-experiment-tracking-plan.md
|
|
- 07 证据基线审计: development/iterations/iteration-2/07-evidence-baseline-audit.md
|
|
- 08 Git 工作流规划: development/iterations/iteration-2/08-git-workflow-plan.md
|
|
- 09 契约补录 events: development/iterations/iteration-2/09-events-contract-backfill.md
|
|
- 10 Flutter 埋点修复: development/iterations/iteration-2/10-flutter-analytics-repair.md
|
|
- 11 后端地基报告: development/iterations/iteration-2/11-backend-foundation-report.md
|
|
- 12 第一波收口: development/iterations/iteration-2/12-wave1-closure.md
|
|
- 13 宠物 CRUD 与权限框架: development/iterations/iteration-2/13-pets-crud-permission-report.md
|
|
- 14 契约起草说明: development/iterations/iteration-2/14-pets-contract-draft.md
|
|
- 15 埋点持久化队列: development/iterations/iteration-2/15-analytics-persistent-queue.md
|
|
- 16 体重与疫苗接口: development/iterations/iteration-2/16-weights-vaccinations-report.md
|
|
- 17 健康事件与提醒接口: development/iterations/iteration-2/17-events-reminders-report.md
|
|
- 18 档案聚合摘要: development/iterations/iteration-2/18-pet-summary-report.md
|
|
- 19 契约冻结报告: development/iterations/iteration-2/19-contract-freeze-report.md
|
|
- 20 契约一致性测试: development/iterations/iteration-2/20-contract-test-report.md
|
|
- 21 第二波收口: development/iterations/iteration-2/21-wave2-closure.md
|
|
- 22 pets 数据层: development/iterations/iteration-2/22-pets-feature-datalayer.md
|
|
- 23 宠物页面接入: development/iterations/iteration-2/23-pets-pages-report.md
|
|
- 24 埋点白名单 v2: development/iterations/iteration-2/24-event-whitelist-v2.md
|
|
- 25 体重疫苗模块: development/iterations/iteration-2/25-weights-vaccines-ui-report.md
|
|
- 26 时间线与提醒页: development/iterations/iteration-2/26-timeline-reminders-report.md
|
|
- 27 第三波收口: development/iterations/iteration-2/27-wave3-closure.md
|
|
- 28 E2E 烟囱收官: development/iterations/iteration-2/28-e2e-smoke-report.md
|
|
- 29 M2 收官总结: development/iterations/iteration-2/29-m2-summary.md
|
|
- 30 真机补验清单: development/iterations/iteration-2/30-device-verification-checklist.md
|
|
- 第三迭代:
|
|
- 进展看板: development/iterations/iteration-3/index.md
|
|
- 01 任务分解: development/iterations/iteration-3/01-pm-task-breakdown.md
|
|
- 02 后端技术评估: development/iterations/iteration-3/02-backend-technical-assessment.md
|
|
- 03 Flutter 技术评估: development/iterations/iteration-3/03-flutter-technical-assessment.md
|
|
- 04 现状核实: development/iterations/iteration-3/04-reality-check.md
|
|
- 05 社区 UI 设计规范: development/iterations/iteration-3/05-community-ui-spec.md
|
|
- 06 埋点规划: development/iterations/iteration-3/06-experiment-tracking-plan.md
|
|
- 07 证据基线审计: development/iterations/iteration-3/07-evidence-baseline-audit.md
|
|
- 08 Git 工作流规划: development/iterations/iteration-3/08-git-workflow-plan.md
|
|
- 09 社区地基报告: development/iterations/iteration-3/09-community-foundation-report.md
|
|
- 10 埋点队列加固: development/iterations/iteration-3/10-analytics-queue-hardening.md
|
|
- 11 社区契约起草: development/iterations/iteration-3/11-community-contract-draft.md
|
|
- 12 防泄漏检查落地: development/iterations/iteration-3/12-secret-scan-rollout.md
|
|
- 13 media MinIO 闭环: development/iterations/iteration-3/13-media-minio-report.md
|
|
- 14 第一波收口: development/iterations/iteration-3/14-wave1-closure.md
|
|
- 15 帖子生命周期: development/iterations/iteration-3/15-post-lifecycle-report.md
|
|
- 16 Feed 与作者链路: development/iterations/iteration-3/16-feed-author-report.md
|
|
- 17 评论与互动: development/iterations/iteration-3/17-comments-interactions-report.md
|
|
- 18 契约冻结 v1.3.0: development/iterations/iteration-3/18-contract-freeze-report.md
|
|
- 19 快照同步与矩阵: development/iterations/iteration-3/19-contract-sync-report.md
|
|
- 20 第二波收口: development/iterations/iteration-3/20-wave2-closure.md
|
|
- 21 社区数据层: development/iterations/iteration-3/21-community-datalayer.md
|
|
- 22 埋点白名单 v3: development/iterations/iteration-3/22-event-whitelist-v3.md
|
|
- 23 媒体上传客户端: development/iterations/iteration-3/23-media-upload-client.md
|
|
- 24 Feed 页接入: development/iterations/iteration-3/24-feed-page-report.md
|
|
- 25 详情页与互动: development/iterations/iteration-3/25-detail-interactions-report.md
|
|
- 26 发布页与漏斗: development/iterations/iteration-3/26-publish-page-report.md
|
|
- 27 第三波收口: development/iterations/iteration-3/27-wave3-closure.md
|
|
- 28 E2E 烟囱收官: development/iterations/iteration-3/28-e2e-smoke-report.md
|
|
- 29 M3 收官总结: development/iterations/iteration-3/29-m3-summary.md
|
|
- 30 发布 E2E 回归: development/iterations/iteration-3/30-release-e2e-regression.md
|
|
- M3.5 体验补齐:
|
|
- 01 任务分解: development/iterations/iteration-3.5/01-pm-task-breakdown.md
|
|
- 02 客户端体验修复: development/iterations/iteration-3.5/02-client-ux-fixes.md
|
|
- 03 后端资料与头像: development/iterations/iteration-3.5/03-backend-profile-avatar.md
|
|
- 04 契约冻结 v1.4.0: development/iterations/iteration-3.5/04-contract-freeze-v140.md
|
|
- 05 资料页与头像 UI: development/iterations/iteration-3.5/05-profile-avatar-ui.md
|
|
- 06 M3.5 收口: development/iterations/iteration-3.5/06-wave2-closure.md
|
|
- 07 安全事件复盘: development/iterations/iteration-3.5/07-security-incident-20260911.md
|
|
- 08 发布 E2E 回归: development/iterations/iteration-3.5/08-release-e2e-regression.md
|
|
- 第四迭代 AI 创作:
|
|
- 00 开工汇总与拍板清单: development/iterations/iteration-4/00-kickoff-index.md
|
|
- 01 任务分解: development/iterations/iteration-4/01-pm-task-breakdown.md
|
|
- 02 后端技术评估: development/iterations/iteration-4/02-backend-technical-assessment.md
|
|
- 03 Flutter 技术评估: development/iterations/iteration-4/03-flutter-technical-assessment.md
|
|
- 04 现实核查: development/iterations/iteration-4/04-reality-check.md
|
|
- 05 AI 创作 UI 规格: development/iterations/iteration-4/05-ai-create-ui-spec.md
|
|
- 06 埋点与实验规划: development/iterations/iteration-4/06-experiment-tracking-plan.md
|
|
- 07 基线证据审计: development/iterations/iteration-4/07-evidence-baseline-audit.md
|
|
- 08 Git 流程规划: development/iterations/iteration-4/08-git-workflow-plan.md
|
|
- API:
|
|
- 契约说明: api/index.md
|
|
- 架构:
|
|
- 后端模块结构与职责: architecture/backend-modules.md
|
|
- 技术决策记录: architecture/decisions.md
|