Enhanced Dev Env

🚀 增強開發環境與MCP服務器

本項目提供了一個全面的開發環境，涵蓋UV包管理器、Open解釋器（開發分支）以及模型上下文協議服務器，能極大提升開發效率。

🚀 快速開始

使用Docker

# 構建並啟動容器
docker-compose up -d

# 進入容器
docker-compose exec dev zsh

# 或使用運行命令
docker-compose run --rm dev

使用Vagrant

# 啟動虛擬機
vagrant up

# 通過SSH進入虛擬機
vagrant ssh

# 銷燬虛擬機
vagrant destroy

✨ 主要特性

• UV包管理器：可實現快速的Python包管理。
• 現代CLI工具：包含exa、bat、ripgrep等實用工具。
• Zsh shell：搭配Oh My Zsh及有用插件。
• 開發工具：如git、vim、tmux等一應俱全。
• 基於Rust的性能工具：助力提升性能。
• Docker和Vagrant配置：方便進行容器和虛擬機管理。
• 優化的Python開發環境：為Python開發提供便利。

📦 安裝指南

本項目可通過Docker或Vagrant進行部署，具體啟動命令見“快速開始”部分。

🛠️ 包含的工具

Python工具

• UV包管理器
• IPython
• Black：代碼格式化工具
• isort：導入排序工具
• mypy：類型檢查工具
• ruff：代碼檢查工具
• pytest：測試框架
• debugpy：調試工具
• pre-commit：預提交鉤子

現代CLI工具

• exa：現代ls替代工具
• bat：現代cat替代工具
• ripgrep：現代grep替代工具
• fd-find：現代find替代工具
• delta：git diff增強工具
• zoxide：智能cd工具
• starship：shell提示工具
• dust：現代du替代工具
• hyperfine：基準測試工具

開發工具

• Git
• Vim
• Tmux
• HTTPx
• Docker
• Docker Compose

💻 使用示例

包管理

# 安裝包
python-install pandas numpy

# 創建虛擬環境
venv-create

# 激活虛擬環境
venv-activate

# 安裝項目依賴
python-deps

開發工作流

# 初始化新項目
uv-init myproject

# 從模板創建項目
uv-scaffold fastapi myapi

# 設置測試
uv-test-setup

# 檢查項目結構
uv-project-check

維護

# 清理UV緩存
uv-clean

# 重建虛擬環境
uv-venv-rebuild

# 檢查系統
uv-doctor

📚 詳細文檔

目錄結構

.
├── Dockerfile           # 容器定義文件
├── docker-compose.yml   # 容器編排文件
├── Vagrantfile         # 虛擬機定義文件
├── .zshrc              # Shell配置文件
├── workspace/          # 你的項目目錄
└── .config/
    └── uv/            # UV配置目錄

自定義配置

添加本地配置

創建~/.zshrc.local用於機器特定設置：

# 本地環境變量
export MY_VAR="value"

# 本地別名
alias myalias="mycommand"

修改UV配置

編輯~/.config/uv/uvconfig.toml：

[cache]
最大容量 = "10GB"
共享 = true

[network]
併發下載數 = 8

故障排除

常見問題

1. 包安裝問題

   uv-clean
   uv-doctor
   

2. 虛擬環境問題

   uv-venv-rebuild
   

3. 性能問題

   bench "your-command"  # 使用hyperfine進行基準測試
   

維護

容器更新

# 無緩存重建容器以獲取更新
docker-compose build --no-cache

# 拉取最新基礎鏡像
docker-compose pull

虛擬機更新

# 更新虛擬機
vagrant provision

# 更新虛擬機鏡像
vagrant box update

🔒 安全注意事項

• 容器以非root用戶運行。
• SSH密鑰只讀掛載。
• Git配置只讀掛載。
• 使用最小基礎鏡像。
• 定期進行安全更新。