---
title: CH-01
emoji: "⚡️"
colorFrom: indigo
colorTo: yellow
sdk: gradio
sdk_version: "6.19.0"
python_version: "3.14"
app_file: app_new.py
pinned: false
---

# CH-01 多案場專案管理系統

此專案為 Hugging Face Spaces / Gradio 應用，支援多案場管理、分類篩選、會議錄音轉錄、現場照片紀錄、OCR 文件建檔、行事曆提醒、歷史搜尋、甘特圖與 PDF/Excel 報表匯出。新版介面採金藍液態玻璃風格，適合桌機、手機和平板使用。

## 行事曆提醒

在「行事曆提醒」分頁可以替案場新增會議、投標期限、文件送審、現場勘查等提醒，並匯出 `.ics` 檔。將 `.ics` 匯入 Apple Calendar、Google Calendar 或 Outlook 後，手機和平板會依設定的提前提醒時間跳通知。

## 部署設定

1. 在 Hugging Face Spaces 建立 Space，名稱為 `CH-01`。
2. 將此專案推送至 Space 的 Git repository。
3. 在 Space 的 Settings > Secrets 中新增：
   - `APP_LOGIN_USER`：登入帳號，預設 `Neil67`
   - `APP_LOGIN_PASSWORD`：登入密碼，未設定時不檢查密碼
   - `APP_ACCESS_KEY`：額外存取金鑰，未設定時不檢查金鑰
   - `HUGGINGFACEHUB_API_TOKEN` 或 `HF_TOKEN`：使用 HF Inference API 時需要
   - `TEXT_MODEL`：可選，文字摘要模型；未設定時會使用本機模板摘要
   - `TRANSCRIBE_MODEL`：可選，預設 `openai/whisper-large-v3`
   - `IMAGE_CAPTION_MODEL`：可選，預設 `nlpconnect/vit-gpt2-image-captioning`
   - `OCR_MODEL`：可選，預設 `microsoft/trocr-base-printed`
4. `requirements.txt` 已包含應用所需依賴。

## 本地啟動

```bash
pip install -r requirements.txt
python app_new.py
```

## 重要檔案

- `app_new.py`：新版主應用程式，也是目前 Space 入口
- `app.py`：舊版應用程式，保留作為參考
- `cases.json`：案場資料、會議、照片、OCR 與附件紀錄
- `requirements.txt`：依賴列表
- `README.md`：Space 配置說明