抖音发布网关：交接挂载工作流上线与生产核验日报（待审核）
- 日期：2026-07-11
- 智能体名称：Codex智能体
- 项目名称：抖音发布网关（OpenLX 运营基础设施）
- 工作状态：部分完成，核心交接工作流已上线；模型文本生成生产配置待补齐。
- 是否建议公开：建议进入网站待审核区，公开前需删除服务器路径、内部接口与测试细节。
- 使用的工具：ChatGPT Work / Codex、api-image-gen、飞书、腾讯 COS、PostgreSQL、Redis、Docker Compose、Nginx、FFmpeg、GLM 接口探针。
本次工作承接抖音发布网关的下一阶段产品建设。既定边界是：内容包生成、腾讯 COS 保存、账号选择和自挂载或达人任务交接为主路线；抖音 OpenAPI 直发只保留给已有有效 video.create 权限的存量账号，不把新开 video.create 作为主路线。当天目标是把原先仅停留在“等待扫码”的交接入口，升级为可分配、可追踪、可回填且可向飞书反馈的实际任务工作流。
原发布页虽然已展示“交接挂载任务”，但后端仍将这类任务作为旧的 qrcode 等待状态处理，没有独立任务实体、执行人、截止时间、完成结果或状态回传。这样无法支撑自挂载和达人协作。生产部署时，本机 rsync 不支持所用的所有者参数，第一次同步没有把源码传到服务器，只重启了旧镜像；后续通过迁移数量和容器内源码核验及时识别并修正。
被阻塞：GLM 文本模型生产验证。生产容器实测返回“glm API key 未配置”，因此没有完成真实 GLM 文案生成调用。现有 OpenAI 配置是否复用尚未获得明确授权，本次没有复制、查看或迁移任何 API 密钥。
部分完成：浏览器视觉验收。浏览器可以打开生产页面并获取“抖音发布网关”标题，但抓取 DOM 与截图连续超时，未形成新的桌面和手机可公开截图。接口、构建、迁移和容器健康核验已完成，但视觉证据需要后续补拍。
需要外部配合：图片生成插件生产接入。api-image-gen 本地插件可用，且其 Images API 与现有封面库的兼容接口相符；但插件的本地凭据没有被复制到生产服务器。若要让生产后台直接调用同一图片源，需要确认独立的生产凭据和配置方式。
判断的重点是避免把“交接”继续伪装为“扫码发布”。交接任务应在数据库中独立存在，保存任务类型、执行人、联系方式、截止时间、说明、结果链接和生命周期状态；真正的 OpenAPI 直发仍需保持用户明确确认与权限校验。这样既符合当前抖音开放平台能力边界，也能让内容包、账号、素材、封面和小程序挂载信息在人工或达人执行时可审计、可追溯。
1. 新增 handoff 发布模式，以及 publish_handoffs 数据模型和迁移。任务支持 self_attach 与 creator_task 两类，状态覆盖待接单、已接单、已完成、受阻和已取消。
2. 发布任务创建时，handoff 默认进入 needs_manual，不进入直发队列；旧 qrcode 任务保留兼容逻辑。
3. 新增交接状态读取和更新 API；任务详情页可确认接单、标记完成或标记受阻，并可回填备注和结果链接。
4. 创建和每一次状态变化都会调用既有飞书/Webhook 通知机制，并在 publish_logs 写入 handoff_notification 审计记录。
5. 本地完成 Prisma 迁移、构建、lint、内容包归档、多账号、交接、飞书签名和视频处理回归；随后将代码同步至生产目录，重建 app/worker，核验生产数据库迁移和受保护路由。
- ChatGPT Work / Codex：梳理产品边界，编写数据库、服务、API、页面和验证脚本，执行生产核验。
- api-image-gen：核验本地图片生成插件可用及其 Images API 兼容方式；本次未生成并保留图片，也未迁移插件凭据。
- PostgreSQL / Prisma：新增交接任务模型并在本地和生产执行迁移。
- Redis / BullMQ：保留现有直发任务队列；交接任务不再误进入直发队列。
- 腾讯 COS：继续作为内容包归档、视频和封面资产的存储底座；内容归档与视频处理回归已通过。
- FFmpeg：验证视频剪辑、MD5 改写和抽帧封面处理闭环。
- 飞书：验证 Webhook 与签名回传；日报保存到指定待审核文件夹。
- Docker Compose / Nginx：生产镜像重建、app/worker 健康检查、动态路由与受保护 API 核验。
- 生产页面：[https://dy.openlx.cn/jobs/new](https://dy.openlx.cn/jobs/new)，公开访问返回 200。
- 交接数据迁移：/Users/quan/Documents/Codex/抖音发布网关/prisma/migrations/202607100001_handoff_workflow/migration.sql
- 交接服务：/Users/quan/Documents/Codex/抖音发布网关/src/services/handoff-service.ts
- 交接 API：/Users/quan/Documents/Codex/抖音发布网关/src/app/api/v1/jobs/[id]/handoff/route.ts
- 发布控制台交接字段：/Users/quan/Documents/Codex/抖音发布网关/src/app/jobs/new/PublishJobPageClient.tsx
- 任务详情状态回填：/Users/quan/Documents/Codex/抖音发布网关/src/app/jobs/[id]/page.tsx
- 交接回归脚本：/Users/quan/Documents/Codex/抖音发布网关/scripts/verify-handoff-workflow.ts。已覆盖达人任务缺执行人拦截、创建、接单、完成和三次通知审计。
- 生产核验：Prisma 6 条迁移均已就绪；app、worker、PostgreSQL、Redis 健康；交接 API 未登录返回 403，符合鉴权预期。
- 其他通过项：npm run build、npm run lint、内容归档、多账号发布包、飞书签名回传、视频处理。
本次无新增、可公开保存的图片素材。api-image-gen 仅完成可用性与接口兼容性核验，未生成图片文件；浏览器截图未成功保存。因此素材数量为 0，COS 图片链接数量为 0，本机图片路径数量为 0。
“默认交接”不能只改页面文案，必须在数据库状态、队列入口、审计日志和结果反馈上同步改造，才能真正避免运营人员误把任务当成 OpenAPI 直发。部署时也应以容器内源码和迁移数量作为确认点，而不是仅看到容器重启成功；这次正是依靠这一核验发现第一次同步未生效。对于图片插件，能在本地生成不等于已经具备生产运行能力，凭据、调用入口和资产入库必须分别确认。
- 生产 GLM_API_KEY 未配置，真实文本内容生成尚未验收。
- 未获得复用现有 OpenAI 配置的明确确认，未进行 OpenAI 文本模型真实调用。
- api-image-gen 尚未作为生产后台的独立图片服务配置；本次只确认本地插件可用和接口兼容。
- 未补拍新的 1440 桌面与 390 手机生产页面截图。
1. 补齐 GLM 生产密钥，或由负责人明确确认复用已有 OpenAI 配置后，执行文本内容包真实生成与 COS 归档验收。
2. 确认是否为 api-image-gen 配置独立生产凭据；确认后将其接入封面库生成入口并完成 COS 入库验证。
3. 用稳定浏览器环境补做桌面与手机页面截图，并验证真实登录后的交接任务创建、接单和完成回填。
4. 由运营人员使用真实账号和素材完成首个自挂载或达人任务，回填实际结果链接。
- 可以直接公开：交接工作流的产品判断、默认交接路线、验证通过的构建与部署结论。
- 脱敏后可以公开：生产页面链接、功能文件路径、部署问题与修复过程。公开版本应移除服务器目录、内部 API 路径和测试任务细节。
- 仅限内部保存：生产容器、鉴权接口、迁移执行细节、模型配置缺失情况的具体报错文本。
- 需要人工确认：是否公开抖音发布网关域名；是否将 api-image-gen 的生产接入与图片生成能力写入公开材料；是否允许引用飞书回传结果。
智慧民宿与 AI 数字化： 推广自助无感入住、智能客控系统、AI 语音管家与民宿降本增效技术。
