# moelian 普通用户系统交互原型

产品范围、页面需求、授权规则、统计口径与验收清单见 [需求文档](需求文档.md)。

**打开方式：直接双击 `index.html`。推荐先打开 `demo.html`，选择评审场景。**

本会话本地预览：<http://127.0.0.1:4173/demo.html>。本地服务退出后，可在此目录执行：

```powershell
python -m http.server 4173 --bind 127.0.0.1
```

无需安装依赖，无需构建。核心页面、公开品牌及封面均已保存到本地，可离线打开。手机使用桌面浏览器开发工具的 390px 视口预览，或查看 `screenshots/index.html`。服务仅监听当前电脑的回环地址，手机实机不能直接访问此地址。

## 两条主要评审路线

1. `demo.html` → **游客浏览** → 点击作品 → 开始阅读 → 调整页码 → 登录留住书签 → 输入邮箱 → 获取验证码 → 输入 **123456** → 个人中心 → 阅读历史 → 继续阅读。游客刚读的位置会带入登录的本地示例账号。
2. 返回 `demo.html` → **有绑定账号** → 个人中心的作品数据 → 选择作品 → 切换累计／近 7 天／近 30 天 → 查看阅读趋势、章节表现及统计说明。

阅读历史可以筛选漫画／小说、删除单条记录、清空全部。删除与清空均有确认，按 Esc 或取消可保留记录。漫画支持章节与页码选择，小说支持章节与正文位置选择；小说拖动位置条后，高亮并滚动到相应段落。此处用位置条模拟阅读进度，正文自然滚动本身不会更新记录。

## 演示账号与状态

| 账号 | 昵称 | 示例授权 |
| --- | --- | --- |
| reader@example.com | 小满 | 无绑定作品；已有漫画、小说阅读历史 |
| yuzu@example.com | 柚子 | 熊谷与鹿户、带大小姐跑路的我……、我想打破她的从容 |
| lin@example.com | 小林 | 熊谷与鹿户，演示同一作品授权另一普通用户 |
| 其他有效格式邮箱 | 新来的读者 | 首次验证创建空白本地账号，无历史、无授权 |

所有账号均点击“获取验证码”后输入 `123456`。验证码仅在本页生成，不发邮件；有效期 5 分钟，重试倒计时 30 秒。账号与阅读状态存储在浏览器 `localStorage`，文件打开与 HTTP 打开的存储彼此独立；浏览器禁用存储时会提示，并保留本次会话中的交互。

评审工具提供空历史、无绑定作品、无统计数据、无访问权限及共享授权直达入口。**切换场景会重置本原型的所有示例账号与阅读记录**，不会影响现站或其他网站的数据。正常用户界面没有身份切换、绑定、上传或投稿管理按钮。

无绑定账号隐藏“作品数据”入口，直接进入作品列表显示无绑定状态，直接进入单作品统计显示无访问权限。授权仅为查看汇总数据，和作者署名独立；用户无法自行绑定。前端判断只是交互展示，**真实权限必须由服务端校验**。

## 页面入口

以下片段接在 `index.html` 后，也可通过页面导航进入。

| 页面 | 片段 |
| --- | --- |
| 漫画／小说书架 | `#/shelf/manga` / `#/shelf/novel` |
| 登录／首次注册 | `#/login` |
| 个人中心 | `#/account` |
| 阅读历史 | `#/history` |
| 作品详情 | `#/book/77` |
| 漫画：第 3 话第 8 页 | `#/read/77/3/8` |
| 小说：第 2 章正文 42% | `#/read/79/2/42` |
| 作品数据列表 | `#/works` |
| 单作品统计 | `#/stats/77` |
| 暂无统计的作品 | `#/stats/76` |

## 数据口径与原型边界

- 全部账号、目录、连载状态、正文、阅读历史、统计与授权均为虚构示例。公开作品封面和作者署名只用于视觉参考；简介为公开内容节选或概述。没有真实登录、真实账号创建、邮件发送、统计上报或写入请求。
- 固定演示快照更新于 **2026-11-17 06:00 北京时间**，统计截至 **2026-11-16**；累计采集起点为 2026-09-18。界面每日更新的文案用于展示产品规则，本地文件不执行真实每日统计任务。
- 周期阅读人数为周期内去重示例值；每日人数单独按天去重，不能跨天相加得到周期人数。有效阅读次数等于图表所选日期的每日有效阅读次数合计。列表与详情使用同一份数据。
- 章节完读率 = 本周期有效开始的去重读者中，在截止日前到达章节末尾的人数 ÷ 有效开始人数。无有效开始显示“—”；未采集完读信息显示“未采集”，不以访问量补算。有效开始的时间、页数与进度阈值是原型展示假设，需产品确认后用于正式系统。
- 漫画使用分镜示意，小说使用原创占位段落，只验证继续阅读与位置恢复，没有实现完整阅读器。

## 验证与截图

已用 **Chrome 157** 实际运行检查 **1440×1040 桌面**、**390×844 手机模拟视口**。主要交互、空状态与权限示例通过；页面没有横向溢出。检查期间核心原型无脚本错误、无外部网络请求、无写入请求。`file://` 直接打开统计入口也已验证。

`screenshots/index.html` 是桌面、手机截图索引，包括书架、登录、个人中心、历史、作品详情、阅读示意、作品数据列表／详情和边界状态。原始截图为 PNG，`verification.json` 记录本次浏览器检查结果。

逻辑自检：

```powershell
node self-check.cjs
```

覆盖进度边界、历史筛选排序、周期指标与每日总和、合理完读率、缺失数据和共享授权样例。

浏览器回归脚本使用本机已安装的 `puppeteer-core` 与 Chrome，不是原型运行依赖。本机复跑方式：

```powershell
$env:PUPPETEER_MODULE = 'C:\Users\huion\.bun\install\global\node_modules\puppeteer-core'
node browser-check.cjs
```

复跑前先启动 4173 本地静态服务。可通过 `CHROME_PATH` 指定已有浏览器、`PROTOTYPE_URL` 指定另一个本地服务地址。未检查真实手机硬件、Safari/Firefox 或完整屏幕阅读器兼容性；前端权限、邮箱验证和统计不能作为生产实现。

## 文件与素材

运行文件：`index.html`、`demo.html`、`styles.css`、`data.js`、`app.js`、`assets/`。测试文件与截图均可独立保留，不参与原型运行。

只读参考：<http://moelian.longlian.online/manga>、<http://moelian.longlian.online/novel>、<http://moelian.longlian.online/manga/77>、<http://moelian.longlian.online/setting>。`reference/assets.json` 记录封面原始地址；`reference/current-shelf.png` 是制作前取得的现站浏览器截图。素材权利归各自权利人，本包用于本次原型评审。

本次未修改现有网站源码、生产服务器或测试服务器。
