From b49e78a6864113b4169f86db81b9bf1b1aad07ea Mon Sep 17 00:00:00 2001
From: rw0067680 <18133922183@163.com>
Date: Tue, 23 Dec 2025 18:37:46 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/index.md                           |    1 -
 docs/学习笔记/MkDocs 是什么.md          | 1258 +++++++++++++++++++++++
 docs/学习笔记/gerrit上传代码详细指南.md |  424 ++++++++
 docs/开发指南/开发规范.md               |    6 +-
 docs/开发指南/快速开始.md               |    6 +-
 docs/开发指南/项目结构.md               |    3 +-
 docs/技术文档/架构设计.md               |    1 -
 docs/技术文档/部署文档.md               |    1 -
 mkdocs.yml                              |    2 +
 使用说明.md                             |   23 +-
 部署说明.md                             |   11 +-
 11 files changed, 1724 insertions(+), 12 deletions(-)
 create mode 100644 docs/学习笔记/MkDocs 是什么.md
 create mode 100644 docs/学习笔记/gerrit上传代码详细指南.md

diff --git a/docs/index.md b/docs/index.md
index cbecd4b..fdc6a19 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -64,4 +64,3 @@ docs/
 ---
 
 **开始编写你的文档吧！** 📝
-
diff --git a/docs/学习笔记/MkDocs 是什么.md b/docs/学习笔记/MkDocs 是什么.md
new file mode 100644
index 0000000..441fa29
--- /dev/null
+++ b/docs/学习笔记/MkDocs 是什么.md	
@@ -0,0 +1,1258 @@
+# MkDocs 是什么
+
+## MkDocs 是什么？
+
+**MkDocs** 是一个**快速、简单、优雅的静态网站生成器**，专门用于从 Markdown 文件构建项目文档。它的设计目标非常明确：让创建美观、实用的文档网站变得尽可能轻松。
+
+### 核心特点
+
+**1. 极简配置**
+
+- 只需一个 YAML 配置文件 (`mkdocs.yml`)
+
+- 几分钟内即可搭建起完整的文档站点
+
+**2. Markdown 驱动**
+
+- 所有内容都使用 Markdown 编写
+
+- 对开发者友好，学习成本低
+
+**3. 丰富的主题系统**
+
+- 内置多个主题（如 `material`、`readthedocs`）
+
+- Material for MkDocs 主题尤为强大，支持：
+  
+  - 响应式设计
+  
+  - 深色/浅色模式
+  
+  - 搜索功能
+  
+  - 多级导航
+  
+  - 代码高亮
+
+### 在你的 DevOps 平台中的角色
+
+在你的“个人超级 DevOps 平台”中，**MkDocs 作为个人知识库**：
+
+text
+
+# 典型结构
+
+docs/                    # 你的知识库
+├── index.md            # 首页
+├── devops-platform.md  # DevOps平台搭建记录
+├── kubernetes-guide.md # K8s学习笔记
+├── api-references/     # API文档
+└── troubleshooting.md  # 排错手册
+mkdocs.yml              # 配置文件
+
+### 为什么适合你的技术栈？
+
+**与你的其他组件完美集成：**
+
+1. **与 Gitea 结合**
+   
+   - 将 MkDocs 源码存储在 Gitea 中
+   
+   - 使用 Git Hook 自动构建和部署文档
+   
+   - 用 Gitea 的 Wiki 做协作，MkDocs 做正式知识库
+
+2. **与 MinIO 结合**
+   
+   - 将构建的静态文档网站托管到 MinIO
+   
+   - 使用 MinIO 作为文档附件存储
+
+3. **作为知识沉淀中心**
+   
+   - 记录你的 DevOps 平台搭建过程
+   
+   - 编写团队技术规范
+   
+   - 整理问题解决方案
+
+### 快速示例
+
+**安装：**
+
+bash
+
+pip install mkdocs mkdocs-material
+
+**创建新站点：**
+
+bash
+
+mkdocs new my-knowledge-base
+cd my-knowledge-base
+
+**简单配置 (`mkdocs.yml`)：**
+
+yaml
+
+site_name: 我的技术知识库
+theme:
+  name: material
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - search.suggest
+    - search.highlight
+
+nav:
+
+- 首页: index.md
+- DevOps平台:
+  - 架构设计: devops/architecture.md
+  - 部署指南: devops/deployment.md
+- 移动开发:
+  - CI/CD流程: mobile/ci-cd.md
+  - 发布管理: mobile/release.md
+
+**编写内容 (`docs/index.md`)：**
+
+markdown
+
+# 欢迎来到我的知识库
+
+这里是个人超级 DevOps 平台的所有技术文档。
+
+## 平台组件
+
+- **代码管理**: Gitea
+- **依赖管理**: Nexus
+- **文档管理**: MkDocs
+- **监控告警**: Sentry + Grafana
+
+**本地预览：**
+
+bash
+
+mkdocs serve
+
+# 在 http://localhost:8000 查看
+
+### 进阶用法
+
+**版本化文档：**
+
+yaml
+
+theme:
+  name: material
+  features:
+    - navigation.tabs
+    - navigation.tabs.sticky
+  language: zh
+
+extra:
+  version:
+    provider: mike
+
+plugins:
+
+- search
+- mike:
+    alias_type: symlink
+
+**与 CI/CD 集成：**
+
+yaml
+
+# GitLab CI 示例
+
+pages:
+  stage: deploy
+  script:
+    - pip install mkdocs mkdocs-material
+    - mkdocs build
+    - mv site public
+  artifacts:
+    paths:
+      - public
+  only:
+    - main
+
+### 优势总结
+
+✅ **简单易用** - Markdown 编写，配置简单  
+✅ **维护方便** - 版本控制友好  
+✅ **部署灵活** - 生成静态文件，可托管到任何地方  
+✅ **搜索强大** - 内置全文搜索  
+✅ **移动友好** - 响应式设计  
+✅ **社区活跃** - 丰富的插件生态
+
+在你的 DevOps 生态中，MkDocs 是**文档即代码**理念的完美实践，它让技术文档的编写、维护和发布变得和写代码一样规范高效。
+
+vscode下载
+
+我来详细介绍如何下载和安装 Visual Studio Code (VSCode)，这是开发者必备的代码编辑器。
+
+## 下载 VSCode 的几种方式
+
+### 1. **官方网站下载**（最推荐）
+
+**访问官网：** [https://code.visualstudio.com/](https://code.visualstudio.com/)
+
+官网会自动检测你的操作系统，推荐合适的版本：
+
+- **Windows 用户**：下载 `.exe` 安装包
+
+- **macOS 用户**：下载 `.dmg` 文件或 `.zip` 压缩包
+
+- **Linux 用户**：提供多种包格式（`.deb`, `.rpm`, `.tar.gz`）
+
+### 2. **各平台具体下载地址**
+
+**Windows：**
+
+text
+
+https://code.visualstudio.com/sha/download?build=stable&os=win32-x64-user
+
+**macOS：**
+
+- Intel 芯片：
+
+text
+
+https://code.visualstudio.com/sha/download?build=stable&os=darwin
+
+- Apple Silicon (M1/M2/M3)：
+
+text
+
+https://code.visualstudio.com/sha/download?build=stable&os=darwin-arm64
+
+**Linux：**
+
+text
+
+https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64
+
+### 3. **使用包管理器安装**
+
+**Windows (Winget)：**
+
+bash
+
+winget install Microsoft.VisualStudioCode
+
+**macOS (Homebrew)：**
+
+bash
+
+brew install --cask visual-studio-code
+
+**Ubuntu/Debian：**
+
+bash
+
+sudo apt update
+sudo apt install software-properties-common apt-transport-https wget
+wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add -
+sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main"
+sudo apt update
+sudo apt install code
+
+**CentOS/RHEL/Fedora：**
+
+bash
+
+sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
+sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
+sudo dnf install code  # 或 sudo yum install code
+
+### 4. **便携版下载**
+
+如果你想要免安装版本：
+
+- **Windows**：下载 `VSCode-win32-x64-XX.X.X.zip`
+
+- **macOS**：下载 `VSCode-darwin-x64-XX.X.X.zip`
+
+- **Linux**：下载 `VSCode-linux-x64-XX.X.X.tar.gz`
+
+## 安装步骤
+
+### **Windows 安装**
+
+1. 下载 `.exe` 安装包
+
+2. 双击运行安装程序
+
+3. 同意许可协议
+
+4. 选择安装选项（推荐勾选）：
+   
+   - ✅ 将“通过 Code 打开”操作添加到 Windows 资源管理器文件上下文菜单
+   
+   - ✅ 将“通过 Code 打开”操作添加到 Windows 资源管理器目录上下文菜单
+   
+   - ✅ 将 Code 注册为受支持的文件类型的编辑器
+   
+   - ✅ 添加到 PATH（允许从命令行运行 `code`）
+
+### **macOS 安装**
+
+1. 下载 `.dmg` 文件
+
+2. 双击打开磁盘映像
+
+3. 将 VSCode 图标拖到“应用程序”文件夹
+
+4. 首次运行时，可能会提示“无法打开”，需要：
+   
+   - 右键点击 VSCode → 打开
+   
+   - 或在“系统偏好设置 → 安全性与隐私”中允许打开
+
+### **Linux 安装**
+
+**使用 .deb 包 (Ubuntu/Debian)：**
+
+bash
+
+sudo dpkg -i code_*.deb
+sudo apt-get install -f  # 安装依赖
+
+## 首次设置建议
+
+安装完成后，建议进行以下配置：
+
+### 1. **安装中文语言包**
+
+1. 打开 VSCode
+
+2. 按 `Ctrl+Shift+X` 打开扩展面板
+
+3. 搜索 `Chinese (Simplified)`
+
+4. 点击安装并重启
+
+### 2. **推荐扩展**（根据你的 DevOps 需求）
+
+**通用开发：**
+
+- `GitLens` - Git 增强
+
+- `Git History` - Git 历史查看
+
+- `Error Lens` - 错误提示增强
+
+- `Path Intellisense` - 路径自动补全
+
+**DevOps 相关：**
+
+- `Docker` - Docker 支持
+
+- `Kubernetes` - K8s 支持
+
+- `YAML` - YAML 语言支持
+
+- `HashiCorp Terraform` - Terraform 支持
+
+**文档编写：**
+
+- `Markdown All in One` - Markdown 增强
+
+- `markdownlint` - Markdown 格式检查
+
+- `Paste Image` - 粘贴图片到 Markdown
+
+**你的技术栈扩展：**
+
+- `Gradle for Java` - Gradle 支持
+
+- `MinIO` - MinIO 文件管理
+
+- `Gitea` - Gitea 集成
+
+### 3. **常用配置**
+
+json
+
+// settings.json
+{
+  "editor.fontSize": 14,
+  "editor.tabSize": 2,
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "explicit"
+  },
+  "files.autoSave": "afterDelay",
+  "terminal.integrated.defaultProfile.windows": "Git Bash",
+  "workbench.colorTheme": "Default Dark Modern",
+  "workbench.iconTheme": "material-icon-theme"
+}
+
+## 便携版使用（无需安装）
+
+如果你下载的是便携版：
+
+**Windows：**
+
+1. 解压 `VSCode-win32-x64-XX.X.X.zip` 到任意目录
+
+2. 运行 `Code.exe`
+
+**macOS/Linux：**
+
+1. 解压压缩包
+
+2. 进入解压目录，运行 `./Code`（可能需要 `chmod +x`）
+
+## 验证安装
+
+打开终端/命令提示符，输入：
+
+bash
+
+code --version
+
+# 或
+
+code --help
+
+如果正确安装，会显示版本信息：
+
+text
+
+1.84.2
+...
+
+## 小贴士
+
+1. **自动更新**：VSCode 默认启用自动更新，可以在设置中调整
+
+2. **Insiders 版本**：如果想体验最新功能，可以下载 [VSCode Insiders](https://code.visualstudio.com/insiders/)
+
+3. **同步设置**：登录 Microsoft/GitHub 账号可同步设置到不同设备
+
+4. **命令行使用**：安装时添加到 PATH 后，可以在终端中用 `code .` 打开当前目录
+
+## 快速开始
+
+安装完成后，你可以：
+
+1. 按 `F1` 或 `Ctrl+Shift+P` 打开命令面板
+
+2. 输入 `>Git: Clone` 克隆你的 Gitea 仓库
+
+3. 开始编写你的 DevOps 平台代码和文档
+
+VSCode 是搭建和维护你的“个人超级 DevOps 平台”的绝佳工具，配合你提到的 Gitea、MkDocs 等组件，能极大提升开发效率！
+
+- **Typora**（所见即所得）
+  下载
+
+# Typora 下载和安装指南
+
+## 官方下载渠道
+
+### 1. **官方网站**
+
+**访问：** [https://typora.io/](https://typora.io/)
+
+点击首页的 "Download" 按钮，会自动推荐适合你系统的版本。
+
+### 2. **各平台直接下载链接**
+
+**Windows：**
+
+- 64位：https://typora.io/windows/typora-setup-x64.exe
+
+- 32位：https://typora.io/windows/typora-setup-ia32.exe
+
+**macOS：**
+
+- Intel：https://typora.io/mac/Typora.dmg
+
+- Apple Silicon (M1/M2/M3)：https://typora.io/mac/Typora.dmg （通用版本）
+
+**Linux：**
+
+bash
+
+# Debian/Ubuntu
+
+wget -qO - https://typora.io/linux/public-key.asc | sudo tee /etc/apt/trusted.gpg.d/typora.asc
+sudo add-apt-repository 'deb https://typora.io/linux ./'
+sudo apt update
+sudo apt install typora
+
+# 或直接下载 .deb 包
+
+https://typora.io/linux/Typora-linux-x64.deb
+
+### 3. **国内镜像/备用下载**
+
+由于网络原因，如果官网下载慢，可以尝试：
+
+**GitHub Releases：**
+
+text
+
+https://github.com/typora/typora-issues/releases
+
+**第三方镜像站：**
+
+- 腾讯软件中心：https://pc.qq.com/detail/10/detail_22850.html
+
+- 华为云镜像：https://mirrors.huaweicloud.com/typora/
+
+## 安装步骤
+
+### **Windows 安装**
+
+1. 下载 `.exe` 安装包
+
+2. 双击运行安装程序
+
+3. 选择安装位置（默认 `C:\Program Files\Typora`）
+
+4. 创建桌面快捷方式和开始菜单项
+
+5. 完成安装
+
+### **macOS 安装**
+
+1. 下载 `.dmg` 文件
+
+2. 双击打开磁盘映像
+
+3. 将 Typora 图标拖到 "应用程序" 文件夹
+
+4. 首次运行时，如果提示 "无法打开"：
+   
+   - 右键点击 Typora → 打开
+   
+   - 或进入 "系统偏好设置 → 安全性与隐私" → 点击 "仍要打开"
+
+### **Linux 安装**
+
+bash
+
+# 使用 .deb 包安装
+
+sudo dpkg -i Typora-linux-x64.deb
+sudo apt install -f  # 修复依赖
+
+# 或使用 Snap
+
+sudo snap install typora
+
+## 许可证激活
+
+**注意：Typora 现在是付费软件**（从 2021.11 开始）
+
+### 1. **试用版**
+
+- 提供 15 天免费试用
+
+- 试用期满后需要购买许可证
+
+### 2. **购买许可证**
+
+1. 访问：[https://store.typora.io/](https://store.typora.io/)
+
+2. 选择许可证类型：
+   
+   - **个人版**：$14.99（3台设备）
+   
+   - **商业版**：$29.99（3台设备）
+   
+   - **教育优惠**：有折扣
+
+3. 购买后会收到许可证密钥
+
+### 3. **激活步骤**
+
+1. 打开 Typora
+
+2. 菜单栏选择 `帮助 → 我的许可证...`
+
+3. 输入邮箱和许可证密钥
+
+4. 激活成功
+
+## 替代方案（如果你不想付费）
+
+### **免费开源替代品**
+
+1. **MarkText** - 类似 Typora 的免费开源编辑器
+   
+   - GitHub：[GitHub - marktext/marktext: 📝A simple and elegant markdown editor, available for Linux, macOS and Windows.](https://github.com/marktext/marktext)
+   
+   - 下载：[Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases)
+
+2. **Obsidian** - 强大的知识库工具，免费个人使用
+   
+   - 官网：[https://obsidian.md/](https://obsidian.md/)
+
+3. **Zettlr** - 学术写作的 Markdown 编辑器
+   
+   - 官网：[https://www.zettlr.com/](https://www.zettlr.com/)
+
+4. **VSCode + Markdown 扩展**
+   
+   bash
+   
+   # 安装以下扩展
+   
+   1. Markdown All in One
+   2. Markdown Preview Enhanced
+   3. Markdown Preview Github Styling
+
+### **旧版本 Typora**
+
+如果你有旧版本 (v0.11.18 及之前)，可以继续使用：
+
+- GitHub 旧版本下载：https://github.com/typora/typora-issues/issues/8102
+
+- **注意**：旧版本可能存在安全漏洞
+
+## Typora 基本使用
+
+### 1. **界面概览**
+
+text
+
+左侧：文件树或大纲视图
+中间：编辑区域（所见即所得）
+右侧：大纲导航
+
+### 2. **常用快捷键**
+
+- `Ctrl + /`：切换源代码模式
+
+- `Ctrl + B`：加粗
+
+- `Ctrl + I`：斜体
+
+- `Ctrl + K`：插入链接
+
+- `Ctrl + Shift + I`：插入图片
+
+- `Ctrl + T`：插入表格
+
+- `Ctrl + Shift + M`：数学公式
+
+- `Ctrl + 1~6`：标题级别
+
+### 3. **与你的 DevOps 平台集成**
+
+**配合 Gitea：**
+
+1. 在 Typora 中编写 Markdown 文档
+
+2. 保存到 Git 仓库目录
+
+3. 使用 Git 命令或 Git 客户端提交到 Gitea
+
+**配合 MkDocs：**
+
+yaml
+
+# mkdocs.yml 配置 Typora 兼容
+
+markdown_extensions:
+
+- admonition
+- codehilite
+- footnotes
+- meta
+- toc:
+    permalink: true
+- pymdownx.superfences
+- pymdownx.tabbed
+
+### 4. **图片处理配置**
+
+yaml
+
+# Typora 偏好设置 → 图像
+
+- 复制图片到 ./${filename}.assets 文件夹
+- 对本地位置的图片应用上述规则
+- 对网络位置的图片应用上述规则
+
+## 主题和样式
+
+### 内置主题：
+
+1. **Github** - GitHub 风格
+
+2. **Night** - 深色主题
+
+3. **Pixyll** - 简洁风格
+
+4. **Whitey** - 纯白简洁
+
+### 自定义 CSS：
+
+1. 打开主题文件夹：`文件 → 偏好设置 → 外观 → 打开主题文件夹`
+
+2. 创建 `user.base.user.css` 文件
+
+3. 添加自定义样式：
+
+css
+
+/* 自定义样式 */
+body {
+    font-family: "Microsoft YaHei", sans-serif;
+    max-width: 900px;
+    margin: 0 auto;
+}
+
+img {
+    border-radius: 8px;
+    box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+}
+
+## 常见问题解决
+
+### Q1: 下载速度慢？
+
+- 使用国内镜像站
+
+- 使用下载工具（IDM、迅雷等）
+
+- 尝试 GitHub Releases
+
+### Q2: 安装失败？
+
+**Windows：**
+
+- 以管理员身份运行
+
+- 关闭杀毒软件临时
+
+- 检查系统版本（需要 Win7 以上）
+
+**macOS：**
+
+bash
+
+# 如果提示 "已损坏"
+
+sudo xattr -rd com.apple.quarantine /Applications/Typora.app
+
+**Linux：**
+
+bash
+
+# 依赖问题
+
+sudo apt --fix-broken install
+
+### Q3: 许可证问题？
+
+- 检查网络连接
+
+- 确认邮箱和密钥正确
+
+- 访问 https://typora.io/dev_release.html 检查服务状态
+
+## 推荐配置（用于 DevOps 文档）
+
+### 1. **工作流设置**
+
+text
+
+1. 在 Typora 中编写 Markdown
+2. 保存到 Git 管理的 docs/ 目录
+3. 使用 MkDocs 构建静态网站
+4. 部署到服务器或 GitHub Pages
+
+### 2. **写作模板**
+
+创建模板文件 `template.md`：
+
+markdown
+
+---
+
+title: {{title}}
+date: {{date}}
+tags: 
+category: 
+
+---
+
+# {{title}}
+
+## 概述
+
+## 详细内容
+
+## 参考链接
+
+### 3. **自动化脚本**
+
+bash
+
+#!/bin/bash
+
+# auto_build.sh - 自动构建文档
+
+cd /path/to/docs
+typora --wait-for-signal-to-close document.md
+mkdocs build
+git add .
+git commit -m "Update documentation"
+git push
+
+## 总结
+
+Typora 是一款优秀的 Markdown 编辑器，特别适合：
+
+- 个人知识库管理（配合你的 MkDocs）
+
+- 技术文档编写
+
+- 日常笔记记录
+
+如果你需要完全免费的方案，建议考虑 **MarkText** 或 **Obsidian**。对于你的 DevOps 平台，Typora 的所见即所得特性确实能提升 Markdown 文档的编写体验。
+
+本回答由 AI 生成，内容仅供参考，请仔细甄别。
+
+image.png
+
+PNG 33.06KB
+
+下载好了，如何安装
+
+根据你提供的信息，你已经下载了 MarkText 的 Windows 安装文件。以下是详细的安装步骤：
+
+## 方法一：使用安装向导（推荐）
+
+### 步骤：
+
+1. **找到下载的文件**
+   
+   - 通常在 `Downloads`（下载）文件夹中
+   
+   - 文件名类似：`marktext-setup-x.x.x.exe`（x.x.x 是版本号）
+
+2. **运行安装程序**
+   
+   - 双击 `.exe` 文件
+   
+   - 如果出现安全警告，点击"运行"或"更多信息 → 仍要运行"
+
+3. **选择安装类型**
+   
+   text
+   
+   Install for: （选择安装范围）
+   □ Just me (当前用户)
+   ☑ All users (requires admin privileges) (所有用户，需要管理员权限)
+   
+   - **推荐选择**：`All users`（需要管理员权限）
+
+4. **选择安装位置**
+   
+   - 默认位置：`C:\Program Files\MarkText\`
+   
+   - 可以点击"Browse"更改安装路径
+
+5. **创建快捷方式**
+   
+   - 桌面快捷方式（推荐勾选）
+   
+   - 开始菜单文件夹
+
+6. **完成安装**
+   
+   - 点击"Install"开始安装
+   
+   - 安装完成后点击"Finish"
+
+## 方法二：使用包管理器安装
+
+### 如果已经下载了安装包，直接使用方法一即可。以下是使用包管理器的方法：
+
+### 1. **使用 Chocolatey**（需要先安装 Chocolatey）
+
+cmd
+
+# 以管理员身份打开命令提示符或 PowerShell
+
+choco install marktext
+
+### 2. **使用 Winget**（Windows 11 自带，Win10 可能需要安装）
+
+cmd
+
+# 以管理员身份打开终端
+
+winget install marktext
+
+## 验证安装
+
+### 检查是否安装成功：
+
+1. **启动程序**
+   
+   - 从开始菜单搜索"MarkText"
+   
+   - 双击桌面快捷方式（如果创建了）
+
+2. **命令行验证**
+   
+   cmd
+   
+   # 打开命令提示符或 PowerShell
+   
+   marktext --version
+   
+   # 或
+   
+   marktext --help
+
+3. **文件关联**（可选）
+   
+   - 安装后，MarkText 可能会询问是否关联 `.md` 文件
+   
+   - 点击"是"即可用 MarkText 打开所有 Markdown 文件
+
+## 首次使用设置
+
+### 1. **选择主题**
+
+打开 MarkText 后，你会看到：
+
+- **Dark Theme** - 深色主题
+
+- **Light Theme** - 浅色主题
+
+- **Graphite Theme** - 石墨主题
+
+- **Ulysses Theme** - Ulysses 风格
+
+- **Material Dark** - Material 深色
+
+- **Cadmium Light** - 镉浅色
+
+### 2. **基本配置**
+
+按 `Ctrl+,` 打开设置：
+
+json
+
+{
+  // 编辑器设置
+  "autoSave": true,           // 自动保存
+  "autoSaveDelay": 1000,      // 自动保存延迟（毫秒）
+  "defaultFontSize": 16,      // 默认字体大小
+
+  // 编辑器行为
+  "editorLineWidth": 800,     // 编辑器行宽
+  "fontFamily": "Arial",      // 字体
+
+  // Markdown 设置
+  "preferLooseListItem": true, // 宽松列表
+  "bulletListMarker": "-",     // 列表标记
+
+  // 图像设置
+  "imageFolderPath": "assets", // 图片保存文件夹
+  "setImageFolder": true       // 自动创建图片文件夹
+}
+
+### 3. **设置中文界面**
+
+1. 按 `Ctrl+,` 打开设置
+
+2. 搜索 `locale`
+
+3. 将 `locale` 改为 `zh-CN`
+
+4. 重启 MarkText
+
+## 常见问题解决
+
+### Q1：安装时提示"需要管理员权限"？
+
+- **解决方法**：
+  
+  1. 右键点击安装程序
+  
+  2. 选择"以管理员身份运行"
+  
+  3. 或者选择"Just me"（仅当前用户）安装选项
+
+### Q2：安装后无法启动？
+
+- **解决方法**：
+  
+  1. 重启电脑
+  
+  2. 检查防病毒软件是否阻止
+  
+  3. 重新安装
+  
+  4. 查看 Windows 事件查看器中的错误信息
+
+### Q3：如何卸载？
+
+cmd
+
+# 方法1：控制面板卸载
+
+# 方法2：使用包管理器
+
+winget uninstall marktext
+
+# 或
+
+choco uninstall marktext
+
+## 快速开始使用
+
+### 1. **创建第一篇文档**
+
+1. 按 `Ctrl+N` 新建文件
+
+2. 输入内容：
+   
+   markdown
+   
+   # 我的第一篇 Markdown
+   
+   ## 这是副标题
+   
+   - 列表项1
+   - 列表项2
+   
+   **粗体文本** *斜体文本*
+   
+   [链接](https://example.com)
+
+3. 按 `Ctrl+S` 保存
+
+### 2. **常用快捷键**
+
+- `Ctrl+N`：新建文件
+
+- `Ctrl+O`：打开文件
+
+- `Ctrl+S`：保存
+
+- `Ctrl+Shift+S`：另存为
+
+- `Ctrl+/`：切换源代码模式
+
+- `Ctrl+B`：加粗
+
+- `Ctrl+I`：斜体
+
+- `Ctrl+K`：插入链接
+
+- `Ctrl+Shift+I`：插入图片
+
+### 3. **与你的 DevOps 平台集成**
+
+将 MarkText 作为你的 Markdown 编辑器：
+
+bash
+
+# 在 Git 仓库中编辑文档
+
+cd /path/to/your/docs
+
+# 用 MarkText 打开文件
+
+marktext README.md
+
+# 或
+
+marktext .
+
+## 高级功能
+
+### 1. **多标签页**
+
+- 支持同时打开多个文件
+
+- 标签页可拖拽重新排列
+
+### 2. **多种编辑模式**
+
+- **源代码模式** - 纯文本编辑
+
+- **打字机模式** - 当前行居中
+
+- **专注模式** - 淡化其他内容
+
+### 3. **导出功能**
+
+支持导出为：
+
+- HTML
+
+- PDF
+
+- 纯文本
+
+### 4. **Git 集成**
+
+内置简单的 Git 支持：
+
+- 显示 Git 状态
+
+- 提交消息
+
+- 差异对比
+
+## 配置为默认 Markdown 编辑器
+
+### Windows 10/11：
+
+1. 右键点击 `.md` 文件
+
+2. 选择"打开方式" → "选择其他应用"
+
+3. 找到 MarkText，勾选"始终使用此应用打开 .md 文件"
+
+4. 点击"确定"
+
+完成安装后，你就可以用 MarkText 来编写你的 MkDocs 文档、技术笔记等，配合你的 DevOps 平台使用了！
+
+image.png
+
+PNG 64.83KB
+
+点击哪个文件安装呢？
+
+从你提供的文件列表来看，这是一个 **MarkText 的源代码项目目录**，而不是可以直接安装的安装程序。
+
+让我帮你分析一下：
+
+## 📁 **目录结构分析**
+
+text
+
+├── docs/              # 文档文件夹
+├── src/               # 源代码文件夹
+├── static/            # 静态资源
+├── resources/         # 应用资源
+├── package.json       # Node.js 项目配置文件
+├── electron-builder.yml # Electron 构建配置
+└── 其他配置文件...
+
+## 🚨 **重要：这不是安装包！**
+
+你下载的是 **MarkText 的源代码**，需要**编译构建**后才能得到安装程序。
+
+## 🛠️ **如何正确安装 MarkText**
+
+你有两个选择：
+
+### **选择一：下载正式安装包（推荐）**
+
+1. **访问 MarkText 官方发布页**：  
+   [Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases)
+
+2. **下载正确的安装包**：
+   
+   - Windows：`marktext-setup-x.x.x.exe` （x.x.x是版本号）
+   
+   - macOS：`marktext-x.x.x.dmg`
+   
+   - Linux：`marktext-x.x.x-x86_64.AppImage`
+
+3. **双击安装包安装**
+
+### **选择二：从源码构建安装**
+
+如果你确实想从这个源码构建：
+
+bash
+
+# 1. 安装 Node.js (v14+)
+
+# 从 https://nodejs.org/ 下载安装
+
+# 2. 安装 Yarn
+
+npm install -g yarn
+
+# 3. 进入项目目录
+
+cd "你下载的文件夹路径"
+
+# 4. 安装依赖
+
+yarn install
+
+# 5. 运行开发版本
+
+yarn run dev
+
+# 6. 构建安装包（可选）
+
+yarn run build
+
+## 📦 **快速对比**
+
+| 类型        | 文件                          | 说明     |
+| --------- | --------------------------- | ------ |
+| **✅ 安装包** | `.exe`, `.dmg`, `.AppImage` | 双击即可安装 |
+| **❌ 源代码** | 文件夹 + 配置文件                  | 需要编译构建 |
+
+## 🔍 **检查你下载的文件**
+
+如果你是通过以下方式下载的：
+
+- **GitHub 的绿色 "Code" 按钮** → 下载的是源代码
+
+- **Git clone 命令** → 下载的是源代码
+
+- **Release 页面的 "Source code"** → 下载的是源代码
+
+**正确的方式**：在 Release 页面找到 **Assets**（资源）部分，下载那里的文件。
+
+## 🎯 **立即获取安装包的步骤**
+
+1. **访问**：[Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases)
+
+2. **找到最新版本**（如 v0.17.1）
+
+3. **展开 "Assets"** 部分
+
+4. **下载对应系统的文件**：
+   
+   text
+   
+   Windows用户下载：
+   marktext-setup-x.x.x.exe  （约 90 MB）
+   或
+   marktext-setup-x.x-x64.exe
+
+## 💡 **如果你已经下载了源代码**
+
+你可以：
+
+1. **保留源代码**：用于学习或二次开发
+
+2. **删除源代码**：如果你只需要使用软件
+
+## 📝 **总结建议**
+
+**普通用户**：直接去 Release 页面下载安装包，简单快捷  
+**开发者**：可以保留源代码进行学习和定制
+
+**记住这个关键点**：
+
+- **`.exe` 文件** = 可以直接安装
+
+- **文件夹+配置文件** = 需要编译构建
+
+现在就去 Release 页面下载真正的安装包吧！这样你就能立即开始使用 MarkText 了。
diff --git a/docs/学习笔记/gerrit上传代码详细指南.md b/docs/学习笔记/gerrit上传代码详细指南.md
new file mode 100644
index 0000000..3a1b5ed
--- /dev/null
+++ b/docs/学习笔记/gerrit上传代码详细指南.md
@@ -0,0 +1,424 @@
+# gerrit上传代码详细指南
+
+# **Gerrit 代码上传详细指南**
+
+## **一、Gerrit 工作流程概述**
+
+```
+开发者 → 本地开发 → 推送代码审查 → Gerrit 评审 → 评审通过 → 合并代码
+     ↑                                                     ↓
+     └─────────────── 需要修改 ← 评审不通过 ←───────────────┘
+```
+
+## **二、环境准备**
+
+### **1. 安装必要的工具**
+
+```bash
+# 安装 Git
+sudo apt-get install git  # Ubuntu/Debian
+brew install git          # macOS
+
+# 安装 commit-msg 钩子（关键步骤）
+curl -Lo .git/hooks/commit-msg http://YOUR_GERRIT:8080/tools/hooks/commit-msg
+chmod +x .git/hooks/commit-msg
+```
+
+### **2. 配置 Git 用户信息**
+
+```bash
+git config --global user.name "你的姓名"
+git config --global user.email "你的邮箱@company.com"
+git config --global core.autocrlf input  # Windows 用户重要！
+git config --global core.safecrlf warn
+```
+
+### **3. 配置 SSH 密钥**
+
+```bash
+# 生成 SSH 密钥
+ssh-keygen -t ed25519 -C "your_email@company.com"
+
+# 查看公钥
+cat ~/.ssh/id_ed25519.pub
+
+# 将公钥添加到 Gerrit: Settings → SSH Keys
+```
+
+## **三、日常开发流程**
+
+### **1. 克隆项目**
+
+```bash
+# 方式1：通过 SSH（推荐）
+git clone ssh://username@gerrit-server:29418/project-name
+
+# 方式2：通过 HTTP
+git clone http://gerrit-server:8080/project-name
+```
+
+### **2. 创建开发分支**
+
+```bash
+# 从 master 创建功能分支
+git checkout master
+git pull origin master
+git checkout -b feature/your-feature-name
+
+# 或者从特定版本创建
+git checkout -b feature/xxx release-1.0
+```
+
+### **3. 进行开发**
+
+```bash
+# 修改文件
+git add .
+git status  # 查看状态
+
+# 提交代码（commit-msg 钩子会自动添加 Change-Id）
+git commit -m "功能描述
+
+详细描述：
+1. 做了什么修改
+2. 为什么修改
+3. 测试情况
+
+Bug: BUG-12345  # 如果有 Bug 编号
+Feature: FEAT-6789  # 如果有需求编号
+
+Change-Id: I自动生成"
+```
+
+### **4. 推送代码审查**
+
+```bash
+# 标准推送方式（创建/更新代码审查）
+git push origin HEAD:refs/for/目标分支
+
+# 示例：
+git push origin HEAD:refs/for/master          # 推送到 master 评审
+git push origin HEAD:refs/for/release-1.0     # 推送到 release 分支评审
+git push origin HEAD:refs/for/feature/xxx     # 推送到功能分支评审
+```
+
+## **四、推送参数详解**
+
+### **1. 普通推送**
+
+```bash
+# 创建新的代码审查
+git push origin HEAD:refs/for/master
+
+# 创建草稿代码审查
+git push origin HEAD:refs/drafts/master
+```
+
+### **2. 推送并设置评审人**
+
+```bash
+# 推送并添加 Reviewer
+git push origin HEAD:refs/for/master%r=reviewer1@company.com,r=reviewer2@company.com
+
+# 推送并添加 CC
+git push origin HEAD:refs/for/master%cc=manager@company.com
+
+# 推送并设置 Topic
+git push origin HEAD:refs/for/master%topic=feature/login
+```
+
+### **3. 推送选项组合**
+
+```bash
+# 完整示例
+git push origin HEAD:refs/for/master%\
+r=alice@company.com,\
+r=bob@company.com,\
+cc=manager@company.com,\
+topic=feature/login,\
+l=Code-Review+2,\
+l=Verified+1
+```
+
+## **五、更新已有的代码审查**
+
+### **1. 修改后更新**
+
+```bash
+# 修改代码后
+git add .
+git commit --amend  # 重要：必须使用 --amend 保留 Change-Id
+
+# 重新推送（会自动更新原有代码审查）
+git push origin HEAD:refs/for/master
+```
+
+### **2. 基于评审意见修改**
+
+```bash
+# 查看评审意见后修改
+git fetch origin refs/changes/XX/YYYY/Z && git checkout FETCH_HEAD
+# 或者
+git review -d 12345  # 如果安装了 git-review
+
+# 修改代码
+git add .
+git commit --amend
+
+# 重新推送
+git push origin HEAD:refs/for/master
+```
+
+### **3. 创建新的 Patch Set**
+
+```bash
+# 每次 git commit --amend 后推送都会创建新的 Patch Set
+git log --oneline -1  # 确认 Change-Id 存在
+git push origin HEAD:refs/for/master
+```
+
+## **六、解决常见问题**
+
+### **问题1：缺少 Change-Id**
+
+```bash
+# 安装 commit-msg 钩子
+curl -Lo .git/hooks/commit-msg http://gerrit:8080/tools/hooks/commit-msg
+chmod +x .git/hooks/commit-msg
+
+# 为现有提交添加 Change-Id
+git commit --amend --no-edit  # 重新提交，钩子会自动添加
+
+# 或者手动添加
+git commit --amend -m "原提交信息
+
+Change-Id: I旧的ChangeId"  # 从 Gerrit 界面复制
+```
+
+### **问题2：权限拒绝**
+
+```bash
+# 检查 SSH 配置
+ssh -p 29418 username@gerrit-server
+
+# 检查公钥是否添加
+cat ~/.ssh/id_ed25519.pub
+
+# 检查项目权限
+# 联系管理员或查看 Gerrit Web 界面
+```
+
+### **问题3：冲突无法推送**
+
+```bash
+# 拉取最新代码
+git fetch origin
+git rebase origin/master  # 或者 git merge origin/master
+
+# 解决冲突
+git mergetool  # 或手动解决
+git add .
+git rebase --continue  # 如果使用 rebase
+
+# 重新推送
+git push origin HEAD:refs/for/master
+```
+
+### **问题4：错误的分支目标**
+
+```bash
+# 查看当前分支
+git branch -a
+
+# 查看远程分支
+git branch -r
+
+# 推送到正确的分支
+git push origin HEAD:refs/for/正确的分支名
+```
+
+## **七、高级操作**
+
+### **1. 提交多个相关修改**
+
+```bash
+# 创建多个提交
+git add file1
+git commit -m "修改1: 功能A"
+git add file2
+git commit -m "修改2: 功能B"
+
+# 推送到同一个 Topic
+git push origin HEAD~2:refs/for/master%topic=feature/xxx
+```
+
+### **2. 依赖链提交**
+
+```bash
+# 第一个提交
+git commit -m "基础修改"
+
+# 第二个提交依赖第一个
+git commit -m "依赖修改"
+
+# 推送到 Gerrit 时保持依赖关系
+git push origin HEAD~1:refs/for/master
+git push origin HEAD:refs/for/master%depends=第一个提交的Change-Id
+```
+
+### **3. 使用 git-review 工具**
+
+```bash
+# 安装
+pip install git-review
+
+# 初始化
+git review -s
+
+# 提交代码审查
+git review
+
+# 下载代码审查
+git review -d 12345  # Change-Number
+```
+
+## **八、Gerrit Web 界面操作**
+
+### **1. 查看代码审查**
+
+- 访问：`http://gerrit:8080`
+- 登录 → Dashboard → 查看你的代码审查
+- 点击 Change-Number 进入详情
+
+### **2. 评审操作**
+
+- **+1 / -1**：代码风格、建议性意见
+- **+2 / -2**：代码评审通过/拒绝（需要权限）
+- **Submit**：合并代码（需要权限）
+- **Abandon**：放弃代码审查
+- **Rebase**：重新基于最新代码
+- **Cherry Pick**：应用到其他分支
+
+### **3. 查看差异**
+
+- **Side-by-Side**：并排对比
+- **Unified Diff**：统一差异
+- **Patch Set**：切换不同版本
+
+## **九、最佳实践**
+
+### **1. 提交信息规范**
+
+```
+一句话摘要（50字以内）
+
+详细描述：
+• 做了什么修改
+• 为什么修改
+• 如何测试
+• 可能的影响
+
+Bug: BUG-12345
+Feature: FEAT-6789
+Test: 通过单元测试/集成测试
+
+Change-Id: I自动生成
+```
+
+### **2. 代码审查前自查**
+
+```bash
+# 1. 运行代码检查
+git diff --check  # 检查空白字符
+
+# 2. 运行测试
+npm test  # 或 mvn test, pytest 等
+
+# 3. 检查提交信息
+git log --oneline -1
+
+# 4. 确保 Change-Id 存在
+git log -1 | grep Change-Id
+```
+
+### **3. 每日工作流程**
+
+```bash
+# 早上
+git fetch origin
+git rebase origin/master  # 更新本地代码
+
+# 开发中
+git add .
+git commit -m "..."
+
+# 推送前
+git pull --rebase origin master  # 再次更新
+解决冲突（如果有）
+git push origin HEAD:refs/for/master
+
+# 查看 Gerrit 反馈
+# 根据评审意见修改
+```
+
+## **十、常用命令速查**
+
+```bash
+# 初始化
+git clone ssh://user@gerrit:29418/project
+scp -p -P 29418 user@gerrit:hooks/commit-msg .git/hooks/
+
+# 日常开发
+git checkout -b feature/xxx
+git add .
+git commit -m "..."
+git push origin HEAD:refs/for/master
+
+# 更新
+git commit --amend
+git push origin HEAD:refs/for/master
+
+# 查看
+git log --oneline -5
+git status
+git diff
+
+# 解决冲突
+git fetch origin
+git rebase origin/master
+解决冲突 → git add → git rebase --continue
+```
+
+## **十一、故障排除**
+
+| 问题            | 解决方案              |
+| ------------- | ----------------- |
+| 403 Forbidden | 检查 SSH 密钥/HTTP 密码 |
+| 缺少 Change-Id  | 安装 commit-msg 钩子  |
+| 分支不存在         | 先创建分支或确认分支名       |
+| 冲突无法推送        | rebase 解决冲突       |
+| 权限不足          | 联系管理员添加权限         |
+| 推送被拒绝         | 检查目标分支是否正确        |
+
+## **十二、快速参考卡片**
+
+```
+✅ 正确流程：
+1. git clone
+2. 安装 commit-msg 钩子
+3. git checkout -b feature/xxx
+4. 开发并提交
+5. git push origin HEAD:refs/for/目标分支
+
+✅ 更新流程：
+1. git commit --amend  # 必须！
+2. git push origin HEAD:refs/for/目标分支
+
+✅ 关键要点：
+• 每次提交都必须有 Change-Id
+• 更新必须用 --amend
+• 只能推送到 refs/for/
+• 在 Gerrit Web 界面查看结果
+```
+
+
diff --git a/docs/开发指南/开发规范.md b/docs/开发指南/开发规范.md
index 1b78ad6..fca2fdd 100644
--- a/docs/开发指南/开发规范.md
+++ b/docs/开发指南/开发规范.md
@@ -13,13 +13,13 @@
 
 使用三个反引号包裹代码，并指定语言：
 
-````markdown
+```markdown
 ```python
 def hello():
     print("Hello, World!")
 ```
-````
 
+```
 ### 链接
 
 - 内部链接：使用相对路径
@@ -53,6 +53,7 @@ def hello():
 ### 文档头部
 
 每个文档应包含：
+
 - 标题（H1）
 - 简要描述
 - 目录（可选，用于长文档）
@@ -101,4 +102,3 @@ def hello():
 - 2024-01-01: 初始版本
 - 2024-01-15: 添加新功能说明
 ```
-
diff --git a/docs/开发指南/快速开始.md b/docs/开发指南/快速开始.md
index 2b56a1c..793416b 100644
--- a/docs/开发指南/快速开始.md
+++ b/docs/开发指南/快速开始.md
@@ -26,27 +26,31 @@ docker-compose up -d
 ## 常用命令
 
 ### 启动服务
+
 ```bash
 docker-compose up -d
 ```
 
 ### 停止服务
+
 ```bash
 docker-compose down
 ```
 
 ### 查看日志
+
 ```bash
 docker-compose logs -f
 ```
 
 ### 构建静态站点
+
 ```bash
 docker-compose exec mkdocs mkdocs build
 ```
 
 ### 进入容器
+
 ```bash
 docker exec -it mkdocs sh
 ```
-
diff --git a/docs/开发指南/项目结构.md b/docs/开发指南/项目结构.md
index bc6a9d7..b126a3f 100644
--- a/docs/开发指南/项目结构.md
+++ b/docs/开发指南/项目结构.md
@@ -20,6 +20,7 @@ mkdocs/
 ### mkdocs.yml
 
 MkDocs 的主配置文件，包含：
+
 - 站点信息（名称、描述、作者等）
 - 主题配置
 - 插件配置
@@ -29,6 +30,7 @@ MkDocs 的主配置文件，包含：
 ### docker-compose.yml
 
 Docker Compose 配置文件，定义：
+
 - 使用的镜像
 - 端口映射
 - 数据卷挂载
@@ -41,4 +43,3 @@ Docker Compose 配置文件，定义：
 2. **命名规范**: 使用有意义的文件名
 3. **导航清晰**: 在 `mkdocs.yml` 中维护清晰的导航结构
 4. **版本控制**: 建议使用 Git 管理文档
-
diff --git a/docs/技术文档/架构设计.md b/docs/技术文档/架构设计.md
index f1cd0fd..85d4867 100644
--- a/docs/技术文档/架构设计.md
+++ b/docs/技术文档/架构设计.md
@@ -56,4 +56,3 @@
 ## 数据持久化
 
 所有服务的数据都存储在 Docker 卷中，确保数据持久化。
-
diff --git a/docs/技术文档/部署文档.md b/docs/技术文档/部署文档.md
index a01c53c..17e1e73 100644
--- a/docs/技术文档/部署文档.md
+++ b/docs/技术文档/部署文档.md
@@ -158,4 +158,3 @@ sudo chown -R $USER:$USER /home/renjianbo/devops/*/data
 ```bash
 docker logs <容器名>
 ```
-
diff --git a/mkdocs.yml b/mkdocs.yml
index 5988647..946394d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -60,6 +60,8 @@ nav:
     - 学习笔记/Java学习.md
     - 学习笔记/前端学习.md
     - 学习笔记/DevOps学习.md
+    - 学习笔记/gerrit上传代码详细指南.md
+    - 学习笔记/MkDocs 是什么.md
 
 # Markdown扩展
 markdown_extensions:
diff --git a/使用说明.md b/使用说明.md
index 412b697..ae865af 100644
--- a/使用说明.md
+++ b/使用说明.md
@@ -21,11 +21,13 @@
 ### 方式一：在服务器上直接编辑（推荐用于快速修改）
 
 1. **SSH 连接到服务器**
+   
    ```bash
    ssh renjianbo@101.43.95.130
    ```
 
 2. **编辑文档文件**
+   
    ```bash
    # 使用 vim 编辑
    vim /home/renjianbo/devops/mkdocs/docs/index.md
@@ -35,16 +37,19 @@
    ```
 
 3. **保存文件后，MkDocs 会自动重新加载**（开发模式）
+   
    - 无需重启服务
    - 浏览器刷新即可看到更新
 
 ### 方式二：本地开发后上传（推荐用于大量编辑）
 
 1. **在本地电脑上编辑**
+   
    - 使用你喜欢的编辑器（VS Code、Typora、MarkText 等）
    - 编辑 `docs/` 目录下的 Markdown 文件
 
 2. **上传到服务器**
+   
    ```bash
    # 使用 scp 上传
    scp -r docs/ renjianbo@101.43.95.130:/home/renjianbo/devops/mkdocs/
@@ -58,6 +63,7 @@
 ### 方式三：使用 Git 管理（推荐用于团队协作）
 
 1. **在本地编辑并提交到 Git**
+   
    ```bash
    cd /home/renjianbo/devops/mkdocs
    git add .
@@ -66,6 +72,7 @@
    ```
 
 2. **在服务器上拉取更新**
+   
    ```bash
    ssh renjianbo@101.43.95.130
    cd /home/renjianbo/devops/mkdocs
@@ -100,12 +107,14 @@ docs/
 ### 添加新文档
 
 1. **创建 Markdown 文件**
+   
    ```bash
    # 例如：添加新的学习笔记
    touch /home/renjianbo/devops/mkdocs/docs/学习笔记/新主题.md
    ```
 
 2. **编辑文件内容**
+   
    ```markdown
    # 新主题
    
@@ -113,6 +122,7 @@ docs/
    ```
 
 3. **在 mkdocs.yml 中添加导航**
+   
    ```yaml
    nav:
      - 学习笔记:
@@ -126,11 +136,13 @@ docs/
 ## 🛠️ 常用编辑命令
 
 ### 查看现有文档
+
 ```bash
 ls -la /home/renjianbo/devops/mkdocs/docs/
 ```
 
 ### 编辑文档
+
 ```bash
 # 使用 vim
 vim /home/renjianbo/devops/mkdocs/docs/index.md
@@ -140,6 +152,7 @@ nano /home/renjianbo/devops/mkdocs/docs/index.md
 ```
 
 ### 创建新文档
+
 ```bash
 # 创建新文件
 touch /home/renjianbo/devops/mkdocs/docs/新文档.md
@@ -149,6 +162,7 @@ nano /home/renjianbo/devops/mkdocs/docs/新文档.md
 ```
 
 ### 查看 MkDocs 日志（确认更新）
+
 ```bash
 docker logs -f mkdocs
 ```
@@ -158,6 +172,7 @@ docker logs -f mkdocs
 ### 1. 使用本地编辑器（推荐）
 
 在本地使用专业的 Markdown 编辑器：
+
 - **VS Code** + Markdown 插件
 - **Typora**（所见即所得）
 - **MarkText**（开源免费）
@@ -165,6 +180,7 @@ docker logs -f mkdocs
 ### 2. 实时预览
 
 MkDocs 开发模式支持自动刷新：
+
 - 编辑文件并保存
 - 浏览器会自动刷新显示最新内容
 - 无需手动重启服务
@@ -172,6 +188,7 @@ MkDocs 开发模式支持自动刷新：
 ### 3. 文件同步
 
 如果需要在多台电脑上编辑：
+
 - 使用 Git 管理文档
 - 或使用 rsync/scp 同步文件
 
@@ -180,16 +197,20 @@ MkDocs 开发模式支持自动刷新：
 编辑文件后，可以通过以下方式验证：
 
 1. **查看容器日志**
+   
    ```bash
    docker logs mkdocs | tail -20
    ```
+   
    应该看到类似信息：
+   
    ```
    INFO    -  Documentation built in 1.32 seconds
    INFO    -  [时间] Serving on http://0.0.0.0:8000/
    ```
 
 2. **刷新浏览器**
+   
    - 访问 http://101.43.95.130:8000
    - 按 F5 或 Ctrl+R 刷新
    - 应该看到最新内容
@@ -203,6 +224,7 @@ A: MkDocs 是静态文档生成工具，它读取 Markdown 文件并生成静态
 ### Q: 如果我想在线编辑怎么办？
 
 A: 可以考虑以下方案：
+
 1. **使用 Wiki 系统**（如 Gitea 的 Wiki 功能）
 2. **使用在线 Markdown 编辑器**（如 HackMD、StackEdit）
 3. **使用 Git 工作流**（本地编辑 → Git 提交 → 服务器拉取）
@@ -224,4 +246,3 @@ A: 不需要！MkDocs 开发模式会自动检测文件变化并重新生成网
 ---
 
 **总结：MkDocs 需要编辑 Markdown 文件，不能在前端网站直接编辑。编辑文件后，MkDocs 会自动生成更新的网站。**
-
diff --git a/部署说明.md b/部署说明.md
index edead4b..ce90697 100644
--- a/部署说明.md
+++ b/部署说明.md
@@ -65,26 +65,31 @@ nav:
 ## 🔧 常用命令
 
 ### 启动服务
+
 ```bash
 docker-compose up -d
 ```
 
 ### 停止服务
+
 ```bash
 docker-compose down
 ```
 
 ### 重启服务
+
 ```bash
 docker-compose restart
 ```
 
 ### 查看日志
+
 ```bash
 docker-compose logs -f
 ```
 
 ### 构建静态站点
+
 ```bash
 docker-compose exec mkdocs mkdocs build
 ```
@@ -92,6 +97,7 @@ docker-compose exec mkdocs mkdocs build
 构建后的静态文件会生成在 `site/` 目录。
 
 ### 进入容器
+
 ```bash
 docker exec -it mkdocs sh
 ```
@@ -133,13 +139,13 @@ site_url: http://101.43.95.130:8000/
 
 使用三个反引号包裹代码，并指定语言：
 
-````markdown
+```markdown
 ```python
 def hello():
     print("Hello, World!")
 ```
-````
 
+```
 ### 表格
 
 ```markdown
@@ -209,4 +215,3 @@ chown -R renjianbo:renjianbo /home/renjianbo/devops/mkdocs
 ---
 
 **开始编写你的文档吧！** 📝
-