aico-cli 0.2.2 → 0.2.5

package/templates/agents/aico/requirement/PLATFORM_COMPATIBILITY.md

@@ -0,0 +1,219 @@
+# 🌐 跨平台兼容性指南
+
+## 支持的操作系统
+
+### ✅ 完全支持
+- **Windows 10/11** (通过以下环境)
+  - Git Bash (推荐)
+  - Cygwin
+  - WSL (Windows Subsystem for Linux)
+  - MSYS2
+
+- **macOS** (10.15+)
+  - 原生终端
+  - iTerm2
+  - 任何兼容的终端环境
+
+- **Linux** (主流发行版)
+  - Ubuntu/Debian
+  - CentOS/RHEL
+  - Fedora
+  - Arch Linux
+  - 其他基于 GNU/Linux 的系统
+
+## 🛠️ 环境要求
+
+### 基本依赖
+所有平台都需要以下基本工具：
+- `bash` (版本 4.0+)
+- `coreutils` (包含基本 Unix 命令)
+- `grep`
+- `sed`
+- `head`/`tail`
+- `mkdir`/`cat`/`echo`
+
+### Windows 特定设置
+
+#### 选项1: Git for Windows (推荐)
+```bash
+# 1. 下载安装 Git for Windows
+#    https://git-scm.com/download/win
+
+# 2. 启动 Git Bash
+# 3. 导航到脚本目录
+cd /c/path/to/your/project
+
+# 4. 运行脚本
+./requirement-launcher.sh "您的需求"
+```
+
+#### 选项2: WSL (Windows Subsystem for Linux)
+```bash
+# 1. 启用 WSL
+wsl --install
+
+# 2. 安装 Ubuntu
+wsl --install -d Ubuntu
+
+# 3. 启动 WSL
+wsl
+
+# 4. 安装必要工具
+sudo apt update && sudo apt install git bash
+
+# 5. 运行脚本
+./requirement-launcher.sh "您的需求"
+```
+
+#### 选项3: Cygwin
+```bash
+# 1. 安装 Cygwin
+#    https://www.cygwin.com/
+
+# 2. 确保安装以下包：
+#    - bash
+#    - coreutils
+#    - grep
+#    - sed
+
+# 3. 运行脚本
+./requirement-launcher.sh "您的需求"
+```
+
+### macOS 设置
+```bash
+# 确保已安装 Xcode Command Line Tools
+xcode-select --install
+
+# 或者使用 Homebrew 安装最新工具
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+brew install coreutils
+
+# 运行脚本
+./requirement-launcher.sh "您的需求"
+```
+
+### Linux 设置
+```bash
+# Ubuntu/Debian
+sudo apt update && sudo apt install bash coreutils
+
+# CentOS/RHEL
+sudo yum install bash coreutils
+
+# Fedora
+sudo dnf install bash coreutils
+
+# 运行脚本
+./requirement-launcher.sh "您的需求"
+```
+
+## 📁 文件结构
+
+```
+agents/aico/requirement/
+├── requirement-functions-crossplatform.sh  # 跨平台主函数库
+├── requirement-launcher.sh                 # 跨平台启动器
+├── requirement-functions.sh                # 原版函数库 (Unix only)
+├── PLATFORM_COMPATIBILITY.md              # 本文件
+└── *.md                                   # 其他文档文件
+```
+
+## 🔧 技术实现细节
+
+### 平台检测
+脚本会自动检测运行环境：
+- `Darwin` → macOS
+- `Linux` → Linux
+- `CYGWIN*|MINGW*|MSYS*` → Windows
+
+### 路径处理
+- **Windows**: 自动处理路径分隔符 (`/` → `\\`)
+- **临时目录**: 使用平台适当的临时目录
+- **家目录**: 自动识别 Windows (`%USERPROFILE%`) 和 Unix (`$HOME`)
+
+### 命令兼容性
+- 使用 `command -v` 代替 `which`
+- 提供命令回退机制
+- 统一的错误处理
+
+## 🚀 快速开始
+
+### 所有平台通用命令
+```bash
+# 1. 确保脚本有执行权限
+chmod +x requirement-launcher.sh
+chmod +x requirement-functions-crossplatform.sh
+
+# 2. 运行需求识别
+./requirement-launcher.sh "需要开发用户登录功能"
+
+# 3. 或者直接使用函数库
+source requirement-functions-crossplatform.sh
+main_workflow "需要修复页面加载性能问题"
+```
+
+### Windows 特定示例
+```bash
+# 在 Git Bash 中:
+cd /c/Users/YourName/project
+./requirement-launcher.sh "创建新的API接口"
+
+# 在 PowerShell 中启动 Git Bash:
+Start-Process "C:\\Program Files\\Git\\git-bash.exe" -ArgumentList "-c", "cd /c/path/to/project && ./requirement-launcher.sh '您的需求'"
+```
+
+## 🧪 测试验证
+
+### 基本功能测试
+```bash
+# 测试平台检测
+./requirement-launcher.sh "测试平台兼容性"
+
+# 测试需求分析
+./requirement-launcher.sh "需要添加数据导出功能"
+
+# 测试文档生成
+./requirement-launcher.sh "创建用户管理模块"
+```
+
+### 跨平台一致性验证
+确保在所有平台上产生相同的结果：
+- 相同的需求识别结果
+- 相同的文档输出格式
+- 相同的状态管理行为
+
+## ⚠️ 已知限制
+
+1. **Windows 原生 CMD/PowerShell**: 不支持，必须使用兼容环境
+2. **非常旧的系统**: 可能需要手动安装更新版本的 bash
+3. **特殊字符处理**: 某些特殊字符在不同 shell 中可能有不同行为
+4. **文件权限**: Windows 和 Unix 文件权限模型不同
+
+## 🔄 更新和维护
+
+### 添加新平台支持
+1. 在 `detect_platform()` 中添加新的平台检测
+2. 在相应的平台分支中添加特殊处理逻辑
+3. 更新测试用例
+4. 更新本文档
+
+### 维护跨平台兼容性
+- 避免使用平台特定的命令
+- 使用 POSIX 兼容的语法
+- 提供适当的回退机制
+- 定期在不同平台上测试
+
+## 📞 技术支持
+
+如果遇到平台兼容性问题：
+
+1. 检查 `detect_platform` 函数的输出
+2. 验证基本依赖是否安装
+3. 查看具体的错误信息
+4. 参考对应平台的设置指南
+
+---
+
+**最后更新**: $(date '+%Y-%m-%d')
+**兼容性状态**: ✅ 生产环境就绪

package/templates/agents/aico/requirement/crossplatform-utils.sh

@@ -0,0 +1,307 @@
+#!/usr/bin/env bash
+# 跨平台工具库 - 支持 Windows/Linux/macOS
+# 为所有智能体脚本提供统一的跨平台功能
+
+# 平台检测函数
+detect_platform() {
+    case "$(uname -s)" in
+        Darwin)
+            PLATFORM="macos"
+            ;;
+        Linux)
+            PLATFORM="linux"
+            ;;
+        CYGWIN*|MINGW*|MSYS*)
+            PLATFORM="windows"
+            ;;
+        *)
+            PLATFORM="unknown"
+            ;;
+    esac
+    echo "🌐 检测到平台: $PLATFORM"
+}
+
+# 跨平台临时目录
+get_temp_dir() {
+    case "$PLATFORM" in
+        windows)
+            # Windows: 使用用户临时目录
+            if [ -n "$TEMP" ]; then
+                echo "$TEMP"
+            elif [ -n "$TMP" ]; then
+                echo "$TMP"
+            else
+                echo "/tmp"
+            fi
+            ;;
+        *)
+            # Linux/macOS: 使用标准临时目录
+            echo "/tmp"
+            ;;
+    esac
+}
+
+# 跨平台文件路径处理
+normalize_path() {
+    local path="$1"
+    case "$PLATFORM" in
+        windows)
+            # 将路径转换为 Windows 兼容格式
+            echo "$path" | sed 's|/|\\|g'
+            ;;
+        *)
+            echo "$path"
+            ;;
+    esac
+}
+
+# 跨平台家目录
+get_home_dir() {
+    case "$PLATFORM" in
+        windows)
+            echo "$USERPROFILE"
+            ;;
+        *)
+            echo "$HOME"
+            ;;
+    esac
+}
+
+# 跨平台命令检查
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# 跨平台文件查找
+find_files() {
+    local pattern="$1"
+    local max_results="${2:-10}"
+    
+    # 使用兼容的 find 命令
+    if command_exists "find"; then
+        find . -name "$pattern" 2>/dev/null | head -n "$max_results"
+    else
+        # Windows 回退方案
+        ls -la "$pattern" 2>/dev/null | head -n "$max_results"
+    fi
+}
+
+# 跨平台文件读取
+safe_read_file() {
+    local file_path="$1"
+    local max_lines="${2:-50}"
+    
+    if [ -f "$file_path" ]; then
+        # 使用兼容的读取方式
+        if command_exists "head"; then
+            head -n "$max_lines" "$file_path" 2>/dev/null
+        else
+            # Windows 回退方案
+            sed -n "1,${max_lines}p" "$file_path" 2>/dev/null
+        fi
+    else
+        echo "文件不存在: $file_path"
+    fi
+}
+
+# 跨平台包管理器检测
+detect_package_manager() {
+    if command_exists "npm"; then
+        echo "npm"
+    elif command_exists "yarn"; then
+        echo "yarn"
+    elif command_exists "pnpm"; then
+        echo "pnpm"
+    elif command_exists "pip"; then
+        echo "pip"
+    elif command_exists "cargo"; then
+        echo "cargo"
+    else
+        echo "unknown"
+    fi
+}
+
+# 跨平台 Git 命令
+git_safe() {
+    if command_exists "git"; then
+        git "$@" 2>/dev/null
+    else
+        echo "Git 未安装"
+    fi
+}
+
+# 跨平台目录创建
+safe_mkdir() {
+    local dir_path="$1"
+    
+    if command_exists "mkdir"; then
+        mkdir -p "$dir_path" 2>/dev/null
+    else
+        # Windows 回退方案
+        md "$dir_path" 2>/dev/null
+    fi
+}
+
+# 跨平台文件复制
+safe_cp() {
+    local source="$1"
+    local destination="$2"
+    
+    if command_exists "cp"; then
+        cp "$source" "$destination" 2>/dev/null
+    else
+        # Windows 回退方案
+        copy "$source" "$destination" 2>/dev/null
+    fi
+}
+
+# 跨平台文件移动
+safe_mv() {
+    local source="$1"
+    local destination="$2"
+    
+    if command_exists "mv"; then
+        mv "$source" "$destination" 2>/dev/null
+    else
+        # Windows 回退方案
+        move "$source" "$destination" 2>/dev/null
+    fi
+}
+
+# 跨平台文件删除
+safe_rm() {
+    local file_path="$1"
+    
+    if command_exists "rm"; then
+        rm -f "$file_path" 2>/dev/null
+    else
+        # Windows 回退方案
+        del "$file_path" 2>/dev/null
+    fi
+}
+
+# 跨平台目录删除
+safe_rmdir() {
+    local dir_path="$1"
+    
+    if command_exists "rm"; then
+        rm -rf "$dir_path" 2>/dev/null
+    else
+        # Windows 回退方案
+        rmdir /s /q "$dir_path" 2>/dev/null
+    fi
+}
+
+# 跨平台环境变量设置
+set_env() {
+    local var_name="$1"
+    local var_value="$2"
+    
+    case "$PLATFORM" in
+        windows)
+            set "$var_name=$var_value"
+            ;;
+        *)
+            export "$var_name=$var_value"
+            ;;
+    esac
+}
+
+# 跨平台脚本执行
+execute_script() {
+    local script_path="$1"
+    
+    if [ -f "$script_path" ]; then
+        if command_exists "bash"; then
+            bash "$script_path"
+        else
+            # Windows 回退方案
+            cmd /c "$script_path"
+        fi
+    else
+        echo "脚本文件不存在: $script_path"
+    fi
+}
+
+# 跨平台进程检查
+check_process() {
+    local process_name="$1"
+    
+    case "$PLATFORM" in
+        windows)
+            tasklist | grep -i "$process_name" >/dev/null 2>&1
+            ;;
+        *)
+            ps aux | grep -v "grep" | grep -i "$process_name" >/dev/null 2>&1
+            ;;
+    esac
+}
+
+# 跨平台端口检查
+check_port() {
+    local port="$1"
+    
+    case "$PLATFORM" in
+        windows)
+            netstat -ano | grep ":$port " >/dev/null 2>&1
+            ;;
+        *)
+            lsof -i ":$port" >/dev/null 2>&1
+            ;;
+    esac
+}
+
+# 跨平台网络请求
+safe_curl() {
+    if command_exists "curl"; then
+        curl "$@" 2>/dev/null
+    elif command_exists "wget"; then
+        wget -q -O - "$@" 2>/dev/null
+    else
+        echo "网络工具未安装"
+    fi
+}
+
+# 跨平台日期时间
+get_timestamp() {
+    case "$PLATFORM" in
+        windows)
+            date "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "$(date +'%Y-%m-%d %H:%M:%S')"
+            ;;
+        *)
+            date '+%Y-%m-%d %H:%M:%S'
+            ;;
+    esac
+}
+
+# 跨平台文件权限设置
+set_executable() {
+    local file_path="$1"
+    
+    case "$PLATFORM" in
+        windows)
+            # Windows 不需要设置执行权限
+            :
+            ;;
+        *)
+            chmod +x "$file_path" 2>/dev/null
+            ;;
+    esac
+}
+
+# 跨平台路径分隔符
+get_path_separator() {
+    case "$PLATFORM" in
+        windows)
+            echo ";"
+            ;;
+        *)
+            echo ":"
+            ;;
+    esac
+}
+
+# 初始化平台检测
+detect_platform
+
+echo "✅ 跨平台工具库已加载 (支持 Windows/Linux/macOS)"