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…

464 ·GitHub
Wanwan
这是什么？Wanwan（弯弯机）是一款用于与 AI 角色聊天和角色扮演的静态网页应用，完全在浏览器中运行，无需服务器、依赖或构建步骤。
这是后端服务，还是只是一堆静态文件？它就是一些纯静态文件（index.html、css、js、img、audio），扔到 Netlify 之类的任何静态托管上即可；完全没有服务端代码。
怎么把它部署上线？Fork 仓库并连接到 Netlify，每次提交都会自动部署；或者直接下载 ZIP，把文件夹拖进 Netlify Drop 手动上传。
需要 GitHub 账号或任何构建工具吗？推荐的自动部署方式需要 GitHub 账号和 Netlify 账号；手动上传两者都不需要，只要有下载好的项目文件即可。无论哪种方式都不需要构建命令或环境变量。
如果我更换设备或域名，我的聊天和角色会怎样？所有聊天记录、角色、设置和 API 配置都只保存在当前浏览器的本地存储中；新设备、新浏览器、无痕窗口或新域名都会从完全空白的数据空间开始，因此迁移数据必须先导出再重新导入。
不用桌面浏览器，在手机上也能用吗？可以，它可以作为网页应用安装到主屏幕：iOS/iPadOS 通过 Safari 的分享菜单，Android 通过 Chrome 的菜单。
要真正开始和 AI 模型聊天，我需要什么？你直接在 wanwan 自己的设置页面里填入模型服务的 API 地址和 API 密钥；README 警告不要把它放进 Netlify 环境变量，也不要提交到公开仓库。
既然是纯静态的，为什么还需要联网？页面会从外部 CDN 加载部分脚本、图标和图片，因此即使没有后端服务器，也需要联网才能正常工作。
我能把它放到自己的自定义域名上，而不用 netlify.app 地址吗？可以，在 Netlify 的 Domain management > Production domains 设置中，按照 Netlify 的自定义域名文档添加你自己的域名即可。
What are similar projects?InternalBeyond-Mobile, SillyTavern, player, bluntcore-intimacy-lab, Chat_UI, whirl, Companion-Space, chainlit
Which topics is it in?roleplay, ai-companion, conversational-ai, static-site, byok, pwa, chat, chatbot, browser, local-first, ios, web-app
Creator
wanonewan
Size
12.1 MB
Stars
464
Updated
CommitAug 15
Age
2mo
Commits · 90 Days