SuperAPI AI 工具集

channel-forward-parity

通用与其它

查看项目

更新于 10-16 06:17

技能介绍

用途:在修改任何渠道 webhook 路由或共享 drain-channel 工作流之前,用该技能审计各渠道投递路径的一致性。

审计范围(源码文件):src/server/channels/last-forward.ts;src/server/workflows/channels/drain-channel-workflow.ts;src/app/api/channels/slack/webhook/route.ts;src/app/api/channels/telegram/webhook/route.ts;src/app/api/channels/discord/webhook/route.ts;src/app/api/channels/whatsapp/webhook/route.ts;src/app/api/channels/summary/route.ts;src/server/admin/why-not-ready.ts。

主要能力:产出两张表。第一张按 Channel、Branch、Logs event、Updates lastForward、Classification、Stale URL refresh、Evidence 逐分支核对;第二张额外覆盖相关性传播:requestId/deliveryId、workflowRunId 是否传播。

必要规则:每次投递尝试都必须更新 lastForward;每个 skip/reject 分支必须记录结构化原因;工作流转发已记录 lastForward,不得在其之上重复记录;route-ready、native-accepted、user-visible-reply 须分开对待;热点轮询路径不要加 info 级日志,除非运维必需,ring-buffer 淘汰会掩盖证据;不得给路由处理器添加 export const runtime = "nodejs";工作流交接分支需验证 channels.<ch>_workflow_started、channels.forward_attempt、channels.forward_outcome 可通过 requestId/deliveryId 与 workflowRunId 关联;若 npx workflow 无法检查运行,一致性证据须回退到 Vercel 日志加 /api/admin/logs;不接受“workflow started”作为原生接受证明,需 forward attempt/outcome 或用户可见回复证据;未尝试应用 admin SSH/exec 回退或标记不可用前,不得把 npx sandbox 失败当作 sandbox 不可达;信任 vercel、npx workflow 或 npx sandbox 输出前先验证项目定位,若 .vercel/project.json 指向不同发布,需明确的项目/团队/部署定位证据。

当前审计种子:检查 Slack fast-path fetch-exception 分支的 recordChannelLastForward 覆盖;检查 Telegram 未授权、无效 JSON、去重分支在需要运维证据处是否有结构化日志;检查 WhatsApp 重复/跳过分支的结构化日志与清晰分类;检查每个 sandbox-not-listening 分支是否每请求恰好一次过期端口刷新。

限制:资料未提供具体安装命令、收费信息或运行示例,相关细节暂未提供。