弯弯机是一个可以直接部署到浏览器使用的静态应用。本项目不需要服务器、不需要安装依赖,也不需要执行构建命令。
推荐将仓库连接到 Netlify。完成一次设置后,只要 GitHub 仓库有新提交,Netlify 就会自动发布新版。没有 GitHub 账户时,也可以直接上传项目文件夹。
推荐方案需要:
手动上传只需要下载好的项目文件。
- 打开本项目的 GitHub 仓库页面。
- 点击页面右上角的 Fork。
- 点击 Create fork,把项目复制到你自己的 GitHub 账户。
以后可以在自己的仓库页面点击 Sync fork 同步本项目的更新。同步产生新提交后,Netlify 会自动重新部署。
- 登录 Netlify。
- 在团队首页点击 Add new project。
- 选择 Import an existing project。
- 选择 GitHub,按提示授权 Netlify 访问你的 GitHub 仓库。
- 在仓库列表中选择刚刚 Fork 的弯弯仓库。如果找不到它,请在 GitHub 授权设置中允许 Netlify 访问该仓库。
在发布前确认以下设置:
| 设置 | 填写内容 |
|---|---|
| Production branch | 保持默认,通常是 main 或 master |
| Base directory | 留空 |
| Build command | 留空 |
| Publish directory | . |
| Environment variables | 不需要添加 |
然后点击 Publish。等待部署状态显示为已发布后,打开 Netlify 提供的 https://项目名称.netlify.app 地址即可使用。
如果新建的 Netlify 团队默认启用了私有项目,部署完成后可能只有团队成员能访问。需要公开分享时,请在 Netlify 的项目访问设置中将它改为公开。
连接 GitHub 后,Netlify 会监听生产分支:
- 你向自己的生产分支提交或合并修改后,Netlify 会自动部署。
- 上游项目发布更新后,先在 GitHub 的 Fork 页面点击 Sync fork;同步完成后,Netlify 会自动部署。
- 可以在 Netlify 项目中的 Deploys 页面查看进度、日志和历史版本。
这种方式不需要连接 GitHub,但每次更新都要重新上传。
- 在 GitHub 仓库页面点击 Code,再点击 Download ZIP。
- 解压下载的 ZIP。
- 打开解压后的文件夹,确认第一层能直接看到
index.html、css、js、img等内容。 - 登录 Netlify 后打开 Netlify Drop。
- 把整个项目文件夹拖到上传区域。
- 上传完成后,打开 Netlify 提供的
netlify.app地址。
更新手动部署的网站时,先下载并解压新版项目,再进入原来的 Netlify 项目,在 Deploys 页面的上传区域拖入更新后的完整文件夹。
Netlify 会自动生成一个随机的 netlify.app 地址。可以在项目设置中修改项目名称,从而更改这个地址。
如需使用自己的域名,请进入 Domain management > Production domains,再选择 Add a domain。具体步骤可参考 Netlify 自定义域名文档。
弯弯机支持作为网页应用安装:
- iPhone / iPad(Safari):打开网站,点击分享按钮,选择“添加到主屏幕”。
- Android(Chrome):打开网站,点击浏览器菜单,选择“安装应用”或“添加到主屏幕”。
- 聊天、角色、设置和 API 配置等数据主要保存在当前浏览器的本地存储中,不会因为部署到 Netlify 就自动上传到 Netlify。
- 更换设备、浏览器、无痕窗口或网站域名后,会被视为一个新的本地数据空间。清除浏览器的网站数据也可能删除已有内容。
- 更换设备、浏览器或域名前,请先在弯弯中导出数据备份,再在新地址中导入。
- 模型服务的 API 地址和 API Key 应在弯弯的设置页面中填写,不需要放进 Netlify 环境变量,也不要直接写进公开仓库的代码。
- 页面会从外部 CDN 加载部分程序和图标,并使用部分外部图片资源,因此使用时需要网络连接。
检查 Netlify 的 Publish directory 是否为 .,并确认 index.html 位于上传或仓库的根目录,而不是多套了一层文件夹。
确认项目内容上传完整,尤其不要遗漏 css、js、img 和 audio 文件夹。然后在 Netlify 的 Deploys 页面重新部署。
- 确认修改已经进入 Netlify 设置的生产分支。
- 在 Netlify 的 Deploys 页面确认是否产生了新部署,以及部署是否成功。
- 重新打开网站;如仍显示旧内容,清除该网站的浏览器缓存后再试。
这是浏览器的数据隔离机制。不同域名会使用不同的本地数据空间。回到旧地址导出备份,再到新地址导入即可。
重新连接 GitHub,并在授权页面允许 Netlify 访问该仓库。组织账户中的仓库可能还需要组织管理员批准 Netlify 的访问权限。