從 sambot 匯入

如果您正在從 sambot.ru 遷移，GetMyBot 可以完整接收您的機器人：反應、標籤、媒體，甚至與使用者的對話歷史。遷移分為兩個步驟——從 sambot 匯出資料（使用匯出工具或瀏覽器擴充功能），然後將取得的封存檔匯入 GetMyBot。

可遷移的內容

  • 反應 — 機器人的完整行為邏輯。
  • 標籤 — 訂閱者的標記（含顏色）。
  • 媒體 — 反應所引用的圖片與檔案。
  • 對話歷史 — 機器人與使用者的通訊記錄（以獨立封存檔形式）。

匯入反應包

反應封存檔（mybot-export.zip）可上傳至機器人：POST /api/bots/{id}/reactions/import。封存檔內容：

  • manifest.json — 標頭：格式版本、來源（sambot）、機器人名稱、匯出日期、計數。
  • reactions.json — 反應陣列（必要）。
  • labels.json — 標籤清單（選填）。
  • media/<sha256>.<ext> — 媒體檔案（選填）。

提供兩種模式：

  • 新增（append）— 封存檔中的反應新增至現有反應。
  • 取代（replace）— 先刪除機器人目前的反應，再從封存檔載入。

反應包解壓縮後的總大小限制為 64 MiB。

匯入對話歷史

對話記錄以獨立封存檔（mybot-dialogs.zip）遷移：POST /api/bots/{id}/dialogs/import。封存檔包含使用者資料及其附件訊息，讓用戶頁面中立即可見過去的對話記錄。

對話封存檔解壓縮後的總大小限制為 256 MiB。

匯出工具（Python）

tools/sambot_export 套件透過 session cookie 爬取 sambot.ru 上的機器人、下載媒體，並將所有內容打包成 zip 封存檔。在 tools/sambot_export 目錄中執行：python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip。

  • 預設匯出反應、標籤與媒體。
  • --mode dialogs 模式可將對話歷史匯出至獨立的 mybot-dialogs.zip。
  • 授權方式——僅限 cookie（來自已登入的 session；登入表單有反機器人權杖保護，密碼無法使用）。Cookie 從瀏覽器取得。

Chrome 擴充功能

若不方便使用命令列，有一個 Chrome 擴充功能（MV3）「GetMyBot — sambot 匯出工具」。它可直接在瀏覽器中從 sambot.ru 頁面匯出機器人：請求存取目前分頁與下載權限，適用於 https://sambot.ru/*，且 session cookie 不會離開瀏覽器。輸出為同樣可匯入 GetMyBot 的 zip 封存檔。

遷移步驟

  1. 使用匯出工具或擴充功能匯出機器人——取得 mybot-export.zip（以及視需要的 mybot-dialogs.zip）。
  2. 將反應包匯入機器人（選擇「新增」或「取代」模式）。
  3. 視需要匯入對話歷史。
  4. 檢查反應與標籤，視需要確認媒體庫。

後續步驟