AI agent 資料匯入指南

JSON 格式 myconcerts-export-v1 · 更新：2026-10-23

本頁規範「匯入備份」接受的 JSON 格式、欄位限制、範例、隱私要求與操作契約。匯入檔案必須符合 myconcerts-export-v1 格式。

1. 匯入前確認與操作契約

輸入必須是符合格式的 JSON。請依下方欄位表提供已確認的演出資料，明確區分演出日期與購票日期，時間使用演出當地時間並指定時區。未知必填資訊須先補齊；未知選填欄位應省略，不猜測內容。

檔案規格。使用 UTF-8 編碼的 .json 檔，內容須符合下方格式、欄位型別與容量限制；未知金額應省略，0 代表真實零元。
授權範圍。匯入須有使用者對本次 JSON 內容、新增場次、目的帳號及本機／雲端儲存方式的明確授權。未獲授權不得選檔或執行匯入。
經由網站匯入。先由使用者或獲授權的 agent 透過「下載資料」保存現有文字記錄備份，再到「個人頁面」的資料管理區選「匯入備份」，閱讀並確認場次數量。未登入只存目前瀏覽器；登入後才寫入該帳號的雲端資料。
核對結果。確認網站顯示的新增／跳過數量與可見記錄、不公開狀態；登入時須確認雲端已同步，重新載入後記錄仍在。必要時經網站下載資料，比對僅新增預期場次、指定欄位一致且既有記錄未變，不以按鈕點擊成功當作匯入完成。不要為了驗證而新增、公開或刪除其他資料。

目前沒有對外寫入 API、CLI 或 MCP。window.MC.importShows 是網站內部函式，不是外部接口；不要直接呼叫它、修改 localStorage 或寫入資料庫來跳過上述確認。

2. JSON 格式與可複製範例

頂層必須是物件，包含 "format": "myconcerts-export-v1" 與 shows 陣列。檔案不得超過 2,097,152 bytes（2 MiB，介面稱 2MB）；每份最多 100 筆，與現有資料合併後也不得超過 100 場。

匯入只採用下列支援欄位。頂層只使用 format 與 shows；匯出檔中的 exportedAt、profile 及其他頂層欄位不會還原。每筆場次的 id 另行處理，其餘只保留下表白名單欄位；白名單以外的欄位會忽略、不儲存，不會僅因多出欄位就拒絕整份 JSON。額外欄位被忽略，不代表會移除支援欄位值中夾帶的資訊。

每一筆 shows 的完整支援欄位（含 ID）
欄位	指南要求	格式與限制
`id`	必填	每筆新記錄產生一個 UUID，保存原檔供重試；檔內不可重複。不得含 `/`，不超過 200 字元。既有備份保留原 ID。
`artist`	必填	非空字串，最多 80；建議與 lineup 第一位一致。
`lineup`	必填	1–50 個藝人名稱字串，每個都不可為空白。
`genre`	必填	字串，最多 30；沿用網站分類，不確定分類時用「其他」，不要臆測曲風。
`date`	必填	`YYYY-MM-DD`，必須是實際存在且已確認的演出日期。不可填購票日期或用今天代替未知日期。
`venue`	必填	非空場館名稱，最多 120。不要以本機能接受空字串推定雲端也接受。
`cur`	必填	`TWD`、`KRW`、`JPY`、`HKD`、`MOP`、`USD`、`THB` 或 `SGD`，須與金額相符。
`pub`	必填	布林值；agent 新產生的記錄一律用 `false`，不是字串 `"false"`。
`timezone`	建議明填	IANA 時區，例如 `Asia/Taipei`、`Asia/Tokyo`。省略會使用台北時區；海外演出不可直接套台北時間。
`title`、`time`、`org`、`alias`	選填	文字；時間若已確認，使用演出當地的 `HH:mm`。未知時省略，不捏造。
`face`、`paid`	選填	分別為票面價與實付金額，使用 JSON 數字而非含幣別或千分位的文字。未知時省略，0 代表真實零元。
`seatZone`、`seatRow`、`seatNum`	選填	座位區、排、號文字。介面分別以 24、8、8 字元處理；匯入器未逐項檢查長度。顯示時會補上區／排／號單位。
`seat`	選填／相容	舊版合併座位文字；沒有分項座位時用於解析顯示，有分項時以分項為準。
`rate`、`rateDate`	選填／匯率	對台幣匯率數字與匯率日期文字。既有備份若幣別、演出日期未變，可沿用原值；否則由網站取得匯率。TWD 或未提供實付金額時清為 null；外幣匯率取得失敗可能中斷匯入。
`hideSeat`	選填／相容	既有座位隱藏旗標，建議為布林值；匯入器未檢查其型別，公開場次投影目前不以此欄位遮蔽座位，不構成隱私保證。
`srcUrl`、`conf`、`urlStatus`	選填／相容	既有備份保留欄位，原值會保留。匯入器未另訂型別或長度驗證，目前介面也未使用；新資料可省略。

以下全部是虛構示例，不要當成真實場次匯入。建立新記錄時重新產生自己的 UUID；重試已產生的檔案時，不要再換 UUID。

{
  "format": "myconcerts-export-v1",
  "shows": [
    {
      "id": "09f79a87-4a3a-48e8-b105-85bd8a090521",
      "artist": "示範樂團",
      "lineup": ["示範樂團"],
      "genre": "其他",
      "title": "虛構演出示範",
      "date": "2027-01-15",
      "timezone": "Asia/Taipei",
      "venue": "虛構示範場館",
      "cur": "TWD",
      "pub": false
    }
  ]
}

上表區分建議格式與程式實際行為。匯入器並未完整驗證實際日期或所有選填欄位；接受檔案不代表內容正確。雲端儲存仍受安全規則與資料大小限制；表格中的相容欄位不是新的對外 API。

3. 重複、部分失敗與重試

只依 ID 跳過既有記錄。相同藝人、日期和場館但 ID 不同，仍可能新增重複場次；相同 ID 即使內容不同也不會覆蓋或更新。更正既有資料應使用網站編輯功能，另取得修改授權。
同一檔案的 ID 必須唯一。目前本機匯入不會完整排除檔內重複 ID；雲端的容量預檢也可能把重複筆數算入。不要依賴匯入器替你修正。
保留固定 ID 的原檔。缺少或不合法的 ID 可能每次重新產生，超長 ID 會被截斷；不要省略 ID、每次重試換 ID，或複製別人的固定示例 ID。
中斷不等於全部取消。雲端是逐筆匯入，已成功的場次會保留。先讀取結果與新增數量；確認原檔 ID 固定且唯一，再在授權範圍內重試同一份檔案。若仍失敗就停止，不改 ID、不刪資料來強迫重跑。
匯率與公開同步可能另行失敗。外幣實付金額可能需要網路取得匯率，不要偽造 rate 或 rateDate。若提示「記錄已儲存，但公開頁尚未更新」，不要重加場次，應分開處理同步問題。

4. 私密預設與資料邊界

場次的公開開關會匯入。profile 個人頁設定雖不還原，pub 仍會生效。若個人公開頁已開啟，pub:true 可能立即公開；匯入含 true 的備份須有對應的公開授權，否則不得匯入。
JSON 不包含圖片檔，也不會還原個人公開頁設定。此指南不提供圖片上傳、帳號設定、公開分享或帳號刪除的操作授權。
備份檔可能含名稱、個人頁設定及座位等私人資料，只能存放於使用者核准的位置，不貼到公開頁、記錄或未核准的外部服務。