docs: 重构命令和技能文档体系,规范化文档格式和内容组织
This commit is contained in:
@@ -12,6 +12,7 @@ Gitea skill 需要配置连接信息才能与你的 Gitea 实例交互。配置
|
||||
|
||||
## 配置目录结构
|
||||
|
||||
### macOS / Linux
|
||||
```
|
||||
~/.config/gitea/
|
||||
├── config.env # 主配置文件(包含 URL、Token、默认组织等)
|
||||
@@ -20,6 +21,20 @@ Gitea skill 需要配置连接信息才能与你的 Gitea 实例交互。配置
|
||||
└── .gitignore # Git 忽略文件(保护敏感信息)
|
||||
```
|
||||
|
||||
### Windows
|
||||
```
|
||||
%USERPROFILE%\.config\gitea\
|
||||
├── config.env # 主配置文件(包含 URL、Token、默认组织等)
|
||||
├── runners\ # Runner 配置目录
|
||||
│ └── runner-*\ # 各个 runner 的独立目录
|
||||
└── .gitignore # Git 忽略文件(保护敏感信息)
|
||||
```
|
||||
|
||||
**Windows 用户提示**:
|
||||
- 配置文件路径示例:`C:\Users\YourUsername\.config\gitea\config.env`
|
||||
- 可以在 PowerShell 中使用 `$env:USERPROFILE` 变量
|
||||
- 在 CMD 中使用 `%USERPROFILE%` 环境变量
|
||||
|
||||
## 快速配置
|
||||
|
||||
### 方法 1: 使用交互式向导(推荐)
|
||||
@@ -48,6 +63,7 @@ AI 会自动启动配置向导。
|
||||
|
||||
如果你熟悉配置格式,可以手动创建:
|
||||
|
||||
**macOS / Linux**:
|
||||
```bash
|
||||
mkdir -p ~/.config/gitea/runners
|
||||
cat > ~/.config/gitea/config.env << 'EOF'
|
||||
@@ -62,6 +78,45 @@ EOF
|
||||
chmod 600 ~/.config/gitea/config.env
|
||||
```
|
||||
|
||||
**Windows PowerShell**:
|
||||
```powershell
|
||||
# 创建目录
|
||||
New-Item -Path "$env:USERPROFILE\.config\gitea\runners" -ItemType Directory -Force
|
||||
|
||||
# 创建配置文件
|
||||
@"
|
||||
GITEA_URL=https://git.digitevents.com
|
||||
GITEA_TOKEN=your_personal_access_token
|
||||
GITEA_DEFAULT_ORG=your_org_name
|
||||
|
||||
GITEA_RUNNER_CAPACITY=2
|
||||
GITEA_RUNNER_TIMEOUT=3h
|
||||
"@ | Out-File -FilePath "$env:USERPROFILE\.config\gitea\config.env" -Encoding utf8
|
||||
|
||||
# 设置文件权限(仅所有者可读)
|
||||
$acl = Get-Acl "$env:USERPROFILE\.config\gitea\config.env"
|
||||
$acl.SetAccessRuleProtection($true, $false)
|
||||
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule($env:USERNAME, "Read,Write", "Allow")
|
||||
$acl.SetAccessRule($rule)
|
||||
Set-Acl "$env:USERPROFILE\.config\gitea\config.env" $acl
|
||||
```
|
||||
|
||||
**Windows CMD**:
|
||||
```cmd
|
||||
:: 创建目录
|
||||
mkdir "%USERPROFILE%\.config\gitea\runners"
|
||||
|
||||
:: 创建配置文件
|
||||
(
|
||||
echo GITEA_URL=https://git.digitevents.com
|
||||
echo GITEA_TOKEN=your_personal_access_token
|
||||
echo GITEA_DEFAULT_ORG=your_org_name
|
||||
echo.
|
||||
echo GITEA_RUNNER_CAPACITY=2
|
||||
echo GITEA_RUNNER_TIMEOUT=3h
|
||||
) > "%USERPROFILE%\.config\gitea\config.env"
|
||||
```
|
||||
|
||||
## 交互式配置流程
|
||||
|
||||
### 步骤 1: 输入 Gitea 实例地址
|
||||
|
||||
Reference in New Issue
Block a user