列出可用的 Cosplay 剧本

Cosplay 流程:

获取剧本列表：先调用 GET /api/cosplay/scripts 获取所有剧本概要（标题、设定、场景数等），必要时再用 GET /api/cosplay/scripts/{script_id} 拉取详细说明。

创建/恢复会话（开始 Cosplay）：用户选择剧本后，带上登录态调用 POST /api/cosplay/scripts/{script_id}/sessions。{"resume": true} 可复用未完成会话，返回 state，含当前场景、历史记录、分数等。

逐步互动（用户选择选项，获得反馈，并获取下一题）：前端读取 state.current_scene 展示选项，用户选定后用 POST /api/cosplay/sessions/{session_id}/choice，请求体 {"option_id": "…"}；响应返回新的 state，包含即时反馈与更新后的分数。

中途查询（可选）：随时用 GET /api/cosplay/sessions/{session_id} 可拿最新状态（用于断点续玩或多端同步）。

完结与报告：剧本完成时，逐步互动的 API 会返回 state.completed = true，很快就能在 state.report 中看到评价；若需要单独拉取可调用 GET /api/cosplay/sessions/{session_id}/report 获得完整报告。

返回响应

🟢200成功

application/json

Successful Response

Body

示例

{
    "scripts": [
        {
            "id": 1,
            "title": "初级软件工程师",
            "summary": "你刚加入星辰科技的新团队，将在第一个冲刺周期里体验真实的软件工程协作。",
            "setting": "你是一名刚加入\"星辰科技\"的初级软件工程师，今天是你在一个新项目上的第一个冲刺周期。",
            "total_scenes": 4,
            "updated_at": "2025-10-15T07:03:19"
        },
        {
            "id": 2,
            "title": "前端开发工程师",
            "summary": "加入星云设计工作室的首个大型项目，考验你平衡创意与协作的能力。",
            "setting": "你是一名新加入\"星云设计工作室\"的前端开发工程师，正负责一款全新社交 APP 的界面设计。",
            "total_scenes": 4,
            "updated_at": "2025-10-15T07:03:19"
        },
        {
            "id": 3,
            "title": "产品经理",
            "summary": "敏捷科技的核心迭代交到你手中，考验你的策略与执行力。",
            "setting": "你是\"敏捷科技\"的一名产品经理，正负责一款企业级 SaaS 产品的核心功能迭代。",
            "total_scenes": 4,
            "updated_at": "2025-10-15T07:03:19"
        }
    ]
}

列出可用的 Cosplay 剧本

请求参数

请求示例代码

返回响应