chore: 合併 develop 至 master（master 落後 4 個提交） #4

2026-08-21T08:44:04Z

jiantw83 commented

2026-08-21 08:44:04 +00:00

目的

把 develop 的 4 個提交合併回 master，讓 master 跟上最新進度。

內容

來源分支：develop
目標分支：master
落後提交數：4

🤖 Generated with Claude Code

## 目的把 develop 的 4 個提交合併回 master，讓 master 跟上最新進度。 ## 內容 - 來源分支：develop - 目標分支：master - 落後提交數：4 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jiantw83 added 4 commits 2026-08-21 08:44:05 +00:00

feat(gitea): gitea.sh 認證失敗時自動退回 tea CLI 登入 token 684d3f4f31

What（改了什麼）
- tools/gitea.sh 新增 tea_token()：解析 ~/.config/tea/config.yml，優先取 default: true 的登入 token，否則取第一個。
- 啟動時 GITEA_TOKEN 未設定或為空，改用 tea token；兩者皆無才維持原本的必填錯誤。
- req() 遇 HTTP 401/403 且 tea token 存在又與當前 token 不同時，換用 tea token 重試一次，之後不再重試。
- 檔頭用法註解補上退回機制的說明。

Why（為什麼改）
- 使用者規則：api token 401/403 時，若 tea CLI 已登入就取其 token 重試，避免因 GITEA_TOKEN 過期或未設定就直接中斷流程。

How（怎麼改）
- 以 awk 解析 tea 設定檔的 logins 清單，抓各登入的 token 與 default 旗標。
- req() 改為 while 迴圈包住 curl，retried 旗標保證最多重試一次；HTTP >= 400 仍以 exit 4 收場。
- 實測：sh -n 語法檢查通過；GITEA_TOKEN 為空時經 tea token 成功；GITEA_TOKEN=deadbeef 時走 401 重試路徑成功；無 tea 設定且 token 為空時維持原錯誤訊息。

Who（影響哪個功能／使用者）
- 所有經 tools/gitea.sh 呼叫 Gitea API 的技能（wiki、repo-sync、jsc-git pr 等）與使用者：token 缺失或失效時多一層自動救援，行為只在原本會失敗的情境改變。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

feat(wiki): wiki 技能新增圖表優先內容規則並更新 README 說明 1f17f1779a

What（改了什麼）
- skills/wiki/SKILL.md 新增兩條規則：頁面內容以圖表優先（mermaid 流程圖、時序圖、甘特圖、圓餅圖與 markdown 表格），純文字為最後手段且保持精簡；tools/gitea.sh 已內建認證退回機制，兩條路徑都失敗才回報認證錯誤。
- SKILL.md frontmatter description 補上 chart-first 說明，讓技能挑選時就能看到此規則。
- README.md：「Skills 目錄」的 wiki 條目補上圖表優先說明；環境變數表的 GITEA_TOKEN 一列補上 401/403 自動退回 tea CLI token 的行為。

Why（為什麼改）
- 使用者規則：wiki 輸出盡量用 mermaid 與表格呈現，不要只有純文字。
- 認證退回已在 tools/gitea.sh 實作，技能文件與 README 需同步，避免技能誤判認證失敗或文件與行為不一致。

How（怎麼改）
- 在 SKILL.md 規則清單追加第 4、5 條，並同步改寫 frontmatter description。
- README 對應兩處文字更新，與 gitea.sh 的實際行為一致。

Who（影響哪個功能／使用者）
- 使用 jsc-gitea:wiki 的所有呼叫方（jsc-ask、jsc-sdlc、jsc-log）：之後寫出的 wiki 頁會以圖表為主；閱讀 README 的使用者能得知 token 退回行為。

備註：README.md 的 GITEA_TOKEN 環境變數表一列在語意上屬於前一個 commit（tea token 退回），但為避免以 hunk 拆分 README，整檔併入本 commit。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

chore(plugin): 版本號由 0.0.1 升至 0.0.2 5e732f42fd

What（改了什麼）
- plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 的 version 同步由 0.0.1 改為 0.0.2。

Why（為什麼改）
- 本次加入 tea CLI token 退回與 wiki 圖表優先規則兩項功能，需要提升版本讓各 AI CLI 的插件更新機制抓到新版。

How（怎麼改）
- 三份 manifest 僅改 version 欄位，其餘內容不動，維持三處版本一致。

Who（影響哪個功能／使用者）
- 安裝 jsc-gitea 插件的所有 AI CLI 使用者：更新後可取得本次的功能。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Merge pull request 'feat/tea-token-fallback-and-chart-first-wiki' (#3 ) from feat/tea-token-fallback-and-chart-first-wiki into develop 51be91ce9d

Reviewed-on: #3

admin approved these changes 2026-08-21 08:56:03 +00:00

admin merged commit af398f6b15 into master

2026-08-21 08:56:06 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/gitea#4