添加 Gitea APT 仓库配置功能和完整文档系统

- 新增 gitea_repo_setup.yaml playbook 用于管理 Gitea APT 仓库
- 支持删除旧源、下载 GPG 密钥、配置新源和自动更新 APT 缓存
- 添加仓库配置架构文档和使用指南
- 采用部分参数化设计，支持自定义仓库 URL 和所有者

llmdoc/architecture/repo-configuration.md

@@ -0,0 +1,38 @@
+# Gitea 仓库配置架构
+
+## 1. 身份定义
+
+- **组件**: Gitea APT 仓库配置管理
+- **目的**: 自动化 APT 仓库源配置过程
+
+## 2. 核心组件
+
+- `playbooks/gitea_repo_setup.yaml`: 主要配置逻辑
+  - `ansible.builtin.file`: 目录管理
+  - `ansible.builtin.get_url`: 密钥下载
+  - `ansible.builtin.template`: 源文件生成
+  - `ansible.builtin.apt`: 缓存更新
+
+## 3. 执行流程
+
+1. **目录准备**
+   - 检查并创建 `/etc/apt/keyrings/`
+   - 删除旧的仓库源文件
+
+2. **密钥管理**
+   - 下载 GPG 公钥
+   - 确保密钥正确导入
+
+3. **源配置**
+   - 生成 `wangdefa.list`
+   - 配置仓库 URL 和签名信息
+
+4. **缓存刷新**
+   - 触发 `apt update`
+   - 记录更新日志
+
+## 4. 设计原则
+
+- 幂等性：可安全重复执行
+- 参数化：关键配置可动态调整
+- 模块化：遵循 Ansible 最佳实践

llmdoc/guides/gitea-repo-configuration.md

@@ -0,0 +1,38 @@
+# 如何配置 Gitea APT 仓库
+
+## 前提条件
+
+- 已安装 Ansible
+- 目标机器可访问互联网
+- 具有 sudo 权限
+
+## 配置步骤
+
+1. **准备清单文件**
+   - 编辑 `inventory` 文件，添加目标主机
+   ```ini
+   [gitea_hosts]
+   your_target_host ansible_user=your_username
+   ```
+
+2. **设置变量**
+   在 `group_vars` 或 playbook 中定义必要变量：
+   ```yaml
+   repo_url: "https://gitea.example.com/repo"
+   repo_owner: "wangdefa"
+   ```
+
+3. **执行 Playbook**
+   ```bash
+   ansible-playbook -i inventory playbooks/gitea_repo_setup.yaml
+   ```
+
+4. **验证配置**
+   - 检查 `/etc/apt/sources.list.d/wangdefa.list`
+   - 运行 `apt update` 验证源可用性
+
+## 注意事项
+
+- 确保网络连接正常
+- 检查 GPG 密钥下载是否成功
+- 对于不同的 Linux 发行版可能需要调整