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配置只读挂载。
• 使用最小基础镜像。
• 定期进行安全更新。