权限声明

SECURITY MANIFEST:

- Allowed to read: {baseDir}/README.md, {baseDir}/references/*.json

- Allowed to make network requests to: https://lumipath.cn

通用工作流

当用户提出请求时，请严格执行以下步骤：

1. 检查API密钥：首先检查环境变量 LUMI_API_KEY 是否存在。如果不存在，提示用户设置：export LUMI_API_KEY="lumi_your_key_here"
2. 阅读README：仔细阅读 {baseDir}/README.md，了解接口概览和认证方式。
3. 目录索引：扫描 {baseDir}/references/ 目录下的所有文件名，确定哪些 OpenAPI 定义文件与用户需求相关。
4. 精准读取：仅读取选定的 .json 文件，分析其 paths、parameters 和 requestBody。
5. 收集参数（见下方各场景的参数清单），向用户确认所有必要参数后再执行。
6. 构造请求：使用 curl 执行请求。
   • Base URL: https://lumipath.cn
   • Auth: Authorization: Bearer $LUMI_API_KEY

场景一：搬运视频（repurpose）

触发条件：用户提供抖音/B站/小红书链接，或说"搬运"、"复用"、"翻译发布"。

第一步：收集参数（在执行任何 API 调用前，必须向用户确认以下所有信息）

autoPublish 默认启用：搬运场景中，只要用户指定了发布平台，必须始终设置 autoPublish 字段，无需额外询问用户是否自动发布。

禁止跳过参数收集步骤直接发起请求。 如果用户没有提供某个必要参数，必须主动询问。

第二步：获取账号连接 ID

调用 GET /api/v1/connections 获取目标平台的 connectionId，展示给用户确认使用哪个账号。

第三步：获取 TTS 声音列表（如需配音）

引导用户访问 https://lumipath.cn/voices 查看所有可用声音（支持试听）。用户选定声音名称后，调用 GET /api/v1/tts?language=\x3C目标语言> 匹配对应的 id。

第四步：发起搬运任务

调用 POST /api/v1/repurpose，将发布信息通过 autoPublish 字段一并传入，确保翻译完成后自动发布。

autoPublish: {
  text: "\x3C用户提供的发布文案>",
  tiktokConnectionIds: [...],   // 如选择了 TikTok
  youtubeConnectionIds: [...],  // 如选择了 YouTube
  instagramConnectionIds: [...] // 如选择了 Instagram
}

第五步：轮询任务进度

每隔 15 秒调用一次 GET /api/v1/localization?taskId=\x3CtaskId>，向用户展示当前进度（step 和 progress），直到 status=completed 或 status=failed。

第六步：完成确认

• status=completed：告知用户任务已完成，已自动发布到指定平台。
• status=failed：展示 failureReason，建议用户重试。

场景二：直接发布视频（social post）

触发条件：用户提供视频 URL 或已有视频，要直接发布，不需要翻译。

参数收集

执行步骤

1. 如果是新视频 URL，先调用 POST /api/v1/videos/upload 上传，获取 OSS url
2. 调用 GET /api/v1/connections 获取目标平台的 connectionId
3. 调用 POST /api/v1/social-posts 发布

场景三：仅本地化（不发布）

触发条件：用户只想翻译/配音/加字幕，暂不发布。

参数收集

同场景一，但不询问发布平台，不设置 autoPublish。

完成后展示 outputUrl，告知用户可随时用此链接手动发布。

注意事项

• 禁止全量加载：除非涉及多个领域，否则禁止同时读取多个 JSON 文件。
• 参数完整性：绝对禁止在用户未确认目标语言、发布平台、发布文案的情况下启动 repurpose 或 localization 任务。
• 账号确认：当用户有多个同平台账号时，必须列出所有账号让用户选择，不得自动选第一个。
• 轮询：任务启动后必须持续轮询并向用户报告进度，不得静默等待。
• 错误处理：请求失败时展示友好提示和详细错误信息。