ceoandchenyunda218
bc46620d04
- 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
55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
# 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）。
|