@@ -11,1 +11,4 @@
+  model:
+    description: '使用的 AI 模型'
+    required: false
 runs:

@@ -1,4 +1,11 @@
 #!/bin/sh
+# ============================================================================

@@ -0,0 +1,1703 @@
+# AI Code Review
+
+更新時間：2026/08/07 13:51:53

@@ -213,10 +235,28 @@ function toReviewComment(f) {
 }

@@ -371,7 +413,14 @@ function extractFileDiff(diff, file) {
 /**

@@ -111,0 +170,4 @@
+      { role: 'user', content: prompt },
+    ],
+    temperature: 0,
+    stream: false,

@@ -3,0 +5,4 @@
+ * @param {Date} [date] - 要格式化的時間點；省略時使用呼叫當下的系統時間。
+ * @returns {string} 例如 `2026/08/07 12:39:43`。
+ */
+function formatTimestamp(date = new Date()) {

@@ -54,1 +56,4 @@
+ * 目前程式碼中有 3 個 exit 1 呼叫點（未設定 CLIProxyAPI、取 diff 失敗、所有角色分析皆失敗）
+ * 退出前未呼叫 `section('Pipeline 結束')`，與其餘 exit 點不一致，會少一行收尾分隔線，
+ * 是否為刻意設計尚需人工確認。
  */

@@ -11,1 +11,4 @@
+  model:
+    description: '使用的 AI 模型，僅允許英數字、點、底線與連字號'
+    required: false
 runs:

@@ -11,2 +12,4 @@
+    description: '使用的 AI 模型，僅允許英數字、點、底線與連字號'
+    required: false
 runs:
   using: 'docker'

@@ -0,0 +1,1703 @@
+# AI Code Review

@@ -33,2 +34,4 @@
+ *   {@link postNewCriticalComments} 組裝 comment 內文使用。
+ *   使用情境：任何要把一批 findings 呈現成單一 Markdown 表格的地方，先篩好要顯示的子集合再呼叫本函式。
  */
 function buildTable(findings) {

@@ -77,0 +87,4 @@
+/**
+ * 產生單一 finding 的行內（inline）review comment 內文：等級／審查員／建議三行。
+ *
+ * @param {{ level?: string, role?: string, suggestion?: string }} f 單筆審查問題物件。

@@ -273,1 +312,3 @@
- * 發布所有舊問題 comment（一次發布，依等級排序）
+ * 發布所有舊問題的彙總 comment（一次性發布一則一般 comment，不含行內標註）。
+ *
+ * @param {Array<{ is_new?: boolean, level?: string }>} findings 審查問題陣列；

@@ -43,3 +43,4 @@
 export const FINDINGS_PATH = '.gitea/ai-review/findings.json';
 export const EXCLUSIONS_PATH = '.gitea/ai-review/exclusions.json';
+const MODEL_NAME_RE = /^[A-Za-z0-9._-]+$/;
 

@@ -330,14 +348,25 @@ export function mergeFindings(oldFindings, newFindings) {
 }
 

@@ -338,3 +361,3 @@
 
 /**
- * AI 呼叫失敗時的統一降級處理
+ * AI 呼叫失敗時的統一降級處理：記錄警告訊息後原樣回傳 findings（不做任何篩選），

@@ -571,8 +656,13 @@ async function judgeFindingIsFalsePositive(finding, defender, exclusionHint, cha
 }
 
 /**

@@ -26,6 +30,26 @@ export async function mapWithConcurrency(items, limit, fn) {
   const n = Number(limit);
   const workers = (!Number.isFinite(n) || n <= 0) ? list.length : Math.min(n, list.length);

@@ -105,0 +151,4 @@
+ *   僅使用 `apiKeys[0]`；`model` 可省略，省略時交由 CLIProxyAPI 自動選擇。
+ * @param {string} prompt - 送給 API 的完整 prompt 內容，會作為 user 訊息內容；
+ *   HTTP 層的 system 訊息為固定的通用指示，與 prompt 內可能內嵌的 `<system>` 內容無關。
+ * @returns {Promise<any>} API 回應的原始資料物件（`resp.data`），並非純文字；

@@ -105,1 +158,4 @@
+ * @remarks 逾時與輸出上限由環境變數 `AI_ASSISTANT_TIMEOUT_MS`／`AI_ASSISTANT_MAX_BUFFER`
+ *   控制，預設值為 15 分鐘／20 MB。
+ * @remarks 使用 `getInsecureHttpsAgent()`（停用 TLS 憑證驗證），適用內部自簽憑證環境。
  */

@@ -3,0 +4,4 @@
+ *
+ * @param {Date} [date] - 要格式化的時間點；省略時使用呼叫當下的系統時間。
+ * @returns {string} 例如 `2026/08/07 12:39:43`。
+ */

@@ -3,0 +15,4 @@
+    minute: '2-digit',
+    second: '2-digit',
+    hourCycle: 'h23',
+  }).formatToParts(date);

@@ -3,0 +16,4 @@
+    second: '2-digit',
+    hourCycle: 'h23',
+  }).formatToParts(date);
+  const map = Object.fromEntries(parts.map((p) => [p.type, p.value]));

@@ -94,5 +94,5 @@
   }
   return [...groups.values()].map(g => ({ ...g, thread: g.bodies.join('\n---\n') }));
 }
 
 /** codeWindow 預設的上下文行數（目標行上下各取幾行）。 */

@@ -0,0 +6,4 @@
+
+| 專案名稱 | 專案描述 |
+| --- | --- |
+| [AI Code Review](https://gitea.jsc.idv.tw/actions/ai-code-review/src/branch/develop/src) | Gitea Docker 容器 action：對 PR 的 diff 派多個角色進行 AI 程式碼審查，產生 findings 並依對話收斂、排除規則與 AI 誤報裁決收斂結果；負責 Gitea PR API（diff／comment／review／resolve）串接、CLIProxyAPI 對話與 usage／額度統計、git clone／commit／push 持久化 findings，以及執行前的 token／LLM／git 遠端前置驗證。 |

@@ -42,23 +42,28 @@ export const LLM_PROVIDER = 'cliproxyapi';
 
 export const FINDINGS_PATH = '.gitea/ai-review/findings.json';
 export const EXCLUSIONS_PATH = '.gitea/ai-review/exclusions.json';