初始化專案:Go 模組骨架、CLI 進入點、README、測試

- go.mod(module gitea.alterminal.com/alterminal/teai,Go 1.26)
- cmd/teai/main.go:程式進入點,結束碼交由 internal/cli.Run 處理
- internal/cli:命令列架構(引數剖析、子命令分派、version 命令)
- internal/cli/cli_test.go:用法輸出、version、未知命令等基本測試
- README.md:專案說明、建置與開發慣例(繁體中文)
- .gitignore:建置產物、測試輸出、環境檔
- 僅使用標準庫,可離線建置;授權待維護者選定

Refs #1
This commit is contained in:
ceo
2026-09-09 22:46:26 +08:00
commit d691434994
6 changed files with 268 additions and 0 deletions
+54
View File
@@ -0,0 +1,54 @@
# teai
teai 是 Gitea 的命令列(CLI)輔助工具,補足官方 `tea` CLI 缺少的功能。
名稱取「**te**a + **AI**」:這套工具主要為了讓 AI agent 能以更完整、更可靠的
方式操作 Gitea(查詢、回覆、審核、自動化……)。
- **語言:** Go(與 Gitea 本體一致)
- **目標站點:** `https://gitea.alterminal.com`
- **狀態:** 專案初始化中,功能尚未開始開發
## 安裝與建置
需要 Go 1.26 以上。
```sh
go build -o teai ./cmd/teai
```
## 使用方式
```sh
# 目前僅提供骨架
./teai # 顯示說明
./teai version # 顯示版本資訊
```
離線環境可直接建置:本專案目前僅使用 Go 標準庫,沒有外部相依。
## 開發
```sh
go build ./... # 建置全部套件
go test ./... # 跑全部測試
go vet ./... # 靜態檢查
```
套件結構:
| 路徑 | 內容 |
| --- | --- |
| `cmd/teai/` | 程式進入點(`main`) |
| `internal/cli/` | 命令列架構(flag 剖析、子命令分派、輸出) |
| `internal/` 其他子套件 | 之後依功能新增(如 `internal/gitea`、`internal/cmds/`) |
### 慣例
- 文件與溝通一律使用**繁體中文**
- 對外行為(CLI 輸出、錯誤訊息)以英文為主,方便除錯與自動化剖析
- 變更一律走 **feature 分支 + Pull Request**,由審核者合併;不直推 `main`
- Commit 訊息與 PR 標題使用繁體中文或英文皆可,但需簡潔明確
## 授權
尚未決定(待維護者選定,例如 MIT/Apache-2.0)。