wanwan README

The project's README from github.com/wanonewan/wanwan. As one markdown file: README.md.

弯弯机部署教程

弯弯机是一个可以直接部署到浏览器使用的静态应用。本项目不需要服务器、不需要安装依赖,也不需要执行构建命令。

推荐将仓库连接到 Netlify。完成一次设置后,只要 GitHub 仓库有新提交,Netlify 就会自动发布新版。没有 GitHub 账户时,也可以直接上传项目文件夹。

部署前准备

推荐方案需要:

手动上传只需要下载好的项目文件。

方案一:连接 GitHub 自动部署「推荐」

1. Fork 本仓库

  1. 打开本项目的 GitHub 仓库页面。
  2. 点击页面右上角的 Fork。
  3. 点击 Create fork,把项目复制到你自己的 GitHub 账户。

以后可以在自己的仓库页面点击 Sync fork 同步本项目的更新。同步产生新提交后,Netlify 会自动重新部署。

2. 在 Netlify 导入仓库

  1. 登录 Netlify。
  2. 在团队首页点击 Add new project。
  3. 选择 Import an existing project。
  4. 选择 GitHub,按提示授权 Netlify 访问你的 GitHub 仓库。
  5. 在仓库列表中选择刚刚 Fork 的弯弯仓库。如果找不到它,请在 GitHub 授权设置中允许 Netlify 访问该仓库。

3. 填写部署设置

在发布前确认以下设置:

设置 填写内容
Production branch 保持默认,通常是 main 或 master
Base directory 留空
Build command 留空
Publish directory .
Environment variables 不需要添加

然后点击 Publish。等待部署状态显示为已发布后,打开 Netlify 提供的 https://项目名称.netlify.app 地址即可使用。

如果新建的 Netlify 团队默认启用了私有项目,部署完成后可能只有团队成员能访问。需要公开分享时,请在 Netlify 的项目访问设置中将它改为公开。

4. 更新网站

连接 GitHub 后,Netlify 会监听生产分支:

方案二:手动上传到 Netlify

这种方式不需要连接 GitHub,但每次更新都要重新上传。

  1. 在 GitHub 仓库页面点击 Code,再点击 Download ZIP。
  2. 解压下载的 ZIP。
  3. 打开解压后的文件夹,确认第一层能直接看到 index.html、css、js、img 等内容。
  4. 登录 Netlify 后打开 Netlify Drop。
  5. 把整个项目文件夹拖到上传区域。
  6. 上传完成后,打开 Netlify 提供的 netlify.app 地址。

更新手动部署的网站时,先下载并解压新版项目,再进入原来的 Netlify 项目,在 Deploys 页面的上传区域拖入更新后的完整文件夹。

部署后的常用设置

修改网站地址

Netlify 会自动生成一个随机的 netlify.app 地址。可以在项目设置中修改项目名称,从而更改这个地址。

如需使用自己的域名,请进入 Domain management > Production domains,再选择 Add a domain。具体步骤可参考 Netlify 自定义域名文档。

添加到手机主屏幕

弯弯机支持作为网页应用安装:

数据与隐私

常见问题

部署后显示 404 或 Page not found

检查 Netlify 的 Publish directory 是否为 .,并确认 index.html 位于上传或仓库的根目录,而不是多套了一层文件夹。

页面能打开,但没有样式或部分功能不能使用

确认项目内容上传完整,尤其不要遗漏 css、js、img 和 audio 文件夹。然后在 Netlify 的 Deploys 页面重新部署。

GitHub 更新后,网站没有变化

  1. 确认修改已经进入 Netlify 设置的生产分支。
  2. 在 Netlify 的 Deploys 页面确认是否产生了新部署,以及部署是否成功。
  3. 重新打开网站;如仍显示旧内容,清除该网站的浏览器缓存后再试。

换了域名或项目地址后,原来的数据不见了

这是浏览器的数据隔离机制。不同域名会使用不同的本地数据空间。回到旧地址导出备份,再到新地址导入即可。

在 Netlify 中找不到 GitHub 仓库

重新连接 GitHub,并在授权页面允许 Netlify 访问该仓库。组织账户中的仓库可能还需要组织管理员批准 Netlify 的访问权限。

相关文档

wanwan (wanonewan/wanwan)

Searching Database…

457 ·GitHub
Что это?Wanwan (弯弯机) — статическое веб-приложение для общения и ролевых игр с ИИ-персонажами, работающее целиком в браузере, без сервера, зависимостей или этапа сборки.
Это бэкенд-сервис или просто папка статических файлов?Это обычные статические файлы (index.html, css, js, img, audio), которые вы кладёте на любой статический хостинг вроде Netlify; серверного кода нет вовсе.
Как его развернуть?Сделайте форк репозитория и подключите его к Netlify для автоматических деплоев при каждом коммите, или просто скачайте ZIP и перетащите папку в Netlify Drop для ручной загрузки.
Нужен ли аккаунт GitHub или инструменты сборки?Рекомендуемому пути с автодеплоем нужны аккаунт GitHub и аккаунт Netlify; ручной загрузке не нужно ни то ни другое — только скачанные файлы проекта. Команда сборки и переменные окружения не нужны в обоих случаях.
Что будет с чатами и персонажами при смене устройства или домена?Вся история чатов, персонажи, настройки и конфигурация API живут только в локальном хранилище текущего браузера; новое устройство, браузер, окно инкогнито или домен начинают с совершенно пустого пространства данных, поэтому для переноса нужно экспортировать и заново импортировать свои данные.
Можно пользоваться с телефона, а не в браузере компьютера?Да, его можно установить на домашний экран как веб-приложение: на iOS/iPadOS через меню «Поделиться» в Safari, а на Android через меню Chrome.
Что нужно, чтобы реально начать общение с ИИ-моделью?Вы вводите адрес API и API-ключ сервиса моделей прямо на собственной странице настроек wanwan; в README предупреждают не класть их в переменные окружения Netlify и не коммитить в публичный репозиторий.
Если он полностью статический, зачем ему интернет?Страница загружает часть скриптов, иконок и изображений с внешних CDN, поэтому даже без бэкенд-сервера для корректной работы нужно живое соединение.
Можно разместить его на собственном домене вместо адреса netlify.app?Да, через настройки Domain management > Production domains в Netlify, где можно добавить свой домен, следуя документации Netlify по кастомным доменам.
Creator
wanonewan
Size
12.1 MB
Stars
457
Updated
CommitAug 15
Age
2mo
Commits · 90 Days