docs: 補齊 JSDoc 與指令檔註解、測試移至 app/test 並重建 README #10

Merged
admin merged 16 commits from ai-review-resolve/develop-20260626-141504 into develop 2026-06-26 07:42:55 +00:00
2 changed files with 12 additions and 4 deletions
Showing only changes of commit 998b5ca5ac - Show all commits
+5 -3
View File
@@ -16,12 +16,14 @@ export const EXCLUSIONS_PATH = '.gitea/ai-review/exclusions.json';
* 建立一個停用 TLS 憑證驗證(`rejectUnauthorized: false`)的 HTTPS Agent
* 供連接使用自簽或無效憑證的 OpenCode 服務時使用。
*
* @remarks 次呼叫都會回傳全新的 Agent 實例(不快取),建議呼叫端重用以共用連線池。
* @remarks 次呼叫時建立,之後快取為模組層級單例(singleton)重複使用,
* 避免每次都新建 Agent 與連線池、浪費 TCP 三次握手。
* 停用憑證驗證有中間人攻擊風險,僅限受信任的內部環境使用。
Ghost marked this conversation as resolved
Review

嚴重等級🟡 警告
審查員:Rogue
問題:每次呼叫都 new https.Agent(),這會建立全新的 TCP 連線池,不僅增加記憶體碎片,還浪費三次握手建立連線的時間,根本沒發揮連線池的優勢。
建議:將 Agent 實例化為模組層級的靜態變數(Singleton),只在第一次呼叫時建立,後續重複使用。

**嚴重等級**:🟡 警告 **審查員**:Rogue **問題**:每次呼叫都 new https.Agent(),這會建立全新的 TCP 連線池,不僅增加記憶體碎片,還浪費三次握手建立連線的時間,根本沒發揮連線池的優勢。 **建議**:將 Agent 實例化為模組層級的靜態變數(Singleton),只在第一次呼叫時建立,後續重複使用。
Review

嚴重等級🟡 警告
審查員:Rogue
問題:每次呼叫都 new https.Agent(),這會建立全新的 TCP 連線池,不僅增加記憶體碎片,還浪費三次握手建立連線的時間,根本沒發揮連線池的優勢。
建議:將 Agent 實例化為模組層級的靜態變數(Singleton),只在第一次呼叫時建立,後續重複使用。

**嚴重等級**:🟡 警告 **審查員**:Rogue **問題**:每次呼叫都 new https.Agent(),這會建立全新的 TCP 連線池,不僅增加記憶體碎片,還浪費三次握手建立連線的時間,根本沒發揮連線池的優勢。 **建議**:將 Agent 實例化為模組層級的靜態變數(Singleton),只在第一次呼叫時建立,後續重複使用。
* @returns {import('https').Agent} 已關閉憑證驗證的 HTTPS Agent 例。
* @returns {import('https').Agent} 已關閉憑證驗證的 HTTPS Agent 例。
*/
let _openCodeHttpsAgent = null;
export function getOpenCodeHttpsAgent() {
return new https.Agent({ rejectUnauthorized: false });
return (_openCodeHttpsAgent ??= new https.Agent({ rejectUnauthorized: false }));
}
/**
+7 -1
View File
3
@@ -107,14 +107,20 @@ function cleanText(value) {
* @param {*} value - 任意值;非字串會先經 cleanText 轉為空字串。
* @returns {string} 正規化後、以單一空白分隔的字串(可能為空字串)。
* @remarks 用於 finding 與排除條目文字的雙向「包含」比對(applyExclusions、appendExclusions)。
* 因為比對常對同一段文字重複呼叫(findings × exclusions 笛卡爾積),
* 以模組層級 Map 對「字串輸入」做 memoization,避免重複跑 NFKC/正則替換。
*/
const _normalizeTextCache = new Map();
export function normalizeText(value) {
return cleanText(value)
if (typeof value === 'string' && _normalizeTextCache.has(value)) return _normalizeTextCache.get(value);
const result = cleanText(value)
.normalize('NFKC')
.toLowerCase()
.replace(/[\p{P}\p{S}\s]+/gu, ' ')
.replace(/\s+/g, ' ')
.trim();
if (typeof value === 'string') _normalizeTextCache.set(value, result);
return result;
}
/**