SuperAPI AI 工具集

local-explorer

编程与开发

查看项目

更新于 10-15 19:50

技能介绍

用途:该技能用于在 Cloudflare Workers SDK 的 local-explorer 中新增产品或资源类型,涉及本地 API 与本地浏览器界面(UI)的扩展。

主要能力与流程:先阅读指定文件,包括 packages/miniflare/src/workers/local-explorer/explorer.worker.ts、packages/miniflare/src/plugins/core/explorer.ts、types.ts,以及一个相似的现有资源实现和对应测试;若有 UI 改动,还需阅读 Sidebar.tsx、routes 下的路由文件与 e2e 测试。随后在 openapi-filter-config.ts 添加 API 表面,用 OPENAPI_INPUT_PATH=<path-to-full-openapi-spec> pnpm --dir packages/miniflare generate:api 生成过滤后的规范与后端类型,必要时添加 ignores 并重新生成。接着在 explorer.ts 中通过 constructExplorerBindingMap() 与 constructExplorerWorkerOpts() 接入绑定,在 types.ts 扩展绑定元数据,在 resources/<product>.ts 实现处理器,在 explorer.worker.ts 注册 Hono 路由,并用生成的 Zod schema 校验请求体与查询参数,用 wrapResponse() 和 errorResponse() 返回 Cloudflare API 信封响应。之后添加 Miniflare 测试,运行 pnpm --dir packages/local-explorer-ui build 重新生成 UI API 客户端,添加 UI 路由与组件(使用 Kumo 组件),并补充 Playwright e2e 测试。

规则与限制:不要直接编辑生成文件(如 openapi.local.json 或 generated/ 目录);优先使用上游 Cloudflare API 路径,仅本地 API 用 extensions.paths;对不支持的参数、头、请求体属性与响应字段添加 ignores。本地列表端点(如列出 KV 命名空间)不应实现分页,针对单个资源的分页可支持;跨 worker 聚合使用 aggregation.ts 中的 aggregateListResults()、getPeerUrlsIfAggregating()、fetchFromPeer()。需要文件系统访问时通过 c.env.MINIFLARE_LOOPBACK 调用 Node.js 端点。UI 侧使用 Kumo 颜色令牌,不使用 tailwindCSS 颜色令牌。资料未提供具体收费、价格或平台信息。