# 乾式真空泵研究作品｜單頁連續閱讀版

> 🌐 線上正式網址：**https://chief1-research.pages.dev**（Cloudflare Pages，免密碼公開，手機 / 電腦皆可瀏覽）

製作人：**湯棨富**

`Chief1` 將原來 16 個內容頁合併為 **1 個完整的 `index.html`**。不必按目錄或切換分頁，直接往下滑即可讀完。原本 `C:\web\Chief` 多頁版不變。

## 開啟與預覽

- 最簡單：直接以瀏覽器開啟 `index.html`。本機圖片、搜尋、告警示範與 CSV 匯出可離線使用。
- 雙擊 `啟動網站.bat`：以本機 Node 預覽伺服器開啟 `http://127.0.0.1:8187/index.html`。
- 命令列：在本資料夾執行 `node server.cjs` 或 `npm start`。
- 預設連接埠 **8187**，與 Chief 原版 8186 分開。只綁定 127.0.0.1，唯讀服務，沒有設備連線功能。

## 單頁閱讀操作

- 16 章全部在 HTML 中，不依賴點擊載入、頁籤、折疊或 JavaScript 才顯示。
- 左側章節只用於本頁定位，隨捲動標示目前章節；上方細線與側欄顯示閱讀位置。
- 搜尋結果定位到同一頁的段落或原圖；網址片段可以複製分享，直接開啟或重新整理仍可定位。
- 手機的「目錄」按鈕展開章節導覽；選擇章節後自動收回，不遮住正文。
- 圖片點擊可放大；按 Escape 關閉。原本折疊的圖內 OCR、完整示範資料表與設定概念已預設展開為普通文字區域。
- 月份、模型告警、儀表板及成本試算的操作仍保留；這些控制項不是閱讀章節的必要步驟。
- 「已有原圖／原稿預留」篩選只影響第12章圖片索引，不會隱藏其他章節的圖片。

## 原始碼與重新建置

```text
index.html                  單頁全文（已建置，可直接開啟）
assets/style.css            原研究網站共用樣式
assets/reading.css          單頁章節、側欄進度、行動版樣式
assets/app.js               搜尋、圖片、表格、儀表板與告警互動
assets/reading.js           捲動定位、章節追蹤、閱讀進度、手機目錄
assets/simulation.js        可重現合成資料與告警狀態機
assets/site-data.js         建置生成的搜尋與表格資料
assets/original/            清晰原始圖片
assets/images/              網頁顯示圖片
data/                      來源、頁碼、策展章節與圖號資料
downloads/                 原始DOCX、轉存PDF、表格與覆蓋CSV
tools/content.py           原稿文字、表格、圖說與共用組件
tools/widgets.py           互動教學HTML組件
tools/build.py             單頁靜態生成器
tests/                     內容、瀏覽器、模擬規則測試
reports/                   本版驗收結果與來源稽核
```

預覽不必安裝任何套件。修改內容及重新建置需要 Python 3.11+，安裝 `requirements-build.txt`：

```sh
python -m pip install -r requirements-build.txt
# 若使用 uv：uv pip install --python <Python執行檔路徑> -r requirements-build.txt
python tools/build.py
```

修改原稿策展內容時編輯 `data/pages.json` 與對應組件；不要只修改 `index.html` 後再建置，否則手動變更會被覆蓋。原稿數據與 `assets/simulation.js` 的合成數列分開管理。

驗收命令（瀏覽器測試先啟動伺服器）：

```sh
npm install
python tests/test_single_page.py
node --test tests/simulation.test.cjs
node tests/browser.cjs
```

瀏覽器測試使用安裝於 Windows 的 Microsoft Edge。`reports/acceptance.md` 記錄本次實際執行結果，不以舊版驗收代替。

## 全文章節入口

|順序|章節|同頁網址|
|---|---|---|
|01|作品總覽|`index.html#chapter-index`|
|02|研究背景與動機|`index.html#chapter-background`|
|03|課程整合與學習|`index.html#chapter-courses`|
|04|方法與六個月時程|`index.html#chapter-method`|
|05|硬體與感測配置|`index.html#chapter-hardware`|
|06|軟體與資料管理|`index.html#chapter-software`|
|07|系統架構與資料流程|`index.html#chapter-architecture`|
|08|多模態特徵與模型|`index.html#chapter-models`|
|09|異常判定與預警|`index.html#chapter-alerts`|
|10|互動儀表板|`index.html#chapter-dashboard`|
|11|驗證方法與準則|`index.html#chapter-validation`|
|12|設計成果與圖像|`index.html#chapter-results`|
|13|可靠性與研究限制|`index.html#chapter-reliability`|
|14|預算與儲存容量|`index.html#chapter-budget`|
|15|RTX 6000 Ada補充|`index.html#chapter-rtx6000`|
|16|結論與資料資源|`index.html#chapter-resources`|

`downloads/coverage.csv` 與 `numeric-index.csv` 的來源位置已改為本版 `index.html#...` 的段落／圖號網址。

## 部署

將 `index.html`、`assets/`、`data/`、`downloads/`、`reports/` 及 `README.md` 放到同一個靜態網站根目錄即可。不需要伺服器重寫規則、後端、API或CDN；所有章節網址都是同一份HTML的片段。開發相依 `node_modules/`、`tests/`、`tools/` 不必上傳。

## 來源與界線

來源是本次附上的 DOCX；PDF 為 Microsoft Word 轉存29頁版本，並非另附《1版.pdf》。保留四張原表、完整26圖索引：8圖已提供、18圖原稿預留；缺圖與疑義仍按原稿註明。原始文件未更動；網站署名只用湯棨富。

儀表板與告警全部是 **合成資料示範，非實測、未連接設備**；資料不足、未知工況、模型未就緒與離線不顯示正常健康分數。人工確認不解除異常。沒有真實MQTT連線，也沒有泵浦啟停控制。實機、效能與硬體相容性仍待測。