浏览器里的沉浸式「小手机」前端：杂志风多页桌面、AI 对话、情侣玩法、深入系统模拟，以及一整套可本地美化的应用壳。
本仓库无登录门槛，打开即可进入桌面。数据默认保存在浏览器本地（localStorage / IndexedDB / OPFS 等）。
许可协议：GNU Affero General Public License v3.0（AGPL-3.0）。
- 四页杂志风主屏：手帐 / 底片匣 / 侧写 / 雾笺等排版，可分页滑动
- 自定义桌面：4×7 图标网格、长按拖动排序、小组件库与实例级配置
- 美化中心：壁纸、图标、字号、桌面挂件、锁屏壁纸与四位密码
- 启动页 / 锁屏 / 状态栏：开屏动画、可选锁屏、手机态与网页态切换
- PWA：
manifest.json+ Service Worker，可「添加到主屏幕」类 App 使用 - 导入导出：设置内支持轻量 ZIP 备份（对话、设置、深入、主题等）
| 模块 | 说明 |
|---|---|
| 聊天 | 多联系人会话、群聊、红包、朋友圈、相册、钱包、语音/通话 UI、心声、情诗、翻译、记忆抽取、后台消息与感知规则等 |
| 世界书 | 全局 / 线上 / 线下范围匹配；关键词触发；可绑定到联系人 |
| 联系人 | 角色档案、关系与聊天默认设置 |
| 记忆 | 长期记忆相关入口与管理 |
| 论坛 | 可配置独立论坛 API（留空则沿用对话 API） |
| 音乐 | 播放器 UI、桌面歌词、一起听 |
| 打字机 | 共读 / 器物等叙事向写作玩法 |
| 模拟器 | AI 叙事模拟器（独立模式层） |
| 日记 | 日记与定时相关能力 |
| 情侣空间 | 打卡、时间线、悄悄话、相册板等 |
| 行程轨迹 | 行程记录与展示 |
| 深入 | 模拟微信 / 短信 / 小红书 / 抖音 / B 站 / 小说 / 备忘 / 健康 / 待办 / 游戏 / 云盘 / 相册 / 浏览器 / 外卖 / 购物等「深层 App」 |
| 线下 / 便利店 / 赛事 / 剧场 / 天气 等 | 桌面磁贴入口的玩法与场景应用 |
| 74 号便利店、错位时空、共鸣、记录 等 | 扩展玩法入口（部分为场景化 UI） |
部分桌面磁贴（如「大世界」）仍可能标注为开发中，以实际页面提示为准。
- 静态前端：HTML / CSS / 原生 JavaScript，无构建步骤
- 按需懒加载非聊天模块（见
js2/miya-lazy-boot.js），减轻首屏压力 - 移动端视口与 iOS 键盘高度做了专门处理
.
├── index.html # 主页面（桌面 + 各 App 壳）
├── manifest.json # PWA 清单
├── sw.js # Service Worker
├── css/ # 样式
├── js1/ # 脚本（聊天、情侣、深入等）
├── js2/ # 脚本（设置、音乐、日记、懒加载等）
├── img/ # 图标与静态图
├── LICENSE # AGPL-3.0
└── README.md
- 现代浏览器（推荐最新版 Chrome / Edge / Safari / Firefox）
- 本地预览需要任意静态文件服务器（因部分能力依赖
http(s)://，不建议用file://直接打开） - 使用 AI 对话等功能时，需在应用 设置 中自行填写可用的 API 地址与密钥（本仓库不包含任何第三方密钥）
git clone https://github.com/lixooo00-lab/mingruis-miya.git
cd mingruis-miya任选一种即可。
Python 3：
python3 -m http.server 8080Node.js（需已安装 npx）：
npx --yes serve -l 8080PHP：
php -S 127.0.0.1:8080浏览器访问：
http://127.0.0.1:8080/
首次进入会看到启动页，随后进入桌面。在 设置 中配置对话 / 论坛 / 生图等 API 后，即可使用聊天与相关 AI 能力。
同一局域网下，用电脑的局域网 IP 访问，例如：
http://192.168.x.x:8080/
也可部署到任意静态托管（GitHub Pages、Cloudflare Pages、Nginx、对象存储静态站点等）。部署后建议用 HTTPS，以便 PWA / 持久存储等能力更完整。
| 操作 | 说明 |
|---|---|
| 配置 API | 桌面 → 设置，填写对话 API；论坛 API 可单独配置 |
| 备份数据 | 设置内的导入 / 导出（ZIP） |
| 换壁纸图标 | 桌面 → 美化 |
| 自定义布局 | 美化中切换自定义桌面，或主屏编辑小组件 |
| 清缓存异常 | 浏览器清除本站数据，或先注销 SW 后再强刷（开发时常用） |
开发时若改了 sw.js 仍看到旧资源，可在开发者工具 → Application → Service Workers 里 unregister，再硬刷新。
- 主入口几乎都在
index.html；业务逻辑按模块拆在js1/、js2/，样式在css/ - 新增非首屏 App 时，优先挂到
js2/miya-lazy-boot.js的分组懒加载，避免拖慢启动 - 静态资源 URL 带有
?v=版本参数；发版时如有缓存问题，可递增相关版本号 - 不要把含密钥、用户名单、找回码等私密配置提交进公开仓库
本项目以 GNU Affero General Public License v3.0（AGPL-3.0） 发布。
简要含义（非正式法律意见，细节以 LICENSE 全文为准）：
- 你可以自由使用、修改、分发本软件
- 分发修改版时，须继续以 AGPL-3.0（或兼容条款允许的方式）开源
- 若通过网络提供本程序的修改版服务，也须向用户提供对应源代码
Copyright © 2026 Miya contributors.
- 本仓库为前端体验与角色扮演向项目，不包含商业登录后台，禁止商业使用/商业用途二次分发
- 使用第三方 AI / 生图等 API 时，请遵守对应服务商条款与当地法律法规
- UI 中部分命名与布局仅供模拟与娱乐，与真实产品无关