# README 勘误记录

本文件记录 mainPage README 中发现并修正的错误，便于追溯。

## 2026-07-27：构建输出路径描述错误

**原描述（错误）**：

- 项目结构注释：`vite.config.js # 构建输出到 /root/html（emptyOutDir=false，不清空既有文件）`
- 如何使用：`# 3. 构建（产物输出到 /root/html，不清空既有文件）`
- 开发命令：`npm run build # 构建到 /root/html`

**实际行为**（见 `vite.config.js`）：

- `npm run build` 输出到项目本地 `dist/`（`emptyOutDir: true`，每次清空）。
- `npm run deploy` 才用 rsync 把 `dist/` 同步到 Apache 站点根 `/root/html`（脚本：`vite build && rsync ... dist/... /root/html/...`）。

**修正**：三处均改为说明构建输出到 `dist/`，由 `npm run deploy` rsync 到 `/root/html`，并在「开发命令」补 `npm run deploy` 一行。

> 背景：本次升级 timeTableFix 子模块（新增时区选择）时，按 README 从 0 构建复现发现该不一致。

## 2026-07-28：部署路径统一为 /var/www/html

**原描述（不一致）**：

- `package.json` 的 `npm run deploy` 脚本 rsync 到 `/root/html`（依赖 `/root/html` 软链到 `/var/www/html`）。
- `deploy.sh` 与 README 用 `/var/www/html`（Apache 标准 DocumentRoot，不依赖软链）。
- `vite.config.js` 顶部注释写 `/root/html(软链到 /var/www/html)`。

**问题**：全新 Ubuntu 安装时 `/root/html` 软链不存在，`npm run deploy` 会失败或写到错误位置；三处路径不统一。

**修正**：`package.json` deploy 脚本与 `vite.config.js` 注释统一为 `/var/www/html`，与 `deploy.sh`、README、Apache DocumentRoot 一致。

## 2026-07-28：iframe / ical.js / 子模块数量描述过时

**原描述（错误）**：

- README「外部依赖」称白板页「iframe 嵌入外部服务 `https://f.zikai.wang`」。
- README「项目结构」注释称 zPDF_package「iframe 嵌入 zTools2」、白板「iframe 嵌入」。
- README「package.json」注释含 `ical.js`（子模块依赖被误列在父项目）。
- README 子模块只列 timeTableFix / z449，漏 zPDF_package / zWhiteBoard；克隆后安装依赖步骤也漏后两者。
- architecture.md 的 `requiresAlive` 示例为 `https://f.zikai.wang/health`，且称「仅白板页签使用」（PDF 也用）。
- architecture.md / add-module.md 提及 PageShell 的 `padded` prop（已被移除）。
- submodule-timeTableFix.md 称「共享 mainPage 的依赖 `ical.js`」（实际子模块自带）。

**实际行为**：

- 四个子模块（timeTableFix / z449 / zPDF_package / zWhiteBoard）均为**构建期组件 import**（非 iframe）。
- 白板与 PDF 页签的探针均为同源相对路径 `/api/health`（经反代/vite proxy 指向 zTools2），非外部域名。
- `ical.js` 仅 timeTableFix 使用，由其自身 `package.json` 管理；mainPage 的 `package.json` 不再列。
- PageShell 已无 `padded` prop（默认即上下间距）。

**修正**：README 改写为简洁版，结构/外部依赖/克隆步骤均对齐现状；docs 各文件同步修正。