底座仓库里有什么
底座、随底座提供的模块和 Agent 部分:每一部分增加什么,依赖什么。
本页列出你克隆下来的底座仓库里有什么。这里没有任何东西需要另外安装:底座和下面的每个模块都已经在代码里。依赖服务商的能力在凭据配置完成前不可用。
底座
| 领域 | 可用界面 | 配置或指南 |
|---|---|---|
| 账号与权限 | 登录、注册、验证、找回、个人资料、会话、角色、权限及 API 密钥 | 认证、角色、API 密钥 |
| 计费 | 产品、定价套餐(/admin/plans)、结账、订单、订阅、客户账单页及履约插件 | 支付、产品 |
| 积分 | 余额、预留与账本;结算由服务端工作流执行 | 积分 |
| AI 与对话 | 服务商通道、场景、文本和媒体任务、对话、定价及用量 | AI 通道、场景、对话 |
| 文件与消息 | 私有资源、上传、邮件模板与投递、通知 | 存储、邮件、通知 |
| 运营 | 后台概览、用户、工单、分析、审计、限流、国家统计和就绪检查 | 管理后台、初始化检查 |
| 扩展 | 插件内核、已安装插件列表,以及用于启用和停用插件的 /admin/plugins | 插件 |
| 工具 | kernlift deploy-target、kernlift context 命令和编码 Agent 技能 | CLI、技能 |
| 部署 | Cloudflare、Fly.io、Railway 和 Docker 的部署配置,由 kernlift deploy-target 写入 | 运行时与数据库适配器 |
示例落地页、/pricing、关于和联系页面属于底座。博客、可编辑法律内容、更新日志与 RSS 来自下方的 CMS 模块。服务商密钥与业务设置保存在 /admin/config/* 或相应后台页面。环境变量只用于启动和基础设施。见配置模型。
仓库里的模块
每个模块是一项自成一体的功能,带有自己的页面、服务端代码、数据表、中英文案和校验器。它的边界记录在 modules/<key>/module.json 里。依赖一列列出它还依赖什么。
| Key | 类型 | 依赖 | 增加什么 | 从这里开始 |
|---|---|---|---|---|
cms | 模块 | — | 内容编辑器、分类、版本、法律页与更新日志、博客及 RSS | CMS |
newsletter | 模块 | — | 邮件订阅、候补名单、邀请及设置页面 | 邮件订阅与候补名单 |
affiliate | 模块 | — | 推荐、佣金、提现与审核流程 | 推广返佣 |
image-agent | 模块 | agent-starter | /app/image、Image Studio Skill(platform.image)、画幅选择、图片查看器与每次运行的出图上限,设置页在 /admin/config/image-agent | 图片 Agent |
agent-starter | 模板 | — | /app/agent、Agent API 与服务、技能、连接器、运行工作区、沙箱及搜索配置 | 运行 Agent 启动模板 |
Agent 模板在 Web 应用之外再运行一个服务,并且需要 Postgres。kernlift deploy-target --agent 不接受其他数据库。D1 可以运行底座,但不能存储 Agent 运行数据。没有 agent 服务时 Web 应用仍然完整,agent 入口显示服务尚未部署。
image-agent 是模块,但它是 agent 工作台的一个插件,没有 agent-starter 就不起作用。
业务模板(image-studio、video-studio、image-agent、video-agent)是各自独立的仓库,每个都是在这个底座上做好的完整项目。见获取 Kernlift。
如何核对一个项目
- 阅读
modules/*/module.json清单。每份清单通过kind、requires、files、fragments、migrations、tables、configKeys和skillPackages定义一个模块的边界。 - 打开
/setup查看实时就绪状态。未配置的服务商显示为未配置。页面可以存在,而它的外部集成尚未配置。 - 运行
pnpm validate:gate。每项能力带有自己的校验器。