acquisition-dependencies

name	acquisition-dependencies
version	2.0.0
description	红龙获客系统依赖安装技能 v2.0 - 跨平台自动检测+安装。自动识别 Linux/Windows/macOS 环境，安装所有 Python/npm 系统依赖。触发：安装依赖、更新依赖、补全依赖、一键安装依赖。
triggers	["安装依赖","更新依赖","补全依赖","安装依赖包","修复依赖","一键安装依赖","初始化环境"]

红龙获客系统 · 依赖安装技能 v2.0

Skill Graph： 领域 → [[_index-meta|系统元技能领域]] | 上游 ← [[_index-acquisition|核心流程领域]] | 下游 → [[acquisition-init|系统初始化]]（依赖安装后）

功能

自动检测当前系统环境（Linux/Windows/macOS/WSL2），根据检测结果安装所有必需的 Python 和 npm 依赖。

一键安装

# Linux/macOS/WSL2
bash ~/.hermes/skills/acquisition/acquisition-dependencies/scripts/install-deps.sh

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.hermes\skills\acquisition\acquisition-dependencies\scripts\install-deps.ps1"

离线环境下直接运行本地脚本即可（脚本已安装在 skills/ 目录内，无需联网）。

环境检测逻辑

检测顺序：
  1. uname -s  → 判断 Linux/Darwin/NT
  2. /proc/version → 判断 WSL2
  3. command -v node/npm/python3 → 判断已安装的工具

检测结果	系统类型	安装方式
Linux + /proc/version含microsoft	WSL2	apt-get + node symlink修复
Linux + 无WSL特征	Debian/Ubuntu	apt-get
Darwin	macOS	brew
NT/CYGWIN/MINGW	Windows	PowerShell + pip

陷阱记录

• 不要依赖远程curl安装：GitHubraw可能不通，脚本必须已在本地 skills/ 目录内
• WSL2 node路径问题：WSL2下node可能在~/.nvm/，需要symlink到/usr/bin/否则子进程找不到
• pip3 --user vs sudo apt：apt的python包版本可能旧，pip3 --user补充安装确保最新版
• Playwright Chromium体积大：180MB，首次安装用tail -5避免长时间无输出
• patch误删风险：修改RETAINED_SKILLS清单时易漏掉整块技能组（如CRM/工具层），修复后需重新验证清单数量与目录一致

依赖清单

Python 依赖（所有平台）

包名	用途	验证命令
openpyxl	Excel读写	python3 -c "import openpyxl"
docx	Word读写	python3 -c "import docx"
yaml	YAML解析	python3 -c "import yaml"
Pillow	图片处理	python3 -c "from PIL import Image"
requests	HTTP请求	python3 -c "import requests"
regex	正则增强	python3 -c "import regex"
lxml	XML/HTML解析	python3 -c "import lxml"
playwright	浏览器自动化	python3 -c "from playwright.sync_api import sync_playwright"

Node.js 依赖（所有平台）

包名	用途	验证命令
nodemailer	邮件发送	node -e "require('nodemailer')"

浏览器（可选）

浏览器	用途	安装命令
Chromium	Playwright主力	python3 -m playwright install chromium
Chrome	备用	python3 -m playwright install chrome

安装脚本

Linux/macOS: install-deps.sh

#!/usr/bin/env bash
# =============================================================
# 红龙获客系统 · 依赖安装脚本 (Linux/macOS/WSL2)
# 版本: 2.0.0 | 自动检测系统环境
# =============================================================

set -euo pipefail

# --- 颜色输出 ---
RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
CYAN='\033[0;36m'; BOLD='\033[1m'; NC='\033[0m'

log()  { echo -e "${CYAN}[$(date '+%H:%M:%S')]${NC} $*"; }
ok()   { echo -e "${GREEN}  ✓${NC}  $*"; }
warn() { echo -e "${YELLOW}  ⚠${NC}  $*"; }
fail() { echo -e "${RED}  ✗${NC}  $*"; }

# --- 环境检测 ---
detect_os() {
    local os_type
    case "$(uname -s)" in
        Linux*)     os_type="linux" ;;
        Darwin*)    os_type="macos" ;;
        CYGWIN*|MINGW*|MSYS*|NT*) os_type="windows" ;;
        *)          os_type="unknown" ;;
    esac

    
     [[  ==  ]] && grep -qi  /proc/version 2>/dev/null; 
        os_type=
    

     
}

() {
      -v node &>/dev/null; 
         
    
         
    

      -v npm &>/dev/null; 
         
    
         
    

      -v python3 &>/dev/null; 
         
      -v python &>/dev/null; 
         
    
         
    
}


() {
    python3 -c  2>/dev/null
}

() {
    node -e  2>/dev/null
}


() {
     

      -v apt-get &>/dev/null; 
         
         apt-get update -qq

         pkgs=(
            python3-pip
            python3-openpyxl
            python3-docx
            python3-yaml
            python3-pil
            python3-requests
            python3-regex
            python3-lxml
        )

         
         apt-get install -y  2>&1 |  -5
        ok 
    
        warn 
    

    
     
    pip3 install --quiet --user openpyxl docx pyyaml Pillow requests regex lxml 2>&1 |  -3
    ok 
}

() {
     

     !  -v brew &>/dev/null; 
        fail 
         1
    

     
    brew install python3 node
    brew install python3-openpyxl python3-docx python3-yaml python3-pillow 2>/dev/null || 
    ok 
}

() {
     

     python_pkgs=
     failed=()

     pkg  ; 
         python3 -c  2>/dev/null; 
             -n 
        
             pip3 install --quiet --user  2>/dev/null; 
                ok 
            
                fail 
                failed+=()
            
        
    

    
     python3 -c  2>/dev/null; 
        ok 
    
         
        pip3 install --quiet playwright 2>&1 |  -2
        python3 -m playwright install chromium --with-deps 2>&1 |  -5
        ok 
    

     [[  -gt 0 ]]; 
        warn 
         1
    
     0
}

() {
     

     !  -v npm &>/dev/null; 
        warn 
         0
    

     npm_pkgs=
     failed=()

     pkg  ; 
         node -e  2>/dev/null; 
            ok 
        
             npm install -g  2>/dev/null; 
                ok 
            
                fail 
                failed+=()
            
        
    

     [[  -gt 0 ]]; 
        warn 
    
}

() {
     

    
     node_path
     [[ -d  ]]; 
         node_version
        node_version=$(  |  -1)
         [[ -n  ]]; 
             nvm_node=
             nvm_npm=

             [[ ! -L /usr/bin/node ]] && [[ -f  ]]; 
                  -sf  /usr/bin/node
                  -sf  /usr/bin/npm
                ok 
            
        
    
}

() {
     

     failed=0

    
     py_pkgs=
     pkg  ; 
         import_name=
         python3 -c  2>/dev/null; 
            ok 
        
            fail 
            ((failed++))
        
    

    
     python3 -c  2>/dev/null; 
        ok 
    
        fail 
        ((failed++))
    

    
     node -e  2>/dev/null; 
        ok 
    
        warn 
    

     
}


() {
     
     
     
     
     

    
     os_type
    os_type=$(detect_os)
     
    detect_node |   -r line; 
         
    
     
     

    
      
        linux|wsl2)
            install_linux
             [[  ==  ]]; 
                install_wsl2_extras
            
            ;;
        macos)
            install_macos
            ;;
        windows)
            fail 
             1
            ;;
        *)
            fail 
             1
            ;;
    

    
    install_python_deps

    
    install_npm_deps

    
     
     verify_all; 
         
        ok 
         
    
         
        warn 
         1
    
}

main 

---

详细参考

以下内容已拆分到 [[references/windows-install.md]]，仅在需要时读取：

• acquisition-init 集成
• 版本历史

Windows PowerShell 安装脚本、集成说明和版本历史。