Skip to content

Kaiwu · 开物载道 v0.3.0 · Apache-2.0 开源

让产品用 AI 直出前端,让代码与交付始终可控。

产品即前端,后端接完联调上线;独立业务仓与随仓门禁,换人换工具都能接手,企业能力由平台承载。

Kaiwu 解决企业 AI 开发的两个核心难题:一是产品即前端,产品经理无需先装平台或后端,直接用 AI 在 kaiwu-web-starter 或生成前端仓做出带模拟身份与规则验收的正式 React 前端,经 project adopt 纳管与 Git 交接后,后端接上 Spring Boot 接口即可上线,不再重敲前端;二是开发可控,每个业务交付为独立前后端仓,自带 AGENTS.md、模块契约、规则场景与 verify 门禁,换人或换 AI 工具都能稳定接手。

  • 产品即前端 · 零重写交接从起步仓直出内置 Mock 演示到纳管联调,同一套 React 仓直达生产
  • 开发可控 · 换人换工具可接手小上下文独立仓 + 规则场景门禁 + 行级数据范围校验,换人换模型不漂移
  • 薄平台 · 企业级底座与移交统一鉴权、跨环境配置移交、STS 对象存储、统一待办与达梦 DM8,业务 100% 独立
工作台同一账号进入所有已授权业务应用,集中处理跨项目待办与站内通知
DESIGN PHILOSOPHY · 开物载道的设计主张

为什么做“薄平台底座 + 独立业务仓”?

企业开发多个业务后台时,往往困在两个极端:要么背负沉重的单体大平台与低代码黑盒,要么靠复制脚手架和 AI 自由发挥导致每个项目各自漂移。Kaiwu 用三条明确的边界化解这一矛盾。

01边界清晰 · 拒绝绑架

共享企业治理,但业务项目 100% 独立

常见困境:大平台或全量脚手架把所有公共模块与业务混在同一工程,升级底座怕覆盖业务,改业务又反向拖住平台。

Kaiwu 理念:统一网关、单点登录、成员角色、字典、国际化与待办由平台集中承载;每个业务应用只由项目工厂生成或纳管一次,交付为独立前后端 Git 仓 + 独立数据库,随时可独立演进、独立部署。

02AI 可选 · 确定性交付

AI 负责受控蓝图,模板负责确定性工程

常见困境:让大模型直接从零写整套工程,虽然能跑通页面,却常漏掉权限校验、Flyway 迁移、安全审计与发布契约。

Kaiwu 理念:把 AI 放在前端交互、受校验蓝图或单仓功能迭代上,而工程目录、@/kaiwu 接入层、鉴权校验与 CI 骨架由版本化模板确定性渲染。不用 AI 也可一键生成标准空脚手架。

03小上下文 · 可执行门禁

把开发规范变成随仓运行的校验脚本

常见困境:巨型仓库超出 AI 上下文窗口,检索面过大导致改一处漏一处;口头约定在换人或换模型后迅速失效。

Kaiwu 理念:每个业务仓聚焦单一业务域,并内置 AGENTS.md、verify:mock 与 verify.sh 门禁。后端注解、前端校验与 menus.yml 权限码三端同码,规则与场景双向绑定,缺失即报错。

PRODUCT-LED FRONTEND · 同一套前端,从无平台演示直达上线

产品做的页面就是正式前端,不再画完原型重敲一遍

产品经理无需先装平台或后端,直接用 AI 在前端起步仓做出可切角色试用的正式页面;确认后通过 Git 交接并纳管生成配套后端,全程留在同一个前端仓库。

产品经理 + AI · 零平台模拟在正式前端仓直出多角色演示

用 AI 拉取前端起步仓直接生成页面或双人预约示例,本机启动即可切换不同身份点开试用并随时重置演示数据,不依赖平台、容器或数据库。

Git 交接 · 规则与清单随仓在产品分支固化契约并交接

在同一个前端仓库保存页面、接口类型、菜单权限清单、规则编号与验收场景,验收后发起交接合并请求,不靠口头传达和截图对齐。

后端工程师 + AI · 纳管与联调一键纳管生成后端,同一前端上线

后端执行一条纳管命令登记项目并生成配套服务;接口写完后连本地网关复验全部验收场景,生产构建自动剔除模拟路由与假数据。

零平台内置模拟运行时开箱演示

内置开发态拦截与角色切换面板,未注册接口会明确提示兜底;产品本机只装基础前端环境即可运行,且不会混入生产构建包。

无头接入层与界面自由替换UI 可换

登录、权限校验、字典与请求封装收拢在带完整性保护的接入层中;只换组件库或整套视觉皮肤,完全不伤业务逻辑与鉴权链路。

规则编号与验收场景双向门禁随仓门禁

提交前自动核对规则文档、菜单权限清单、模拟实现与自动化场景测试是否一致,防止后端接手时漏掉边界阈值或越权检查。

纳管自动建项与分支协作闭环同仓交付

纳管时自动登记前端并同步菜单、角色与配套后端仓;研发保留已验收界面仅微调联调,上线后的交互修正也可顺畅回流产品分支。

从起步仓启动并纳管 → · 查看完整产品交接与联调流程 →

AGENT-LED ONBOARDING · 一句话启动全流程

把这句话交给你的 AI Agent

根据当前角色选择一条起步提示词,复制给能使用本机终端的 AI 编码工具(Claude Code、Codex、Cursor、Trae 等)。

模式一:产品先出前端(无需启动 Kaiwu 平台)仅需 Git + Node 22 + pnpm 10 · 自动拉取起步仓跑起演示
text
从 https://github.com/kaiwuzaidao/kaiwu-web-starter 获取 Kaiwu 前端起步仓最新稳定版(如 v0.3.0),按仓库内 AGENTS.md 初始化我的业务前端项目,帮我做一个设备预约前端:让员工能看到会议室投影仪的空闲时段,选时间预约或取消自己的预约,两个人选到同一时段时让后提交的人看得懂出了什么问题。用内置 Mock 跑起来给我本地可点的地址。
1. 拉取起步仓并建仓Agent 从 GitHub 拉取最新稳定版起步仓,按 AGENTS.md 初始化
2. 本地多角色演示启动后可在内置面板切换不同角色试操作,并自动写好规则与场景
3. 验收交接与纳管确认页面与规则后发起交接,研发执行纳管即可生成配套后端联调
模式二:启动平台并建双仓(完整底座起步)需 Docker Compose v2 · 自动拉取稳定版并生成前后端
text
从 https://github.com/kaiwuzaidao/kaiwu 获取 Kaiwu 最新稳定版,按 AGENTS.md 在本机启动。问我想开发什么项目,再按我的回答准备前后端。
1. 自动准备底座Agent 按 AGENTS.md 在本机检查环境并启动 Kaiwu
2. 按需生成双仓询问你想做什么业务,生成并拉取独立的前后端 Git 仓库
3. 人类确认关键授权账号登录与配置写入由你确认,所有改动清晰可查

已经有项目了?使用已有项目的开发提示词 →

查看 Agent 在幕后执行的 CLI 命令(两种起步方式均可手动执行)

左栏为产品先做前端再纳管生成后端,右栏为从已运行平台直接创建并同步双仓:

1. 起步仓直出 Mock,再纳管生成后端

产品先在 kaiwu-web-starter 初始化项目并演示;开发在入口仓登录,预览并纳管前端,同步清单后只取回配套后端,再用 pnpm dev:real 联调。

node scripts/kaiwu-init.mjs --code booking --name 设备预约
cd ../booking-web && pnpm install --frozen-lockfile && pnpm dev
# 交接后在入口仓纳管:
./kaiwu login --client "project-development"
./kaiwu project adopt ../booking-web
./kaiwu project adopt ../booking-web --apply

2. 从平台创建双仓、挂载并同步清单

已在入口仓启动平台时,可直接生成基础双仓并挂载到本机工作台;日常维护菜单、字典与参数先预览再加 --apply 写入。

./kaiwu login --client "project-development"
./kaiwu project new inventory --name "库存管理"
./kaiwu project status inventory --wait
./kaiwu project pull inventory
./kaiwu project-up ../business/inventory-service ../business/inventory-web
./kaiwu project sync ../business/inventory-service

查看两种起步详细步骤 · 启动并登录 Kaiwu · 查看完整 CLI 命令 →

ARCHITECTURE & BOUNDARIES · 平台与业务解耦

一套企业底座,多个独立应用

从上往下看,工作台和业务前端的 API 请求都经过同一个网关。蓝色虚线标出新接入的库存项目,它与设备预约项目并列,拥有自己的前端仓、后端仓和数据库。

浏览器与前端

React · TypeScript · Umi Max · Ant Design
平台工作台kaiwu-system-web
已有项目 · 设备预约booking-web
新增项目 · 库存示例inventory-web
共享 API 网关kaiwu-gateway-service
Spring Cloud Gateway · WebFlux · Redis
平台控制面kaiwu-system-service成员、权限、项目工厂Spring Boot · MyBatis-Plus
平台数据库
已有项目 · 设备预约booking-service设备预约与取消Spring Boot · MyBatis-Plus接入 SDK · kaiwu-system-starter
预约数据库
新增项目 · 库存示例inventory-service入库与盘点Spring Boot · MyBatis-Plus接入 SDK · kaiwu-system-starter
库存数据库
产品经理和 AI 可从 kaiwu-web-starter 或项目工厂进入 inventory-web 完成页面与 Mock 演示;后端工程师沿用同一前端,经 project adopt 纳管后在 inventory-service 实现接口并写入库存库。图中数据库以 MySQL 为例。
kaiwu 入口与 CLI · 启动平台与纳管同步kaiwu-web-starter 产品前端起步仓 · 无平台直出 Mockkaiwu-deploy 可选部署仓 · Kubernetes / Argo CD

Kaiwu 共享平台底座(Control Plane & Starter SDK)

平台自身同样作为内置项目(project_code=system)运行,无特权旁路
身份、权限与行级数据范围单点登录与 60 秒签名 Context;kaiwu-data-scope 按角色 × 部门在 SQL 层自动过滤,为已声明的表补上 AI 开发容易漏掉的行级过滤
清单同步与跨环境配置移交kaiwu/*.yml 随仓同步;测试到生产导出 6 类配置快照,三方基线比对 diff 预览,授权按组确认、删除逐项勾选、新建定时任务默认停用
项目级引用式多语言与字典业务库只存稳定码值;引用式 i18n 按项目隔离,消除“双真相源”漂移且不同项目译文互不泄露
对象存储 (STS) 与安全 ExcelAK/SK 加密留平台,业务仅取前缀限定 STS 临时凭证;只存引用不固化 URL,保留旧绑定即可继续读取历史文件;安全 XLSX 读写防公式注入
统一待办、调度与达梦 DM8bizKey 幂等待办(或签/会签/逾期置顶)、可抢占租约调度;平台首次安装原生可选 MySQL 或达梦 DM8
受控项目 AI 助手PLAN / ANSWER 双模型路由;按成员权限与行级范围只读查询,写操作先预览冻结版本、用户确认后同事务幂等执行

以设备预约和库存为例,两者共用员工身份,再按项目分别授予角色与数据范围。组件随业务需要按需引入,团队自行决定每个服务如何部署。 查看请求与授权完整链路 →

APPROACH COMPARISON · 为什么不直接用脚手架或低代码?

上线第二个应用,哪些能力能直接沿用?

假设设备预约系统已经上线,现在要为同一批员工开发库存系统。员工沿用原账号,库存的盘点规则由业务团队自己定:

开发方式前端如何从原型到上线员工怎样进入库存系统盘点规则改在哪里、如何维护
推荐范式Kaiwu + AI 工具产品与 AI 先在 kaiwu-web-starter 或生成前端仓用内置 Mock 完成多角色演示与规则验收,经 project adopt 与 Git 交接后,后端接入 Spring Boot API 与 dev:real 联调上线,UI 库可换且生产剥离 Mock。库存接入同一网关,直接给已有员工分配库存项目的角色与行级数据范围(本人/部门),工作台自动出现新入口与统一待办。Agent 在库存项目独立的前后端仓库改代码,随仓校验通过后用 project sync 预览清单差异;测试到生产用跨环境移交包三方比对同步字典、菜单、角色与任务。
低代码平台在拖拽设计器里配置表单并直接发布,但复杂交互、自定义 UI 与跨系统前端代码复用受限于平台扩展边界。在同一平台建应用,通常可以沿用平台的账号和角色模型。在设计器里调整表单和流程。遇到复杂盘点逻辑、跨环境配置 diff 审计或深度定制时,受限于平台边界。
传统后台脚手架产品先画静态原型,专职前端再照图在复制工程里重敲一遍,接口字段与交互往往需反复对齐。复制一份新工程虽有登录代码,但两套系统要共用账号、待办与 STS 存储,仍需自行改造统一身份与凭证中心。在复制出的工程里改源码。第 1 个项目与第 5 个项目逐渐漂移,测试到生产的菜单、字典与角色变更常靠手工 SQL 对齐。
单独使用 AI 工具AI 能快速生成一次性前端 Demo,但缺少统一鉴权、权限/字典接入层与 Mock 隔离,交给后端后常需推倒重写。每次都要把已有的身份接口、令牌协议、行级数据权限和存储规则重新喂给 AI,或从头设计。AI 可以直接改源码,但权限三端一致性、行级 SQL 隔离、多环境配置移交和发布契约需要团队自行兜底。
CONTROLLABLE DELIVERY · 开发可控,换人换工具都能开发

把规范变成随仓门禁,换人换模型都不漂移

AI 写代码很快,但工程长期可维护需要可控边界。Kaiwu 把约定、规则与检查脚本放进业务仓库本身,让任何人、任何 AI 编码工具都能基于同一份事实接手开发、定位问题并通过门禁。

01

缩小 AI 需要阅读的上下文范围

项目工厂和起步仓交付独立的业务前后端。修改某个业务功能时,AI 编码工具只需读取该项目自己的页面、接口与迁移脚本,不会被无关项目干扰。

02

让规则与架构约定随仓交接

模块边界、AGENTS.md、business-rules.md、acceptance-scenarios.md 与清单全部保存在 Git 仓库里。换工程师或切换大模型,从当前提交就能读到同一份事实依据。

03

把契约与生产隔离写进构建门禁

前端 pnpm verify:mock 校验规则编号、场景、@/kaiwu 接入层与生产构建隔离;联调后 pnpm verify 与 verify.sh 核对三端权限与清单一致。

DEVELOPER HANDBOOK · 从安装到生产交付

开发手册

按实际开发任务组织的实操指南,每章包含前置条件、执行命令、预期结果与排错方法,同时向人类开发者与 AI 编码工具开放。

CLI 命令索引 · AI 阅读索引 (llms.txt) · 完整手册 Markdown · 仓库地图

Apache License 2.0