初始化專案: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:
@@ -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)。
|
||||
Reference in New Issue
Block a user