Show HN:一個AI代理可以安全構建和維護應用的單一代碼庫
一個面向生產的單一代碼庫啓動模板,基於pnpm工作空間、Turborepo、Cloudflare Workers、Hono、React、Tailwind CSS v4和TanStack Router/Query構建。專為AI代理設計,通過清晰的約定和邊界安全地構建和維護應用程序。
該單一代碼庫(monorepo)模板旨在為AI代理提供一個安全且高效的環境,使其能夠自主構建和維護應用程序。通過結構化的約定和明確的邊界,模板顯著降低了意外副作用的風險,特別適合需要AI輔助開發的生產級項目。
模板基於pnpm工作空間和Turborepo實現高效的依賴管理和構建緩存,同時利用Cloudflare Workers進行邊緣部署,確保低延遲和全球可用性。前端技術棧包括React(使用Vite 8構建)、Tailwind CSS v4和TanStack Router/Query,提供了現代化的開發體驗。後端服務則通過Hono框架構建,按運行時角色分為HTTP網關(worker-api)、業務邏輯Worker(worker-*)、隊列消費者(queue-*)、Webhook入口(webhook-*)和MCP服務器(mcp-*)等類別,每種角色都有明確的通信模式和職責邊界。
在項目結構上,模板將代碼分為三個主要部分:後端服務(apps/目錄下的Worker應用)、前端應用(front-app)和共享包(packages/)。共享包包括DTO合同和枚舉定義,確保整個技術棧的數據一致性。特別地,模板強調數據庫模式(Drizzle schema)只能由單個Worker擁有,其他Worker通過服務綁定RPC或隊列訪問數據,避免了多應用直接綁定同一數據庫的風險。
模板還提供了豐富的開發工具鏈,包括Makefile命令用於安裝、檢查、測試和部署。端口分配遵循統一規則:Worker使用87xx端口,前端使用51xx/41xx端口。AI代理的鈎子和技能配置被集成到倉庫中,使自主代理能夠安全地與代碼庫交互並執行常見任務。此外,模板詳細説明了如何創建新的Worker、配置環境變量以及測試服務綁定,為開發者提供了一站式的入門指導。
總體而言,該單一代碼庫啓動模板不僅關注代碼組織和安全性,還特別為AI代理的自主操作進行了優化,是構建可擴展、可維護的雲端應用的堅實起點。