AI能力中心
游记生成
游记生成为异步任务模式：提交生成请求后，系统在后台分阶段处理并返回进度，完成后产出可编辑游记内容。
什么时候用
- 你想把一次旅行或活动照片整理成结构化文字内容。
- 你希望从“素材集合”快速得到可发布的初稿。
- 你需要边生成边查看进度，而不是长时间阻塞等待。
素材要求
- 必填：
memoryId - 模式：
ALBUM：基于整个回忆/相册生成PARTIAL：基于指定photoIds[]生成（最多 30 张）
- 建议素材具备基本时序和主题一致性，能显著提升成稿质量。
生成流程
- 在回忆页打开“游记生成”弹窗，选择模式与素材范围。
- 提交后创建异步任务，返回
jobId。 - 前端轮询任务状态（
PENDING/PROCESSING/SUCCEEDED/FAILED）。 - 成功后获得
travelogueId与访问链接，进入编辑与发布。
可编辑策略（推荐）
- 先结构后润色：先确认段落结构，再调整措辞风格。
- 保留事实锚点：地点、时间、人物尽量与素材一致。
- 小步迭代：每次只改一类问题（逻辑/语气/长度），便于回溯。
输入输出示例
示例：创建任务
POST /api/travelogues/jobs
Content-Type: application/json
{
"memoryId": "mem_xxx",
"mode": "PARTIAL",
"photoIds": ["p1", "p2", "p3"]
}示例：创建响应
{
"jobId": "job_xxx"
}示例：轮询状态响应（节选）
{
"status": "PROCESSING",
"stage": "GENERATE",
"progress": 72,
"travelogueId": null,
"shareUrl": null,
"errorMessage": null
}注意事项
- 任务受用户/组织/全局队列限流影响，高峰期可能排队。
ALBUM模式进入模型处理的照片数量有上限（超出会采样）。- 助手不可用、模型超时、结果解析失败都可能导致任务失败。
- 失败后可重试，系统具备有限次自动重试与回退机制。
常见失败与排查
1) 提示权限不足
- 原因：当前账号无对应回忆编辑权限。
- 处理：切换有权限账号，或联系组织管理员授权。
2) PARTIAL 模式提交失败
- 原因：未传
photoIds或超过最大数量限制。 - 处理：确保至少传 1 张且不超过 30 张。
3) 长时间处理中或失败
- 原因：排队拥堵、上游模型超时、助手端点不可用。
- 处理：稍后重试；若多次失败，缩小素材范围并改用默认助手。
4) 结果不可读或结构异常
- 原因：模型输出 JSON 结构不满足解析约束。
- 处理：重新触发生成，并优先使用主题更一致的素材。