ezai-go2 1.3.1__tar.gz

ezai_go2-1.3.1/GITHUB_README.md

@@ -0,0 +1,118 @@
+# EZAI-Go2 - 简单易用的AI机器人控制库
+
+[![PyPI version](https://badge.fury.io/py/ezai-go2.svg)](https://badge.fury.io/py/ezai-go2)
+[![Python versions](https://img.shields.io/pypi/pyversions/ezai-go2.svg)](https://pypi.org/project/ezai-go2/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+EZAI-Go2 是一个专为 Go2 机器狗和 AI 应用设计的简化 Python 接口库，让机器人控制和计算机视觉变得简单易用。
+
+## 🚀 快速安装
+
+```bash
+pip install ezai-go2
+```
+
+## 📖 主要功能
+
+- **🤖 Go2 机器狗控制**: 完整的运动控制、状态查询、视频流支持
+- **📷 计算机视觉**: 集成 OpenCV，支持图像处理和显示
+- **🧠 AI 工作流**: 支持 ONNX 和 RKNN 模型推理
+- **🔧 模块化设计**: 支持按需导入，减少依赖冲突
+- **🎓 教育友好**: 适合初学者和 STEM 教育
+
+## 🛠️ 开发者指南
+
+### 项目结构
+```
+go2dog/
+├── ezai/                    # 核心库代码
+├── examples/               # 示例代码
+├── tests/                  # 测试代码
+├── DEVELOPMENT.md          # 详细开发指南
+├── setup.py                # 打包配置
+├── pyproject.toml          # 项目配置
+└── upload.py               # 发布脚本
+```
+
+### 快速开始
+
+1. **克隆项目**：
+```bash
+git clone https://github.com/nmww/go2dog.git
+cd go2dog
+```
+
+2. **安装开发依赖**：
+```bash
+pip install -e .
+pip install ezai-go2[dev]
+```
+
+3. **配置 PyPI 认证**（发布时需要）：
+   - 在用户主目录创建 `.pypirc` 文件
+   - 添加 PyPI API token（详见 [DEVELOPMENT.md](DEVELOPMENT.md)）
+   - ⚠️ **重要**: `.pypirc` 文件绝对不能提交到 Git！
+
+4. **版本发布**：
+```bash
+# 补丁版本
+python quick_update.py patch
+
+# 次版本
+python quick_update.py minor
+
+# 主版本
+python quick_update.py major
+```
+
+### 基本使用示例
+
+```python
+from ezai import Go2, Camera, OpenCVUI
+
+# Go2 机器狗控制
+dog = Go2()
+if dog.connect():
+    dog.move(0.5, 0, 0)  # 前进
+    time.sleep(2)
+    dog.move(0, 0, 0)    # 停止
+    dog.disconnect()
+
+# 摄像头和 UI
+camera = Camera()
+ui = OpenCVUI()
+image = camera.capture()
+if image:
+    ui.show_image("Camera", image)
+    ui.waitKey(0)
+```
+
+## 📚 文档
+
+- **[DEVELOPMENT.md](DEVELOPMENT.md)** - 详细开发指南
+- **[README.md](README.md)** - PyPI 展示文档
+- **[examples/](examples/)** - 示例代码
+
+## 🤝 贡献
+
+1. Fork 项目
+2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 📄 许可证
+
+本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
+
+## 📞 联系方式
+
+- 邮箱: macnote@qq.com
+- PyPI: https://pypi.org/project/ezai-go2/
+- GitHub: https://github.com/nmww/go2dog
+
+---
+
+⚠️ **开发者注意**: 
+- 请勿将 `.pypirc` 文件提交到版本控制
+- 发布前请阅读 [DEVELOPMENT.md](DEVELOPMENT.md) 了解详细流程

ezai_go2-1.3.1/GIT_STRATEGY.md

@@ -0,0 +1,236 @@
+# EZAI-Go2 Git 提交策略
+
+## 🎯 提交原则
+
+### 应该提交的文件
+- ✅ **源代码**: `ezai/*.py`
+- ✅ **示例代码**: `examples/*.py`
+- ✅ **测试代码**: `tests/*.py`
+- ✅ **配置文件**: `setup.py`, `pyproject.toml`, `requirements.txt`
+- ✅ **文档文件**: `README.md`, `DEVELOPMENT.md`, `GITHUB_README.md`
+- ✅ **许可证**: `LICENSE`
+- ✅ **打包清单**: `MANIFEST.in`
+- ✅ **版本管理脚本**: `update_version.py`, `quick_update.py`
+- ✅ **发布脚本**: `upload.py`
+
+### 绝对不能提交的文件
+- ❌ **打包产物**: `dist/`, `*.egg-info/`, `build/`
+- ❌ **敏感配置**: `.pypirc`, `.env`, API keys
+- ❌ **缓存文件**: `__pycache__/`, `*.pyc`
+- ❌ **IDE 配置**: `.vscode/`, `.idea/`
+- ❌ **虚拟环境**: `venv/`, `env/`
+- ❌ **模型文件**: `*.onnx`, `*.h5`, `*.pth`
+- ❌ **数据文件**: `data/`, `datasets/`
+- ❌ **日志文件**: `*.log`
+
+## 📝 .gitignore 策略
+
+### 核心排除项
+```gitignore
+# 打包产物（最重要）
+dist/
+*.egg-info/
+build/
+*.egg
+
+# 敏感配置
+.pypirc
+.env
+
+# Python 缓存
+__pycache__/
+*.pyc
+```
+
+### 开发环境排除
+```gitignore
+# 虚拟环境
+venv/
+env/
+
+# IDE 配置
+.vscode/
+.idea/
+
+# 测试覆盖率
+.coverage
+.pytest_cache/
+```
+
+## 🔄 分支策略
+
+### 主要分支
+- **main**: 稳定发布版本
+- **develop**: 开发分支（可选）
+
+### 功能分支
+- **feature/功能名**: 新功能开发
+- **fix/问题描述**: Bug 修复
+- **docs/文档更新**: 文档更新
+- **release/版本号**: 发布准备
+
+### 分支命名规范
+```bash
+feature/video-stream-enhancement
+fix/go2-connection-issue
+docs/update-installation-guide
+release/v1.1.0
+```
+
+## 📋 提交信息规范
+
+### 格式
+```
+<类型>(<范围>): <描述>
+
+[可选的详细描述]
+
+[可选的关闭问题]
+```
+
+### 类型说明
+- **feat**: 新功能
+- **fix**: Bug 修复
+- **docs**: 文档更新
+- **style**: 代码格式化
+- **refactor**: 代码重构
+- **test**: 测试相关
+- **chore**: 构建过程或辅助工具的变动
+- **release**: 版本发布
+
+### 示例
+```bash
+feat(go2): add video stream error handling
+fix(camera): resolve image capture timeout issue
+docs(readme): update installation instructions
+style(ezai): apply black formatting
+refactor(ui): simplify widget creation logic
+test(go2): add connection test cases
+chore(deps): update numpy version constraint
+release(v1.0.9): patch release with documentation updates
+```
+
+## 🚀 发布流程
+
+### 1. 开发阶段
+```bash
+# 创建功能分支
+git checkout -b feature/new-function
+
+# 开发和提交
+git add .
+git commit -m "feat(module): add new function"
+git push origin feature/new-function
+```
+
+### 2. 发布准备
+```bash
+# 切换到主分支
+git checkout main
+git pull origin main
+
+# 合并功能分支
+git merge feature/new-function
+
+# 更新版本（使用脚本）
+python quick_update.py patch
+
+# 提交版本更新
+git add .
+git commit -m "release(v1.0.10): patch release"
+```
+
+### 3. 发布后
+```bash
+# 推送主分支
+git push origin main
+
+# 创建标签
+git tag -a v1.0.10 -m "Release version 1.0.10"
+git push origin v1.0.10
+
+# 删除功能分支
+git branch -d feature/new-function
+git push origin --delete feature/new-function
+```
+
+## 🔍 代码审查检查点
+
+### 提交前检查
+- [ ] 代码格式化 (`black ezai/`)
+- [ ] 代码检查 (`flake8 ezai/`)
+- [ ] 测试通过 (`pytest tests/`)
+- [ ] 文档更新
+- [ ] 版本号更新（如需要）
+- [ ] 无敏感信息泄露
+
+### 提交信息检查
+- [ ] 类型正确
+- [ ] 范围明确
+- [ ] 描述清晰
+- [ ] 关联问题（如有）
+
+## 📊 仓库大小优化
+
+### 定期清理
+```bash
+# 清理 Git 历史（谨慎使用）
+git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch large-file.onnx' --prune-empty --tag-name-filter cat -- --all
+
+# 清理未跟踪文件
+git clean -fd
+```
+
+### 大文件处理
+- 模型文件使用 Git LFS
+- 数据文件放在外部存储
+- 避免提交二进制文件
+
+## 🛡️ 安全最佳实践
+
+### 敏感信息保护
+- `.pypirc` 永远不提交
+- API token 使用环境变量
+- 密钥使用配置文件模板
+
+### 代码审查
+- 所有提交需要代码审查
+- 检查硬编码的敏感信息
+- 验证依赖安全性
+
+## 📋 常见问题
+
+### Q: 如何处理已提交的大文件？
+```bash
+# 查找大文件
+git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sed -n 's/^blob //p' | sort --numeric-sort --key=2 | tail -10
+
+# 从历史中移除
+git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch large-file' --prune-empty --tag-name-filter cat -- --all
+```
+
+### Q: 如何恢复误删的文件？
+```bash
+# 从暂存区恢复
+git restore --staged file.txt
+
+# 从提交历史恢复
+git checkout HEAD~1 -- file.txt
+```
+
+### Q: 如何撤销提交？
+```bash
+# 撤销最后一次提交（保留修改）
+git reset --soft HEAD~1
+
+# 撤销最后一次提交（丢弃修改）
+git reset --hard HEAD~1
+```
+
+---
+
+⚠️ **重要提醒**:
+- 提交前务必检查 `.gitignore` 配置
+- 绝对不要提交 `dist/` 和 `*.egg-info/` 目录
+- 使用语义化提交信息
+- 定期清理仓库，保持精简

ezai_go2-1.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 EZAI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ezai_go2-1.3.1/MANIFEST.in

@@ -0,0 +1,27 @@
+# EZAI-Go2 Package Manifest
+
+# Include core files
+include README.md
+include LICENSE
+include requirements.txt
+include MANIFEST.in
+
+# Include examples
+recursive-include examples *.py
+
+# Include tests
+recursive-include tests *.py
+
+# Exclude development and unnecessary files
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude __pycache__
+global-exclude .git*
+global-exclude .DS_Store
+global-exclude *.so
+global-exclude .pypirc
+global-exclude upload.py
+global-exclude update_version.py
+global-exclude quick_update.py
+global-exclude DEVELOPMENT.md

ezai_go2-1.3.1/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.1
+Name: ezai-go2
+Version: 1.3.1
+Summary: Easy AI Robot Control Library for Go2 and Computer Vision
+Home-page: https://github.com/ezai-team/ezai
+Author: EZAI Team
+Author-email: EZAI Team <contact@ezai.com>
+Maintainer-email: EZAI Team <contact@ezai.com>
+License: MIT License
+        
+        Copyright (c) 2024 EZAI Team
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/nmww/go2dog
+Project-URL: Documentation, https://github.com/nmww/go2dog/blob/main/DEVELOPMENT.md
+Project-URL: Repository, https://github.com/nmww/go2dog.git
+Project-URL: Bug Tracker, https://github.com/nmww/go2dog/issues
+Keywords: robotics,ai,computer-vision,go2,unitree,machine-learning,education
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: core
+Requires-Dist: numpy<=1.24.3,>=1.19.0; extra == "core"
+Requires-Dist: pillow>=8.0.0; extra == "core"
+Requires-Dist: netifaces>=0.10.0; extra == "core"
+Requires-Dist: typing-extensions<5.0.0,>=3.6.6; extra == "core"
+Provides-Extra: opencv
+Requires-Dist: opencv-python>=4.5.0; extra == "opencv"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.8; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Requires-Dist: build>=0.7.0; extra == "dev"
+Provides-Extra: onnx
+Requires-Dist: onnx>=1.12.0; extra == "onnx"
+Requires-Dist: onnxruntime>=1.12.0; extra == "onnx"
+Provides-Extra: rknn
+Requires-Dist: rknn-toolkit2>=1.5.0; extra == "rknn"
+Provides-Extra: all
+Requires-Dist: numpy<=1.24.3,>=1.19.0; extra == "all"
+Requires-Dist: pillow>=8.0.0; extra == "all"
+Requires-Dist: netifaces>=0.10.0; extra == "all"
+Requires-Dist: typing-extensions<5.0.0,>=3.6.6; extra == "all"
+Requires-Dist: opencv-python>=4.5.0; extra == "all"
+Requires-Dist: onnx>=1.12.0; extra == "all"
+Requires-Dist: onnxruntime>=1.12.0; extra == "all"
+Requires-Dist: rknn-toolkit2>=1.5.0; extra == "all"
+
+# EZAI - 简单易用的AI机器人控制库
+
+[![PyPI version](https://badge.fury.io/py/ezai-go2.svg)](https://badge.fury.io/py/ezai-go2)
+[![Python versions](https://img.shields.io/pypi/pyversions/ezai-go2.svg)](https://pypi.org/project/ezai-go2/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+EZAI是一个专为Go2机器狗和AI应用设计的简化Python接口库，让机器人控制和计算机视觉变得简单易用。
+
+## 🚀 特性
+
+- **简单易用**: 专为初学者设计的API接口
+- **模块化设计**: 支持按需导入，减少依赖
+- **Go2机器狗控制**: 完整的运动控制和视频流支持
+- **计算机视觉**: 集成OpenCV，支持图像处理和显示
+- **AI工作流**: 支持ONNX和RKNN模型推理
+- **教育友好**: 适合STEM教育和编程学习
+
+## 📦 安装
+
+### 基础安装
+```bash
+pip install ezai-go2
+```
+
+### 完整安装（包含所有可选依赖）
+```bash
+pip install ezai-go2[all]
+```
+
+### 仅安装ONNX支持
+```bash
+pip install ezai-go2[onnx]
+```
+
+### 仅安装RKNN支持
+```bash
+pip install ezai-go2[rknn]
+```
+
+## 🔧 Go2 SDK安装
+
+要使用Go2机器狗控制功能，需要额外安装unitree-sdk2py：
+
+```bash
+# 从官方源码安装
+git clone https://github.com/unitreerobotics/unitree_sdk2_python.git
+cd unitree_sdk2_python
+pip install -e .
+```
+
+## 📖 快速开始
+
+### Go2机器狗控制
+
+```python
+from ezai import Go2
+
+# 创建Go2控制器
+dog = Go2()
+
+# 连接机器狗
+if dog.connect():
+    # 前进
+    dog.move(0.5, 0, 0)  # vx=0.5, vy=0, vyaw=0
+    time.sleep(2)
+    
+    # 停止
+    dog.move(0, 0, 0)
+    
+    # 断开连接
+    dog.disconnect()
+```
+
+### 计算机视觉
+
+```python
+from ezai import Camera, OpenCVUI
+
+# 创建摄像头
+camera = Camera()
+ui = OpenCVUI()
+
+# 捕获图像
+image = camera.capture()
+if image is not None:
+    # 显示图像
+    ui.show_image("Camera", image)
+    ui.waitKey(0)
+```
+
+### AI推理（ONNX）
+
+```python
+from ezai import ONNXWorkflow
+
+# 创建ONNX工作流
+workflow = ONNXWorkflow("model.onnx")
+
+# 加载图像
+image = cv2.imread("test.jpg")
+
+# 运行推理
+result = workflow.run(image)
+print(f"推理结果: {result}")
+```
+
+## 📚 模块说明
+
+### Go2模块
+- `Go2`: Go2机器狗主控制类
+- 支持运动控制、状态查询、视频流等
+- 自动网络接口检测和IP配置
+
+### Camera模块
+- `Camera`: 摄像头控制类
+- 支持USB摄像头和网络摄像头
+- 简化的图像捕获接口
+
+### UI模块
+- `OpenCVUI`: OpenCV显示界面类
+- 简化的图像显示和交互接口
+- 支持窗口管理和事件处理
+
+### AI工作流模块
+- `ONNXWorkflow`: ONNX模型推理
+- `RKNNWorkflow`: RKNN模型推理
+- 统一的推理接口设计
+
+## 🛠️ 开发
+
+### 安装开发依赖
+```bash
+pip install ezai-go2[dev]
+```
+
+### 运行测试
+```bash
+pytest tests/
+```
+
+### 代码格式化
+```bash
+black ezai/
+```
+
+## 📋 依赖要求
+
+- Python >= 3.7
+- OpenCV >= 4.5.0
+- NumPy <= 1.24.3
+- Pillow >= 8.0.0
+- netifaces >= 0.10.0
+
+可选依赖：
+- unitree-sdk2py (Go2控制)
+- onnx + onnxruntime (ONNX推理)
+- rknn-toolkit2 (RKNN推理)
+
+## 🤝 贡献
+
+欢迎提交Issue和Pull Request！
+
+## 📄 许可证
+
+本项目采用MIT许可证 - 详见 [LICENSE](LICENSE) 文件
+
+## 📞 联系方式
+
+- 邮箱: macnote@qq.com
+- GitHub: https://github.com/nmww/go2dog
+- 文档: https://github.com/nmww/go2dog/blob/main/DEVELOPMENT.md
+
+## 🙏 致谢
+
+感谢Unitree机器人提供的Go2 SDK支持！