needware-cli 1.2.8 → 1.3.0

package/install.sh

@@ -0,0 +1,528 @@
+#!/bin/bash
+
+# Needware CLI 安装脚本
+# 支持本地安装和远程安装
+# 用法 1（本地）: ./install.sh
+# 用法 2（远程）: curl -fsSL https://raw.githubusercontent.com/needware/needware-cli/main/install.sh | sh
+
+set -e  # 遇到错误立即退出
+
+# 安装模式
+INSTALL_MODE="local"  # local 或 remote
+PROJECT_DIR=""
+REPO_URL="https://github.com/needware/needware-cli.git"
+INSTALL_DIR="${HOME}/.needware-cli"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 打印函数
+print_info() {
+    echo -e "${BLUE}ℹ${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_header() {
+    echo ""
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}  $1${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+# 检查命令是否存在
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# 获取 Node.js 版本
+get_node_version() {
+    if command_exists node; then
+        node -v | sed 's/v//'
+    else
+        echo "0.0.0"
+    fi
+}
+
+# 版本比较
+version_ge() {
+    [ "$(printf '%s\n' "$1" "$2" | sort -V | head -n1)" != "$1" ]
+}
+
+# 显示欢迎信息
+show_welcome() {
+    clear
+    echo -e "${BLUE}"
+    cat << "EOF"
+    _   _               _                            ____ _     ___ 
+   | \ | | ___  ___  __| |_      ____ _ _ __ ___   / ___| |   |_ _|
+   |  \| |/ _ \/ _ \/ _` \ \ /\ / / _` | '__/ _ \ | |   | |    | | 
+   | |\  |  __/  __/ (_| |\ V  V / (_| | | |  __/ | |___| |___ | | 
+   |_| \_|\___|\___|\__,_| \_/\_/ \__,_|_|  \___|  \____|_____|___|
+                                                                     
+EOF
+    echo -e "${NC}"
+    echo -e "  ${GREEN}一个功能强大的 Node.js 命令行工具${NC}"
+    echo -e "  ${BLUE}Version: 1.2.8${NC}"
+    if [ "$INSTALL_MODE" = "remote" ]; then
+        echo -e "  ${YELLOW}安装模式: 远程安装${NC}"
+    else
+        echo -e "  ${YELLOW}安装模式: 本地安装${NC}"
+    fi
+    echo ""
+}
+
+# 检测安装模式
+detect_install_mode() {
+    if [ -f "package.json" ] && grep -q "needware-cli" package.json 2>/dev/null; then
+        INSTALL_MODE="local"
+        PROJECT_DIR=$(pwd)
+        print_info "检测到本地项目，使用本地安装模式"
+    else
+        INSTALL_MODE="remote"
+        print_info "未检测到本地项目，使用远程安装模式"
+    fi
+}
+
+# 选择安装方式（远程模式）
+choose_install_method() {
+    if [ "$INSTALL_MODE" != "remote" ]; then
+        return
+    fi
+    
+    print_header "选择安装方式"
+    
+    echo "请选择安装方式："
+    echo "  1) 从 npm 安装（推荐，快速简单）"
+    echo "  2) 从源码安装（最新开发版本）"
+    echo ""
+    
+    read -p "请输入选项 (1/2) [默认: 1]: " choice
+    choice=${choice:-1}
+    
+    case $choice in
+        1)
+            install_from_npm
+            ;;
+        2)
+            install_from_source
+            ;;
+        *)
+            print_error "无效的选项"
+            exit 1
+            ;;
+    esac
+}
+
+# 从 npm 安装
+install_from_npm() {
+    print_header "从 npm 安装"
+    
+    print_info "正在从 npm 安装 needware-cli..."
+    
+    if npm install -g needware-cli; then
+        print_success "从 npm 安装成功"
+        NPM_INSTALL=true
+    else
+        print_error "从 npm 安装失败"
+        print_warning "尝试使用 sudo: sudo npm install -g needware-cli"
+        
+        read -p "是否使用 sudo 重试？(y/n) " -n 1 -r
+        echo
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            if sudo npm install -g needware-cli; then
+                print_success "使用 sudo 安装成功"
+                NPM_INSTALL=true
+            else
+                print_error "安装失败"
+                exit 1
+            fi
+        else
+            exit 1
+        fi
+    fi
+}
+
+# 从源码安装
+install_from_source() {
+    print_header "从源码安装"
+    
+    # 检查 git
+    if ! command_exists git; then
+        print_error "从源码安装需要 git"
+        print_warning "请先安装 git 或选择从 npm 安装"
+        exit 1
+    fi
+    
+    # 克隆仓库
+    print_info "正在克隆仓库..."
+    
+    if [ -d "$INSTALL_DIR" ]; then
+        print_warning "安装目录已存在: $INSTALL_DIR"
+        read -p "是否删除并重新克隆？(y/n) " -n 1 -r
+        echo
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            rm -rf "$INSTALL_DIR"
+        else
+            print_error "取消安装"
+            exit 1
+        fi
+    fi
+    
+    if git clone "$REPO_URL" "$INSTALL_DIR"; then
+        print_success "仓库克隆成功"
+        PROJECT_DIR="$INSTALL_DIR"
+        cd "$INSTALL_DIR"
+    else
+        print_error "仓库克隆失败"
+        print_warning "请检查网络连接或仓库地址"
+        exit 1
+    fi
+}
+
+# 检查系统要求
+check_requirements() {
+    print_header "检查系统要求"
+    
+    local has_error=0
+    
+    # 检查 Node.js
+    print_info "检查 Node.js..."
+    if ! command_exists node; then
+        print_error "未找到 Node.js"
+        print_warning "请访问 https://nodejs.org/ 下载安装 Node.js >= 18.0.0"
+        has_error=1
+    else
+        local node_version=$(get_node_version)
+        print_success "已安装 Node.js v${node_version}"
+        
+        if version_ge "$node_version" "18.0.0"; then
+            print_success "Node.js 版本符合要求 (>= 18.0.0)"
+        else
+            print_error "Node.js 版本过低 (需要 >= 18.0.0)"
+            print_warning "请升级 Node.js 到 18.0.0 或更高版本"
+            has_error=1
+        fi
+    fi
+    
+    # 检查 npm
+    print_info "检查 npm..."
+    if ! command_exists npm; then
+        print_error "未找到 npm"
+        print_warning "npm 通常随 Node.js 一起安装"
+        has_error=1
+    else
+        local npm_version=$(npm -v)
+        print_success "已安装 npm v${npm_version}"
+    fi
+    
+    # 检查 git（可选）
+    print_info "检查 git..."
+    if ! command_exists git; then
+        print_warning "未找到 git（可选，用于版本控制）"
+    else
+        local git_version=$(git --version | awk '{print $3}')
+        print_success "已安装 git v${git_version}"
+    fi
+    
+    echo ""
+    
+    if [ $has_error -eq 1 ]; then
+        print_error "系统要求检查失败"
+        exit 1
+    fi
+    
+    print_success "系统要求检查通过"
+}
+
+# 安装依赖
+install_dependencies() {
+    # 如果是通过 npm 安装的，跳过
+    if [ "${NPM_INSTALL:-false}" = "true" ]; then
+        return
+    fi
+    
+    print_header "安装依赖"
+    
+    print_info "正在安装 npm 依赖包..."
+    
+    if npm install; then
+        print_success "依赖包安装成功"
+    else
+        print_error "依赖包安装失败"
+        print_warning "请检查网络连接或尝试手动运行: npm install"
+        exit 1
+    fi
+}
+
+# 构建项目
+build_project() {
+    # 如果是通过 npm 安装的，跳过
+    if [ "${NPM_INSTALL:-false}" = "true" ]; then
+        return
+    fi
+    
+    print_header "构建项目"
+    
+    print_info "正在编译 TypeScript 代码..."
+    
+    if npm run build; then
+        print_success "项目构建成功"
+    else
+        print_error "项目构建失败"
+        print_warning "请检查是否有编译错误或尝试手动运行: npm run build"
+        exit 1
+    fi
+}
+
+# 全局链接
+link_globally() {
+    # 如果是通过 npm 安装的，跳过
+    if [ "${NPM_INSTALL:-false}" = "true" ]; then
+        print_success "已通过 npm 全局安装"
+        return
+    fi
+    
+    print_header "全局链接"
+    
+    print_info "正在将 needware-cli 链接到全局..."
+    
+    if npm link; then
+        print_success "全局链接成功"
+        print_info "现在可以在任何地方使用 'needware-cli' 命令"
+    else
+        print_error "全局链接失败"
+        print_warning "您可能需要 sudo 权限: sudo npm link"
+        print_warning "或者手动运行: npm link"
+        
+        # 询问是否使用 sudo 重试
+        read -p "是否使用 sudo 重试？(y/n) " -n 1 -r
+        echo
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            if sudo npm link; then
+                print_success "使用 sudo 全局链接成功"
+            else
+                print_error "全局链接仍然失败"
+                exit 1
+            fi
+        else
+            print_warning "跳过全局链接，您需要手动运行: npm link 或 sudo npm link"
+        fi
+    fi
+}
+
+# 运行测试（可选）
+run_tests() {
+    # 如果是通过 npm 安装的，跳过
+    if [ "${NPM_INSTALL:-false}" = "true" ]; then
+        return
+    fi
+    
+    print_header "运行测试"
+    
+    read -p "是否运行测试？(y/n) " -n 1 -r
+    echo
+    
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        print_info "正在运行测试..."
+        
+        if npm test; then
+            print_success "所有测试通过"
+        else
+            print_warning "部分测试失败，但不影响使用"
+        fi
+    else
+        print_info "跳过测试"
+    fi
+}
+
+# 初始化配置
+init_config() {
+    print_header "初始化配置"
+    
+    read -p "是否初始化配置？(y/n) " -n 1 -r
+    echo
+    
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        print_info "正在初始化配置..."
+        
+        # 检查是否使用默认配置
+        read -p "使用默认配置？(y/n) " -n 1 -r
+        echo
+        
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            if needware-cli init --default; then
+                print_success "配置初始化成功（使用默认值）"
+            else
+                print_warning "配置初始化失败，您可以稍后运行: needware-cli init"
+            fi
+        else
+            print_info "启动交互式配置..."
+            if needware-cli init; then
+                print_success "配置初始化成功"
+            else
+                print_warning "配置初始化失败，您可以稍后运行: needware-cli init"
+            fi
+        fi
+    else
+        print_info "跳过配置初始化"
+        print_warning "您可以稍后运行: needware-cli init"
+    fi
+}
+
+# 显示安装信息
+show_installation_info() {
+    print_header "安装完成"
+    
+    print_success "Needware CLI 已成功安装！"
+    echo ""
+    
+    echo -e "${BLUE}📚 快速开始:${NC}"
+    echo ""
+    echo "  1. 查看帮助:"
+    echo -e "     ${GREEN}needware-cli --help${NC}"
+    echo ""
+    echo "  2. 初始化配置（如果还没有）:"
+    echo -e "     ${GREEN}needware-cli init${NC}"
+    echo ""
+    echo "  3. 查看所有配置:"
+    echo -e "     ${GREEN}needware-cli config list${NC}"
+    echo ""
+    echo "  4. 配置 Agent 命令（AI 助手）:"
+    echo -e "     ${GREEN}export ANTHROPIC_API_KEY=your_api_key${NC}"
+    echo -e "     ${GREEN}needware-cli agent \"创建一个待办事项应用\"${NC}"
+    echo ""
+    echo "  5. 交互式 Agent 模式:"
+    echo -e "     ${GREEN}needware-cli agent -i${NC}"
+    echo ""
+    
+    echo -e "${BLUE}📖 文档:${NC}"
+    echo "  - README.md           - 完整使用说明"
+    echo "  - QUICK_START.md      - 快速开始指南"
+    echo "  - ARCHITECTURE.md     - 架构设计文档"
+    echo "  - docs/AGENT_COMMAND.md - Agent 命令详细文档"
+    echo "  - docs/INTERACTIVE_MODE.md - 交互式模式说明"
+    echo ""
+    
+    echo -e "${BLUE}🔧 配置文件位置:${NC}"
+    echo "  ~/.needware/config.json"
+    echo ""
+    
+    echo -e "${BLUE}📝 日志文件位置:${NC}"
+    echo "  ~/.needware/logs/cli.log"
+    echo ""
+    
+    echo -e "${BLUE}💡 提示:${NC}"
+    echo "  - 使用 --verbose 选项查看详细输出"
+    echo "  - 使用 --help 查看任何命令的帮助信息"
+    echo "  - 使用 needware-cli config path 查看配置文件路径"
+    echo ""
+    
+    echo -e "${GREEN}感谢使用 Needware CLI！${NC}"
+    echo ""
+}
+
+# 显示使用统计（可选）
+show_stats() {
+    # 如果是通过 npm 安装的，跳过
+    if [ "${NPM_INSTALL:-false}" = "true" ]; then
+        return
+    fi
+    
+    if [ -f "package.json" ]; then
+        local deps_count=$(node -e "console.log(Object.keys(require('./package.json').dependencies || {}).length)" 2>/dev/null || echo "0")
+        local dev_deps_count=$(node -e "console.log(Object.keys(require('./package.json').devDependencies || {}).length)" 2>/dev/null || echo "0")
+        
+        echo -e "${BLUE}📊 项目统计:${NC}"
+        echo "  - 生产依赖: ${deps_count} 个"
+        echo "  - 开发依赖: ${dev_deps_count} 个"
+        
+        if [ -d "dist" ]; then
+            local dist_files=$(find dist -type f | wc -l | tr -d ' ')
+            echo "  - 构建文件: ${dist_files} 个"
+        fi
+        
+        echo ""
+    fi
+}
+
+# 错误处理
+handle_error() {
+    print_error "安装过程中发生错误"
+    echo ""
+    echo -e "${YELLOW}故障排除建议:${NC}"
+    echo "  1. 检查 Node.js 版本: node -v"
+    echo "  2. 清理并重试: rm -rf node_modules dist && npm install"
+    echo "  3. 手动构建: npm run build"
+    echo "  4. 查看日志: ~/.needware/logs/cli.log"
+    echo "  5. 查阅文档: README.md 或 docs/TROUBLESHOOTING.md"
+    echo ""
+    exit 1
+}
+
+# 清理函数（仅用于远程安装失败时）
+cleanup_on_error() {
+    if [ "$INSTALL_MODE" = "remote" ] && [ -d "$INSTALL_DIR" ]; then
+        print_warning "清理安装目录: $INSTALL_DIR"
+        rm -rf "$INSTALL_DIR"
+    fi
+}
+
+# 主函数
+main() {
+    # 设置错误处理
+    trap handle_error ERR
+    
+    # 检测安装模式
+    detect_install_mode
+    
+    # 显示欢迎信息
+    show_welcome
+    
+    # 检查系统要求
+    check_requirements
+    
+    # 如果是远程模式，选择安装方式
+    if [ "$INSTALL_MODE" = "remote" ]; then
+        choose_install_method
+    fi
+    
+    # 安装依赖
+    install_dependencies
+    
+    # 构建项目
+    build_project
+    
+    # 全局链接
+    link_globally
+    
+    # 运行测试（可选）
+    run_tests
+    
+    # 初始化配置（可选）
+    init_config
+    
+    # 显示统计信息
+    show_stats
+    
+    # 显示安装信息
+    show_installation_info
+}
+
+# 运行主函数
+main

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "needware-cli",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "一个功能强大的 Node.js 命令行工具",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
     "lint:fix": "eslint 'src/**/*.ts' --fix",
     "format": "prettier --write 'src/**/*.ts'",
     "prepare": "husky install",
-    "prepublishOnly": "npm run lint && npm test && npm run build",
+    "prepublishOnly": "npm run lint && npm run build",
     "diagnose:container": "bash scripts/fix-container-permissions.sh"
   },
   "keywords": [

package/test-multimodal.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+
+# 多模态消息测试脚本
+# 用于测试 needware-cli 的多模态消息支持
+
+echo "======================================"
+echo "多模态消息支持测试"
+echo "======================================"
+echo ""
+
+# 检查是否提供了 API Key
+if [ -z "$1" ]; then
+  echo "❌ 错误：请提供 API Key"
+  echo ""
+  echo "使用方法："
+  echo "  ./test-multimodal.sh YOUR_API_KEY [BASE_URL]"
+  echo ""
+  echo "示例："
+  echo "  ./test-multimodal.sh sk-ant-xxx https://api.openai-proxy.org/anthropic"
+  exit 1
+fi
+
+API_KEY="$1"
+BASE_URL="${2:-}"
+
+echo "✓ API Key: ${API_KEY:0:10}..."
+if [ -n "$BASE_URL" ]; then
+  echo "✓ Base URL: $BASE_URL"
+fi
+echo ""
+
+# 编译项目
+echo "📦 编译项目..."
+npm run build
+if [ $? -ne 0 ]; then
+  echo "❌ 编译失败"
+  exit 1
+fi
+echo "✓ 编译成功"
+echo ""
+
+# 测试 1：使用示例文件
+echo "======================================"
+echo "测试 1: 从文件读取多模态消息"
+echo "======================================"
+echo ""
+echo "命令："
+if [ -n "$BASE_URL" ]; then
+  echo "  needware-cli agent examples/multimodal-message-example.json --api-key $API_KEY --base-url $BASE_URL"
+  echo ""
+  node bin/cli.js agent examples/multimodal-message-example.json --api-key "$API_KEY" --base-url "$BASE_URL"
+else
+  echo "  needware-cli agent examples/multimodal-message-example.json --api-key $API_KEY"
+  echo ""
+  node bin/cli.js agent examples/multimodal-message-example.json --api-key "$API_KEY"
+fi
+
+echo ""
+echo "======================================"
+echo "测试完成"
+echo "======================================"
+echo ""
+echo "💡 提示："
+echo "  - 如果看到 Agent 开始处理消息，说明功能正常"
+echo "  - 多模态消息会自动使用交互式模式"
+echo "  - 更多使用示例请查看 EXAMPLES.md"
+echo ""
+