# docs

**Repository Path**: suxikang/docs

## Basic Information

- **Project Name**: docs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-07
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 技术文档仓库

> 收集和整理 AI/ML 系统性能优化、数据库测试、开发工具和系统配置相关的实用技术指南。

## 📁 文档目录

### MySQL 性能优化

- **[MySQL Sysbench 性能测试指南](./mysql/mysql_sysbench_test.md)**
  - 完整的安装和配置步骤
  - 只读、读写测试流程
  - 一键测试脚本

- **[MySQL 只读性能优化报告 — Round 1](./mysql/reports/mysql_readonly_optimization_report.md)**
  - LTO + O3 + jemalloc 编译优化
  - TPS 提升 +9.20%

- **[MySQL 只读性能优化报告 — Round 2](./mysql/reports/mysql_readonly_optimization_report_round2.md)**
  - AHI=OFF + LRU256 + arena=8 参数调优
  - TPS 累计提升 +11.45%

- **[MySQL 只读性能优化报告 — Round 3](./mysql/reports/mysql_readonly_optimization_report_round3.md)**
  - checksum=none + sort_buffer=8M
  - TPS 累计提升 +13.84%

- **[MySQL 只读性能优化报告 — Round 4](./mysql/reports/mysql_readonly_optimization_report_round4.md)**
  - ARM CRC32C 硬件加速 + 编译选项修正
  - CRC32 开销从 2.7% 降至 0.86%

### 性能优化

- **[Host Bound 优化方法整理：AMD/NVIDIA/AWS 官方方案](./server-cpu-optimization/host_bound_optimization_amd_nvidia_aws.md)**
  - 面向 GPU 训练、推理和分布式场景
  - 判断方式、常见成因和官方优化手段
  - 包含快速决策表和优化顺序建议

- **[CPU/Host 侧优化方法论：GPU 与 NPU 场景通用](./server-cpu-optimization/host_bound_optimization_cases_by_layer.md)**
  - 按 CPU/host 瓶颈链路分层解析
  - 覆盖 GPU、NPU、TPU、XPU 等加速器场景
  - 包含实战案例和提升比例

- **[CPU 架构对比分析](./server-cpu-optimization/cpu_architecture_comparison.md)**

- **[环境信息采集脚本](./server-cpu-optimization/collect_env_info.sh)** + [使用指南](./server-cpu-optimization/collect_env_info_guide.md)

### 开发工具与指南

- **[Claude Code 使用指南](./tool-guides/claude_code_usage_guide.md)**
  - 安装配置（API Key、settings.json）
  - 目录结构详解（基于官方文档）
  - 命令行选项和使用示例
  - 使用技巧和进阶方法

- **[AI Agent 架构指南](./tool-guides/agent_architecture_guide.md)**

- **[Python GC（垃圾回收）机制详解](./tool-guides/python_gc.md)**
  - 引用计数与分代回收原理
  - multiprocessing 场景下的 GC 隔离性
  - 性能影响和优化策略

- **[Git Clone（GitHub SSH）常见坑与解决方案](./tool-guides/git_clone_ssh_troubleshooting.md)**
  - SSH 网络路径问题诊断
  - 临时和永久解决方案
  - 最小验收清单

- **[tmux 使用指南](./tool-guides/tmux_usage_guide.md)**
  - 会话/窗口/面板管理
  - 常用场景（长时间编译、多面板监控、结对编程）
  - macOS 注意事项和快捷键查看

- **[Vim 使用指南](./tool-guides/vim_usage_guide.md)**
  - 四种模式与切换
  - 光标移动、编辑、搜索替换
  - 可视模式、分屏、命令组合规律
  - 推荐配置和常见问题

### 系统配置

- **[Clash (mihomo) Linux 部署指南](./tool-guides/clash_linux_use.md)**
  - ARM64 架构支持（openEuler 22.03）
  - 配置文件说明和订阅设置
  - GeoIP/GeoSite 手动下载方法
  - Web 控制面板配置

- **[Clash Verge Rev Ubuntu 安装指南](./tool-guides/clash_verge_ubuntu.md)**
  - .deb 安装包下载和安装
  - 基础配置和使用说明

- **[Ubuntu 系统设置](./tool-guides/ubuntu_setting.md)**
  - 禁止系统休眠配置
  - 验证和恢复方法

- **[Firecracker 200 沙箱一键启动基准测试](./tool-guides/firecracker_200_sandbox_benchmark.md)**

## 🚀 快速开始

### 克隆仓库

```bash
# SSH 方式（推荐）
git clone git@gitee.com:suxikang/docs.git

# HTTPS 方式
git clone https://gitee.com/suxikang/docs.git
```

### 本地预览

```bash
cd docs

# 使用 VS Code 预览 Markdown
code README.md

# 或使用其他 Markdown 预览工具
```

## 📚 文档规范

本仓库遵循以下文档编写规范：

- 使用编号章节（## 1., ## 2.）便于交叉引用
- 命令示例使用 ```bash 标记
- 包含"常见问题"章节（Q: 格式）
- 提供"快速诊断"或"一键脚本"便于快速应用
- 外部链接使用完整 URL
- 文档间相对链接使用 `./文件名.md` 格式
- 所有参考链接在文末统一列出

## 🛠️ 贡献指南

欢迎提交 Issue 和 Pull Request！

### 文档主题选择

优先收录以下类型的文档：
- ✅ **官方方法整理**（如 AMD/NVIDIA/AWS 官方优化指南）
- ✅ **实战问题解决**（如 Git SSH 连接问题、GeoIP 下载失败）
- ✅ **完整测试流程**（如 Sysbench 一键测试脚本）
- ✅ **系统配置指南**（如 Ubuntu 禁止休眠、代理部署）

避免收录：
- ❌ 纯理论介绍无实战价值的文档
- ❌ 与现有文档重复度高的内容
- ❌ 过于简单可通过官方文档直接获取的信息

### 提交规范

```bash
# 1. Fork 本仓库
# 2. 创建特性分支
git checkout -b feature/your-doc-name

# 3. 提交更改
git add .
git commit -m "docs: 添加文档主题"

# 4. 推送到分支
git push origin feature/your-doc-name

# 5. 创建 Pull Request
```

Commit message 格式：
```
docs: 添加/更新 [文档主题]

- 主要变更点1
- 主要变更点2
```

## 📖 相关资源

- [Claude Code 官方文档](https://code.claude.com/docs)
- [NVIDIA 官方文档](https://docs.nvidia.com/)
- [AMD ROCm 文档](https://rocm.docs.amd.com/)
- [AWS 官方文档](https://docs.aws.amazon.com/)

## 📄 许可证

本项目文档采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可证。

---
**最后更新**: 2026-04-19
**维护者**: [suxikang](https://gitee.com/suxikang)