From 3d555e38d982cc4ce28be406e8e045833752a585 Mon Sep 17 00:00:00 2001 From: ceo Date: Thu, 10 Sep 2026 15:24:09 +0800 Subject: [PATCH] =?UTF-8?q?docs=EF=BC=9A=E5=B7=B2=E7=9F=A5=E8=BC=B8?= =?UTF-8?q?=E5=87=BA=E5=B7=AE=E7=95=B0=E8=A3=9C=20mine=EF=BC=8Fpulls=20?= =?UTF-8?q?=E6=AC=84=E4=BD=8D=E9=9B=86=E5=B7=AE=E7=95=B0=EF=BC=88#26?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit gitea.py 的 mine／pulls 輸出完整 API 物件是 _dump 直接傾倒的副作用， 欄位集隨 Gitea 版本浮動；teai 維持策展摘要欄位（機器可讀優先）， 交叉驗證比對項目集合與判定語義，不逐欄位比對。判定 #26。 --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 9ce3462..8e0d63a 100644 --- a/README.md +++ b/README.md @@ -276,6 +276,12 @@ teai whoami # 目前帳號（讀 tea 組態） - **空清單**：`gitea.py` 的 `_dump` 對空清單**不輸出任何內容**；teai 的清單類命令 （`mine`／`pulls`）空清單輸出 `[]`。對 JSON 消費者來說 `[]` 比「無輸出」更明確， 交叉驗證時以此差異為準。`next` 兩者語義相同（無工作 → `null`／「沒有未完成的工作」）。 +- **清單欄位集（`mine`／`pulls`）**：`gitea.py` 直接傾倒完整 Gitea API 物件 + （`_dump` 的副作用，欄位集隨 Gitea 版本浮動）；teai 輸出策展摘要欄位 + （`mine`：repo／number／title／url；`pulls`：number／title／state／author／ + head／base／updated_at…依命令定義）。交叉驗證比對**項目集合**（列出哪些 + issue／PR）與判定語義，不逐欄位比對；`next`／`stalled` 兩者為策展欄位且 + 鍵集鍵序全等，可逐欄位比對。判定 #26（維持摘要、文件化差異）。 - **全域選項位置**：teai 的全域選項（`--output` 等）可出現在命令之前或之後， 且可與命令旗標交錯（`teai members --has-work --output table`）； gitea.py 的旗標剖析較寬鬆，兩者命令列介面以此行為對齊。 -- 2.54.0