fix: resolve pre-commit linting issues

- Fix MyPy unreachable code errors in preload_sharp_model.py
- Apply automatic formatting fixes (black, trailing-whitespace, end-of-file-fixer)
- Fix markdownlint fenced code block language tags

Author: TRIP(appergb)

.github/workflows/release.yml

@@ -28,4 +28,3 @@ jobs:
 
     - name: Verify build
       run: ls -la dist/
-

README.md

@@ -81,11 +81,13 @@ python3 scripts/pointcloud_voxelizer.py input.ply --visualize
 ## Troubleshooting
 
 1. **Python version error**
+
    ```bash
    python3 --version  # Ensure >= 3.9
    ```
 
 2. **Dependency installation failure**
+
    ```bash
    pip install torch --index-url https://download.pytorch.org/whl/cpu
    ```
@@ -95,6 +97,7 @@ python3 scripts/pointcloud_voxelizer.py input.ply --visualize
    - Use `--voxel-size 0.02` for lower precision
 
 4. **GPU unavailable**
+
    ```bash
    python3 scripts/preload_sharp_model.py --device cpu
    ```
@@ -119,9 +122,9 @@ A.YLM/
 
 Issues and pull requests are welcome.
 
-**Developer**: TRIP (appergb)  
+**Developer**: TRIP (appergb)
 **Contributors**: closer, true
 
 ## License
 
-This project is licensed under the MIT License.
+This project is licensed under the MIT License.

scripts/pointcloud_voxelizer.py

@@ -275,9 +275,7 @@ def detect_and_correct_ground_plane_enhanced(
 
             [a, b, c, d] = best_plane_model
             inlier_ratio = (
-                len(best_inliers) / len(pcd.points)
-                if best_inliers is not None
-                else 0.0
+                len(best_inliers) / len(pcd.points) if best_inliers is not None else 0.0
             )
 
             # 2. 地面质量评估
@@ -1689,4 +1687,3 @@ def main():
 
 if __name__ == "__main__":
     main()
-

scripts/preload_sharp_model.py

@@ -31,6 +31,13 @@
 from pathlib import Path
 from typing import Any, Dict, Optional, cast
 
+try:
+    from sharp.models import RGBGaussianPredictor
+
+    ModelType = Optional[RGBGaussianPredictor]
+except ImportError:
+    ModelType = Any
+
 # 添加项目路径
 project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 if project_root not in sys.path:
@@ -70,7 +77,7 @@ def __init__(self, checkpoint_path: Optional[str] = None, device: str = "auto"):
             "SHARP_MODEL_PATH", "models/sharp_2572gikvuh.pt"
         )
         self.device = self._get_device(device)
-        self.model = None
+        self.model: ModelType = None
         self.loaded = False
         self.load_time = 0.0
         self.metadata_file: Optional[str] = None
@@ -142,17 +149,14 @@ def preload_model(self) -> bool:
 
             # 创建和初始化模型
             self.model = create_predictor(PredictorParams())
-            if self.model is not None:
-                self.model.load_state_dict(state_dict)
-                self.model.eval()
-                self.model.to(self.device)
-
-                self.logger.info(f"   模型类型: {type(self.model).__name__}")
-                self.logger.info(
-                    f"   模型参数量: {sum(p.numel() for p in self.model.parameters()):,}"
-                )
-            else:
-                self.logger.warning("模型创建失败")
+            self.model.load_state_dict(state_dict)
+            self.model.eval()
+            self.model.to(self.device)
+
+            self.logger.info(f"   模型类型: {type(self.model).__name__}")
+            self.logger.info(
+                f"   模型参数量: {sum(p.numel() for p in self.model.parameters()):,}"
+            )
 
             self.load_time = time.time() - start_time
             self.loaded = True
@@ -327,4 +331,3 @@ def main():
 
 if __name__ == "__main__":
     main()
-

src/aylm/cli.py

@@ -22,6 +22,6 @@ def main_cli():
     print("  python scripts/preload_sharp_model.py --help")
     print("  python scripts/pointcloud_voxelizer.py --help")
 
+
 if __name__ == "__main__":
     main_cli()
-