Piracy Handler

用于“综合页搜索完成后”的后置编排：盗版检测（只读）→ 子任务创建 → webhook 计划 upsert。

路径约定

统一安装与执行目录：~/.agents/skills/piracy-handler/。执行前先进入该目录：

cd ~/.agents/skills/piracy-handler

Quick start

在 ~/.agents/skills/piracy-handler/ 目录运行：

npx tsx scripts/piracy_detect.ts --task-id <TASK_ID>
npx tsx scripts/piracy_create_subtasks.ts --task-id <TASK_ID>
npx tsx scripts/piracy_upsert_webhook_plans.ts --task-id <TASK_ID>

更完整命令与调试示例见 references/commands.md。

Workflow（高层）

1. 从本地 sqlite capture_results 读取综合页采集结果。
2. 通过 TaskID 从任务状态表补齐 BookID（capture_results 不含 BookID）——委托 feishu-bitable-task-manager。
3. 用 GroupID={MapAppValue(任务App)}_{BookID}_{UserKey} 聚类。
4. 从原始剧单按 BookID 查询总时长，换算后计算阈值并筛选命中分组。
5. 为命中分组创建子任务（个人页必建，合集/锚点按条件）——委托 feishu-bitable-task-manager。
6. 创建/更新 BizType=piracy_general_search 的 webhook 推送计划——委托 group-webhook-dispatch。

I/O（默认路径约定）

• piracy_detect.ts 默认写入 ~/.eval/<TaskID>/detect.json（避免多设备并行冲突）。
• 未指定 --input 时，后续命令可用 --task-id <TaskID> 从 ~/.eval/<TaskID>/detect.json 读取。

Required env

• FEISHU_APP_ID, FEISHU_APP_SECRET
• TASK_BITABLE_URL（任务状态表）
• DRAMA_BITABLE_URL（原始剧单/元信息表）
• WEBHOOK_BITABLE_URL（推送计划表）

Dependencies

• 调用其它 skills 时遵循各自的 Path Convention / 路径约定（统一安装路径：~/.agents/skills/<skill>/），推荐在脚本里使用单条 subshell 执行避免 cd 漂移：
  • (cd ~/.agents/skills/feishu-bitable-task-manager && npx tsx scripts/bitable_task.ts ...)
  • (cd ~/.agents/skills/feishu-bitable-task-manager && npx tsx scripts/bitable_lookup.ts fetch ...)
  • (cd ~/.agents/skills/group-webhook-dispatch && npx tsx scripts/upsert_webhook_plan.ts ...)

Resources

• scripts/piracy_detect.ts: 阈值检测（输出 JSON）
• scripts/piracy_create_subtasks.ts: 子任务创建（写任务状态表）
• scripts/piracy_upsert_webhook_plans.ts: webhook 计划 upsert（写推送计划表）
• Read references/commands.md for field conventions and debug flags.