# JarvisOps 社群工作台：給 AI 的引導手冊

> 這份手冊是寫給 **AI 助手**讀的。使用者把這個網址貼給你，是希望你**一步一步帶他把 JarvisOps 社群工作台設定好**：
> 登入、連上他店裡的社群帳號、發出第一篇貼文，必要時再把他自己的 AI 接上工作台。
> 網址：https://studio.jarvisos.live/ai-guide　｜　目錄：https://studio.jarvisos.live/llms.txt　｜　更新：2026-10-26

---

## 0. 帶人之前先遵守（很重要）

1. **一次只給一步。** 每一步說清楚「去哪個頁面、按哪個按鈕、會看到什麼」，然後等使用者回報結果再給下一步。
2. **用使用者的語言回答**（預設繁體中文），稱呼對方「你」。不要一次貼整份手冊給他。
3. **絕對不要向使用者要**：密碼、簡訊或 email 驗證碼、工作台 API 金鑰、LINE channel access token、任何平台的 client secret。
   這些只能由使用者自己填在官方頁面或工作台的欄位裡。使用者如果把它們貼進對話，請他立刻到原頁面撤銷或重發一組。
4. **帳號是使用者的，按鈕也由他按。** 建立帳號、登入、授權、同意條款，都是使用者在官方頁面親自操作；你只負責說明要按哪裡、哪一顆**不要**按。
5. **畫面和這份手冊不一樣時不要猜。** 請使用者描述畫面上的字或截圖給你看，再判斷下一步。各平台的選單常改版。
6. **不承諾工作台沒有的功能。** 這份手冊沒寫的、或使用者卡住超過兩次的，請他聯絡工作台管理者：hello@jarvisos.live。
7. 工作台網址只有一個：https://studio.jarvisos.live 。不要叫使用者到其他網址輸入工作台帳密。

---

## 1. 先問三件事，判斷從哪裡開始

開場先問使用者（一次問完沒關係）：

1. **你在工作台是店主還是員工？已經有帳號了嗎？**
   - 沒有帳號：員工沒有邀請也可以在登入頁按「建立帳號」，等管理者開通；管理者已把你的臉書加進白名單的，用 Facebook 建立就直接開通。帳號密碼建立一律待開通。若沒有按鈕，請向管理者索取邀請。店主仍由工作台管理者發「開店邀請」連結（第 2.1 節）。
   - 店主：可以連結所有社群帳號。
   - 員工：**連結社群帳號只有店主能做**。員工接受邀請時，如果邀請流程有「連結你自己的粉專」那一步，可以在那時連自己的粉專；其他平台請店主連。員工的重點通常是第 4 節（發文）和第 5 節（接上自己的 AI）。
2. **要發到哪些平台？** Facebook 粉絲專頁、Instagram、Threads、YouTube、LINE 官方帳號、TikTok、Google 商家檔案。
3. **這些平台的帳號已經有了嗎？是不是店的帳號（不是個人帳號）？**

依回答跳到對應章節。建議順序：Facebook 粉專 → Instagram → Threads →（需要的話）LINE、YouTube、TikTok。

---

## 2. 工作台基本

### 2.1 登入

- 沒有邀請：登入頁 →「建立帳號」→ 用 Facebook 或填稱呼、登入名稱、兩次密碼與選填粉專網址。管理者已把你的臉書加進白名單的，用 Facebook 建立就直接開通並開自己的品牌；不在名單、名單無法確認或使用帳號密碼，都先待開通。
- 待開通：只顯示稱呼、送出時間與登出；不能發文、接上 AI 或使用 AI 額度。請等管理者在「員工管理 → 待開通」開通，不要引導你去建立金鑰或配對。開通後重新查看首頁。
- 有邀請連結：打開連結 → 設定帳號名稱與密碼（使用者自己設）→ 完成後到 https://studio.jarvisos.live/login 登入。邀請連結有效期限有限，過期請邀請人重發。
- 已經是 Facebook 應用程式測試人員的人，登入頁「其他登入方式」可以用 Facebook 登入。
- 忘記密碼：請管理者（員工請店主）給重設密碼連結。

### 2.2 畫面在哪裡

- 首頁選品牌（一家店通常一個品牌）。
- 車行品牌：主要入口是「今天要做什麼、車輛庫、自動輪播、發布紀錄」，其他用途與帳號在更多。其他品牌仍用下述五步。
- 非車行的「發文流程」五步：**1. 連結粉專**（帳號頁，標題「連接你的品牌帳號」）、**2. 建立任務**、**3. 寫草稿**、**4. 預覽確認**、**5. 排程發布**。
- 「更多」選單：照片庫、草稿清單、素材庫、排程清單、發布紀錄、設定與用量、API 金鑰、接上我的 AI、使用說明（店主另有員工管理）。
- 帳號頁每個平台一張卡片。卡片上的狀態：「尚未連結」→「已連結」；另外有「試行模式：不會真的發出」或「正式發布已開啟」。**已連結不代表會真的發**，要看是不是正式模式。

---

## 3. 連結各平台（店主）

> 目前工作台的 Facebook／Instagram／Threads 應用程式與 TikTok 應用程式還在平台審核前的測試階段，**只有管理者加進測試名單的帳號才能授權**。
> 授權時出現「應用程式未啟用」「無法使用」「不是測試人員」這類訊息，請使用者聯絡管理者把他加入測試名單，並照管理者說明到該平台接受邀請。

### 3.1 Facebook 粉絲專頁

前提：使用者是該粉專的管理員。

1. 若管理者已把他加為 Meta 應用程式測試人員：請他到 Facebook「設定與隱私 → 設定 → 應用程式和網站 → 開發者請求」按接受（沒看到就先略過，授權失敗再回來處理）。
2. 工作台 → 品牌 → 「1. 連結粉專」→ Facebook 卡片 →「連結粉專」。
3. 在 Facebook 的授權畫面登入、按繼續，勾選要給工作台的粉專（使用者本人操作）。
4. 回到工作台，卡片顯示「已連結」和粉專名稱就完成。
5. 要真的發文：卡片裡的「發布模式」選正式，勾確認後儲存。

### 3.2 Instagram

前提：IG 必須是**專業帳號（商家或創作者）**，而且**連到上面那個 Facebook 粉專**。工作台是透過粉專找到 IG 的。

先問：「你有店用的 IG 嗎？是個人帳號還是商家帳號？」

- **沒有 IG**：建議另開店用帳號（IG App「新增帳號」，或網頁 instagram.com 註冊），由使用者本人註冊。
- **只有個人帳號**：提醒他切成專業帳號後**帳號會變公開、以前的貼文全部公開**，而且一個 IG 專業帳號同時只能連一個粉專。多數店家應另開店用帳號。
- **切成商家帳號**：IG 設定 → 帳號類型和工具 → 切換為專業帳號 → 商家 → 選類別（例如車行選「汽車經銷」）。聯絡資料可先只填電話。
- **連到粉專**（擇一）：
  - IG App：個人檔案 →「編輯個人檔案」→「粉絲專頁」→ 連結既有的粉專（選工作台連的那一個）。
  - 電腦：Meta Business Suite（business.facebook.com）→ 選該粉專 → 設定 → 連結 Instagram 商業檔案。過程中會跳出新視窗（若被瀏覽器擋住，允許彈出視窗後再按一次「繼續」）。
- 回工作台帳號頁 Instagram 卡片 → 按「**重新查詢 IG 連結**」→ 找到後按「**啟用**」。**啟用後就是正式發布**，之後排程到時間會真的發到 IG。
- IG 貼文至少要一張圖片，不能只發文字。

### 3.3 Threads

1. 使用者用店的 IG 帳號登入 threads.com（或 Threads App），選「使用 Meta 帳號加入」建立 Threads 個人檔案。
2. 請管理者把這個 Threads 帳號加入測試名單；之後使用者到 Threads「設定 → 帳號 → 網站權限 → 邀請」按**接受**。
3. 工作台帳號頁 Threads 卡片 →「連結 Threads」→ 授權畫面「以 ○○ 的身分繼續」（本人按）。
4. 連上後是**試行模式**；卡片「發布模式」選正式、勾確認、儲存。

### 3.4 YouTube

1. 建議為店開一個頻道：YouTube → 設定 → 所有頻道（或「建立頻道」）→ 填頻道名稱。這會建立一個 Google「品牌帳戶」。
2. 工作台帳號頁 YouTube 卡片 →「連結 YouTube」→ Google「選擇你的帳戶或品牌帳戶」→ **選頻道那個品牌帳戶**（不是個人帳戶）。
3. 若看到「Google 尚未驗證這個應用程式」：按「進階」→「前往 jarvisos.live（不安全）」。（工作台的 Google 驗證在審核中，通過後就不會出現。）
4. 授權頁**兩個權限都要勾**：管理 YouTube 影片、查看 YouTube 帳戶。少勾一個，工作台會不能上傳或讀不到頻道。
5. 連上後是試行；卡片「發布模式」選正式上傳、勾確認、儲存。
6. 目前工作台一律以**私人**上傳影片；公開與否請使用者到 YouTube 自己改。

### 3.5 LINE 官方帳號

1. 使用者登入 LINE 官方帳號管理後台 manager.line.biz。沒有官方帳號就由他本人建立（帳號名稱、業種；台灣輕用量免費，每月 200 則訊息）。
2. 該帳號 → 設定 → Messaging API →「啟用 Messaging API」→ 選服務提供者。
   **提醒：服務提供者選了就不能改。** 建議新建一個以店名命名的提供者，不要選別家公司的。接著同意 API 條款（本人按）。隱私權政策、服務條款網址可以先留空。
3. 到 LINE Developers（developers.line.biz）→ 同一個提供者 → 同一個 channel → Messaging API 分頁 → 最下面「Channel access token (long-lived)」→ 按「Issue」→ 按旁邊的複製圖示。
4. 回工作台帳號頁 LINE 卡片 → 把 token **貼在「長期 channel access token」欄位**（不要貼給你）→「驗證並連結 LINE」。成功後只顯示末四碼、好友數與本月額度。
5. 連上後是試行。**要切成正式發送，請使用者聯絡管理者**（工作台目前沒有讓使用者自己切的按鈕）。
6. 提醒：LINE 訊息是發給好友、按人頭計費；每次廣播前要回工作台看額度試算並按確認。好友是 0 的話，先在店裡放 QR code 讓客人加好友。

### 3.6 TikTok

目前 TikTok 應用程式在測試階段，只有管理者加進測試名單的 TikTok 帳號能連。

1. 請使用者先把要連的 TikTok 帳號名稱給管理者；管理者加入後，使用者會在一個 TikTok 授權畫面按「繼續」（成為測試使用者）。
2. 工作台帳號頁 TikTok 卡片 →「連結 TikTok」→ TikTok 授權畫面（確認登入的是店的帳號）→ 繼續。
3. 影片會先送到使用者 **TikTok App 的收件匣（草稿）**，要他在 App 裡按發布才會公開。切成正式傳送請聯絡管理者。
4. 提醒：TikTok 網頁版不能在同一個登入裡切換多個帳號，要登出個人帳號再登入店的帳號；手機 App 可以在個人檔案上方帳號名稱 →「新增帳號」切換。

### 3.7 Google 商家檔案

工作台的 Google 商家檔案功能需要 Google 另外核准（要求商家檔案已驗證滿 60 天且有網站），**目前還不能從工作台發布**。
可以先帶使用者在 Google 地圖找到店 →「聲明這個商家」→ 完成驗證、填好營業時間與電話，等之後開放。
（繁中介面填營業時間若一直說時間無效，可以把網址裡的 `hl=zh-TW` 改成 `hl=en`，用「10:00 AM」這種格式輸入。）

---

## 4. 發出第一篇貼文

### 車行：先建車輛庫

1. 車輛庫 → 新增車輛，同頁填已知資料與照片（一次最多 10 張），預設在庫。第一張為封面，車頭請用「設為第一張」。售價、年份、里程可空白，文案會省略；車型與狀態可空白存檔，但依目前共用契約確認前仍須填妥。
2. 按「產生文案」一起儲存資料與照片；有 AI 額度就用 AI，沒有或暫時失敗時使用固定模板。核對五平台示意預覽，不合限制或沒連結的列出原因、不納入確認。
3. 親手勾核對聲明 →「確認入庫」。Facebook、Instagram、Threads、TikTok 收件匣與 Google 商家檔案依可用條件一次確認。Google 只用封面照，TikTok 仍要到 App 完成。
4. 指定發：「立即發這台」沿用已確認文案，可正式發的帳號預設全選，盡快約 5 分鐘後；勾核對再按「確認並排程」。輪播：選每天 1～5 台與時段、一次勾所有帳號，每時段同一台車發到所有所選帳號，全部輪完才重來；不再呼叫 AI。
5. 改價或照片 →「重新產生並確認」；首頁與車輛庫會提醒待重新確認。賣出 →「標為已售出」，取消未送出的排程。既有貼文需去平台處理；正在發送的請求無法保證撤回。
6. 車輛庫看每台正式與試行次數，「看發過哪些」篩選發布紀錄。常用社團只存名稱網址；「分享到社團」開 Facebook 官方分享畫面，使用者選社團並自行送出。只記按過，不知道分享成功與否。

LINE 全部好友廣播每次需要看人數／額度試算，YouTube 需要影片與專用核對，不進車輛入庫或輪播。以下保留其他品牌與進階用途的流程。

建議先用練習資料走一次，只走到「預覽確認」，不要建排程。

1. **建立任務**：品牌 →「2. 建立任務」→ 選類型（車輛、活動、照片、影片…）→ 填已確認的事實（例如車款、年份、里程、價格、狀態）→ 儲存。
2. **素材**：任務裡勾選素材，或先到「更多 → 素材庫」上傳照片／影片（JPEG、PNG、WebP、MP4）。
3. **寫草稿**：「3. 寫草稿」→ 按「AI 幫我寫」（工作台內建寫稿助手），或自己寫。**請使用者核對數字**，特別是價格、里程、年份。
4. **確認並排程**：草稿頁直接看各平台示意預覽。先儲存文案與照片，在「確認並排程」選帳號（可正式發布的預設全勾，不能發的列原因且禁用），選「盡快」（伺服器以送出時刻加 5 分鐘）或指定未來的台北時間。親手勾「已比對目前任務…確認內容正確」，按「確認並排程」。
5. **查看結果**：結果頁列出「已排定 N 篇」、各帳號、時間、發布模式，以及未排定帳號的原因。部分失敗不影響其他帳號；建立不等於已發出，請到排程清單看執行結果。

**進階舊流程仍可用**：草稿頁展開「進階：分開確認內容與安排發布」→ 選平台 → 勾核對聲明 →「確認選取平台的內容」→「選帳號與排程時間」→「更新檢查」→「確認建立排程」。LINE 全部好友廣播必須閱讀試算並另外勾確認，不能用一步流程略過；YouTube 與工廠成片也必須走專用核對。試行模式帳號請走進階流程。

未儲存的文案／照片不可直接排程；先儲存，再核對一次即可。任務或草稿被另一頁修改時會拒絕舊核對，需重新載入。Facebook 無照片會提醒純文字；Instagram 必須有照片或影片。
**執行後看結果**：「更多 → 排程清單」或「發布紀錄」。**排程成功不等於已發布**；顯示成功且有平台的貼文編號才算數。結果「不確定」時，先到社群平台看有沒有貼出，**不要重排**，以免發兩篇。

沒有 API 的平台（例如 LINE VOOM、Dcard、8891、591）：草稿頁「帶去其他平台」可以複製文案、下載圖卡，再由使用者自己貼上。

---

## 5. 把使用者自己的 AI 接上工作台（選用）

接上之後，使用者可以直接用說的請 AI 建任務、寫稿、排程、查結果。需要能使用「外部工具」的 AI（支援 MCP 或 OpenAPI，且能設定 Bearer 金鑰）。

- **Codex、Claude Code、Gemini CLI、Cursor**：工作台「更多 → 接上我的 AI」→ 按「接上我的 AI」→ 複製那一行指令，貼給該 AI 執行（電腦要有 Python 3.9 以上）→ 重新啟動 AI → 說「用 jarvis_studio 列出我的品牌」。配對碼 10 分鐘內有效、只能用一次。
- **ChatGPT**：工作台「更多 → API 金鑰」建立金鑰（只顯示一次，請使用者自己保存）→ ChatGPT 建立自訂 GPT → 新增 Action → 從網址匯入 OpenAPI：https://studio.jarvisos.live/api/v1/openapi.json → 驗證選 API Key／Bearer、填金鑰。ChatGPT 網頁版「連接器」只接受 OAuth，不能用。
- **Claude App**：建立金鑰 → 設定 → 連接器 → 新增自訂連接器，MCP 網址：https://studio.jarvisos.live/mcp，在 Bearer 或 Authorization 欄位填金鑰。App 只接受 OAuth、沒有金鑰欄位時接不上，請改用上面的一行配對。
- 金鑰**只填在連線設定**，不要貼進聊天。每個 AI 用一把金鑰，不用時到「API 金鑰」撤銷。

接上之後，如果你（AI）就是被接上的那一個：先呼叫 `get_started()` 工具，它會回傳完整的操作規則、可用品牌與下一步。

---

## 6. 常見狀況

| 使用者說 | 怎麼帶 |
|---|---|
| 「按了連結沒反應」 | 可能彈出視窗被擋：請他允許彈出視窗再按一次；或換 Chrome 再試 |
| 「授權畫面說應用程式不能用」 | 測試階段：請他聯絡管理者加入測試名單（第 3 節開頭） |
| 「IG 查不到」 | IG 不是專業帳號、或沒連到這個粉專、或連到別的粉專（第 3.2 節） |
| 「卡片寫試行模式」 | 還不會真的發；FB、Threads、YouTube 在卡片「發布模式」切正式；LINE、TikTok 請管理者切 |
| 「排程成功了但沒看到貼文」 | 先看排程清單的結果；到時間才會送；結果不確定時先查平台，不要重排 |
| 「LINE 廣播一直要確認」 | 正常：每次都要回工作台看額度試算並確認 |
| 「YouTube 影片是私人」 | 正常：工作台目前一律私人上傳，請到 YouTube 自己改公開 |
| 「TikTok 沒有直接發出」 | 正常：先進 App 收件匣，要在 App 按發布 |
| 「忘記密碼」 | 員工找店主、店主找管理者，要重設密碼連結 |

聯絡管理者：hello@jarvisos.live（請使用者附上畫面上的錯誤訊息與時間，**不要附密碼、驗證碼或金鑰**）。
# 車輛自動輪播

`get_rotation(brand_id)` 讀設定與進度；`set_rotation(brand_id, data)` 設 enabled、daily_count（1～5）與等數量 slots，每項含 time（台北 HH:MM）和 account_ids 陣列。所有時段使用帳號聯集，每個時段同一台車發到所有目標帳號；每日上限按台數。舊 account_id 單值仍接受，但儲存後正規化為聯集 account_ids。使用者要先核對設定。
輪播只用已確認且對所有所選帳號有效的在庫車輛文案，不自動確認、不改寫、不耗 AI 額度。指定成功的車計入當輪，重啟不重複計入；結果不確定要先對帳。缺某平台確認時，重新產生並確認或調整所選帳號，不能直接繞過確認。