[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-nextify-limited--libra":3,"tool-nextify-limited--libra":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":79,"owner_twitter":80,"owner_website":79,"owner_url":81,"languages":82,"stars":111,"forks":112,"last_commit_at":113,"license":114,"difficulty_score":115,"env_os":116,"env_gpu":117,"env_ram":116,"env_deps":118,"category_tags":131,"github_topics":132,"view_count":23,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":140,"updated_at":141,"faqs":142,"releases":171},2574,"nextify-limited\u002Flibra","libra","The open-source V0\u002FLovable alternative","Libra 是一款开源的 AI 应用生成平台，旨在成为 V0 和 Lovable 等商业工具的免费替代方案。它的核心理念是“语言即应用”，用户只需输入一句自然语言描述，Libra 就能自动完成网页应用的构建、迭代与部署全流程。\n\n这一工具主要解决了传统开发中环境配置复杂、全栈技术门槛高以及从原型到生产部署周期长的问题。通过高度集成的自动化流程，Libra 让创意能瞬间转化为可运行的实际产品，极大地缩短了开发路径。\n\nLibra 非常适合希望快速验证想法的创业者、想要提升效率的全栈开发者，以及不具备深厚编码背景但需要构建 Web 应用的设计师或普通用户。对于开发者而言，其开源特性允许深度定制和私有化部署，避免了供应商锁定风险。\n\n在技术亮点方面，Libra 提供了完整的全栈集成能力，内置了从计算运行时、数据存储到网络安全的基础架构支持。它不仅支持 AI 辅助编码，还集成了 Stripe 支付等生产级服务，并兼容多种部署方式，既提供便捷的云端托管服务，也支持用户在本地或自有服务器上灵活搭建，真正实现了从创意到生产环境的无缝衔接。","# Libra AI\n\n\u003Cdiv align=\"center\">\n\n\u003Cimg src=\"\u002Flogo.svg\" alt=\"Libra logo\" style=\"width: 250px; height: auto; max-width: 100%;\" \u002F>\n\n**Open Source Alternative to V0\u002FLovable**\n\n**Libra AI: Language as Application** - Launch, iterate, and deploy your next web application with a single sentence.\n\n[![SPONSORED BY CLERK](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-CLERK-6C47FF?style=for-the-badge)](https:\u002F\u002Fclerk.com?utm_source=libra.dev)\n[![SPONSORED BY E2B FOR STARTUPS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-E2B%20FOR%20STARTUPS-ff8800?style=for-the-badge)](https:\u002F\u002Fe2b.dev\u002Fstartups?utm_source=libra.dev)\n[![SPONSORED BY POSTHOG FOR STARTUPS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-POSTHOG%20FOR%20STARTUPS-1D4AFF?style=for-the-badge)](https:\u002F\u002Fposthog.com\u002Fstartups?utm_source=libra.dev)\n[![SPONSORED BY DAYTONA STARTUP GRID](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-DAYTONA%20STARTUP%20GRID-2ECC71?style=for-the-badge)](https:\u002F\u002Fdaytona.io\u002Fstartups?utm_source=libra.dev)\n[![SPONSORED BY CLOUDFLARE FOR STARTUPS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-CLOUDFLARE%20FOR%20STARTUPS-F38020?style=for-the-badge)](https:\u002F\u002Fwww.cloudflare.com\u002Fforstartups\u002F?utm_source=libra.dev)\n\n[![Open Source License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL-green.svg)](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002FLICENSE) [![Made by Nextify2024](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fmade_by-nextify2024-blue?color=FF782B&link=https:\u002F\u002Fx.com\u002Fnextify2024)](https:\u002F\u002Fx.com\u002Fnextify2024)\n\n[🌐 **Try Now**](https:\u002F\u002Flibra.dev) • [📖 **Documentation**](https:\u002F\u002Fdocs.libra.dev\u002F) • [💬 **Join Community**](https:\u002F\u002Fforum.libra.dev) • [⚡ **View Source**](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra)\n\n[🇨🇳 **中文版**](README_ZH.md)\n\n\u003C\u002Fdiv>\n\n- [Libra AI](#libra-ai)\n  - [🚀 What is Libra AI?](#-what-is-libra-ai)\n    - [✨ Core Features](#-core-features)\n      - [🤖 AI-Powered Coding](#-ai-powered-coding)\n      - [🛠️ Integrated Development Experience](#️-integrated-development-experience)\n      - [🔗 Full-Stack Integration](#-full-stack-integration)\n      - [🌐 Production Deployment](#-production-deployment)\n    - [Why Open Source?](#why-open-source)\n  - [🏗️ Technical Architecture](#️-technical-architecture)\n    - [Compute \\& Runtime](#compute--runtime)\n    - [Data Storage](#data-storage)\n    - [Network \\& Security](#network--security)\n    - [Development Tools \\& Services](#development-tools--services)\n    - [Application Services Overview](#application-services-overview)\n    - [🛠️ Core Technology Stack](#️-core-technology-stack)\n      - [Frontend Technology Architecture](#frontend-technology-architecture)\n      - [Backend \\& API Architecture](#backend--api-architecture)\n      - [AI \\& Machine Learning](#ai--machine-learning)\n      - [Data Storage Architecture](#data-storage-architecture)\n      - [Deployment \\& Infrastructure](#deployment--infrastructure)\n      - [Development Toolchain](#development-toolchain)\n  - [⚡ Quick Start](#-quick-start)\n    - [🎯 Choose Your Usage Method](#-choose-your-usage-method)\n      - [🌐 Cloud Hosted Service (Recommended)](#-cloud-hosted-service-recommended)\n      - [💻 Local Development Deployment (Developers)](#-local-development-deployment-developers)\n    - [📦 Environment Requirements](#-environment-requirements)\n    - [🚀 Local Environment Setup](#-local-environment-setup)\n      - [Step 1: Get Source Code](#step-1-get-source-code)\n      - [Step 2: Configure Environment Variables](#step-2-configure-environment-variables)\n      - [Step 3: Initialize Database](#step-3-initialize-database)\n      - [Step 4: Start Development Services](#step-4-start-development-services)\n      - [Step 5: Configure Stripe Payment (Required)](#step-5-configure-stripe-payment-required)\n    - [🌐 Local Service Addresses](#-local-service-addresses)\n  - [🚀 Deployment Options](#-deployment-options)\n    - [🌐 Cloud Hosted Service (Recommended)](#-cloud-hosted-service-recommended-1)\n    - [🏠 Self-Hosted Deployment](#-self-hosted-deployment)\n  - [🎯 Hosted Platform vs Open Source](#-hosted-platform-vs-open-source)\n    - [📊 Feature Comparison](#-feature-comparison)\n    - [🤔 How to Choose the Right Version?](#-how-to-choose-the-right-version)\n      - [Choose Cloud Hosting if you](#choose-cloud-hosting-if-you)\n      - [Choose Open Source if you](#choose-open-source-if-you)\n  - [❓ Frequently Asked Questions](#-frequently-asked-questions)\n    - [🆚 Product Versions](#-product-versions)\n    - [🛠️ Technical Issues](#️-technical-issues)\n    - [💼 Commercial Use](#-commercial-use)\n    - [🔧 Development \\& Deployment](#-development--deployment)\n    - [🤝 Community Contribution](#-community-contribution)\n      - [🌟 Usage \\& Promotion](#-usage--promotion)\n      - [🔧 Code Contribution](#-code-contribution)\n      - [📝 Other Contribution Methods](#-other-contribution-methods)\n      - [🎯 Contribution Guidelines](#-contribution-guidelines)\n  - [📄 Open Source License](#-open-source-license)\n    - [📜 AGPL-3.0 Open Source License](#-agpl-30-open-source-license)\n      - [✅ Your Rights](#-your-rights)\n      - [📋 Your Obligations](#-your-obligations)\n      - [💼 Commercial License](#-commercial-license)\n    - [💬 Participate in Roadmap Discussion](#-participate-in-roadmap-discussion)\n    - [🙏 Acknowledgments](#-acknowledgments)\n\n---\n\n## 🚀 What is Libra AI?\n\n**Libra AI** is a production-ready AI-native development platform that enables full lifecycle management of web applications through natural language interaction. Built with modern technology architecture, it covers the complete engineering process from rapid prototyping to enterprise-grade production deployment.\n\nJust as V0 is deeply integrated with the Vercel ecosystem, Libra is specifically designed for the Cloudflare Workers architecture, providing a native AI development experience.\n\n### ✨ Core Features\n\n#### 🤖 AI-Powered Coding\n\n- Multi-model integration: Claude, OpenAI, Gemini, DeepSeek, and more\n- Natural language-driven production-grade code generation\n- Intelligent context awareness and best practice adherence\n- Multi-sandbox provider support (E2B, Daytona)\n\n#### 🛠️ Integrated Development Experience\n\n- Cloud IDE: syntax highlighting, smart indentation, custom plugins\n- Hot Module Replacement (HMR) real-time preview\n- Intelligent dependency analysis and automatic installation\n\n#### 🔗 Full-Stack Integration\n\n- Seamless GitHub integration with one-way sync\n- Cloudflare edge computing deployment\n- Enterprise-grade identity authentication (OAuth 2.0)\n- Stripe commercial subscription management\n\n#### 🌐 Production Deployment\n\n- Cloudflare Workers edge computing network\n- Serverless architecture with elastic scaling\n- Automated TLS\u002FSSL certificate management\n- Git version control with one-click rollback\n\n### Why Open Source?\n\n- 📂 **Technical Autonomy**: Avoid vendor lock-in risks\n- 🔧 **Architectural Flexibility**: Support for deep customization and extension\n- 💝 **Community Ecosystem**: Open source community collaboration\n\n## 🏗️ Technical Architecture\n\nLibra is built entirely on Cloudflare. You need to be familiar with the following products:\n\n### Compute & Runtime\n\n| Product Name | Description | Application in Libra |\n|-------------|-------------|---------------------|\n| [Workers](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002F?utm_source=libra.dev) | Serverless computing platform | Core application runtime environment, hosting all service logic |\n| [Durable Objects](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fdurable-objects\u002F?utm_source=libra.dev) | Strong consistency storage | Real-time state management and session persistence |\n| [Browser Rendering](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fbrowser-rendering\u002F?utm_source=libra.dev) | Browser rendering service | Web screenshot generation and preview functionality |\n| [Workers for Platforms](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fcloudflare-for-platforms\u002F?utm_source=libra.dev) | Multi-tenant platform | User project isolation deployment and routing management |\n\n### Data Storage\n\n| Product Name | Description | Application in Libra |\n|-------------|-------------|---------------------|\n| [KV](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fkv\u002F?utm_source=libra.dev) | Global key-value storage | Configuration caching and temporary data storage |\n| [D1](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fd1\u002F?utm_source=libra.dev) | Serverless SQLite database | Authentication data and lightweight business data |\n| [Hyperdrive](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fhyperdrive\u002F?utm_source=libra.dev) | Database connection acceleration | PostgreSQL connection pooling and query optimization |\n| [R2](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fr2\u002F?utm_source=libra.dev) | Object storage service | File uploads, static assets, and build artifact storage |\n\n### Network & Security\n\n| Product Name | Description | Application in Libra |\n|-------------|-------------|---------------------|\n| [Turnstile](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fturnstile\u002F?utm_source=libra.dev) | Smart CAPTCHA | Security verification for user registration and sensitive operations |\n| [Cloudflare for SaaS](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fcloudflare-for-platforms\u002Fcloudflare-for-saas\u002F?utm_source=libra.dev) | Custom domain management | Custom domain binding and SSL certificates for user projects |\n\n### Development Tools & Services\n\n| Product Name | Description | Application in Libra |\n|-------------|-------------|---------------------|\n| [Workflows](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkflows\u002F?utm_source=libra.dev) | Workflow orchestration | Step-by-step management of complex deployment processes |\n| [Queues](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fqueues\u002F?utm_source=libra.dev) | Message queue service | Asynchronous task processing and batch deployment management |\n| [AI Gateway](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fai-gateway\u002F?utm_source=libra.dev) | AI model gateway | Monitor and control your AI applications |\n| [Images](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fimages\u002F?utm_source=libra.dev) | Image processing optimization | Dynamic image transformation and CDN distribution |\n\nLibra adopts **Turborepo** Monorepo architecture design:\n\n```text\nlibra\u002F\n├── apps\u002F                    # Core application services\n│   ├── auth-studio\u002F         # Authentication management console (D1 + drizzle-kit)\n│   ├── builder\u002F             # Vite build service - code compilation and deployment\n│   ├── cdn\u002F                 # Hono CDN service - static asset management\n│   ├── deploy\u002F              # Deployment service V2 - Cloudflare Queues\n│   ├── deploy-workflow\u002F     # Deployment service V1 - Cloudflare Workflows (deprecated)\n│   ├── dispatcher\u002F          # Request routing dispatcher (Workers for Platforms)\n│   ├── docs\u002F                # Technical documentation site (Next.js + FumaDocs)\n│   ├── email\u002F               # Email service previewer (React Email)\n│   ├── opennext-cache\u002F      # OpenNext cache service (Cloudflare)\n│   ├── screenshot\u002F          # Screenshot service - Cloudflare Queues\n│   ├── vite-shadcn-template\u002F# Project template engine (Vite + shadcn\u002Fui)\n│   └── web\u002F                 # Next.js 15 main application (React 19)\n├── packages\u002F                # Shared package modules\n│   ├── api\u002F                 # API layer (tRPC + type safety)\n│   ├── auth\u002F                # Authentication service (better-auth)\n│   ├── better-auth-cloudflare\u002F # Cloudflare authentication adapter\n│   ├── better-auth-stripe\u002F  # Stripe payment integration\n│   ├── common\u002F              # Common utility library and type definitions\n│   ├── db\u002F                  # Main database schema and operations (PostgreSQL)\n│   ├── email\u002F               # Email service components\n│   ├── middleware\u002F          # Middleware services and tools\n│   ├── sandbox\u002F             # Unified sandbox abstraction layer (E2B + Daytona)\n│   ├── shikicode\u002F           # Code editor (Shiki syntax highlighting)\n│   ├── templates\u002F           # Project scaffolding templates\n│   └── ui\u002F                  # Design system (shadcn\u002Fui + Tailwind CSS v4)\n├── tooling\u002F                 # Development tools and configuration\n│   └── typescript-config\u002F   # Shared TypeScript configuration\n└── scripts\u002F                 # GitHub environment variable management\n```\n\n### Application Services Overview\n\n**🔒 Authentication Management Center (`apps\u002Fauth-studio`)**\n\n- User, organization, permission, and subscription lifecycle management\n- Main database uses PostgreSQL (via Neon + Hyperdrive), authentication data uses D1 (SQLite)\n- OAuth 2.0 multi-provider authentication system\n- Stripe commercial payment gateway integration\n\n**🔨 Build Compilation Service (`apps\u002Fbuilder`)**\n\n- Vite high-performance build engine with millisecond-level hot startup\n- Automatic code compilation and seamless production deployment\n- Multi-tech-stack project template rapid instantiation\n\n**📺 Content Distribution Service (`apps\u002Fcdn`)**\n\n- Hono framework-driven file management system\n- Intelligent image processing and compression optimization\n- Global CDN edge caching acceleration\n- Cloudflare Workers edge deployment\n\n**🚀 Deployment Service V2 (`apps\u002Fdeploy`)**\n\n- Modern deployment architecture based on Cloudflare Queues\n- Batch processing and concurrency control\n- D1 database state management\n- Dead letter queue handling for failed deployments\n- Comprehensive error handling and retry logic\n\n**⚡ Deployment Service V1 (`apps\u002Fdeploy-workflow`, deprecated)**\n\n- Deployment orchestration based on Cloudflare Workflows\n- Step-by-step deployment process and state management\n- Built-in retry mechanism and error recovery\n- Support for complex deployment scenarios and dependency management\n\n**🔀 Request Routing Service (`apps\u002Fdispatcher`)**\n\n- Workers for Platforms core routing component\n- Route user domain requests to corresponding Worker instances\n- Dynamic Worker scheduling and lifecycle management\n- Custom domain binding and SSL certificate handling\n- Unified authentication and access control layer\n- Cloudflare SaaS for Platforms integration\n\n**📖 Technical Documentation Site (`apps\u002Fdocs`)**\n\n- FumaDocs modern documentation solution\n- Cloudflare Workers global distribution\n\n**📧 Email Notification Service (`apps\u002Femail`)**\n\n- React Email component-based email development\n- Multi-scenario email template engine\n\n**🔄 OpenNext Cache Service (`apps\u002Fopennext-cache`)**\n\n- Next.js Cloudflare deployment cache optimization\n- OpenNext framework and Cloudflare Workers integration\n- Seamless integration with main web application deployment\n\n**📸 Screenshot Service (`apps\u002Fscreenshot`)**\n\n- Cloudflare Queues-based screenshot generation\n- Asynchronous queue processing for web screenshot requests\n- Automated website preview image generation\n- R2 storage for screenshot files\n- Batch processing and error retry\n\n**🔨 Project Scaffolding Service (`apps\u002Fvite-shadcn-template`)**\n\n- Vite high-performance build toolchain\n- Fast compilation and production deployment\n- Pre-configured shadcn\u002Fui + Tailwind CSS v4\n- Visual template selection and preview\n\n**🌐 Core Web Application (`apps\u002Fweb`)**\n\n- Next.js 15 App Router + React 19 technology stack\n- Platform main interface and user interaction layer\n- AI-driven intelligent conversation and project management\n- Real-time code editing, preview, deployment, and version control\n- Cloudflare Workers serverless deployment\n\n### 🛠️ Core Technology Stack\n\n#### Frontend Technology Architecture\n\n| Technology Framework | Application Scenario | Version |\n|---------------------|---------------------|---------|\n| [Next.js](https:\u002F\u002Fnextjs.org?utm_source=libra.dev) | React full-stack development framework (App Router) | 15.3.5 |\n| [React](https:\u002F\u002Freact.dev?utm_source=libra.dev) | User interface library (Server Components) | 19.1.1 |\n| [TypeScript](https:\u002F\u002Ftypescriptlang.org?utm_source=libra.dev) | Statically typed JavaScript superset | 5.8.3+ |\n| [Tailwind CSS](https:\u002F\u002Ftailwindcss.com?utm_source=libra.dev) | Utility-first CSS framework | 4.1.11 |\n| [shadcn\u002Fui](https:\u002F\u002Fui.shadcn.com?utm_source=libra.dev) | Component library and design system | Based on Radix UI |\n| [Radix UI](https:\u002F\u002Fradix-ui.com?utm_source=libra.dev) | Unstyled accessible UI primitive library | 1.2.x-1.3.x |\n| [Motion](https:\u002F\u002Fmotion.dev?utm_source=libra.dev) | Modern animation engine | 12.23.11 |\n| [Lucide React](https:\u002F\u002Flucide.dev?utm_source=libra.dev) | Vector icon library | 0.486.0 |\n\n#### Backend & API Architecture\n\n| Technology Framework | Application Scenario | Version |\n|---------------------|---------------------|---------|\n| [tRPC](https:\u002F\u002Ftrpc.io?utm_source=libra.dev) | End-to-end type-safe API development | 11.4.3+ |\n| [Hono](https:\u002F\u002Fhono.dev?utm_source=libra.dev) | Edge computing web framework | 4.8.10+ |\n| [Zod](https:\u002F\u002Fzod.dev?utm_source=libra.dev) | TypeScript data validation library | 4.0.14 |\n| [Drizzle ORM](https:\u002F\u002Form.drizzle.team?utm_source=libra.dev) | Type-safe TypeScript ORM | 0.44.4 |\n| [better-auth](https:\u002F\u002Fbetter-auth.com?utm_source=libra.dev) | Modern identity authentication solution | 1.3.4 |\n\n#### AI & Machine Learning\n\n| AI Platform | Features | API Version |\n|------------|----------|-------------|\n| [AI SDK](https:\u002F\u002Fsdk.vercel.ai?utm_source=libra.dev) | Multi-provider AI model integration | 4.3.19 |\n| [E2B](https:\u002F\u002Fe2b.dev?utm_source=libra.dev) | Secure code execution sandbox | 1.2.0-beta.5 |\n| [Daytona](https:\u002F\u002Fdaytona.io?utm_source=libra.dev) | Development environment sandbox provider | Latest |\n| **Integrated AI Models** | | |\n| Anthropic Claude | Advanced reasoning and code generation | API v1 |\n| Azure OpenAI | Enterprise-grade AI model service | API v1 |\n| Google Gemini | Multimodal AI capabilities | API v1 |\n| DeepSeek | Cost-effective code generation | API v1 |\n\n#### Data Storage Architecture\n\n| Database Technology | Application Scenario | Version |\n|--------------------|---------------------|---------|\n| [Neon](https:\u002F\u002Fneon.com?utm_source=libra.dev) | Main database (PostgreSQL) | 17+ |\n| [Cloudflare Hyperdrive](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fhyperdrive?utm_source=libra.dev) | Database connection pooling and acceleration | Latest |\n| [Cloudflare D1](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fd1?utm_source=libra.dev) | Edge database (SQLite) | Latest |\n| [Drizzle Kit](https:\u002F\u002Form.drizzle.team\u002Fkit-docs\u002Foverview?utm_source=libra.dev) | Database migration tool | 0.31.4+ |\n\n#### Deployment & Infrastructure\n\n| Platform Technology | Application Scenario | Version |\n|---------------------|---------------------|---------|\n| [Cloudflare Workers](https:\u002F\u002Fworkers.cloudflare.com?utm_source=libra.dev) | Serverless edge computing platform | Latest |\n| [OpenNext](https:\u002F\u002Fopennext.js.org\u002Fcloudflare?utm_source=libra.dev) | Next.js Cloudflare deployment adapter | 1.6.2 |\n| [Turborepo](https:\u002F\u002Fturbo.build?utm_source=libra.dev) | High-performance Monorepo build system | 2.5.5 |\n| [Bun](https:\u002F\u002Fbun.sh?utm_source=libra.dev) | JavaScript runtime and package manager | 1.2.19 |\n\n#### Development Toolchain\n\n| Tool | Purpose | Version |\n|------|---------|---------|\n| [Biome](https:\u002F\u002Fbiomejs.dev?utm_source=libra.dev) | Code formatting and quality checking | ^2.2.2 |\n| [Vitest](https:\u002F\u002Fvitest.dev?utm_source=libra.dev) | Unit testing framework | 3.2.4 |\n| [Paraglide.js](https:\u002F\u002Finlang.com\u002Fm\u002Fgerre34r\u002Flibrary-inlang-paraglideJs?utm_source=libra.dev) | Internationalization i18n solution | 2.2.0 |\n\n## ⚡ Quick Start\n\n### 🎯 Choose Your Usage Method\n\n#### 🌐 Cloud Hosted Service (Recommended)\n\n- Visit [libra.dev](https:\u002F\u002Flibra.dev) to get started\n- Quick registration with GitHub OAuth or email\n- Build production-grade applications in minutes\n\n#### 💻 Local Development Deployment (Developers)\n\n- Complete source code access and control\n- Deep customization development and extension\n- Private\u002Fenterprise-grade deployment\n\n### 📦 Environment Requirements\n\n```bash\n# System dependency requirements\ngit --version   # >= 2.30.0\nnode --version  # >= 20.0.0 (recommend 24)\nbun --version   # >= 1.0.0\n```\n\n### 🚀 Local Environment Setup\n\n#### Step 1: Get Source Code\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra.git\ncd libra\nbun install\n# (Optional) Generate i18n files for apps\u002Fweb\ncd apps\u002Fweb && bun run prebuild && cd ..\u002F..\n```\n\n#### Step 2: Configure Environment Variables\n\n```bash\ncp .env.example .env\n```\n\nEdit the `.env` file to configure necessary environment variables.\n\n#### Step 3: Initialize Database\n\nMain database (PostgreSQL) initialization:\n\n```bash\n# Generate and run migrations from project root\ncd packages\u002Fdb\nbun db:generate\nbun db:migrate\n```\n\nAuthentication database (D1\u002FSQLite) initialization:\n\n```bash\n# Test D1 database connection (local environment)\ncd apps\u002Fweb && bun wrangler d1 execute libra --local --command='SELECT 1'\n\n# Generate and run authentication database migrations\ncd packages\u002Fauth\nbun db:generate\nbun db:migrate\n```\n\n#### Step 4: Start Development Services\n\n```bash\n# Start all services\nbun dev\n\n# Or start main application separately\ncd apps\u002Fweb && bun dev\n```\n\n#### Step 5: Configure Stripe Payment (Required)\n\nConfigure corresponding products:\n\n```bash\nstripe listen --forward-to localhost:3000\u002Fapi\u002Fauth\u002Fstripe\u002Fwebhook\n```\n\n### 🌐 Local Service Addresses\n\nAfter setup, you can access various services through the following addresses:\n\n- **Core Application (web)**: \u003Chttp:\u002F\u002Flocalhost:3000>\n- **Email Preview (email)**: \u003Chttp:\u002F\u002Flocalhost:3001>\n- **Authentication Management (auth-studio)**: \u003Chttp:\u002F\u002Flocalhost:3002>\n- **Technical Documentation (docs)**: \u003Chttp:\u002F\u002Flocalhost:3003>\n- **CDN Service (cdn)**: \u003Chttp:\u002F\u002Flocalhost:3004>\n- **Build Service (builder)**: \u003Chttp:\u002F\u002Flocalhost:5173> (Vite default port)\n- **Template Service (vite-shadcn-template)**: \u003Chttp:\u002F\u002Flocalhost:5173> (Vite default port, may conflict with builder)\n- **Routing Service (dispatcher)**: \u003Chttp:\u002F\u002Flocalhost:3007>\n- **Deployment Service V2 (deploy)**: \u003Chttp:\u002F\u002Flocalhost:3008>\n- **Screenshot Service (screenshot)**: \u003Chttp:\u002F\u002Flocalhost:3009>\n- **Deployment Service V1 (deploy-workflow, deprecated)**: \u003Chttp:\u002F\u002Flocalhost:3008> (shares port with Deployment Service V2)\n\n## 🚀 Deployment Options\n\n### 🌐 Cloud Hosted Service (Recommended)\n\nReady-to-use cloud development experience:\n\n1. Visit [libra.dev](https:\u002F\u002Flibra.dev) official platform\n2. Quick registration with GitHub OAuth or email\n3. AI-driven rapid application building\n4. One-click deployment to custom domains\n\n**Cloud Service Advantages:**\n- Zero-configuration out-of-the-box\n- Elastic scaling and automatic updates\n- Built-in AI model integration\n- Enterprise-grade technical support\n\n### 🏠 Self-Hosted Deployment\n\n**1. Deploy Libra Platform Itself**\n\nAll Libra platform services are deployed on Cloudflare Workers:\n\n```bash\n\n# Deploy various services to Cloudflare Workers\n# Refer to the following workflow files for complete deployment process:\n# - .github\u002Fworkflows\u002Fweb.yml - Main application deployment\n# - .github\u002Fworkflows\u002Fcdn.yml - CDN service deployment\n# - .github\u002Fworkflows\u002Fdeploy.yml - Deployment service deployment\n# - .github\u002Fworkflows\u002Fdispatcher.yml - Routing service deployment\n# - .github\u002Fworkflows\u002Fscreenshot.yml - Screenshot service deployment\n# - .github\u002Fworkflows\u002Fdocs.yml - Documentation site deployment\n```\n\n**2. Deploy User Projects as PaaS Platform**\n\nLibra uses **Workers for Platforms** technology to provide project deployment capabilities for users, offering two deployment service architectures:\n\n1. **Workers for Platforms Architecture**:\n    - Each user project is deployed as an independent Worker\n    - Intelligent routing through `dispatcher` service\n    - Support for custom domain binding\n    - Completely isolated runtime environment (process-level isolation through Workers for Platforms)\n\n2. **Deployment Service Architecture Options**:\n\n   **V2 Queue Architecture** (`apps\u002Fdeploy`):\n    - **Cloudflare Queues**: Asynchronous queue processing for deployment tasks\n    - **Batch Processing**: Support for concurrency control and batch deployment\n    - **Dead Letter Queue**: Retry mechanism for handling failed deployments\n    - **Use Cases**: High concurrency, large-scale deployment needs\n\n   **V1 Workflow Architecture** (`apps\u002Fdeploy-workflow`, deprecated):\n    - **Cloudflare Workflows**: Step-by-step deployment orchestration\n    - **State Persistence**: Built-in state management and recovery mechanism\n    - **Complex Processes**: Support for complex deployment dependencies and conditional logic\n    - **Use Cases**: Complex deployment processes, scenarios requiring precise control\n\n3. **General Deployment Process**:\n    - Verify user permissions and project quotas\n    - Create sandbox environment for secure building (supports E2B or Daytona)\n    - Sync project files\n    - Execute build commands (`bun install` & `bun build`)\n    - Deploy to user's Worker instance using Wrangler API\n    - Update routing configuration, clean up temporary environment\n\n4. **Technical Features**:\n    - **Sandbox Environment**: Secure isolated build environment (supports E2B or Daytona)\n    - **Global Distribution**: Leverage Cloudflare edge computing network\n    - **Flexible Architecture**: Choose appropriate deployment service based on needs\n\n## 🎯 Hosted Platform vs Open Source\n\n### 📊 Feature Comparison\n\n| Feature | Hosted Platform | Open Source | Notes |\n|---------|----------------|-------------|-------|\n| **🤖 AI Code Generation** | ✅ Out-of-the-box | ❌ Requires API key configuration | Multi-AI provider integration |\n| **🔧 Development Environment** | ✅ Zero configuration | ❌ Requires sandbox environment setup | Cloud IDE and real-time preview |\n| **📂 GitHub Integration** | ✅ One-click connection | ❌ Requires OAuth authorization setup | Repository auto-creation and sync |\n| **🌐 Deployment Service** | ✅ Built-in support | ❌ Requires deployment environment setup | Cloudflare native integration |\n| **🎨 Editor** | ✅ Full features | ❌ Basic visual editing | Visual editing and preview |\n| **🔒 Data Control** | 🔒 Cloud hosted | ✅ Complete private control | Self-hosted data complete control |\n| **🛠️ Custom Development** | ⚠️ Platform limitations | ✅ Unlimited customization | Source-level modification and extension |\n| **📞 Technical Support** | ✅ Professional service | 🤝 Community support | Official service vs open source community |\n| **💰 Cost Structure** | 💰 Pay-as-you-go | 🆓 Infrastructure costs | SaaS subscription vs self-maintenance |\n\n### 🤔 How to Choose the Right Version?\n\n#### Choose Cloud Hosting if you\n\n- **🚀 Quick Launch**: No complex configuration needed, start application development immediately\n- **💼 Business Priority**: Focus on product development rather than infrastructure operations\n- **👥 Team Collaboration**: Need enterprise-grade team management features\n- **📞 Professional Service**: Expect official technical support and SLA guarantees\n- **🔄 Automatic Operations**: Want platform automated updates and maintenance\n\n#### Choose Open Source if you\n\n- **🏠 Data Autonomy**: Complete control over data storage and processing\n- **🔧 Deep Customization**: Need to modify core functionality or integrate proprietary business logic\n- **💰 Cost Control**: Have technical team, need to optimize long-term operational costs\n- **🌍 Special Deployment**: Specific region\u002Fprivate network\u002Foffline environment deployment\n- **📚 Technical Learning**: Deep understanding of complete technical architecture design\n\n## ❓ Frequently Asked Questions\n\n### 🆚 Product Versions\n\n**Q: What are the core differences between the hosted platform and open source version?**\n\nA: **Cloud hosting** is an official SaaS service, ready to use upon registration, including complete AI capabilities and enterprise-grade features. **Open source version** provides core source code, supports self-deployment and deep customization, but requires self-configuration of AI APIs and operational environment.\n\n**Q: How complete are the features in the open source version?**\n\nA: The open source version includes the platform's core functional architecture. We follow the principle of \"99% features open source, 1% commercial services\" to ensure developers can access complete technical capabilities.\n\n### 🛠️ Technical Issues\n\n**Q: What technical background is required to use Libra?**\n\nA: Depends on usage method:\n\n- **Hosted platform users**: No technical background required, just need to use a browser\n- **Local developers**: Need basic web development knowledge and Node.js experience\n- **Self-hosted deployment**: Need server and DevOps practical experience\n\n**Q: How is the quality of AI-generated code?**\n\nA: We always pursue production-grade code quality:\n\n- Complete TypeScript type safety guarantee\n- Follow modern React development patterns and industry best practices\n- Responsive design implementation based on Tailwind CSS\n- Accessible components integrated with Radix UI\n- Clear and maintainable code structure and comments\n\n**Q: Can I customize AI behavior and prompts?**\n\nA: Full customization is supported in the open source version:\n\n- Custom AI prompt engineering\n- Flexible model selection logic configuration\n- Modify code generation templates\n- Integrate third-party AI services\n\n### 💼 Commercial Use\n\n**Q: Can Libra be used for commercial projects?**\n\nA: Absolutely. We provide multiple commercial solutions:\n\n- **Hosted platform**: Business-friendly pay-as-you-go model\n- **Open source version**: Follows AGPL-3.0 open source license, requires derivative projects to also be open source\n- **Commercial licensing**: Provides commercial open source licenses for enterprises requiring closed-source deployment\n\n**Q: How about data security and privacy protection?**\n\nA: We provide different levels of data protection solutions:\n\n- **Hosted platform**: Data processed in our secure infrastructure, compliant with international security standards\n- **Self-hosted deployment**: You have complete control over data storage, processing, and access permissions\n- **Enterprise customization**: Can provide customized solutions based on special security requirements and compliance needs\n\n**Q: Do you provide enterprise-grade technical support?**\n\nA: Yes. Our enterprise services include:\n\n- Private cloud environment deployment\n- Custom feature development services\n- Dedicated technical support team\n- Service Level Agreement (SLA) guarantees\n- Security auditing and compliance support\n\nFor enterprise services, please contact: [contact@libra.dev](mailto:contact@libra.dev)\n\n### 🔧 Development & Deployment\n\n**Q: Which deployment platforms are supported?**\n\nA: Currently only supports deployment on Cloudflare\n\n**Q: How to participate in open source project contributions?**\n\nA: We warmly welcome community contributions. For specific methods, please refer to the [Community Contribution Guidelines](#-community-contribution) below.\n\n### 🤝 Community Contribution\n\nWe warmly welcome contributions from developers worldwide! Here are the ways you can participate:\n\n#### 🌟 Usage & Promotion\n\n- Experience [Libra platform](https:\u002F\u002Flibra.dev) and share your usage experience\n- Create amazing application projects and showcase them in the community\n- Write technical blog articles or create tutorial videos\n- Share and recommend Libra on social media platforms\n\n#### 🔧 Code Contribution\n\n```bash\n# 1. Fork our repository on GitHub\n# 2. Clone your fork to local\ngit clone https:\u002F\u002Fgithub.com\u002Fyour-username\u002Flibra.git\ncd libra\n\n# 3. Create feature development branch\ngit checkout -b feature\u002Fyour-amazing-feature\n\n# 4. Develop and test thoroughly\nbun install\nbun dev\n\n# 5. Commit code with clear commit messages\ngit commit -m \"feat: add incredible new feature\"\n\n# 6. Push branch and create Pull Request\ngit push origin feature\u002Fyour-amazing-feature\n```\n\n#### 📝 Other Contribution Methods\n\n- **Documentation Improvement**: Improve usage guides, add example code, fix documentation errors\n- **Issue Reporting**: Help us discover and locate system issues\n- **Feature Suggestions**: Propose improvement ideas and new feature requirements\n- **Multi-language Support**: Help translate Libra into more languages\n    - Project uses Paraglide.js for internationalization\n    - Translation file location: `apps\u002Fweb\u002Fmessages\u002F[locale].json`\n    - Add new language: Add language code in `apps\u002Fweb\u002Fproject.inlang\u002Fsettings.json`\n- **Community Support**: Help other users in [forum](https:\u002F\u002Fforum.libra.dev) and GitHub discussions\n\n#### 🎯 Contribution Guidelines\n\n- Please follow our [Code of Conduct](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002Fcode_of_conduct_zh.md)\n- Read and follow [Contribution Guidelines](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002FTECHNICAL_GUIDELINES_ZH.md)\n- Use standardized commit message format (Conventional Commits)\n- Provide corresponding test cases for new features\n- Update relevant documentation in a timely manner\n\n## 📄 Open Source License\n\n### 📜 AGPL-3.0 Open Source License\n\nLibra is released under the [GNU Affero General Public License v3.0](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002FLICENSE) open source license.\n\n#### ✅ Your Rights\n\n- **🆓 Free Use**: Free to use for personal, educational, and commercial projects\n- **🔧 Modification and Customization**: Free to modify and extend code functionality\n- **📤 Distribution and Sharing**: Can share with others under the same license\n- **🏢 Commercial Deployment**: Allowed for commercial purpose deployment\n\n#### 📋 Your Obligations\n\n- **📄 Retain Copyright Information**: Must retain original copyright notices\n- **🔓 Open Source Derivative Works**: Must provide source code for any modifications\n- **📧 Network Service Open Source**: Must open source when providing services over network\n- **🔗 Use Same License**: Derivative works must use AGPL-3.0 license\n\n#### 💼 Commercial License\n\nIf you need more flexibility, we provide commercial licenses suitable for:\n\n- Closed-source proprietary modifications\n- Product distribution without open sourcing\n- Customized licensing terms\n\nCommercial licensing consultation: [contact@libra.dev](mailto:contact@libra.dev)\n\n### 💬 Participate in Roadmap Discussion\n\nWe welcome community participation in roadmap planning:\n\n- 📝 [Feature Requests](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fissues\u002Fnew?template=feature_request.md)\n- 💬 [Roadmap Discussion](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fdiscussions)\n- 📧 [Enterprise Requirements](mailto:contact@libra.dev)\n\n### 🙏 Acknowledgments\n\nThanks to the following excellent sponsors for their valuable support to the Libra project, enabling us to focus on building better AI development experiences for developers:\n\n**[Clerk](https:\u002F\u002Fclerk.com?utm_source=libra.dev)** - The most comprehensive user management platform\n\n**[E2B](https:\u002F\u002Fe2b.dev\u002Fstartups?utm_source=libra.dev)** - E2B is an open-source runtime environment for executing AI-generated code in secure cloud sandboxes, suitable for intelligent agents and AI application scenarios.\n\n**[PostHog](https:\u002F\u002Fposthog.com\u002Fstartups?utm_source=libra.dev)** - A single platform for analytics, testing, observing, and deploying new features\n\n**[Daytona](https:\u002F\u002Fdaytona.io\u002Fstartups?utm_source=libra.dev)** - Daytona is a secure and resilient infrastructure for running AI-generated code\n\n**[Cloudflare](https:\u002F\u002Fwww.cloudflare.com\u002Fforstartups\u002F?utm_source=libra.dev)** - Global leading edge computing and network infrastructure provider\n\n---","# 天秤座 AI\n\n\u003Cdiv align=\"center\">\n\n\u003Cimg src=\"\u002Flogo.svg\" alt=\"Libra logo\" style=\"width: 250px; height: auto; max-width: 100%;\" \u002F>\n\n**V0\u002FLovable 的开源替代方案**\n\n**Libra AI：语言即应用**——只需一句话，即可启动、迭代并部署您的下一个 Web 应用程序。\n\n[![由 Clerk 赞助](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-CLERK-6C47FF?style=for-the-badge)](https:\u002F\u002Fclerk.com?utm_source=libra.dev)\n[![由 E2B FOR STARTUPS 赞助](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-E2B%20FOR%20STARTUPS-ff8800?style=for-the-badge)](https:\u002F\u002Fe2b.dev\u002Fstartups?utm_source=libra.dev)\n[![由 PostHog FOR STARTUPS 赞助](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-POSTHOG%20FOR%20STARTUPS-1D4AFF?style=for-the-badge)](https:\u002F\u002Fposthog.com\u002Fstartups?utm_source=libra.dev)\n[![由 DAYTONA STARTUP GRID 赞助](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-DAYTONA%20STARTUP%20GRID-2ECC71?style=for-the-badge)](https:\u002F\u002Fdaytona.io\u002Fstartups?utm_source=libra.dev)\n[![由 Cloudflare FOR STARTUPS 赞助](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSPONSORED%20BY-CLOUDFLARE%20FOR%20STARTUPS-F38020?style=for-the-badge)](https:\u002F\u002Fwww.cloudflare.com\u002Fforstartups\u002F?utm_source=libra.dev)\n\n[![开源许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL-green.svg)](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002FLICENSE) [![由 Nextify2024 制作](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fmade_by-nextify2024-blue?color=FF782B&link=https:\u002F\u002Fx.com\u002Fnextify2024)](https:\u002F\u002Fx.com\u002Fnextify2024)\n\n[🌐 **立即试用**](https:\u002F\u002Flibra.dev) • [📖 **文档**](https:\u002F\u002Fdocs.libra.dev\u002F) • [💬 **加入社区**](https:\u002F\u002Fforum.libra.dev) • [⚡ **查看源码**](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra)\n\n[🇨🇳 **中文版**](README_ZH.md)\n\n\u003C\u002Fdiv>\n\n- [Libra AI](#libra-ai)\n  - [🚀 什么是 Libra AI？](#-what-is-libra-ai)\n    - [✨ 核心功能](#-core-features)\n      - [🤖 AI 驱动的编码](#-ai-powered-coding)\n      - [🛠️ 集成开发体验](#️-integrated-development-experience)\n      - [🔗 全栈集成](#-full-stack-integration)\n      - [🌐 生产环境部署](#-production-deployment)\n    - [为什么选择开源？](#why-open-source)\n  - [🏗️ 技术架构](#️-technical-architecture)\n    - [计算与运行时](#compute--runtime)\n    - [数据存储](#data-storage)\n    - [网络与安全](#network--security)\n    - [开发工具与服务](#development-tools--services)\n    - [应用服务概览](#application-services-overview)\n    - [🛠️ 核心技术栈](#️-core-technology-stack)\n      - [前端技术架构](#frontend-technology-architecture)\n      - [后端与 API 架构](#backend--api-architecture)\n      - [AI 与机器学习](#ai--machine-learning)\n      - [数据存储架构](#data-storage-architecture)\n      - [部署与基础设施](#deployment--infrastructure)\n      - [开发工具链](#development-toolchain)\n  - [⚡ 快速入门](#-quick-start)\n    - [🎯 选择使用方式](#-choose-your-usage-method)\n      - [🌐 云托管服务（推荐）](#-cloud-hosted-service-recommended)\n      - [💻 本地开发部署（开发者）](#-local-development-deployment-developers)\n    - [📦 环境要求](#-environment-requirements)\n    - [🚀 本地环境搭建](#-local-environment-setup)\n      - [第 1 步：获取源代码](#step-1-get-source-code)\n      - [第 2 步：配置环境变量](#step-2-configure-environment-variables)\n      - [第 3 步：初始化数据库](#step-3-initialize-database)\n      - [第 4 步：启动开发服务](#step-4-start-development-services)\n      - [第 5 步：配置 Stripe 支付（必填）](#step-5-configure-stripe-payment-required)\n    - [🌐 本地服务地址](#-local-service-addresses)\n  - [🚀 部署选项](#-deployment-options)\n    - [🌐 云托管服务（推荐）](#-cloud-hosted-service-recommended-1)\n    - [🏠 自行托管部署](#-self-hosted-deployment)\n  - [🎯 托管平台 vs 开源](#-hosted-platform-vs-open-source)\n    - [📊 功能对比](#-feature-comparison)\n    - [🤔 如何选择合适的版本？](#-how-to-choose-the-right-version)\n      - [如果您满足以下条件，请选择云托管](#choose-cloud-hosting-if-you)\n      - [如果您满足以下条件，请选择开源](#choose-open-source-if-you)\n  - [❓ 常见问题解答](#-frequently-asked-questions)\n    - [🆚 产品版本](#-product-versions)\n    - [🛠️ 技术问题](#️-technical-issues)\n    - [💼 商业用途](#-commercial-use)\n    - [🔧 开发与部署](#-development--deployment)\n    - [🤝 社区贡献](#-community-contribution)\n      - [🌟 使用与推广](#-usage--promotion)\n      - [🔧 代码贡献](#-code-contribution)\n      - [📝 其他贡献方式](#-other-contribution-methods)\n      - [🎯 贡献指南](#-contribution-guidelines)\n  - [📄 开源许可证](#-open-source-license)\n    - [📜 AGPL-3.0 开源许可证](#-agpl-30-open-source-license)\n      - [✅ 您的权利](#-your-rights)\n      - [📋 您的义务](#-your-obligations)\n      - [💼 商业许可](#-commercial-license)\n    - [💬 参与路线图讨论](#-participate-in-roadmap-discussion)\n    - [🙏 致谢](#-acknowledgments)\n\n---\n\n## 🚀 什么是 Libra AI？\n\n**Libra AI** 是一个生产就绪的原生 AI 开发平台，通过自然语言交互实现 Web 应用程序的全生命周期管理。它采用现代技术架构，覆盖从快速原型设计到企业级生产部署的完整工程流程。\n\n正如 V0 深度集成于 Vercel 生态系统一样，Libra 专为 Cloudflare Workers 架构而设计，提供原生的 AI 开发体验。\n\n### ✨ 核心功能\n\n#### 🤖 AI 驱动的编码\n\n- 多模型集成：Claude、OpenAI、Gemini、DeepSeek 等\n- 基于自然语言的生产级代码生成\n- 智能上下文感知与最佳实践遵循\n- 多沙盒提供商支持（E2B、Daytona）\n\n#### 🛠️ 集成开发体验\n\n- 云端 IDE：语法高亮、智能缩进、自定义插件\n- 热模块替换（HMR）实时预览\n- 智能依赖分析与自动安装\n\n#### 🔗 全栈集成\n\n- 无缝 GitHub 集成，支持单向同步\n- Cloudflare 边缘计算部署\n- 企业级身份认证（OAuth 2.0）\n- Stripe 商业订阅管理\n\n#### 🌐 生产环境部署\n\n- Cloudflare Workers 边缘计算网络\n- 无服务器架构，具备弹性扩展能力\n- 自动化 TLS\u002FSSL 证书管理\n- Git 版本控制，支持一键回滚\n\n### 为什么选择开源？\n\n- 📂 **技术自主性**：避免供应商锁定风险\n- 🔧 **架构灵活性**：支持深度定制与扩展\n- 💝 **社区生态**：开源社区协作\n\n## 🏗️ 技术架构\n\nLibra 完全构建在 Cloudflare 之上。你需要熟悉以下产品：\n\n### 计算与运行时\n\n| 产品名称 | 描述 | 在 Libra 中的应用 |\n|-------------|-------------|---------------------|\n| [Workers](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002F?utm_source=libra.dev) | 无服务器计算平台 | 核心应用运行环境，承载所有业务逻辑 |\n| [Durable Objects](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fdurable-objects\u002F?utm_source=libra.dev) | 强一致性存储 | 实时状态管理和会话持久化 |\n| [Browser Rendering](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fbrowser-rendering\u002F?utm_source=libra.dev) | 浏览器渲染服务 | Web 截图生成和预览功能 |\n| [Workers for Platforms](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fcloudflare-for-platforms\u002F?utm_source=libra.dev) | 多租户平台 | 用户项目隔离部署和路由管理 |\n\n### 数据存储\n\n| 产品名称 | 描述 | 在 Libra 中的应用 |\n|-------------|-------------|---------------------|\n| [KV](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fkv\u002F?utm_source=libra.dev) | 全球键值存储 | 配置缓存和临时数据存储 |\n| [D1](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fd1\u002F?utm_source=libra.dev) | 无服务器 SQLite 数据库 | 认证数据和轻量级业务数据 |\n| [Hyperdrive](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fhyperdrive\u002F?utm_source=libra.dev) | 数据库连接加速 | PostgreSQL 连接池和查询优化 |\n| [R2](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fr2\u002F?utm_source=libra.dev) | 对象存储服务 | 文件上传、静态资源和构建产物存储 |\n\n### 网络与安全\n\n| 产品名称 | 描述 | 在 Libra 中的应用 |\n|-------------|-------------|---------------------|\n| [Turnstile](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fturnstile\u002F?utm_source=libra.dev) | 智能 CAPTCHA | 用户注册和敏感操作的安全验证 |\n| [Cloudflare for SaaS](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fcloudflare-for-platforms\u002Fcloudflare-for-saas\u002F?utm_source=libra.dev) | 自定义域名管理 | 用户项目的自定义域名绑定和 SSL 证书 |\n\n### 开发工具与服务\n\n| 产品名称 | 描述 | 在 Libra 中的应用 |\n|-------------|-------------|---------------------|\n| [Workflows](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkflows\u002F?utm_source=libra.dev) | 工作流编排 | 复杂部署流程的步骤式管理 |\n| [Queues](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fqueues\u002F?utm_source=libra.dev) | 消息队列服务 | 异步任务处理和批量部署管理 |\n| [AI Gateway](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fai-gateway\u002F?utm_source=libra.dev) | AI 模型网关 | 监控和控制你的 AI 应用 |\n| [Images](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fimages\u002F?utm_source=libra.dev) | 图像处理优化 | 动态图像转换和 CDN 分发 |\n\nLibra 采用 **Turborepo** 单仓库架构设计：\n\n```text\nlibra\u002F\n├── apps\u002F                    # 核心应用服务\n│   ├── auth-studio\u002F         # 认证管理控制台 (D1 + drizzle-kit)\n│   ├── builder\u002F             # Vite 构建服务 - 代码编译和部署\n│   ├── cdn\u002F                 # Hono CDN 服务 - 静态资源管理\n│   ├── deploy\u002F              # 部署服务 V2 - Cloudflare Queues\n│   ├── deploy-workflow\u002F     # 部署服务 V1 - Cloudflare Workflows (已弃用)\n│   ├── dispatcher\u002F          # 请求路由分发器 (Workers for Platforms)\n│   ├── docs\u002F                # 技术文档站点 (Next.js + FumaDocs)\n│   ├── email\u002F               # 邮件服务预览器 (React Email)\n│   ├── opennext-cache\u002F      # OpenNext 缓存服务 (Cloudflare)\n│   ├── screenshot\u002F          # 截图服务 - Cloudflare Queues\n│   ├── vite-shadcn-template\u002F# 项目模板引擎 (Vite + shadcn\u002Fui)\n│   └── web\u002F                 # Next.js 15 主应用 (React 19)\n├── packages\u002F                # 共享包模块\n│   ├── api\u002F                 # API 层 (tRPC + 类型安全)\n│   ├── auth\u002F                # 认证服务 (better-auth)\n│   ├── better-auth-cloudflare\u002F # Cloudflare 认证适配器\n│   ├── better-auth-stripe\u002F  # Stripe 支付集成\n│   ├── common\u002F              # 公用工具库和类型定义\n│   ├── db\u002F                  # 主数据库模式和操作 (PostgreSQL)\n│   ├── email\u002F               # 邮件服务组件\n│   ├── middleware\u002F          # 中间件服务和工具\n│   ├── sandbox\u002F             # 统一沙箱抽象层 (E2B + Daytona)\n│   ├── shikicode\u002F           # 代码编辑器 (Shiki 语法高亮)\n│   ├── templates\u002F           # 项目脚手架模板\n│   └── ui\u002F                  # 设计系统 (shadcn\u002Fui + Tailwind CSS v4)\n├── tooling\u002F                 # 开发工具和配置\n│   └── typescript-config\u002F   # 共享 TypeScript 配置\n└── scripts\u002F                 # GitHub 环境变量管理\n```\n\n### 应用服务概览\n\n**🔒 认证管理中心 (`apps\u002Fauth-studio`)**\n\n- 用户、组织、权限和订阅的全生命周期管理\n- 主数据库采用 PostgreSQL（通过 Neon + Hyperdrive），认证数据使用 D1（SQLite）\n- OAuth 2.0 多提供商认证系统\n- 集成 Stripe 商业支付网关\n\n**🔨 构建编译服务 (`apps\u002Fbuilder`)**\n\n- Vite 高性能构建引擎，支持毫秒级热启动\n- 自动化代码编译与无缝生产部署\n- 多技术栈项目模板快速实例化\n\n**📺 内容分发服务 (`apps\u002Fcdn`)**\n\n- 基于 Hono 框架的文件管理系统\n- 智能图像处理与压缩优化\n- 全球 CDN 边缘缓存加速\n- Cloudflare Workers 边缘部署\n\n**🚀 部署服务 V2 (`apps\u002Fdeploy`)**\n\n- 基于 Cloudflare Queues 的现代化部署架构\n- 批量处理与并发控制\n- D1 数据库状态管理\n- 失败部署的死信队列处理\n- 全面的错误处理与重试逻辑\n\n**⚡ 部署服务 V1 (`apps\u002Fdeploy-workflow`, 已弃用)**\n\n- 基于 Cloudflare Workflows 的部署编排\n- 分步部署流程与状态管理\n- 内置重试机制与错误恢复\n- 支持复杂部署场景及依赖管理\n\n**🔀 请求路由服务 (`apps\u002Fdispatcher`)**\n\n- Platforms 核心路由组件 Worker\n- 将用户域名请求路由至相应 Worker 实例\n- 动态 Worker 调度与生命周期管理\n- 自定义域名绑定与 SSL 证书处理\n- 统一认证与访问控制层\n- 集成 Cloudflare SaaS for Platforms\n\n**📖 技术文档站点 (`apps\u002Fdocs`)**\n\n- FumaDocs 现代化文档解决方案\n- Cloudflare Workers 全球分发\n\n**📧 邮件通知服务 (`apps\u002Femail`)**\n\n- 基于 React Email 组件的邮件开发\n- 多场景邮件模板引擎\n\n**🔄 OpenNext 缓存服务 (`apps\u002Fopennext-cache`)**\n\n- Next.js 在 Cloudflare 上的部署缓存优化\n- OpenNext 框架与 Cloudflare Workers 集成\n- 与主 Web 应用程序部署无缝衔接\n\n**📸 截图服务 (`apps\u002Fscreenshot`)**\n\n- 基于 Cloudflare Queues 的截图生成\n- 异步队列处理网页截图请求\n- 自动化网站预览图生成\n- 使用 R2 存储截图文件\n- 批量处理与错误重试\n\n**🔨 项目脚手架服务 (`apps\u002Fvite-shadcn-template`)**\n\n- Vite 高性能构建工具链\n- 快速编译与生产部署\n- 预配置 shadcn\u002Fui + Tailwind CSS v4\n- 可视化模板选择与预览\n\n**🌐 核心 Web 应用程序 (`apps\u002Fweb`)**\n\n- Next.js 15 App Router + React 19 技术栈\n- 平台主界面与用户交互层\n- 基于 AI 的智能对话与项目管理\n- 实时代码编辑、预览、部署及版本控制\n- Cloudflare Workers 无服务器部署\n\n### 🛠️ 核心技术栈\n\n#### 前端技术架构\n\n| 技术框架         | 应用场景                     | 版本       |\n|------------------|------------------------------|------------|\n| [Next.js](https:\u002F\u002Fnextjs.org?utm_source=libra.dev) | React 全栈开发框架（App Router） | 15.3.5     |\n| [React](https:\u002F\u002Freact.dev?utm_source=libra.dev)   | 用户界面库（Server Components） | 19.1.1     |\n| [TypeScript](https:\u002F\u002Ftypescriptlang.org?utm_source=libra.dev) | 静态类型化的 JavaScript 超集 | 5.8.3+     |\n| [Tailwind CSS](https:\u002F\u002Ftailwindcss.com?utm_source=libra.dev) | 实用程序优先的 CSS 框架 | 4.1.11     |\n| [shadcn\u002Fui](https:\u002F\u002Fui.shadcn.com?utm_source=libra.dev) | 组件库和设计系统 | 基于 Radix UI |\n| [Radix UI](https:\u002F\u002Fradix-ui.com?utm_source=libra.dev) | 无样式、可访问的 UI 原语库 | 1.2.x-1.3.x |\n| [Motion](https:\u002F\u002Fmotion.dev?utm_source=libra.dev) | 现代动画引擎 | 12.23.11   |\n| [Lucide React](https:\u002F\u002Flucide.dev?utm_source=libra.dev) | 矢量图标库 | 0.486.0    |\n\n#### 后端与 API 架构\n\n| 技术框架         | 应用场景                     | 版本       |\n|------------------|------------------------------|------------|\n| [tRPC](https:\u002F\u002Ftrpc.io?utm_source=libra.dev) | 端到端类型安全的 API 开发 | 11.4.3+    |\n| [Hono](https:\u002F\u002Fhono.dev?utm_source=libra.dev) | 边缘计算 Web 框架 | 4.8.10+    |\n| [Zod](https:\u002F\u002Fzod.dev?utm_source=libra.dev) | TypeScript 数据验证库 | 4.0.14     |\n| [Drizzle ORM](https:\u002F\u002Form.drizzle.team?utm_source=libra.dev) | 类型安全的 TypeScript ORM | 0.44.4     |\n| [better-auth](https:\u002F\u002Fbetter-auth.com?utm_source=libra.dev) | 现代身份认证解决方案 | 1.3.4      |\n\n#### AI 与机器学习\n\n| AI 平台          | 特性                         | API 版本   |\n|------------------|------------------------------|------------|\n| [AI SDK](https:\u002F\u002Fsdk.vercel.ai?utm_source=libra.dev) | 多提供商 AI 模型集成 | 4.3.19     |\n| [E2B](https:\u002F\u002Fe2b.dev?utm_source=libra.dev) | 安全的代码执行沙盒 | 1.2.0-beta.5 |\n| [Daytona](https:\u002F\u002Fdaytona.io?utm_source=libra.dev) | 开发环境沙盒提供商 | 最新       |\n| **集成 AI 模型** |                              |            |\n| Anthropic Claude | 高级推理与代码生成         | API v1     |\n| Azure OpenAI     | 企业级 AI 模型服务           | API v1     |\n| Google Gemini    | 多模态 AI 能力               | API v1     |\n| DeepSeek         | 高性价比的代码生成           | API v1     |\n\n#### 数据存储架构\n\n| 数据库技术       | 应用场景                     | 版本       |\n|------------------|------------------------------|------------|\n| [Neon](https:\u002F\u002Fneon.com?utm_source=libra.dev) | 主数据库（PostgreSQL） | 17+        |\n| [Cloudflare Hyperdrive](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fhyperdrive?utm_source=libra.dev) | 数据库连接池与加速 | 最新       |\n| [Cloudflare D1](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fd1?utm_source=libra.dev) | 边缘数据库（SQLite） | 最新       |\n| [Drizzle Kit](https:\u002F\u002Form.drizzle.team\u002Fkit-docs\u002Foverview?utm_source=libra.dev) | 数据库迁移工具 | 0.31.4+    |\n\n#### 部署与基础设施\n\n| 平台技术         | 应用场景                     | 版本       |\n|------------------|------------------------------|------------|\n| [Cloudflare Workers](https:\u002F\u002Fworkers.cloudflare.com?utm_source=libra.dev) | 无服务器边缘计算平台 | 最新       |\n| [OpenNext](https:\u002F\u002Fopennext.js.org\u002Fcloudflare?utm_source=libra.dev) | Next.js Cloudflare 部署适配器 | 1.6.2      |\n| [Turborepo](https:\u002F\u002Fturbo.build?utm_source=libra.dev) | 高性能 Monorepo 构建系统 | 2.5.5      |\n| [Bun](https:\u002F\u002Fbun.sh?utm_source=libra.dev) | JavaScript 运行时与包管理器 | 1.2.19     |\n\n#### 开发工具链\n\n| 工具             | 用途                         | 版本       |\n|------------------|------------------------------|------------|\n| [Biome](https:\u002F\u002Fbiomejs.dev?utm_source=libra.dev) | 代码格式化与质量检查 | ^2.2.2     |\n| [Vitest](https:\u002F\u002Fvitest.dev?utm_source=libra.dev) | 单元测试框架 | 3.2.4      |\n| [Paraglide.js](https:\u002F\u002Finlang.com\u002Fm\u002Fgerre34r\u002Flibrary-inlang-paraglideJs?utm_source=libra.dev) | 国际化 i18n 解决方案 | 2.2.0      |\n\n## ⚡ 快速入门\n\n### 🎯 选择使用方式\n\n#### 🌐 云端托管服务（推荐）\n\n- 访问 [libra.dev](https:\u002F\u002Flibra.dev) 开始使用\n- 使用 GitHub OAuth 或邮箱快速注册\n- 几分钟内即可构建生产级应用\n\n#### 💻 本地开发部署（开发者）\n\n- 完整源码访问与控制\n- 深度自定义开发与扩展\n- 私有\u002F企业级部署\n\n### 📦 环境要求\n\n```bash\n# 系统依赖要求\ngit --version   # >= 2.30.0\nnode --version  # >= 20.0.0（建议 24）\nbun --version   # >= 1.0.0\n```\n\n### 🚀 本地环境搭建\n\n#### 步骤 1：获取源码\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra.git\ncd libra\nbun install\n# （可选）为 apps\u002Fweb 生成 i18n 文件\ncd apps\u002Fweb && bun run prebuild && cd ..\u002F..\n```\n\n#### 步骤 2：配置环境变量\n\n```bash\ncp .env.example .env\n```\n\n编辑 `.env` 文件以配置必要的环境变量。\n\n#### 步骤 3：初始化数据库\n\n主数据库（PostgreSQL）初始化：\n\n```bash\n# 在项目根目录下生成并运行迁移\ncd packages\u002Fdb\nbun db:generate\nbun db:migrate\n```\n\n认证数据库（D1\u002FSQLite）初始化：\n\n```bash\n# 测试 D1 数据库连接（本地环境）\ncd apps\u002Fweb && bun wrangler d1 execute libra --local --command='SELECT 1'\n\n# 生成并运行认证数据库迁移\ncd packages\u002Fauth\nbun db:generate\nbun db:migrate\n```\n\n#### 步骤 4：启动开发服务\n\n```bash\n# 启动所有服务\nbun dev\n\n# 或单独启动主应用\ncd apps\u002Fweb && bun dev\n```\n\n#### 步骤 5：配置 Stripe 支付（必填）\n\n配置相应的产品：\n\n```bash\nstripe listen --forward-to localhost:3000\u002Fapi\u002Fauth\u002Fstripe\u002Fwebhook\n```\n\n### 🌐 本地服务地址\n\n设置完成后，您可以通过以下地址访问各项服务：\n\n- **核心应用（web）**：\u003Chttp:\u002F\u002Flocalhost:3000>\n- **邮件预览（email）**：\u003Chttp:\u002F\u002Flocalhost:3001>\n- **认证管理（auth-studio）**：\u003Chttp:\u002F\u002Flocalhost:3002>\n- **技术文档（docs）**：\u003Chttp:\u002F\u002Flocalhost:3003>\n- **CDN 服务（cdn）**：\u003Chttp:\u002F\u002Flocalhost:3004>\n- **构建服务（builder）**：\u003Chttp:\u002F\u002Flocalhost:5173>（Vite 默认端口）\n- **模板服务（vite-shadcn-template）**：\u003Chttp:\u002F\u002Flocalhost:5173>（Vite 默认端口，可能与 builder 冲突）\n- **路由服务（dispatcher）**：\u003Chttp:\u002F\u002Flocalhost:3007>\n- **部署服务 V2（deploy）**：\u003Chttp:\u002F\u002Flocalhost:3008>\n- **截图服务（screenshot）**：\u003Chttp:\u002F\u002Flocalhost:3009>\n- **部署服务 V1（deploy-workflow，已弃用）**：\u003Chttp:\u002F\u002Flocalhost:3008>（与部署服务 V2 共用端口）\n\n## 🚀 部署选项\n\n### 🌐 云托管服务（推荐）\n\n开箱即用的云端开发体验：\n\n1. 访问 [libra.dev](https:\u002F\u002Flibra.dev) 官方平台\n2. 使用 GitHub OAuth 或邮箱快速注册\n3. 基于 AI 的应用快速构建\n4. 一键部署至自定义域名\n\n**云服务优势：**\n- 零配置，开箱即用\n- 弹性扩展与自动更新\n- 内置 AI 模型集成\n- 企业级技术支持\n\n### 🏠 自行部署\n\n**1. 部署 Libra 平台本身**\n\nLibra 平台的所有服务均部署在 Cloudflare Workers 上：\n\n```bash\n\n# 将各类服务部署至 Cloudflare Workers\n# 完整部署流程请参考以下工作流文件：\n# - .github\u002Fworkflows\u002Fweb.yml - 主应用部署\n# - .github\u002Fworkflows\u002Fcdn.yml - CDN 服务部署\n# - .github\u002Fworkflows\u002Fdeploy.yml - 部署服务部署\n# - .github\u002Fworkflows\u002Fdispatcher.yml - 路由服务部署\n# - .github\u002Fworkflows\u002Fscreenshot.yml - 截图服务部署\n# - .github\u002Fworkflows\u002Fdocs.yml - 文档站点部署\n```\n\n**2. 作为 PaaS 平台部署用户项目**\n\nLibra 使用 **Workers for Platforms** 技术为用户提供项目部署能力，提供两种部署服务架构：\n\n1. **Workers for Platforms 架构**：\n    - 每个用户项目以独立 Worker 形式部署\n    - 通过 `dispatcher` 服务实现智能路由\n    - 支持自定义域名绑定\n    - 完全隔离的运行环境（通过 Workers for Platforms 实现进程级隔离）\n\n2. **部署服务架构选项**：\n\n   **V2 队列架构** (`apps\u002Fdeploy`)：\n    - **Cloudflare Queues**：异步队列处理部署任务\n    - **批量处理**：支持并发控制与批量部署\n    - **死信队列**：失败重试机制\n    - **适用场景**：高并发、大规模部署需求\n\n   **V1 工作流架构** (`apps\u002Fdeploy-workflow`, 已弃用)：\n    - **Cloudflare Workflows**：分步骤部署编排\n    - **状态持久化**：内置状态管理和恢复机制\n    - **复杂流程**：支持复杂的部署依赖和条件逻辑\n    - **适用场景**：复杂部署流程、需要精确控制的场景\n\n3. **通用部署流程**：\n    - 核实用户权限与项目配额\n    - 创建沙盒环境进行安全构建（支持 E2B 或 Daytona）\n    - 同步项目文件\n    - 执行构建命令（`bun install` 和 `bun build`）\n    - 使用 Wrangler API 部署至用户的 Worker 实例\n    - 更新路由配置，清理临时环境\n\n4. **技术特性**：\n    - **沙盒环境**：安全隔离的构建环境（支持 E2B 或 Daytona）\n    - **全球分布式**：利用 Cloudflare 边缘计算网络\n    - **灵活架构**：根据需求选择合适的部署服务\n\n## 🎯 托管平台 vs 开源\n\n### 📊 功能对比\n\n| 功能 | 托管平台 | 开源 | 备注 |\n|---------|----------------|-------------|-------|\n| **🤖 AI 代码生成** | ✅ 开箱即用 | ❌ 需配置 API 密钥 | 多 AI 提供商集成 |\n| **🔧 开发环境** | ✅ 零配置 | ❌ 需搭建沙盒环境 | 云端 IDE 和实时预览 |\n| **📂 GitHub 集成** | ✅ 一键连接 | ❌ 需设置 OAuth 授权 | 仓库自动创建与同步 |\n| **🌐 部署服务** | ✅ 内置支持 | ❌ 需搭建部署环境 | Cloudflare 原生集成 |\n| **🎨 编辑器** | ✅ 功能齐全 | ❌ 基本可视化编辑 | 可视化编辑与预览 |\n| **🔒 数据控制** | 🔒 云托管 | ✅ 完全私有控制 | 自行部署数据完全可控 |\n| **🛠️ 自定义开发** | ⚠️ 平台限制 | ✅ 无限制定制 | 源码级修改与扩展 |\n| **📞 技术支持** | ✅ 专业服务 | 🤝 社区支持 | 官方服务 vs 开源社区 |\n| **💰 成本结构** | 💰 按使用付费 | 🆓 基础设施成本 | SaaS 订阅 vs 自行维护 |\n\n### 🤔 如何选择合适版本？\n\n#### 选择云托管服务的情况：\n\n- **🚀 快速上线**：无需复杂配置，可立即开始应用开发\n- **💼 业务优先**：专注于产品开发而非基础设施运维\n- **👥 团队协作**：需要企业级团队管理功能\n- **📞 专业服务**：期望官方技术支持及 SLA 保障\n- **🔄 自动化运营**：希望平台自动更新与维护\n\n#### 选择开源版本的情况：\n\n- **🏠 数据自主**：完全掌控数据存储与处理\n- **🔧 深度定制**：需要修改核心功能或集成专有业务逻辑\n- **💰 成本控制**：拥有技术团队，需优化长期运营成本\n- **🌍 特殊部署**：特定区域、私有网络或离线环境部署\n- **📚 技术学习**：深入理解完整的技术架构设计\n\n## ❓ 常见问题解答\n\n### 🆚 产品版本\n\n**Q：托管平台与开源版本的核心区别是什么？**\n\nA：**云托管** 是官方提供的 SaaS 服务，注册后即可使用，包含完整的 AI 能力与企业级功能。**开源版本** 提供核心源码，支持自行部署与深度定制，但需要自行配置 AI API 和运行环境。\n\n**Q：开源版本的功能完整性如何？**\n\nA：开源版本包含了平台的核心功能架构。我们遵循“99% 功能开源，1% 商业服务”的原则，确保开发者能够获得完整的技术能力。\n\n### 🛠️ 技术问题\n\n**问：使用 Libra 需要什么样的技术背景？**\n\n答：取决于使用方式：\n\n- **托管平台用户**：无需任何技术背景，只需使用浏览器即可。\n- **本地开发者**：需要具备基本的 Web 开发知识和 Node.js 经验。\n- **自托管部署**：需要有服务器和 DevOps 的实践经验。\n\n**问：AI 生成的代码质量如何？**\n\n答：我们始终追求生产级的代码质量：\n\n- 完整的 TypeScript 类型安全保证\n- 遵循现代 React 开发模式和行业最佳实践\n- 基于 Tailwind CSS 实现响应式设计\n- 集成了 Radix UI 的可访问性组件\n- 清晰且易于维护的代码结构和注释\n\n**问：我可以自定义 AI 的行为和提示词吗？**\n\n答：开源版本支持完全自定义：\n\n- 自定义 AI 提示工程\n- 灵活配置模型选择逻辑\n- 修改代码生成模板\n- 集成第三方 AI 服务\n\n### 💼 商业用途\n\n**问：Libra 能否用于商业项目？**\n\n答：当然可以。我们提供多种商业解决方案：\n\n- **托管平台**：适合企业的按需付费模式\n- **开源版本**：遵循 AGPL-3.0 开源许可证，要求衍生项目也必须开源\n- **商业授权**：为需要闭源部署的企业提供商业开源许可证\n\n**问：数据安全和隐私保护方面如何保障？**\n\n答：我们提供不同级别的数据保护方案：\n\n- **托管平台**：数据在我们的安全基础设施中处理，符合国际安全标准\n- **自托管部署**：您对数据存储、处理和访问权限拥有完全控制权\n- **企业定制化**：可根据特殊的安全要求和合规需求提供定制化解决方案\n\n**问：是否提供企业级技术支持？**\n\n答：是的。我们的企业服务包括：\n\n- 私有云环境部署\n- 自定义功能开发服务\n- 专属技术支持团队\n- 服务水平协议（SLA）保障\n- 安全审计和合规支持\n\n如需企业服务，请联系：[contact@libra.dev](mailto:contact@libra.dev)\n\n### 🔧 开发与部署\n\n**问：支持哪些部署平台？**\n\n答：目前仅支持在 Cloudflare 上部署。\n\n**问：如何参与开源项目的贡献？**\n\n答：我们热烈欢迎社区贡献。具体方法请参阅下方的【社区贡献指南】。\n\n### 🤝 社区贡献\n\n我们热忱欢迎全球开发者参与贡献！以下是您可以参与的方式：\n\n#### 🌟 使用与推广\n\n- 体验 [Libra 平台](https:\u002F\u002Flibra.dev)，分享您的使用心得\n- 创建精彩的项目并在社区中展示\n- 撰写技术博客文章或制作教程视频\n- 在社交媒体平台上分享并推荐 Libra\n\n#### 🔧 代码贡献\n\n```bash\n# 1. 在 GitHub 上 Fork 我们的仓库\n# 2. 将您的 Fork 克隆到本地\ngit clone https:\u002F\u002Fgithub.com\u002Fyour-username\u002Flibra.git\ncd libra\n\n# 3. 创建功能开发分支\ngit checkout -b feature\u002Fyour-amazing-feature\n\n# 4. 进行开发并充分测试\nbun install\nbun dev\n\n# 5. 提交代码，并撰写清晰的提交信息\ngit commit -m \"feat: 添加令人惊叹的新功能\"\n\n# 6. 推送分支并创建 Pull Request\ngit push origin feature\u002Fyour-amazing-feature\n```\n\n#### 📝 其他贡献方式\n\n- **文档改进**：完善使用指南、添加示例代码、修复文档错误\n- **问题报告**：帮助我们发现并定位系统问题\n- **功能建议**：提出改进建议和新功能需求\n- **多语言支持**：帮助将 Libra 翻译成更多语言\n    - 项目使用 Paraglide.js 进行国际化\n    - 翻译文件位置：`apps\u002Fweb\u002Fmessages\u002F[locale].json`\n    - 添加新语言：在 `apps\u002Fweb\u002Fproject.inlang\u002Fsettings.json` 中添加语言代码\n- **社区支持**：在 [论坛](https:\u002F\u002Fforum.libra.dev) 和 GitHub 讨论区帮助其他用户\n\n#### 🎯 贡献指南\n\n- 请遵守我们的【行为准则】(https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002Fcode_of_conduct_zh.md)\n- 阅读并遵循【贡献指南】(https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002FTECHNICAL_GUIDELINES_ZH.md)\n- 使用标准化的提交信息格式（Conventional Commits）\n- 为新功能提供相应的测试用例\n- 及时更新相关文档\n\n## 📄 开源许可证\n\n### 📜 AGPL-3.0 开源许可证\n\nLibra 依据 [GNU Affero General Public License v3.0](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fblob\u002Fmain\u002FLICENSE) 开源许可证发布。\n\n#### ✅ 您的权利\n\n- **🆓 免费使用**：可用于个人、教育及商业项目\n- **🔧 修改与定制**：可自由修改和扩展代码功能\n- **📤 分发与共享**：可在相同许可证下与他人共享\n- **🏢 商业部署**：允许用于商业目的的部署\n\n#### 📋 您的义务\n\n- **📄 保留版权信息**：必须保留原始版权声明\n- **🔓 衍生作品开源**：对任何修改都必须提供源代码\n- **📧 网络服务开源**：通过网络提供服务时必须开源\n- **🔗 使用相同许可证**：衍生作品必须采用 AGPL-3.0 许可证\n\n#### 💼 商业许可证\n\n如果您需要更高的灵活性，我们提供适合以下场景的商业许可证：\n\n- 闭源专有修改\n- 不公开源代码的产品分发\n- 定制化的许可条款\n\n商业授权咨询：[contact@libra.dev](mailto:contact@libra.dev)\n\n### 💬 参与路线图讨论\n\n我们欢迎社区参与路线图规划：\n\n- 📝 [功能请求](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fissues\u002Fnew?template=feature_request.md)\n- 💬 [路线图讨论](https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fdiscussions)\n- 📧 [企业需求](mailto:contact@libra.dev)\n\n### 🙏 致谢\n\n感谢以下优秀赞助商对 Libra 项目的宝贵支持，使我们能够专注于为开发者打造更优质的 AI 开发体验：\n\n**[Clerk](https:\u002F\u002Fclerk.com?utm_source=libra.dev)** - 最全面的用户管理平台\n\n**[E2B](https:\u002F\u002Fe2b.dev\u002Fstartups?utm_source=libra.dev)** - E2B 是一个开源运行时环境，可在安全的云沙箱中执行 AI 生成的代码，适用于智能体和 AI 应用场景。\n\n**[PostHog](https:\u002F\u002Fposthog.com\u002Fstartups?utm_source=libra.dev)** - 一体化平台，用于分析、测试、监控以及部署新功能\n\n**[Daytona](https:\u002F\u002Fdaytona.io\u002Fstartups?utm_source=libra.dev)** - Daytona 是一套安全且具备弹性的基础设施，用于运行 AI 生成的代码\n\n**[Cloudflare](https:\u002F\u002Fwww.cloudflare.com\u002Fforstartups\u002F?utm_source=libra.dev)** - 全球领先的边缘计算与网络基础设施提供商\n\n---","# Libra AI 快速上手指南\n\nLibra AI 是一个开源的 AI 原生开发平台，被誉为 V0\u002FLovable 的开源替代方案。它允许你通过自然语言描述，快速构建、迭代并部署基于 Cloudflare Workers 架构的全栈 Web 应用。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n### 系统要求\n- **操作系统**: macOS, Linux 或 Windows (推荐 WSL2)\n- **Node.js**: v20.x 或更高版本\n- **包管理器**: pnpm (推荐) 或 npm\u002Fyarn\n\n### 前置依赖与账号\n你需要提前注册并准备以下服务的 API Key 或访问权限：\n1. **Cloudflare Account**: 必须拥有 Cloudflare 账号，并获取 `Account ID` 和 `API Token` (需包含 Workers, D1, KV, R2 等权限)。\n2. **AI 模型提供商**: 至少配置一个 LLM API Key (如 OpenAI, Anthropic\u002FClaude, Google Gemini, DeepSeek 等)。\n3. **数据库**: 本地开发需安装 Docker (用于运行 PostgreSQL)，或直接使用 Cloudflare D1\u002FHyperdrive。\n4. **支付服务 (可选但推荐)**: Stripe API Keys (用于测试订阅功能)。\n\n> **国内开发者提示**: 如果访问 GitHub 或 npm 源较慢，建议配置国内镜像源。\n> ```bash\n> # 设置 pnpm 淘宝镜像\n> pnpm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 安装步骤\n\n### 第一步：获取源代码\n克隆项目仓库到本地：\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra.git\ncd libra\n```\n\n### 第二步：安装依赖\n使用 pnpm 安装项目依赖（Libra 采用 Turborepo 单体仓库架构）：\n```bash\npnpm install\n```\n\n### 第三步：配置环境变量\n复制环境变量模板文件并根据实际情况填写：\n```bash\ncp .env.example .env\n```\n编辑 `.env` 文件，填入关键配置：\n```ini\n# Cloudflare 配置\nCLOUDFLARE_ACCOUNT_ID=你的账户 ID\nCLOUDFLARE_API_TOKEN=你的 API Token\n\n# AI 模型配置 (任选其一或多个)\nOPENAI_API_KEY=sk-...\nANTHROPIC_API_KEY=sk-ant-...\n# 或使用国内模型代理\nDEEPSEEK_API_KEY=...\n\n# 数据库配置 (本地开发)\nDATABASE_URL=postgresql:\u002F\u002Fuser:password@localhost:5432\u002Flibra_db\n\n# Stripe 配置 (如需测试支付)\nSTRIPE_SECRET_KEY=sk_test_...\nSTRIPE_WEBHOOK_SECRET=whsec_...\n```\n\n### 第四步：初始化数据库\n如果使用本地 PostgreSQL，请先启动 Docker 容器并运行迁移脚本：\n```bash\n# 启动本地数据库 (如果项目包含 docker-compose)\ndocker compose up -d db\n\n# 执行数据库迁移\npnpm db:migrate\n```\n*注：若直接使用 Cloudflare D1，请参照文档运行 `wrangler d1 create` 相关命令。*\n\n### 第五步：启动开发服务\n启动所有核心服务（包括前端、后端、构建服务等）：\n```bash\npnpm dev\n```\n系统将自动启动多个端口，主应用通常运行在 `http:\u002F\u002Flocalhost:3000`。\n\n## 基本使用\n\n### 1. 访问平台\n打开浏览器访问 `http:\u002F\u002Flocalhost:3000` (或你配置的本地地址)。首次使用可能需要注册一个管理员账号。\n\n### 2. 创建第一个应用\n在输入框中使用自然语言描述你的需求，例如：\n> \"创建一个带有深色模式的待办事项列表应用，支持任务分类和本地存储。\"\n\n### 3. 实时预览与迭代\n- **代码生成**: Libra 将调用配置的 AI 模型生成 React + Tailwind CSS 代码。\n- **热更新**: 利用 Cloudflare Workers 和 HMR 技术，右侧预览窗口将实时展示应用效果。\n- **继续对话**: 你可以继续输入指令进行修改，例如：\"把按钮颜色改成蓝色，并添加一个删除确认弹窗\"。\n\n### 4. 部署上线\n当应用开发完成后，点击界面上的 **Deploy** 按钮。Libra 会自动将应用构建并部署到 Cloudflare Workers 边缘网络，生成一个可公开访问的 `*.workers.dev` 域名。\n\n---\n*更多高级配置（如自定义域名、多沙箱环境切换）请参考官方文档。*","一位独立开发者需要在周末快速验证一个“社区二手交易小程序”的创意，希望尽快上线可交互的原型以收集用户反馈。\n\n### 没有 libra 时\n- **启动成本高昂**：从零搭建 React 前端、Node.js 后端及数据库环境至少需要半天时间，严重拖慢创意验证速度。\n- **全栈协调困难**：开发者需同时兼顾 UI 设计、API 接口定义和服务器配置，容易因上下文切换导致逻辑漏洞。\n- **部署流程繁琐**：将本地代码迁移至生产环境涉及复杂的 CI\u002FCD 配置，往往在部署环节卡壳数小时。\n- **迭代周期漫长**：每次修改功能都需要重新编译、测试并手动更新线上版本，无法实现“即时所见即所得”。\n\n### 使用 libra 后\n- **一句话即刻启动**：只需输入“创建一个包含用户认证和商品发布功能的二手交易平台”，libra 自动生成完整的全栈代码架构。\n- **智能全栈集成**：libra 自动处理前端界面、后端逻辑与数据库连接的协同工作，开发者仅需关注核心业务规则。\n- **一键生产部署**：利用内置的云原生能力，libra 直接将应用部署到可用公网访问的环境，无需配置任何服务器。\n- **自然语言迭代**：通过对话指令如“增加图片上传功能”或“优化移动端布局”，libra 实时更新代码并热重载，分钟级完成功能演进。\n\nlibra 将原本需要数天的全栈开发工作压缩至几分钟，让开发者能真正专注于产品创意而非基础设施搭建。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnextify-limited_libra_a1a38348.png","nextify-limited","Nextify Limited","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fnextify-limited_8b6d5cc0.png","",null,"nextify2024","https:\u002F\u002Fgithub.com\u002Fnextify-limited",[83,87,91,95,99,103,107],{"name":84,"color":85,"percentage":86},"TypeScript","#3178c6",95.6,{"name":88,"color":89,"percentage":90},"MDX","#fcb32c",2.3,{"name":92,"color":93,"percentage":94},"CSS","#663399",1.4,{"name":96,"color":97,"percentage":98},"JavaScript","#f1e05a",0.4,{"name":100,"color":101,"percentage":102},"HTML","#e34c26",0.2,{"name":104,"color":105,"percentage":106},"Dockerfile","#384d54",0.1,{"name":108,"color":109,"percentage":110},"Shell","#89e051",0,1512,236,"2026-04-02T05:12:56","AGPL-3.0",4,"未说明","不需要 GPU",{"notes":119,"python":116,"dependencies":120},"该工具完全构建在 Cloudflare 生态之上，核心运行环境为 Cloudflare Workers（无服务器架构），而非传统的本地 Python\u002FGPU 环境。本地开发需配置 Cloudflare 账户及相关 API 密钥，并依赖外部沙箱提供商（如 E2B 或 Daytona）进行代码执行隔离。主要技术栈为 TypeScript\u002FJavaScript (Next.js 15, React 19, Vite)，无需安装 CUDA 或特定显卡驱动。",[121,122,123,124,125,126,127,128,129,130],"Node.js (隐含，基于 Vite\u002FNext.js)","Turborepo","Cloudflare Workers","Cloudflare D1","Cloudflare R2","Cloudflare Queues","Cloudflare Workflows","E2B 或 Daytona (沙箱服务)","Stripe","PostgreSQL (通过 Hyperdrive)",[14,13,15],[133,134,135,136,137,138,139],"ai","vibe-coding","web-coding","lovable","v0","cloudflare-workers","typescript","2026-03-27T02:49:30.150509","2026-04-06T05:17:19.828628",[143,148,153,157,161,166],{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},11901,"如何复现 Libra 模型的评估结果？我的 BLEU 和 ROUGE 指标与论文不符怎么办？","指标差异通常由生成参数和文本预处理方式引起。请遵循以下调整：\n1. 使用确定性生成参数：设置 temperature=0.0, top_p=1.0。\n2. 仅评估 'FINDINGS' 部分：在评估脚本中添加 extract_findings_section 函数提取该章节。\n3. 修改预处理逻辑：不要使用激进的正则表达式清洗，改用温和的 normalize_medical_text 例程以保留医学术语。\n4. 参考项目中新添加的 evaluation\u002FREADME_EVALUATION.md 指南以及 evaluation\u002Fimproved_eval.py 工具进行重新评估。","https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fissues\u002F30",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},11902,"为什么在 Cloud 实例上遇到 'Unterminated String' 错误？","该错误是因为当前使用的 GPT-4.1 模型不适合生成复杂的应用程序代码。维护者计划尽快切换到更强大的模型来解决此问题。","https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fissues\u002F27",{"id":154,"question_zh":155,"answer_zh":156,"source_url":152},11903,"本地运行和云端部署时，环境变量配置有什么不同？","本地运行只需填写部分环境变量即可启动；但在进行云端部署（如 Cloudflare）时，几乎需要填写所有数据。建议在 GitHub 配置中填全所有环境变量以确保部署成功。",{"id":158,"question_zh":159,"answer_zh":160,"source_url":152},11904,"项目支持部署到 Vercel 吗？","目前不支持。部署到 Vercel 需要重写几乎所有代码，团队目前没有能力进行此项工作。当前的重点也不是编写 Cloudflare 部署的详细文档。",{"id":162,"question_zh":163,"answer_zh":164,"source_url":165},11905,"Libra 是否支持通过 MySQL\u002FPostgreSQL DDL 生成 GORM Model？","这不是 Libra 当前的主要目标。Libra 专注于基于 vite+react+hono 的全栈生成能力，并非传统的 AI 聊天工具。不过，社区欢迎贡献关于 Go 及相关项目生成的代码和模板。","https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fissues\u002F10",{"id":167,"question_zh":168,"answer_zh":169,"source_url":170},11906,"生产环境如何构建 Cloudflare Workers？","项目支持在生产环境（CI\u002FCD）中构建 Cloudflare Workers。对于其他分支，请使用 GitHub Actions 进行构建。","https:\u002F\u002Fgithub.com\u002Fnextify-limited\u002Flibra\u002Fissues\u002F4",[]]