前置要求
克隆 Kernlift 之前要准备好的工具、账号和基础知识。
开始快速开始之前,先把下面这些准备好。这里的东西都不花钱;需要付费的服务要到接入服务商时才用得上。
本机工具
| 工具 | 版本 | 用途 |
|---|---|---|
| Node.js | 22.x 系列的 22.12 或以上版本 | 运行开发服务器、构建和各种脚本 |
| pnpm | package.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 技能。