前置要求

克隆 Kernlift 之前要准备好的工具、账号和基础知识。

开始快速开始之前,先把下面这些准备好。这里的东西都不花钱;需要付费的服务要到接入服务商时才用得上。

本机工具

工具版本用途
Node.js22.x 系列的 22.12 或以上版本运行开发服务器、构建和各种脚本
pnpmpackage.json 中 packageManager 指定的版本安装依赖,运行所有 pnpm 脚本
git任意较新版本克隆仓库、同步更新

检查一下:

node --version
pnpm --version
git --version

没有 pnpm 的话,用 npm install -g pnpm@10.25.0 安装。

GitHub 账号

代码通过 GitHub 交付,所以你需要一个 GitHub 账号,而且必须是激活购买时填写的那个。见获取 Kernlift。

文档里的克隆命令用的是 SSH(git@github.com:...)。请先在 GitHub 的 SSH keys 页面添加 SSH 公钥,或者改用仓库页面上显示的 HTTPS 地址克隆。

现在还不需要的

  • 数据库服务。 本地开发用的是一个 SQLite 文件,执行迁移时自动创建。
  • 云平台账号。 Cloudflare、Fly.io、Railway 或 Docker 主机到部署时才需要。
  • 服务商账号。 支付、邮件、存储和 AI 都是项目跑起来之后在管理后台里接入的。在那之前它们各自显示「未配置」。

如果要用 Agent 工作台

Agent 是可选的,没有它 Web 应用也是完整的。如果你打算运行它,或者买的是 image-agent、video-agent,还需要 Postgres 和一个沙箱服务。见运行 Agent 启动模板。

需要了解的知识

你会阅读并修改 TypeScript 和 React 代码。最好具备:

  • TypeScript 和 React,能看懂一个组件和一个服务端函数。
  • TanStack Start 与 TanStack Router 的基础:文件路由、loader 和服务端函数。
  • SQL 基础。表结构和查询用 Drizzle 编写。
  • Tailwind CSS,用于样式。

如果你用编码 Agent 干活,仓库自带一组技能,能带着它完成常见任务。见使用编码 Agent 技能。

下一步