Thoughts, stories and ideas.
Send API的Test按钮测试正常,但在Workflow的Data Processing阶段配置后保存就丢失,Flow运行到对应阶段也不触发。根因有三重:默认JSON body缺少runtime.前缀、DataProcessingPolicy schema丢弃字段、前后端命名不统一。
一次上传3个文件分别选择Template A/B/C,Extraction识别正常但Comparison/Data Processing阶段全都取成了Template A的值。根因在run_input_files的extraction_result_id到template_id映射在后续阶段丢失,全都fallback到run-level的first_template_id。
记录了配置 Send Webhook 后 Flow 失败的严重踩坑场景。测试 API 成功但正式运行失败，根因是数据 ID 不匹配且异常未隔离。notification 失败导致整个 Flow failed，用户找不到失败原因。
记录了多文件上传后首次进入 Extraction Review 页面为空的踩坑场景。根因是页面加载太快，数据还没准备好；前端缺少轮询和等待机制。还包含一个 Save Edits 可能写错目标的待验证风险。
记录了 Workflow Comparison 配置删除后保存失败的踩坑场景。删除最后一条配置后，前端以为删干净了，后端还以为配置还在用，导致前后端状态不一致。
Comet 归档阶段 AI agent "7/7 成功"的背后，50 个后端文件被静默删除。记录根因、恢复过程，以及一个教训：永远不要跳过 `git diff --stat` 和 smoke test。
从一次GitHub Actions schedule事件不触发的排查过程出发，记录最小化探针、GitHub API交叉验证、fork与非fork对照实验的完整思路，最终定位到timezone字段行为不可靠这一关键坑点，总结出纯UTC cron的最佳实践。
记录一次 git pull --rebase 导致 .git 目录丢失的故障，从问题现象、根因分析到恢复方案，总结出可复用的 Git 最佳实践和操作前检查清单。
深入剖析OAuth2 Authorization Code Flow + PKCE的完整登录链路，结合Keycloak实战经验，还原一次414 URI Too Long错误的完整排查过程——从协议原理、前端实现、Nginx配置到根因定位。
一篇去除敏感信息的简短排查笔记：从一次414 URI Too Long问题，理解OAuth2、OIDC、JWT和Keycloak在登录流程中的分工。