| 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 配置說明 | |