@wwkit/cft 1.0.28 → 1.0.29

package/src/installer.js

@@ -1,369 +1,369 @@
-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, getProxy, getLocation, copyBuiltinConfig } from './config.js'
-import { parseProxy, openTunnel } from '@wwkit/shared'
-
-const USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36 cft-installer'
-const MANUAL_DOWNLOAD_HINT = '资源下载失败，请在 http://deepbluenet.com/webwork/#/mirror 手动下载资源，并将资源解压到 ~/.config/cft 目录，然后将地址添加到 ~/.config/webwork/webwork.json5 中的 env.SELENIUM_CFT_DIR 属性上'
-
-function log(msg) {
-  console.log(`  ${msg}`)
-}
-
-function sendRequest(url, proxyValue, cb, method = 'GET') {
-  const proxy = parseProxy(proxyValue)
-  const target = new URL(url)
-  const headers = { 'user-agent': USER_AGENT }
-  const onError = (e) => cb(e, null)
-
-  if (!proxy) {
-    const proto = target.protocol === 'https:' ? https : http
-    const req = proto.request(url, { headers, method }, (res) => cb(null, res))
-    req.on('error', onError)
-    req.end()
-    return
-  }
-
-  if (proxy.protocol === 'http:' && target.protocol === 'http:') {
-    const req = http.request({
-      host: proxy.hostname,
-      port: Number(proxy.port) || 80,
-      path: url,
-      method,
-      headers: { ...headers, host: target.host },
-    }, (res) => cb(null, res))
-    req.on('error', onError)
-    req.end()
-    return
-  }
-
-  openTunnel(proxy, target).then((socket) => {
-    const proto = target.protocol === 'https:' ? https : http
-    const req = proto.request({
-      method,
-      hostname: target.hostname,
-      port: Number(target.port) || (target.protocol === 'https:' ? 443 : 80),
-      path: target.pathname + target.search,
-      headers: { ...headers, host: target.host },
-      agent: false,
-      createConnection: () => socket,
-    }, (res) => cb(null, res))
-    req.on('error', onError)
-    socket.on('error', onError)
-    req.end()
-  }).catch(onError)
-}
-
-/**
- * 访问前预检完整路径是否可达（HEAD 请求，非 2xx/3xx 视为不可达）
- * @param {string} url - 完整下载 URL
- * @param {string} [proxyValue] - 代理地址
- * @returns {Promise<boolean>}
- */
-function checkUrlReachable(url, proxyValue) {
-  return new Promise((resolve) => {
-    sendRequest(url, proxyValue, (err, response) => {
-      if (err) { resolve(false); return }
-      response.resume()
-      if (response.statusCode >= 200 && response.statusCode < 400) {
-        resolve(true)
-      } else if (response.statusCode === 405) {
-        // 405 Method Not Allowed — 服务器已响应，仅不支持 HEAD
-        resolve(true)
-      } else {
-        resolve(false)
-      }
-    }, 'HEAD')
-  })
-}
-
-/**
- * 下载失败时的统一终止提示
- * @param {Error} [cause] - 原始错误
- */
-function downloadError(cause) {
-  const err = new Error(MANUAL_DOWNLOAD_HINT)
-  if (cause) err.cause = cause
-  return err
-}
-
-function downloadFile(url, destPath, proxyValue, redirects = 0) {
-  return new Promise((resolve, reject) => {
-    if (redirects > 5) {
-      reject(new Error(`Too many redirects: ${url}`))
-      return
-    }
-    const filename = path.basename(destPath)
-    log(`下载 ${filename} ...`)
-
-    sendRequest(url, proxyValue, (err, response) => {
-      if (err) { reject(err); return }
-      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, proxyValue, 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()
-      })
-      file.on('error', reject)
-      response.on('error', reject)
-    })
-  })
-}
-
-async function downloadExtract(url, saveDir, filename, extractDir, proxyValue) {
-  const filePath = path.join(saveDir, filename)
-  await downloadFile(url, filePath, proxyValue)
-
-  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
-    if (!packageManager) {
-      log(`${label}: 缺少系统依赖 ${missing.join(', ')}，未检测到 apt-get/dnf，请手动安装`)
-      continue
-    }
-    const { packages, unknown } = mapToPackages(missing, packageManager)
-    if (packages.length) {
-      log(`${label}: 自动安装系统依赖 ${packages.join(', ')}`)
-      installDeps(packages, packageManager)
-    }
-    if (unknown.length) {
-      log(`${label}: 无法自动映射的库 ${unknown.join(', ')}，请手动安装`)
-    }
-  }
-}
-
-/**
- * 安装 CFT（Chrome + ChromeDriver）
- * @param {object} [opts]
- * @param {string} [opts.proxy] - 显式代理地址（socks5://host:port 等）；传入则直接使用，不读配置
- * @returns {Promise<object>}
- */
-export async function install(opts = {}) {
-  copyBuiltinConfig()
-  const version = getVersion()
-  const registry = getRegistry()
-  const location = getLocation()
-  const osType = getOs()
-  const proxy = opts.proxy || getProxy()
-
-  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`
-  const chromeDir = path.join(location, `chrome-${osType}`)
-  const driverDir = path.join(location, `chromedriver-${osType}`)
-
-  log(`从网络下载 CFT ${version} (${osType})`)
-  if (proxy) log(`使用代理: ${proxy}`)
-
-  for (const url of [chromeUrl, driverUrl]) {
-    const ok = await checkUrlReachable(url, proxy)
-    if (ok) {
-      log(`[OK] 资源可达: ${url}`)
-    } else {
-      log(`[FAIL] 资源不可达: ${url}`)
-      throw downloadError()
-    }
-  }
-
-  try {
-    await downloadExtract(chromeUrl, location, `chrome-${osType}.zip`, chromeDir, proxy)
-    await downloadExtract(driverUrl, location, `chromedriver-${osType}.zip`, driverDir, proxy)
-  } catch (cause) {
-    throw downloadError(cause)
-  }
-
-  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
+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, getProxy, getLocation, copyBuiltinConfig } from './config.js'
+import { parseProxy, openTunnel } from '@wwkit/shared'
+
+const USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36 cft-installer'
+const MANUAL_DOWNLOAD_HINT = '资源下载失败，请在 http://deepbluenet.com/webwork/#/mirror 手动下载资源，并将资源解压到 ~/.config/cft 目录，然后将地址添加到 ~/.config/webwork/webwork.json5 中的 env.SELENIUM_CFT_DIR 属性上'
+
+function log(msg) {
+  console.log(`  ${msg}`)
+}
+
+function sendRequest(url, proxyValue, cb, method = 'GET') {
+  const proxy = parseProxy(proxyValue)
+  const target = new URL(url)
+  const headers = { 'user-agent': USER_AGENT }
+  const onError = (e) => cb(e, null)
+
+  if (!proxy) {
+    const proto = target.protocol === 'https:' ? https : http
+    const req = proto.request(url, { headers, method }, (res) => cb(null, res))
+    req.on('error', onError)
+    req.end()
+    return
+  }
+
+  if (proxy.protocol === 'http:' && target.protocol === 'http:') {
+    const req = http.request({
+      host: proxy.hostname,
+      port: Number(proxy.port) || 80,
+      path: url,
+      method,
+      headers: { ...headers, host: target.host },
+    }, (res) => cb(null, res))
+    req.on('error', onError)
+    req.end()
+    return
+  }
+
+  openTunnel(proxy, target).then((socket) => {
+    const proto = target.protocol === 'https:' ? https : http
+    const req = proto.request({
+      method,
+      hostname: target.hostname,
+      port: Number(target.port) || (target.protocol === 'https:' ? 443 : 80),
+      path: target.pathname + target.search,
+      headers: { ...headers, host: target.host },
+      agent: false,
+      createConnection: () => socket,
+    }, (res) => cb(null, res))
+    req.on('error', onError)
+    socket.on('error', onError)
+    req.end()
+  }).catch(onError)
+}
+
+/**
+ * 访问前预检完整路径是否可达（HEAD 请求，非 2xx/3xx 视为不可达）
+ * @param {string} url - 完整下载 URL
+ * @param {string} [proxyValue] - 代理地址
+ * @returns {Promise<boolean>}
+ */
+function checkUrlReachable(url, proxyValue) {
+  return new Promise((resolve) => {
+    sendRequest(url, proxyValue, (err, response) => {
+      if (err) { resolve(false); return }
+      response.resume()
+      if (response.statusCode >= 200 && response.statusCode < 400) {
+        resolve(true)
+      } else if (response.statusCode === 405) {
+        // 405 Method Not Allowed — 服务器已响应，仅不支持 HEAD
+        resolve(true)
+      } else {
+        resolve(false)
+      }
+    }, 'HEAD')
+  })
+}
+
+/**
+ * 下载失败时的统一终止提示
+ * @param {Error} [cause] - 原始错误
+ */
+function downloadError(cause) {
+  const err = new Error(MANUAL_DOWNLOAD_HINT)
+  if (cause) err.cause = cause
+  return err
+}
+
+function downloadFile(url, destPath, proxyValue, redirects = 0) {
+  return new Promise((resolve, reject) => {
+    if (redirects > 5) {
+      reject(new Error(`Too many redirects: ${url}`))
+      return
+    }
+    const filename = path.basename(destPath)
+    log(`下载 ${filename} ...`)
+
+    sendRequest(url, proxyValue, (err, response) => {
+      if (err) { reject(err); return }
+      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, proxyValue, 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()
+      })
+      file.on('error', reject)
+      response.on('error', reject)
+    })
+  })
+}
+
+async function downloadExtract(url, saveDir, filename, extractDir, proxyValue) {
+  const filePath = path.join(saveDir, filename)
+  await downloadFile(url, filePath, proxyValue)
+
+  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
+    if (!packageManager) {
+      log(`${label}: 缺少系统依赖 ${missing.join(', ')}，未检测到 apt-get/dnf，请手动安装`)
+      continue
+    }
+    const { packages, unknown } = mapToPackages(missing, packageManager)
+    if (packages.length) {
+      log(`${label}: 自动安装系统依赖 ${packages.join(', ')}`)
+      installDeps(packages, packageManager)
+    }
+    if (unknown.length) {
+      log(`${label}: 无法自动映射的库 ${unknown.join(', ')}，请手动安装`)
+    }
+  }
+}
+
+/**
+ * 安装 CFT（Chrome + ChromeDriver）
+ * @param {object} [opts]
+ * @param {string} [opts.proxy] - 显式代理地址（socks5://host:port 等）；传入则直接使用，不读配置
+ * @returns {Promise<object>}
+ */
+export async function install(opts = {}) {
+  copyBuiltinConfig()
+  const version = getVersion()
+  const registry = getRegistry()
+  const location = getLocation()
+  const osType = getOs()
+  const proxy = opts.proxy || getProxy()
+
+  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`
+  const chromeDir = path.join(location, `chrome-${osType}`)
+  const driverDir = path.join(location, `chromedriver-${osType}`)
+
+  log(`从网络下载 CFT ${version} (${osType})`)
+  if (proxy) log(`使用代理: ${proxy}`)
+
+  for (const url of [chromeUrl, driverUrl]) {
+    const ok = await checkUrlReachable(url, proxy)
+    if (ok) {
+      log(`[OK] 资源可达: ${url}`)
+    } else {
+      log(`[FAIL] 资源不可达: ${url}`)
+      throw downloadError()
+    }
+  }
+
+  try {
+    await downloadExtract(chromeUrl, location, `chrome-${osType}.zip`, chromeDir, proxy)
+    await downloadExtract(driverUrl, location, `chromedriver-${osType}.zip`, driverDir, proxy)
+  } catch (cause) {
+    throw downloadError(cause)
+  }
+
+  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
 }