alterminal/teai
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs：已知輸出差異補 mine／pulls 欄位集差異（#26） #27

Merged
chenyunda218 merged 1 commits from docs/issue26-output-fieldset-diff into main 2026-09-10 18:51:30 +08:00
Conversation 0 Commits 1 Files Changed 1
+6
ceo commented 2026-09-10 15:24:18 +08:00
Member
Copy Link
Copy Source

內容

README「與 gitea.py 的對應與遷移」的已知輸出差異清單新增一條：mine／pulls 的欄位集差異（gitea.py 傾倒完整 API 物件 vs teai 策展摘要欄位），交叉驗證比對項目集合與判定語義、不逐欄位比對；next／stalled 為策展欄位、鍵集鍵序全等。

判定（#26）

採方向 2：teai 維持摘要輸出（機器可讀優先），差異補進 README 已知輸出差異清單。

理由：

  • gitea.py 的 mine／pulls 完整物件是 _dump 直接傾倒 API 回應的副作用，欄位集隨 Gitea 版本浮動，不是設計承諾；teai 的 stalled／next 能與 gitea.py 鍵集鍵序全等，是因為兩邊都是策展欄位。
  • 方向 1 要把 Gitea 序列化細節（鍵序、空值表示、時間格式、巢狀 user／repository 物件）凍結進 teai 型別，Gitea 升級即 drift，維護成本不成比例。
  • teai 全線命令（含 dailyops issues／pulls view）皆為策展欄位輸出，一致性好；消費端（agent 工作流）實際只讀 repo／number／title／url，判定語義兩者實測一致。

驗收

  • README 已知輸出差異清單含 mine／pulls 欄位集差異及其判定
  • 文件變更，不動程式碼
## 內容 README「與 gitea.py 的對應與遷移」的已知輸出差異清單新增一條：`mine`／`pulls` 的欄位集差異（gitea.py 傾倒完整 API 物件 vs teai 策展摘要欄位），交叉驗證比對項目集合與判定語義、不逐欄位比對；`next`／`stalled` 為策展欄位、鍵集鍵序全等。 ## 判定（#26） 採**方向 2**：teai 維持摘要輸出（機器可讀優先），差異補進 README 已知輸出差異清單。 理由： - gitea.py 的 mine／pulls 完整物件是 `_dump` 直接傾倒 API 回應的**副作用**，欄位集隨 Gitea 版本浮動，不是設計承諾；teai 的 stalled／next 能與 gitea.py 鍵集鍵序全等，是因為兩邊都是策展欄位。 - 方向 1 要把 Gitea 序列化細節（鍵序、空值表示、時間格式、巢狀 user／repository 物件）凍結進 teai 型別，Gitea 升級即 drift，維護成本不成比例。 - teai 全線命令（含 dailyops issues／pulls view）皆為策展欄位輸出，一致性好；消費端（agent 工作流）實際只讀 repo／number／title／url，判定語義兩者實測一致。 ## 驗收 - [ ] README 已知輸出差異清單含 mine／pulls 欄位集差異及其判定 - [ ] 文件變更，不動程式碼
ceo added 1 commit 2026-09-10 15:24:18 +08:00
docs：已知輸出差異補 mine／pulls 欄位集差異（#26） 3d555e38d9 
gitea.py 的 mine／pulls 輸出完整 API 物件是 _dump 直接傾倒的副作用，
欄位集隨 Gitea 版本浮動；teai 維持策展摘要欄位（機器可讀優先），
交叉驗證比對項目集合與判定語義，不逐欄位比對。判定 #26。
chenyunda218 merged commit fd3b8cbd6b into main 2026-09-10 18:51:30 +08:00
chenyunda218 deleted branch docs/issue26-output-fieldset-diff 2026-09-10 18:51:30 +08:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
bug
Something is not working
 duplicate
This issue or pull request already exists
 enhancement
New feature
 help wanted
Need some help
 invalid
Something is wrong
 question
More information is needed
 wontfix
This won't be fixed
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin alex ceo chenyunda218 (Dan Chen) iris max queena
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: alterminal/teai#27