# Kernlift 文档 > Kernlift 是一个 TanStack Start SaaS 模板:认证、计费、积分、管理后台、工作台、以插件形式提供的模块和可选的 > Agent 服务,可部署到 Cloudflare、Fly.io、Railway 或 Docker。 在 Kernlift 项目里,`pnpm kernlift context` 会从源码描述这个项目(路由、插件、设置页、环境变量、脚本、 校验器、技能),AGENTS.md 是每次修改都要遵守的规则。项目事实以这两者为准,这里的页面用于概念和操作步骤。 下面每个链接都是该页的 Markdown;https://kernlift.dev/zh/llms-full.txt 是全部页面合在一个文件里。 English: https://kernlift.dev/llms.txt. - [介绍](https://kernlift.dev/zh/docs.md): Kernlift 是什么,底座仓库里有什么,业务模板多了什么,以及从哪里开始。 - **使用指南** - [获取 Kernlift](https://kernlift.dev/zh/docs/guide/get-kernlift.md): 购买 Kernlift Premium 会员,用 GitHub 用户名激活,打开私有仓库;以及会员和非会员如何购买业务模板。 - [常见问题](https://kernlift.dev/zh/docs/guide/faq.md): 激活、邀请过期、退款、fork、同步上游更新、同步后更新数据库、项目数量与技术支持。 - [系统架构](https://kernlift.dev/zh/docs/guide/architecture.md): 代码如何分层、业务代码为什么从不接触 SQL 方言,以及让模板便于 fork 的约定。 - [前置要求](https://kernlift.dev/zh/docs/guide/prerequisites.md): 克隆 Kernlift 之前要准备好的工具、账号和基础知识。 - [同步上游更新](https://kernlift.dev/zh/docs/guide/upgrading.md): 从 upstream 远程把模板的新版本合并进你的项目,并用项目自带的检查验收。 - [排查项目问题](https://kernlift.dev/zh/docs/guide/troubleshooting.md): 根据现象找到原因和修复方法:初始化清单缺项、会话密钥、生成的类型、迁移、开发环境免登录、agent、定时任务和仓库访问。 - [更新日志](https://kernlift.dev/zh/changelog) - **快速开始** - [快速开始](https://kernlift.dev/zh/docs/quick-start.md): 克隆仓库、安装依赖、构建数据库、创建管理员,在本地把项目跑起来。 - **定制化** - [安装后的第一步](https://kernlift.dev/zh/docs/customize/first-steps.md): 查看初始化清单、接入邮件,然后决定接下来打开哪一篇定制指南。 - [换成自己的品牌](https://kernlift.dev/zh/docs/customize/branding.md): 把 Kernlift 的名称、域名、描述、图标和分享图换成你自己的,并决定用户登录后落在哪个页面。 - [替换落地页和定价页](https://kernlift.dev/zh/docs/customize/landing-pages.md): 重写示例首页、用 page-shell 原语新增公开页面,并了解 /pricing 读取什么数据、校验器强制哪些规则。 - [使用设计系统](https://kernlift.dev/zh/docs/customize/design-system.md): 用 beUI、motion 组件和产品令牌搭建或改造页面,修改主题,并避开校验器会拒绝的导入。 - [新增与修改文案](https://kernlift.dev/zh/docs/customize/i18n.md): 在英文和中文两种语言下编辑文案、新增支持多语言的路由,并了解可选语言段和 i18n 校验器的工作方式。 - [新增后台或工作台页面](https://kernlift.dev/zh/docs/customize/new-page.md): 在 /admin 或 /app 下新增一个页面:带守卫的服务端函数、两种语言的文案和一个导航入口。 - **部署上线** - [部署项目](https://kernlift.dev/zh/docs/deploy.md): 从四个平台里选一个,写入生成的密钥,迁移、部署,并创建线上管理员。 - [部署到 Cloudflare Workers](https://kernlift.dev/zh/docs/deploy/cloudflare.md): 把 Worker 部署在 D1 或经 Hyperdrive 连接的 Postgres 上,写入会话密钥,创建线上管理员,并按需加上 agent 容器。 - [部署到 Fly.io](https://kernlift.dev/zh/docs/deploy/fly.md): 创建 Fly 应用,导入生成的密钥,部署 Node 镜像并执行迁移,创建线上管理员,并按需加上 agent 应用。 - [部署到 Railway](https://kernlift.dev/zh/docs/deploy/railway.md): 由 .railway/railway.ts 创建 Railway 项目、服务和 Postgres,写入生成的密钥,部署,并创建线上管理员。 - [用 Docker Compose 部署](https://kernlift.dev/zh/docs/deploy/docker.md): 用 compose.yaml 在自己的服务器上运行项目:设置公网地址,启动并迁移,在前面加上 TLS,并创建线上管理员。 - [运行 Node 构建](https://kernlift.dev/zh/docs/deploy/node.md): 用 pnpm build:node 或根目录的 Dockerfile 构建 Node 服务,提供它需要的环境变量,迁移,然后在任意主机上运行。 - [部署模型](https://kernlift.dev/zh/docs/deploy/runtimes.md): 一个项目一个平台、两种构建目标、每个平台允许的数据库与 agent 组合、密钥放在哪里、迁移何时执行,以及定时任务如何启动。 - **核心** - 配置 - [配置模型](https://kernlift.dev/zh/docs/core/configuration.md): 为什么少数设置放在环境变量里,而其他一切都保存在数据库中、在管理后台编辑。 - [配置一个可运行的项目](https://kernlift.dev/zh/docs/core/configuration/project.md): 从启动变量开始,完成登录与邮件投递,再按实际使用的功能接入服务商并验证。 - [项目结构](https://kernlift.dev/zh/docs/core/project-structure.md): 熟悉 Kernlift 代码仓库,知道每一类改动应该放在哪里。 - 认证、角色与用户 - [认证与授权模型](https://kernlift.dev/zh/docs/core/auth.md): 身份在哪里读取、每个边界如何判定访问权限,以及为什么没有兜底用户。 - [管理用户、角色和权限](https://kernlift.dev/zh/docs/core/auth/roles.md): 完成后,每位成员只持有其工作所需权限的角色,你也可以暂停或封禁任意账号。 - [用户与账号](https://kernlift.dev/zh/docs/core/auth/users.md): 查找账号,查看它持有的内容,分配角色,封禁与恢复,以及修复积分余额。 - [签发 API 密钥并设置限流](https://kernlift.dev/zh/docs/core/auth/api-keys.md): 完成后,用户可以在脚本中用带 scope 的密钥调用 AI 和上传接口,你可以控制每个密钥的调用频率。 - 管理后台 - [运行管理后台](https://kernlift.dev/zh/docs/core/admin.md): 创建第一个管理员、完成上线检查清单、熟悉侧边栏,并在 /admin 中管理插件、调整缓存和查看审计日志。 - [审计日志](https://kernlift.dev/zh/docs/core/admin/audit-log.md): 查清谁改了什么:48 处写入路径记录操作者、动作、目标和元数据。 - [限流](https://kernlift.dev/zh/docs/core/admin/rate-limits.md): 设置 API Key 请求限额,并选择内存或 Redis 计数后端。 - [按国家查看账号与已付订单](https://kernlift.dev/zh/docs/core/admin/countries.md): 在国家统计页按时间范围比较账号和已结算订单。 - [缓存](https://kernlift.dev/zh/docs/core/admin/cache.md): 十个缓存域,各有自己的 TTL,可放内存或 Cloudflare KV,每个域都能单独清除。 - [数据访问](https://kernlift.dev/zh/docs/core/data-access.md): 业务代码如何访问数据库:只经过仓储,同一套契约覆盖 SQLite、D1 和 Postgres,事务在每种数据库上意味着什么,以及为什么迁移按方言分别维护。 - 插件 - [插件](https://kernlift.dev/zh/docs/core/plugins.md): 插件内核的工作方式:什么是插件,它向哪些客户端插槽和服务端插槽贡献内容,插件如何在构建期安装、在运行时启用和停用。 - [编写后台插件](https://kernlift.dev/zh/docs/core/plugins/console-plugins.md): 把自己的功能做成一个本地插件:用户工作区的侧边栏入口、一个页面和一张仪表盘卡片,管理员可以随时启用和停用。 - [模板与派生产品](https://kernlift.dev/zh/docs/core/plugins/templates.md): 仓库里的模块和模板产品有什么不同,业务模板是什么,以及如何在底座上只加一个插件,做出自己的产品。 - [开发一个模块](https://kernlift.dev/zh/docs/core/plugins/build-a-module.md): 把一项功能做成仓库里的一个模块:代码、两种方言的 schema 与迁移、区域标记、清单和校验器。 - 后台任务 - [后台任务](https://kernlift.dev/zh/docs/core/background-jobs.md): Web 应用如何在每个平台上每分钟执行一轮自己的周期性工作,为什么一行锁就够,以及 /setup 怎样发现它停了。 - [运行后台任务](https://kernlift.dev/zh/docs/core/background-jobs/run.md): 确认定时任务在你的平台上运行,手动执行一轮,并在 /setup 提示它停止时知道该做什么。 - [校验器与发布门禁](https://kernlift.dev/zh/docs/core/validators.md): 为什么每项能力都带有断言行为与接线的可执行检查,以及发布门禁如何决定哪些检查必须通过。 - [使用编码 Agent 技能](https://kernlift.dev/zh/docs/core/agent-skills.md): 使用 skills/ 中的 SKILL.md 工作流了解项目、创建项目,开发、安装和卸载模块,添加页面,配置服务商并部署。 - **扩展** - 数据库 - [使用 Postgres 与 Supabase](https://kernlift.dev/zh/docs/extensions/database/postgres.md): 把应用指向任意 Postgres 数据库(包括 Supabase 与 Neon),并用迁移链构建 schema。 - [Supabase](https://kernlift.dev/zh/docs/extensions/database/supabase.md): 在 Supabase 托管应用数据库。 - [Neon](https://kernlift.dev/zh/docs/extensions/database/neon.md): 在 Neon 托管应用数据库。 - [使用 Turso](https://kernlift.dev/zh/docs/extensions/database/turso.md): 通过 SQLite schema 分支和 turso 适配器,在 Turso libSQL 数据库上运行应用。 - [编写自定义数据库适配器](https://kernlift.dev/zh/docs/extensions/database/custom-adapter.md): 为 Postgres 或 SQLite schema 家族注册自己的连接方式,并用 DATABASE_ADAPTER 选择它。 - 登录鉴权 - [配置邮箱密码登录](https://kernlift.dev/zh/docs/extensions/auth/email-password.md): 完成后,用户可以注册账号、验证邮箱、登录,并重置忘记的密码。 - [接入 Google 和 GitHub 登录](https://kernlift.dev/zh/docs/extensions/auth/social.md): 完成后,登录页和注册页会显示 Google 或 GitHub 按钮,用户可以用已有账号直接登录。 - [Google](https://kernlift.dev/zh/docs/extensions/auth/google.md): 让用户通过 Google 登录。 - [GitHub](https://kernlift.dev/zh/docs/extensions/auth/github.md): 让用户通过 GitHub 登录。 - 支付 - [支付生命周期](https://kernlift.dev/zh/docs/extensions/payments.md): 一次结账如何变成已支付订单:服务端定价、通过 Webhook 或回调由服务商确认、幂等结算以及退款。 - [接入支付服务商](https://kernlift.dev/zh/docs/extensions/payments/setup.md): 完成后,买家在 Stripe、Creem、PayPal、DodoPayments、微信支付、支付宝或 Waffo 付款,付款确认后订单标记为已付款。 - [Stripe](https://kernlift.dev/zh/docs/extensions/payments/stripe.md): 通过 Stripe Checkout 收取一次性付款和按月、按年续费的订阅,支持退款和客户门户。 - [Creem](https://kernlift.dev/zh/docs/extensions/payments/creem.md): 通过 Creem 收款。 - [PayPal](https://kernlift.dev/zh/docs/extensions/payments/paypal.md): 通过 PayPal 收款。 - [DodoPayments](https://kernlift.dev/zh/docs/extensions/payments/dodopayments.md): 通过 DodoPayments 收款。 - [微信支付](https://kernlift.dev/zh/docs/extensions/payments/wechat-pay.md): 通过 微信支付 收款。 - [支付宝](https://kernlift.dev/zh/docs/extensions/payments/alipay.md): 通过支付宝电脑网站收银台收取人民币付款。 - [Waffo](https://kernlift.dev/zh/docs/extensions/payments/waffo.md): 通过 Waffo 收款,由它作为 merchant of record 代收代缴销售税。 - [销售产品和方案](https://kernlift.dev/zh/docs/extensions/payments/products.md): 你的产品带着价格出现在前台;买家购买后获得授权,并用 GitHub 用户名激活。 - [管理定价套餐](https://kernlift.dev/zh/docs/extensions/payments/pricing-plans.md): 在管理后台新建和编辑定价页展示、结账售卖的套餐,并为每种语言填写文案。 - [管理订单、退款和订阅](https://kernlift.dev/zh/docs/extensions/payments/subscriptions.md): 完成后,你可以为订单退款、取消或恢复订阅、让买家自助管理账单,并重新处理失败的 webhook。 - [编写履约插件](https://kernlift.dev/zh/docs/extensions/payments/fulfilment.md): 用自己的插件交付已付订单所买的内容、拒绝无法履约的结账,并观察失败的交付被自动重试。 - 存储 - [配置文件存储和上传](https://kernlift.dev/zh/docs/extensions/storage.md): 完成后,用户可以上传文件,并通过限时链接下载。文件保存在你自己的 S3 兼容存储桶或 R2 绑定中。 - [Cloudflare R2](https://kernlift.dev/zh/docs/extensions/storage/cloudflare-r2.md): 将上传文件保存到 Cloudflare R2。 - [Amazon S3](https://kernlift.dev/zh/docs/extensions/storage/aws-s3.md): 将上传文件保存到 Amazon S3。 - [MinIO](https://kernlift.dev/zh/docs/extensions/storage/minio.md): 将上传文件保存到 MinIO。 - 邮件 - [发送事务邮件](https://kernlift.dev/zh/docs/extensions/email.md): 完成后,验证邮件、密码重置邮件和你自己的产品邮件会用可编辑的模板,通过 Resend、Cloudflare Email Service 或阿里云邮件推送发出。 - [Resend](https://kernlift.dev/zh/docs/extensions/email/resend.md): 通过 Resend 发送事务邮件。 - [Cloudflare Email](https://kernlift.dev/zh/docs/extensions/email/cloudflare.md): 通过 Cloudflare Email 发送事务邮件。 - [阿里云邮件推送](https://kernlift.dev/zh/docs/extensions/email/aliyun.md): 通过 阿里云邮件推送 发送事务邮件。 - 统计 - [添加统计分析与客服聊天](https://kernlift.dev/zh/docs/extensions/analytics.md): 在所有页面加载 Google Analytics、Umami、Plausible、Clarity 或 Crisp 聊天组件,检查连接,并按国家查看统计。 - [Google Analytics](https://kernlift.dev/zh/docs/extensions/analytics/google-analytics.md): 为网站接入 Google Analytics。 - [Google Ads](https://kernlift.dev/zh/docs/extensions/analytics/google-ads.md): 为网站接入 Google Ads。 - [Umami](https://kernlift.dev/zh/docs/extensions/analytics/umami.md): 为网站接入 Umami。 - [Plausible](https://kernlift.dev/zh/docs/extensions/analytics/plausible.md): 为网站接入 Plausible。 - [Microsoft Clarity](https://kernlift.dev/zh/docs/extensions/analytics/clarity.md): 为网站接入 Microsoft Clarity。 - [Crisp](https://kernlift.dev/zh/docs/extensions/analytics/crisp.md): 为网站接入 Crisp。 - AI - [AI 渠道、场景与任务生命周期](https://kernlift.dev/zh/docs/extensions/ai.md): 服务商、服务商场景与场景如何组合,积分价格如何解析,以及任务与对话从请求到结算的运行过程。 - [接入 AI 服务商](https://kernlift.dev/zh/docs/extensions/ai/providers.md): 完成后,上游 AI 账号及其模型保存在后台,可以路由到你的场景。 - [OpenAI](https://kernlift.dev/zh/docs/extensions/ai/openai.md): 将文本生成请求路由到 OpenAI。 - [Google Gemini](https://kernlift.dev/zh/docs/extensions/ai/gemini.md): 将文本生成请求路由到 Google Gemini。 - [Cloudflare Workers AI](https://kernlift.dev/zh/docs/extensions/ai/workers-ai.md): 将文本生成请求路由到 Cloudflare Workers AI。 - [设置场景路由和定价](https://kernlift.dev/zh/docs/extensions/ai/scenes.md): 完成后,产品对外提供 chat、image-creation 等命名 AI 场景,每个场景路由到一个模型并按积分计价。 - [接收异步结果(轮询与 webhook)](https://kernlift.dev/zh/docs/extensions/ai/async.md): 完成后,稍后才出结果的图片、视频、音频任务能到达最终状态,积分随之扣除或退回。 - [跑通图片和视频生成](https://kernlift.dev/zh/docs/extensions/ai/media-generation.md): 接入图片或视频服务商,让一次生成完整跑通:请求变量、带数组下标的解析路径、状态轮询、结果入库,以及在 agent 对话里显示图片和视频。 - [AI 对话记录](https://kernlift.dev/zh/docs/extensions/ai/chats.md): 查看用户和 agent 的对话:谁、哪个 agent、什么语言,以及每一条消息的内容。 - 积分 - [积分账本](https://kernlift.dev/zh/docs/extensions/credits.md): 积分如何以只追加账本加余额快照的方式存储,以及冻结、扣除与退还如何让计量计费保持准确。 - [用积分对用量计费](https://kernlift.dev/zh/docs/extensions/credits/usage.md): 完成后,用户通过方案或手动发放获得积分余额,AI 任务等按量计费的工作从余额中扣除。 - [用 CMS 发布内容](https://kernlift.dev/zh/docs/extensions/cms.md): 在管理后台用中英文撰写、发布和整理博客文章、法务页面、更新日志与路线图。 - 订阅 - [邮件订阅与候补名单](https://kernlift.dev/zh/docs/extensions/newsletter.md): 收集邮件订阅者和发布候补名单,同步到 Resend 或 Beehiiv,分批邀请用户并重试失败的同步。 - [Resend](https://kernlift.dev/zh/docs/extensions/newsletter/resend.md): 将邮件订阅者同步到 Resend。 - [Beehiiv](https://kernlift.dev/zh/docs/extensions/newsletter/beehiiv.md): 将邮件订阅者同步到 Beehiiv。 - [运营联盟推广计划](https://kernlift.dev/zh/docs/extensions/affiliate.md): 在管理后台设置计划条款、为推广者发放推荐码、把推广订单转成佣金并审核提现。 - [工单](https://kernlift.dev/zh/docs/extensions/support.md): 接收已登录客户提交的工单,按 SLA 分派处理,并在后台回复。 - 通知 - [向 Slack、Discord 或飞书发送通知](https://kernlift.dev/zh/docs/extensions/notifications.md): 完成后,产品的运营提醒会发到团队群聊频道,每次尝试都记录在投递日志中。 - [Slack](https://kernlift.dev/zh/docs/extensions/notifications/slack.md): 向 Slack 发送团队通知。 - [Discord](https://kernlift.dev/zh/docs/extensions/notifications/discord.md): 向 Discord 发送团队通知。 - [飞书](https://kernlift.dev/zh/docs/extensions/notifications/feishu.md): 向 飞书 发送团队通知。 - Agent - [Agent 运行机制](https://kernlift.dev/zh/docs/extensions/agent.md): 可选的 agent 服务如何部署,Web 应用如何判断它是否可用,以及运行、工作区、技能和决策之间的关系。 - [运行 Agent 启动模板](https://kernlift.dev/zh/docs/extensions/agent/starter.md): 安装 agent 模板,配置模型通道、沙箱与搜索服务商,启动 agent 服务并打开工作台。 - [E2B](https://kernlift.dev/zh/docs/extensions/agent/e2b.md): 为 Agent 接入 E2B。 - [阿里云沙箱](https://kernlift.dev/zh/docs/extensions/agent/aliyun.md): 为 Agent 接入 阿里云沙箱。 - [Novita Sandbox](https://kernlift.dev/zh/docs/extensions/agent/novita.md): 为 Agent 接入 Novita Sandbox。 - [SearXNG](https://kernlift.dev/zh/docs/extensions/agent/searxng.md): 为 Agent 接入 SearXNG。 - [Crawl4AI](https://kernlift.dev/zh/docs/extensions/agent/crawl4ai.md): 为 Agent 接入 Crawl4AI。 - [Agent 插件](https://kernlift.dev/zh/docs/extensions/agent/plugins.md): 把一项 agent 能力做成插件:接入唯一的工作台输入框,带上自己的卡片、面板和操作,运行时随时启停,宿主不用改代码。 - [图片 Agent](https://kernlift.dev/zh/docs/extensions/agent/image-agent.md): 为用户后台加入图片页面:请求在 agent 运行时上执行图片 Skill,使用用户选择的画幅,并受你设置的每次运行出图上限约束。 - **参考** - [底座仓库里有什么](https://kernlift.dev/zh/docs/reference/capabilities.md): 底座、随底座提供的模块和 Agent 部分:每一部分增加什么,依赖什么。 - [技能](https://kernlift.dev/zh/docs/reference/skills.md): skills/ 里的 SKILL.md 工作流:每个做什么、需要你提供什么、如何确认完成。 - [脚本](https://kernlift.dev/zh/docs/reference/scripts.md): 模板 package.json 里除单个校验器之外的每个 pnpm 脚本,按用途分组。 - [校验器](https://kernlift.dev/zh/docs/reference/validators.md): 每个 validate:* 脚本证明什么、validate:all 与发布门禁是否运行它,以及哪些已知会失败。 - [环境变量](https://kernlift.dev/zh/docs/reference/env.md): 部署必须的六个变量、少数可选变量,以及只有 Agent 服务和脚本才读取的变量。 - [部署配置](https://kernlift.dev/zh/docs/reference/deploy-config.md): deploy.config.json 和改写它的 kernlift deploy-target 命令:允许的组合、每个平台拥有的文件、.env.production 的键,以及各平台如何迁移和创建管理员。