133 lines
3.7 KiB
Markdown
133 lines
3.7 KiB
Markdown
---
|
||
description: Reset Gitea configuration with interactive setup wizard
|
||
agent: general
|
||
subtask: true
|
||
---
|
||
|
||
Launch an interactive configuration wizard to set up or reset Gitea configuration.
|
||
|
||
## 工作目录
|
||
|
||
**macOS / Linux:**
|
||
```
|
||
~/.config/gitea/
|
||
```
|
||
|
||
**Windows:**
|
||
```
|
||
%USERPROFILE%\.config\gitea\
|
||
```
|
||
|
||
配置文件和 Runner 目录都将存储在此位置。
|
||
|
||
Please perform the following:
|
||
|
||
1. **Create configuration directory:**
|
||
|
||
**macOS / Linux:**
|
||
```bash
|
||
mkdir -p ~/.config/gitea/runners
|
||
```
|
||
|
||
**Windows PowerShell:**
|
||
```powershell
|
||
New-Item -Path "$env:USERPROFILE\.config\gitea\runners" -ItemType Directory -Force
|
||
```
|
||
|
||
2. **Interactive input - Gitea URL:**
|
||
- Prompt: "请输入 Gitea 实例地址 (例如: https://git.digitevents.com):"
|
||
- Validate: Must start with http:// or https://
|
||
- Remove trailing slash
|
||
|
||
3. **Interactive input - Personal Access Token:**
|
||
- Prompt: "请输入 Personal Access Token:"
|
||
- Before input, show help:
|
||
```
|
||
提示：获取 Personal Access Token 的步骤：
|
||
1. 登录 Gitea
|
||
2. 右上角头像 → 设置 → 应用 → 访问令牌
|
||
3. 点击 "生成新令牌"
|
||
4. 设置令牌名称（如 opencode-cli）
|
||
5. 选择权限：repo, admin:org, write:runner（推荐）
|
||
6. 点击 "生成令牌"
|
||
7. 复制生成的 Token
|
||
```
|
||
- Validate: Not empty
|
||
- Use `read -sp` for secure input (password style)
|
||
|
||
4. **Test connection:**
|
||
- API: `GET ${GITEA_URL}/api/v1/user`
|
||
- If fails: Show error and possible reasons
|
||
- If success: Show username
|
||
|
||
5. **Validate token permissions:**
|
||
- Check `repo`: `GET /api/v1/user/repos` (required)
|
||
- Check `admin:org`: `GET /api/v1/user/orgs` (optional, for org runners)
|
||
- Check `write:runner`: Try to get registration token (optional, for runners)
|
||
- Warn if missing required permissions
|
||
|
||
6. **Input default organization (optional):**
|
||
- Prompt: "请输入默认组织名称 (回车跳过):"
|
||
- If provided, validate it exists: `GET /api/v1/orgs/${org_name}`
|
||
|
||
7. **Save configuration:**
|
||
|
||
**macOS / Linux** - Save to `~/.config/gitea/config.env`:
|
||
```bash
|
||
GITEA_URL=...
|
||
GITEA_TOKEN=...
|
||
GITEA_DEFAULT_ORG=... (if set)
|
||
GITEA_RUNNER_CAPACITY=2
|
||
GITEA_RUNNER_TIMEOUT=3h
|
||
```
|
||
- Set permissions: `chmod 600 ~/.config/gitea/config.env`
|
||
- Create `.gitignore` to exclude sensitive files
|
||
|
||
**Windows** - Save to `%USERPROFILE%\.config\gitea\config.env`:
|
||
```bash
|
||
GITEA_URL=...
|
||
GITEA_TOKEN=...
|
||
GITEA_DEFAULT_ORG=... (if set)
|
||
GITEA_RUNNER_CAPACITY=2
|
||
GITEA_RUNNER_TIMEOUT=3h
|
||
```
|
||
- Set file permissions to restrict access (see setup-guide.md for PowerShell script)
|
||
- Create `.gitignore` to exclude sensitive files
|
||
|
||
8. **Display completion summary in Chinese:**
|
||
|
||
**macOS / Linux:**
|
||
```
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
配置完成
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
配置文件: ~/.config/gitea/config.env
|
||
Runner 目录: ~/.config/gitea/runners
|
||
|
||
下一步：
|
||
- 查看配置: /gitea-config
|
||
- 创建 Runner: 告诉 AI '创建一个 runner'
|
||
- 创建仓库: /create-gitea-repo <repo-name>
|
||
```
|
||
|
||
**Windows:**
|
||
```
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
配置完成
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
配置文件: %USERPROFILE%\.config\gitea\config.env
|
||
Runner 目录: %USERPROFILE%\.config\gitea\runners
|
||
|
||
下一步：
|
||
- 查看配置: /gitea-config
|
||
- 创建 Runner: 告诉 AI '创建一个 runner'
|
||
- 创建仓库: /create-gitea-repo <repo-name>
|
||
```
|
||
|
||
**Security notes:**
|
||
- Config file permissions: 600 (owner read/write only)
|
||
- Token is never displayed after initial input
|
||
- Sensitive files excluded in .gitignore
|