group-webhook-dispatch

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Group Webhook Dispatch

群组Webhook分发工具

用于替代常驻 webhook worker，采用“事件驱动 + 按需补偿”的运行方式：触发时检查是否就绪并推送；必要时按日期做一次补偿扫描。

用于替代常驻webhook worker，采用“事件驱动 + 按需补偿”的运行方式：触发时检查是否就绪并推送；必要时按日期做一次补偿扫描。

路径约定

统一安装与执行目录：

~/.agents/skills/group-webhook-dispatch/

。执行前先进入该目录：

bash

cd ~/.agents/skills/group-webhook-dispatch

统一安装与执行目录：

~/.agents/skills/group-webhook-dispatch/

。执行前先进入该目录：

bash

cd ~/.agents/skills/group-webhook-dispatch

Quick start（事件触发，推荐）

快速开始（事件触发，推荐）

在

~/.agents/skills/group-webhook-dispatch/

目录运行：

bash

npx tsx scripts/dispatch_webhook.ts --task-id <TASK_ID>

在

~/.agents/skills/group-webhook-dispatch/

目录运行：

bash

npx tsx scripts/dispatch_webhook.ts --task-id <TASK_ID>

Entry points

入口脚本

scripts/dispatch_webhook.ts

: 按

--task-id

或

--group-id

触发单组检查与推送

scripts/reconcile_webhook.ts

: 按

--date

扫描

pending/failed

做单次补偿

```
scripts/upsert_webhook_plan.ts
```
: 向
```
WEBHOOK_BITABLE_URL
```
批量创建/更新 webhook 计划（upsert）
```
scripts/webhook_lib.ts
```
: Feishu/SQLite/状态机公共逻辑

scripts/dispatch_webhook.ts

: 按

--task-id

或

--group-id

触发单组检查与推送

scripts/reconcile_webhook.ts

: 按

--date

扫描

pending/failed

状态的任务并执行单次补偿

scripts/upsert_webhook_plan.ts

: 向

WEBHOOK_BITABLE_URL

批量创建/更新webhook计划（upsert）

```
scripts/webhook_lib.ts
```
: Feishu/SQLite/状态机公共逻辑

Webhook 计划 upsert（JSON/JSONL）

Webhook计划Upsert（JSON/JSONL格式）

输入 item 约定：

```
group_id
```
（必填）
```
date
```
（必填，
```
YYYY-MM-DD
```
）
```
biz_type
```
（可选，默认
```
piracy_general_search
```
）
```
task_ids
```
（必填，数组）
```
drama_info
```
（可选，JSON 字符串）

运行：

bash

npx tsx scripts/upsert_webhook_plan.ts --input <JSON/JSONL_FILE>

输入项约定：

```
group_id
```
（必填）
```
date
```
（必填，格式为
```
YYYY-MM-DD
```
）
```
biz_type
```
（可选，默认值为
```
piracy_general_search
```
）
```
task_ids
```
（必填，数组类型）
```
drama_info
```
（可选，JSON字符串）

运行命令：

bash

npx tsx scripts/upsert_webhook_plan.ts --input <JSON/JSONL_FILE>

Required env

必需环境变量

```
FEISHU_APP_ID
```
,
```
FEISHU_APP_SECRET
```
```
TASK_BITABLE_URL
```
,
```
WEBHOOK_BITABLE_URL
```
```
CRAWLER_SERVICE_BASE_URL
```

Optional:

TRACKING_STORAGE_DB_PATH

（默认

~/.eval/records.sqlite

）

```
FEISHU_APP_ID
```
,
```
FEISHU_APP_SECRET
```
```
TASK_BITABLE_URL
```
,
```
WEBHOOK_BITABLE_URL
```
```
CRAWLER_SERVICE_BASE_URL
```

可选：

TRACKING_STORAGE_DB_PATH

（默认路径为

~/.eval/records.sqlite

）

Debugging

调试方法

使用
```
--dry-run
```
只打印将要执行的动作，不写表、不发 webhook。

使用
```
--dry-run
```
参数仅打印将要执行的动作，不会写入数据表或发送webhook。

Resources

参考资源

Read
```
references/commands.md
```
for full command examples (env, debug, reconcile).

查看
```
references/commands.md
```
获取完整的命令示例（包括环境变量配置、调试、补偿等场景）。