parallel-monitor

Web Monitor

操作: $ARGUMENTS

需要 parallel-cli ≥ 0.3.0（monitor 命令在 0.3.0 中添加）。如果 parallel-cli monitor 报错 no such command 或类似信息，请告知用户运行 parallel-cli update（如果通过 pipx 安装则运行 pipx upgrade parallel-web-tools），然后重试。

本技能的功能

监控是长期运行的服务端任务，按固定频率重新检查网页，并在发生变化时发出事件。与搜索/研究/findall（一次性查找）不同，监控会持续存在直到被删除，并且可以选择在每个事件上触发 webhook。

确定操作

解析用户的请求并选择一项：

意图	操作
“跟踪/监控/关注/当X变化时提醒我”	create
“我在监控什么？”/“列出监控”	list
“什么变了？”/“显示监控X的事件”	events
“显示监控X”/“获取X的详细信息”	get
“更改X的频率/查询/webhook”	update
“测试webhook”/“触发测试事件”	simulate（需要监控已配置webhook）
“显示事件组X的完整负载”	event-group
“停止/删除监控X”	delete（删除前务必确认）

创建监控

parallel-cli monitor create "<query>" --cadence daily --json

频率选项：hourly、daily（默认）、weekly、every_two_weeks。根据源的实际变化频率匹配——价格/新闻用 hourly，文件/人员用 weekly。

可选参数：

• --webhook https://example.com/hook — 事件发生时 POST 到指定 URL
• --metadata '{"team":"competitive-intel"}' — 附加 JSON 元数据用于自己的记录
• --output-schema '<json>' — 结构化事件负载（高级）

解析 JSON 提取 monitor_id。告知用户：

• 监控已创建及其 ID
• 频率（以便知道何时预期第一个事件）
• 事件会累积在服务端——稍后可以运行 parallel-cli monitor events $MONITOR_ID 查看变化

如果配置了 webhook，建议测试：

parallel-cli monitor simulate "$MONITOR_ID"

simulate 需要监控已配置 webhook。如果没有，会报错 Webhook not configured for this monitor——不要在未使用 --webhook 创建的监控上运行。

列出监控

parallel-cli monitor list -n 10 --json

默认使用 -n 10——拥有大量历史监控的账户可能返回数兆字节的 JSON。仅在用户明确要求“全部”或更大数量时提高限制。以表格形式呈现：ID、查询（截断）、频率、创建时间。

注意：monitor list 不保证按最新优先排序，因此刚创建的监控可能不会出现在第一页结果中。如果用户验证创建，建议使用 monitor get $MONITOR_ID（使用创建时返回的 ID）而不是扫描列表。

查看监控的事件

parallel-cli monitor events "$MONITOR_ID" --lookback 10d --json

回溯格式：Nd（天）或 Nw（周）。默认 10d。

如需查看特定事件组的详细信息：

parallel-cli monitor event-group "$MONITOR_ID" "$EVENT_GROUP_ID" --json

为用户总结：时间段内的事件数量，然后列出变化及时间戳。引用事件负载中的源 URL。

获取/更新/删除

parallel-cli monitor get "$MONITOR_ID" --json
parallel-cli monitor update "$MONITOR_ID" --cadence weekly --json
parallel-cli monitor delete "$MONITOR_ID" --json

删除前务必确认——删除不可恢复。

设置

需要 parallel-cli（已安装并认证）。如果 parallel-cli --version 失败，或后续命令因认证错误失败，请告知用户查看 https://docs.parallel.ai/integrations/cli 并停止。