跳转到内容
搜索文档

本地资源浏览器

最后更新 查看 MarkdownAgent 设置

本地资源浏览器是一个基于浏览器的界面,用于在开发期间查看和编辑本地绑定中的数据。它可在本地开发服务器的 /cdn-cgi/explorer 路径访问。

无需运行 CLI 命令或编写临时代码来检查本地状态,您可以在浏览器中打开本地资源浏览器并直接操作数据。这在需要填充测试数据、验证 Worker 写入的内容、调试 Workflow 运行,或对本地 D1 数据库运行临时 SQL 查询时很有用。

本地资源浏览器同时支持 WranglerCloudflare Vite 插件

前提条件

打开本地资源浏览器

  1. 启动本地开发会话:
npx wrangler dev
  1. 在终端中按 e 在浏览器中打开本地资源浏览器。您也可以直接导航到 Worker 路由和端口上的 /cdn-cgi/explorer

本地资源浏览器默认可用,并会自动检测 Wrangler 配置 中定义的绑定。

支持的绑定

本地资源浏览器支持以下绑定类型:

绑定 查看 编辑
KV 浏览键、查看值和元数据 创建、更新和删除键值对
R2 列出对象、查看元数据 上传和删除对象
D1 浏览表和行、运行 SQL 查询 通过 SQL 插入、更新和删除行
Durable Objects (SQLite storage) 浏览 SQLite 表和行、运行 SQL 查询 通过 SQL 插入、更新和删除行
Workflows 列出实例、查看状态和步骤历史 触发新运行、重试失败的实例

D1 与 Durable Objects SQL studio

对于 D1 数据库和使用 SQLite storage APIDurable Objects,本地资源浏览器包含 SQL studio。这与 Cloudflare 仪表板中为已部署 D1 数据库提供的体验相同。它提供可视化表浏览器(支持内联编辑)和 SQL 查询编辑器,可运行任意查询。

API

本地资源浏览器在 /cdn-cgi/explorer/api 暴露 API,以编程方式提供与浏览器界面相同的操作。该 API 提供 OpenAPI 规范,描述所有可用端点、参数和响应格式。

获取 OpenAPI 规范:

curl http://localhost:8787/cdn-cgi/explorer/api

与 AI 编码代理配合使用

/cdn-cgi/explorer/api 上的 OpenAPI 规范允许 AI 编码代理和其他工具以编程方式发现并交互您的本地绑定。代理可以获取规范、了解有哪些可用资源,并调用 API 读取或修改本地数据,而无需手动设置。

当您希望代理执行以下操作时,这可以作为 CLI 的替代方案:

  • 在本地 KV 命名空间或 D1 数据库中填充测试数据
  • 在调试期间检查 Durable Object 的状态
  • 使用不同输入数据触发或重试 Workflow 运行
  • 将测试文件上传到本地 R2 存储桶

这篇文档对您有帮助吗?