# 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-29

## 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%

- **[MySQL 远程只读优化报告 v3（最新）](./mysql/reports/mysql-8u32g-remote-readonly-optimization-v3/final/mysql_8u32g_remote_readonly_optimization_report_v3.md)**

### 沙箱技术

> 完整导航见 [sandbox/README.md](./sandbox/README.md)

**背景与洞察**

- **[沙箱技术产业洞察报告](./sandbox/sandbox_insight.md)**
  - 沙箱定义、技术分类（microVM/容器/内核级）、厂商对比
- **[沙箱性能指标调研](./sandbox/sandbox_performance_metrics_research.md)**
  - 生命周期延迟、并发密度、隔离开销等 7 组关键指标体系
- **[沙箱场景下的超分复用技术调研](./sandbox/sandbox_cpu_oversubscription.md)**
  - CPU/内存 overcommit 原理与风险、行业比例、调度策略
- **[互联网厂商 Agent CPU 动态洞察](./sandbox/internet-agent-cpu-insight-2026-04-23.md)**
  - Agent Runtime + Sandbox + Context DB + Tool Gateway 架构趋势

**技术架构**

- **[Firecracker 微虚拟机架构 4+1 视图详解](./sandbox/firecracker_4plus1_architecture.md)**
  - 进程模型、设备模型、API Server、安全模型、KVM 交互
- **[E2B 沙箱平台架构 4+1 视图详解](./sandbox/e2b_4plus1_architecture.md)**
  - SDK → Orchestrator → Envd → FC 层级关系

**实测对比（同一鲲鹏 920 平台）**

- **[Firecracker 性能测试报告](./sandbox/firecracker_test_report.md)**
  - v1.9.0 裸性能，单实例冷启动 ~125ms
- **[E2B 编排层性能测试报告](./sandbox/e2b_test_report.md)**
  - 编排开销 ~15ms（HTTP 解析 + 进程管理）
- **[Docker 沙箱性能测试报告](./sandbox/docker_sandbox_test_report.md)**
  - 容器启动 0.3-0.8s，作为对比基线

**专项调研**

- **[Kata Containers 沙箱调研](./sandbox/kata_sandbox_research.md)** — VM 级安全容器运行时
- **[Conch 沙箱引擎调研](./sandbox/conch_sandbox_research.md)** — openEuler 面向 AI Agent 的沙箱引擎
- **[Conch 测试用例与 Benchmark 调研](./sandbox/conch_testcase.md)** — 行业启动性能数据汇总
- **[Eino 与 VeADK 调研报告](./sandbox/eino_veadk_research_report.md)** — 字节跳动 Eino + 火山引擎 VeADK
- **[AWS AgentCore 沙箱洞察](./sandbox/aws-agentcore-sandbox-insight-report-2026-04-24.md)** — AWS 沙箱到有状态 Agent 工作空间的演进

**论文复刻**

- **[AgentCgroup 论文阅读笔记](./sandbox/agentcgroup-paper-summary-cn.md)** — AI Agent 的 OS 资源控制
- **[观测实验部署指导](./sandbox/agentcgroup-observation-deployment-guide-cn.md)** — CPU/内存数据采集
- **[完整实验部署指导](./sandbox/agentcgroup-experiment-deployment-guide-cn.md)** — 含内核级 enforcement

**核心子项目**

- **[鲲鹏 920 Firecracker 沙箱性能测试](./sandbox/kunpeng-ai-agent/)** — 系统化测试套件（TC-001 ~ TC-004），详见子项目 [README](./sandbox/kunpeng-ai-agent/README.md)

### 性能优化

- **[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)**
  - Intel / AMD / 鲲鹏 / 海光 / NVIDIA Grace / 平头哥玄铁（RISC-V）

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

### AI 工具

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

- **[cc-connect 配置指南](./tool-guides/cc-connect.md)**
  - Claude Code + Codex 对接飞书（WebSocket 架构）
  - 双 Bot 配置、Webhook 设置、常见问题

- **[OpenAI Codex CLI 使用指南](./tool-guides/codex_cli_guide.md)**
  - 安装、沙箱模式、模型选择、权限配置

- **[AI Agent 架构指南](./tool-guides/agent_architecture_guide.md)**
  - Agent 从能力定义到灰度放量的完整开发链路

- **[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)**
  - 四种模式与切换
  - 光标移动、编辑、搜索替换
  - 可视模式、分屏、命令组合规律
  - 推荐配置和常见问题

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

- **[MySQL Docker 容器备份与重启指南](./tool-guides/docker_backup.md)**
  - 容器备份、端口映射、perf 采集权限配置

### 系统配置

- **[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)**
  - 禁止系统休眠配置
  - 验证和恢复方法

## 快速开始

### 克隆仓库

```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-05-03
**维护者**: [suxikang](https://gitee.com/suxikang)