对话线程
接口现在接受 referenceAssetKind 为空字符串或 null。后台表单仍发送空字符串。
契约漂移：schema 接受 image、video、audio、null 或空字符串兼容。 调用方影响：后台表单依赖空字符串处理。 校验缺口：分别测试 null 和空字符串。 上线说明：在读取边界归一为 null。 风险：严格解析可能拒绝既有草稿记录。
提示词库
接口现在接受 referenceAssetKind 为空字符串或 null。后台表单仍发送空字符串。
契约漂移：schema 接受 image、video、audio、null 或空字符串兼容。 调用方影响：后台表单依赖空字符串处理。 校验缺口：分别测试 null 和空字符串。 上线说明：在读取边界归一为 null。 风险：严格解析可能拒绝既有草稿记录。
计划把提示词内容迁到已复核的发布文件后，移除线上数据库写入；生产里的旧记录仍保留。
数据丢失风险：如果读取不再依赖旧表，则风险较低。 回填顺序：禁用写入前确认发布文件覆盖完整。 回滚限制：重新启用数据库写入不一定能恢复遗漏编辑。 验证查询：比较已发布文件模板数量和旧记录数量。 决策：旧记录只读保留至少一个发布周期。
请求：梳理素材归属、下线旧兼容路径、更新文档并改进审计脚本。
工单 1：审计当前素材路径和临时链接引用。 工单 2：替换最终 URL 并验证公开页面。 工单 3：示例覆盖稳定后再删除兼容路径。 工单 4：更新治理文档和发布清单。 验证：提示词检查、媒体审计、typecheck 和 build。
提示词侧栏的 Use 按钮更新了 URL 查询参数，但客户端导航后 textarea 仍保留旧 prompt。
症状：URL 改变，但 textarea 状态不刷新。 可能过期状态：查询参数 hydration 只在首次挂载时运行。 复现：在同一模型页点击两张 prompt 卡片。 最小修复：监听搜索参数，并只在相关值变化时同步。 测试：直接访问和同页导航都能回填 textarea。
未登录用户访问 /zh/studio/image 应进入登录页，并返回本地化 studio 路径。
重定向循环风险：登录页不应重定向到自身。 locale 处理：return path 保留 zh。 受保护路由泄露：studio 内容保持 noindex 且需要登录。 测试用例：未登录访问本地化 studio。 回归检查：默认语言和 zh 行为一致。
需要从 result_urls_json 为旧 AI 任务回填 result_primary_url，同时不改变新任务写入。
真相源：状态为 completed 的旧任务的 result_urls_json 第一项。 试运行：按状态统计缺少主 URL 的记录。 写入顺序：只处理状态为 completed 的旧任务，按 ID 分批。 验证：比较前后计数。 回滚限制：只有原 JSON 完整时才能清空主 URL。
某个上游服务商的视频任务失败，但日志只有通用上游错误，支持团队看不到服务商错误代码。
缺失日志：服务商错误代码和 request ID。 缺失指标：按服务商和模型区分的失败率。 缺失链路：上传到生成的交接。 告警缺口：没有服务商级失败突增告警。 下一步：为支持视图持久化归一化后的上游错误来源和代码。
Playwright 版本变化后截图失败，因为匹配的 Chromium 版本修订未安装。
API 变化：目前没有确认。 生成文件：安装浏览器不应改动应用文件。 浏览器要求：安装匹配的 Chromium 版本修订。 回退计划：只有版本匹配时才使用已有缓存版本修订。 验证：安装后运行截图命令并记录版本修订。
发布改动了提示词静态路径，并新增 58 个对话模板。没有 schema 变更。构建必须包含新页面。
切换点：部署前回滚是 git revert；部署后回滚是重新部署上一个构建版本。 数据风险：schema 没有风险，但 sitemap 数量会变化。 负责人：发布工程师负责部署，内容负责人负责模板校验。 验证：prompts:check、i18n 检查、typecheck、build。 中止条件：缺少本地化文件或提示词静态路由失败。
新增大量模板后，提示词列表页感觉更慢。服务端渲染是静态的，但客户端筛选要处理更多项目。
可能原因：客户端筛选和卡片渲染会随项目数量增加而变重。 测量计划：比较变更前后的客户端水合时间和筛选输入延迟。 安全实验：先记忆化搜索值，只有必要时再做虚拟化。 回滚触发：中端移动设备上的交互延迟超过目标。 不要改动：没有服务端瓶颈证据前，不要改 SEO 静态生成。
提示词卡片现在有紧凑对话预览，动作按钮在截断对话块下方。
焦点顺序：卡片链接不应困住动作按钮。 点击尺寸：复制和运行按钮至少需要 24px 目标或等效间距。 减少动效：悬停扫光效果只能作为装饰。 标签检查：按钮需要可见或可访问动作名称。 移动端风险：对话气泡文字不能覆盖动作按钮。
用户打开模型页，点击相关对话提示词，运行面板应预填该提示词。
用户路径：模型详情到相关提示词，再到运行面板。 数据边界：提示词文本通过客户端导航传递。 失败模式：输入框保留旧提示词。 测试用例：点击两个不同提示词卡片，并断言最新值。 验证目标：URL 和输入框保持同步。
支付完成事件会增加积分。重试事件可能重复到达。钱包页读取积分账本。
幂等：写入积分前，事件 ID 必须唯一。 重放安全：验证签名和时间戳容忍窗口。 积分写入：账本条目应关联支付会话。 客户可见失败：支付成功但积分写入失败时显示待复核。 测试缺口：重复事件和乱序事件用例。
需要对齐 Rivya 和相邻种子脚本的模型配置，但先不改变运行时行为。
顺序：审计当前配置，比较生成的模型事实，再更新种子脚本。 契约：model slug、category 和 provider ID 必须保持稳定。 验证：运行时变更前先做一致性检查。 回滚边界：配置生成可以独立于界面内容回滚。 风险：更改展示字段可能影响 SEO 页面。
只改了提示词模板内容。现有文档已有未提交改动。需要下一负责人复核 SEO 文案。
涉及文件：提示词模板源文件和本地化文件。 不变量：没有改变代码路径或路由行为。 已知风险：新页面会增加静态提示词数量。 验证：prompts:check 和 SEO 标题审计。 下一负责人决策：合并前是否运行完整构建。
功能允许用户上传参考图、保留历史，并跨工作室会话复用提示词。
认证问题：谁能访问复用提示词和上传参考图。 存储问题：参考素材存在哪里，何时过期。 用户数据问题：提示词是否可能包含客户隐私数据。 滥用路径：公开分享可能暴露私有媒体。 评审负责人：上线前安全和产品需要确认保留规则。
prompts:check 通过，但生成的消息文件在工作区变更后，i18n:check 失败。
改动文件失败：先检查 locale JSON 结构。 环境失败：prompts:check 已通过，环境问题可能性低。 不稳定测试：确定性的 i18n:check 不太像不稳定测试。 下一条命令：运行 i18n:generate，再跑 i18n:check。 不要做：不理解源头差异时不要还原生成文件。
决策：提示词模板继续使用文件源，而不是通过后台数据库写入。
背景：公开提示词页面需要静态、可审查内容。 选项：数据库 CMS、文件源、混合回写。 决策：文件源，后台只做诊断。 后果：编辑需要部署，但 SEO 和审查更稳定。 复查触发：运营需要安全的非开发写入流程。