From 67c57b4ed77021431ea62f8559d5b69c5c172da4 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 7 Aug 2026 16:33:05 +0000 Subject: [PATCH] =?UTF-8?q?docs(runner):=20=E5=88=A0=E6=8E=89=20Best=20Pra?= =?UTF-8?q?ctices=20=E9=87=8C=E5=A4=8D=E6=B4=BB=E7=9A=84=E7=8E=AF=E5=A2=83?= =?UTF-8?q?=E5=8F=98=E9=87=8F=E9=85=8D=E7=BD=AE=E9=9D=A2=20(#3617)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #3538(039d2d077,Fixes #3533)以「文档不许描述不存在的能力」为由删掉了本页的 `## Environment Variables` 整节,但只删了那一节 —— `## Best Practices` 下的 `### 2. Environment Configuration` 把同一个不存在的配置面又讲了一遍,教读者用 `import.meta.env.VITE_API_URL` / `VITE_ENABLE_ANALYTICS` 配置 Runner。 实现侧不支持这个说法:`grep -rn "import.meta.env|process.env|loadEnv|VITE_" packages/runner` 整包无输出。同页 `## Metadata Loading`(:95)写着相反的话 ——「it reads no environment variables and no config file」,两句相隔约 400 行。 按 #3538 的口径整节删除,而不是换个变量名续命:Runner 没有任何配置面可以承接 它,唯一的配置入口是 `?api=` 查询参数,已由 Metadata Loading 一节完整覆盖。 Best Practices 余下两条,`### 3. Error Boundaries` 顺延为 `### 2.`。 Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01GTRjn8xBqp75dk7kFupVRt --- content/docs/utilities/runner.mdx | 15 +-------------- 1 file changed, 1 insertion(+), 14 deletions(-) diff --git a/content/docs/utilities/runner.mdx b/content/docs/utilities/runner.mdx index cff53c94c1..355c350f19 100644 --- a/content/docs/utilities/runner.mdx +++ b/content/docs/utilities/runner.mdx @@ -488,20 +488,7 @@ src/app-data/ └── accounts.json # route "/crm/accounts" ``` -### 2. Environment Configuration - -Use environment variables for configuration: - -```typescript -const config = { - apiUrl: import.meta.env.VITE_API_URL, - features: { - analytics: import.meta.env.VITE_ENABLE_ANALYTICS === 'true', - }, -} -``` - -### 3. Error Boundaries +### 2. Error Boundaries Wrap components in error boundaries: