@wwkit/opm 1.0.1

package/src/cli/groups/version-manager.js

@@ -0,0 +1,186 @@
+/**
+ * 版本管理器自身命令组基类（nvm / phpenv / uv 共用）
+ *
+ * 三个版本管理器均提供 version / registry / install / upgrade / uninstall / view 动作，
+ * 差异仅在底层命令与安装/升级/卸载方式，故抽象为数据驱动基类。
+ * 新增版本管理器：子类提供 cfg 配置（isInstalled / install / upgrade / uninstall / help 等）即可。
+ */
+
+import { execSync } from 'node:child_process'
+import { parseFlags } from '../helpers/args.js'
+import { Shell } from '@wwkit/shared'
+import { getActiveRegistry, setActiveRegistry, getPresets } from '../../config.js'
+import { output } from '../../formatter.js'
+
+const shell = new Shell()
+
+/**
+ * @typedef {Object} ToolGroupConfig
+ * @property {string} name - 命令名
+ * @property {string} desc - 顶层帮助描述
+ * @property {boolean} [hasRegistry=true] - 是否支持 registry 动作（uv 为 false）
+ * @property {() => boolean} isInstalled
+ * @property {boolean} [needsBash=false] - versionCmd 是否需要 bash（nvm source / phpenv 脚本）；uv 为 false
+ * @property {() => string} getPath - view 展示的安装路径
+ * @property {() => string} versionCmd - 返回查询版本的 shell 命令
+ * @property {(out: string) => string} [parseVersion] - 解析版本输出
+ * @property {() => Object} install - 安装并返回结果字段（失败时 throw）
+ * @property {() => Object} upgrade - 升级并返回结果字段（失败时 throw）
+ * @property {() => Object} uninstall - 卸载并返回结果字段（失败时 throw）
+ * @property {string} usage - 帮助 usage 行
+ * @property {[string,string][]} actions - 帮助动作表 [签名, 描述]
+ * @property {string[]} examples - 帮助示例
+ */
+
+export class ToolManagerGroup {
+  /**
+   * @param {ToolGroupConfig} cfg
+   */
+  constructor(cfg) {
+    this.name = cfg.name
+    this.desc = cfg.desc
+    this.hasRegistry = cfg.hasRegistry !== false
+    this.cfg = cfg
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    if (action === 'registry' && !this.hasRegistry) {
+      console.error(`Action "registry" is not supported for ${this.name}`)
+      this.printHelp()
+      process.exit(1)
+    }
+
+    switch (action) {
+      case 'version':
+        return this._version()
+      case 'installed':
+        return this._installed()
+      case 'registry':
+        return this._registry(parseFlags(rest))
+      case 'install':
+        return this._install()
+      case 'upgrade':
+        return this._upgrade()
+      case 'uninstall':
+        return this._uninstall()
+      case 'dir':
+        return this._dir()
+      default:
+        console.error(`Unknown action: ${action}`)
+        this.printHelp()
+        process.exit(1)
+    }
+  }
+
+  _version() {
+    if (!this.cfg.isInstalled()) {
+      output('')
+      return
+    }
+    try {
+      const out = execSync(this.cfg.versionCmd(), { encoding: 'utf8', shell: shell.shellForExec(this.cfg.needsBash) })
+      const parsed = this.cfg.parseVersion ? this.cfg.parseVersion(out) : out.trim()
+      output(parsed.replace(/^v/, ''))
+    } catch {
+      output('')
+    }
+  }
+
+  _registry(parsed) {
+    const [sub, ...args] = parsed.positional
+    if (sub === 'set') {
+      const url = args[0]
+      if (!url) {
+        console.error(`Usage: opm ${this.name} registry set <url|preset>`)
+        process.exit(1)
+      }
+      output({ registry: setActiveRegistry(this.name, url) })
+    } else if (sub === 'presets') {
+      const items = Object.entries(getPresets(this.name)).map(([n, u]) => ({ name: n, url: u }))
+      output(items)
+    } else {
+      output({ registry: getActiveRegistry(this.name) })
+    }
+  }
+
+  _install() {
+    if (this.cfg.isInstalled()) {
+      output({ name: this.name, installed: true, hint: `${this.name} already installed, run \`opm ${this.name} upgrade\` to update` })
+      return
+    }
+    try {
+      output({ name: this.name, installed: true, ...(this.cfg.install() || {}) })
+    } catch (err) {
+      console.error(err.message || `Failed to install ${this.name}`)
+      process.exit(1)
+    }
+  }
+
+  _upgrade() {
+    if (!this.cfg.isInstalled()) {
+      console.error(`${this.name} not installed, run \`opm ${this.name} install\` first`)
+      process.exit(1)
+    }
+    try {
+      output({ name: this.name, ...(this.cfg.upgrade() || {}) })
+    } catch (err) {
+      console.error(err.message || `Failed to upgrade ${this.name}`)
+      process.exit(1)
+    }
+  }
+
+  _uninstall() {
+    if (!this.cfg.isInstalled()) {
+      output({ name: this.name, installed: false, hint: `${this.name} not installed` })
+      return
+    }
+    try {
+      output({ name: this.name, ...(this.cfg.uninstall() || {}) })
+    } catch (err) {
+      console.error(err.message || `Failed to remove ${this.name}`)
+      process.exit(1)
+    }
+  }
+
+  _dir() {
+    const installed = this.cfg.isInstalled()
+    output({ name: this.name, installed, install: installed ? this.cfg.getPath() : '' })
+  }
+
+  _installed() {
+    const installed = this.cfg.isInstalled()
+    const result = { name: this.name, installed }
+    if (installed) {
+      result.path = this.cfg.getPath()
+      try {
+const out = execSync(this.cfg.versionCmd(), { encoding: 'utf8', shell: shell.shellForExec(this.cfg.needsBash) })
+        result.version = this.cfg.parseVersion ? this.cfg.parseVersion(out) : out.trim()
+      } catch {}
+    }
+    output(result)
+  }
+
+  printHelp() {
+    const actionLines = this.cfg.actions.map(([sig, desc]) => `  ${sig.padEnd(34)} ${desc}`).join('\n')
+    const exampleLines = this.cfg.examples.map((e) => `  ${e}`).join('\n')
+    console.log(`
+Usage: ${this.cfg.usage}
+
+Actions:
+${actionLines}
+
+Options:
+  -h, --help      Show this help
+
+Examples:
+${exampleLines}
+`)
+  }
+}

package/src/cli/helpers/args.js

@@ -0,0 +1,49 @@
+/**
+ * 共享命令行参数解析器
+ *
+ * 支持以下格式的参数：
+ *   --flag value        长标志（空格分隔）
+ *   --flag=value        长标志（等号形式）
+ *   -f value           短标志（空格分隔）
+ *   -f=value           短标志（等号形式）
+ *   positional         位置参数（不以 - 开头）
+ *
+ * @param {string[]} argv - 原始参数数组
+ * @returns {{ flags: Record<string, string>, positional: string[] }}
+ */
+export function parseFlags(argv) {
+  const flags = {}
+  const positional = []
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i]
+
+    if (arg.startsWith('--') && arg.includes('=')) {
+      const idx = arg.indexOf('=')
+      flags[arg.slice(2, idx)] = arg.slice(idx + 1)
+    } else if (arg.startsWith('--')) {
+      const next = argv[i + 1]
+      if (next !== undefined && !next.startsWith('-')) {
+        flags[arg.slice(2)] = next
+        i++
+      } else {
+        flags[arg.slice(2)] = 'true'
+      }
+    } else if (arg.startsWith('-') && arg.includes('=')) {
+      const idx = arg.indexOf('=')
+      flags[arg.slice(1, idx)] = arg.slice(idx + 1)
+    } else if (arg.startsWith('-') && arg.length > 1) {
+      const next = argv[i + 1]
+      if (next !== undefined && !next.startsWith('-')) {
+        flags[arg.slice(1)] = next
+        i++
+      } else {
+        flags[arg.slice(1)] = 'true'
+      }
+    } else {
+      positional.push(arg)
+    }
+  }
+
+  return { flags, positional }
+}

package/src/cli/index.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+
+/**
+ * opm CLI 入口
+ *
+ * 统一命令行工具，聚合包管理与配置查看。顶层命令按「命令组」组织，
+ * 注册表见下方 GROUPS（帮助、命令列表均由 GROUPS 动态生成，无需手动维护）。
+ */
+
+import { pathToFileURL } from 'node:url'
+import { realpathSync, readFileSync } from 'node:fs'
+import { PackageGroup, RuntimeGroup } from './groups/package.js'
+import { ConfigGroup } from './groups/config.js'
+import { NvmGroup } from './groups/nvm.js'
+import { PhpenvGroup } from './groups/phpenv.js'
+import { UvGroup } from './groups/uv.js'
+import { HomebrewGroup } from './groups/homebrew.js'
+import { EnsureGroup } from './groups/ensure.js'
+import { HarnessGroup } from '../harnesses/base.js'
+import { opencodeHarness } from '../harnesses/opencode/index.js'
+import { CftGroup } from '../binaries/cft/index.js'
+import { generateDocHtml } from './doc.js'
+
+/**
+ * 顶层命令组注册表
+ * 新增命令组：实现 run(argv) + printHelp() + desc 后在此注册（帮助输出自动跟随）。
+ * @type {Record<string, object>}
+ */
+const GROUPS = {
+  npm: new PackageGroup('npm'),
+  pip: new PackageGroup('pip'),
+  dnf: new PackageGroup('dnf'),
+  apt: new PackageGroup('apt'),
+  brew: new PackageGroup('brew'),
+  homebrew: new HomebrewGroup(),
+  composer: new PackageGroup('composer'),
+  bun: new PackageGroup('bun'),
+  winget: new PackageGroup('winget'),
+  node: new RuntimeGroup('node'),
+  nvm: new NvmGroup(),
+  php: new RuntimeGroup('php'),
+  phpenv: new PhpenvGroup(),
+  python: new RuntimeGroup('python'),
+  uv: new UvGroup(),
+  config: new ConfigGroup(),
+  opencode: new HarnessGroup(opencodeHarness),
+  cft: new CftGroup(),
+  ensure: new EnsureGroup(),
+}
+
+class CLI {
+  async run(argv) {
+    const [groupName, ...rest] = argv
+
+    if (!groupName || groupName === '-h' || groupName === '--help' || groupName === 'help') {
+      this.printHelp()
+      return
+    }
+
+    if (groupName === 'version' || groupName === '-v' || groupName === '--version') {
+      const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'))
+      console.log(pkg.version)
+      return
+    }
+
+    if (groupName === 'doc') {
+      generateDocHtml()
+      return
+    }
+
+    const group = GROUPS[groupName]
+    if (!group) {
+      console.error(`Unknown command: ${groupName}`)
+      console.error(`Available commands: ${Object.keys(GROUPS).join(', ')}`)
+      process.exit(1)
+    }
+
+    try {
+      await group.run(rest)
+    } catch (err) {
+      console.error(`[opm] Error: ${err.message}`)
+      process.exit(1)
+    }
+  }
+
+  printHelp() {
+    const groupLines = Object.entries(GROUPS)
+      .map(([name, group]) => `  ${name.padEnd(12)} ${group.desc || group.name}`)
+      .join('\n')
+
+    console.log(`
+Usage: opm <command> [args] [options]
+
+Commands:
+${groupLines}
+  version                   Show opm version
+  doc                       Build docs HTML and open in browser
+
+Options:
+  -g, --global    Global operation (npm: global node_modules; pip: system Python)
+  -p, --proxy <url>  Proxy address (search/info/versions/outdated/install/upgrade)
+  -h, --help      Show help
+
+Run "opm <command> help" for command details.
+
+Examples:
+  opm npm registry set taobao          Set npm registry to taobao mirror
+  opm pip install requests             Install requests
+  opm config                           Show common config (proxy + registries)
+  opm opencode clear                   Clean up opencode sessions before today
+  opm opencode clear --days 7          Keep sessions from the last 7 days
+`)
+  }
+}
+
+if (process.argv[1]) {
+  try {
+    const resolved = pathToFileURL(realpathSync(process.argv[1])).href
+    if (import.meta.url === resolved || import.meta.url === resolved + '/index.js' || import.meta.url === resolved + 'index.js') {
+      const cli = new CLI()
+      cli.run(process.argv.slice(2)).catch((err) => {
+        console.error(`[opm] Error: ${err.message}`)
+        process.exit(1)
+      })
+    }
+  } catch {}
+}
+
+export { CLI, GROUPS }

package/src/config.js

@@ -0,0 +1,133 @@
+/**
+ * opm 配置
+ *
+ * 维护一份用户可编辑的 config.json5（安装后复制到标准配置目录），
+ * 采用 @wwkit/shared 的多层合并读取：
+ *   内置默认(src/config.json5) → 用户文件(~/.config/opm/config.json5) → OPM_CONFIG_CONTENT
+ *
+ * npm/pip/dnf/apt/brew 的 registry 预设与 active（当前激活镜像）都来自合并后的配置，
+ * active 可以是预设 key（如 "taobao"），也可以是完整 URL。
+ */
+
+import fs from 'node:fs'
+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 _loader = createConfigLoader({
+  builtinConfigPath: path.join(__dirname, 'config.json5'),
+  userConfigDir: getXdgConfigDir('opm'),
+  envContentVar: 'OPM_CONFIG_CONTENT',
+  envDirVar: 'OPM_CONFIG_DIR',
+})
+
+export function getUserConfigDir() {
+  return process.env.OPM_CONFIG_DIR || getXdgConfigDir('opm')
+}
+
+export function getUserConfigFile() {
+  return path.join(getUserConfigDir(), 'config.json5')
+}
+
+/**
+ * 读取合并后的完整配置
+ * @returns {object} { proxy, npm:{registry}, pip:{registry}, dnf:{registry}, apt:{registry}, brew:{registry} }
+ */
+export function getConfig() {
+  return _loader.getConfig()
+}
+
+/**
+ * 复制内置配置到用户配置目录（不覆盖已存在文件）
+ * @returns {boolean} 是否写入了新文件
+ */
+export function copyBuiltinConfig() {
+  return _loader.copyBuiltinConfig()
+}
+
+/**
+ * 按点分路径取配置子节点
+ * @param {object} config - getConfig 的返回结果
+ * @param {string} [path] - 如 'proxy' / 'npm.registry'
+ * @returns {*} 子节点；路径为空时返回整个 config
+ */
+export function getSection(config, path) {
+  if (!path) return config
+  return path.split('.').reduce((acc, key) => (acc == null ? undefined : acc[key]), config)
+}
+
+const presetCache = new Map()
+
+/**
+ * 获取指定管理器的镜像预设（不含 active）
+ * @param {string} manager - 管理器名称 (npm/pip/dnf/apt/brew)
+ * @returns {Record<string, string>}
+ */
+export function getPresets(manager) {
+  const cached = presetCache.get(manager)
+  if (cached) return cached
+  const reg = getConfig()[manager]?.registry ?? {}
+  const presets = { ...reg }
+  delete presets.active
+  Object.freeze(presets)
+  presetCache.set(manager, presets)
+  return presets
+}
+
+/**
+ * 解析镜像地址：如果输入是预设 key 则返回对应 URL，否则原样返回
+ * @param {string} input - URL 或预设 key
+ * @param {string} manager - 管理器名称
+ * @returns {string}
+ */
+export function resolveRegistryInput(input, manager) {
+  const presets = getPresets(manager)
+  return presets[input] || input
+}
+
+/**
+ * 解析当前激活镜像地址（key → URL，URL 原样返回）
+ * 未配置 active 时回退到官方源。
+ * @param {string} manager - 管理器名称
+ * @returns {string}
+ */
+export function getActiveRegistry(manager) {
+  const reg = getConfig()[manager]?.registry
+  if (!reg) return ''
+  const active = reg.active
+  if (!active) return reg.official || ''
+  return reg[active] || active
+}
+
+/**
+ * 解析配置中激活的代理地址（key → URL，URL 原样返回）
+ * active 为空时返回 ''（不启用代理）。
+ * @returns {string}
+ */
+export function getActiveProxy() {
+  const proxy = getConfig().proxy ?? {}
+  const active = proxy.active
+  if (!active) return ''
+  return proxy[active] || active
+}
+
+/**
+ * 将指定镜像设为某个管理器的 active，写入用户配置文件
+ * @param {string} manager - 管理器名称
+ * @param {string} input - 预设 key 或完整 URL
+ * @returns {string} 解析后的 URL
+ */
+export function setActiveRegistry(manager, input) {
+  const resolved = resolveRegistryInput(input, manager)
+  const cfg = getConfig()
+  if (!cfg[manager]) cfg[manager] = {}
+  if (!cfg[manager].registry) cfg[manager].registry = {}
+  cfg[manager].registry.active = input
+  presetCache.clear()
+  const userConfigFile = getUserConfigFile()
+  fs.mkdirSync(path.dirname(userConfigFile), { recursive: true })
+  fs.writeFileSync(userConfigFile, `${JSON.stringify(cfg, null, 2)}\n`, 'utf8')
+  return resolved
+}

package/src/config.json5

@@ -0,0 +1,158 @@
+// opm 用户配置（可编辑）
+//
+// 安装后复制到 ~/.config/opm/config.json5（或 $XDG_CONFIG_HOME/opm/config.json5），
+// 通过 OPM_CONFIG_DIR / OPM_CONFIG_CONTENT 可覆盖（测试与特殊场景）。
+// 合并顺序（低 → 高）：内置默认 → 用户文件 → OPM_CONFIG_CONTENT。
+// 字符串中的 {env:XXX} 占位符会在读取时替换为环境变量。
+
+{
+  // 代理预设与当前激活项
+  // active 默认为空（不使用代理）；可改为预设 key（如 "local"）或完整 URL。
+  // 命令行 -p/--proxy 传入时优先使用传入值。
+  proxy: {
+    local: "socks5://127.0.0.1:1080",
+    active: "",
+  },
+
+  // npm 镜像预设与当前激活项
+  // active 可以是预设 key（如 "taobao"），也可以是完整 URL
+  npm: {
+    registry: {
+      official: "https://registry.npmjs.org/",
+      taobao: "https://registry.npmmirror.com/",
+      huawei: "https://cmc.centralrepo.rnd.huawei.com/artifactory/api/npm/npm-central-repo/",
+      active: "taobao",
+    },
+  },
+
+  pip: {
+    registry: {
+      official: "https://pypi.org/simple",
+      tsinghua: "https://pypi.tuna.tsinghua.edu.cn/simple",
+      huawei: "https://cmc.centralrepo.rnd.huawei.com/artifactory/api/pypi/pypi-repo/simple",
+      active: "tsinghua",
+    },
+  },
+
+  dnf: {
+    registry: {
+      hce: "http://his-mirrors.huawei.com/install/hce/2.0/os/x86_64/",
+      "hce-updates": "http://his-mirrors.huawei.com/install/hce/2.0/updates/x86_64/",
+      fedora: "https://download.fedoraproject.org/pub/fedora/linux/releases/$releasever/Everything/$basearch/os/",
+      "fedora-updates": "https://download.fedoraproject.org/pub/fedora/linux/updates/$releasever/Everything/$basearch/",
+      epel: "https://dl.fedoraproject.org/pub/epel/$releasever/Everything/$basearch/",
+      "epel-testing": "https://dl.fedoraproject.org/pub/epel/testing/$releasever/Everything/$basearch/",
+      active: "hce",
+    },
+  },
+
+  apt: {
+    registry: {
+      "ubuntu-tsinghua": "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse",
+      "ubuntu-huawei": "deb https://mirrors.huaweicloud.com/ubuntu/ focal main restricted universe multiverse",
+      "ubuntu-aliyun": "deb http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse",
+      "debian-official": "deb http://deb.debian.org/debian/ bookworm main",
+      "debian-tsinghua": "deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main",
+      active: "ubuntu-tsinghua",
+    },
+  },
+
+  // brew（Homebrew）镜像预设（macOS）
+  // active 指向预设 key（如 "tsinghua"）或 bottle 域名 URL；
+  // 非 official 时 install/upgrade 自动传 HOMEBREW_API_DOMAIN / HOMEBREW_BOTTLE_DOMAIN
+  brew: {
+    registry: {
+      official: "https://ghcr.io/v2/homebrew",
+      tsinghua: "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles",
+      ustc: "https://mirrors.ustc.edu.cn/homebrew-bottles",
+      active: "tsinghua",
+    },
+  },
+
+  // composer（PHP）镜像预设
+  // active 指向预设 key 或 P2 元数据 base URL；
+  // 镜像仅作用于源查询（search/info/versions 的 P2 元数据拉取），
+  // install/upgrade 使用 composer CLI 自身的仓库配置
+  composer: {
+    registry: {
+      official: "https://repo.packagist.org",
+      aliyun: "https://mirrors.aliyun.com/composer",
+      tencent: "https://mirrors.cloud.tencent.com/composer",
+      active: "aliyun",
+    },
+  },
+
+  // bun（Bun runtime + 包管理器）镜像预设
+  // Bun 使用 npm registry，复用相同镜像源
+  // 镜像通过 BUN_CONFIG_REGISTRY 环境变量传递
+  bun: {
+    registry: {
+      official: "https://registry.npmjs.org/",
+      taobao: "https://registry.npmmirror.com/",
+      huawei: "https://cmc.centralrepo.rnd.huawei.com/artifactory/api/npm/npm-central-repo/",
+      active: "taobao",
+    },
+  },
+
+  // nvm 自身镜像预设（git clone 地址）
+  nvm: {
+    registry: {
+      official: "https://github.com/nvm-sh/nvm.git",
+      gitee: "https://gitee.com/mirrors/nvm.git",
+      active: "official",
+    },
+  },
+
+  // node（Node.js）镜像预设（dist 下载地址，传给 NVM_NODEJS_ORG_MIRROR）
+  node: {
+    defaultVersion: "24",
+    registry: {
+      official: "https://nodejs.org/dist",
+      taobao: "https://npmmirror.com/mirrors/node",
+      tsinghua: "https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/",
+      active: "taobao",
+    },
+  },
+
+  // phpenv 自身镜像预设（git clone 地址）
+  phpenv: {
+    registry: {
+      official: "https://github.com/phpenv/phpenv.git",
+      gitee: "https://gitee.com/mirrors/phpenv.git",
+      active: "official",
+    },
+  },
+
+  // php（PHP runtime）镜像预设（dist 下载地址，传给 PHP_BUILD_MIRROR_URL）
+  php: {
+    defaultVersion: "8.3",
+    registry: {
+      official: "https://www.php.net/distributions",
+      tsinghua: "https://mirrors.tuna.tsinghua.edu.cn/php",
+      ustc: "https://mirrors.ustc.edu.cn/php",
+      active: "official",
+    },
+  },
+
+  // python（Python runtime）镜像预设（传给 UV_PYTHON_INSTALL_MIRROR）
+  // uv 从 python-build-standalone GitHub releases 下载 Python 发行版
+  python: {
+    defaultVersion: "3.12",
+    registry: {
+      official: "https://github.com/astral-sh/python-build-standalone/releases/download",
+      ghproxy: "https://ghproxy.com/https://github.com/astral-sh/python-build-standalone/releases/download",
+      active: "official",
+    },
+  },
+
+  // cft（Chrome for Testing）二进制工具
+  // install 缺省版本 + registry 预设（active 默认用镜像，而非 official）
+  cft: {
+    defaultVersion: "141.0.7390.54",
+    registry: {
+      official: "https://googlechromelabs.github.io/chrome-for-testing",
+      npmmirror: "https://npmmirror.com/mirrors/chrome-for-testing",
+      active: "npmmirror",
+    },
+  },
+}

package/src/formatter.js

@@ -0,0 +1,13 @@
+/**
+ * 输出格式化工具
+ *
+ * 统一以 JSON 格式输出（默认即 JSON，无 human 模式）。
+ */
+
+/**
+ * 格式化输出结果
+ * @param {*} data - 要输出的数据
+ */
+export function output(data) {
+  console.log(JSON.stringify(data, null, 2))
+}