用模块契约
让 AI 高效开发
可部署应用
PloyKit使用模块契约约束边界,宿主能力承接通用逻辑。AI 只需要聚焦当前模块,就能生成页面、API、任务和数据结构,减少上下文消耗。
01import { defineModule } from '@ploykit/runtime';0203export default defineModule({04 id: 'cms',05 version: '1.0.0',06 permissions: ['read:posts', 'write:posts'],07 routes: [08 { method: 'get', path: '/posts', handler: 'listPosts' },09 { method: 'post', path: '/posts', handler: 'createPost' },10 ],11 jobs: [{ name: 'publish-render', schedule: '0 9 * * *' }],12 events: ['post.created', 'post.updated'],13});现代 Web 技术栈配合模块运行时,适合从本地开发一路推进到可部署产品。
模块化扩展
页面、API、任务和数据按模块接入,业务边界更清楚。
内置能力
认证、工作台、文件、计费、通知和后台运行时默认可用。
便捷部署
本地开发、模块组合、运行时存储和部署路径保持一致。
开源可控
代码、模块和产品页面都在仓库内版本化,便于审计和二开。
为什么 PloyKit 更适合 AI 协作开发
模块契约先行
页面、API、数据、任务、权限与事件写在同一份声明里,AI 不需要猜项目结构。
上下文更小
每次只阅读当前模块和契约,减少全局代码扫描,提示词更短,产出更稳定。
交付路径清晰
生成的模块直接接入宿主能力,再沿同一套运行时完成验证和部署。
宿主能力已经铺好,模块只写业务增量
认证、路由、数据、文件、任务、事件和诊断都由宿主承接。模块通过契约声明需要什么,接入后就能被统一运行、追踪和部署。
数据与 Schema
声明数据模型、迁移和访问边界,宿主负责落库与运行时适配。
页面与路由
公开页、用户中心和后台入口由模块声明,宿主统一挂载。
任务与事件
定时任务、Webhook、业务事件和结果追踪统一进入运行时。
文件与产物
上传、存储、权限和模块生成文件由宿主统一管理。
服务连接器
AI、邮件、支付和外部 API 作为宿主能力接入模块。
Module Doctor
扫描契约、权限、路由和依赖,提前发现接入风险。
从一个模块开始,组合成完整应用
先声明一个模块,再选择需要的宿主能力,最后按业务场景组合成 CMS、CRM、商城或内部工具。
用契约声明页面、API、Schema、任务和权限。
选择认证、工作区、文件、计费或事件能力。
按 CMS、CRM、商城或内部工具组织上线。
CMS
内容建模、编辑流和发布。
Shop
目录、订单、支付和文件。
CRM
客户、线索、活动和管道。
Workflow
连接应用、作业和任务。
Automation
后台任务、触发器和工作流。
Reports
仪表盘、分析和导出。
从模块契约开始,把产品交给宿主运行。
阅读文档,查看模块契约,把业务能力接入 PloyKit。通用能力由宿主托底,模块专注自己的产品逻辑。