營運總覽
「營運總覽」(/admin,2026-09-03 起改為後台預設頁,原路徑 /admin/telemetry 仍可用、會 301 導向)集中管理 8 家分店的蝦皮聊聊 AI 助手營運狀態、商品上架對齊、買家端賣場探測與官網 /go/:sku 去單點化轉址策略。
頁面原則:
- 最上方為「分店健康」,一眼看出哪家店的擴充功能沒有正常上傳;接著是「待辦摘要」,聚合全站所有需要人工介入處理的事項。若顯示「目前無待辦」,代表艦隊運作正常,無需逐區檢查。
- 點擊頂部「重新整理」按鈕可手動向雲端獲取各分店最新彙總資料。
頁面十大區塊說明
1. 分店健康(Store Health,2026-09-27 新增)
- 以全部啟用中的分店為準(不像下面第 10 項「AI 用量與錯誤」只看近 14 天有動靜的店),每家店固定出現一列,即使完全沒回報過也不會消失、只會標紅。
- 每列顯示:ext-shopee-service 版本、最後回報時間、最後上架快照時間。內容基準店(目前是台中)多顯示「商品完整資料」筆數與最後擷取時間。
- 顯示規則(只顯示,不會擋任何上傳或擷取流程):
- 最後回報時間超過 6 小時:標黃。
- 最後回報時間超過 24 小時(或從未回報過):標紅。
- 版本不是雲端目前發佈的最新版:標黃,並附「未更新(最新 x)」。
- 兩個擴充功能(ext-shopee-service/shopee-copy-product)的雲端最新版分開顯示——目前只有 ext-shopee-service 有逐店版本回報,shopee-copy-product 尚無分店遙測,只能顯示雲端目前發佈的版本號,無法逐店比對。
- 標黃或標紅的列會直接附一句「下一步」,例如「到台中店電腦:Chrome 登入台中店蝦皮賣家帳號,開
chrome://extensions看 ext-shopee-service 版本,按重新載入」,不用先看程式碼或問技術人員才知道怎麼處理。
2. 待辦摘要(Action Items)
將散落於對齊、探測、遙測各處的異常聚合為一張優先清單(如快照過期、探測異常、待放行上報等)。有待辦事項時會以卡片標明優先級與處理引導。
3. 商品對齊(Product Alignment Matrix)
- 以台南店的上架快照為基準,跨 8 家分店比對線上實際架上商品。
- 資料由各店擴充功能在背景定時自報(無需跨店權限)。
- 若分店超過 7 天未上報,狀態標示為「資料過舊」,不判定成缺貨(無新鮮資料時不下負面判定)。
4. 分店與轉址(Store Status & Go Pick Policy)
- 分店啟用與優先級:停用的分店不會出現在官網首頁的分店快捷按鈕,也不會進入
/go/:sku商品購買轉址候選池。 - 挑店策略:
fixed(固定優先級):一律依分店設定的 Priority 排序挑選最高優先級者。by-sku(依貨號輪詢):透過貨號雜湊將不同商品均勻分流至不同分店。by-visitor(依訪客分桶):透過 Cookie 標記將同一訪客的所有點擊固定導向同一家分店。
5. 賣場探測(Storefront Probes)
- 各分店擴充功能每輪自動探測 8 家分店在買家端的公開賣場頁,呈現自動化健康狀態。
- 判定三態:
healthy(正常):買家端賣場頁正常顯示。blocked(已封鎖):買家端賣場頁顯示已被蝦皮封鎖或無法存取。unknown(無法確認):網路抖動或蝦皮反爬蟲攔截,無法斷定。
- 若任一分店超過 24 小時無探測回報,標示「探測過期」(僅代表該店擴充功能可能未啟動,不代表賣場有問題)。
6. 待放行上報(Quarantine / 零重疊拒收)
- 當分店新上報的
item_id集合與該店最新身分對照完全零重疊時,系統啟動第一層安全防禦自動拒收,防止污染 D1 資料庫。 - 管理員可在此檢視上報內容,並手動點擊「放行」寫入資料庫,或「捨棄」丟棄此批異常上報。
7. 身分不符拒收(Identity Mismatch)
- 擴充功能掃描時取得的同源登入身分(
shopId/account)與雲端記錄不符時的拒收存證紀錄。 - 此區塊為唯讀存證,無放行選項,防止寫入錯店資料。
8. 官網目錄對帳(Catalog Audit)
- 比對官網目錄收錄的商品與線上分店實際架上商品:
- 官網目錄有收錄、但在全部已上報分店皆查無的商品。
- 分店已上架、但官網目錄尚未收錄的商品。
- 僅供管理員比對對帳,不自動修改官網目錄。
9. 已移除商品(Site Product Removals)
- 判定時機:每 15 分鐘 Cron 排程,當所有啟用的分店均具備新鮮快照且皆查無某貨號時,自動記錄下架。
- 預設僅顯示目前缺貨未修復的項目,可勾選「顯示全部歷史」查閱已恢復紀錄。
10. AI 用量與錯誤(艦隊遙測 Telemetry)
- 監控各分店近 14 天的擴充功能運作狀態:
- 最後心跳:最近一次回報時間(確認擴充功能在線狀態)。
- 版本:各分店當前安裝的擴充套件版本號(提醒手動更新版本落後的分店)。
- 今日用量與最近錯誤:
- 呼叫成功:正常運作次數計數。
- 模型失敗:呼叫 LLM 失敗次數(若持續大量發生,請至「AI 模型設定」檢查 API 金鑰與額度)。
- 語料失敗:對話紀錄檢索失敗(逾時或連線異常)。
- 貼圖失敗:發送貼圖異常。
- 未知商品:買家提問但知識庫未收錄的商品名稱(可至「商品知識庫」補齊資料)。
- 心跳:在線狀態定期回報。
- 隱私安全:此區塊完全不收集或顯示任何買家交談原文,僅記錄計數與錯誤類型。