[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-store-craft--storecraft":3,"tool-store-craft--storecraft":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},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,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},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 真正成长为懂上",159636,2,"2026-04-17T23:33:34",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":78,"owner_email":79,"owner_twitter":78,"owner_website":80,"owner_url":81,"languages":82,"stars":107,"forks":108,"last_commit_at":109,"license":110,"difficulty_score":32,"env_os":111,"env_gpu":112,"env_ram":112,"env_deps":113,"category_tags":125,"github_topics":126,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":131,"updated_at":132,"faqs":133,"releases":164},8744,"store-craft\u002Fstorecraft","storecraft","⭐ Rapidly build AI-powered, Headless e-commerce backends with TypeScript","Storecraft 是一款专为开发者打造的开源框架，旨在利用 TypeScript 和 JavaScript 快速构建具备 AI 能力的无头电商后端。它解决了传统电商系统开发周期长、集成 AI 功能复杂以及架构不够灵活等痛点，让团队能专注于业务逻辑而非底层设施搭建。\n\n该工具特别适合全栈工程师、后端开发者以及希望快速验证电商创意的初创团队使用。其核心亮点在于\"AI 优先”的设计理念：内置支持主流大语言模型和向量数据库，可轻松实现智能客服、商品相似性搜索及代理式购物助手；同时提供强大的可编程 API、REST 接口及独有的 VQL（虚拟查询语言）来管理商品、订单和用户。\n\n在技术架构上，Storecraft 展现出极高的灵活性。它采用事件驱动和模块化设计，不仅兼容 Node.js、Deno、Bun 及各类 Serverless 平台，还能无缝对接 MongoDB、PostgreSQL、SQLite 等多种数据库，以及 S3 兼容的对象存储。此外，它原生集成了 Stripe 和 PayPal 支付网关，并提供可视化管理仪表盘。通过简单的 CLI 命令，开发者即可初始化一个功能完备、可扩展","Storecraft 是一款专为开发者打造的开源框架，旨在利用 TypeScript 和 JavaScript 快速构建具备 AI 能力的无头电商后端。它解决了传统电商系统开发周期长、集成 AI 功能复杂以及架构不够灵活等痛点，让团队能专注于业务逻辑而非底层设施搭建。\n\n该工具特别适合全栈工程师、后端开发者以及希望快速验证电商创意的初创团队使用。其核心亮点在于\"AI 优先”的设计理念：内置支持主流大语言模型和向量数据库，可轻松实现智能客服、商品相似性搜索及代理式购物助手；同时提供强大的可编程 API、REST 接口及独有的 VQL（虚拟查询语言）来管理商品、订单和用户。\n\n在技术架构上，Storecraft 展现出极高的灵活性。它采用事件驱动和模块化设计，不仅兼容 Node.js、Deno、Bun 及各类 Serverless 平台，还能无缝对接 MongoDB、PostgreSQL、SQLite 等多种数据库，以及 S3 兼容的对象存储。此外，它原生集成了 Stripe 和 PayPal 支付网关，并提供可视化管理仪表盘。通过简单的 CLI 命令，开发者即可初始化一个功能完备、可扩展且文档齐全的电商后端系统，大幅降低技术门槛。","\u003Cdiv style=\"text-align:center\">\n  \u003Cdiv width=\"90%\">\n    \u003Cimg src='https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fblob\u002Fmain\u002Fpackages\u002Fdocs\u002Fpublic\u002Fstorecraft-color.svg' \n        width='100%' \u002F>\n  \u003C\u002Fdiv>\n  Rapidly build AI-powered, Headless e-commerce backends with TypeScript and Javascript !\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n![NPM Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fd18m\u002F%40storecraft%2Fcore)\n\n[![Core](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.core.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.core.yml)\n[![MongoDB](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-mongodb.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-mongodb.yml)[![SQLite \u002F Postgres \u002F MySQL](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-sql.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-sql.yml)\n[![S3 Compatible](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.storage-s3-compatible.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.storage-s3-compatible.yml)\n\n[![what](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Furl?url=https%3A%2F%2Fx.com%2Fshalev_tomer&style=social&label=Storecraft)](https:\u002F\u002Fx.com\u002Fshalev_tomer)\n[![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinkedIn-0077B5?style=flat-square&logo=linkedin&link=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fstore-craft\n)](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fstore-craft)\n\n# The \u003Cimg src='https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fblob\u002Fmain\u002Fpackages\u002Fdocs\u002Fpublic\u002Fstorecraft-color.svg' height='24px' style=\"transform: translateY(4px);\" \u002F> mono-repo\n\nHi 👋, `Storecraft` empowers developers to rapidly build AI-powered, Headless e-commerce backends with TypeScript and Javascript.\n\n⭐ AI first, agentic, chat endpoint and similarity search that can serve your customers, and your team. We Supports most of the popular LLMs, and vector stores for similarity search.\n\n⭐ Manage products, collections, orders, customers, auth, emails and more with a powerful programmable api code, REST API, VQL (Virtual Query Language) for powerful queries and similarity search.\n\n⭐ Built in chat endpoint with an agent that serves customers with carts, checkouts and more with PayPal and Stripe.\n\n⭐ Runs on any javascript [platform](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fplatforms\u002Fnode) (deno, bun, node, cloudflare workers, aws-lambda, google-functions), serverless \u002F serverful\n\n⭐ Connects to any [database](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fdatabases\u002Fsqlite) (mongo, libsql, sqlite, postgres, mysql, neon, turso, d1, planetscale)\n\n⭐ Uses [storage](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fstorage\u002Fs3) (local, r2, s3 compatible, google and more)\n\n⭐ It is [extensible and modular](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fextensions\u002Foverview)\n\n⭐ It is [event based](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fevents)\n\n⭐ Boasts an official [Dashboard](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fdashboard\u002Foverview)\n\n⭐ Well documented [REST-API](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Frest-api\u002Fapi) (can also be found in your `\u002Fapi\u002Freference` endpoint)\n\n\u003Chr\u002F>\n\n## **GET STARTED WITH CLI NOW** 👇\n\n```bash\nnpx storecraft create\n```\n\nThis is all the code you need to get started with your own storecraft app.\n\n```js\nconst app = new App({\n  auth_admins_emails: ['tomer.shalev@gmail.com'],\n  general_store_name: 'Wush Wush Games',\n  \u002F\u002F ... MORE Mandatory CONFIG\n})\n.withPlatform(new NodePlatform())\n.withDatabase(new LibSQL())\n.withStorage(new NodeLocalStorage('storage'))\n.withMailer(new Resend())\n.withPaymentGateways({\n  paypal: new Paypal({ env: 'test' }),\n  stripe: new Stripe(),\n  dummy_payments: new DummyPayments(),\n})\n.withExtensions({\n  postman: new PostmanExtension(),\n})\n.withAI(\n  new OpenAI({ model: 'gpt-4o-mini'})\n)\n.withVectorStore(\n  new LibSQLVectorStore({\n    embedder: new OpenAIEmbedder(),\n  })\n)\n.withAuthProviders({\n  google: new GoogleAuth(),\n})\n.on(\n  'order\u002Fcheckout\u002Fcomplete',\n  async (event) => {\n    \u002F\u002F send a team slack message\n  }\n).init();\n\nawait migrateToLatest(app._.db, false);\nawait app._.vector_store?.createVectorIndex();\n\nhttp\n.createServer(app.handler)\n.listen(\n  8000,\n  () => {\n    app.print_banner('http:\u002F\u002Flocalhost:8000');\n  }\n); \n\n```\n\n**Will produce** a server\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_89a7ad3f1b61.png' \n      width='90%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# Chat with the `storeraft` AI agent\n\nLocated at `\u002Fchat`\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_c2b4f8d9e1cd.gif' \n      style=\"margin: auto\"\n      width='500px' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_6bb3abf72597.gif' \n      style=\"margin: auto\"\n      width='500px' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# Dashboard\n\nLocated at `\u002Fdashboard`\n\n\u003Cdiv style='text-align: center'>\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_767f5aba7662.png' \n      width='100%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# API Reference\n\nLocated at `\u002Fapi` (powered by [Scalar](https:\u002F\u002Fscalar.com))\n\n\n\u003Cdiv style='text-align: center'>\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_bf68ec6b7e7c.png' \n      width='100%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# CLI (npx storecraft create)\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_e690478a0c1e.gif' \n      width='80%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# As seen on MongoDB TV stream\n\n[![Watch on Youtube](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_eaba80687021.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=OO4arXfO75U)\n\n\n# Dvelopment\n\nThis is a mono repo, where each folder in the `packages` folder is a package, that is published `@npm`.\n\nIt leverages the workspace feature of `npm`\n\nTo start developing a feature first\n\n```bash\nnpm install\n```\n\nThe following is the layout of the packages\n\n### Core ([@storecraft\u002Fcore](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002F))\n\nThe core engine of storecraft\n- core types\n- core API\n- core database types\n- core crypto types\n- core storage types\n- core mailer types\n- core payments types\n- core platform types\n- core VQL types and logic\n- core REST API controller\n\n### 🌐 Platforms [@storecraft\u002Fcore\u002Fplatform](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002Fplatform)\n\nSupport for \n- Node\n- Deno\n- Bun\n- Cloudflare workers\n- AWS Lambda\n- Azure Functions\n- Google Functions\n\n### 💾 Databases\n\nSupport for \n- MongoDB ([@storecraft\u002Fdatabase-mongo-node](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-mongodb\u002F))\n- SQLite ([@storecraft\u002Fdatabase-sqlite](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-sqlite\u002F))\n- Postgres ([@storecraft\u002Fdatabase-postgres](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-postgres\u002F))\n- MySQL ([@storecraft\u002Fdatabase-mysql](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-mysql\u002F))\n- SQL Base ([@storecraft\u002Fdatabase-sql-base](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-sql-base\u002F))\n- Neon (Cloud Postgres, [@storecraft\u002Fdatabase-neon](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-neon\u002F))\n- PlanetScale (Cloud Mysql, [@storecraft\u002Fdatabase-planetscale](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-planetscale\u002F))\n- Turso \u002F Libsql (Local and Cloud Sqlite, [@storecraft\u002Fdatabase-turso](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-turso\u002F))\n- D1 (Cloud Sqlite, [@storecraft\u002Fdatabase-cloudflare-d1](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-cloudflare-d1\u002F))\n\n### 📦 Storage\nSupport for,\n- Local storage (Node, Bun, Deno), [@storecraft\u002Fcore\u002Fstorage](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002Fstorage\u002F)\n- S3 Compatible ([@storecraft\u002Fstorage-s3-compatible](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fstorage\u002Fstorage-s3-compatible\u002F))\n  - Cloudflare R2\n  - AWS S3\n  - DigitalOcean Spaces\n  - MinIO\n- Google Storage ([@storecraft\u002Fstorage-google](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fstorage\u002Fstorage-google\u002F))\n\n### 📧 Email Providers\n- Http Mail services [@storecraft\u002Fmailer-providers-http](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fmailers\u002Fmailer-providers-http\u002F) \n  - mailchimp support\n  - mailgun support\n  - resend support\n  - sendgrid support\n- node smtp support [@storecraft\u002Fmailer-smtp](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fmailers\u002Fmailer-smtp\u002F)\n\n### 💳 Payments \n\n- Stripe [@storecraft\u002Fpayments-stripe](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fpayments\u002Fpayments-stripe\u002F)\n- Paypal [@storecraft\u002Fpayments-paypal](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fpayments\u002Fpayments-paypal\u002F)\n- You can roll your own (guide [here](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fcheckout-and-payments\u002Froll-your-own))\n\n### Dashboard\n\nThe official dashboard\n- Learn how to use [here](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fdashboard\u002Foverview)\n- The [code](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdashboard\u002F), \n  - mount as a component, or\n  - consume from cdn\n\n### Chat\n\nThe official Chat\n- Learn how to use [here](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fchat\u002Foverview)\n- The [code](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fchat\u002F), \n  - mount as a component, or\n  - consume from cdn\n\n### sdks\n\n- Universal (front\u002Fback) Javascript SDK, [@storecraft\u002Fsdk](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fsdk\u002F)\n- React Hooks SDK, [@storecraft\u002Fsdk-react-hooks](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fsdk-react-hooks\u002F)\n\n### Test Runner\n\nTest your app, database, storage and more integrations with\n\n[@storecraft\u002Fcore\u002Ftest-runner](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002Ftest-runner\u002F) \n\n### docs\n\nDocs website [code](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdocs\u002F)\n\n### CLI\n\n```bash\nnpx storecraft create\n```\n\nCLI [code](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcli\u002F)\n\n\n### Examples Playground\n\n[Here](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fplayground\u002F) \n\n### Releasing\n\nThe source of truth for the versioning and publishing is the mono-repo version.\nAll the published packages are synced to the mono-repo version. Packages in\nthe mono-repo source code might have different versions but it doesn't matter\nfor the published packages.\n\n#### Versioning\n\nAll versions are synced to the mono-repo version, and are published to npm.\nEach of the commands:\n\n```bash\nnpm run release:version:patch\nnpm run release:version:minor\nnpm run release:version:major\n```\n\nWill,\n\n- Only update the version of the mono-repo.\n- Add a git tag of the version.\n\n#### Publishing\n\nWhen running the command: \n\n```bash\nnpm run release:publish\n```\n\nIt will,\n\n- Update the version of all the packages in the mono-repo to the same version as the mono-repo.\n- Publish all the packages to `npm` with the same version as the mono-repo.\n\n> This can be done in a CI\u002FCD pipeline, or manually.\n\n```text\n\nAuthor: Tomer Shalev (tomer.shalev@gmail.com)\n```\n","\u003Cdiv style=\"text-align:center\">\n  \u003Cdiv width=\"90%\">\n    \u003Cimg src='https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fblob\u002Fmain\u002Fpackages\u002Fdocs\u002Fpublic\u002Fstorecraft-color.svg' \n        width='100%' \u002F>\n  \u003C\u002Fdiv>\n  使用 TypeScript 和 JavaScript 快速构建由 AI 驱动的无头电子商务后端！\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n![NPM 下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fd18m\u002F%40storecraft%2Fcore)\n\n[![Core](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.core.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.core.yml)\n[![MongoDB](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-mongodb.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-mongodb.yml)[![SQLite \u002F Postgres \u002F MySQL](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-sql.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.database-sql.yml)\n[![S3 兼容](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.storage-s3-compatible.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Factions\u002Fworkflows\u002Ftest.storage-s3-compatible.yml)\n\n[![what](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Furl?url=https%3A%2F%2Fx.com%2Fshalev_tomer&style=social&label=Storecraft)](https:\u002F\u002Fx.com\u002Fshalev_tomer)\n[![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinkedIn-0077B5?style=flat-square&logo=linkedin&link=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fstore-craft\n)](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fstore-craft)\n\n# The \u003Cimg src='https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fblob\u002Fmain\u002Fpackages\u002Fdocs\u002Fpublic\u002Fstorecraft-color.svg' height='24px' style=\"transform: translateY(4px);\" \u002F> 单体仓库\n\n嗨 👋，`Storecraft` 让开发者能够使用 TypeScript 和 JavaScript 快速构建由 AI 驱动的无头电子商务后端。\n\n⭐ 以 AI 为先，具备代理功能、聊天端点和相似性搜索，可为您的客户及团队提供服务。我们支持大多数流行的 LLM 和用于相似性搜索的向量存储。\n\n⭐ 通过强大的可编程 API 代码、REST API 和 VQL（虚拟查询语言）来管理产品、系列、订单、客户、认证、邮件等，并实现强大的查询与相似性搜索。\n\n⭐ 内置聊天端点，配备代理功能，可为客户提供购物车、结账等服务，并支持 PayPal 和 Stripe 支付。\n\n⭐ 可在任何 JavaScript [平台](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fplatforms\u002Fnode) 上运行（Deno、Bun、Node、Cloudflare Workers、AWS Lambda、Google Functions 等），无论是无服务器还是传统服务器架构。\n\n⭐ 可连接到任何 [数据库](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fdatabases\u002Fsqlite)（Mongo、LibSQL、SQLite、PostgreSQL、MySQL、Neon、Turso、D1、PlanetScale 等）。\n\n⭐ 支持多种 [存储](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fstorage\u002Fs3) 方式（本地存储、R2、S3 兼容存储、Google 存储等）。\n\n⭐ 具有 [可扩展性和模块化](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fextensions\u002Foverview) 特性。\n\n⭐ 基于 [事件驱动](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fevents) 架构。\n\n⭐ 拥有官方 [仪表板](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fdashboard\u002Foverview)。\n\n⭐ 文档完善 [REST-API](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Frest-api\u002Fapi)（也可在 `\u002Fapi\u002Freference` 端点中找到）。\n\n\u003Chr\u002F>\n\n## **立即使用 CLI 开始** 👇\n\n```bash\nnpx storecraft create\n```\n\n这是您开始构建自己的 Storecraft 应用所需的全部代码。\n\n```js\nconst app = new App({\n  auth_admins_emails: ['tomer.shalev@gmail.com'],\n  general_store_name: 'Wush Wush Games',\n  \u002F\u002F ... 更多必填配置\n})\n.withPlatform(new NodePlatform())\n.withDatabase(new LibSQL())\n.withStorage(new NodeLocalStorage('storage'))\n.withMailer(new Resend())\n.withPaymentGateways({\n  paypal: new Paypal({ env: 'test' }),\n  stripe: new Stripe(),\n  dummy_payments: new DummyPayments(),\n})\n.withExtensions({\n  postman: new PostmanExtension(),\n})\n.withAI(\n  new OpenAI({ model: 'gpt-4o-mini'})\n)\n.withVectorStore(\n  new LibSQLVectorStore({\n    embedder: new OpenAIEmbedder(),\n  })\n)\n.withAuthProviders({\n  google: new GoogleAuth(),\n})\n.on(\n  'order\u002Fcheckout\u002Fcomplete',\n  async (event) => {\n    \u002F\u002F 发送团队 Slack 消息\n  }\n).init();\n\nawait migrateToLatest(app._.db, false);\nawait app._.vector_store?.createVectorIndex();\n\nhttp\n.createServer(app.handler)\n.listen(\n  8000,\n  () => {\n    app.print_banner('http:\u002F\u002Flocalhost:8000');\n  }\n); \n\n```\n\n**将生成**一个服务器\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_89a7ad3f1b61.png' \n      width='90%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# 与 `storeraft` AI 代理聊天\n\n位于 `\u002Fchat`\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_c2b4f8d9e1cd.gif' \n      style=\"margin: auto\"\n      width='500px' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_6bb3abf72597.gif' \n      style=\"margin: auto\"\n      width='500px' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# 仪表板\n\n位于 `\u002Fdashboard`\n\n\u003Cdiv style='text-align: center'>\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_767f5aba7662.png' \n      width='100%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# API 参考\n\n位于 `\u002Fapi`（由 [Scalar](https:\u002F\u002Fscalar.com) 提供支持）\n\n\u003Cdiv style='text-align: center'>\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_bf68ec6b7e7c.png' \n      width='100%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# CLI（npx storecraft create）\n\n\u003Cdiv style='text-align: center' align=\"center\">\n  \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_e690478a0c1e.gif' \n      width='80%' \u002F>\n\u003C\u002Fdiv>\u003Chr\u002F>\u003Cbr\u002F>\n\n# 如 MongoDB TV 直播所示\n\n[![在 YouTube 上观看](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_readme_eaba80687021.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=OO4arXfO75U)\n\n\n# 开发\n\n这是一个单体仓库，`packages` 文件夹中的每个子文件夹都是一个独立的包，已发布至 `@npm`。它利用了 `npm` 的工作区功能。\n\n要开始开发某个功能，请先执行以下命令：\n\n```bash\nnpm install\n```\n\n以下是各包的布局：\n\n### Core ([@storecraft\u002Fcore](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002F))\n\nStorecraft 的核心引擎\n- 核心类型\n- 核心 API\n- 核心数据库类型\n- 核心加密类型\n- 核心存储类型\n- 核心邮件类型\n- 核心支付类型\n- 核心平台类型\n- 核心 VQL 类型及逻辑\n- 核心 REST API 控制器\n\n### 🌐 平台 [@storecraft\u002Fcore\u002Fplatform](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002Fplatform)\n\n支持：\n- Node\n- Deno\n- Bun\n- Cloudflare Workers\n- AWS Lambda\n- Azure Functions\n- Google Functions\n\n### 💾 数据库\n\n支持：\n- MongoDB（[@storecraft\u002Fdatabase-mongo-node](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-mongodb\u002F)）\n- SQLite（[@storecraft\u002Fdatabase-sqlite](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-sqlite\u002F)）\n- Postgres（[@storecraft\u002Fdatabase-postgres](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-postgres\u002F)）\n- MySQL（[@storecraft\u002Fdatabase-mysql](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-mysql\u002F)）\n- SQL Base（[@storecraft\u002Fdatabase-sql-base](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-sql-base\u002F)）\n- Neon（云Postgres，[@storecraft\u002Fdatabase-neon](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-neon\u002F)）\n- PlanetScale（云MySQL，[@storecraft\u002Fdatabase-planetscale](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-planetscale\u002F)）\n- Turso \u002F Libsql（本地及云SQLite，[@storecraft\u002Fdatabase-turso](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-turso\u002F)）\n- D1（云SQLite，[@storecraft\u002Fdatabase-cloudflare-d1](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdatabases\u002Fdatabase-cloudflare-d1\u002F)）\n\n### 📦 存储\n\n支持：\n- 本地存储（Node、Bun、Deno），[@storecraft\u002Fcore\u002Fstorage](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002Fstorage\u002F)\n- S3 兼容存储（[@storecraft\u002Fstorage-s3-compatible](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fstorage\u002Fstorage-s3-compatible\u002F)）\n  - Cloudflare R2\n  - AWS S3\n  - DigitalOcean Spaces\n  - MinIO\n- Google Storage（[@storecraft\u002Fstorage-google](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fstorage\u002Fstorage-google\u002F)）\n\n### 📧 邮件服务提供商\n\n- HTTP 邮件服务 [@storecraft\u002Fmailer-providers-http](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fmailers\u002Fmailer-providers-http\u002F)\n  - 支持 Mailchimp\n  - 支持 Mailgun\n  - 支持 Resend\n  - 支持 Sendgrid\n- Node SMTP 支持 [@storecraft\u002Fmailer-smtp](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fmailers\u002Fmailer-smtp\u002F)\n\n### 💳 支付\n\n- Stripe [@storecraft\u002Fpayments-stripe](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fpayments\u002Fpayments-stripe\u002F)\n- PayPal [@storecraft\u002Fpayments-paypal](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fpayments\u002Fpayments-paypal\u002F)\n- 您也可以自行实现（指南 [在此](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fbackend\u002Fcheckout-and-payments\u002Froll-your-own)）\n\n### 控制台\n\n官方控制台\n- 使用方法 [在此](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fdashboard\u002Foverview)\n- 源码 [在此](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdashboard\u002F)，\n  - 可作为组件挂载，或\n  - 通过 CDN 引用\n\n### 聊天\n\n官方聊天功能\n- 使用方法 [在此](https:\u002F\u002Fstorecraft.app\u002Fdocs\u002Fchat\u002Foverview)\n- 源码 [在此](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fchat\u002F)，\n  - 可作为组件挂载，或\n  - 通过 CDN 引用\n\n### SDKs\n\n- 通用（前后端）JavaScript SDK，[@storecraft\u002Fsdk](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fsdk\u002F)\n- React Hooks SDK，[@storecraft\u002Fsdk-react-hooks](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fsdk-react-hooks\u002F)\n\n### 测试运行器\n\n使用以下工具测试您的应用、数据库、存储及其他集成：\n\n[@storecraft\u002Fcore\u002Ftest-runner](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcore\u002Ftest-runner\u002F)\n\n### 文档\n\n文档网站源码 [在此](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fdocs\u002F)\n\n### CLI\n\n```bash\nnpx storecraft create\n```\n\nCLI 源码 [在此](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fcli\u002F)\n\n### 示例游乐场\n\n[在此](https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Ftree\u002Fmain\u002Fpackages\u002Fplayground\u002F)\n\n### 发布流程\n\n版本管理和发布以 monorepo 版本为准。所有已发布的包都会同步到 monorepo 版本。monorepo 源代码中的包可能版本不同，但这对已发布的包没有影响。\n\n#### 版本管理\n\n所有版本都会同步到 monorepo 版本，并发布到 npm。执行以下命令之一：\n\n```bash\nnpm run release:version:patch\nnpm run release:version:minor\nnpm run release:version:major\n```\n\n这些命令将：\n\n- 仅更新 monorepo 的版本号；\n- 添加对应版本的 Git 标签。\n\n#### 发布\n\n当运行以下命令时：\n\n```bash\nnpm run release:publish\n```\n\n它会：\n\n- 将 monorepo 中所有包的版本更新为与 monorepo 相同的版本；\n- 将所有包以与 monorepo 相同的版本发布到 npm。\n\n> 这一过程可以在 CI\u002FCD 流水线中自动完成，也可手动操作。\n\n```text\n作者：托梅尔·沙列夫（tomer.shalev@gmail.com）\n```","# Storecraft 快速上手指南\n\nStorecraft 是一个基于 TypeScript\u002FJavaScript 的无头（Headless）电商后端框架，主打 AI 优先架构。它支持快速构建具备智能客服、相似性搜索、全渠道支付及多数据库适配能力的电商系统。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: Windows, macOS 或 Linux\n*   **运行时环境**: 需安装以下任一 JavaScript\u002FTypeScript 运行时：\n    *   Node.js (推荐 LTS 版本)\n    *   Bun\n    *   Deno\n    *   Cloudflare Workers 环境\n*   **包管理器**: npm, yarn, pnpm 或 bun\n*   **前置知识**: 熟悉 TypeScript 或 JavaScript 基础语法\n\n> **提示**：虽然原文未提及国内镜像，但在中国大陆开发时，建议配置 `npm` 镜像源（如淘宝镜像）以加速依赖下载：\n> ```bash\n> npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 安装步骤\n\nStorecraft 提供了命令行工具（CLI）来快速初始化项目。\n\n1.  **创建新项目**\n    在终端中运行以下命令，按照提示完成项目初始化：\n\n    ```bash\n    npx storecraft create\n    ```\n\n2.  **安装依赖**\n    进入生成的项目目录并安装依赖（如果 CLI 未自动执行）：\n\n    ```bash\n    npm install\n    ```\n\n## 基本使用\n\nStorecraft 的核心在于通过代码配置应用实例。以下是一个最小化的服务端启动示例，展示了如何配置平台、数据库、存储、支付网关及 AI 功能。\n\n创建一个入口文件（例如 `index.ts` 或 `server.ts`），填入以下代码：\n\n```js\nconst app = new App({\n  auth_admins_emails: ['tomer.shalev@gmail.com'],\n  general_store_name: 'Wush Wush Games',\n  \u002F\u002F ... MORE Mandatory CONFIG\n})\n.withPlatform(new NodePlatform())\n.withDatabase(new LibSQL())\n.withStorage(new NodeLocalStorage('storage'))\n.withMailer(new Resend())\n.withPaymentGateways({\n  paypal: new Paypal({ env: 'test' }),\n  stripe: new Stripe(),\n  dummy_payments: new DummyPayments(),\n})\n.withExtensions({\n  postman: new PostmanExtension(),\n})\n.withAI(\n  new OpenAI({ model: 'gpt-4o-mini'})\n)\n.withVectorStore(\n  new LibSQLVectorStore({\n    embedder: new OpenAIEmbedder(),\n  })\n)\n.withAuthProviders({\n  google: new GoogleAuth(),\n})\n.on(\n  'order\u002Fcheckout\u002Fcomplete',\n  async (event) => {\n    \u002F\u002F send a team slack message\n  }\n).init();\n\nawait migrateToLatest(app._.db, false);\nawait app._.vector_store?.createVectorIndex();\n\nhttp\n.createServer(app.handler)\n.listen(\n  8000,\n  () => {\n    app.print_banner('http:\u002F\u002Flocalhost:8000');\n  }\n); \n```\n\n### 启动服务\n\n运行上述代码后，您将启动一个本地服务器。终端将输出类似以下的信息，并显示访问地址：\n\n*   **后端 API**: `http:\u002F\u002Flocalhost:8000\u002Fapi` (查看 REST API 文档)\n*   **管理后台**: `http:\u002F\u002Flocalhost:8000\u002Fdashboard`\n*   **AI 客服聊天**: `http:\u002F\u002Flocalhost:8000\u002Fchat`\n\n### 核心功能概览\n\n*   **AI 智能体**: 内置 `\u002Fchat` 端点，支持连接主流 LLM（如 OpenAI），可处理购物车、结账咨询及商品相似性搜索。\n*   **多数据库支持**: 示例中使用的是 `LibSQL`，您也可轻松切换至 MongoDB, PostgreSQL, MySQL, Neon, Turso 等。\n*   **支付集成**: 已预配置 Stripe 和 PayPal，支持测试环境。\n*   **事件驱动**: 通过 `.on()` 方法监听业务事件（如订单完成），轻松扩展业务逻辑（如发送 Slack 通知）。","一家初创游戏周边电商团队急需在两周内上线支持 AI 客服和个性化推荐的独立站后端，但后端开发人力严重不足。\n\n### 没有 storecraft 时\n- 开发者需手动搭建复杂的无头电商架构，从零编写商品、订单及用户管理的 REST API，耗时数周。\n- 实现智能客服和相似商品推荐需要单独集成向量数据库与大模型，技术栈割裂且调试困难。\n- 对接 Stripe 或 PayPal 支付网关需处理繁琐的安全认证与回调逻辑，容易引入安全漏洞。\n- 不同部署环境（如 Node.js 或 Cloudflare Workers）需要重复适配代码，维护成本极高。\n- 缺乏统一的事件系统，订单完成后的通知（如发送 Slack 消息）需硬编码耦合在业务逻辑中。\n\n### 使用 storecraft 后\n- 通过一行 CLI 命令即可生成包含完整商品、订单及权限管理的 TypeScript 后端，核心功能当天可用。\n- 内置 AI Agent 与向量搜索模块，配置 OpenAI 密钥后即刻拥有能处理购物车查询的智能客服和推荐引擎。\n- 原生支持 Stripe 和 PayPal 插件，只需简单配置环境变量即可安全处理支付流程，无需关注底层细节。\n- 基于模块化设计，同一套代码可无缝运行于 Node.js、Deno 或 Serverless 环境，灵活适配基础设施。\n- 利用事件驱动机制，轻松订阅 `order\u002Fcheckout\u002Fcomplete` 事件自动触发团队通知，业务扩展解耦且清晰。\n\nstorecraft 将原本需要一个月的全栈开发工作压缩至几天，让团队能专注于业务创新而非重复造轮子。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstore-craft_storecraft_e05c33e0.png","store-craft","Storecraft","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fstore-craft_65825303.png","Ai First Javascript Commerce as Code backend",null,"tomer.shalev@gmail.com","https:\u002F\u002Fstorecraft.app","https:\u002F\u002Fgithub.com\u002Fstore-craft",[83,87,91,95,99,103],{"name":84,"color":85,"percentage":86},"JavaScript","#f1e05a",62.6,{"name":88,"color":89,"percentage":90},"TypeScript","#3178c6",29.3,{"name":92,"color":93,"percentage":94},"MDX","#fcb32c",6.3,{"name":96,"color":97,"percentage":98},"CSS","#663399",1.4,{"name":100,"color":101,"percentage":102},"PEG.js","#234d6b",0.2,{"name":104,"color":105,"percentage":106},"HTML","#e34c26",0.1,789,63,"2026-04-17T17:15:51","NOASSERTION","Linux, macOS, Windows","未说明",{"notes":114,"python":115,"dependencies":116},"这是一个基于 JavaScript\u002FTypeScript 的无头电商后端框架，非 Python AI 模型。支持多种运行时环境（Node.js, Deno, Bun, Cloudflare Workers, AWS Lambda 等）。需自行配置外部 AI 服务（如 OpenAI）和数据库。通过 npx storecraft create 命令初始化项目。","不需要 (基于 JavaScript\u002FTypeScript)",[117,118,119,120,121,122,123,124],"Node.js \u002F Deno \u002F Bun","@storecraft\u002Fcore","数据库驱动 (MongoDB, SQLite, Postgres, MySQL 等)","存储驱动 (S3, Local, Google Storage 等)","邮件服务 (Resend, SMTP 等)","支付网关 (Stripe, PayPal)","AI 提供商 (OpenAI 等)","向量存储 (LibSQL 等)",[35,14,13],[127,128,129,130],"ecommerce","ecommerce-platform","javascript","serverless","2026-03-27T02:49:30.150509","2026-04-18T09:22:16.736812",[134,139,144,149,154,159],{"id":135,"question_zh":136,"answer_zh":137,"source_url":138},39201,"运行 `npx storecraft create` 时提示找不到 'cli-spinners' 包怎么办？","这是一个依赖缺失的问题。维护者已修复并发布了新版本，请尝试更新。如果问题依旧，可以在报错路径显示的 npx 缓存目录中手动安装缺失的依赖。例如，进入报错路径中的 node_modules\u002Fstorecraft 上级目录，运行 `npm i cli-spinners`。建议直接使用最新版本的 storecraft 以避免此问题。","https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fissues\u002F74",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},39202,"执行命令时出现 \"SyntaxError: Unexpected token 'with'\" 错误如何解决？","这是因为当前的 Node.js 版本不支持 \"Import Attributes\"（导入属性）语法。该功能需要较新的 Node.js 版本支持。请将 Node.js 升级到 v22 或更高版本，然后重新运行命令即可解决。","https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fissues\u002F78",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},39203,"Stripe 结账时报错 \"app.gateway is not a function\" 是什么原因？","这通常是由于事件处理逻辑中的 bug 导致的，特别是当 Webhook 接收到不支持的事件类型（如 `payment_intent.created`）时。维护者已在新版本中修复了此问题，增加了对未知事件的更好处理和日志记录。请运行 `npm update` 更新到最新版本即可解决。","https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fissues\u002F97",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},39204,"运行迁移命令时遇到 \"not authorized: SQLITE_AUTH\" 错误怎么办？","这通常是因为核心包（core package）版本过旧导致的兼容性问题。请检查 `package.json`，确保 `@storecraft\u002Fcore` 至少为 `1.0.41`，`@storecraft\u002Fdatabase-cloudflare-d1` 至少为 `1.0.14`。运行 `npm update` 或使用 `npx storecraft create` 创建新项目以获取最新的迁移工具，新版本不仅修复了权限问题，还将迁移速度显著提升。","https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fissues\u002F93",{"id":155,"question_zh":156,"answer_zh":157,"source_url":158},39205,"运行项目时提示找不到 'better-sqlite3' 包如何处理？","虽然具体评论被截断，但此类错误通常发生在本地开发环境缺少必要的原生依赖时。如果是本地运行迁移或测试需要 SQLite，请确保安装了构建工具（如 Python 和 C++ 编译器），或者直接安装该依赖：`npm install better-sqlite3`。如果在 Cloudflare Workers 环境下，请确认是否错误地在本地而非 D1 数据库中执行了操作。","https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fissues\u002F77",{"id":160,"question_zh":161,"answer_zh":162,"source_url":163},39206,"README 文档中的 Scalar API 参考链接失效了怎么办？","这是一个文档链接错误。正确的 API 参考地址位于 `\u002Fapi\u002Freference`，其官方链接应指向 `https:\u002F\u002Fscalar.com` 而不是 GitHub 仓库内的相对路径。如果您在查看源码，可以将链接修正为官方地址；如果是项目维护者，通常会接受 PR 来修复此链接。","https:\u002F\u002Fgithub.com\u002Fstore-craft\u002Fstorecraft\u002Fissues\u002F79",[]]