#获取源码与启动

#获取项目

从 GitHub 仓库 下载源码 ZIP 并解压，或使用 Git：

git clone https://github.com/keiseiTi/origamix.git
cd origamix

下载 ZIP 的用户请在终端进入解压后的仓库根目录。

#安装并启动

pnpm install --frozen-lockfile
pnpm dev

pnpm dev 会准备本地后端、启动前端开发服务并打开 Electron 工作台。开发 Renderer 默认使用端口 5173。

启动成功后应看到工作台。保持终端运行，完成首次使用后停止开发命令，并关闭本次启动的应用。

#启动失败时

• 检查 Node.js 是否为 24，以及安装依赖是否成功。
• 锁文件报错时确认使用了仓库中的完整源码和锁文件，不要直接删除锁文件。
• 端口被占用时先确认占用来源，关闭自己启动的旧开发服务。
• 保存启动日志中的错误信息，提交问题时移除凭据和私人路径。

下一步：创建第一个页面。浏览器开发方式见开发与验证。