aico-cli 0.3.20 → 0.4.0

package/dist/chunks/simple-config.mjs

@@ -13,7 +13,7 @@ import { join as join$1 } from 'node:path';
 import { join, dirname, basename } from 'pathe';
 import { fileURLToPath } from 'node:url';
 
-const version = "0.3.20";
+const version = "0.4.0";
 
 function displayBanner(subtitle) {
   const defaultSubtitle = "\u4E00\u952E\u914D\u7F6E\u4F60\u7684\u5F00\u53D1\u73AF\u5883";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aico-cli",
-  "version": "0.3.20",
+  "version": "0.4.0",
   "packageManager": "pnpm@9.15.9",
   "description": "AI CLI",
   "repository": {

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

@@ -0,0 +1,478 @@
+# Windows 平台使用指南
+
+> 🌐 AICO 需求场景识别智能体全平台兼容性指南
+
+## 📋 目录
+
+- [系统要求](#系统要求)
+- [环境配置](#环境配置)
+- [安装与设置](#安装与设置)
+- [使用方式](#使用方式)
+- [故障排除](#故障排除)
+- [常见问题](#常见问题)
+- [最佳实践](#最佳实践)
+
+## 🖥️ 系统要求
+
+### 支持的 Windows 版本
+- ✅ **Windows 10** (版本 1809 及以上)
+- ✅ **Windows 11** (所有版本)
+- ✅ **Windows Server 2019** 及以上
+
+### PowerShell 版本要求
+- ✅ **PowerShell 5.1** (Windows 内置)
+- ✅ **PowerShell Core 6.0+** (推荐)
+- ❌ PowerShell 4.0 及以下 (不支持)
+
+### 可选兼容层
+- ✅ **Git Bash** (通过 Git for Windows)
+- ✅ **Windows Subsystem for Linux (WSL)**
+- ✅ **Cygwin**
+- ✅ **MSYS2**
+
+## ⚙️ 环境配置
+
+### 方式一：Windows PowerShell (推荐)
+
+#### 1. 检查 PowerShell 版本
+```powershell
+# 检查 PowerShell 版本
+$PSVersionTable.PSVersion
+```
+
+**预期输出示例：**
+```
+Major Minor Build Revision
+----- ----- ----- --------
+5     1     19041 1682  # PowerShell 5.1
+# 或
+7     3     6         0  # PowerShell Core
+```
+
+#### 2. 安装 PowerShell Core (可选但推荐)
+```powershell
+# 使用 winget 安装 PowerShell Core
+winget install Microsoft.PowerShell
+
+# 或从官网下载安装
+# https://github.com/PowerShell/PowerShell/releases
+```
+
+#### 3. 配置执行策略
+```powershell
+# 允许本地脚本执行
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+
+# 验证执行策略
+Get-ExecutionPolicy
+```
+
+#### 4. 启用脚本运行（如果被阻止）
+```powershell
+# 临时绕过执行策略（仅限当前会话）
+Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
+```
+
+### 方式二：Git Bash
+
+#### 1. 安装 Git for Windows
+```bash
+# 下载地址：https://git-scm.com/download/win
+# 安装时确保选择 "Use Git and optional Unix tools from the Command Prompt"
+```
+
+#### 2. 验证 Git Bash 环境
+```bash
+# 验证关键工具
+bash --version
+which sed grep find head tail
+```
+
+### 方式三：WSL (Windows Subsystem for Linux)
+
+#### 1. 启用 WSL
+```powershell
+# 启用 WSL 功能
+Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
+
+# 重启后安装 WSL 发行版
+wsl --install
+```
+
+#### 2. 在 WSL 中配置
+```bash
+# 更新包列表
+sudo apt update
+
+# 安装基础工具
+sudo apt install -y bash grep sed findutils coreutils
+```
+
+## 🚀 安装与设置
+
+### 1. 下载脚本文件
+确保以下文件存在于您的项目目录中：
+```
+templates/agents/aico/requirement/
+├── requirement-launcher.ps1          # PowerShell 启动器
+├── requirement-launcher.sh           # Bash 启动器
+├── requirement-functions-crossplatform.ps1  # PowerShell 功能库
+├── requirement-functions-crossplatform.sh   # Bash 功能库
+├── crossplatform-utils.ps1          # PowerShell 工具库
+├── crossplatform-utils.sh           # Bash 工具库
+└── WINDOWS_USAGE.md                  # 本文档
+```
+
+### 2. 设置文件权限 (Git Bash/WSL)
+```bash
+# 设置脚本执行权限
+chmod +x requirement-launcher.sh
+chmod +x requirement-functions-crossplatform.sh
+chmod +x crossplatform-utils.sh
+```
+
+### 3. 验证环境
+```powershell
+# PowerShell 环境验证
+.\requirement-launcher.ps1 --help
+
+# Git Bash 环境验证
+./requirement-launcher.sh --help
+```
+
+## 💻 使用方式
+
+### PowerShell 使用方式
+
+#### 基本用法
+```powershell
+# 使用 PowerShell 启动器
+.\requirement-launcher.ps1 "需要开发一个用户登录功能"
+
+# 帮助信息
+.\requirement-launcher.ps1 --help
+
+# 版本信息
+.\requirement-launcher.ps1 --version
+```
+
+#### 高级用法
+```powershell
+# 详细输出模式
+.\requirement-launcher.ps1 "优化数据库查询性能" -Verbose
+
+# 静默模式（减少输出）
+.\requirement-launcher.ps1 "修复页面加载问题" -Silent
+
+# 批量处理从文件
+Get-Content "requirements.txt" | ForEach-Object {
+    .\requirement-launcher.ps1 $_
+}
+```
+
+#### 直接调用函数库
+```powershell
+# 加载 PowerShell 函数库
+. .\requirement-functions-crossplatform.ps1
+
+# 直接调用功能
+Collect-Context -UserInput "用户需要登录功能"
+Main-Workflow -UserInput "开发新的API接口"
+
+# 使用跨平台工具
+$platform = Get-Platform
+$files = Find-Files -Pattern "*.js|*.ts" -MaxResults 10
+```
+
+### Git Bash/WSL 使用方式
+
+#### 基本用法
+```bash
+# 使用 Bash 启动器
+./requirement-launcher.sh "需要开发一个用户登录功能"
+
+# 帮助信息
+./requirement-launcher.sh --help
+
+# 版本信息
+./requirement-launcher.sh --version
+```
+
+#### 直接调用函数库
+```bash
+# 加载 Bash 函数库
+source requirement-functions-crossplatform.sh
+
+# 直接调用功能
+collect_context "用户需要登录功能"
+main_workflow "开发新的API接口"
+
+# 使用跨平台工具
+PLATFORM=$(detect_platform)
+files=$(find_files "*.js|*.ts" 10)
+```
+
+## 🔄 智能体使用示例
+
+### 需求识别阶段
+```powershell
+# PowerShell
+.\requirement-launcher.ps1 "我需要实现一个用户注册和登录系统"
+
+# Git Bash
+./requirement-launcher.sh "我需要实现一个用户注册和登录系统"
+```
+
+### 技术方案对齐
+```powershell
+# PowerShell
+.\requirement-launcher.ps1 "技术方案评估：基于 React 的用户认证系统"
+
+# Git Bash
+./requirement-launcher.sh "技术方案评估：基于 React 的用户认证系统"
+```
+
+### 任务执行
+```powershell
+# PowerShell
+.\requirement-launcher.ps1 "执行任务：创建登录表单组件"
+
+# Git Bash
+./requirement-launcher.sh "执行任务：创建登录表单组件"
+```
+
+### 质量验证
+```powershell
+# PowerShell
+.\requirement-launcher.ps1 "质量验证：登录功能测试"
+
+# Git Bash
+./requirement-launcher.sh "质量验证：登录功能测试"
+```
+
+## 🛠️ 故障排除
+
+### 常见错误及解决方案
+
+#### 1. 执行策略限制
+**错误信息：**
+```
+无法加载文件，因为在此系统上禁止运行脚本。
+```
+
+**解决方案：**
+```powershell
+# 临时解决
+Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
+
+# 永久解决（当前用户）
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+```
+
+#### 2. 找不到脚本文件
+**错误信息：**
+```
+无法找到路径，因为该路径不存在。
+```
+
+**解决方案：**
+```powershell
+# 检查文件是否存在
+Test-Path ".\requirement-launcher.ps1"
+
+# 查看当前目录
+Get-Location
+
+# 切换到正确目录
+Set-Location "D:\your-project-path\templates\agents\aico\requirement"
+```
+
+#### 3. 编码问题
+**错误信息：**
+```
+无法处理包含中文字符的内容。
+```
+
+**解决方案：**
+```powershell
+# 设置正确的编码
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+
+# 或者在 PowerSehll 配置文件中设置
+# 在 $PROFILE 文件中添加上述设置
+```
+
+#### 4. 网络连接问题
+**错误信息：**
+```
+无法连接到远程服务器。
+```
+
+**解决方案：**
+```powershell
+# 检查网络连接
+Test-NetConnection -ComputerName "github.com" -Port 443
+
+# 设置代理（如果需要）
+$env:HTTP_PROXY = "http://your-proxy:port"
+$env:HTTPS_PROXY = "http://your-proxy:port"
+```
+
+#### 5. Git Bash 工具不可用
+**错误信息：**
+```
+command not found: sed
+```
+
+**解决方案：**
+```bash
+# 安装 Git for Windows
+# 或安装 WSL
+# 或使用 MSYS2
+
+# 安装必要工具
+pacman -S sed grep findutils coreutils  # MSYS2
+sudo apt install sed grep findutils   # WSL
+```
+
+### 调试模式
+
+#### PowerShell 调试
+```powershell
+# 启用详细输出
+$VerbosePreference = "Continue"
+
+# 启用调试输出
+$DebugPreference = "Continue"
+
+# 启用调试模式运行
+.\requirement-launcher.ps1 "测试需求" -Debug -Verbose
+```
+
+#### Bash 调试
+```bash
+# 启用调试模式
+set -x
+
+# 运行脚本
+./requirement-launcher.sh "测试需求"
+
+# 禁用调试
+set +x
+```
+
+## ❓ 常见问题
+
+### Q1: PowerShell 和 Git Bash 应该选择哪个？
+
+**A:**
+- **PowerShell**: 推荐 Windows 原生使用，更好的 Windows 集成
+- **Git Bash**: 如果您习惯 Unix/Linux 环境，或者需要与 Linux 保持一致
+- **WSL**: 如果需要完整的 Linux 环境
+
+### Q2: 为什么脚本无法执行？
+
+**A:**
+1. 检查执行策略：运行 `Get-ExecutionPolicy`
+2. 检查文件路径：确保在正确的目录中
+3. 检查文件权限：Git Bash 下需要执行权限
+
+### Q3: 如何处理中文乱码？
+
+**A:**
+```powershell
+# PowerShell 中设置
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+
+# Git Bash 中设置
+export LANG=zh_CN.UTF-8
+export LC_ALL=zh_CN.UTF-8
+```
+
+### Q4: 如何创建桌面快捷方式？
+
+**A:**
+```powershell
+# 创建快捷方式脚本
+$WScriptShell = New-Object -ComObject WScript.Shell
+$Shortcut = $WScriptShell.CreateShortcut("$Home\Desktop\AICO 启动器.lnk")
+$Shortcut.TargetPath = "powershell.exe"
+$Shortcut.Arguments = "-NoExit -Command `"$PWD\requirement-launcher.ps1`""
+$Shortcut.WorkingDirectory = $PWD
+$Shortcut.Save()
+```
+
+### Q5: 如何配置环境变量？
+
+**A:**
+```powershell
+# 临时设置（当前会话）
+$env:AICO_HOME = "D:\your-project-path"
+
+# 永久设置（系统级别）
+[Environment]::SetEnvironmentVariable("AICO_HOME", "D:\your-project-path", "User")
+
+# 重启 PowerShell 生效
+```
+
+## 💡 最佳实践
+
+### 1. 项目组织
+```
+your-project/
+├── .aico/
+│   ├── docs/           # 生成的文档
+│   ├── scripts/        # 生成的脚本
+│   └── logs/          # 日志文件
+├── src/               # 源代码
+└── templates/
+    └── agents/
+        └── aico/
+            └── requirement/
+                └── [脚本文件]
+```
+
+### 2. 工作流建议
+1. **项目初始化**: 先使用 `requirement-identifier` 明确需求
+2. **方案制定**: 使用 `requirement-aligner` 确定技术方案
+3. **任务拆分**: 使用 `task-splitter-validator` 分解任务
+4. **执行实施**: 使用 `task-executor` 完成开发
+5. **质量验证**: 使用 `task-executor-validator` 进行测试
+
+### 3. 性能优化
+```powershell
+# 使用 PowerShell Core 获得更好性能
+# 避免在大量循环中使用外部命令
+# 优先使用 PowerShell 内置命令
+```
+
+### 4. 安全考虑
+- 始终检查脚本内容，特别是下载的脚本
+- 使用适当的执行策略，不要设置为 `Unrestricted`
+- 定期更新 PowerShell 和相关工具
+
+### 5. 备份与恢复
+```powershell
+# 备份配置
+Copy-Item ".aico" -Destination ".aico-backup-$(Get-Date -Format 'yyyyMMdd')" -Recurse
+
+# 恢复配置
+Copy-Item ".aico-backup-20241201" -Destination ".aico" -Recurse -Force
+```
+
+## 📞 技术支持
+
+如果遇到问题，请按以下步骤排查：
+
+1. **检查本文档**：确保已对应版本的处理方案
+2. **查看日志文件**：`.aico/logs/` 目录日志可能包含详细信息
+3. **社区支持**：在项目 Issues 中搜索相关问题
+4. **简化重现**：创建最小可复现的测试场景
+
+---
+
+**最后更新时间**: 2024年12月
+**适用版本**: AICO CLI v0.3.0+
+**兼容平台**: Windows 10/11, PowerShell 5.1+