# Google Sheet 每日開發日誌

## 結論

可以，但**不是直接用 Google Sheets OAuth**。這個 workspace 沒有你的 Google 憑證，也不應該把憑證寫進檔案。最安全、最簡單的方式是：

```
daily_log.py  →  Google Apps Script Webhook  →  你的 Google Sheet
```

你的 Sheet 負責顯示；Apps Script 負責 append；`daily_log.py` 只讀環境變數，不把 webhook URL 或 secret 寫入 repo。

---

## 一次性設定

### 1. 建立 Google Sheet

建立一個空白 Google Sheet，命名隨意（例如 `Nyrobrain Dev Log`）。

### 2. 貼上 Apps Script

1. 在 Sheet 內點 **Extensions → Apps Script**。
2. 把 `google_apps_script.js` 的內容貼進去。
3. 把 `SECRET` 改成一段長隨機字串。
4. **Deploy → New deployment → Web app**
   - Execute as: **Me**
   - Who has access: **Anyone with the link**
5. 複製 Web app URL。

### 3. 設定環境變數

在你執行 `daily_log.py` 的 shell 設定：

```bash
export GOOGLE_SHEET_WEBHOOK_URL='https://script.google.com/macros/s/.../exec'
export DAILY_LOG_SECRET='與 Apps Script 內相同的 secret'
```

不要把這兩個值寫進 repo、`.env`、`research.json` 或 dashboard。`daily_log.py` 只從 process environment 讀取。

### 4. 測試

```bash
uv run python brain/research/dashboard/daily_log.py \
  --study R-2026-11-14-01 \
  --note "test row" \
  --sync
```

成功時 Apps Script 會回傳 `{"ok":true,"added":1}`；Sheet 會出現 `DailyLog` 工作表。

---

## GitHub Actions（每天自動跑）

Nyrobrain pod 本身沒有保證每天執行的 cron；如果要每天自動跑，請用 GitHub Actions。

1. 把 workspace push 到 GitHub repo。
2. 在 repo 的 **Settings → Secrets and variables → Actions** 新增：
   - `GOOGLE_SHEET_WEBHOOK_URL`
   - `DAILY_LOG_SECRET`
3. 使用 `.github/workflows/daily-log.yml`（若平台 token 沒有 workflow scope，請在 GitHub 網頁版建立，內容複製 `daily-log.workflow.yml`）：
   - 每天 **19:00 UTC / 03:00 Asia/Taipei（隔天）**
   - 也支援手動 `workflow_dispatch`
4. Action 會：
   - `uv sync --frozen`
   - 跑 `daily_log.py --sync`
   - 把更新後的 `brain/research/daily_log.csv` commit/push 回 repo

如果 push 失敗並提到 workflow scope，請授權 GitHub token 的 `workflow` scope。

## 每天怎麼用

```bash
uv run python brain/research/dashboard/daily_log.py \
  --study R-2026-11-14-01 \
  --note "今天做了什麼、卡在哪裡、下一步" \
  --sync
```

- 不帶 `--study` 時，會先看 `brain/research/daily_log_study.txt`；沒有才用最新的研究。
- 如果 `brain/research/daily_notes/YYYY-MM-DD.md` 存在，會自動當成當天的 note。
- 不帶 `--sync` 時，只寫本地 `brain/research/daily_log.csv`。
- 同一天、同一 study 會覆蓋本地同一列，不會重複。

## Sheet 欄位

| 欄位 | 內容 |
|---|---|
| date | YYYY-MM-DD |
| project | Project 名稱 |
| study_id | R-... |
| title | 研究標題 |
| stage | 目前 stage |
| gate | G1/G2/G3 |
| gate_status | partial/passed/failed |
| verdict | Reject / Keep in research / Paper candidate |
| summary | 研究摘要 + 當日 note |
| key_findings | 前 3 個重點 |
| report_path | 報告相對路徑 |

## Google Drive dashboard 存檔

同一個 Apps Script 也可以把 `DASHBOARD.md` 和 `standalone.html` 存到 Google Drive。設定與限制見：

```
brain/research/dashboard/GOOGLE_DRIVE.md
```

## 安全規則

- `GOOGLE_SHEET_WEBHOOK_URL` 和 `DAILY_LOG_SECRET` 是 secret；不要 commit。
- 不要把 secret 寫進 `research.json`、`README.md`、dashboard 或 Google Sheet 的可見欄位。
- 如果 webhook URL 洩漏，重新 deploy Apps Script 並換一組 URL/secret。
- 這個整合只 append log，不會修改 strategy、report.parquet 或 OMS。

## 手機版

手機 app 不支援 raw HTML；每日日誌請直接看 Google Sheet，或看 `brain/research/DASHBOARD.md`。
