# registry/aliases.yaml
#
# Scope 級別的搜尋同義詞表。
# 當 canonical_id 以某個 scope 為前綴時，Registry 建立 Vectorize 索引時
# 會自動把對應的 aliases 合併進去，不需要零件作者手動填寫。
#
# 維護原則：
# - 這裡只放 scope 的同義詞，不放動作詞（append / send / read）
# - 中英文、縮寫、口語化說法都放進來
# - 未來接入 KBDB 後，此表將成為 KBDB synonym graph 的初始資料
#
# 新增 scope：開 PR，在對應 category 下加一個新 key

scopes:

  # ── 整合類（category: api）──────────────────────────────────────────────────

  gmail:
    - email
    - mail
    - 電子郵件
    - 信件
    - google mail
    - 寄信
    - 發信

  google_sheets:
    - gsheets
    - spreadsheet
    - google 試算表
    - 試算表
    - google sheet
    - sheets
    - excel              # 使用者常用 excel 描述試算表需求

  telegram:
    - tg
    - telegram bot
    - bot 通知
    - 機器人通知

  line_notify:
    - line
    - line 通知
    - line bot
    - 推播

  http_request:
    - http
    - api call
    - fetch
    - rest
    - webhook
    - curl
    - 外部 api
    - 呼叫 api

  # ── 資料處理類（category: data）────────────────────────────────────────────

  string:
    - 字串
    - text
    - 文字
    - str

  array:
    - 陣列
    - list
    - 清單
    - 列表

  date:
    - 日期
    - time
    - 時間
    - datetime
    - timestamp

  number:
    - 數字
    - 數值
    - numeric
    - math
    - 計算

  json:
    - 物件
    - object
    - 資料轉換

  # ── 控制流類（category: logic）─────────────────────────────────────────────

  if:
    - 條件
    - condition
    - 判斷
    - branch
    - 分支

  foreach:
    - 迴圈
    - loop
    - iterate
    - 遍歷
    - each

  switch:
    - 多路由
    - route
    - 路由
    - case

  try_catch:
    - 錯誤處理
    - error handling
    - fallback
    - 例外

  wait:
    - 延遲
    - delay
    - sleep
    - 等待

  # ── AI 類（category: ai）────────────────────────────────────────────────────

  ai:
    - llm
    - gpt
    - claude
    - 語言模型
    - 自然語言
    - 智慧
    - 生成