# Hub 共筆聊天路線圖

> Hub 靜態站副本 · SSOT：`docs/00_planning/projects/rayna-summer/10_HUB_CHAT_ROADMAP.md`
>
> **Rayna 主要 UX**：project-hub 網頁內「聊天感」共筆（Phase 1，已可離線使用）  
> **大人選配**：Cursor IDE Agent（見 [RAYNA_COWRITE_AGENT.md](./agent-prompts/RAYNA_COWRITE_AGENT.md)）  
> **中長期**：LINE 小月 persona（RS-010）

---

## 為什麼不在瀏覽器直接接 Cursor？

| 限制 | 說明 |
|------|------|
| API 金鑰 | 靜態 HTML 無法安全持有 Cursor / OpenAI key |
| CORS | 瀏覽器無法直接呼叫 Cursor Cloud API |
| 帳號 | Rayna 不應共用大人 IDE 登入 |

因此 **Phase 1** 用 client-side「一步一問」聊天 wizard：體驗像跟小助手聊天，資料寫入同一個 `rayna-edits.json` schema，完全離線可用。

---

## Phase 1 — Hub 聊天 wizard（Ship now）

**入口**：[`samples/xiao-yue/project-hub/co-write.html`](../../../samples/xiao-yue/project-hub/co-write.html) → **💬 聊天共筆** tab

| 項目 | 狀態 |
|------|------|
| 七題 FSM（與 09 大綱一致） | ✅ |
| Bot bubble + Rayna 輸入框 | ✅ |
| localStorage + 匯出 JSON | ✅ |
| 表單模式 tab（一次看七題） | ✅ |
| UI 註：進階 LINE 小助手（RS-010） | ✅ |

**檔案**：`co-write-shared.js`、`co-write-chat.js`、`co-write.js`

---

## Phase 2 — LINE bot `xiaoyue` persona

**依賴**：RS-002（LINE 暴露 xiaoyue preset）、既有 `apps/line-bot/src/llm/cowrite-prompts.ts`

| 項目 | 狀態 | 說明 |
|------|------|------|
| FSM | 🟡 In Progress | 七題順序；intent `xiaoyue_cowrite`；關鍵字「小月共筆」 |
| Persona | 🟡 In Progress | `personas/xiaoyue/adapt.md` 童話語氣 |
| 腳本生成 | 🟡 In Progress | `xiaoyue-cowrite-prompts.ts` → ScriptDocument |
| 輸出 | 🟡 In Progress | 七題完成 → 預覽 / 確認製作 → render job |
| RS 任務 | ⬜ | **RS-010** MVP E2E：LINE 共筆小月 → mp4（render E2E 待 RS-003/005） |

**Hub 整合**：[`project-hub/index.html`](../../../samples/xiao-yue/project-hub/index.html) 加「開啟 LINE 小月共筆」→ OA QR / `LINE_OA_URL`  
**使用指南**：[11_LINE_XIAOYUE_COWRITE.md](./11_LINE_XIAOYUE_COWRITE.md)

---

## Phase 3 — API-backed hub（Optional）

若未來要讓 hub 頁「真 LLM 對話」：

1. **LIFF + line-bot session** — LINE 登入後 iframe 或 redirect，session 由後端持有  
2. **Serverless proxy** — content-studio 小 API，key 在 K8s Secret，hub 只打同源 `/api/cowrite`  
3. **維持 wizard 為離線 fallback** — 沒網路時仍可共筆

---

## 與創意流水線對照

| Phase | 07 創意階段 | RS |
|-------|-------------|-----|
| Hub wizard | Phase 2 劇情結構 · Rayna 親手改大綱 | RS-072 |
| LINE 共筆 | Phase 5 結局與劇本 · LINE 共筆定稿 | RS-010, RS-002 |
| Cursor Agent | 大人陪寫、可改 repo markdown | — |

---

## 驗收（Phase 1）

- [ ] Rayna 能在 iPad / 筆電打開 hub，不裝 Cursor 也能完成七題  
- [ ] 匯出 JSON 與表單模式欄位一致  
- [ ] 重新整理後 localStorage 恢復進度