78 lines
2.9 KiB
Markdown
78 lines
2.9 KiB
Markdown
# Gitea 仓库盘点与枚举
|
||
|
||
## 枚举当前用户仓库（含私有）
|
||
|
||
```bash
|
||
TOKEN=$(grep -A1 'gitea.ephron.ren' ~/.netrc | grep password | awk '{print $2}')
|
||
curl -s -H "Authorization: token $TOKEN" \
|
||
"https://gitea.ephron.ren/api/v1/user/repos?limit=100&sort=updated" \
|
||
| jq '[.[] | {name: .full_name, private: .private, desc: (.description // ""), updated: .updated_at[:10]}]'
|
||
```
|
||
|
||
⚠️ **注意**: `/api/v1/repos/search` 默认不返回私有仓库。盘点仓库必须用 `/api/v1/user/repos`（当前用户）或 `/api/v1/users/{username}/repos`（指定用户）。
|
||
|
||
## 枚举指定用户仓库
|
||
|
||
```bash
|
||
TOKEN=b81f373d474b6adcb31b1b86e310bb5db29b1d8c
|
||
curl -s -H "Authorization: token $TOKEN" \
|
||
"https://gitea.ephron.ren/api/v1/users/{username}/repos?limit=100" \
|
||
| jq '[.[] | {name: .full_name, private: .private, desc: (.description // ""), updated: .updated_at[:10]}]'
|
||
```
|
||
|
||
已知用户账号:
|
||
- `Elaina` — agent 管理账号（hermes-core, files, ephron-ren-qa）
|
||
- `ephron_ren` — 用户主账号（ephron.ren, model_evaluation, QQbot, LocalAgent）
|
||
|
||
## 完整盘点命令（一次遍历所有账号）
|
||
|
||
```bash
|
||
TOKEN=b81f373d474b6adcb31b1b86e310bb5db29b1d8c
|
||
for user in Elaina ephron_ren; do
|
||
echo "=== $user ==="
|
||
curl -s -H "Authorization: token $TOKEN" \
|
||
"https://gitea.ephron.ren/api/v1/users/$user/repos?limit=100" \
|
||
| jq -r '.[] | "\(.full_name) | \(.private | if . then "🔒私有" else "🌐公开" end) | \(.description // "-") | \(.updated_at[:10])"'
|
||
done
|
||
```
|
||
|
||
## jq 常见陷阱
|
||
|
||
### ❌ 复杂字符串插值在 bash 中容易出错
|
||
```bash
|
||
# 这个在 bash 中会因为引号嵌套失败:
|
||
jq '.data[] | "\(.full_name) | \(.private ? "私有" : "公开")"'
|
||
```
|
||
|
||
### ✅ 正确做法：用对象提取 + 外部格式化
|
||
```bash
|
||
jq '[.[] | {name: .full_name, private: .private, desc: (.description // ""), updated: .updated_at[:10]}]'
|
||
```
|
||
|
||
或者用 `-r` + 简单插值:
|
||
```bash
|
||
jq -r '.[] | "\(.full_name) | \(.private) | \(.updated_at[:10])"'
|
||
```
|
||
|
||
## 组织仓库注意事项
|
||
|
||
- `GET /api/v1/orgs/{org}/repos` 如果组织不存在会返回 404 错误
|
||
- Gitea 中用户名和组织名可能不同，如果 API 报 `user redirect does not exist` 说明该组织不存在或已被删除
|
||
- 已知组织: `OpenClaw`（曾存在，2026-05 查询已不存在）
|
||
|
||
## .netrc Token 解析坑
|
||
|
||
### 常见问题
|
||
```bash
|
||
# ❌ 如果 ~/.netrc 格式异常，grep -A1 可能取到错误行
|
||
TOKEN=$(grep -A1 'gitea.ephron.ren' ~/.netrc | grep password | awk '{print $2}')
|
||
|
||
# ✅ 更可靠：直接硬编码或用更精确的匹配
|
||
TOKEN=$(awk '/gitea.ephron.ren/{found=1} found && /password/{print $2; exit}' ~/.netrc)
|
||
```
|
||
|
||
### Token 格式
|
||
- Gitea API token 是一个长 hex 字符串（如 `b81f373d474b6adcb31b1b86e310bb5db29b1d8c`）
|
||
- login 和 password 字段存储相同的 token 值
|
||
- 两种认证方式都可以: `-u "token:$TOKEN"` 或 `-H "Authorization: token $TOKEN"`
|