文檔：完成增強功能文檔與版本管理系統

.gitignore

@@ -129,4 +129,10 @@ dmypy.json
 .pyre/
 
 # avoid temp folder
-temp/
+temp/
+
+# per-user
+env_path.txt
+
+# Claude Code local settings
+.claude/

CHANGELOG.md

@@ -0,0 +1,318 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Planned
+- Component Updater 自動更新功能
+- 批次更新多個 .gh 文件
+- 從 GitHub 自動下載最新組件
+- GitHub Actions 自動構建流程
+
+---
+
+## [0.1.0] - 2025-12-30
+
+### 🎉 Initial Enhanced Fork Release
+
+這是基於 compas-dev/compas-actions.ghpython_components 的增強版本，添加了完整的團隊協作和版本管理功能。
+
+### ✨ Added - 新增功能
+
+#### 新組件
+
+1. **Component Updater** (v0.1.0)
+   - 版本檢查工具（靈感來自 Ladybug Tools）
+   - 掃描畫布上的組件並比對版本
+   - 偵測 input/output 參數變化
+   - 生成詳細的版本報告
+   - 支援 manifest.json 版本管理
+   - 分類: Utilities > Version
+   - 檔案: `dist/Component_Updater.ghuser` (7.1 KB)
+
+2. **Swarm Dynamics** (v0.1.0)
+   - 粒子群體動力學模擬系統
+   - 粒子-彈簧物理模擬
+   - K-近鄰自動連接演算法
+   - 全域旋轉與呼吸效果
+   - 主動彈簧（動態長度變化）
+   - Euler 積分法更新
+   - 分類: Physics > Simulation
+   - 檔案: `dist/Swarm_Dynamics.ghuser` (9.8 KB)
+
+3. **YOLO UDP Receiver** (v0.1.0)
+   - YOLOv8 姿態偵測 UDP 數據接收器
+   - 支援 17 個人體關鍵點（COCO 格式）
+   - 輸出 Point3d 座標
+   - 無阻塞 Socket 通訊
+   - 簡單 JSON 解析（無外部依賴）
+   - 分類: YOLO > Network
+   - 檔案: `dist/YOLO_UDP_Receiver.ghuser` (4.3 KB)
+
+#### 版本管理系統
+
+1. **manifest.json**
+   - 集中管理所有組件版本資訊
+   - 記錄 GUID、版本號、參數定義
+   - 支援自動版本檢查
+
+2. **Semantic Versioning 支援**
+   - 版本號格式: MAJOR.MINOR.PATCH
+   - 自動版本號替換（`{{version}}`）
+   - 版本比對演算法
+
+#### 文檔系統
+
+1. **DEVELOPMENT_GUIDE.md**
+   - 完整的組件開發教學
+   - YOLO UDP Receiver 實戰範例
+   - 組件結構詳解
+   - 常見問題解答
+   - 進階開發技巧
+
+2. **TEAM_COLLABORATION.md**
+   - 團隊協作最佳實踐
+   - Git 工作流程
+   - 為什麼適合小團隊開發
+   - pip 套件管理優勢
+   - 多人協作範例
+
+3. **VERSION_MANAGEMENT.md**
+   - 完整的版本管理系統設計
+   - Ladybug Tools 研究成果
+   - 技術實作細節
+   - Phase 1/2/3 發展路線圖
+   - MVP 與未來功能規劃
+
+4. **COMPONENT_CATALOG.md**
+   - 所有組件的詳細目錄
+   - 參數說明與使用範例
+   - 技術特色與應用場景
+   - 安裝與使用指南
+
+5. **CHANGELOG.md** (本文件)
+   - 詳細的變更記錄
+   - 版本歷史追蹤
+
+6. **組件專屬 README**
+   - `components/Swarm_Dynamics/README.md`
+   - `components/Component_Updater/README.md`
+
+#### 原始代碼參考
+
+在 `originalcode/` 資料夾新增：
+- `opencv2gh_yolov8.py` - YOLOv8 姿態偵測發送端
+- `gh_udp_receiver_final.py` - UDP 接收器範例
+- `gh_trajectory_robust.py` - 軌跡處理範例
+
+### 🔧 Changed - 變更
+
+#### README.md
+- 新增 Enhanced Fork Features 區塊
+- 新增組件總覽表格
+- 新增 Quick Start 指南
+- 新增文檔連結
+- 新增 macOS ARM64 支援說明
+
+#### SETUP_FIXES.md
+- 新增詳細的故障排除步驟
+- 新增 `ModuleNotFoundError: pythonnet` 解決方案
+- 新增 conda 自動初始化說明
+- 新增便捷 Alias 設定
+- 更完整的分步驟指引
+
+#### QUICKSTART.md
+- 更新為當前專案路徑
+- 新增 gh_comp alias 說明
+- 更新 conda 環境設置步驟
+
+### 🐛 Fixed - 修復
+
+#### macOS ARM64 相容性
+- 修復 pythonnet 3.x 與 Rhino 8 .NET 8.0 的相容性問題
+- 新增 `python.runtimeconfig.json` 配置
+- 更新 `componentize_cpy.py` 的 runtime 初始化邏輯
+- 解決 conda activate 無效問題
+
+#### 環境設置
+- 修復 `env_path.txt` 路徑問題
+- 新增 conda 自動初始化配置
+- 更新 `.zshrc` 設置
+
+### 🔒 Security - 安全性
+
+- `.gitignore` 新增 `.claude/` 排除項目
+- `env_path.txt` 保持在 `.gitignore` 中（本地配置）
+
+### 📝 Documentation - 文檔改進
+
+#### 新增文檔（7個）
+1. DEVELOPMENT_GUIDE.md (54 KB)
+2. TEAM_COLLABORATION.md (20 KB)
+3. VERSION_MANAGEMENT.md (25 KB)
+4. COMPONENT_CATALOG.md (18 KB)
+5. CHANGELOG.md (本文件)
+6. components/Swarm_Dynamics/README.md (9 KB)
+7. components/Component_Updater/README.md (10 KB)
+
+#### 更新文檔（3個）
+1. README.md - 新增 Enhanced Fork Features
+2. SETUP_FIXES.md - 新增故障排除
+3. QUICKSTART.md - 更新快速開始指南
+
+### 🛠️ Technical - 技術細節
+
+#### 組件架構
+- 使用 `executingcomponent` 基類（CPython）
+- 類變數狀態管理
+- 模板變數支援（`{{version}}`）
+- metadata.json 配置驅動
+
+#### 物理模擬（Swarm Dynamics）
+- Euler 積分法
+- 彈簧力計算: F = k * (L - L0)
+- 動態自然長度
+- K-近鄰演算法
+
+#### 網路通訊（YOLO UDP Receiver）
+- 無阻塞 Socket
+- 批次讀取（50 次循環）
+- 簡單 JSON 解析器
+- 座標縮放轉換
+
+#### 版本管理（Component Updater）
+- 版本號解析演算法
+- 參數相容性檢測
+- manifest.json 自動搜尋
+- 詳細報告生成
+
+### 📦 Build System - 構建系統
+
+#### 新增功能
+- `manifest.json` 支援
+- gh_comp alias（一鍵構建）
+- 版本號自動替換
+- 組件 GUID 管理
+
+#### 環境配置
+- `environment.yml` - Conda 環境定義
+- `python.runtimeconfig.json` - .NET 8.0 配置
+- `.gitignore` 更新
+
+### 🎯 Project Goals - 專案目標
+
+這個版本實現了以下目標：
+
+1. ✅ **版本控制友善**
+   - 所有代碼都是文本文件
+   - Git 可以追蹤每一次變更
+   - 支援 Pull Request 代碼審查
+
+2. ✅ **團隊協作支援**
+   - 統一的 conda 環境管理
+   - manifest.json 版本追蹤
+   - 詳細的協作文檔
+
+3. ✅ **版本管理系統**
+   - Component Updater 工具
+   - Semantic Versioning
+   - 版本檢查與報告
+
+4. ✅ **完整文檔**
+   - 開發指南
+   - 團隊協作最佳實踐
+   - 組件目錄
+   - 變更日誌
+
+5. ✅ **macOS ARM64 支援**
+   - Apple Silicon 完整支援
+   - pythonnet 3.x 配置
+   - 詳細故障排除
+
+---
+
+## [0.0.0] - Before Fork
+
+### Original compas-dev/compas-actions.ghpython_components
+
+- 基本的組件化工具
+- GitHub Actions 支援
+- IronPython 和 CPython 支援
+- 基本的 metadata.json 配置
+
+---
+
+## 版本號說明
+
+使用 [Semantic Versioning](https://semver.org/)：
+
+```
+MAJOR.MINOR.PATCH
+
+MAJOR: 重大更新，不向下相容（如 input/output 變化）
+MINOR: 新增功能，向下相容
+PATCH: Bug 修復，向下相容
+```
+
+**範例**：
+- `0.1.0 → 0.2.0`: 新增功能（相容）
+- `0.2.0 → 0.2.1`: Bug 修復（相容）
+- `0.2.1 → 1.0.0`: 重大更新（不相容）
+
+---
+
+## 貢獻指南
+
+### 如何新增變更記錄
+
+1. 在 `[Unreleased]` 區塊下新增變更
+2. 使用正確的分類：
+   - `Added` - 新功能
+   - `Changed` - 既有功能的變更
+   - `Deprecated` - 即將移除的功能
+   - `Removed` - 已移除的功能
+   - `Fixed` - Bug 修復
+   - `Security` - 安全性修復
+
+3. 發布新版本時：
+   - 將 `[Unreleased]` 內容移到新版本區塊
+   - 更新日期
+   - 更新 manifest.json 版本號
+
+### Git Commit 格式
+
+```
+類型：簡短描述
+
+詳細說明...
+
+Generated with Claude Code
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+**類型**：
+- `新增` - 新功能
+- `修復` - Bug 修復
+- `更新` - 既有功能變更
+- `文檔` - 文檔更新
+- `優化` - 性能優化
+- `重構` - 代碼重構
+
+---
+
+## 連結
+
+- **專案**: https://github.com/fred1357944/compas-actions.ghpython_components
+- **上游**: https://github.com/compas-dev/compas-actions.ghpython_components
+- **問題回報**: https://github.com/fred1357944/compas-actions.ghpython_components/issues
+
+---
+
+**維護者**: Claude Code
+**最後更新**: 2025-12-30