From 75f37ad0936f515cda49d3d1f1e74c046248aa16 Mon Sep 17 00:00:00 2001
From: admin <263303411@qq.com>
Date: Fri, 19 Dec 2025 15:40:35 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20DRONE=20CI=E7=9A=84?=
 =?UTF-8?q?=E5=AE=89=E8=A3=85=E9=9C=80=E8=A6=81=E5=92=8Cgerrit=E5=88=86?=
 =?UTF-8?q?=E5=88=AB=E5=BB=BA=E4=B8=AA=E7=9B=AE=E5=BD=95=E5=90=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...%BA%E4%B8%AA%E7%9B%AE%E5%BD%95%E5%90%97.md | 675 ++++++++++++++++++
 1 file changed, 675 insertions(+)
 create mode 100644 DRONE-CI%E7%9A%84%E5%AE%89%E8%A3%85%E9%9C%80%E8%A6%81%E5%92%8Cgerrit%E5%88%86%E5%88%AB%E5%BB%BA%E4%B8%AA%E7%9B%AE%E5%BD%95%E5%90%97.md

diff --git a/DRONE-CI%E7%9A%84%E5%AE%89%E8%A3%85%E9%9C%80%E8%A6%81%E5%92%8Cgerrit%E5%88%86%E5%88%AB%E5%BB%BA%E4%B8%AA%E7%9B%AE%E5%BD%95%E5%90%97.md b/DRONE-CI%E7%9A%84%E5%AE%89%E8%A3%85%E9%9C%80%E8%A6%81%E5%92%8Cgerrit%E5%88%86%E5%88%AB%E5%BB%BA%E4%B8%AA%E7%9B%AE%E5%BD%95%E5%90%97.md
new file mode 100644
index 0000000..3c92681
--- /dev/null
+++ b/DRONE-CI%E7%9A%84%E5%AE%89%E8%A3%85%E9%9C%80%E8%A6%81%E5%92%8Cgerrit%E5%88%86%E5%88%AB%E5%BB%BA%E4%B8%AA%E7%9B%AE%E5%BD%95%E5%90%97.md
@@ -0,0 +1,675 @@
+# Gitea Wiki 使用指南与实用模板
+
+Gitea Wiki 是一个基于 Git 的文档系统，非常适合团队知识管理和项目文档。以下是详细使用方法和实用模板。
+
+## 📚 **Gitea Wiki 基础操作**
+
+### 如何开启和访问 Wiki
+1. **仓库设置中启用 Wiki**
+   ```
+   仓库主页 → 设置 → 启用 Wiki → 保存
+   ```
+2. **访问 Wiki**
+   - 仓库主页导航栏点击 **`Wiki`** 选项卡
+   - 或直接访问：`https://your-gitea.com/username/repo/wiki`
+
+### Wiki 基本操作
+- **新建页面**：点击 `新建页面` 按钮
+- **编辑页面**：点击页面右上角铅笔图标
+- **页面历史**：点击时钟图标查看版本记录
+- **删除页面**：编辑页面时点击底部删除按钮
+- **搜索**：页面顶部有搜索框
+
+### Wiki 文件结构
+- Wiki 内容存储在仓库的 `.wiki` 子模块中
+- 页面以 `.md` 文件保存（Markdown 格式）
+- 首页固定为 `Home.md`
+- 支持文件夹组织：`开发/API文档.md`
+
+---
+
+## 🎨 **Markdown 语法扩展**
+Gitea Wiki 支持标准 Markdown 和扩展语法：
+
+### 1. **页面链接**
+```markdown
+[首页](Home)
+[API文档](开发/API文档)
+[外部链接](https://example.com)
+```
+
+### 2. **目录生成**
+```markdown
+[[_TOC_]]  # 自动生成目录
+```
+
+### 3. **提示框**
+```markdown
+> **Note**
+> 这是一个提示
+
+> **Warning**
+> 这是一个警告
+
+> **Tip**
+> 这是一个技巧
+```
+
+### 4. **任务列表**
+```markdown
+- [ ] 未完成任务
+- [x] 已完成任务
+```
+
+### 5. **表格**
+```markdown
+| 功能 | 状态 | 负责人 |
+|------|------|--------|
+| 登录 | 已完成 | @张三 |
+| 注册 | 进行中 | @李四 |
+```
+
+---
+
+## 📋 **Gitea Wiki 实用模板库**
+
+这里提供5个开箱即用的模板，覆盖项目文档核心需求。
+
+### 模板1：📖 **项目首页** (`Home.md`)
+```markdown
+# {{项目名称}}
+
+> **项目状态**: 开发中 | 已上线 | 维护中  
+> **最后更新**: {{日期}}  
+> **维护团队**: {{团队名称}}
+
+[[_TOC_]]
+
+## 🎯 项目简介
+{{用1-2句话描述项目是什么，解决什么问题}}
+
+## ✨ 主要特性
+- ✅ 特性一
+- ✅ 特性二  
+- 🚧 特性三（开发中）
+- 📅 特性四（规划中）
+
+## 🚀 快速开始
+
+### 环境要求
+- **操作系统**: {{Windows 10+/macOS 10.15+/Linux}}
+- **运行环境**: {{Java 11+/Node.js 16+/Python 3.8+}}
+- **依赖服务**: {{MySQL 8.0+/Redis 6.0+}}
+
+### 三步启动
+```bash
+# 1. 克隆项目
+git clone {{仓库地址}}
+
+# 2. 安装依赖
+{{安装命令}}
+
+# 3. 启动服务
+{{启动命令}}
+```
+
+## 📁 项目结构
+```
+project/
+├── src/           # 源代码
+├── docs/          # 文档
+├── config/        # 配置文件
+└── tests/         # 测试代码
+```
+
+## 🔗 相关链接
+- [🚀 开发指南](开发/开发指南)
+- [📚 API文档](开发/API文档)
+- [🐛 问题追踪]({{Issues页面链接}})
+- [📦 版本发布]({{Releases页面链接}})
+
+## 👥 团队协作
+| 角色 | 负责人 | 联系方式 |
+|------|--------|----------|
+| 项目经理 | @{{姓名}} | {{邮箱}} |
+| 技术负责人 | @{{姓名}} | {{邮箱}} |
+| 开发人员 | @{{姓名}} | {{邮箱}} |
+
+---
+*最后更新: {{日期}} by @{{更新人}}*
+```
+
+### 模板2：🔧 **开发指南** (`开发/开发指南.md`)
+```markdown
+# 开发指南
+
+[[_TOC_]]
+
+## 开发环境搭建
+
+### 1. 环境准备
+```bash
+# 必备工具清单
+- Git {{版本}}
+- {{开发工具}} {{版本}}
+- {{数据库}} {{版本}}
+```
+
+### 2. 配置本地环境
+```bash
+# 克隆仓库
+git clone {{仓库地址}}
+cd {{项目目录}}
+
+# 复制配置文件
+cp config/.env.example config/.env
+
+# 编辑配置
+vim config/.env
+```
+
+### 3. 安装依赖
+```bash
+# 后端依赖
+{{安装命令}}
+
+# 前端依赖
+{{安装命令}}
+```
+
+## 🔄 开发流程
+
+### 代码规范
+- **分支命名**: `feature/功能名`, `bugfix/问题描述`, `hotfix/紧急修复`
+- **提交信息**: 遵循 Conventional Commits 规范
+- **代码风格**: 使用项目预设的 lint 规则
+
+### 工作流程
+```mermaid
+graph LR
+    A[创建Issue] --> B[新建功能分支]
+    B --> C[开发与自测]
+    C --> D[提交Pull Request]
+    D --> E[代码审查]
+    E --> F[合并到主分支]
+    F --> G[部署测试]
+```
+
+## 🧪 测试指南
+
+### 单元测试
+```bash
+# 运行测试
+{{测试命令}}
+
+# 生成覆盖率报告
+{{覆盖率命令}}
+```
+
+### 集成测试
+1. 启动测试环境
+2. 运行测试套件
+3. 查看测试报告
+
+## 📦 构建与部署
+
+### 本地构建
+```bash
+{{构建命令}}
+```
+
+### 生产部署
+> **Warning**
+> 生产部署需要管理员权限
+
+1. 更新版本号
+2. 运行构建脚本
+3. 执行部署命令
+
+## 🔍 调试技巧
+
+### 常见问题
+| 问题 | 解决方案 |
+|------|----------|
+| 启动失败 | 检查端口占用，查看日志 |
+| 数据库连接失败 | 验证配置，检查服务状态 |
+| 依赖安装失败 | 切换镜像源，清除缓存 |
+
+### 日志查看
+```bash
+# 查看实时日志
+tail -f logs/app.log
+
+# 按级别过滤
+grep "ERROR" logs/app.log
+```
+
+## 📚 学习资源
+- [官方文档]({{链接}})
+- [架构设计](架构设计)
+- [API文档](API文档)
+```
+
+### 模板3：📡 **API文档** (`开发/API文档.md`)
+```markdown
+# API 文档
+
+> **版本**: v1.0  
+> **基础URL**: `https://api.example.com/v1`  
+> **认证方式**: Bearer Token
+
+[[_TOC_]]
+
+## 认证相关
+
+### 获取访问令牌
+**POST** `/auth/login`
+
+#### 请求参数
+```json
+{
+  "username": "string",
+  "password": "string"
+}
+```
+
+#### 响应示例
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "token": "eyJhbGciOiJIUzI1NiIs...",
+    "expires_in": 7200
+  }
+}
+```
+
+#### 错误码
+| 状态码 | 说明 |
+|--------|------|
+| 401 | 用户名或密码错误 |
+| 429 | 请求过于频繁 |
+
+## 用户管理
+
+### 获取用户列表
+**GET** `/users`
+
+#### 查询参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| page | integer | 否 | 页码，默认1 |
+| size | integer | 否 | 每页数量，默认20 |
+| keyword | string | 否 | 搜索关键词 |
+
+#### 响应示例
+```json
+{
+  "code": 200,
+  "data": {
+    "list": [
+      {
+        "id": 1,
+        "username": "zhangsan",
+        "email": "zhangsan@example.com",
+        "created_at": "2023-01-01T00:00:00Z"
+      }
+    ],
+    "total": 100,
+    "page": 1,
+    "size": 20
+  }
+}
+```
+
+### 创建用户
+**POST** `/users`
+
+> **Note**
+> 需要管理员权限
+
+#### 请求头
+```
+Authorization: Bearer {token}
+Content-Type: application/json
+```
+
+#### 请求体
+```json
+{
+  "username": "string",
+  "email": "string",
+  "password": "string",
+  "role": "user"
+}
+```
+
+## 状态码说明
+| 状态码 | 说明 |
+|--------|------|
+| 200 | 请求成功 |
+| 201 | 创建成功 |
+| 400 | 请求参数错误 |
+| 401 | 未授权 |
+| 403 | 权限不足 |
+| 404 | 资源不存在 |
+| 500 | 服务器内部错误 |
+
+## 📡 API 测试
+```bash
+# 使用 curl 测试
+curl -X GET "https://api.example.com/v1/users" \
+  -H "Authorization: Bearer {token}"
+
+# 使用 Postman 导入
+[Postman Collection 链接]
+```
+
+## 🔄 更新日志
+- **2023-10-01**: v1.0 初始版本
+- **2023-10-15**: 新增用户搜索功能
+```
+
+### 模板4：🐛 **问题排查指南** (`运维/问题排查.md`)
+```markdown
+# 常见问题排查指南
+
+[[_TOC_]]
+
+## 问题分类索引
+
+### 🔴 紧急问题（立即处理）
+1. [服务完全不可用](#服务完全不可用)
+2. [数据库连接失败](#数据库连接失败)
+3. [关键功能故障](#关键功能故障)
+
+### 🟡 重要问题（今日处理）
+1. [性能下降](#性能下降)
+2. [部分用户无法访问](#部分用户无法访问)
+3. [数据不一致](#数据不一致)
+
+### 🟢 一般问题（本周处理）
+1. [界面显示异常](#界面显示异常)
+2. [功能使用不便](#功能使用不便)
+
+## 🔴 紧急问题
+
+### 服务完全不可用
+**症状**: 所有用户无法访问，返回 5xx 错误
+
+#### 排查步骤
+```bash
+# 1. 检查服务状态
+systemctl status {{服务名}}
+
+# 2. 查看服务日志
+journalctl -u {{服务名}} -n 50
+
+# 3. 检查端口占用
+netstat -tlnp | grep :{{端口}}
+
+# 4. 检查资源使用
+top -c
+free -h
+df -h
+```
+
+#### 快速恢复
+```bash
+# 重启服务
+systemctl restart {{服务名}}
+
+# 回滚到上一个版本
+{{回滚脚本}}
+```
+
+### 数据库连接失败
+**症状**: 应用日志显示数据库连接异常
+
+#### 排查步骤
+1. **检查数据库服务**
+   ```bash
+   # MySQL
+   systemctl status mysql
+   
+   # 连接测试
+   mysql -h {{主机}} -u {{用户}} -p
+   ```
+
+2. **检查连接配置**
+   ```bash
+   # 查看配置文件
+   cat config/.env | grep DB_
+   ```
+
+3. **检查连接数**
+   ```sql
+   -- MySQL 查看连接数
+   SHOW PROCESSLIST;
+   SHOW VARIABLES LIKE 'max_connections';
+   ```
+
+## 🧰 工具集
+
+### 常用命令
+```bash
+# 查看实时日志
+tail -f /var/log/{{服务}}/app.log
+
+# 查找错误
+grep -r "ERROR\|Exception" /var/log/{{服务}}/
+
+# 性能监控
+htop
+iotop -o
+iftop -P
+```
+
+### 监控面板
+- **Grafana**: {{监控面板链接}}
+- **日志平台**: {{日志平台链接}}
+- **APM**: {{应用性能监控链接}}
+
+## 📞 紧急联系人
+| 时间段 | 负责人 | 电话 | 备用联系人 |
+|--------|--------|------|------------|
+| 工作日 9:00-18:00 | @{{姓名}} | {{电话}} | @{{姓名}} |
+| 工作日 18:00-24:00 | @{{姓名}} | {{电话}} | @{{姓名}} |
+| 周末及节假日 | @{{姓名}} | {{电话}} | @{{姓名}} |
+
+## 📚 参考文档
+- [部署文档](部署指南)
+- [架构说明](架构设计)
+- [监控告警配置](监控配置)
+```
+
+### 模板5：📊 **项目会议记录** (`管理/会议记录/2024-01-例会.md`)
+```markdown
+# 项目周会记录
+
+## 会议基本信息
+- **日期**: {{2024-01-15}}
+- **时间**: {{14:00}} - {{15:30}}
+- **地点**: {{线上会议}} / {{会议室A}}
+- **主持人**: @{{姓名}}
+- **记录人**: @{{姓名}}
+- **参会人员**: @{{人员1}} @{{人员2}} @{{人员3}}
+
+## 📋 议程
+1. 上周工作回顾
+2. 本周计划安排
+3. 问题与风险讨论
+4. 其他事项
+
+## 🔍 上周工作回顾
+
+### 已完成
+| 任务 | 负责人 | 状态 | 备注 |
+|------|--------|------|------|
+| {{功能A开发}} | @{{姓名}} | ✅ 完成 | 已通过测试 |
+| {{Bug修复}} | @{{姓名}} | ✅ 完成 | 已部署到测试环境 |
+| {{文档编写}} | @{{姓名}} | ✅ 完成 | 已更新到Wiki |
+
+### 进行中
+| 任务 | 负责人 | 进度 | 预计完成 |
+|------|--------|------|----------|
+| {{功能B开发}} | @{{姓名}} | 70% | 2024-01-18 |
+| {{性能优化}} | @{{姓名}} | 40% | 2024-01-19 |
+
+### 未完成/延迟
+| 任务 | 负责人 | 原因 | 新计划 |
+|------|--------|------|--------|
+| {{第三方集成}} | @{{姓名}} | 接口文档延迟提供 | 2024-01-22 |
+
+## 🎯 本周计划
+
+### 开发任务
+- [ ] {{功能B联调测试}} (@{{姓名}})
+- [ ] {{数据库迁移准备}} (@{{姓名}})
+- [ ] {{移动端适配}} (@{{姓名}})
+
+### 其他任务
+- [ ] {{技术方案评审}} (周三)
+- [ ] {{项目进度汇报}} (周五)
+
+## ⚠️ 问题与风险
+
+### 当前问题
+1. **问题描述**: {{第三方服务不稳定}}
+   - **影响**: {{调用失败率5%}}
+   - **解决方案**: {{添加重试机制和降级方案}}
+   - **负责人**: @{{姓名}}
+   - **解决时限**: {{2024-01-17}}
+
+2. **问题描述**: {{测试环境资源不足}}
+   - **影响**: {{自动化测试运行缓慢}}
+   - **解决方案**: {{申请扩容测试服务器}}
+   - **负责人**: @{{姓名}}
+
+### 风险识别
+| 风险 | 可能性 | 影响程度 | 应对措施 |
+|------|--------|----------|----------|
+| {{关键人员请假}} | 低 | 高 | {{知识分享，任务备份}} |
+| {{需求变更}} | 中 | 中 | {{加强沟通，预留缓冲}} |
+
+## 💡 重要决策
+1. **决策**: {{采用方案A而非方案B}}
+   - **原因**: {{方案A更稳定，维护成本低}}
+   - **影响**: {{开发周期增加1天}}
+
+2. **决策**: {{推迟功能C到下个迭代}}
+   - **原因**: {{当前资源紧张，优先级调整}}
+   - **影响**: {{需要与产品沟通调整发布计划}}
+
+## 📝 行动计划
+| 事项 | 负责人 | 截止时间 | 产出物 |
+|------|--------|----------|--------|
+| {{完成功能B联调}} | @{{姓名}} | 2024-01-18 | {{可测试版本}} |
+| {{解决第三方服务问题}} | @{{姓名}} | 2024-01-17 | {{技术方案文档}} |
+| {{准备进度汇报材料}} | @{{姓名}} | 2024-01-19 | {{PPT报告}} |
+
+## 🔗 相关材料
+- [项目看板]({{看板链接}})
+- [上周会议记录](2024-01-08-例会)
+- [技术方案文档]({{文档链接}})
+
+## 🗓️ 下次会议
+- **时间**: {{2024-01-22}} {{14:00}}
+- **主持人**: @{{姓名}}
+- **会前准备**: {{每人准备2分钟进度汇报}}
+
+---
+*会议记录更新于: {{2024-01-15 16:00}}*
+```
+
+---
+
+## 🗂️ **Wiki 组织结构建议**
+
+### 推荐目录结构
+```
+Home.md                     # 项目首页
+├── 开发/                    # 技术文档
+│   ├── 开发指南.md
+│   ├── API文档.md
+│   ├── 架构设计.md
+│   └── 数据库设计.md
+├── 部署/                    # 运维部署
+│   ├── 部署指南.md
+│   ├── 问题排查.md
+│   └── 监控配置.md
+├── 管理/                    # 项目管理
+│   ├── 会议记录/
+│   │   ├── 2024-01-08-例会.md
+│   │   └── 2024-01-15-例会.md
+│   └── 项目计划.md
+├── 产品/                    # 产品文档
+│   ├── 需求文档.md
+│   └── 功能说明.md
+└── 团队/                    # 团队协作
+    ├── 团队规范.md
+    ├── 新人指引.md
+    └── 常用工具.md
+```
+
+### 命名规范
+- **英文优先**: 建议使用英文命名，便于链接和搜索
+- **简洁明确**: `API文档.md` 而非 `关于API的详细文档说明.md`
+- **避免特殊字符**: 不要使用 `? * : " < > | \` 等字符
+
+---
+
+## 💡 **高级技巧**
+
+### 1. **Wiki 与 Issue 联动**
+```markdown
+在 Issue 中引用 Wiki:
+相关文档: [开发指南](开发/开发指南)
+
+在 Wiki 中引用 Issue:
+待解决问题: #123, #456
+```
+
+### 2. **创建侧边栏导航**
+创建 `_Sidebar.md` 文件（如果 Gitea 支持）：
+```markdown
+## 导航
+- [首页](Home)
+- [开发文档](开发/开发指南)
+- [API文档](开发/API文档)
+- [部署运维](部署/部署指南)
+
+## 快速链接
+- [项目看板]({{看板链接}})
+- [代码仓库]({{仓库链接}})
+- [Issue列表]({{Issues链接}})
+```
+
+### 3. **版本化管理**
+Wiki 本身基于 Git，可以：
+```bash
+# 克隆 Wiki 仓库
+git clone https://your-gitea.com/username/repo.wiki.git
+
+# 本地编辑后提交
+git add .
+git commit -m "更新文档"
+git push
+```
+
+### 4. **权限控制**
+- 默认 Wiki 权限与仓库相同
+- 可通过仓库设置调整成员权限
+
+---
+
+## 🚀 **立即开始**
+
+1. **选择模板**：根据需求选择合适的模板
+2. **复制内容**：将模板复制到 Gitea Wiki 编辑器
+3. **替换变量**：修改 `{{变量}}` 为实际内容
+4. **建立链接**：在页面间添加相互链接
+5. **保持更新**：养成及时更新文档的习惯
+
+这些模板覆盖了项目文档的主要场景，你可以直接复制使用或按需调整。Wiki 的最大价值在于**持续更新和团队共享**，建议将文档更新纳入日常工作流程。
\ No newline at end of file