---
description: Reset Gitea configuration with interactive setup wizard
---

# gitea-reset

重置 Gitea 配置，启动交互式配置向导。

## Features

- 交互式引导配置
- 验证 URL 和 Token
- 检查 Token 权限
- 自动保存配置到 `~/.config/gitea/config.env`
- 创建必要的目录结构

## Steps

### 1. Create Configuration Directory

```bash
config_dir="$HOME/.config/gitea"
config_file="$config_dir/config.env"

# Create directories
mkdir -p "$config_dir/runners"

echo "开始 Gitea 配置向导..."
echo ""
```

### 2. Input Gitea URL

```bash
read -p "请输入 Gitea 实例地址 (例如: https://git.digitevents.com): " gitea_url

# Validate URL format
if ! [[ "$gitea_url" =~ ^https?:// ]]; then
  echo "❌ URL 必须以 http:// 或 https:// 开头"
  exit 1
fi

# Remove trailing slash
gitea_url="${gitea_url%/}"

echo "✓ URL: $gitea_url"
```

### 3. Input Personal Access Token

```bash
echo ""
read -sp "请输入 Personal Access Token: " gitea_token
echo ""

if [ -z "$gitea_token" ]; then
  echo "❌ Token 不能为空"
  exit 1
fi

echo "✓ Token 已输入"
```

**Token 获取提示**：

在用户输入 Token 前，可以显示帮助信息：

```
提示：获取 Personal Access Token 的步骤：
  1. 登录 Gitea
  2. 右上角头像 → 设置 → 应用 → 访问令牌
  3. 点击 "生成新令牌"
  4. 设置令牌名称（如 opencode-cli）
  5. 选择权限：repo, admin:org, write:runner（推荐）
  6. 点击 "生成令牌"
  7. 复制生成的 Token
```

### 4. Test Connection

```bash
echo ""
echo "正在测试连接..."

response=$(curl -s -w "\n%{http_code}" \
  -H "Authorization: token $gitea_token" \
  "${gitea_url}/api/v1/user")

http_code=$(echo "$response" | tail -n1)
body=$(echo "$response" | sed '$d')

if [ "$http_code" != "200" ]; then
  echo "❌ 连接失败 (HTTP $http_code)"
  echo "请检查："
  echo "  - URL 是否正确"
  echo "  - Token 是否有效"
  echo "  - 网络连接是否正常"
  exit 1
fi

username=$(echo "$body" | jq -r '.login')
echo "✓ 连接成功！"
echo "✓ 登录用户: $username"
```

### 5. Validate Token Permissions

```bash
echo ""
echo "正在检查 Token 权限..."

# Check repo permission
if curl -s -o /dev/null -w "%{http_code}" \
  -H "Authorization: token $gitea_token" \
  "${gitea_url}/api/v1/user/repos" | grep -q "200"; then
  echo "  ✓ repo (仓库管理)"
  has_repo=true
else
  echo "  ✗ repo (仓库管理) - 缺少"
  has_repo=false
fi

# Check org permission
if curl -s -o /dev/null -w "%{http_code}" \
  -H "Authorization: token $gitea_token" \
  "${gitea_url}/api/v1/user/orgs" | grep -q "200"; then
  echo "  ✓ admin:org (组织管理)"
  has_org=true
else
  echo "  ⚠ admin:org (组织管理) - 缺少（创建组织 Runner 时需要）"
  has_org=false
fi

# Check runner permission (try to get a registration token)
if curl -s -o /dev/null -w "%{http_code}" \
  -H "Authorization: token $gitea_token" \
  "${gitea_url}/api/v1/user/actions/runners/registration-token" 2>/dev/null | grep -q "200"; then
  echo "  ✓ write:runner (Runner 管理)"
  has_runner=true
else
  echo "  ⚠ write:runner (Runner 管理) - 缺少（创建 Runner 时需要）"
  has_runner=false
fi

# Warning if missing critical permissions
if [ "$has_repo" = false ]; then
  echo ""
  echo "❌ 缺少必需的 repo 权限"
  read -p "是否继续? [y/N] " continue_anyway
  if [[ ! "$continue_anyway" =~ ^[Yy]$ ]]; then
    echo "已取消，请重新创建具有足够权限的 Token"
    exit 1
  fi
fi
```

### 6. Input Default Organization (Optional)

```bash
echo ""
echo "设置默认组织（可选）："
echo "  - 创建仓库时，如果不指定 owner，将使用默认组织"
echo "  - 创建组织级 Runner 时使用"
echo ""
read -p "请输入默认组织名称 (回车跳过): " default_org

if [ -n "$default_org" ]; then
  # Validate organization exists
  echo "正在验证组织..."
  org_response=$(curl -s -w "\n%{http_code}" \
    -H "Authorization: token $gitea_token" \
    "${gitea_url}/api/v1/orgs/${default_org}")
  
  org_http_code=$(echo "$org_response" | tail -n1)
  
  if [ "$org_http_code" = "200" ]; then
    echo "✓ 组织验证成功: $default_org"
  else
    echo "⚠️  组织 '$default_org' 不存在或无权限访问"
    read -p "仍然设置为默认组织? [Y/n] " set_anyway
    if [[ "$set_anyway" =~ ^[Nn]$ ]]; then
      default_org=""
    fi
  fi
fi
```

### 7. Save Configuration

```bash
echo ""
echo "正在保存配置..."

cat > "$config_file" << EOF
# Gitea Configuration
# Generated at $(date '+%Y-%m-%d %H:%M:%S')

GITEA_URL=$gitea_url
GITEA_TOKEN=$gitea_token
${default_org:+GITEA_DEFAULT_ORG=$default_org}

# Runner Default Settings
GITEA_RUNNER_CAPACITY=2
GITEA_RUNNER_TIMEOUT=3h

# Optional: Override auto-detected labels
# GITEA_RUNNER_LABELS=custom-label-1:host,custom-label-2:host
EOF

# Set restrictive permissions
chmod 600 "$config_file"

# Create .gitignore
cat > "$config_dir/.gitignore" << EOF
config.env
runners/*/.runner
runners/*/.env
EOF

echo "✓ 配置已保存"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "配置完成"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "  配置文件: $config_file"
echo "  Runner 目录: $config_dir/runners"
echo ""
echo "下一步："
echo "  - 查看配置: /gitea-config"
echo "  - 创建 Runner: 告诉 AI '创建一个 runner'"
echo "  - 创建仓库: /create-gitea-repo <repo-name>"
echo ""
```

## Configuration File Format

生成的 `~/.config/gitea/config.env` 文件格式：

```bash
# Gitea Configuration
# Generated at 2026-01-12 22:00:00

GITEA_URL=https://git.digitevents.com
GITEA_TOKEN=git_xxxxxxxxxxxxxxxxxxxx
GITEA_DEFAULT_ORG=ai

# Runner Default Settings
GITEA_RUNNER_CAPACITY=2
GITEA_RUNNER_TIMEOUT=3h

# Optional: Override auto-detected labels
# GITEA_RUNNER_LABELS=custom-label-1:host,custom-label-2:host
```

## Output Example

```
开始 Gitea 配置向导...

请输入 Gitea 实例地址 (例如: https://git.digitevents.com): https://git.digitevents.com
✓ URL: https://git.digitevents.com

请输入 Personal Access Token: ****************
✓ Token 已输入

正在测试连接...
✓ 连接成功！
✓ 登录用户: your_username

正在检查 Token 权限...
  ✓ repo (仓库管理)
  ✓ admin:org (组织管理)
  ✓ write:runner (Runner 管理)

设置默认组织（可选）：
  - 创建仓库时，如果不指定 owner，将使用默认组织
  - 创建组织级 Runner 时使用

请输入默认组织名称 (回车跳过): ai
正在验证组织...
✓ 组织验证成功: ai

正在保存配置...
✓ 配置已保存

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
配置完成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  配置文件: /Users/voson/.config/gitea/config.env
  Runner 目录: /Users/voson/.config/gitea/runners

下一步：
  - 查看配置: /gitea-config
  - 创建 Runner: 告诉 AI '创建一个 runner'
  - 创建仓库: /create-gitea-repo <repo-name>
```

## Security Notes

- 配置文件权限设置为 `600`（仅所有者可读写）
- Token 不会在日志中显示
- 创建 `.gitignore` 文件排除敏感信息
- 建议定期轮换 Token（每 3-6 个月）

## Notes

- **必需权限**: `repo` - 创建和管理仓库
- **推荐权限**: `admin:org` - 创建组织级 Runner
- **推荐权限**: `write:runner` - 管理 Runner
- **可选权限**: `admin:repo_hook` - 配置 Webhooks
- Token 只显示一次，请妥善保管
- 重置配置不会影响已创建的 Runner，但 Runner 会继续使用旧的注册信息