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代理的自主操作進行了最佳化,是構建可擴充套件、可維護的雲端應用的堅實起點。