name: "install-python-package"
command: "/bin/bash"
args:
  - "-c"
  - |
      set -euo pipefail

      PACKAGE="$1"
      ENV_NAME="${2:-default}"
      ADDITIONAL_ARGS="${3:-}"

      BASE_DIR="${HOME}/.cyberstrike/venvs"
      ENV_DIR="${BASE_DIR}/${ENV_NAME}"

      mkdir -p "$BASE_DIR"
      if [ ! -d "$ENV_DIR" ]; then
        python3 -m venv "$ENV_DIR"
      fi

      # shellcheck disable=SC1090
      source "$ENV_DIR/bin/activate"

      if [ -n "$ADDITIONAL_ARGS" ]; then
        pip install "$PACKAGE" $ADDITIONAL_ARGS
      else
        pip install "$PACKAGE"
      fi
  - "_"
enabled: true
short_description: "在指定虚拟环境中创建/激活并安装Python依赖"
description: |
  在虚拟环境中安装Python包。

  **主要功能：**
  - 安装Python包
  - 虚拟环境支持
  - 依赖管理

  **使用场景：**
  - 环境配置
  - 依赖安装
  - 工具安装
parameters:
  - name: "package"
    type: "string"
    description: "要安装的Python包名"
    required: true
    position: 0
    format: "positional"
  - name: "env_name"
    type: "string"
    description: "虚拟环境名称（默认default）"
    required: false
    default: "default"
    position: 1
    format: "positional"
  - name: "additional_args"
    type: "string"
    description: |
      额外的install-python-package参数。用于传递未在参数列表中定义的install-python-package选项。

      **示例值：**
      - 根据工具特性添加常用参数示例

      **注意事项：**
      - 多个参数用空格分隔
      - 确保参数格式正确，避免命令注入
      - 此参数会直接追加到命令末尾
    required: false
    format: "positional"
    default: ""