Merge pull request 'docs：已知輸出差異補 mine／pulls 欄位集差異（#26）' (#27 ) from docs/issue26-output-fieldset-diff into main

Reviewed-on: #27
Merge pull request 'internal/cli：允許命令旗標與位置參數交錯（#25）' (#28 ) from fix/issue25-interleaved-flags into main
2026-09-10 18:51:29 +08:00 · 2026-09-10 15:38:37 +08:00 · 2026-09-10 15:24:09 +08:00
1 changed files with 6 additions and 0 deletions
@@ -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 的旗標剖析較寬鬆，兩者命令列介面以此行為對齊。
Author	SHA1	Message	Date
chenyunda218	fd3b8cbd6b	Merge pull request 'docs：已知輸出差異補 mine／pulls 欄位集差異（#26）' (#27 ) from docs/issue26-output-fieldset-diff into main Reviewed-on: #27	2026-09-10 18:51:29 +08:00
queena	3a587f60ad	Merge pull request 'internal/cli：允許命令旗標與位置參數交錯（#25）' (#28 ) from fix/issue25-interleaved-flags into main	2026-09-10 15:38:37 +08:00
ceo	3d555e38d9	docs：已知輸出差異補 mine／pulls 欄位集差異（#26） gitea.py 的 mine／pulls 輸出完整 API 物件是 _dump 直接傾倒的副作用，欄位集隨 Gitea 版本浮動；teai 維持策展摘要欄位（機器可讀優先），交叉驗證比對項目集合與判定語義，不逐欄位比對。判定 #26。	2026-09-10 15:24:09 +08:00