@wwkit/cft 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 bluesliu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @wwkit/cft
+
+Chrome for Testing (CFT) 安装器 — 下载、解压、chmod、Linux 依赖检查。
+
+## 用法
+
+```bash
+cft install    # 下载并安装 Chrome for Testing（已装同版本则跳过）
+cft status     # 显示安装状态
+cft clear      # 删除安装产物（~/.config/cft/）
+cft help       # 显示帮助
+```
+
+## 安装目录
+
+`~/.config/cft/`（或 `$XDG_CONFIG_HOME/cft/`）
+
+## installed.json
+
+安装完成后生成 `~/.config/cft/installed.json`：
+
+```json
+{
+  "location": "~/.config/cft",
+  "version": "141.0.7390.54",
+  "os": "mac-arm64",
+  "chrome_path": ".../chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing",
+  "driver_path": ".../chromedriver-mac-arm64/chromedriver"
+}
+```
+
+## 配置
+
+版本和镜像源硬编码在包内，不接受外部参数。
+
+- 默认版本: `141.0.7390.54`
+- 默认镜像: `https://npmmirror.com/mirrors/chrome-for-testing`
+
+## 本地开发
+
+### 环境要求
+
+- Node.js >= 18
+- pnpm（workspace 根目录 `pnpm install` 自动链接 `@wwkit/shared`）
+
+### 直接调用命令
+
+```bash
+# 通过 bin 入口（推荐，模拟 npm 全局安装后的行为）
+node bin status
+node bin install
+node bin help
+
+# 或通过 pnpm script
+pnpm start install
+```
+
+### 运行测试
+
+```bash
+pnpm test          # 单元测试
+```
+
+### 发布
+
+```bash
+pnpm release       # pnpm version patch && pnpm publish
+```

package/bin/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+import { install, status, clear } from '../src/index.js'
+
+const command = process.argv[2]
+
+if (command === 'install') {
+  install()
+    .then((info) => {
+      console.log()
+      console.log('  ✓ CFT 安装完成')
+      process.exit(0)
+    })
+    .catch((err) => {
+      console.error(`  ✗ CFT 安装失败: ${err.message}`)
+      process.exit(1)
+    })
+} else if (command === 'status') {
+  const info = status()
+  process.exit(info ? 0 : 1)
+} else if (command === 'clear') {
+  clear()
+  process.exit(0)
+} else if (command === 'help' || command === undefined) {
+  console.log(`cft - Chrome for Testing 安装器
+
+用法:
+  cft install    下载并安装 Chrome for Testing（已装同版本则跳过）
+  cft status     显示安装状态
+  cft clear      删除安装产物（~/.config/cft/）
+  cft help       显示本帮助
+
+安装目录: ~/.config/cft/`)
+} else {
+  console.error(`未知命令: ${command}`)
+  console.error('运行 cft help 查看用法')
+  process.exit(1)
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@wwkit/cft",
+  "version": "1.0.1",
+  "author": "bluesliu <langcai163@163.com>",
+  "description": "Chrome for Testing (CFT) installer — download, extract, chmod, dep-check",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "cft": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "jest": {
+    "transform": {},
+    "testMatch": [
+      "**/tests/unit/**/*.test.js"
+    ]
+  },
+  "keywords": [
+    "chrome",
+    "chromedriver",
+    "chrome-for-testing",
+    "cft",
+    "selenium",
+    "webdriver"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "extract-zip": "^2.0.1",
+    "@wwkit/shared": "1.0.1"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0"
+  },
+  "scripts": {
+    "start": "node bin/index.js",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --no-cache tests/unit",
+    "test:all": "node --experimental-vm-modules node_modules/jest/bin/jest.js --no-cache tests/unit",
+    "release": "pnpm version patch && pnpm publish"
+  }
+}

package/src/config.js

@@ -0,0 +1,35 @@
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createConfigLoader, getXdgConfigDir } from '@wwkit/shared'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const INSTALL_DIR = getXdgConfigDir('cft')
+
+const _loader = createConfigLoader({
+  builtinConfigPath: path.join(__dirname, 'config.json5'),
+  userConfigDir: INSTALL_DIR,
+})
+
+export const INSTALL_LOCATION = INSTALL_DIR
+export const USER_CONFIG_FILE = path.join(INSTALL_DIR, 'config.json5')
+
+export function getConfig() {
+  return _loader.getConfig()
+}
+
+export function copyBuiltinConfig() {
+  return _loader.copyBuiltinConfig()
+}
+
+export function getVersion() {
+  return getConfig().version
+}
+
+export function getRegistry() {
+  return getConfig().registry
+}
+
+export function getLocation() {
+  return INSTALL_LOCATION
+}

package/src/config.json5

@@ -0,0 +1,4 @@
+{
+  version: "141.0.7390.54",
+  registry: "https://npmmirror.com/mirrors/chrome-for-testing",
+}

package/src/depchecker.js

@@ -0,0 +1,159 @@
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import process from 'node:process'
+
+const APT_MAP = {
+  'libnss3.so': 'libnss3',
+  'libatk-1.0.so.0': 'libatk1.0-0t64',
+  'libatk-bridge-2.0.so.0': 'libatk-bridge2.0-0t64',
+  'libcups.so.2': 'libcups2t64',
+  'libdrm.so.2': 'libdrm2',
+  'libgbm.so.1': 'libgbm1',
+  'libxkbcommon.so.0': 'libxkbcommon0',
+  'libXcomposite.so.1': 'libxcomposite1',
+  'libXdamage.so.1': 'libxdamage1',
+  'libXfixes.so.3': 'libxfixes3',
+  'libXrandr.so.2': 'libxrandr2',
+  'libasound.so.2': 'libasound2t64',
+  'libpango-1.0.so.0': 'libpango-1.0-0',
+  'libcairo.so.2': 'libcairo2',
+  'libpangoft2-1.0.so.0': 'libpango1.0-0',
+  'libharfbuzz.so.0': 'libharfbuzz0b',
+  'libxss.so.1': 'libxss1',
+  'libatspi.so.0': 'libatspi2.0-0t64',
+  'libxcb.so.1': 'libxcb1',
+  'libx11.so.6': 'libx11-6',
+  'libxext.so.6': 'libxext6',
+  'libnssutil3.so': 'libnss3',
+  'libsmime3.so': 'libnss3',
+  'libnspr4.so': 'libnspr4',
+  'libdbus-1.so.3': 'libdbus-1-3',
+  'libexpat.so.1': 'libexpat1',
+  'libxrender.so.1': 'libxrender1',
+  'libglib-2.0.so.0': 'libglib2.0-0',
+  'libgobject-2.0.so.0': 'libglib2.0-0',
+  'libpango-1.0-0.so.0': 'libpango-1.0-0',
+}
+
+const DNF_MAP = {
+  'libnss3.so': 'nss',
+  'libatk-1.0.so.0': 'atk',
+  'libatk-bridge-2.0.so.0': 'at-spi2-atk',
+  'libcups.so.2': 'libcups',
+  'libdrm.so.2': 'libdrm',
+  'libgbm.so.1': 'mesa-libgbm',
+  'libxkbcommon.so.0': 'libxkbcommon',
+  'libXcomposite.so.1': 'libXcomposite',
+  'libXdamage.so.1': 'libXdamage',
+  'libXfixes.so.3': 'libXfixes',
+  'libXrandr.so.2': 'libXrandr',
+  'libasound.so.2': 'alsa-lib',
+  'libpango-1.0.so.0': 'pango',
+  'libcairo.so.2': 'cairo',
+  'libpangoft2-1.0.so.0': 'pango',
+  'libharfbuzz.so.0': 'harfbuzz',
+  'libxss.so.1': 'libXScrnSaver',
+  'libatspi.so.0': 'at-spi2-core',
+  'libxcb.so.1': 'libxcb',
+  'libx11.so.6': 'libX11',
+  'libxext.so.6': 'libXext',
+  'libnssutil3.so': 'nss',
+  'libsmime3.so': 'nss',
+  'libnspr4.so': 'nspr',
+  'libdbus-1.so.3': 'dbus-libs',
+  'libexpat.so.1': 'expat',
+  'libxrender.so.1': 'libXrender',
+  'libglib-2.0.so.0': 'glib2',
+  'libgobject-2.0.so.0': 'glib2',
+}
+
+export function isSupported() {
+  return process.platform === 'linux'
+}
+
+export function check(binaryPath) {
+  if (!isSupported()) return []
+  if (!binaryPath || !fs.existsSync(binaryPath)) return []
+  try {
+    execSync('which ldd', { stdio: 'pipe' })
+  } catch {
+    return []
+  }
+  let result
+  try {
+    result = execSync(`ldd "${binaryPath}"`, { captureOutput: true, timeout: 20000 })
+  } catch {
+    return []
+  }
+  const stdout = result.stdout?.toString() || ''
+  const missing = []
+  for (const line of stdout.split('\n')) {
+    const m = line.match(/^\s*(\S+)\s+=>\s+not found/)
+    if (m) missing.push(m[1])
+  }
+  return missing
+}
+
+export function mapToPackages(libs, packageManager) {
+  const table = packageManager === 'apt' ? APT_MAP : DNF_MAP
+  const packages = []
+  const unknown = []
+  const seen = new Set()
+  for (const lib of libs) {
+    const pkg = table[lib]
+    if (pkg && !seen.has(pkg)) {
+      seen.add(pkg)
+      packages.push(pkg)
+    } else if (!pkg) {
+      unknown.push(lib)
+    }
+  }
+  return { packages, unknown }
+}
+
+export function install(packages, packageManager) {
+  if (!packages.length) return true
+  const cmd = packageManager === 'apt'
+    ? ['apt-get', 'install', '-y', ...packages]
+    : ['dnf', 'install', '-y', ...packages]
+  try {
+    const result = execSync(['sudo', ...cmd].join(' '), { timeout: 600000 })
+    return true
+  } catch {
+    return false
+  }
+}
+
+function detectPackageManager() {
+  try { execSync('which apt-get', { stdio: 'pipe' }); return 'apt' } catch {}
+  try { execSync('which dnf', { stdio: 'pipe' }); return 'dnf' } catch {}
+  return 'apt'
+}
+
+export { detectPackageManager }
+
+export function verify(binaryPath) {
+  if (!isSupported()) {
+    return { missing: [], packages: [], unknown: [], ok: true }
+  }
+  const packageManager = detectPackageManager()
+  const missing = check(binaryPath)
+  const result = { missing, packages: [], unknown: [], ok: !missing.length }
+  if (!missing.length) return result
+
+  const { packages, unknown } = mapToPackages(missing, packageManager)
+  result.packages = packages
+  result.unknown = unknown
+
+  if (packages.length) {
+    if (install(packages, packageManager)) {
+      const stillMissing = check(binaryPath)
+      result.ok = !stillMissing.length
+    } else {
+      result.ok = false
+    }
+  } else {
+    result.ok = false
+  }
+  return result
+}

package/src/exefinder.js

@@ -0,0 +1,110 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+
+function getPossibleNames(baseName) {
+  const names = new Set()
+  if (baseName === 'chrome') {
+    ['chrome', 'google chrome', 'google chrome for testing'].forEach(n => {
+      names.add(n.toLowerCase())
+      names.add(n.toLowerCase() + '.exe')
+    })
+  } else if (baseName === 'chromedriver') {
+    names.add('chromedriver')
+    names.add('chromedriver.exe')
+  } else {
+    names.add(baseName.toLowerCase())
+    names.add(baseName.toLowerCase() + '.exe')
+  }
+  return names
+}
+
+function findFallback(directory, baseName, isMacos) {
+  if (baseName === 'chrome' && isMacos) {
+    const paths = [
+      path.join(directory, 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'),
+      path.join(directory, 'Chrome.app', 'Contents', 'MacOS', 'Chrome'),
+      path.join(directory, 'Google Chrome.app', 'Contents', 'MacOS', 'Google Chrome'),
+    ]
+    for (const p of paths) {
+      if (fs.existsSync(p)) return p
+    }
+  } else if (baseName === 'chromedriver') {
+    const paths = [
+      path.join(directory, 'chromedriver'),
+      path.join(directory, 'chromedriver.exe'),
+    ]
+    for (const p of paths) {
+      if (fs.existsSync(p)) return p
+    }
+  }
+  return null
+}
+
+function setAppPermissions(appBundlePath) {
+  if (!fs.existsSync(appBundlePath)) return
+  for (const entry of fs.readdirSync(appBundlePath, { withFileTypes: true })) {
+    const fullPath = path.join(appBundlePath, entry.name)
+    if (entry.isDirectory()) {
+      setAppPermissions(fullPath)
+    } else {
+      try { fs.chmodSync(fullPath, 0o755) } catch {}
+    }
+  }
+}
+
+function ensureExecutable(filePath, isMacos = false, baseName = '') {
+  if (process.platform === 'win32') return filePath
+  try {
+    fs.accessSync(filePath, fs.constants.X_OK)
+    return filePath
+  } catch {}
+  try {
+    fs.chmodSync(filePath, 0o755)
+    if (isMacos && baseName === 'chrome') {
+      const parts = filePath.split('/Contents/MacOS/')
+      if (parts.length > 1 && parts[0].endsWith('.app')) {
+        setAppPermissions(parts[0])
+      }
+    }
+  } catch {}
+  return filePath
+}
+
+export function find(directory, baseName) {
+  const isMacos = process.platform === 'darwin'
+
+  if (!fs.existsSync(directory)) {
+    throw new Error(`Directory not found: ${directory}`)
+  }
+
+  if (fs.statSync(directory).isFile()) {
+    try {
+      fs.accessSync(directory, fs.constants.X_OK)
+      return ensureExecutable(directory)
+    } catch {}
+  }
+
+  const possibleNames = getPossibleNames(baseName)
+
+  function walkDir(dir) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const fullPath = path.join(dir, entry.name)
+      if (entry.isDirectory()) {
+        const result = walkDir(fullPath)
+        if (result) return result
+      } else if (possibleNames.has(entry.name.toLowerCase())) {
+        return fullPath
+      }
+    }
+    return null
+  }
+
+  const found = walkDir(directory)
+  if (found) return ensureExecutable(found, isMacos, baseName)
+
+  const fallback = findFallback(directory, baseName, isMacos)
+  if (fallback) return ensureExecutable(fallback, isMacos, baseName)
+
+  throw new Error(`Executable not found: ${baseName} in ${directory}`)
+}

package/src/index.js

@@ -0,0 +1,3 @@
+export { install, status, clear } from './installer.js'
+export { getOs, isWindows, isMacos, isLinux, VALID_OS_TYPES } from './platform.js'
+export { getConfig, getVersion, getRegistry, getLocation, copyBuiltinConfig, INSTALL_LOCATION, USER_CONFIG_FILE } from './config.js'

package/src/installer.js

@@ -0,0 +1,260 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import https from 'node:https'
+import http from 'node:http'
+
+import extractZip from 'extract-zip'
+
+import { getOs, VALID_OS_TYPES } from './platform.js'
+import { find as findExe } from './exefinder.js'
+import { check as checkDeps, mapToPackages, install as installDeps, isSupported as depsSupported, detectPackageManager } from './depchecker.js'
+import { getVersion, getRegistry, getLocation, copyBuiltinConfig } from './config.js'
+
+function log(msg) {
+  console.log(`  ${msg}`)
+}
+
+function downloadFile(url, destPath, redirects = 0) {
+  return new Promise((resolve, reject) => {
+    if (redirects > 5) {
+      reject(new Error(`Too many redirects: ${url}`))
+      return
+    }
+    const protocol = url.startsWith('https:') ? https : http
+    const filename = path.basename(destPath)
+    log(`下载 ${filename} ...`)
+
+    protocol.get(url, (response) => {
+      if (response.statusCode === 301 || response.statusCode === 302 || response.statusCode === 307 || response.statusCode === 308) {
+        const location = response.headers.location
+        response.resume()
+        if (!location) {
+          reject(new Error(`Redirect without Location header: ${url}`))
+          return
+        }
+        downloadFile(location, destPath, redirects + 1).then(resolve).catch(reject)
+        return
+      }
+      if (response.statusCode !== 200) {
+        reject(new Error(`HTTP ${response.statusCode}: ${url}`))
+        return
+      }
+      const total = parseInt(response.headers['content-length'] || '0', 10)
+      let downloaded = 0
+      let lastLog = 0
+      response.on('data', (chunk) => {
+        downloaded += chunk.length
+        if (total > 0) {
+          const pct = Math.floor(downloaded * 100 / total)
+          if (pct >= lastLog + 10 || downloaded === total) {
+            log(`[${filename}] ${pct}% (${Math.floor(downloaded / 1048576)}MB / ${Math.floor(total / 1048576)}MB)`)
+            lastLog = pct
+          }
+        }
+      })
+      const file = fs.createWriteStream(destPath)
+      response.pipe(file)
+      file.on('finish', () => {
+        file.close()
+        resolve()
+      })
+    }).on('error', reject)
+  })
+}
+
+async function downloadExtract(url, saveDir, filename, extractDir) {
+  const filePath = path.join(saveDir, filename)
+  await downloadFile(url, filePath)
+
+  log(`解压到 ${path.basename(extractDir)}`)
+  if (fs.existsSync(extractDir)) {
+    fs.rmSync(extractDir, { recursive: true, force: true })
+  }
+  await extractZip(filePath, { dir: saveDir })
+  fs.unlinkSync(filePath)
+}
+
+function chmodExec(filePath) {
+  if (filePath && fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+    try { fs.chmodSync(filePath, 0o755) } catch {}
+  }
+}
+
+function chmodExecDir(directory) {
+  if (!directory || !fs.existsSync(directory) || !fs.statSync(directory).isDirectory()) return
+  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    const fullPath = path.join(directory, entry.name)
+    if (entry.isDirectory()) {
+      chmodExecDir(fullPath)
+    } else {
+      try { fs.chmodSync(fullPath, 0o755) } catch {}
+    }
+  }
+}
+
+function prepareDir(location) {
+  if (!fs.existsSync(location)) {
+    fs.mkdirSync(location, { recursive: true })
+    return
+  }
+  const entries = fs.readdirSync(location)
+  if (!entries.length) return
+  log(`清空安装目录: ${location}`)
+  for (const name of entries) {
+    if (name === 'config.json5') continue
+    const itemPath = path.join(location, name)
+    if (fs.statSync(itemPath).isFile()) {
+      fs.unlinkSync(itemPath)
+    } else {
+      fs.rmSync(itemPath, { recursive: true, force: true })
+    }
+  }
+}
+
+function readInstalledInfo(location) {
+  const jsonPath = path.join(location, 'installed.json')
+  if (!fs.existsSync(jsonPath)) return null
+  try {
+    return JSON.parse(fs.readFileSync(jsonPath, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+function checkInstalled(version, location, osType) {
+  const info = readInstalledInfo(location)
+  if (!info) return { installed: false, info: {} }
+  const chromeDir = path.join(location, `chrome-${osType}`)
+  const driverDir = path.join(location, `chromedriver-${osType}`)
+  if (info.version === version && info.os === osType &&
+      fs.existsSync(chromeDir) && fs.existsSync(driverDir)) {
+    return { installed: true, info }
+  }
+  return { installed: false, info: {} }
+}
+
+function saveInstallInfo(location, info) {
+  const jsonPath = path.join(location, 'installed.json')
+  fs.writeFileSync(jsonPath, JSON.stringify(info, null, 2), 'utf-8')
+  log(`安装信息已保存到 ${jsonPath}`)
+}
+
+function checkSystemDeps(chromeExe, driverExe) {
+  if (!depsSupported()) return
+  const packageManager = detectPackageManager()
+  for (const [label, exePath] of [['Chrome', chromeExe], ['ChromeDriver', driverExe]]) {
+    if (!exePath || !fs.existsSync(exePath)) continue
+    const missing = checkDeps(exePath)
+    if (!missing.length) continue
+    const { packages, unknown } = mapToPackages(missing, packageManager)
+    if (packages.length) {
+      log(`${label}: 自动安装系统依赖 ${packages.join(', ')}`)
+      installDeps(packages, packageManager)
+    }
+    if (unknown.length) {
+      log(`${label}: 无法自动映射的库 ${unknown.join(', ')}，请手动安装`)
+    }
+  }
+}
+
+export async function install() {
+  copyBuiltinConfig()
+  const version = getVersion()
+  const registry = getRegistry()
+  const location = getLocation()
+  const osType = getOs()
+
+  if (!VALID_OS_TYPES.includes(osType)) {
+    throw new Error(`Unsupported OS: ${osType}`)
+  }
+
+  const { installed, info } = checkInstalled(version, location, osType)
+  if (installed) {
+    log(`CFT ${version} 已安装，跳过`)
+    return info
+  }
+
+  prepareDir(location)
+
+  const chromeUrl = `${registry}/${version}/${osType}/chrome-${osType}.zip`
+  const driverUrl = `${registry}/${version}/${osType}/chromedriver-${osType}.zip`
+  log(`从网络下载 CFT ${version} (${osType})`)
+
+  const chromeDir = path.join(location, `chrome-${osType}`)
+  const driverDir = path.join(location, `chromedriver-${osType}`)
+
+  await downloadExtract(chromeUrl, location, `chrome-${osType}.zip`, chromeDir)
+  await downloadExtract(driverUrl, location, `chromedriver-${osType}.zip`, driverDir)
+
+  const chromeExe = findExe(chromeDir, 'chrome')
+  const driverExe = findExe(driverDir, 'chromedriver')
+
+  chmodExecDir(chromeDir)
+  chmodExecDir(driverDir)
+  chmodExec(chromeExe)
+  chmodExec(driverExe)
+
+  checkSystemDeps(chromeExe, driverExe)
+
+  const installInfo = {
+    location,
+    version,
+    os: osType,
+    chrome_path: chromeExe,
+    driver_path: driverExe,
+  }
+  saveInstallInfo(location, installInfo)
+  log(`Chrome 路径: ${chromeExe}`)
+  log(`ChromeDriver 路径: ${driverExe}`)
+  return installInfo
+}
+
+export function status() {
+  const location = getLocation()
+  const info = readInstalledInfo(location)
+  if (!info) {
+    console.log('CFT 未安装，请运行: cft install')
+    return null
+  }
+  const chromeOk = fs.existsSync(info.chrome_path || '')
+  const driverOk = fs.existsSync(info.driver_path || '')
+  console.log(`版本: ${info.version || 'unknown'}  (os: ${info.os || 'unknown'})`)
+  console.log(`Chrome:      ${info.chrome_path || ''}  ${chromeOk ? 'OK' : '文件不存在'}`)
+  console.log(`ChromeDriver: ${info.driver_path || ''}  ${driverOk ? 'OK' : '文件不存在'}`)
+  return info
+}
+
+export function clear() {
+  const location = getLocation()
+  if (!fs.existsSync(location)) {
+    console.log(`安装目录不存在: ${location}`)
+    return false
+  }
+
+  const info = readInstalledInfo(location)
+  const label = info ? `CFT ${info.version || ''} (${info.os || ''})` : 'CFT'
+
+  // only remove installation artifacts, keep config.json5
+  const artifacts = []
+  if (info?.os) {
+    artifacts.push(`chrome-${info.os}`, `chromedriver-${info.os}`)
+  }
+  artifacts.push('installed.json')
+
+  let removed = false
+  for (const name of artifacts) {
+    const p = path.join(location, name)
+    if (fs.existsSync(p)) {
+      fs.rmSync(p, { recursive: true, force: true })
+      removed = true
+    }
+  }
+
+  if (removed) {
+    console.log(`  ✓ 已删除 ${label}`)
+    console.log(`    ${location}`)
+  } else {
+    console.log(`  无安装产物可删除`)
+  }
+  return removed
+}

package/src/platform.js

@@ -0,0 +1,27 @@
+import process from 'node:process'
+import os from 'node:os'
+
+const VALID_OS_TYPES = ['linux64', 'win64', 'mac-x64', 'mac-arm64']
+
+export function getOs() {
+  const platform = process.platform
+  const arch = process.arch
+  if (platform === 'win32') return 'win64'
+  if (platform === 'darwin') return arch === 'arm64' ? 'mac-arm64' : 'mac-x64'
+  if (platform === 'linux') return 'linux64'
+  throw new Error(`Unsupported platform: ${platform}`)
+}
+
+export function isWindows() {
+  return process.platform === 'win32'
+}
+
+export function isMacos() {
+  return process.platform === 'darwin'
+}
+
+export function isLinux() {
+  return process.platform === 'linux'
+}
+
+export { VALID_OS_TYPES }