From adb14cff770c042454f6f8fb09d40cceffce7c1d Mon Sep 17 00:00:00 2001
From: imbytecat <imbytecat@gmail.com>
Date: Sat, 7 Feb 2026 16:14:55 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E9=87=8D=E6=9E=84=20Turbo=20=E6=9E=84?=
 =?UTF-8?q?=E5=BB=BA=E9=85=8D=E7=BD=AE=E5=B9=B6=E5=BC=BA=E5=8C=96=20Bun=20?=
 =?UTF-8?q?=E4=B8=93=E7=94=A8=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

将应用特定的构建输出配置下沉至各自 turbo.json，根级 build 任务添加拓扑依赖；AGENTS.md 统一添加 Bun 专用运行时警告；桌面端启用 Linux CEF 渲染器。
---
 AGENTS.md                         | 6 +++++-
 apps/desktop/AGENTS.md            | 3 +++
 apps/desktop/electrobun.config.ts | 3 +++
 apps/desktop/src/bun/index.ts     | 1 +
 apps/desktop/turbo.json           | 9 +++++++++
 apps/server/AGENTS.md             | 6 +++++-
 apps/server/turbo.json            | 3 +++
 turbo.json                        | 7 ++-----
 8 files changed, 31 insertions(+), 7 deletions(-)
 create mode 100644 apps/desktop/turbo.json

diff --git a/AGENTS.md b/AGENTS.md
index 66c3375..2f9d342 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,8 +4,11 @@ Guidelines for AI agents working in this Bun monorepo.
 
 ## Project Overview
 
+> **⚠️ This project uses [Bun](https://bun.sh) exclusively as both the JavaScript runtime and package manager. Do NOT use Node.js / npm / yarn / pnpm. All commands start with `bun` — use `bun install` for dependencies and `bun run` / `bun <script>` for scripts. Never use `npm`, `npx`, or `node`.**
+
 - **Monorepo**: Bun workspaces + Turborepo orchestration
-- **Runtime**: Bun (see `mise.toml` for version)
+- **Runtime**: Bun (see `mise.toml` for version) — **NOT Node.js**
+- **Package Manager**: Bun — **NOT npm / yarn / pnpm**
 - **Apps**:
   - `apps/server` - TanStack Start fullstack web app (see `apps/server/AGENTS.md`)
   - `apps/desktop` - Tauri v2 desktop shell, loads server via sidecar (see `apps/desktop/AGENTS.md`)
@@ -153,6 +156,7 @@ export const myTable = pgTable('my_table', {
 - Include `createdAt`/`updatedAt` on all tables
 
 **DON'T:**
+- Use `npm`, `npx`, `node`, `yarn`, `pnpm` — always use `bun` / `bunx`
 - Edit `src/routeTree.gen.ts` (auto-generated)
 - Use `as any`, `@ts-ignore`, `@ts-expect-error`
 - Commit `.env` files
diff --git a/apps/desktop/AGENTS.md b/apps/desktop/AGENTS.md
index 4d5e770..66a3550 100644
--- a/apps/desktop/AGENTS.md
+++ b/apps/desktop/AGENTS.md
@@ -2,6 +2,8 @@
 
 Electrobun desktop shell - loads the server app in a native window.
 
+> **⚠️ This project uses Bun — NOT Node.js / npm. All commands use `bun`. Never use `npm`, `npx`, or `node`.**
+
 ## Architecture
 
 - **Type**: Electrobun desktop application
@@ -75,5 +77,6 @@ Electrobun.events.on('will-quit', () => {
 - Handle server startup gracefully
 
 **DON'T:**
+- Use `npm`, `npx`, `node`, `yarn`, `pnpm` — always use `bun` / `bunx`
 - Hardcode dependency versions (use catalog)
 - Block main thread during server wait
diff --git a/apps/desktop/electrobun.config.ts b/apps/desktop/electrobun.config.ts
index 1f45052..b0b12ce 100644
--- a/apps/desktop/electrobun.config.ts
+++ b/apps/desktop/electrobun.config.ts
@@ -10,5 +10,8 @@ export default {
     bun: {
       entrypoint: 'src/bun/index.ts',
     },
+    linux: {
+      bundleCEF: true,
+    },
   },
 } satisfies ElectrobunConfig
diff --git a/apps/desktop/src/bun/index.ts b/apps/desktop/src/bun/index.ts
index 8078415..51d07e2 100644
--- a/apps/desktop/src/bun/index.ts
+++ b/apps/desktop/src/bun/index.ts
@@ -38,6 +38,7 @@ async function main() {
       width: 1200,
       height: 800,
     },
+    renderer: 'cef',
   })
 
   Electrobun.events.on('will-quit', () => console.log('Quitting...'))
diff --git a/apps/desktop/turbo.json b/apps/desktop/turbo.json
new file mode 100644
index 0000000..054a5fb
--- /dev/null
+++ b/apps/desktop/turbo.json
@@ -0,0 +1,9 @@
+{
+  "$schema": "../../node_modules/turbo/schema.json",
+  "extends": ["//"],
+  "tasks": {
+    "build": {
+      "outputs": ["build/**", "artifacts/**"]
+    }
+  }
+}
diff --git a/apps/server/AGENTS.md b/apps/server/AGENTS.md
index c2d9202..8844eb8 100644
--- a/apps/server/AGENTS.md
+++ b/apps/server/AGENTS.md
@@ -4,8 +4,11 @@ TanStack Start fullstack web app with ORPC (contract-first RPC).
 
 ## Tech Stack
 
+> **⚠️ This project uses Bun — NOT Node.js / npm. All commands use `bun`. Never use `npm`, `npx`, or `node`.**
+
 - **Framework**: TanStack Start (React 19 SSR, file-based routing)
-- **Runtime**: Bun
+- **Runtime**: Bun — **NOT Node.js**
+- **Package Manager**: Bun — **NOT npm / yarn / pnpm**
 - **Language**: TypeScript (strict mode)
 - **Styling**: Tailwind CSS v4
 - **Database**: PostgreSQL + Drizzle ORM
@@ -195,6 +198,7 @@ export const env = createEnv({
 - Use `ORPCError` with proper codes
 
 **DON'T:**
+- Use `npm`, `npx`, `node`, `yarn`, `pnpm` — always use `bun` / `bunx`
 - Edit `src/routeTree.gen.ts` (auto-generated)
 - Use `as any`, `@ts-ignore`, `@ts-expect-error`
 - Commit `.env` files
diff --git a/apps/server/turbo.json b/apps/server/turbo.json
index 048910a..ba448ce 100644
--- a/apps/server/turbo.json
+++ b/apps/server/turbo.json
@@ -2,6 +2,9 @@
   "$schema": "../../node_modules/turbo/schema.json",
   "extends": ["//"],
   "tasks": {
+    "build": {
+      "outputs": [".output/**"]
+    },
     "compile": {
       "dependsOn": ["build"],
       "outputs": ["out/**"]
diff --git a/turbo.json b/turbo.json
index ca2e101..92bffb9 100644
--- a/turbo.json
+++ b/turbo.json
@@ -9,11 +9,8 @@
   ],
   "tasks": {
     "build": {
-      "outputs": ["dist/**", ".output/**", "build", "artifacts"]
-    },
-    "compile": {
-      "dependsOn": ["build"],
-      "outputs": ["out/**"]
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**"]
     },
     "dev": {
       "cache": false,