# CHANGELOG

本项目的所有重要变更记录于此。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)。

## [Unreleased]

### Added (新增)

- **编程规范文档** `doc/CODING_STYLE.md` — 教科书级别规范(PEP 8 + ROS2 REP + rclpy/rclcpp 最佳实践 + 测试 + 反模式)
- **路线图文档** `doc/00-levels.md` — Level 1-4 全方位 ROS2 → 机械臂 → VLA 学习路线
- **Docker 分组** — `docker-compose.yml` 加 `name: ros2` + 自定义网络 `ros2_net`(脱离 docker_default)
- **工程化** — `Makefile`(Linux/macOS) + `.gitlab-ci.yml`(GitLab 自动 build/test) + `LICENSE`(MIT) + `CONTRIBUTING.md` + `CHANGELOG.md`

### Changed (重写)

按 `doc/CODING_STYLE.md` 严格规范重写所有包:

- `py_pubsub` — ChatterPublisher/ChatterSubscriber(完整 type hints + Google docstring + 11 测试)
- `cpp_pubsub` — ChatterPublisher/ChatterSubscriber(命名空间 + override + const + 3 gtest)
- `py_srv` — AddTwoIntsServer/Client(6 测试)
- `py_action_demo` — FibonacciActionServer/Client(MultiThreadedExecutor + ReentrantCallbackGroup + 4 测试)
- `cpp_robot_tf2` — JointStatePublisher/Tf2Listener(URDF 4 关节 + 4 gtest)
- `py_vision_demo` — FakeCamera/ImageProcessor(cv_bridge + 11 测试)
- `bringup` — 6 跨包 launch 嵌套(IncludeLaunchDescription)
- `py_params` — ParamsTalker(descriptor + 缓存 + 16 测试)
- `cpp_custom_interface` — SensorReading.msg + GetCalibration.srv + MoveArm.action(3 节点 + 3 gtest)
- `py_lifecycle_composable` — LifecycleDemoNode + ComposableDemo(6 测试)
- `cpp_qos_demo` — QosDemoPublisher/Subscriber(9 种 QoS 组合 + 4 gtest)
- `py_overlay_dds` — DdsInspectorNode(ROS_DOMAIN_ID / RMW 检查 + 6 测试)

总计:**12 包 / 74 测试用例 / 100% 通过目标**

## [0.1.0] - 2026-08-04

### Added

- 初始版本:7 包 + 10 测试 100% 通过 + 15 篇深度文档 + Docker + venv

[Unreleased]: https://git.xsinfo.vip/xiaoshuai/ROS2_learn/-/compare/v0.1.0...HEAD
[0.1.0]: https://git.xsinfo.vip/xiaoshuai/ROS2_learn/-/releases/v0.1.0