Merge pull request #15 from IthacaDream/chore/support-py310

chore: fix typing problem, supporting python3.10

Author: thirdgerb

.gitignore

@@ -1,6 +1,5 @@
 # ide
 .idea/
-uv.lock
 dist
 debug.log
 .DS_Store
@@ -93,35 +92,6 @@ target/
 profile_default/
 ipython_config.py
 
-# pyenv
-#   For a library or package, you might want to ignore these files since the code is
-#   intended to run in multiple environments; otherwise, check them in:
-# .python-version
-
-# pipenv
-#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
-#   However, in case of collaboration, if having platform-specific dependencies or dependencies
-#   having no cross-platform support, pipenv may install dependencies that don't work, or not
-#   install all needed dependencies.
-#Pipfile.lock
-
-# poetry
-#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
-poetry.lock
-
-uv.lock
-
-# pdm
-#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
-#pdm.lock
-#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
-#   in version control.
-#   https://pdm.fming.dev/#use-with-ide
-.pdm.toml
-
 # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
 __pypackages__/
 
@@ -175,4 +145,5 @@ cython_debug/
 .vscode/
 
 .setup_env
-.uv_cache
+.uv_cache
+.ruff_cache

Makefile

@@ -19,12 +19,12 @@ install-uv: ## Install uv if missing
 
 .PHONY: install-python
 install-python: ## Install Python via uv if missing
-	@echo "==> Ensuring Python 3.12 is available (via uv)"
-	@if uv python find 3.12 >/dev/null 2>&1; then \
-		echo "Python 3.12 already available"; \
+	@echo "==> Ensuring Python 3.10 is available (via uv)"
+	@if uv python find 3.10 >/dev/null 2>&1; then \
+		echo "Python 3.10 already available"; \
 	else \
-		echo "Python 3.12 not found. Installing..."; \
-		uv python install 3.12; \
+		echo "Python 3.10 not found. Installing..."; \
+		uv python install 3.10; \
 	fi
 
 .PHONY: uv-venv
@@ -38,7 +38,7 @@ uv-venv: ## Create project virtualenv with uv if missing
 	fi
 
 .PHONY: install-uv-pyenv
-install-uv-pyenv: install-uv install-python uv-venv ## Install uv, Python 3.12, and venv
+install-uv-pyenv: install-uv install-python uv-venv ## Install uv, Python 3.10, and venv
 
 .PHONY: install-prek
 install-prek: ## Install prek and repo git hooks.
@@ -48,7 +48,7 @@ install-prek: ## Install prek and repo git hooks.
 	@uv tool run prek install
 
 .PHONY: prepare
-prepare: install-uv install-python uv-venv install-prek ## Setup uv, Python 3.12, venv, and prek hooks.
+prepare: install-uv install-python uv-venv install-prek ## Setup uv, Python 3.10, venv, and prek hooks.
 	@echo "==> Syncing dependencies for all workspace packages"
 	@uv sync --dev --all-extras
 

examples/jetarm_ws/src/jetarm_channel/jetarm_channel/face_traking_node.py

@@ -135,7 +135,6 @@ def image_callback(self, ros_image):
             self.image_queue.put(bgr_image)
 
     def main(self):
-
         while self.running:
             bgr_image = self.image_queue.get()
 

examples/jetarm_ws/src/jetarm_channel/jetarm_channel/nodes/pychannel_with_rclpy.py

@@ -62,7 +62,6 @@ def main(args=None):
 
     @main_channel.build.command()
     async def reset_body():
-
         # 发送目标
         joint_names = ["joint1", "joint2", "joint3", "joint4", "joint5", "r_joint"]
         positions = [0.0, 1.0, -1.57, -1.57, 0.2, 0.0]

examples/miku/README.md

@@ -5,28 +5,30 @@ Miku 是一个 live2d 数字人躯体, 用来测试 MOSS 架构对躯体的多
 # 设计思路
 
 - Body（身体：全身运动）
-    - Expression（表情）
-    - Head（头）
-        - Hair（头发）
-        - pigtail_L（左辫子）
-        - pigtail_R（右辫子）
-        - Face（脸）
-            - BROW_L（左眉毛）
-            - BROW_R（右眉毛）
-            - Eye_L（左眼睛）
-            - Eye_R（右眼睛）
-            - Nose（鼻子）
-            - Mouth（嘴巴）
-    - Arm_L（左臂）
-    - Elbow_L（左肘）
-    - Arm_R（右臂）
-    - Elbow_R（右肘）
-    - Tie（领带）
-    - Leg_L（左腿）
-    - Leg_R（右腿）
+  - Expression（表情）
+  - Head（头）
+    - Hair（头发）
+    - pigtail_L（左辫子）
+    - pigtail_R（右辫子）
+    - Face（脸）
+      - BROW_L（左眉毛）
+      - BROW_R（右眉毛）
+      - Eye_L（左眼睛）
+      - Eye_R（右眼睛）
+      - Nose（鼻子）
+      - Mouth（嘴巴）
+  - Arm_L（左臂）
+  - Elbow_L（左肘）
+  - Arm_R（右臂）
+  - Elbow_R（右肘）
+  - Tie（领带）
+  - Leg_L（左腿）
+  - Leg_R（右腿）
 
 # 运行
+
 ## 配置环境变量
+
 在项目根目录下创建 `.workspace/.env` 文件，配置环境变量：
 
 ```bash
@@ -43,7 +45,9 @@ MOSS_LLM_MODEL=your_llm_model_here
 VOLCENGINE_STREAM_TTS_APP=your_volcengine_stream_tts_app_id_here
 VOLCENGINE_STREAM_TTS_ACCESS_TOKEN=your_volcengine_stream_tts_access_token_here
 ```
+
 ## 启动
+
 ```bash
 python main.py
 ```

examples/miku/main.py

@@ -2,7 +2,7 @@
 import sys
 
 import dotenv
-from ghoshell_common.contracts import LocalWorkspaceProvider, Workspace, WorkspaceConfigs
+from ghoshell_common.contracts import LocalWorkspaceProvider
 
 from ghoshell_moss.speech import make_baseline_tts_speech
 from ghoshell_moss.speech.player.pyaudio_player import PyAudioStreamPlayer

examples/minecraft_bot/README.md

@@ -9,6 +9,7 @@ minecraft_bot 示例提供了一个可对话、可交互的 Minecraft 机器人
 ## 功能特性
 
 当前已集成的机器人行为能力包括：
+
 - 🚶‍♂️ **移动控制** - 在游戏世界中自由移动
 - 👥 **跟随玩家** - 自动跟随指定玩家
 - 🔍 **物品查找** - 寻找游戏中的特定物品
@@ -28,33 +29,41 @@ minecraft_bot/
 ```
 
 # 环境准备
+
 ## Minecraft 客户端安装
 
 ### 下载 HMCL 启动器
+
 访问 [HMCL 官网](https://hmcl.huangyuhui.net/download/) 下载启动器。
 
 ### 安装 Minecraft 1.21.8 版本
+
 1. 启动 HMCL 启动器
-2. 点击"安装游戏"
-3. 选择 "Minecraft 1.21.8" 版本
-4. 点击"安装"完成客户端安装
+1. 点击"安装游戏"
+1. 选择 "Minecraft 1.21.8" 版本
+1. 点击"安装"完成客户端安装
 
 ## 安装 Minecraft Server
 
 ### 使用 Docker 启动服务器
+
 ```bash
 cd server
 docker-compose up -d
 ```
+
 第一次启动容器时会自动下载 Minecraft 1.21.8 版本的服务器文件。
 
 ### 检查服务状态
+
 等待服务启动完成，检查端口是否正常监听：
+
 ```bash
 docker-compose logs -f 
 ```
 
 出现以下日志表示服务启动成功：
+
 ```
 [03:30:22] [Server thread/INFO]: Done (5.274s)! For help, type "help"
 [03:30:22] [Server thread/INFO]: Starting remote control listener
@@ -63,23 +72,28 @@ docker-compose logs -f
 ```
 
 ### 配置服务器
+
 服务器启动后，在 `server/data` 目录下会生成配置文件：
+
 - `server.properties` - 服务器主配置文件
 - `whitelist.json` - 白名单配置
 - ...
 
 **重要配置修改：**
 编辑 `server.properties`，将 `online-mode` 设置为 `false`：
+
 ```properties
 online-mode=false
 ```
 
 编辑 `server.properties`，将 `gamemode` 设置为 `creative`（防止被小怪攻击）：
+
 ```properties
 gamemode=creative
 ```
 
 修改后重启容器使配置生效：
+
 ```bash
 docker-compose restart
 ```
@@ -91,9 +105,9 @@ docker-compose restart
 ## 加入服务器
 
 1. **启动 Minecraft 游戏**
-2. **选择"多人游戏"**
-3. **添加服务器**，地址设置为 `127.0.0.1`
-4. **加入服务器**
+1. **选择"多人游戏"**
+1. **添加服务器**，地址设置为 `127.0.0.1`
+1. **加入服务器**
 
 ## 启动机器人
 
@@ -116,9 +130,11 @@ VOLCENGINE_STREAM_TTS_ACCESS_TOKEN=your_volcengine_stream_tts_access_token_here
 ```
 
 在项目根目录下运行以下命令启动机器人：
+
 ```bash
 python main.py [--speech]
 ```
+
 第一次执行会自动安装 Node.js 依赖
 
 机器人将自动连接到服务器并出现在游戏中。默认机器人用户名为 `Jarvis`。
@@ -127,6 +143,7 @@ python main.py [--speech]
 ## 交互方式
 
 机器人启动后，您可以通过游戏内的聊天功能（按t）与机器人交互：
+
 - 发送消息给机器人
 - 使用指令控制机器人行为
 - 机器人会根据 MOSS 架构进行智能响应
@@ -153,23 +170,27 @@ PORT = 25565             # 服务器端口
 ## 常见问题
 
 1. **无法连接服务器**
+
    - 检查 Docker 容器是否正常运行：`docker-compose ps`
    - 确认服务器端口 25565 是否被占用
    - 验证 `online-mode=false` 配置是否正确
 
-2. **机器人无法启动**
+1. **机器人无法启动**
+
    - 检查 Python 和 Node.js 依赖是否安装完整
    - 确认 Minecraft 服务器已启动并运行正常
    - 查看控制台错误日志进行排查
 
-3. **机器人无响应**
+1. **机器人无响应**
+
    - 检查网络连接状态
    - 确认机器人是否成功连接到服务器
    - 验证游戏内聊天功能是否正常
 
 # 技术架构
 
 本项目基于以下技术栈：
+
 - **MOSS 架构** - 提供智能对话和决策能力
 - **Mineflayer** - Minecraft 机器人控制库
 - **Python-JavaScript 桥接** - 实现跨语言调用