电脑端部署教程：用 Node.js 跑起本地服务
前置条件
| 依赖 | 要求 |
|---|---|
| Node.js | 24 或更高版本（官方快速开始页的当前要求） |
| Git | 任意较新版本 |
| LLM API | OpenAI、Claude、Gemini 或本地模型任选其一，见接上第一个模型 |
Node.js 版本不符是新手最常见的翻车点，装之前先在终端里跑 node -v 确认。
四步启动
git clone <官方仓库地址>
cd Luker
npm install
node server.js- 仓库地址在 GitHub 仓库页的绿色 Code 按钮里复制，本站不贴外链。
- 官方仓库同时提供启动脚本
start.sh，会自动装依赖并启动。 - 除 Node 外，官方也支持用 Deno 或 Bun 启动（对应
npm run start:deno/npm run start:bun）。
启动成功后在浏览器访问 localhost:8000 即可看到界面。
日常更新
git pull
npm install更新后重启服务即可。有新版本时，应用内也会出现更新提示弹窗引导操作。
数据放在哪
默认数据目录是项目根目录下的 data，你以后导入的角色卡、聊天记录、预设都在里面。常用 config.yaml 配置项见首次配置走通。
适合谁用这条路线
- 想自己管理版本、紧跟更新的用户
- 需要改动源码或参与开发的用户
- 不想装 Docker 的用户
如果你更想"一条命令拉起来、更新靠拉镜像"，直接看Docker 部署。
版本要求可能随官方更新变化，以仓库 README 为准。