open-mercato

让 AI 编码助手直接产出生产级架构，不用反复改代码

open-mercato 是一个面向 AI 编程时代的应用基础框架，用 TypeScript 和 Next.js 构建。它解决的核心问题是：当使用 Cursor、Claude Code 等 AI 编程工具开发复杂业务系统时，架构决策往往重复且易出错。该项目将多租户、RBAC 权限、事件流、定价计费、销售管道、CRM/ERP 流程等数百个架构和领域决策，预先固化为约定和规范。AI 代理在编码时可直接遵循这些内置约定，无需重新设计轮子，从而大幅提升开发效率和代码质量。它本质上是把资深架构师的经验编译成 AI 可读的规则集，让 AI 生成的代码天然具备生产级水准，支持自托管和后台管理面板，适合需要快速构建复杂业务系统的团队。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1766

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队open-mercato

所属国家

官网地址https://www.openmercato.com

GitHubhttps://github.com/open-mercato/open-mercato

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型admin-panel,agentic,ai-agents,ai-coding,crm,erp,framework,nextjs,open-source,self-hosted,typescript

GitHub 星标★ 1766

30天Star增速

HF 下载量

上线时间2025-09-10 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：进阶约 30 分钟部署方式：本地安装 7 步

环境要求

Node.js 24（官方要求 24 版本）
Git
PostgreSQL 与 Redis（最简单的方式是用 Docker Desktop 启动）
Docker Desktop（提供 docker compose 命令）

安装与启动步骤

1安装前置依赖

先装 Node.js 24、Git 和 Docker Desktop，装完重开一个终端，确保 node、git、docker 命令可用。
2启用 Corepack 与 Yarn

Windows 需先放开执行策略，再用 Corepack 激活 README 指定的 Yarn 4.12.0 版本。
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
corepack enable; corepack prepare yarn@4.12.0 --activate
```
3克隆仓库并切分支

拉取 open-mercato 源码，进入目录后切到 develop 分支（README 的快速开始就是这个分支）。
```
git clone https://github.com/open-mercato/open-mercato.git
cd open-mercato
git checkout develop
```
4启动数据库与缓存

用仓库自带的 docker compose 一键拉起 PostgreSQL 和 Redis，也可改用本机原生安装。
```
docker compose up -d
```
5复制环境变量文件

把示例环境文件复制成实际使用的 .env，后续配置项都改在这个文件里。
```
Copy-Item appsmercato.env.example appsmercato.env
```
6启动开发服务

在仓库根目录运行开发模式，它会监听各 workspace 包并在启动时打印当前监听模式。
```
yarn dev
```
7可选：新建独立应用

不想改 monorepo 的话，可用脚手架生成自己的应用目录，再单独起容器和开发服务。
```
npx create-mercato-app my-app
cd my-app
docker compose up -d
```

关键配置

配置项	必填	说明	示例
`apps/mercato/.env`	是	应用运行环境变量，由仓库自带的 .env.example 复制而来	`apps/mercato/.env`
`--database-name`	否	给 yarn dev/setup 传数据库名覆盖值，用于多个本地实例共用同一 PostgreSQL	`review_1720`
`--no-update-env`	否	单次运行时不写入 .env，只对当前子进程生效	`--no-update-env`

如何确认成功

docker compose ps 显示 PostgreSQL、Redis 容器正常运行，且 yarn dev 启动后终端无报错。

常见问题

Q：必须自己装 PostgreSQL 和 Redis 吗？

A：不是。README 推荐用 Docker Desktop 配合 docker compose up -d 一键启动，也可以用原生 PostgreSQL + pgAdmin 自行安装。

Q：对 Node.js 版本有要求吗？

A：有，README 明确要求 Node.js 24；同时 Yarn 需通过 Corepack 激活到 4.12.0 版本。

Q：想同时跑两个长期运行的本地实例怎么办？

A：给 yarn dev、yarn dev:greenfield 或 yarn setup 加 --database-name 覆盖数据库名，例如 yarn dev --database-name=review_1720 --no-update-env，不会改动 .env。

Q：开发模式内存占用偏高怎么缓解？

A：yarn dev 默认监听所有 workspace 包，包越多内存越高，可以缩小监听范围只保留常改的包，当前模式启动时会带 emoji 打印出来。

注意事项

README 的快速开始命令是 Windows PowerShell 写法（Copy-Item、Set-ExecutionPolicy），macOS/Linux 需换成对应的 cp 等命令。
Docker 开发环境、VPS 生产部署、Dev Container、Railway 一键云部署均有独立文档，见 docs.openmercato.com 对应安装章节。
仓库分为 monorepo（核心开发/完整示例）与 create-mercato-app 脚手架两条路径，按需选择其一。
不要使用 README 未给出的端口、路径或包名，遇到问题优先查官网安装文档。

核心亮点

内置多租户、RBAC、计费、CRM/ERP 等数百个架构决策，AI 生成代码直接符合生产标准
针对 Cursor、Claude Code 等主流 AI 编程工具深度优化，减少无效代码生成
基于 Next.js 和 TypeScript 全栈实现，支持自托管，数据完全可控

不足之处

项目较新，文档和社区生态仍在建设中
框架约定较强，对非标准业务场景的灵活性可能受限

适用场景

用 AI 编程工具快速搭建 SaaS 产品的 MVP 到生产版本
企业内部系统开发，需要统一权限、多租户和业务流程规范
作为 AI 编码工作流的基础脚手架，减少架构评审和返工成本

替代项目

create-t3-app、Supabase、Crystallize

项目介绍

open-mercato 是开发框架领域的开源项目，由 open-mercato 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,766）位列前 30%，在开发框架分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,623 增加到 1,766，净增 143。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：用AI编程工具快速搭建SaaS产品的MVP到生产版本。同类可对比的替代方案包括 create-t3-app、Supabase、Crystallize。

上一篇：WFGY

下一篇：ai