patbond-doc

zhaoyuxi/patbond-doc

Fork 0

Commit Graph

Author	SHA1	Message	Date
lixi	cd87437abd	fix(docs): iteration-4/06 表名列名按正典回改，并暴露 first_attempt_at 缺口 CI / docs-build (push) Successful in 36s Details 用户拍板修改。原报告全篇使用本角色自拟名 `creation.generation_tasks` （11 处，含 4 段可执行 SQL），正典 patbond_postgresql.sql:605 实为 `creation.generation_jobs`；列名亦不一致。而该报告 §4.2 自称「对后端工单的硬要求」——照字面实现会建出第二张表或写错列名。改动： - 表名 11 处 → creation.generation_jobs（零残留；§4.2 修订说明中对旧名的引用刻意保留） - 列名回改：queued_at→created_at、finished_at→completed_at、 failure_reason→error_code/error_message、last_attempt_at→started_at、 model_key→model_id(+generation_models.code / provider_model_snapshot)、 style_key→style_code_snapshot；input/output count 改为由 input_asset_id / output_asset_id 是否为 NULL 派生 - §4.2 新增 15 行逐列映射表，标明每列在正典中的对应与状态 - §5 未取证段更新：列名已回改，但 first_attempt_at 落地前两项 SQL 不可运行本次修改新发现的真问题（非改名）：`first_attempt_at` 正典无对应列，且 `ck_generation_jobs_state` 会主动销毁该信息——该 CHECK 规定 status='queued' 分支必须 started_at IS NULL，故失败重排队时首次尝试时间不可恢复，导致「排队时长」与「纯执行耗时」永远无法分离（正是 §4.2 自己警告的后果）。处置：V6 增加 first_attempt_at timestamptz （仅首次进入 running 写入、重试不覆盖），并在状态机 CHECK 的 queued 分支中排除该列。这是 §4.2 硬要求中唯一需改动正典结构的一项，另一项是 A2 拍板（参考图选填）导致的 input_asset_id 改可空。验证：secret-scan exit 0；mkdocs build --strict exit 0。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-17 16:30:30 +08:00
lixi	79b33dba31	docs: M4「AI 创作」开工分析八份报告 + 汇总拍板页入档挂导航八角色并行开工分析，合计 7448 行；另出 00 汇总页（跨角色收敛结论、 13 项待拍板、6 项待仲裁分歧、未取证项汇总），挂第四迭代导航最前。 mkdocs build --strict 通过。基线实测修正（文档与实况不符）： - api 测试 381（releases.md 记 379，成因待仲裁） - 埋点白名单 41（四份文档记 42，experiment_exposed 重复计数） - 真机验证挂起 10 项（转述链 4→6→8→10 每跳丢项） - E2E 断言机械可数 226（声称 234 无可复核来源） - v0.4.0 实际发布 09-14 11:17；CI 非红，三仓五上下文全绿多方独立收敛（无需拍板）： - 队列用 Postgres SKIP LOCKED + 租约列，不引入 Redis/MQ - 服务端零对象写能力（ObjectStorage 无 put/get），M4 立足点缺地基 - 「四模块字节级快照锁 CI」不存在，实际门禁仅结构断言 - 定稿模型 input_asset_id NOT NULL，即图生图不支持文生图 - 跨 schema 外键补回是 V5 自身指令，裁剪理由已不成立阻塞项与安全缺口： - AI provider BLOCKED：零 SDK/endpoint/额度，正典种子即 fixture - 分支保护必需上下文选错触发器：(push) 限定 branches:[dev]，致「推 dev 即满足门禁」且「非 dev 分支 PR 永久无法合并」 - check-secrets.sh 对 sk-/sk-ant- 零覆盖，须先于任何 AI key 落地 - 北极星 09-21 窗口已于 09-13 关闭，补救无从下手，建议改事件驱动本批核心教训：13 处文档/注释与代码相反且多已被下游采信，其中 5 处造成实际规模误判（widthPx M→S、数据模型早已定稿 L→M、社区侧 purpose 校验实际不存在等）。汇总页 §0 立转述纪律。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-14 15:48:56 +08:00

Author

SHA1

Message

Date

lixi

cd87437abd

fix(docs): iteration-4/06 表名列名按正典回改，并暴露 first_attempt_at 缺口

CI / docs-build (push) Successful in 36s

Details

用户拍板修改。原报告全篇使用本角色自拟名 `creation.generation_tasks`
（11 处，含 4 段可执行 SQL），正典 patbond_postgresql.sql:605 实为
`creation.generation_jobs`；列名亦不一致。而该报告 §4.2 自称「对后端
工单的硬要求」——照字面实现会建出第二张表或写错列名。

改动：
- 表名 11 处 → creation.generation_jobs（零残留；§4.2 修订说明中对旧名
  的引用刻意保留）
- 列名回改：queued_at→created_at、finished_at→completed_at、
  failure_reason→error_code/error_message、last_attempt_at→started_at、
  model_key→model_id(+generation_models.code / provider_model_snapshot)、
  style_key→style_code_snapshot；input/output count 改为由
  input_asset_id / output_asset_id 是否为 NULL 派生
- §4.2 新增 15 行逐列映射表，标明每列在正典中的对应与状态
- §5 未取证段更新：列名已回改，但 first_attempt_at 落地前两项 SQL 不可运行

**本次修改新发现的真问题（非改名）**：`first_attempt_at` 正典无对应列，
且 `ck_generation_jobs_state` 会主动销毁该信息——该 CHECK 规定
status='queued' 分支必须 started_at IS NULL，故失败重排队时首次尝试
时间不可恢复，导致「排队时长」与「纯执行耗时」永远无法分离（正是
§4.2 自己警告的后果）。处置：V6 增加 first_attempt_at timestamptz
（仅首次进入 running 写入、重试不覆盖），并在状态机 CHECK 的 queued
分支中排除该列。这是 §4.2 硬要求中唯一需改动正典结构的一项，另一项
是 A2 拍板（参考图选填）导致的 input_asset_id 改可空。

验证：secret-scan exit 0；mkdocs build --strict exit 0。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-17 16:30:30 +08:00

lixi

79b33dba31

docs: M4「AI 创作」开工分析八份报告 + 汇总拍板页入档挂导航

八角色并行开工分析，合计 7448 行；另出 00 汇总页（跨角色收敛结论、
13 项待拍板、6 项待仲裁分歧、未取证项汇总），挂第四迭代导航最前。
mkdocs build --strict 通过。

基线实测修正（文档与实况不符）：
- api 测试 381（releases.md 记 379，成因待仲裁）
- 埋点白名单 41（四份文档记 42，experiment_exposed 重复计数）
- 真机验证挂起 10 项（转述链 4→6→8→10 每跳丢项）
- E2E 断言机械可数 226（声称 234 无可复核来源）
- v0.4.0 实际发布 09-14 11:17；CI 非红，三仓五上下文全绿

多方独立收敛（无需拍板）：
- 队列用 Postgres SKIP LOCKED + 租约列，不引入 Redis/MQ
- 服务端零对象写能力（ObjectStorage 无 put/get），M4 立足点缺地基
- 「四模块字节级快照锁 CI」不存在，实际门禁仅结构断言
- 定稿模型 input_asset_id NOT NULL，即图生图不支持文生图
- 跨 schema 外键补回是 V5 自身指令，裁剪理由已不成立

阻塞项与安全缺口：
- AI provider BLOCKED：零 SDK/endpoint/额度，正典种子即 fixture
- 分支保护必需上下文选错触发器：(push) 限定 branches:[dev]，
  致「推 dev 即满足门禁」且「非 dev 分支 PR 永久无法合并」
- check-secrets.sh 对 sk-/sk-ant- 零覆盖，须先于任何 AI key 落地
- 北极星 09-21 窗口已于 09-13 关闭，补救无从下手，建议改事件驱动

本批核心教训：13 处文档/注释与代码相反且多已被下游采信，其中
5 处造成实际规模误判（widthPx M→S、数据模型早已定稿 L→M、
社区侧 purpose 校验实际不存在等）。汇总页 §0 立转述纪律。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-14 15:48:56 +08:00

2 Commits