WorkerDock icon

WorkerDock

WorkerDock 是一款免费的 macOS 应用,用于查找和管理本地 Cloudflare Workers、Pages、Astro、EmDash 及其他 Wrangler 项目,集中处理进程、端口、日志、绑定和部分本地数据工具,适合个人本地开发。

WorkerDock

在 macOS 上管理本地 Cloudflare 项目

WorkerDock 是一款 macOS 应用,可在一个窗口中管理本地 Cloudflare Workers 项目。它会扫描指定文件夹中的本地 Workers、Pages、Astro、EmDash、Vite 及其他基于 Wrangler 的项目,然后显示其状态、端口、项目类型和绑定信息。

该应用旨在取代多个终端标签页以及手动跟踪开发进程的做法。用户可以启动、停止和重启项目,查看实时日志,识别 D1、KV 和 R2 等资源,并使用菜单栏控制项,而无需重新打开主窗口。根据产品所述行为,WorkerDock 对项目文件夹采取只读方式,并将项目代码和数据保留在 Mac 上。

功能

项目发现

选择一个文件夹,让 WorkerDock 扫描嵌套目录和 monorepo,查找本地 Wrangler-based Workers、Pages、Astro、EmDash、Vite 及其他受支持的项目类型。

统一项目列表

在一个侧边栏中查看项目,包括检测到的类型、当前状态、本地端口、收藏状态和搜索支持。

进程控制

从主窗口或菜单栏启动、停止或重启项目。WorkerDock 会选择合适的命令和空闲端口,并管理项目进程组,以便更干净地关闭进程。

绑定概览

查看 D1、KV、R2、Queues、Durable Objects、Workflows、Service bindings、Workers AI、Vectorize 和 Hyperdrive 等资源的绑定关系图或列表。不会显示具体值。

日志和诊断

读取可选择的实时输出,支持筛选、自动跟随、缓冲上限和可见的错误高亮。端口冲突和缺少依赖项会被提示,但不会自动安装软件包。

本地工作流工具

使用内置的本地 Explorer 查看 D1、KV、R2、Durable Object 和 Workflow 数据,在浏览器中打开本地网站,并通过 macOS 菜单栏控制项目。

使用场景

  • 运行多个本地服务

    扫描一次工作区或 monorepo,然后启动和停止多个本地 Workers,无需打开单独的终端标签页或手动跟踪每个端口。

  • 检查资源连接

    在调试数据流或配置关系之前,检查项目的 D1、KV、R2、队列、Durable Object 或其他绑定名称。

  • 诊断开发问题

    使用实时、可筛选的日志和端口冲突说明,识别启动失败、端口被占用、缺少依赖项以及本地服务发出的请求。

  • 从菜单栏管理项目

    在不同应用之间切换时,通过 macOS 菜单栏启动、停止、重启或打开本地项目。

  • 检查本地开发数据

    在开发本地项目时,通过内置 Explorer 浏览本地 D1、KV、R2、Durable Object 和 Workflow 数据。

Pros and Cons

Pros

  • 在一个 Mac 界面中整合项目发现、进程控制、日志、端口和绑定检查功能。
  • 扫描嵌套文件夹和 monorepo,查找多种本地项目类型。
  • 停止项目时也会停止其 workerd 进程,有助于避免本地进程持续运行和端口被占用。
  • 显示绑定名称但不公开变量值,并且据描述对项目文件夹采取只读方式。
  • 包含菜单栏控制、收藏、搜索、本地数据浏览和可选择日志。

Cons

  • 需要 macOS 14(Sonoma)或更高版本。
  • 文档所述工作流侧重于本地项目;现有信息无法证明其支持团队协作或远程项目管理。
  • 部分计划中的功能(包括本地 D1 迁移和 .dev.vars 编辑器)尚未包含。

FAQ

WorkerDock 如何查找项目?

WorkerDock 会扫描您选择的文件夹(包括嵌套文件夹和 monorepo)中的本地 Wrangler 项目,然后列出检测到的项目及其状态、端口和可用的绑定信息。

WorkerDock 可以对本地项目执行哪些操作?

它可以启动、停止和重启检测到的本地项目。WorkerDock 会选择适当的命令和空闲端口;停止项目时,也会停止其关联的 workerd 进程。

WorkerDock 会显示配置密钥或变量值吗?

WorkerDock 会显示绑定名称和类型,包括检测到的 D1、KV、R2、Queues、Durable Objects、Workflows、Service bindings、Workers AI、Vectorize 和 Hyperdrive。它会显示变量名称,而不会显示变量值。

WorkerDock 会修改或上传我的项目文件吗?

不会。该应用被描述为对项目文件夹只读,不会上传代码或数据,也不会更改项目文件。如果缺少依赖项,它会显示安装命令,但不会执行该命令。

WorkerDock 支持哪些平台,项目范围是什么?

WorkerDock 需要 macOS 14(Sonoma)或更高版本,并作为一款免费的 Mac 应用提供。现有信息描述的是本地项目管理,而不是团队或远程项目管理。

Quick Facts

类别
开发者工具
平台
macOS 14(Sonoma)或更高版本
主要用途
管理本地 Cloudflare Workers 项目
项目类型
Workers、Pages、Astro、EmDash、Vite 和 Wrangler 项目
可用性
免费的 Mac 应用;在 GitHub 上开源
最新文档版本
0.1.2