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	島民	看到每個帳號的健康分與降速建議	不怕被平台懲罰	送出前自動檢查；<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： 健康分對每個已連帳號可見；<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. 批准

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