用途
该技能用于为 evlog 开发新的框架集成,让 HTTP 框架通过中间件或插件自动记录宽事件。它覆盖实现方式、公共接口以及仓库内的配套更新。
两种实现路径
常规请求与响应中间件优先使用基于 evlog/toolkit 中 defineFrameworkIntegration 的声明式模式,复用请求提取、日志创建、挂载和异步本地存储等公共逻辑。只有框架生命周期无法在开始时同步取得请求,例如服务器动作、模块级钩子或智能体运行轮次,才采用较低层的自定义生命周期工具。原文提供 Next.js、Nitro 和 Eve 等自定义模式作为参考。
主要要求
集成应提供统一的配置入口、中间件或插件、请求范围内的日志支持以及框架原生访问方式。公共逻辑应优先复用 shared/ 与 toolkit 的工具,不另写一套重复实现;Workers 的异步本地存储兼容配置需要单独注意。
工作流程
原文列出十五项检查点,除集成源码外,还包括构建入口、包导出与依赖、测试、框架文档、概览与安装入口、落地页和框架展示组件、公开 Skill、README、带测试界面的示例应用、changeset 以及 PR scope。实现前按命名约定选取参考集成,实现后执行相应构建与测试。
注意事项
新增 PR scope 的检查以目标分支已有列表为准,需要提前注册,或在引入时使用不带 scope 的标题。声明式模式适合常规 HTTP 生命周期,自定义模式用于明确不匹配的情况;该技能本身不证明某个新框架已经获得生产验证。