siluzan-tso-cli 1.1.9-beta.3 → 1.1.11-beta.2

package/README.md

@@ -49,7 +49,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.9-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.11-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手 | 建议 `--ai` |
 |------|-------------|

package/dist/skill/SKILL.md

@@ -14,6 +14,14 @@ allowed-tools: Bash(siluzan-tso:*) Read
 
 ---
 
+## 一键安装
+
+如果 CLI 尚未安装，直接帮用户执行对应平台的安装脚本：
+
+- **macOS / Linux / WSL：** `bash scripts/install.sh`
+- **Windows PowerShell：** `powershell -ExecutionPolicy Bypass -File scripts/install.ps1`
+
+脚本会自动完成 Node.js 检测/安装、CLI 安装、Skill 全局注册，并引导用户配置 API Key。无需选择，本脚本专为 siluzan-tso-cli 定制。
 
 ---
 
@@ -21,37 +29,12 @@ allowed-tools: Bash(siluzan-tso:*) Read
 
 使用本 Skill 前，以下组件必须已安装并就绪：
 
-### 必需二进制 / 运行时
-| 依赖 | 最低版本 | 用途 |
-|------|---------|------|
-| **Node.js** | 18+ | CLI 执行运行时以及 `node -e` 数据过滤 |
-| **npm** 或 **pnpm** | npm 8+ / pnpm 8+ | 安装 `siluzan-tso-cli` 全局包 |
-| **siluzan-tso** CLI | 与 Skill 同版本 | 所有业务操作的执行入口（由 `npm install -g siluzan-tso-cli` 安装） |
-
-### 凭据与配置文件
-| 项目 | 位置 | 说明 |
-|------|------|------|
-| API Key 或 Token | `~/.siluzan/config.json` 中的 `apiKey` 或 `token` 字段 | 用于所有 TSO API 调用的鉴权。API Key 在丝路赞控制台「个人设置 → API Key 管理」创建。**请勿将此文件提交到 Git。** |
-| tsoApiBaseUrl | `~/.siluzan/config.json` 中的 `apiBaseUrl` | TSO 后端 API 地址，默认 `https://tso-api.siluzan.com`（生产）或 `https://tso-api-ci.siluzan.com`（测试） |
-| googleApiUrl | `~/.siluzan/config.json` 中的 `googleApiUrl` | Google 广告 API 网关，默认 `https://googleapi.mysiluzan.com`（从 tsoApiBaseUrl 自动推导） |
-
-### 网络端点
-本 Skill 通过 CLI 访问以下远程服务：
-| 端点 | 用途 |
-|------|------|
-| `tso-api.siluzan.com` / `tso-api-ci.siluzan.com` | TSO 核心 API（账户、报告、预警、开票等） |
-| `googleapi.mysiluzan.com` / `googleapi-ci.mysiluzan.com` | Google Ads API 网关（广告 CRUD、关键词、地理定位） |
-| `www.siluzan.com` / `www-ci.siluzan.com` | 前端页面（充值/激活等需浏览器操作时引导用户打开） |
-| `o605862.ingest.us.sentry.io` | 错误追踪（Sentry，仅发送匿名崩溃日志，不含业务数据） |
-| `registry.npmjs.org` | 版本更新检查 |
-
 ### 可选环境变量
 | 变量 | 说明 |
 |------|------|
 | `SILUZAN_API_KEY` | 从环境变量读取 API Key（优先级高于 config.json，CI/CD 推荐） |
 | `SILUZAN_AUTH_TOKEN` | 从环境变量读取 JWT Token（优先级高于 config.json） |
 | `SILUZAN_DATA_PERMISSION` | 从环境变量读取数据权限标识（优先级高于 config.json，跳过自动拉取） |
-| `SILUZAN_GOOGLE_API` | 覆盖默认 Google API 网关地址 |
 
 如果上述依赖缺失，请先参照 `references/setup.md` 完成安装与配置。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.9-beta.3",
-  "publishedAt": 1776246707915
+  "version": "1.1.11-beta.2",
+  "publishedAt": 1776308245270
 }

package/dist/skill/scripts/install.ps1

@@ -0,0 +1,199 @@
+#Requires -Version 5.1
+# =============================================================================
+# siluzan-tso-cli - One-click install script (PowerShell)
+# Supported: Windows 10/11 (PowerShell 5.1+ or PowerShell 7+)
+# =============================================================================
+
+$ErrorActionPreference = 'Stop'
+
+# -- Package info (injected at build time) ------------------------------------
+$PKG_NAME        = 'siluzan-tso-cli'
+$CLI_BIN         = 'siluzan-tso'
+$SKILL_LABEL     = 'Siluzan TSO'
+$INSTALL_CMD     = 'npm install -g siluzan-tso-cli@beta'
+$PERMISSION_HINT = 'Assets + TSO (Ad Management)'
+$WEB_BASE        = 'https://www-ci.siluzan.com'
+$API_KEY_URL     = "$WEB_BASE/v3/foreign_trade/settings/apiKeyManagement"
+
+# -- Constants ----------------------------------------------------------------
+$NODE_MAJOR_MIN = 18
+$NPM_MIRROR     = 'https://registry.npmmirror.com'
+
+# -- Helpers ------------------------------------------------------------------
+function Write-Info  { param([string]$Msg) Write-Host "[OK] $Msg" -ForegroundColor Green }
+function Write-Warn  { param([string]$Msg) Write-Host "[!]  $Msg" -ForegroundColor Yellow }
+function Write-Err   { param([string]$Msg) Write-Host "[X]  $Msg" -ForegroundColor Red }
+function Write-Step  { param([string]$Msg) Write-Host "`n-- $Msg --" -ForegroundColor White }
+
+function Read-Input {
+    param([string]$Prompt)
+    Write-Host $Prompt -NoNewline
+    return [Console]::ReadLine()
+}
+
+function Refresh-Path {
+    $machinePath = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+    $userPath    = [Environment]::GetEnvironmentVariable('Path', 'User')
+    $env:Path    = "$machinePath;$userPath"
+}
+
+# -- Node.js ------------------------------------------------------------------
+function Test-NodeVersion {
+    try {
+        $nodeCmd = Get-Command node -ErrorAction SilentlyContinue
+        if (-not $nodeCmd) { return $false }
+        $ver = (node -v) -replace '^v', ''
+        $major = [int]($ver.Split('.')[0])
+        return $major -ge $NODE_MAJOR_MIN
+    } catch {
+        return $false
+    }
+}
+
+function Get-NodeVersionString {
+    try { return (node -v) } catch { return 'N/A' }
+}
+
+function Install-NodeJS {
+    $hasWinget = $null -ne (Get-Command winget -ErrorAction SilentlyContinue)
+    if ($hasWinget) {
+        Write-Info 'Installing Node.js LTS via winget...'
+        winget install -e --id OpenJS.NodeJS.LTS --silent --accept-package-agreements --accept-source-agreements
+        if ($LASTEXITCODE -ne 0) {
+            Write-Warn 'winget returned non-zero, trying fallback...'
+            Install-NodeFallback
+            return
+        }
+    } else {
+        Install-NodeFallback
+        return
+    }
+    Refresh-Path
+    if (-not (Test-NodeVersion)) {
+        Write-Warn 'Node.js not found after PATH refresh, locating install dir...'
+        $nodePath = "$env:ProgramFiles\nodejs"
+        if (Test-Path "$nodePath\node.exe") {
+            $env:Path = "$nodePath;$env:Path"
+        }
+    }
+}
+
+function Install-NodeFallback {
+    Write-Err 'Cannot auto-install Node.js'
+    Write-Host ''
+    Write-Host '  Please install Node.js manually:' -ForegroundColor Cyan
+    Write-Host '  https://nodejs.org/en/download/'
+    Write-Host ''
+    Write-Host '  After installation, reopen PowerShell and run this script again.'
+    throw 'Node.js is required'
+}
+
+# -- Main ---------------------------------------------------------------------
+function Main {
+    Write-Host ''
+    Write-Host '+---------------------------------------------+' -ForegroundColor White
+    Write-Host "|  $SKILL_LABEL -- Install                    |" -ForegroundColor White
+    Write-Host '+---------------------------------------------+' -ForegroundColor White
+    Write-Host ''
+
+    # Step 1: Environment check
+    Write-Step 'Step 1/4: Environment check'
+
+    if (Test-NodeVersion) {
+        Write-Info "Node.js $(Get-NodeVersionString) found"
+    } else {
+        $nodeCmd = Get-Command node -ErrorAction SilentlyContinue
+        if ($nodeCmd) {
+            Write-Warn "Node.js $(Get-NodeVersionString) is too old (need >= $NODE_MAJOR_MIN), upgrading..."
+        } else {
+            Write-Warn 'Node.js not found, installing...'
+        }
+        Install-NodeJS
+        if (-not (Test-NodeVersion)) {
+            Write-Err 'Node.js installation failed. Please install manually: https://nodejs.org/'
+            return
+        }
+        Write-Info "Node.js $(Get-NodeVersionString) installed"
+    }
+
+    $npmCmd = Get-Command npm -ErrorAction SilentlyContinue
+    if (-not $npmCmd) {
+        Refresh-Path
+        $npmCmd = Get-Command npm -ErrorAction SilentlyContinue
+    }
+    if (-not $npmCmd) {
+        Write-Err 'npm not found (Node.js installation may be incomplete)'
+        return
+    }
+    Write-Info 'npm ready'
+
+    $currentRegistry = ''
+    try { $currentRegistry = (npm config get registry 2>$null).Trim() } catch {}
+    if ($currentRegistry -ne $NPM_MIRROR -and $currentRegistry -ne "$NPM_MIRROR/") {
+        Write-Info 'Switching npm registry to China mirror for faster downloads...'
+        npm config set registry $NPM_MIRROR
+        Write-Info "npm registry set to $NPM_MIRROR"
+    } else {
+        Write-Info 'npm registry already set to China mirror'
+    }
+
+    # Step 2: Install CLI
+    Write-Step "Step 2/4: Install $PKG_NAME"
+
+    Write-Info "Running: $INSTALL_CMD"
+    Invoke-Expression $INSTALL_CMD
+    if ($LASTEXITCODE -ne 0) { Write-Err "$INSTALL_CMD failed"; return }
+    Write-Info "$PKG_NAME installed"
+
+    Write-Info 'Registering Skill to all AI platform global directories...'
+    Invoke-Expression "$CLI_BIN init --global --force"
+
+    # Step 3: Configure API Key
+    Write-Step 'Step 3/4: Configure API Key'
+    Write-Host ''
+    Write-Host '  Opening the API Key management page. In your browser:'
+    Write-Host '  1. Sign up / Log in to your Siluzan account'
+    Write-Host "  2. Click 'Create API Key'"
+    Write-Host "  3. Select permissions: $PERMISSION_HINT"
+    Write-Host '  4. Copy the generated API Key'
+    Write-Host ''
+
+    try {
+        Start-Process $API_KEY_URL
+        Write-Info 'API Key management page opened in browser'
+    } catch {
+        Write-Warn 'Could not open browser automatically. Please visit:'
+        Write-Host "  $API_KEY_URL" -ForegroundColor Cyan
+    }
+
+    Write-Host ''
+    $apiKey = Read-Input '  Paste API Key (press Enter to skip): '
+
+    if (-not [string]::IsNullOrWhiteSpace($apiKey)) {
+        Invoke-Expression "$CLI_BIN login --api-key $apiKey"
+        Write-Info 'API Key saved to ~/.siluzan/config.json'
+    } else {
+        Write-Host ''
+        Write-Warn 'API Key configuration skipped. You can set it later:'
+        Write-Host "  Option 1: $CLI_BIN login --api-key YOUR_API_KEY"
+        Write-Host '  Option 2: $env:SILUZAN_API_KEY = ''YOUR_API_KEY'''
+    }
+
+    # Step 4: Done
+    Write-Step 'Step 4/4: Complete'
+    Write-Host ''
+    Write-Host "  $SKILL_LABEL installed successfully!" -ForegroundColor Green
+    Write-Host ''
+    Write-Host '  Skill registered to these global directories (all AI assistants):'
+    Write-Host '  ~/.cursor/skills/  ~/.claude/skills/  ~/.agents/skills/' -ForegroundColor DarkGray
+    Write-Host '  ~/.gemini/skills/  ~/.codex/skills/   ~/.kilo/skills/' -ForegroundColor DarkGray
+    Write-Host '  ~/.codeium/windsurf/skills/  ~/.config/opencode/skills/' -ForegroundColor DarkGray
+    Write-Host '  ~/.openclaw/skills/  ~/.workbuddy/skills/' -ForegroundColor DarkGray
+    Write-Host ''
+    Write-Host "  Update CLI & Skill files: $CLI_BIN update"
+    Write-Host ''
+    Write-Info "Need help? Visit $WEB_BASE"
+    Write-Host ''
+}
+
+Main

package/dist/skill/scripts/install.sh

@@ -0,0 +1,214 @@
+#!/usr/bin/env bash
+# =============================================================================
+# siluzan-tso-cli - One-click install script
+# Supported: macOS, Linux, Windows (WSL)
+# =============================================================================
+
+set -euo pipefail
+
+# -- Package info (injected at build time) ------------------------------------
+readonly PKG_NAME="siluzan-tso-cli"
+readonly CLI_BIN="siluzan-tso"
+readonly SKILL_LABEL="Siluzan TSO"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
+readonly PERMISSION_HINT="Assets + TSO (Ad Management)"
+readonly WEB_BASE="https://www-ci.siluzan.com"
+readonly API_KEY_URL="${WEB_BASE}/v3/foreign_trade/settings/apiKeyManagement"
+
+# -- Constants ----------------------------------------------------------------
+readonly NODE_MAJOR_MIN=18
+readonly NPM_MIRROR="https://registry.npmmirror.com"
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+CYAN='\033[0;36m'; BOLD='\033[1m'; DIM='\033[2m'; NC='\033[0m'
+
+info()  { printf "${GREEN}[OK]${NC} %s\n" "$1"; }
+warn()  { printf "${YELLOW}[!]${NC} %s\n" "$1"; }
+error() { printf "${RED}[X]${NC} %s\n" "$1" >&2; }
+step()  { printf "\n${BOLD}-- %s --${NC}\n" "$1"; }
+
+# -- Detect OS ----------------------------------------------------------------
+detect_os() {
+  local uname_out
+  uname_out=$(uname -s 2>/dev/null || echo "Unknown")
+  case "$uname_out" in
+    Darwin*)  echo "macos" ;;
+    Linux*)   echo "linux" ;;
+    MINGW*|MSYS*|CYGWIN*) echo "gitbash" ;;
+    *)        echo "unknown" ;;
+  esac
+}
+
+# -- Open URL in browser ------------------------------------------------------
+open_url() {
+  local url="$1" os_type
+  os_type=$(detect_os)
+  case "$os_type" in
+    macos)   open "$url" 2>/dev/null && return 0 ;;
+    linux)   xdg-open "$url" 2>/dev/null && return 0 ;;
+    gitbash) start "$url" 2>/dev/null && return 0 ;;
+  esac
+  return 1
+}
+
+# -- Node.js ------------------------------------------------------------------
+node_version_ok() {
+  command -v node >/dev/null 2>&1 || return 1
+  local major
+  major=$(node -v | tr -d 'v' | cut -d. -f1)
+  [ "$major" -ge "$NODE_MAJOR_MIN" ]
+}
+
+install_node() {
+  local os_type
+  os_type=$(detect_os)
+  case "$os_type" in
+    macos)
+      if command -v brew >/dev/null 2>&1; then
+        info "Installing Node.js LTS via Homebrew..."
+        brew install node@22
+        brew link --overwrite node@22 2>/dev/null || true
+      else
+        info "Installing Node.js LTS via install-node.vercel.app..."
+        curl -fsSL https://install-node.vercel.app/lts | bash -s -- --yes
+      fi
+      ;;
+    linux)
+      if command -v apt-get >/dev/null 2>&1; then
+        info "Installing Node.js 22.x via NodeSource (apt)..."
+        curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+        sudo apt-get install -y nodejs
+      elif command -v yum >/dev/null 2>&1; then
+        info "Installing Node.js 22.x via NodeSource (yum)..."
+        curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo -E bash -
+        sudo yum install -y nodejs
+      else
+        info "Installing Node.js LTS via install-node.vercel.app..."
+        curl -fsSL https://install-node.vercel.app/lts | bash -s -- --yes
+      fi
+      ;;
+    gitbash)
+      error "Cannot auto-install Node.js in Git Bash. Please use the PowerShell script or install manually."
+      echo "  https://nodejs.org/en/download/"
+      exit 1
+      ;;
+    *)
+      error "Unsupported OS. Please install Node.js >= ${NODE_MAJOR_MIN} manually:"
+      echo "  https://nodejs.org/en/download/"
+      exit 1
+      ;;
+  esac
+
+  export PATH="$HOME/.local/bin:$HOME/.nodejs/bin:/usr/local/bin:$PATH"
+  hash -r 2>/dev/null || true
+
+  if ! node_version_ok; then
+    error "Node.js installation failed. Please install manually:"
+    echo "  https://nodejs.org/en/download/"
+    exit 1
+  fi
+}
+
+# -- Main ---------------------------------------------------------------------
+main() {
+  echo ""
+  echo -e "${BOLD}+---------------------------------------------+${NC}"
+  echo -e "${BOLD}|  ${SKILL_LABEL} -- Install                  |${NC}"
+  echo -e "${BOLD}+---------------------------------------------+${NC}"
+  echo ""
+
+  # Step 1: Environment check
+  step "Step 1/4: Environment check"
+
+  if node_version_ok; then
+    info "Node.js $(node -v) found"
+  else
+    if command -v node >/dev/null 2>&1; then
+      warn "Node.js $(node -v) is too old (need >= ${NODE_MAJOR_MIN}), upgrading..."
+    else
+      warn "Node.js not found, installing..."
+    fi
+    install_node
+    info "Node.js $(node -v) installed"
+  fi
+
+  if command -v pnpm >/dev/null 2>&1; then
+    PKG_MANAGER="pnpm"
+  elif command -v npm >/dev/null 2>&1; then
+    PKG_MANAGER="npm"
+  else
+    error "npm not found (Node.js installation may be incomplete)"
+    exit 1
+  fi
+  info "$PKG_MANAGER ready"
+
+  local current_registry
+  current_registry=$(npm config get registry 2>/dev/null || echo "")
+  if [ "$current_registry" != "$NPM_MIRROR" ] && [ "$current_registry" != "${NPM_MIRROR}/" ]; then
+    info "Switching npm registry to China mirror for faster downloads..."
+    npm config set registry "$NPM_MIRROR"
+    info "npm registry set to $NPM_MIRROR"
+  else
+    info "npm registry already set to China mirror"
+  fi
+
+  # Step 2: Install CLI
+  step "Step 2/4: Install ${PKG_NAME}"
+
+  info "Running: ${INSTALL_CMD}"
+  $PKG_MANAGER install -g ${PKG_NAME}$(echo "${INSTALL_CMD}" | grep -o '@[^ ]*' || true)
+  info "${PKG_NAME} installed"
+
+  info "Registering Skill to all AI platform global directories..."
+  ${CLI_BIN} init --global --force
+
+  # Step 3: Configure API Key
+  step "Step 3/4: Configure API Key"
+  echo ""
+  echo "  Opening the API Key management page. In your browser:"
+  echo "  1. Sign up / Log in to your Siluzan account"
+  echo "  2. Click 'Create API Key'"
+  echo "  3. Select permissions: ${PERMISSION_HINT}"
+  echo "  4. Copy the generated API Key"
+  echo ""
+
+  if ! open_url "$API_KEY_URL"; then
+    warn "Could not open browser automatically. Please visit:"
+    echo -e "  ${CYAN}${API_KEY_URL}${NC}"
+  else
+    info "API Key management page opened in browser"
+  fi
+
+  echo ""
+  printf "  Paste API Key (press Enter to skip): "
+  local api_key=""
+  read -r api_key < /dev/tty 2>/dev/null || read -r api_key
+
+  if [ -n "$api_key" ]; then
+    ${CLI_BIN} login --api-key "$api_key"
+    info "API Key saved to ~/.siluzan/config.json"
+  else
+    echo ""
+    warn "API Key configuration skipped. You can set it later:"
+    echo "  Option 1: ${CLI_BIN} login --api-key YOUR_API_KEY"
+    echo "  Option 2: export SILUZAN_API_KEY=YOUR_API_KEY"
+  fi
+
+  # Step 4: Done
+  step "Step 4/4: Complete"
+  echo ""
+  echo -e "  ${GREEN}${SKILL_LABEL} installed successfully!${NC}"
+  echo ""
+  echo "  Skill registered to these global directories (all AI assistants):"
+  echo -e "  ${DIM}~/.cursor/skills/  ~/.claude/skills/  ~/.agents/skills/"
+  echo -e "  ~/.gemini/skills/  ~/.codex/skills/   ~/.kilo/skills/"
+  echo -e "  ~/.codeium/windsurf/skills/  ~/.config/opencode/skills/"
+  echo -e "  ~/.openclaw/skills/  ~/.workbuddy/skills/${NC}"
+  echo ""
+  echo "  Update CLI & Skill files: ${CLI_BIN} update"
+  echo ""
+  info "Need help? Visit ${WEB_BASE}"
+  echo ""
+}
+
+main "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.9-beta.3",
+  "version": "1.1.11-beta.2",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "type": "module",
   "bin": {