thread-master/docs/product/growth-loop/requirements.md

# Requirements: 成長迴路（從「好用」到「非用不可」）

> Status: `approved`  
> Status note: 使用者 2026-07-20「需求 OK」  
> Slug: `growth-loop`  
> Last updated: `2026-07-20`  
> 輸入真相：2026-07-20 PM 體檢結論；`apps/web` 現況 UI；`docs/product/haixun-backend/`（已交付能力）；git `main` 分支舊願景文件（`ai_threads_auto_account_ops.md`）  
> 修訂：§6 開放問題改為已鎖定決策（PM 預設）

## 1. 一句話

把巡樓從「AI 內容＋外展工具組合包」升級成「**能證明 ROI、越用越準的 Threads 成長系統**」：先補 **成果歸因** 與 **學習閉環最小版** 兩塊護城河，再擴 **代操模式** 與 **帳號健康分**，最後以 **Playbook 市集＋邀請獎勵** 啟動自增長。

## 2. 誰用、在什麼情境

| 角色 | 目標 |
|------|------|
| 品牌／小電商島民（靠 Threads 獲客） | 明確看到海巡與發文帶來多少成果（觸達→對話→追蹤→成交），據此決定續費 |
| 創作者島民 | 每週拿到「下週該做什麼」的具體建議，帳號穩定成長 |
| 代操／Agency | 一套工具服務多個客戶：各自的品牌、人設、帳號、審核與月報 |
| 營運／管理員 | 用數據證明產品價值、量化平台政策風險、讓邀請網絡真正帶來增長 |

## 3. 背景與動機（As-is → 為什麼改）

**2026-07-20 體檢結論（本 run 的存在理由）：**

- **現況是「很用心的組合包」：** 產文有 ChatGPT 替代、排程 Buffer 已支援 Threads、單點皆有替代品；組合＝方便≠必要。「非用不可」程度評估 **2.5 / 5**。
- **儀表板只有成本視角：** 用量頁呈現「你花了多少點」，沒有任何地方告訴用戶「你賺回了多少」。無法證明 ROI 的工具，在續費時永遠是第一個被砍的。
- **真正的護城河沒做：** 舊願景的核心是「成效回收 → 分析原因 → 策略自我更新 → 可解釋」的**學習閉環**（舊文件 MVP4），目前落在 P2 未實作。人設／品牌資產理論上「越用越準」，但**沒有可見的複利證據** → 轉換成本低。
- **邀請網絡是裝飾：** 關係樹已建，但「日後活動再說」＝無獎勵機制＝無網路效應。
- **灰帽功能無護欄：** ThreadPlay 多帳互回、養帳號短回屬平台政策敏感操作，目前無健康度量化、無降速機制；Meta 政策收緊是**存亡級風險**。
- **不改的後果：** 用戶燒完免費點數即流失；無溢價能力；政策風險歸零核心功能；增長全靠人工推銷。

**已握有的三張王牌（本 run 要放大，不重造）：**

1. **海巡外展迴路**——最接近 painkiller：「每天 15 分鐘，找到正在講你產品痛點的真人，用像人的口吻回覆帶單」＝業務開發，市面 social listening 工具不碰這段。
2. **TC／台灣 Threads 垂直深度**——語感、場景全 TC 原生，國際工具對 Threads 皆敷衍。
3. **8D 人設語紋＋品牌知識資產**——具複利潛力，需要被「看見」。

**參考（非需求本體）：**

- 舊願景閉環與 MVP1–4 驗收：git `main` 分支 `ai_threads_auto_account_ops.md`
- 已交付能力真相：`docs/product/haixun-backend/spec.md`（Insights 真管線維持 P2 的決策不變）
- UI 真相：`apps/web`（今日／海巡／用量／Insights 頁）

## 4. 目標（To-be）

### 4.1 必須達成（P0）— 價值可見 ＋ 學習閉環最小版

1. **成果歸因（海巡 ROI 優先）**  
   - 外展回覆送出後，追蹤可合理取得的訊號（見 §6 決策 #1）：對方回應、帳號追蹤數變化、貼文互動、自帶 UTM 連結點擊（P2）；成交 **P0 手動回報**。  
   - 每筆成果可回溯到具體回覆／具體貼文（歸因鏈）。  
   - **今日頁與用量頁改為「成本＋成果」並列**：本週／本月觸達、對話、追蹤、成交摘要卡。  
2. **每週帳號健檢＋下週行動建議（學習閉環 MVP）**  
   - 基於**既有已同步貼文成效**（不重做 Insights 真管線），每會員每週自動產出一份 AI 報告：哪類題材／開頭／CTA 有效（**必須引用證據、可解釋**）＋下週 **3 個具體行動**，且每個行動可一鍵跳到對應功能（找話題／海巡／寫一則）。  
   - **方案內含、不扣點**（見 §6 決策 #2）。  
   - 這是舊願景 MVP4 的最小版，**不是**完整 Insights 管線。  
3. **資產複利可見**  
   - 呈現「系統從你的 N 篇貼文／M 次回饋學到什麼」：人設／品牌知識的學習摘要與版本，讓「越用越準」被感知，構成轉換成本。

### 4.2 應該有（P1）— 客群擴張 ＋ 風險護欄

1. **代操／Agency 模式**  
   - **同租戶內多工作區（Workspace）**，不重做多租戶帳單（見 §6 決策 #3）。  
   - 每工作區獨立品牌＋人設＋帳號歸屬；工作區可切換、資料隔離。  
   - 草稿審核流：草稿 → 待審 → 已准／退回，已准才進 Outbox。  
   - 白牌月報 PDF 匯出（不含白牌域名）。  
2. **帳號健康分（灰帽護欄）**  
   - 依操作密度／間隔／失敗率／token 狀態，給每個已連帳號 0–100 健康分與降速建議（訊號與門檻見 §6 決策 #5）。  
   - ThreadPlay／海巡送出**前**自動檢查；過載時降速並向用戶說明原因；今日頁可見警示。  
   - **只做護欄，不新增更激進的多帳玩法。**  
3. **邀請獎勵落地（單層紅線）**  
   - 直邀成員**首次升級到付費方案** → 邀請人得**產品點數**回饋（比例與上限見 §6 決策 #4）。  
   - **單層、點數、非現金**；文案維持「邀請人／直邀／延伸」。  
   - 邀請頁可見累計回饋。

### 4.3 以後再說（P2）

1. **利基 Playbook 市集**：分享／引用海巡 brief、人設風格、互回劇本模板（保養／母嬰／3C…），需可匿名化。  
2. **免費破冰工具**：公開免登入「風格指紋測驗」「痛點關鍵字產生器」，結果頁導註冊（用產品自己在 Threads 擴散）。  
3. **跨帳號基準（benchmark）**：匿名聚合「同利基帳號中位數」比較。  
4. **UTM 落地頁自動歸因**（P0 成交仍手動）。  
5. 既有 P2 維持不變：Insights 真數據管線完整版、真實金流／發票。

## 5. 範圍

### In scope

- 上述 P0／P1 功能的**產品行為定義**；前端 `apps/web` 與後端 `apps/backend` 皆會異動（經 spec → plan → tasks 才動碼）。  
- 歸因以「**可合理取得的訊號**」為限：Threads API 可讀的公開計數、自帶 UTM 連結（P2）、手動回報。  
- 每週健檢**重用既有同步貼文成效資料**，不新建 Insights 管線。  
- 代操＝同租戶 Workspace，非多租戶改造。

### Out of scope（明確不做）

- **不做多層獎金、不做現金回饋**（MLM 紅線）。  
- **不為歸因繞過平台限制**爬取私人數據；不做侵入式追蹤。  
- 不串自動成交／真金流（P2 外）。  
- 不重做既有發文／海巡主流程——本 run 是**加值層**，不是重構。  
- 不新增灰帽玩法；多帳互回只加護欄。  
- 代操模式 P1 不做白牌域名、不做多租戶帳單、不做跨租戶資料遷移。  
- 健檢報告**不扣平台點數**（方案內含）。

## 6. 已鎖定決策（2026-07-20）

| # | 議題 | 決策 |
|---|------|------|
| 1 | 歸因訊號與降級 | **P0 必做訊號：** (a) 外展回覆是否被對方再回／引用（對話）；(b) 送出帳號追蹤數變化（在合理時間窗內觀測，無法 100% 歸因時標「可能相關」）；(c) 目標貼文／己方回覆的互動計數變化（若 API 可讀）；(d) **成交＝手動回報**（金額選填、備註選填）。**P2：** UTM 連結點擊自動歸因。**降級：** API 拿不到某訊號時仍交付其餘訊號＋手動回報，**禁止**因缺訊號整段不做。具體 API 欄位對照表 → **spec 列出並驗證**。 |
| 2 | 每週健檢計費 | **方案內含，不扣點、不佔 AI 文案 meter。** 健檢是留存工具，不是變現點。產出失敗可重試，仍不計費。 |
| 3 | 代操工作區模型 | **同租戶內多 Workspace**，不引入多租戶帳單／多租戶隔離改造。每個會員預設 1 個 Workspace；可建多個。Workspace 擁有：品牌、人設、Threads 帳號歸屬、草稿審核設定。用量／方案仍綁**會員**（非 Workspace）。Admin 可跨 Workspace 檢視。 |
| 4 | 邀請點數回饋 | **觸發：** 直邀成員**首次**從 free 升級到付費方案（Starter 或 Pro）時發一次，**不**按月續訂再發。**額度：** 直邀升 Starter → 邀請人 **+100 點**；升 Pro → **+300 點**。**上限：** 邀請人每月透過邀請獲得的點數 ≤ 其當月方案額度的 **50%**（超出部分當月不發、不遞延）。**僅單層**（延伸不發）。點數入平台額度池，BYOK 無關。 |
| 5 | 健康分規則 | **分數：** 每帳號 0–100，**每日至少重算一次**（有發送事件時可即時重算）。**訊號（權重方向，細節 spec）：** 24h 發送次數過高↓、最小間隔違規次數↓、Outbox 近 7 日失敗率↓、token 過期／錯誤↓、連續多日無操作不扣分。**門檻：** ≥70 正常；40–69 警告（送出前提示、建議加倍間隔）；**<40 強制降速**（禁止新建 ThreadPlay 送出、海巡自動送出改為僅允許「複製→手動標記」路徑，直到分數回升）。今日頁顯示最低分帳號警示。 |
| 6 | 成交歸因 | **P0 手動回報**（從成果卡／海巡命中詳情填）。**P2** 才做 UTM 落地頁自動歸因。手動回報可事後改／刪（需留 audit 精神，spec 定）。 |
| 7 | 交付順序 | **硬性：** P0（歸因＋健檢＋資產可見）→ P1（健康分 → 邀請獎勵 → 代操）→ P2。P1 內健康分優先於代操（護城河／存亡 > 客群擴張）。 |
| 8 | 健檢產出節奏 | 每會員每週 **1** 份；週一 UTC 00:00 起可產（或會員時區週一，spec 定一種並寫死）。可手動「提前重產」但每 7 日最多 2 次（防刷）。 |
| 9 | 人工路徑 | 所有自動發送能力必須保留「複製文案 → 開 Threads → 標記完成」；健康分 <40 時**只留**此路徑給敏感操作。 |

## 7. 使用者故事（可驗收）

### P0

| ID | 作為… | 我想要… | 以便… | 驗收要點 |
|----|--------|---------|--------|----------|
| US-01 | 品牌島民 | 看到本週海巡帶來的觸達／對話／追蹤／成交 | 判斷值不值得續費 | 今日頁＋用量頁可見成果卡；每筆成果可回溯到具體回覆；成交可手動回報 |
| US-02 | 創作者 | 每週收到健檢報告＋3 個下週行動 | 知道該做什麼 | 報告含證據引用；行動可一鍵跳功能；**不扣點** |
| US-03 | 島民 | 看到系統從我的貼文／回饋學到的東西 | 感到越用越準 | 資產頁可見學習摘要與版本號 |

### P1

| ID | 作為… | 我想要… | 以便… | 驗收要點 |
|----|--------|---------|--------|----------|
| US-10 | 代操 | 在同帳號下切換 Workspace，各管各的品牌／人設／帳號 | 一套工具服務多客戶 | ≥2 Workspace 隔離；月報可匯出白牌 PDF；方案仍綁會員 |
| US-11 | 代操 | 客戶審核草稿後才進 Outbox | 交稿流程可控 | 草稿有 待審／已准／退回；未准不可送出 |
| US-12 | 島民 | 看到每個帳號的健康分與降速建議 | 不怕被平台懲罰 | 送出前自動檢查；&lt;40 強制降速並說明；今日頁警示 |
| US-13 | 島民 | 直邀首次付費後我得到點數 | 願意主動推廣 | Starter+100／Pro+300；月上限 50% 方案額度；邀請頁可見累計 |

### P2

| ID | 作為… | 我想要… | 以便… | 驗收要點 |
|----|--------|---------|--------|----------|
| US-20 | 島民 | 引用別人的利基 playbook 模板 | 快速上手新利基 | 市集可瀏覽／引用；作者可匿名 |
| US-21 | 訪客 | 免登入玩風格指紋測驗 | 認識產品 | 結果頁導註冊；可在 Threads 分享 |
| US-22 | 島民 | 看我跟同利基帳號中位數的比較 | 知道自己程度 | 匿名聚合；樣本不足時不顯示 |
| US-23 | 品牌島民 | 回覆裡的 UTM 連結自動算點擊成果 | 少手動填 | 點擊進歸因鏈；與手動成交可並存 |

## 8. 成功標準

- [ ] **P0：** 至少一條「海巡外展 → 送出 → 成果（對方回應或追蹤變化或手動成交）」完整歸因鏈可展示。  
- [ ] **P0：** 每週健檢報告自動產出，含 ≥3 條**帶證據**的行動建議，可一鍵跳功能，**且不扣點**。  
- [ ] **P0：** 用量頁從純成本視角改為成本＋成果並列。  
- [ ] **P0：** 人設／品牌資產頁可見學習摘要與版本。  
- [ ] **P1：** 健康分對每個已連帳號可見；&lt;40 時敏感自動送出被擋、僅人工路徑。  
- [ ] **P1：** 直邀首次升 Starter／Pro 分別入帳 100／300 點；月上限生效。  
- [ ] **P1：** 代操可在 2 個 Workspace 間切換，各自產出月報 PDF；草稿未經審核不可進 Outbox。  
- [ ] **定性：** 用戶訪談能說出「這工具幫我賺／省了多少」的**價值句**，而非只描述功能。

## 9. 約束與假設

- **約束：**  
  - `AGENTS.md` 全部契約精神（UTC nano、envelope、分頁、guarded job、go-zero、etc 單份、數字 uid、權限中介層）。  
  - 前端 `apps/web`：不引入新 UI 框架；mock｜live 同一 repository 介面；TC 台灣語感。  
  - **平台政策紅線：** 所有自動化必須保留人工路徑；灰帽功能只加護欄不擴大（§6 #5、#9）。  
  - 與 `haixun-backend` 的關係：本 run 是**加值層**；「Insights 真管線維持 P2」決策不變。  
  - MLM 紅線：單層、點數、非現金（§6 #4）。  
- **假設：**  
  - Threads API 至少能支撐「對話／互動計數」之一；全拿不到時仍以手動成交＋標記完成支撐歸因 MVP。  
  - 既有同步貼文成效資料足以支撐每週健檢最小版。  
  - 用戶願意手動回報成交（P0）；不願意時成果卡仍顯示對話／追蹤。

## 10. 風險

| 風險 | 影響 | 緩解（需求層） |
|------|------|----------------|
| 歸因訊號拿不到（API 權限限制） | P0 價值證明變弱 | §6 #1 降級路徑；禁止因缺訊號整段砍掉 |
| Meta 平台政策收緊 | 存亡級 | 健康分＋人工路徑＋功能開關；不新增灰帽玩法 |
| 學習閉環品質不穩、報告不可信 | 核心賣點崩壞 | 強制證據引用；每 7 日最多重產 2 次防刷 |
| 邀請獎勵被觀感為 MLM | 品牌風險 | 單層、點數非現金、首次升級才發、月上限 50% |
| 代操模式範圍爆炸 | 工期失控 | 同租戶 Workspace only；不做白牌域名／多租戶帳單 |
| P0 被 P1/P2 稀釋 | 本 run 失去存在理由 | §6 #7 交付順序硬性 |
| 邀請刷點（自建小號升級） | 成本黑洞 | 月上限 50%；僅首次付費；後續可加風控（spec） |

## 11. 開放問題（剩餘，僅技術驗證）

1. Threads API 實際可讀欄位對照表（追蹤數、回覆串、insights）→ **spec 驗證後寫死；缺的走 §6 #1 降級**。  
2. 健檢「週一」用 UTC 還是會員時區 → **spec 選一種寫死**（建議會員 `timezone`，無則 UTC）。  
3. Workspace 與現有 brand／persona／threads_account 資料表歸屬欄位命名 → **spec／plan**。  
4. 健康分權重精確公式 → **spec**（需求只鎖訊號方向與門檻帶）。

## 12. 批准

- [x] 需求已批准（2026-07-20／使用者「需求 OK」）