01-quickstart.md

1. 快速开始

环境要求

• Node.js 18 或更高版本 — 在 nodejs.org 下载 LTS 安装。
• 任意现代浏览器 — Chrome / Edge / Firefox / Arc 都行。
• 磁盘空间 ≥ 500 MB（含 node_modules）。
• 可选：本地 ComfyUI（如果想跑 SDXL 工作流）。
• 可选：互联网（首次同步灵感库时需要访问 github.com）。

启动步骤

Windows

1. 解压 / clone 项目到任意目录（路径中不要带中文或空格）。
2. 双击 start.bat。
3. 首次启动会自动 npm install + 构建前端，大约 1-2 分钟。
4. 启动完成后浏览器会自动打开 http://127.0.0.1:3456。

macOS / Linux

chmod +x start.sh
./start.sh

卡住了？手动启动

npm install
npm run build
node server.js

第一次配置 API Key

启动后画布右上角会弹出"本地软件设置"。

字段	是否必填	说明
Tikpan API 密钥	必填	在 tikpan.com 注册后获取，格式 sk-xxx。
ComfyUI 地址	选填	默认 http://127.0.0.1:8188，本地 ComfyUI 跑在哪里就填哪里。
中转站地址 (Base URL)	选填	自建中转站填这里。留空走 tikpan.com 默认上游。
ComfyUI 工作流目录	选填	例 D:/ComfyUI/user/default/workflows，填了画布会扫描里面的 .json。

Key 保存位置：data/local-config.json，仅在你本机。不会上传到任何服务器。

生成你的第一张图

1. 画布上点击空白处 → 弹出模型选择器（Launcher）。
2. 选一个图像类档案（例：Tikpan Nano Banana Pro）。
3. 节点出现后，textarea 里默认有引导词，可改成你想生成的内容：

   一只穿宇航服的橘猫，坐在火星沙漠里，电影感打光，4K 摄影。
   

4. 按 Ctrl + Enter（或点侧边栏的"生成到画布"）。
5. 等 10-30 秒，生成结果会自动贴到画布右侧。

备份、迁移、卸载

• 备份：复制 data/ 文件夹。所有 Key、画布、资产、项目都在里面。
• 迁移：把整个项目文件夹拷到新电脑，运行 start.bat。
• 卸载：删除文件夹。系统不会有任何残留。

---

下一步 → 2. 画布操作