# 用途：AI Code Review Action 的設定檔草稿，保留原始輸入與 Node 入口，並補上逐行說明。
# 更新時間：2026/07/11 18:54:51
# Action 顯示名稱，讓工作流程與使用者介面可以辨識此動作。
name: 'AI Code Review'
# Action 的簡短用途說明。
description: 'AI 程式碼審查'
# 作者或維護者名稱。
author: 'Jeffery'
# 定義此 Action 對外提供的輸入參數。
inputs:
  # 用於存取 Gitea API 的授權 Token。
  token:
    # token 參數的用途說明。
    description: '操作 Gitea API 的 Token'
    # 此參數為必要，執行時必須提供。
    required: true
  # 用於存取 Gitea Commit API 的授權 Token。
  comment_token:
    # comment_token 參數的用途說明。
    description: '操作 Gitea Commit API 的 Token'
    # 此參數為選填，沒有提供時不影響 Action 啟動。
    required: false
  # 指定執行 AI 程式碼審查時所使用的模型名稱。
  model:
    # model 參數的用途說明。
    description: '執行 AI 程式碼審查使用的 LLM 名稱'
    # 此參數為選填，未提供時由執行環境或預設值決定。
    required: false
# 宣告 Action 的執行方式與主要進入點。
runs:
  # 使用 Node.js 24 執行此 Action。
  using: 'node24'
  # Action 的主要進入檔，實際邏輯從此檔案開始。
  main: 'src/main.js'
