siluzan-website-cli 1.0.1-beta.1

package/dist/skill/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: siluzan-website
+description: >-
+  管理丝路赞 WordPress 站点（wp-k8s 托管）：列出我的站点、新增/编辑页面、从丝路赞目录安装插件。
+  当用户提到 WordPress、建站后台、新增页面、改官网、装插件、站点 guid、
+  siluzan-website、zionbuilder、visual-edit 时使用。不是 LPS / AI Sites，也不是 SEO JSON 生成。
+---
+
+# siluzan-website
+
+管理用户账号下的 **WordPress 站点**（TSO 建站 / wp-k8s）。通过 CLI 调平台 all-sites 与站点 WP REST，不要手写 curl，不要猜 guid / 页面 ID。
+
+**不是** `landing-page-system` 的 LPS Agent，也不是 `siluzan-seo` 的 schema 生成。用户要的是「我的官网加一页 / 看插件」才用本 Skill。
+
+## 一键安装
+
+如果 CLI 尚未安装，直接帮用户执行：
+
+- **macOS / Linux / WSL：**
+  ```bash
+  bash <(curl -fsSL https://unpkg.com/siluzan-website-cli@latest/dist/skill/scripts/install.sh)
+  ```
+- **Windows PowerShell：**
+  ```powershell
+  irm https://unpkg.com/siluzan-website-cli@latest/dist/skill/scripts/install.ps1 | iex
+  ```
+
+Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败。若异常，先装 [Git for Windows](https://git-scm.com/download/win)，再在 Git Bash 里跑上面的 bash 命令。
+
+脚本会检测 Node.js、全局安装 CLI、`init --global --force`，并引导 `login`。凭据与 CSO/TSO 共用 `~/.siluzan/config.json`。
+
+---
+
+## 命令索引
+
+| 命令 | 作用 | 文档 |
+|------|------|------|
+| `siluzan-website login` / `send-login-code` | 登录并保存 API Key | [references/setup.md](references/setup.md) |
+| `siluzan-website config show/set/clear` | 查看 / 写入凭据 | [references/setup.md](references/setup.md) |
+| `siluzan-website init` / `update` | 写入 / 刷新 Skill 文件 | [references/setup.md](references/setup.md) |
+| `siluzan-website sites list` | 列出我的 WordPress 站点 | [references/sites.md](references/sites.md) |
+| `siluzan-website pages list/add/update` | 列出 / 新增 / 覆盖页面 | [references/pages.md](references/pages.md) |
+| `siluzan-website plugins list/catalog/install` | 已装列表 / 目录 / 安装并启用 | [references/plugins.md](references/plugins.md) |
+
+---
+
+## 场景路由
+
+| 用户在做什么 | 先读 | 再执行 |
+|--------------|------|--------|
+| 首次安装 / 登录 | `references/setup.md` | `login` 或复用已有 CSO/TSO 凭据 |
+| 我有哪些网站 | `references/sites.md` | `sites list`，不要猜 guid |
+| 加一页 / 改一页 | `references/pages.md` | 先 `sites list` 再 `pages add/update` |
+| 这个站装了哪些插件 | `references/plugins.md` | `plugins list` |
+| 安装 / 启用插件 | `references/plugins.md` | `catalog` 找 slug → 确认 → `install` |
+
+---
+
+## AI 行为规范
+
+1. **计划 → 确认 → 执行 → 验证**
+   - 写操作（`pages add` / `pages update` / `plugins install`）会立刻生效，执行前必须复述目标站点与内容，获得用户确认。
+   - 只读（`sites list` / `pages list` / `plugins list` / `plugins catalog` / `config show`）可直接跑。
+2. **不猜 ID**：站点用 `sites list` 的 `guid`；页面用 `pages list` 的 `id`。
+3. **先查再写**：改页面前先 `pages list` 确认目标页存在。
+4. **只认 API Key**：所有命令走 `x-api-key`（`SILUZAN_API_KEY` 或 `login` 写入的 config）。Agent 沙箱只注入 Key，不要向用户要 JWT，也不要设 `SILUZAN_AUTH_TOKEN`。
+5. **命令透明**：用一句话说明意图（「正在列出您的站点」），不要把整段命令当主回复；用户要细节时再给完整命令。
+6. **失败先自救**：401 → 引导重新 `login`；站点找不到 → 再跑 `sites list`；不要编造成功。
+
+### 本版明确不做
+
+- 创建 / 删除 / 重启站点（SiteMan）
+- 绑定域名 / CDN / SSL
+- 停用 / 删除插件；安装目录里没有的第三方插件
+- LPS / AI Sites / SEO JSON 灌入

package/dist/skill/_meta.json

@@ -0,0 +1,21 @@
+{
+  "slug": "siluzan-website",
+  "version": "1.0.1-beta.1",
+  "publishedAt": 1789609097006,
+  "homepage": "https://www.siluzan.com",
+  "source": "https://dev.azure.com/jack4it/Sammamish/_git/siluzan-skill",
+  "requiredBinaries": [
+    "node",
+    "npm"
+  ],
+  "optionalBinaries": [],
+  "requiredEnv": [],
+  "optionalEnv": [
+    "SILUZAN_API_KEY",
+    "SILUZAN_AUTH_TOKEN"
+  ],
+  "configPaths": [
+    "~/.siluzan/config.json"
+  ],
+  "companionSkills": []
+}

package/dist/skill/references/pages.md

@@ -0,0 +1,57 @@
+# 页面管理
+
+走站点 WordPress REST，鉴权与其它命令相同：**API Key（x-api-key）**。站点侧 `wp-oauth2` 会用 Key 调主站校验，并确认该账号拥有本站。
+
+底层接口（已存在，本 CLI 只封装）：
+
+- 列表：`GET /wp-json/wp/v2/pages`
+- 新增：`POST /wp-json/zionbuilder/v1/pages/add-visual-edit`
+- 更新：`POST /wp-json/zionbuilder/v1/pages/{id}/save-visual-edit`
+
+`add-visual-edit` / `save-visual-edit` 会把 HTML 转成 Zion Builder 组件，并且 **直接 publish**。执行前必须和用户确认目标站点与标题。
+
+## 列出
+
+```bash
+siluzan-website pages list --site <guid>
+siluzan-website pages list --url https://{guid}-prod.admin.mysiluzan.com --json
+```
+
+记下 `id`，更新时必须用这个 id，不要猜。
+
+## 新增
+
+```bash
+siluzan-website pages add --site <guid> --title "关于我们" --content-file about.html
+siluzan-website pages add --site <guid> --title "联系" --content "<h1>Contact</h1>"
+```
+
+可选：`--css-file` / `--js-file` / `--post-type`（默认 `page`）。
+
+正文用完整 HTML 片段即可（有标题、段落、图片）。不要传 Zion Builder JSON。图片尽量用已上传的绝对 URL；`s.coze.cn` 图站点侧会尝试拉到媒体库。
+
+## 更新
+
+```bash
+siluzan-website pages update --site <guid> --id 123 --content-file about.html
+siluzan-website pages update --site <guid> --id 123 --title "新标题" --content "<p>…</p>"
+```
+
+`update` 会覆盖该页 Builder 内容。先 `pages list` 确认 id。
+
+## 写后验证
+
+新增 / 更新成功后：
+
+1. 看命令打印的 `post_id` 与 `url`
+2. 再跑一次 `pages list --site <guid>`，确认标题和链接
+3. 需要给用户可点链接时，只用接口返回的 `url` / `link`，不要手拼 permalink
+
+## 失败
+
+| 现象 | 处理 |
+|------|------|
+| 未找到认证凭据 | 按 setup.md 配置 `SILUZAN_API_KEY` |
+| 401 / rest_forbidden | API Key 无效，或该账号没有这个站点 |
+| 站点 404 | `--url` 或平台域名不对；用 `sites list` 的 url |
+| Content cannot be empty | `--content` / `--content-file` 为空 |

package/dist/skill/references/plugins.md

@@ -0,0 +1,54 @@
+# 插件
+
+鉴权一律 **API Key（x-api-key）**。安装走站点 `siluzan-helper-plugin` 的 REST，只允许丝路赞目录里的 zip，不接受任意 URL。
+
+## 已装列表
+
+```bash
+siluzan-website plugins list --site <guid>
+siluzan-website plugins list --site <guid> --json
+```
+
+`GET /wp-json/wp/v2/plugins`。字段：`plugin`、名称、`status`、版本。
+
+## 可安装目录
+
+```bash
+siluzan-website plugins catalog --site <guid>
+siluzan-website plugins catalog --site <guid> --json
+```
+
+`GET /wp-json/siluzan-helper/v1/plugins/catalog`。记下 `slug`，安装必须用这个值（或 `plugin` 路径）。不要猜。
+
+## 安装并启用
+
+写操作，执行前必须和用户确认目标站点与插件名。
+
+```bash
+siluzan-website plugins install --site <guid> --slug <slug>
+```
+
+`POST /wp-json/siluzan-helper/v1/plugins/install`，body：`{ "slug": "..." }`。
+
+成功后命令会再跑一次 `plugins list` 复核。已装且已启用会返回 `already: true`，视为成功，不要再装一遍。
+
+## Agent 流程
+
+1. `sites list` 确定 guid
+2. `plugins catalog` 找到 slug（用户说中文名时按 `name` 匹配）
+3. 复述「将在 {站点} 安装并启用 {名称}（slug）」并等确认
+4. `plugins install --site <guid> --slug <slug>`
+5. 看复核列表里是否 `active`
+
+匹配到多个目录项时让用户选，不要猜。
+
+## 失败
+
+| 现象 | 处理 |
+|------|------|
+| catalog / install 404 或路由不存在 | 站点 helper 还没带 REST，需要更新 `siluzan-helper-plugin` |
+| 401 | API Key 无效或无权操作该站 |
+| Plugin not found | slug 不对，重新 `catalog` |
+| 安装成功但激活失败 | 把站点返回的 message 原文告诉用户 |
+
+本 Skill **不能**停用、删除插件，也不能装 wordpress.org 上目录里没有的插件。

package/dist/skill/references/setup.md

@@ -0,0 +1,73 @@
+# 安装与登录
+
+本 Skill **只支持 API Key 鉴权**（与 CSO / TSO 相同）。Agent 沙箱注入 `SILUZAN_API_KEY`，所有命令带 `x-api-key`。不要使用 JWT / `SILUZAN_AUTH_TOKEN`。
+
+## 一键安装
+
+- **macOS / Linux / WSL：**
+  ```bash
+  bash <(curl -fsSL https://unpkg.com/siluzan-website-cli@latest/dist/skill/scripts/install.sh)
+  ```
+- **Windows PowerShell：**
+  ```powershell
+  irm https://unpkg.com/siluzan-website-cli@latest/dist/skill/scripts/install.ps1 | iex
+  ```
+
+脚本：检测 Node 18+ → 全局安装 `siluzan-website-cli` → `siluzan-website init --global --force` → `siluzan-website login`。
+
+手动安装：
+
+```bash
+npm install -g siluzan-website-cli@beta
+siluzan-website init --global --force
+siluzan-website login
+```
+
+测试包：`npm install -g siluzan-website-cli@beta`。
+
+## 凭据
+
+与 `siluzan-cso` / `siluzan-tso` 共用 `~/.siluzan/config.json` 的 `apiKey` 字段。
+
+| 来源 | 说明 |
+|------|------|
+| `SILUZAN_API_KEY` | Agent / CI 优先 |
+| `config.json` 的 `apiKey` | `login` 写入 |
+| JWT / `SILUZAN_AUTH_TOKEN` | **本 Skill 不使用** |
+
+已用 CSO/TSO 登录过、本地已有 API Key 时，无需再 login。
+
+### 手机号两段式（签发 API Key）
+
+```bash
+siluzan-website send-login-code --phone 13800138000
+siluzan-website login --phone 13800138000 --code 123456
+```
+
+拆成两步是为了避免 Agent 卡在交互输入时反复重发短信。
+
+### 其他方式
+
+```bash
+siluzan-website login --api-key <KEY>
+siluzan-website config show
+```
+
+Agent 沙箱（`IS_SILUZAN_AGENT_ENV=true`）只读 `SILUZAN_API_KEY`，不读 config.json，也不要跑交互 `login`。
+
+## Skill 初始化
+
+```bash
+siluzan-website init                # 当前项目各 AI 目录
+siluzan-website init --global       # 全局目录
+siluzan-website init --ai cursor    # 只写 Cursor
+siluzan-website update              # 升级 CLI 并刷新已记录的 Skill
+```
+
+## 常见错误
+
+| 现象 | 处理 |
+|------|------|
+| 未找到认证凭据 | `login` 或设置 `SILUZAN_API_KEY` |
+| 401 / API Key 无权访问本站 | Key 有效但账号没有该站点；换有权限的账号或换 `--site` |
+| 站点找不到 | 先 `sites list`，用返回的 guid |

package/dist/skill/references/sites.md

@@ -0,0 +1,35 @@
+# 站点列表
+
+## 命令
+
+```bash
+siluzan-website sites list
+siluzan-website sites list -q 品牌名
+siluzan-website sites list --json
+```
+
+走主站 `GET /query/profile/steward-individual/all-sites`（与 TSO 建站后台同一接口）。
+
+## 返回字段
+
+| 字段 | 含义 |
+|------|------|
+| `guid` | 站点 ID，后续 `--site` 必须用它（名称可能重复） |
+| `name` | 站点名称 |
+| `region` | `us` / `cn` 或中文「美国」「中国」 |
+| `siteState` | 例如 `Online` |
+| `url` | 平台访问地址，按 TSO 规则拼接 |
+
+平台地址规则（与 TSO `getDomainName` 一致）：
+
+- 国际：`https://{guid}-{stage}.admin.mysiluzan.com`
+- 国内：`https://{guid}-{stage}.cn.siluzan.com`
+
+`stage` 由 CLI 构建环境决定（生产 `prod`，测试 `ci`）。自定义域名本版不查 SiteMan DNS；要对已绑域名的站操作页面，可直接 `--url https://www.example.com`。
+
+## Agent 用法
+
+1. 用户说「我的网站」时先跑 `sites list`，把名称和 guid 给用户看。
+2. 多个站点时让用户选，不要猜。
+3. 后续页面 / 插件命令传 `--site <guid>`。名称唯一时 `--site 名称` 也可以。
+4. 需要对返回结果做筛选时加 `--json`，再在本地处理；不要编造 guid。

package/dist/skill/scripts/install.ps1

@@ -0,0 +1,275 @@
+#Requires -Version 5.1
+# =============================================================================
+# siluzan-website-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-website-cli'
+# PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
+$PKG_VERSION = '1.0.1-beta.1'
+$CLI_BIN     = 'siluzan-website'
+$SKILL_LABEL = 'Siluzan Website'
+$INSTALL_CMD = 'npm install -g siluzan-website-cli@beta'
+$WEB_BASE    = 'https://www-ci.siluzan.com'
+
+# -- Constants ----------------------------------------------------------------
+$NODE_MAJOR_MIN    = 18
+$NPM_MIRROR        = 'https://registry.npmmirror.com'
+# Git for Windows installer (mirrored on Siluzan CDN; bump version here when needed)
+$GIT_INSTALLER_URL = 'https://staticpn.siluzan.com/assets/git/Git-2.54.0-64-bit.exe'
+
+# -- 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 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'
+}
+
+# -- Git for Windows ----------------------------------------------------------
+# Some agent clients (Cursor / Claude Code / etc.) have known quirks running
+# PowerShell or cmd commands. We install Git for Windows ahead of time so the
+# user always has a Git Bash fallback to run the equivalent bash installer
+# (`bash <(curl -fsSL .../install.sh)`) when the PowerShell channel misbehaves.
+function Test-GitInstalled {
+    return $null -ne (Get-Command git -ErrorAction SilentlyContinue)
+}
+
+function Test-IsAdmin {
+    try {
+        $id = [Security.Principal.WindowsIdentity]::GetCurrent()
+        $principal = New-Object Security.Principal.WindowsPrincipal($id)
+        return $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
+    } catch {
+        return $false
+    }
+}
+
+function Install-Git {
+    $tmpFile = Join-Path $env:TEMP 'siluzan-git-installer.exe'
+
+    Write-Info "Downloading Git for Windows: $GIT_INSTALLER_URL"
+    try {
+        $prevProgress = $ProgressPreference
+        $ProgressPreference = 'SilentlyContinue'
+        Invoke-WebRequest -Uri $GIT_INSTALLER_URL -OutFile $tmpFile -UseBasicParsing
+        $ProgressPreference = $prevProgress
+    } catch {
+        Write-Warn "Git installer download failed: $($_.Exception.Message)"
+        return $false
+    }
+
+    if (-not (Test-Path $tmpFile)) {
+        Write-Warn 'Git installer file not found after download'
+        return $false
+    }
+
+    # Inno Setup silent flags. When not admin we point /DIR to %LOCALAPPDATA% so
+    # the installer doesn't try to write to Program Files (which would trigger UAC
+    # or just fail). The installer auto-detects ALLUSERS vs CURRENTUSER mode based
+    # on whether the current process is elevated, so we don't pass /CURRENTUSER
+    # explicitly (not all Git for Windows builds accept that flag).
+    $installArgs = @('/VERYSILENT', '/NORESTART', '/NOCANCEL', '/SP-', '/CLOSEAPPLICATIONS', '/RESTARTAPPLICATIONS')
+    if (Test-IsAdmin) {
+        Write-Info 'Installing Git for Windows system-wide (admin detected)...'
+    } else {
+        $userDir = Join-Path $env:LOCALAPPDATA 'Programs\Git'
+        Write-Info "Installing Git for Windows for current user: $userDir"
+        $installArgs += @("/DIR=$userDir")
+    }
+
+    try {
+        Start-Process -FilePath $tmpFile -ArgumentList $installArgs -Wait -NoNewWindow
+    } catch {
+        Write-Warn "Git installer launch failed: $($_.Exception.Message)"
+        Remove-Item $tmpFile -ErrorAction SilentlyContinue
+        return $false
+    }
+    Remove-Item $tmpFile -ErrorAction SilentlyContinue
+
+    Refresh-Path
+    if (-not (Test-GitInstalled)) {
+        # 安装器有时不会立刻刷新 PATH，按已知路径手动补一次
+        $candidates = @(
+            (Join-Path $env:LOCALAPPDATA 'Programs\Git\cmd'),
+            (Join-Path $env:ProgramFiles 'Git\cmd')
+        )
+        foreach ($p in $candidates) {
+            if (Test-Path (Join-Path $p 'git.exe')) {
+                $env:Path = "$p;$env:Path"
+                break
+            }
+        }
+    }
+
+    return Test-GitInstalled
+}
+
+# -- 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'
+
+    # Git for Windows: pre-install as a Bash fallback path for agent clients
+    # whose PowerShell/cmd channel is unreliable. Failure here is non-fatal.
+    if (Test-GitInstalled) {
+        Write-Info 'Git for Windows already installed (Git Bash fallback ready)'
+    } else {
+        Write-Warn 'Git for Windows not found, installing as Bash fallback for agent clients...'
+        $gitOk = $false
+        try { $gitOk = Install-Git } catch { Write-Warn "Git install error: $($_.Exception.Message)" }
+        if ($gitOk) {
+            Write-Info 'Git for Windows installed (Git Bash fallback ready)'
+        } else {
+            Write-Warn 'Git for Windows install was skipped or failed; CLI install will continue.'
+            Write-Host '  If your agent later fails to run PowerShell commands, install Git manually:' -ForegroundColor DarkGray
+            Write-Host "  $GIT_INSTALLER_URL" -ForegroundColor DarkGray
+        }
+    }
+
+    $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"
+
+    # 用打包时锁定的 PKG_VERSION，保证脚本与同批 dist/skill 行为对齐
+    $installTarget = "$PKG_NAME@$PKG_VERSION"
+    Write-Info "Running: npm install -g $installTarget"
+    & npm install -g $installTarget
+    if ($LASTEXITCODE -ne 0) { Write-Err "npm install -g $installTarget failed"; return }
+    Write-Info "$installTarget installed"
+
+    Write-Info 'Registering Skill to all AI platform global directories...'
+    & $CLI_BIN init --global --force
+
+    if ($CLI_BIN -eq 'siluzan-seo') {
+        Write-Info 'siluzan-seo does not require login; skipping API Key setup.'
+    } else {
+        Write-Step 'Step 3/4: Configure API Key'
+        Write-Host ''
+        & $CLI_BIN login
+    }
+
+    # 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 ''
+    if (Test-GitInstalled) {
+        Write-Host '  Tip: if your agent client has trouble running PowerShell/cmd commands later,' -ForegroundColor DarkGray
+        Write-Host '       open Git Bash and re-run the equivalent bash installer instead.' -ForegroundColor DarkGray
+        Write-Host ''
+    }
+    Write-Info "Need help? Visit $WEB_BASE"
+    Write-Host ''
+}
+
+Main