wike-chi 红龙获客系统 · 依赖安装技能 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
# 检测 WSL2
if [[ "$os_type" == "linux" ]] && grep -qi 'microsoft\|wsl' /proc/version 2>/dev/null; then
os_type="wsl2"
fi
echo "$os_type"
}
detect_node() {
if command -v node &>/dev/null; then
echo "node: $(node --version)"
else
echo "node: NOT FOUND"
fi
if command -v npm &>/dev/null; then
echo "npm: $(npm --version)"
else
echo "npm: NOT FOUND"
fi
if command -v python3 &>/dev/null; then
echo "python3: $(python3 --version 2>&1)"
elif command -v python &>/dev/null; then
echo "python: $(python --version 2>&1)"
else
echo "python3: NOT FOUND"
fi
}
# --- 检查依赖是否已安装 ---
check_python_pkg() {
python3 -c "import $1" 2>/dev/null
}
check_npm_pkg() {
node -e "require('$1')" 2>/dev/null
}
# --- 安装函数 ---
install_linux() {
log "${BOLD}==> Linux/WSL2 环境${NC}"
if command -v apt-get &>/dev/null; then
log "检测到 apt 包管理器"
sudo apt-get update -qq
local pkgs=(
python3-pip
python3-openpyxl
python3-docx
python3-yaml
python3-pil
python3-requests
python3-regex
python3-lxml
)
log "安装 Python 系统包..."
sudo apt-get install -y "${pkgs[@]}" 2>&1 | tail -5
ok "系统包安装完成"
else
warn "apt 不可用，尝试 pip3 直接安装..."
fi
# pip3 补充安装（确保最新版本）
log "使用 pip3 补充/升级包..."
pip3 install --quiet --user openpyxl docx pyyaml Pillow requests regex lxml 2>&1 | tail -3
ok "pip3 安装完成"
}
install_macos() {
log "${BOLD}==> macOS 环境${NC}"
if ! command -v brew &>/dev/null; then
fail "Homebrew 未安装，请先安装: /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
return 1
fi
log "安装 Homebrew 包..."
brew install python3 node
brew install python3-openpyxl python3-docx python3-yaml python3-pillow 2>/dev/null || true
ok "Homebrew 安装完成"
}
install_python_deps() {
log "${BOLD}==> 安装 Python 依赖${NC}"
local python_pkgs="openpyxl docx pyyaml Pillow requests regex lxml"
local failed=()
for pkg in $python_pkgs; do
if python3 -c "import ${pkg%%:*}" 2>/dev/null; then
echo -n ""
else
if pip3 install --quiet --user "$pkg" 2>/dev/null; then
ok "$pkg"
else
fail "$pkg 安装失败"
failed+=("$pkg")
fi
fi
done
# Playwright
if python3 -c "from playwright.sync_api import sync_playwright" 2>/dev/null; then
ok "playwright 已安装"
else
log "安装 Playwright..."
pip3 install --quiet playwright 2>&1 | tail -2
python3 -m playwright install chromium --with-deps 2>&1 | tail -5
ok "playwright + chromium 安装完成"
fi
if [[ ${#failed[@]} -gt 0 ]]; then
warn "以下包安装失败: ${failed[*]}"
return 1
fi
return 0
}
install_npm_deps() {
log "${BOLD}==> 安装 Node.js 依赖${NC}"
if ! command -v npm &>/dev/null; then
warn "npm 未安装，跳过 Node.js 依赖"
return 0
fi
local npm_pkgs="nodemailer"
local failed=()
for pkg in $npm_pkgs; do
if node -e "require('$pkg')" 2>/dev/null; then
ok "$pkg 已安装"
else
if npm install -g "$pkg" 2>/dev/null; then
ok "$pkg"
else
fail "$pkg 安装失败"
failed+=("$pkg")
fi
fi
done
if [[ ${#failed[@]} -gt 0 ]]; then
warn "以下包安装失败: ${failed[*]}"
fi
}
install_wsl2_extras() {
log "${BOLD}==> WSL2 特殊处理${NC}"
# WSL2 下确保 node path 正确
local node_path
if [[ -d "$HOME/.nvm/versions/node" ]]; then
local node_version
node_version=$(ls "$HOME/.nvm/versions/node" | head -1)
if [[ -n "$node_version" ]]; then
local nvm_node="$HOME/.nvm/versions/node/$node_version/bin/node"
local nvm_npm="$HOME/.nvm/versions/node/$node_version/bin/npm"
if [[ ! -L /usr/bin/node ]] && [[ -f "$nvm_node" ]]; then
sudo ln -sf "$nvm_node" /usr/bin/node
sudo ln -sf "$nvm_npm" /usr/bin/npm
ok "node/npm symlink 已创建 → $node_version"
fi
fi
fi
}
verify_all() {
log "${BOLD}==> 验证安装${NC}"
local failed=0
# Python
local py_pkgs="openpyxl docx yaml PIL requests regex lxml"
for pkg in $py_pkgs; do
local import_name="${pkg%%:*}"
if python3 -c "import $import_name" 2>/dev/null; then
ok "python: $pkg"
else
fail "python: $pkg MISSING"
((failed++))
fi
done
# Playwright
if python3 -c "from playwright.sync_api import sync_playwright" 2>/dev/null; then
ok "python: playwright"
else
fail "python: playwright MISSING"
((failed++))
fi
# Node
if node -e "require('nodemailer')" 2>/dev/null; then
ok "node: nodemailer"
else
warn "node: nodemailer 未安装 (可选)"
fi
return $failed
}
# --- 主流程 ---
main() {
echo ""
echo "═══════════════════════════════════════════════════"
echo " 红龙获客系统 · 依赖安装 v2.0"
echo "═══════════════════════════════════════════════════"
echo ""
# 1. 环境检测
local os_type
os_type=$(detect_os)
log "系统检测:"
detect_node | while read -r line; do
echo " $line"
done
echo " OS类型: $os_type"
echo ""
# 2. 根据系统安装
case "$os_type" in
linux|wsl2)
install_linux
if [[ "$os_type" == "wsl2" ]]; then
install_wsl2_extras
fi
;;
macos)
install_macos
;;
windows)
fail "Windows 原生环境请使用 PowerShell 脚本: install-deps.ps1"
return 1
;;
*)
fail "无法识别的系统: $(uname -a)"
return 1
;;
esac
# 3. Python + Playwright（所有环境）
install_python_deps
# 4. npm（所有环境）
install_npm_deps
# 5. 验证
echo ""
if verify_all; then
echo ""
ok "全部依赖安装成功！"
echo ""
else
echo ""
warn "部分依赖安装失败，请参考上方错误信息"
return 1
fi
}
main "$@"
详细参考
以下内容已拆分到 [[references/windows-install.md]]，仅在需要时读取：
- acquisition-init 集成
- 版本历史
Windows PowerShell 安装脚本、集成说明和版本历史。