Demo-Slap 高光片段生成技能

从 CS2 录像（demo）中生成 MP4 高光片段与精彩集锦（fragmovie）。

该技能专为 OpenClaw 环境设计，支持后台任务、本地辅助脚本及上下文感知的聊天消息交付。使用 Python 3 编写的脚本，并通过 requests 包调用 HTTP API。

预期运行时输入参数：

• 必需：DEMOSLAP_API_KEY
• 可选：LEETIFY_API_KEY
• 可选部署辅助参数：DEMO_SLAP_WATCHDOG_JOB_ID

脚本说明

所有脚本均需相对于技能根目录执行，通常位于 scripts/ 目录下。

Demo-Slap

Leetify

对局数据源选择策略

• 当 LEETIFY_API_KEY 可用时，优先使用 Leetify 发现近期对局。
• 若未配置 LEETIFY_API_KEY，但 DEMOSLAP_API_KEY 可用，则使用 Demo-Slap 的 /public-api/matches 接口获取对局历史。
• Swagger 文档地址：https://api-doc.demo-slap.net/
• 将 Demo-Slap 对局历史视为兜底发现路径：用于列举对局、在分析/渲染前选定已分析过的对局或回放上下文。

运行时文件

以下文件可作为可选的本地运行时状态，在执行过程中使用：

• data/state.json
• data/highlights.json
• data/history.log
• data/steam_ids.json
• data/config.json

这些文件仅为本地运行提供辅助支持，非理解或检查技能包本身所必需。

state.json 用于追踪当前操作状态：

{
  "status": "idle|analyzing|rendering|done|error",
  "job_id": "...",
  "render_job_id": "...",
  "chat_id": "telegram:182314856",
  "clip_urls": {"highlight_id": "https://..."},
  "progress": "polling 3/30",
  "last_completed_op": "analyze|render",
  "notification": {
    "sent": false,
    "sent_at": null,
    "last_attempt_at": null,
    "error": null
  },
  "updated_at": "ISO timestamp"
}

工作流

1. 查找目标对局

当 LEETIFY_API_KEY 可用时的首选路径：

python3 scripts/leetify/leetify_matches.py  [--limit 10]

当缺少 LEETIFY_API_KEY 但 DEMOSLAP_API_KEY 可用时的兜底路径：

python3 scripts/demo_slap_matches.py [] [--limit 10]

• 调用 Demo-Slap /public-api/matches 接口
• 如需查阅接口 Schema 细节，请参考 Demo-Slap Swagger 文档：https://api-doc.demo-slap.net/
• 若提供了 且已建立映射，则尽可能按该玩家的 Steam ID 过滤对局
• 用户选定对局后，执行：

python3 scripts/demo_slap_match_pick.py [] --match-index 

• 将返回的 jobId 视为后续所有 Demo-Slap 操作的主要标识符

2. 解析回放 URL

使用 Leetify 时的首选路径：

python3 scripts/leetify/leetify_resolve.py  --match-index 

使用 Demo-Slap 兜底路径时：

python3 scripts/demo_slap_match_pick.py [] --match-index 

• 以返回的 jobId 作为选定对局的唯一标识
• 若返回结果中包含 demoUrl，仍可继续使用基于 URL 的分析流程
• 若无 demoUrl 字段，则跳过 URL 解析步骤，直接调用支持已有 jobId 的分析接口
• 可通过 GET /public-api/analyze/{jobId}/status 和 GET /public-api/analyze/{jobId}/data 查询已存在的高光片段
• 若用户所需高光片段和剪辑已存在，可直接基于该 jobId 启动渲染

3. 后台分析

python3 -u scripts/demo_slap_analyze.py --url '' --username  --chat-id 

需配合 exec(background: true) 执行，并保留返回的进程/会话 ID。

OpenClaw 环境中可选的、部署特定的看门狗（watchdog）模式：

• 仅当后台分析/渲染任务能从周期性交付检查中获益时，才启用看门狗。
• 若已有可用的部署级看门狗，应复用而非默认新建持久化调度任务。
• 若部署方选择通过内置 cron 工具创建或启用看门狗，须将其作用域限定于当前运行周期，并在终端交付完成后立即禁用。
• 2 分钟为合理的默认轮询间隔。
• scripts/demo_slap_watchdog.sh status|tail|job 仅作为本地辅助工具，用于检查运行时状态、日志或部署特定的任务引用。
• 运行期间，以 data/state.json 和 data/highlights.json 为准作为事实来源。

智能体（Agent）工作流：

1. 选择对局数据源：
   • 若存在 LEETIFY_API_KEY，则选用 Leetify
   • 若缺失 LEETIFY_API_KEY 但存在 DEMOSLAP_API_KEY，则选用 Demo-Slap /public-api/matches
2. 若使用 Leetify，先解析回放 URL，再执行分析
3. 若使用 Demo-Slap 兜底路径，先选取对局并检查返回的 jobId
4. 若所选 Demo-Slap 对局已存在分析数据，则直接基于 jobId 继续流程，无需强制执行基于 URL 的分析
5. 仅当长时间运行的分析/渲染任务确实受益于看门狗机制时，才启用或创建部署级看门狗
6. 启动分析或渲染任务，并在适用时保存返回的进程/会话 ID
7. 若部署中启用了看门狗，则由其负责结果交付
8. 终端交付完成后，再次禁用看门狗

4. 后台渲染

# 单个高光片段
python3 -u scripts/demo_slap_render.py   --chat-id 

# 精彩集锦（fragmovie）
python3 -u scripts/demo_slap_render.py    ... --fragmovie --chat-id 

需配合 exec(background: true) 执行，并保留返回的进程/会话 ID。

OpenClaw 环境中可选的、部署特定的看门狗（watchdog）模式：

• 仅当后台分析/渲染任务能从周期性交付检查中获益时，才启用看门狗。
• 若已有可用的部署级看门狗，应复用而非默认新建持久化调度任务。
• 若部署方选择通过内置 cron 工具创建或启用看门狗，须将其作用域限定于当前运行周期，并在终端交付完成后立即禁用。
• 2 分钟为合理的默认轮询间隔。
• scripts/demo_slap_watchdog.sh status|tail|job 仅作为本地辅助工具，用于检查运行时状态、日志或部署特定的任务引用。
• 运行期间，以 data/state.json 和 data/highlights.json 为准作为事实来源。

智能体（Agent）工作流：

1. 仅在当前运行需要时，启用或复用部署级看门狗
2. 启动渲染任务，并保存返回的进程/会话 ID
3. 轮询进程输出，提取 Estimated finish: 行内容；若存在，向用户告知预估完成时间（ETA）
4. 若启用了看门狗，则由其负责结果交付
5. 终端交付完成后，再次禁用看门狗

关键提示：请从原始请求的入站元数据中提取 。硬编码的聊天标识符仅作本地示例参考，不可作为可复用的默认值。

5. 查询状态

读取 data/state.json 文件即可。

初始化配置

将用户名映射至 Steam ID

python3 scripts/leetify/leetify_save_id.py  

配置 API 密钥

推荐使用环境变量方式配置：

• DEMOSLAP_API_KEY — 必需
• LEETIFY_API_KEY — 可选，仅用于 Leetify 支持的对局发现
• DEMO_SLAP_WATCHDOG_JOB_ID — 可选，仅用于部署级看门狗检测脚本的辅助参数

数据源选择规则：

• 若存在 LEETIFY_API_KEY，则使用 Leetify 发现对局。
• 若缺失 LEETIFY_API_KEY 但存在 DEMOSLAP_API_KEY，则使用 Demo-Slap /public-api/matches 发现对局。
• DEMOSLAP_API_KEY 始终为分析/渲染所必需。

对于受控的自托管部署，可选的本地兜底方案：将密钥写入 data/config.json 文件。

技术支持

如需访问权限或技术支持，请加入我们的 Discord 社区：https://discord.gg/8nfh26W9wQ