void

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Void

Read only the guides needed for the user's task. Prefer the app's installed documentation at

node_modules/void/docs/

so it matches the app's Void version. All

docs/

paths below are relative to that package's root. When using this skill globally without a local Void installation, follow the skill's symlink to its real directory and use

../../docs/

in the same Void package. If the skill was copied without the package, use the guides at https://void.cloud instead.

Before running a Void command, find its group in

docs/reference/cli.md

, then read the matching page under

docs/reference/cli/

for syntax, options, and deployment target. Use Void commands for application and platform workflows. Mention Wrangler only when the user needs to recognize a literal configuration file or environment variable.

Use

void

and

@void/*

in imports, examples, and package manifests. Follow the project's existing framework and deployment destination. Deploying to a Void platform requires an explicit

void connect <url>

first; never infer a platform from old examples, tokens, or project IDs. Platform hostnames passed to

void connect

default to HTTPS. Loopback hosts (

localhost

127.0.0.1

, and

[::1]

) default to HTTP:

void connect localhost:8787

. An explicit scheme overrides the default. For a one-time deployment elsewhere, connect to that platform, then set

VOID_API_URL

for the deploy command and pass

--project <slug>

. This preserves the app's existing saved destination, including when the target project is new.

仅阅读用户任务所需的指南。优先使用应用安装在

node_modules/void/docs/

下的文档，以确保与应用的 Void 版本一致。以下所有

docs/

路径均相对于该包的根目录。在本地没有 Void 安装的情况下全局使用此 skill 时，请沿着该 skill 的符号链接进入其真实目录，并在同一个 Void 包中使用

../../docs/

。如果复制此 skill 时未复制该包，请改用 https://void.cloud 上的指南。

在运行 Void 命令前，先在

docs/reference/cli.md

中找到命令所属的分组，再阅读

docs/reference/cli/

下对应的页面，以了解语法、选项和部署目标。对于应用和平台工作流，应使用 Void 命令。只有当用户需要识别实际的配置文件或环境变量时，才提及 Wrangler。

在 imports、示例和 package manifests 中使用

void

和

@void/*

。遵循项目现有的框架和部署目标。将应用部署到 Void platform 前，必须先显式执行

void connect <url>

；绝不根据旧示例、token 或 project ID 推断目标 platform。

传给

void connect

的 platform hostname 默认使用 HTTPS。Loopback host（

localhost

、

127.0.0.1

和

[::1]

）默认使用 HTTP，例如

void connect localhost:8787

。显式指定 scheme 会覆盖默认值。如需一次性部署到其他位置，请先 connect 到该 platform，然后为 deploy 命令设置

VOID_API_URL

并传入

--project <slug>

。这样可以保留应用已保存的目标位置，即使目标 project 是新的也不受影响。

Task Routing

任务路由

User intent	Docs file(s)
CLI command syntax, flags, env vars	`docs/reference/cli.md`
Initial setup, onboarding, first app	`docs/guide/quickstart.md` , `docs/reference/cli/setup.md`
App type detection and mode behavior	`docs/guide/app-types.md` , `docs/reference/config.md`
Server/API routing and middleware	`docs/guide/server-routing.md` , `docs/integrations/hono.md`
Pages mode, loader/action, forms, layouts	`docs/guide/pages-routing/*.md` , `docs/guide/type-safety.md`
Database and migrations	`docs/guide/database.md` , `docs/guide/type-safety.md`
Typed fetch and end-to-end typing	`docs/guide/typed-fetch.md` , `docs/guide/type-safety.md`
Authentication	`docs/guide/auth.md` , `docs/guide/env-vars.md`
Cloudflare runtime bindings and config	`docs/integrations/cloudflare.md` , `docs/reference/config.md` , `docs/guide/env-vars.md`
AI inference (Workers AI, providers)	`docs/guide/ai.md`
Durable State and WebSockets	`docs/guide/durable-state.md` , `docs/guide/websockets.md`
Server-sent events and live streams	`docs/guide/sse.md` , `docs/guide/live.md`
Sandboxes	`docs/guide/sandboxes.md`
Email	`docs/guide/email.md` , then the matching guide under `docs/guide/email/`
KV / storage / queues / cron jobs	`docs/guide/kv.md` , `docs/guide/storage.md` , `docs/guide/queues.md` , `docs/guide/jobs.md`
SSR and caching	`docs/guide/ssr.md` , `docs/guide/edge/*.md`
HTTPS, rewrites, redirects, fallbacks	`docs/guide/edge/rewrites.md` , `docs/guide/edge/redirects.md` , `docs/reference/config.md`
Static site generation	`docs/guide/ssg.md`
Connected apps and artifact preparation	`docs/guide/platform/administration/connected-apps.md` , `docs/reference/api/deploy.md`
Deployment and CI	`docs/guide/deployment.md` , `docs/reference/cli/deploy.md`
Install or maintain a company platform	`docs/guide/self-hosted-platform.md` , `docs/reference/cli/platform-installation.md`
Develop or deploy a platform fork	`docs/guide/platform-development.md` , `docs/guide/self-hosted-platform.md`
Platform administration	`docs/guide/platform-administration.md` , `docs/reference/cli/platform.md`
Platform plans and account limits	`docs/guide/platform/administration/plans.md` , `docs/reference/cli/platform-config.md`
Self-host deploy to own Cloudflare account	`docs/integrations/cloudflare.md` , `docs/reference/cli/deploy.md`
Project status, deployment history	`docs/reference/cli/project.md`
Cache purging	`docs/reference/cli/project.md`
Project logs, runtime errors	`docs/reference/cli/project.md`
Secrets management (put/sync/delete)	`docs/reference/cli/secrets.md` , `docs/guide/env-vars.md`
Typed env vars ( `defineEnv` , `env.ts` )	`docs/guide/env-vars.md`
Custom domain setup	`docs/reference/cli/domains.md`
Database status, reset, seed, export	`docs/reference/cli/database.md` , `docs/guide/database.md`
Auth login/logout/whoami	`docs/reference/cli/auth.md`
Overview / introduction	`docs/guide/index.md`
API surface details	`docs/reference/api.md`
Meta framework integration	`docs/integrations/frameworks/*.md`
Coding agent setup	`docs/integrations/agents.md`
Node.js / Bun / Deno targets	`docs/integrations/nodejs-bun-deno.md`
ORMs and external databases	`docs/guide/database.md`
Project structure and conventions	`docs/reference/structure.md`
Resource/binding inference	`docs/reference/resource-inference.md`

用户意图	文档文件
CLI 命令语法、flags 和环境变量	`docs/reference/cli.md`
初始设置、入门引导和首个应用	`docs/guide/quickstart.md` , `docs/reference/cli/setup.md`
应用类型检测和 mode 行为	`docs/guide/app-types.md` , `docs/reference/config.md`
Server/API 路由和 middleware	`docs/guide/server-routing.md` , `docs/integrations/hono.md`
Pages 模式、loader/action、forms 和 layouts	`docs/guide/pages-routing/*.md` , `docs/guide/type-safety.md`
数据库和 migrations	`docs/guide/database.md` , `docs/guide/type-safety.md`
类型化 fetch 和端到端类型推断	`docs/guide/typed-fetch.md` , `docs/guide/type-safety.md`
身份验证	`docs/guide/auth.md` , `docs/guide/env-vars.md`
Cloudflare runtime bindings 和配置	`docs/integrations/cloudflare.md` , `docs/reference/config.md` , `docs/guide/env-vars.md`
AI 推理（Workers AI、providers）	`docs/guide/ai.md`
Durable State 和 WebSockets	`docs/guide/durable-state.md` , `docs/guide/websockets.md`
Server-sent events 和 live streams	`docs/guide/sse.md` , `docs/guide/live.md`
Sandboxes	`docs/guide/sandboxes.md`
电子邮件	`docs/guide/email.md` ，然后阅读 `docs/guide/email/` 下对应的指南
KV / storage / queues / cron jobs	`docs/guide/kv.md` , `docs/guide/storage.md` , `docs/guide/queues.md` , `docs/guide/jobs.md`
SSR 和缓存	`docs/guide/ssr.md` , `docs/guide/edge/*.md`
HTTPS、rewrites、redirects 和 fallbacks	`docs/guide/edge/rewrites.md` , `docs/guide/edge/redirects.md` , `docs/reference/config.md`
静态站点生成	`docs/guide/ssg.md`
Connected apps 和 artifact preparation	`docs/guide/platform/administration/connected-apps.md` , `docs/reference/api/deploy.md`
部署和 CI	`docs/guide/deployment.md` , `docs/reference/cli/deploy.md`
安装或维护企业内部 platform	`docs/guide/self-hosted-platform.md` , `docs/reference/cli/platform-installation.md`
开发或部署 platform fork	`docs/guide/platform-development.md` , `docs/guide/self-hosted-platform.md`
Platform 管理	`docs/guide/platform-administration.md` , `docs/reference/cli/platform.md`
Platform plans 和账户限制	`docs/guide/platform/administration/plans.md` , `docs/reference/cli/platform-config.md`
自托管部署到自己的 Cloudflare 账户	`docs/integrations/cloudflare.md` , `docs/reference/cli/deploy.md`
项目状态和部署历史	`docs/reference/cli/project.md`
缓存清除	`docs/reference/cli/project.md`
项目日志和 runtime 错误	`docs/reference/cli/project.md`
Secrets 管理（put/sync/delete）	`docs/reference/cli/secrets.md` , `docs/guide/env-vars.md`
类型化环境变量（ `defineEnv` 、 `env.ts` ）	`docs/guide/env-vars.md`
自定义域名设置	`docs/reference/cli/domains.md`
数据库状态、重置、seed 和导出	`docs/reference/cli/database.md` , `docs/guide/database.md`
Auth 登录/退出/whoami	`docs/reference/cli/auth.md`
概览/简介	`docs/guide/index.md`
API surface 详情	`docs/reference/api.md`
Meta framework 集成	`docs/integrations/frameworks/*.md`
Coding Agent 设置	`docs/integrations/agents.md`
Node.js / Bun / Deno 目标	`docs/integrations/nodejs-bun-deno.md`
ORM 和外部数据库	`docs/guide/database.md`
项目结构和约定	`docs/reference/structure.md`
Resource/binding 推断	`docs/reference/resource-inference.md`

Working rules

工作规则

Read the relevant guide before changing configuration, persistent resources, authentication, or deployment workflows. The guides define current behavior; avoid copying a second set of instructions into this skill.
Before moving deployed Durable State, native Durable Object, or WebSocket definitions, read their guides and use
```
void info
```
to preserve resource names and instance keys.
Declare application environment keys in
```
env.ts
```
and access them through
```
void/env
```
; follow
```
docs/guide/env-vars.md
```
for local and production values.

In Pages navigation, style the current link with

Link

aria-current

and

data-void-active

attributes (

activeMatch="prefix"

for sections) instead of comparing

useRouter().path

; see

docs/guide/pages-routing/overview.md#active-links

. Show a loading state on the clicked link with

data-void-pending

instead of matching

useNavigation().location

yourself; see

docs/guide/pages-routing/overview.md#pending-links

For platform setup, follow the pages linked from
```
docs/guide/self-hosted-platform.md
```
. Use
```
void platform list
```
to find the installation slug for maintenance. For recovery, use its documented resume or repair workflow and preserve the installation's credentials and resources.
Use
```
--plan
```
to review platform changes. If an operation has an uncertain outcome, inspect its status and events before retrying.

If the user invokes this skill without a task, inspect the app's local structure, configuration, and saved deployment destination, give a brief status, and ask what they want to work on.

Await AI and Sandbox operations normally. Usage limits reject with

UsageLimit

from

void/limits

; Void routes and Pages actions automatically return HTTP 429. Optionally catch with

instanceof UsageLimit

for a fallback or custom response. In Pages, prefer the adapter’s

Form

with

useForm()

so action failures remain visible and entered data is preserved. See

docs/guide/ai.md

docs/guide/sandboxes.md

, and

docs/guide/pages-routing/actions-and-forms.md

在修改配置、持久化资源、身份验证或部署工作流之前，先阅读相关指南。指南定义了当前行为；避免在此 skill 中复制第二套说明。
在迁移已部署的 Durable State、原生 Durable Object 或 WebSocket 定义之前，先阅读相应指南，并使用
```
void info
```
保留资源名称和实例键。
在
```
env.ts
```
中声明应用环境变量键，并通过
```
void/env
```
访问；本地和生产环境值遵循
```
docs/guide/env-vars.md
```
。

在 Pages 导航中，使用

Link

的

aria-current

和

data-void-active

属性设置当前链接样式（分区使用

activeMatch="prefix"

），不要自行比较

useRouter().path

；参见

docs/guide/pages-routing/overview.md#active-links

。在点击的链接上使用

data-void-pending

显示加载状态，不要自行匹配

useNavigation().location

；参见

docs/guide/pages-routing/overview.md#pending-links

。

对于 platform 设置，请遵循
```
docs/guide/self-hosted-platform.md
```
中链接的页面。使用
```
void platform list
```
查找用于维护的 installation slug。恢复时，使用文档中说明的 resume 或 repair 工作流，并保留 installation 的 credentials 和 resources。
使用
```
--plan
```
审查 platform 变更。如果某项操作的结果不确定，请在重试前检查其 status 和 events。

如果用户在未指定任务的情况下调用此 skill，请检查应用的本地结构、配置和已保存的 deployment destination，给出简短状态，并询问用户希望处理什么。

通常应等待 AI 和 Sandbox 操作完成。达到 usage limit 时，系统会通过

void/limits

中的

UsageLimit

拒绝请求；Void 路由和 Pages actions 会自动返回 HTTP 429。可以选择使用

instanceof UsageLimit

捕获异常，以提供 fallback 或 custom response。在 Pages 中，优先使用 adapter 的

Form

与

useForm()

，这样 action failures 仍然可见，且已输入的数据得以保留。参见

docs/guide/ai.md

、

docs/guide/sandboxes.md

和

docs/guide/pages-routing/actions-and-forms.md

。