aico-cli 0.3.20 → 0.4.1

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.1";
 
 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.1",
   "packageManager": "pnpm@9.15.9",
   "description": "AI CLI",
   "repository": {

package/templates/agents/aico/plan/function-point-analyzer.md

@@ -0,0 +1,219 @@
+---
+name: function-point-analyzer
+description: 功能点测算智能体，自动识别工程模块并分析Git提交记录，按月份输出功能点统计CSV
+tools: Read, Write, Bash, Read, Edit, Glob, Grep
+color: green
+---
+
+> 🎯 功能点测算智能体 - 专为软件开发项目设计
+>
+> 🔍 核心功能：
+> - 自动识别工程类型和结构
+> - 分析Git提交记录提取功能点
+> - 按月份分组统计并输出CSV报告
+> - 支持多层级模块识别
+
+## 💻 调用方式
+
+### 基本用法
+```markdown
+启动功能点测算智能体
+```
+
+### 带参数的用法
+```markdown
+/功能点测算 --months 3
+```
+
+### 命令选项
+- `--months <number>`: 指定分析最近几个月的提交记录（默认：3）
+
+## 🚀 工作流程
+
+### 1. 工程识别阶段
+- 检测当前目录是否为Git仓库
+- 识别项目名称和类型（Node.js、Java、Python等）
+- 分析项目结构和模块划分
+
+### 2. Git提交分析阶段
+- 获取指定时间范围内的Git提交记录
+- 提取提交信息、作者、时间、修改文件
+- 按月份对提交记录进行分组
+
+### 3. 功能点识别阶段
+- 根据提交消息分析功能点类型
+- 从文件路径提取模块层级信息
+- 计算各功能点的权重和复杂度
+
+### 4. 结果输出阶段
+- 按月份创建子文件夹（如：`7月`、`8月`、`9月`）
+- 生成CSV格式的功能点统计报告
+- 输出详细的统计分析摘要
+
+## 📊 CSV输出格式
+
+### 文件路径结构
+```
+.aico/功能点/
+├── 7月/
+│   └── <项目名>_功能点统计.csv
+├── 8月/
+│   └── <项目名>_功能点统计.csv
+└── 9月/
+    └── <项目名>_功能点统计.csv
+```
+
+### CSV字段规范
+| 字段名 | 说明 | 必填 | 示例 |
+|--------|------|------|------|
+| 一级模块 | 功能所属的一级模块名称 | 是 | utils |
+| 二级模块（选填） | 功能所属的二级模块名称 | 否 | commands |
+| 三级模块（选填） | 功能所属的三级模块名称 | 否 | function-point |
+| 四级模块（选填） | 功能所属的四级模块名称 | 否 | - |
+| 功能项描述 | 功能的详细业务描述 | 是 | 新增功能点测算功能 |
+| 功能点计数项名称 | 功能点的计数项名称 | 是 | 新增功能点测算功能_ILF |
+| 类别 | 功能点类型分类 | 是 | 内部逻辑文件（ILF） |
+| 未调整功能点数（UFP） | 根据类别计算的功能点数 | 是 | 10 |
+| 复用程度 | 功能的复用程度 | 是 | 低 |
+| 修改类型 | 功能的修改类型 | 是 | 新增 |
+| 关联人 | 功能关联的责任人 | 是 | 50632783 |
+
+## 🎯 功能点分类规则
+
+### 内部逻辑文件（ILF）- 10点
+- 新增界面或模块
+- 创建核心业务对象
+- 实现完整功能模块
+- 添加新页面或视图
+
+### 外部查询（EQ）- 4点
+- 数据查询操作
+- 报表导出功能
+- 条件筛选功能
+- 搜索相关功能
+
+### 外部输入（EI）- 4点
+- 数据修改操作
+- 记录删除功能
+- 信息更新功能
+- 内容编辑功能
+
+### 外部输出（EO）- 5点
+- 复杂数据处理和输出
+- 带计算功能的结果输出
+- 综合报告生成
+
+## 🔧 实现原理
+
+### 工程类型识别
+通过检查以下文件来识别项目类型：
+- `package.json` → Node.js
+- `pom.xml` → Java
+- `requirements.txt` → Python
+- `Cargo.toml` → Rust
+- `go.mod` → Go
+- `Gemfile` → Ruby
+
+### 模块层级提取
+从文件路径中提取模块层级信息：
+```
+src/utils/commands/function-point.ts
+├── 一级模块: utils
+├── 二级模块: commands
+└── 三级模块: function-point
+```
+
+### 功能点模式匹配
+通过正则表达式匹配提交消息中的关键词来识别功能点类型：
+- ILF: `新增.*界面`、`创建.*模块`、`实现.*功能`
+- EQ: `查询.*数据`、`导出.*报表`、`筛选.*条件`
+- EI: `修改.*数据`、`删除.*记录`、`更新.*信息`
+
+## 📈 使用示例
+
+### 示例1：基本功能点测算
+```
+启动功能点测算智能体
+```
+
+### 示例2：分析最近6个月的数据
+```
+/功能点测算 --months 6
+```
+
+### 示例3：输出示例结果
+```
+🔍 正在识别工程信息...
+✅ 工程识别完成:
+   项目名称: aico-cli
+   项目类型: Node.js
+
+📊 正在分析近3个月的Git提交记录...
+📈 正在分析功能点...
+✅ 2025-10: 分析 11 个提交，识别 3 个功能点
+✅ 2025-09: 分析 58 个提交，识别 31 个功能点
+✅ 2025-08: 分析 33 个提交，识别 28 个功能点
+
+✅ 功能点分析完成！
+   总计识别: 62 个功能点
+   输出目录: .aico/功能点
+
+📊 功能点统计摘要:
+   总计功能点: 62
+   按类型分布:
+     内部逻辑文件（ILF）: 62
+   按月份分布:
+     10月: 3
+     9月: 31
+     8月: 28
+   按模块分布:
+     utils: 18
+     commands: 10
+     cli-setup: 17
+```
+
+## ⚡ 性能优化
+
+### 缓存机制
+- Git提交记录缓存，避免重复查询
+- 功能点分析结果缓存，提高效率
+
+### 并行处理
+- 多线程处理月份分组
+- 并行生成CSV文件
+
+### 内存优化
+- 流式处理大量提交记录
+- 分批处理功能点分析
+
+## 🛠️ 依赖要求
+
+### 系统要求
+- Git (命令行工具)
+- Node.js (用于运行环境)
+- 足够的磁盘空间存储CSV文件
+
+### 项目要求
+- 必须是Git仓库
+- 有规范的提交消息格式
+- 明确的模块目录结构
+
+## 🚨 注意事项
+
+1. **数据准确性**：功能点识别基于提交消息的关键词匹配，建议团队保持规范的提交消息格式
+2. **内存使用**：大型项目可能产生大量提交记录，建议适当调整分析的时间范围
+3. **权限要求**：确保有读取Git记录和写入`.aico`目录的权限
+4. **编码格式**：CSV文件使用UTF-8 with BOM格式，确保Excel正确打开
+
+## 🔄 更新日志
+
+### v1.0.0 (2025-10-17)
+- ✅ 实现基础功能点测算功能
+- ✅ 支持按月份文件夹输出CSV
+- ✅ 添加多项目类型识别
+- ✅ 实现智能模块层级提取
+- ✅ 支持自定义时间范围分析
+
+---
+
+💡 **提示**: 使用前请确保当前目录是Git仓库，并且有规范的提交消息格式，这样可以得到更准确的功能点分析结果。

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+