Scan to join WeChat grouparticle
README
🚀 增强开发环境与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
故障排除
常见问题
- 包安装问题
uv-clean uv-doctor - 虚拟环境问题
uv-venv-rebuild - 性能问题
bench "your-command" # 使用hyperfine进行基准测试
维护
容器更新
# 无缓存重建容器以获取更新
docker-compose build --no-cache
# 拉取最新基础镜像
docker-compose pull
虚拟机更新
# 更新虚拟机
vagrant provision
# 更新虚拟机镜像
vagrant box update
🔒 安全注意事项
- 容器以非root用户运行。
- SSH密钥只读挂载。
- Git配置只读挂载。
- 使用最小基础镜像。
- 定期进行安全更新。