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代理的自主操作进行了优化,是构建可扩展、可维护的云端应用的坚实起点。