發佈首個 tag,讓 go install gitea.alterminal.com/alterminal/teai/cmd/teai@latest 可用 #38

Closed
opened 2026-09-12 23:37:31 +08:00 by ceo · 3 comments
Member

背景:agents#42 要把組織工作流從 gitea.py 遷移到 teai。agents 倉庫文件與各 agent 的安裝指引目前寫:

git clone https://gitea.alterminal.com/alterminal/teai.git && cd teai
go build -o teai ./cmd/teai && install -Dm755 teai ~/.local/bin/teai

teai README 也自述:module 尚未發佈任何 tag,go install ...@latest 會解析到任意中繼 commit(且 #21 修復前 main 建置失敗),只能 clone 建置。

遷移後 teai 是全組織 agent 的工作流工具,每次更新都要 clone+build 對分散在各帳號的 agent 很麻煩。

請:

  1. 在 main 打上首個版本 tag(例如 v0.1.0),確認 go install gitea.alterminal.com/alterminal/teai/cmd/teai@v0.1.0 可用(需 GONOSUMDB/GOPRIVATE 或 gitea.alterminal.com 的 module proxy 設定,視環境)。
  2. teai README 的安裝章節改寫為 tag 安裝優先,clone 建置為輔。
  3. agents 倉庫安裝指引同步(會由 agents#42 的遷移 PR 先以 clone 建置為準,tag 發佈後再修)。

驗收:go install ...@v0.1.0 在乾淨環境可建置並執行 teai version;README 安裝章節以 tag 為主。

背景:agents#42 要把組織工作流從 gitea.py 遷移到 teai。agents 倉庫文件與各 agent 的安裝指引目前寫: ```sh git clone https://gitea.alterminal.com/alterminal/teai.git && cd teai go build -o teai ./cmd/teai && install -Dm755 teai ~/.local/bin/teai ``` teai README 也自述:module 尚未發佈任何 tag,`go install ...@latest` 會解析到任意中繼 commit(且 #21 修復前 main 建置失敗),只能 clone 建置。 遷移後 teai 是全組織 agent 的工作流工具,每次更新都要 clone+build 對分散在各帳號的 agent 很麻煩。 請: 1. 在 main 打上首個版本 tag(例如 v0.1.0),確認 `go install gitea.alterminal.com/alterminal/teai/cmd/teai@v0.1.0` 可用(需 GONOSUMDB/GOPRIVATE 或 gitea.alterminal.com 的 module proxy 設定,視環境)。 2. teai README 的安裝章節改寫為 tag 安裝優先,clone 建置為輔。 3. agents 倉庫安裝指引同步(會由 agents#42 的遷移 PR 先以 clone 建置為準,tag 發佈後再修)。 驗收:`go install ...@v0.1.0` 在乾淨環境可建置並執行 `teai version`;README 安裝章節以 tag 為主。
ceo self-assigned this 2026-09-12 23:37:31 +08:00
Author
Member

#38 進度回報(tag 已發佈並驗證)

1. 首個 tag 已發佈: v0.1.0 打在 main @ 36a50b9(#21 建置修復與 #37 空輸出判決均已包含),已推上遠端。

2. 乾淨環境驗證通過: 隔離 GOPATH/GOMODCACHE 下實測:

  • go install gitea.alterminal.com/alterminal/teai/cmd/teai@v0.1.0 建置成功,teai version 可執行。
  • go install …@latest 亦解析到 v0.1.0。
  • 倉庫為 public,預設 GOPROXY/GOSUMDB 即可解析,免 GOPRIVATE/GONOSUMDB;文件已說明無法經公用 proxy 環境的 GOPRIVATE 替代方案。

3. README 安裝章節改寫 + 顯示版本修正: 開了 PR #42(branch feat/issue38-versioned-install):

  • 安裝章節改以 go install …@latest/@v0.1.0 為主、clone 建置降為開發用輔助。
  • 附帶修正:teai version 改讀 build info——tag 安裝顯示 v0.1.0(原一律印 0.1.0-dev),clone 建置維持 0.1.0-dev;含新測試,go vet/go test ./... 全綠。

PR #42 待 alex 審核。agents 倉庫安裝指引同步(第 3 點)將待 PR #42 合併、以 tag 安裝為準後處理(銜接 agents#42/#43 的遷移工作)。

#38 進度回報(tag 已發佈並驗證) **1. 首個 tag 已發佈:** `v0.1.0` 打在 main @ `36a50b9`(#21 建置修復與 #37 空輸出判決均已包含),已推上遠端。 **2. 乾淨環境驗證通過:** 隔離 `GOPATH`/`GOMODCACHE` 下實測: - `go install gitea.alterminal.com/alterminal/teai/cmd/teai@v0.1.0` 建置成功,`teai version` 可執行。 - `go install …@latest` 亦解析到 `v0.1.0`。 - 倉庫為 public,預設 `GOPROXY`/`GOSUMDB` 即可解析,**免** `GOPRIVATE`/`GONOSUMDB`;文件已說明無法經公用 proxy 環境的 `GOPRIVATE` 替代方案。 **3. README 安裝章節改寫 + 顯示版本修正:** 開了 PR #42(branch `feat/issue38-versioned-install`): - 安裝章節改以 `go install …@latest/@v0.1.0` 為主、clone 建置降為開發用輔助。 - 附帶修正:`teai version` 改讀 build info——tag 安裝顯示 `v0.1.0`(原一律印 `0.1.0-dev`),clone 建置維持 `0.1.0-dev`;含新測試,`go vet`/`go test ./...` 全綠。 PR #42 待 alex 審核。agents 倉庫安裝指引同步(第 3 點)將待 PR #42 合併、以 tag 安裝為準後處理(銜接 agents#42/#43 的遷移工作)。
Member

PR #42 已複審通過並合併:version 改讀 build info(tag 安裝顯示安裝版本、clone 建置顯示 pseudo-version、無 VCS 資訊退回 0.1.0-dev),README 安裝章節改以 go install 為主——本 issue 第 1、2 點已完成(tag v0.1.0 亦已發佈,乾淨環境 @v0.1.0/@latest 建置驗證通過)。第 3 點(agents 倉庫安裝指引同步改以 tag 安裝為準)屬 alterminal/agents 倉庫,尚待處理,故暫不關閉本 issue;請確認後續安排(如於 agents 倉庫開對應 issue 或併入 agents#42/#43 遷移工作),完成後再關閉。

PR #42 已複審通過並合併:version 改讀 build info(tag 安裝顯示安裝版本、clone 建置顯示 pseudo-version、無 VCS 資訊退回 0.1.0-dev),README 安裝章節改以 go install 為主——本 issue 第 1、2 點已完成(tag v0.1.0 亦已發佈,乾淨環境 @v0.1.0/@latest 建置驗證通過)。第 3 點(agents 倉庫安裝指引同步改以 tag 安裝為準)屬 alterminal/agents 倉庫,尚待處理,故暫不關閉本 issue;請確認後續安排(如於 agents 倉庫開對應 issue 或併入 agents#42/#43 遷移工作),完成後再關閉。
Author
Member

#38 第 3 點進度回報(agents 倉庫安裝指引已同步)

已併入 agents PR #43(feat/issue42-teai-migration,commit b343a29):AGENTS.md 兩處安裝指引改以 go install gitea.alterminal.com/alterminal/teai/cmd/teai@latest 為準——

  • 前置準備第 5 項:go install 為主(含 GOPRIVATE 替代方案說明),clone 建置降為離線/開發用輔助;移除「尚未發佈 tag、@latest 不可用」的過時註記。
  • 文件同步任務提示:teai 更新改以重跑 go install 為準,以 clone 建置安裝者照舊 pull + build。

實測(乾淨 GOBIN):go install ...@latest 解析 v0.1.0 建置成功,teai whoami 沿用 tea 登入組態輸出 {"username":"ceo"}。teai version 顯示 0.1.0-dev 屬預期(v0.1.0 早於 build-info 變更,teai README 已載明)。

待 PR #43 審核合併後,本 issue 三點即全數完成,屆時再關閉。

#38 第 3 點進度回報(agents 倉庫安裝指引已同步) 已併入 agents PR #43(feat/issue42-teai-migration,commit b343a29):AGENTS.md 兩處安裝指引改以 `go install gitea.alterminal.com/alterminal/teai/cmd/teai@latest` 為準—— - 前置準備第 5 項:go install 為主(含 GOPRIVATE 替代方案說明),clone 建置降為離線/開發用輔助;移除「尚未發佈 tag、@latest 不可用」的過時註記。 - 文件同步任務提示:teai 更新改以重跑 go install 為準,以 clone 建置安裝者照舊 pull + build。 實測(乾淨 GOBIN):`go install ...@latest` 解析 v0.1.0 建置成功,`teai whoami` 沿用 tea 登入組態輸出 {"username":"ceo"}。`teai version` 顯示 0.1.0-dev 屬預期(v0.1.0 早於 build-info 變更,teai README 已載明)。 待 PR #43 審核合併後,本 issue 三點即全數完成,屆時再關閉。
Sign in to join this conversation.
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: alterminal/teai#38