部署模式

Web 应用通过 NEXT_PUBLIC_APP_MODE 选择两种模式之一。选择是 构建时烤进去的 —— 没有运行时开关。

	`self-hosted`	`cloud`
默认？	是	仅当存在 Clerk Key 时
鉴权	无	Clerk（middleware + `<ClerkProvider>`）
存储	仅 IndexedDB	IndexedDB + Core API
AI Lab（面试/翻译/分析）	除非把 `NEXT_PUBLIC_API_URL` 指向后端，否则禁用	启用
分享和版本历史	仅本地	服务端支撑
同步状态指示	`local`	`saved` / `syncing` / `modified` / `error`

判定方式

apps/web/src/lib/config/app.ts 在模块加载时推导模式：

apps/web/src/middleware.ts 在 import 时挑对应的 middleware：

// 伪代码，见 middleware.ts
export default APP_MODE === 'cloud'
  ? clerkMiddleware(/* ... */)
  : () => NextResponse.next()

因为 Next.js middleware 是按构建打包的，切换模式需要重新构建，不能只是在运行中的服务器上改环境变量。

两种模式下跑的是同一棵 React 树、同一个 store、同一组路由。再做一个独立应用只会让维护面翻倍，行为却不会增加。Flag 模式保住了：

…而只在边缘做切换：鉴权 middleware、同步副作用、AI Lab 可见性。

没有充足理由，不要新增其他运行时模式开关或本地/云端分支。现在的边界是有意收窄的。详见贡献指南。