Initial commit

2026-06-06 05:21:10 +00:00
commit 6664758a6d
493 changed files with 135653 additions and 0 deletions
--- a/skills/xlsx/setup.sh
+++ b/skills/xlsx/setup.sh
@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# ---
+# name: xlsx-setup
+# author: Z.AI
+# version: "1.0"
+# description: Environment setup for the XLSX skill. Checks and installs all required dependencies.
+# ---
+#
+# Installs only dependencies required by the XLSX skill.
+set -euo pipefail
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m'
+ok() { echo -e "  ${GREEN}✓${NC} $1"; }
+fail() { echo -e "  ${RED}✗${NC} $1"; }
+warn() { echo -e "  ${YELLOW}○${NC} $1"; }
+info() { echo -e "  ${BLUE}→${NC} $1"; }
+
+echo "============================================"
+echo "  XLSX Skill — Environment Setup"
+echo "============================================"
+echo ""
+
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+echo "Platform: $OS $ARCH"
+echo ""
+
+# ── 0. macOS: Homebrew ──
+if [ "$OS" = "Darwin" ]; then
+    echo "--- Homebrew (macOS package manager) ---"
+    if command -v brew &>/dev/null; then
+        BREW_VER=$(brew --version 2>/dev/null | head -1)
+        ok "brew ($BREW_VER)"
+    else
+        fail "brew not found — some optional dependencies need Homebrew on macOS"
+        info "Install: /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+    fi
+    echo ""
+fi
+
+# ── 1. Python 3 ──
+echo "--- Python ---"
+if command -v python3 &>/dev/null; then
+    PY_VER=$(python3 --version 2>&1)
+    ok "python3 ($PY_VER)"
+    if [ "$OS" = "Darwin" ]; then
+        PY_PATH=$(which python3 2>/dev/null)
+        if [[ "$PY_PATH" == "/usr/bin/python3" ]]; then
+            warn "Using macOS system Python (limited). Recommend: brew install python3"
+        fi
+    fi
+else
+    fail "python3 not found"
+    case "$OS" in
+        Darwin) info "Install: brew install python3" ;;
+        Linux)  info "Install: sudo apt install python3 python3-pip  (Debian/Ubuntu)"
+                info "         sudo dnf install python3 python3-pip  (Fedora/RHEL)" ;;
+        *)      info "Install: https://www.python.org/downloads/" ;;
+    esac
+fi
+
+# ── 2. pip ──
+echo ""
+echo "--- pip ---"
+if python3 -m pip --version &>/dev/null 2>&1; then
+    PIP_VER=$(python3 -m pip --version 2>/dev/null | head -1)
+    ok "pip ($PIP_VER)"
+else
+    fail "pip not found"
+    case "$OS" in
+        Darwin) info "Install: python3 -m ensurepip --upgrade"
+                info "     or: brew install python3 (includes pip)" ;;
+        Linux)  info "Install: sudo apt install python3-pip  (Debian/Ubuntu)" ;;
+        *)      info "Install: python3 -m ensurepip --upgrade" ;;
+    esac
+fi
+
+# ── 3. Python packages ──
+echo ""
+echo "--- Python Packages ---"
+PY_PKGS=(
+    "openpyxl:openpyxl"
+    "xlsxwriter:XlsxWriter"
+)
+
+MISSING_PY=()
+for entry in "${PY_PKGS[@]}"; do
+    mod="${entry%%:*}"
+    pkg="${entry##*:}"
+    if python3 -c "import $mod" 2>/dev/null; then
+        ver=$(python3 -c "import $mod; print(getattr($mod, '__version__', 'installed'))" 2>/dev/null)
+        ok "$pkg ($ver)"
+    else
+        fail "$pkg not installed"
+        MISSING_PY+=("$pkg")
+    fi
+done
+
+if [ ${#MISSING_PY[@]} -gt 0 ]; then
+    echo ""
+    if [ -t 0 ]; then
+        read -p "  Install missing Python packages? [Y/n] " -n 1 -r REPLY
+        echo ""
+        REPLY=${REPLY:-Y}
+    else
+        warn "Non-interactive mode — skipping auto-install. Run interactively or install manually."
+        REPLY=N
+    fi
+    if [[ ! $REPLY =~ ^[Nn]$ ]]; then
+        python3 -m pip install -q "${MISSING_PY[@]}" 2>/dev/null \
+            || python3 -m pip install -q --user "${MISSING_PY[@]}" 2>/dev/null \
+            || python3 -m pip install -q --break-system-packages "${MISSING_PY[@]}" 2>/dev/null \
+            || { fail "pip install failed. Try manually: pip install ${MISSING_PY[*]}"; }
+        ok "Installed: ${MISSING_PY[*]}"
+    fi
+fi
+
+# ── 4. LibreOffice (optional, for format conversion) ──
+echo ""
+echo "--- LibreOffice (optional, for CSV/PDF conversion) ---"
+if command -v soffice &>/dev/null; then
+    LO_VER=$(soffice --version 2>/dev/null | head -1)
+    ok "libreoffice ($LO_VER)"
+else
+    warn "libreoffice not installed (needed only for .xlsx→PDF or .csv→.xlsx conversion)"
+    case "$OS" in
+        Darwin) info "Install: brew install --cask libreoffice" ;;
+        Linux)  info "Install: sudo apt install libreoffice-core  (Debian/Ubuntu)" ;;
+    esac
+fi
+
+# ── Summary ──
+echo ""
+echo "============================================"
+echo "  Setup complete."
+echo "============================================"