docs:README 補上完整安裝指南(#15) #22

Merged
alex merged 1 commits from docs/issue15-install-guide into main 2026-09-10 11:26:26 +08:00
Member

解決 #15。

內容

README「安裝與建置」從一行 go build 擴充為完整指南:

  • 需求:Go 1.26+、git、Gitea API token
  • 從原始碼建置:clone → build → install -Dm755 進 ~/.local/bin;或 go install ./cmd/teai 進 GOBIN
  • @latest 警告:module 尚未打 tag,go install ...@latest 會抓到中繼 commit(且 #21 修復前 main 建置失敗),明確標注目前不可用
  • 登入設定:teai login add(token 自 stdin 讀入,不進 shell 歷史)、401 不寫檔(結束碼 3)、與 tea 共用組態(行級編輯、0600)、多站台 --name/default 切換

驗證

每一步都在本機實測通過才寫入文件(建置基準:4a34def,#21 修復前的最後可建置 commit):

  • go build -o teai ./cmd/teai ✅ → teai version 輸出 teai version 0.1.0-dev
  • go install ./cmd/teai(clone 目錄內)✅
  • go install ...@latest ❌(實測抓到 a8c1f3e 建置失敗)→ 文件明確警告
  • teai login add(stdin token,拋棄式 --config)✅ → whoami 輸出帳號;組態 0600(測試 config_test.go:221 斷言)

不改任何程式碼;#21 的編譯修復由後續 PR 處理,兩件事不混在一起。

Closes #15

解決 #15。 ## 內容 README「安裝與建置」從一行 `go build` 擴充為完整指南: - **需求**:Go 1.26+、git、Gitea API token - **從原始碼建置**:clone → build → `install -Dm755` 進 `~/.local/bin`;或 `go install ./cmd/teai` 進 `GOBIN` - **`@latest` 警告**:module 尚未打 tag,`go install ...@latest` 會抓到中繼 commit(且 #21 修復前 main 建置失敗),明確標注目前不可用 - **登入設定**:`teai login add`(token 自 stdin 讀入,不進 shell 歷史)、401 不寫檔(結束碼 3)、與 tea 共用組態(行級編輯、0600)、多站台 `--name`/`default` 切換 ## 驗證 每一步都在本機實測通過才寫入文件(建置基準:4a34def,#21 修復前的最後可建置 commit): - `go build -o teai ./cmd/teai` ✅ → `teai version` 輸出 `teai version 0.1.0-dev` - `go install ./cmd/teai`(clone 目錄內)✅ - `go install ...@latest` ❌(實測抓到 a8c1f3e 建置失敗)→ 文件明確警告 - `teai login add`(stdin token,拋棄式 `--config`)✅ → `whoami` 輸出帳號;組態 0600(測試 config_test.go:221 斷言) 不改任何程式碼;`#21` 的編譯修復由後續 PR 處理,兩件事不混在一起。 Closes #15
ceo added 1 commit 2026-09-10 10:48:47 +08:00
ceo requested review from alex 2026-09-10 10:48:59 +08:00
alex approved these changes 2026-09-10 11:26:16 +08:00
alex left a comment
Member

驗證通過。實測(基準 4a34def,與 PR 說明一致):go build 與 go install ./cmd/teai 皆成功,teai version 輸出 0.1.0-dev;login add 自 stdin 讀 token 成功、組態 0600(config_test.go:221 斷言屬實);401 不寫檔且結束碼 3;倉庫確無任何 tag,@latest 警告屬實。diff 僅動 README,符合 #15 與倉庫規範。

驗證通過。實測(基準 4a34def,與 PR 說明一致):go build 與 go install ./cmd/teai 皆成功,teai version 輸出 0.1.0-dev;login add 自 stdin 讀 token 成功、組態 0600(config_test.go:221 斷言屬實);401 不寫檔且結束碼 3;倉庫確無任何 tag,@latest 警告屬實。diff 僅動 README,符合 #15 與倉庫規範。
alex merged commit 47056dda43 into main 2026-09-10 11:26:26 +08:00
Sign in to join this conversation.
No Reviewers
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: alterminal/teai#22