Tester: cache zotero installer and program files

[northword]

zotero/client-downloads repo

### manifests/{release,beta,dev}/updates-{mac,win32,win-x64,win-arm64,linux-i686,linux-x86_64}.json

[
  {
    "major": null,
    "version": "5.0-beta.209+98544edde",
    "detailsURL": "https://www.zotero.org/support/5.0_changelog",
    "buildID": "20170608144058"
  }
]

Base uri is https://www.zotero.org/download/client/.

For request:

GET https://www.zotero.org/download/client/manifests/beta/updates-win-x64.json

Response:

[
  {
    "version": "7.1-beta.35+03b33d995",
    "buildID": "20250503055820",
    "detailsURL": "https://www.zotero.org/support/7.1_changelog",
    "major": null
  },
  {
    "version": "7.1-beta.36+1eacc8bbd",
    "buildID": "20250510044543",
    "detailsURL": "https://www.zotero.org/support/7.1_changelog",
    "major": null
  },
  {
    "version": "7.1-beta.37+e50787c94",
    "buildID": "20250611052747",
    "detailsURL": "https://www.zotero.org/support/7.1_changelog",
    "major": null
  },
  {
    "version": "7.1-beta.38+408f1274f",
    "buildID": "20250614052306",
    "detailsURL": "https://www.zotero.org/support/7.1_changelog",
    "major": null
  },
  {
    "version": "7.1-beta.39+0acfcd3f9",
    "buildID": "20250619110523",
    "detailsURL": "https://www.zotero.org/support/7.1_changelog",
    "major": null
  }
]

我们可以先请求此链接获取最新版本的版本号和 buildID，并以 zotero-{{arch}}-{{version}}-{{buildID}} 为 cache key，对安装包和解压后的文件进行缓存。

[northword]

可以为此创建一个单独的 Action，如 zotero-plugin-dev/action-setup-zotero。

来自 GPT 的快速反馈：

好的，下面是一个完整的 TypeScript GitHub Action 项目结构，它将：

• 自动获取 Zotero 最新 beta 版本（或自定义）
• 下载并缓存安装包
• 解压并设置环境变量 ZOTERO_PLUGIN_ZOTERO_BIN_PATH
• 自动判断平台是否需要 xvfb-run（Linux CI 环境下）
• 创建一个 wrapper 来强制所有启动命令都通过 xvfb-run（如需要）

📁 项目结构（简化）

setup-zotero/
├── action.yml
├── package.json
├── tsconfig.json
├── src/
│   └── main.ts
├── dist/

📄 action.yml

name: 'Setup Zotero'
description: 'Set up Zotero for plugin development and testing'
inputs:
  architecture:
    description: 'Target architecture'
    required: false
    default: 'linux-x86_64'
  channel:
    description: 'Channel (release | beta | dev)'
    required: false
    default: 'beta'
  version:
    description: 'Specific version to install (optional)'
    required: false
outputs:
  zotero-version:
    description: 'Installed Zotero version'
  zotero-bin-path:
    description: 'Path to Zotero binary'
runs:
  using: 'node20'
  main: 'dist/index.js'

📄 package.json

{
  "name": "setup-zotero",
  "version": "1.0.0",
  "main": "dist/index.js",
  "scripts": {
    "build": "ncc build src/main.ts -o dist"
  },
  "dependencies": {
    "@actions/core": "^1.10.0",
    "@actions/io": "^1.1.2",
    "@actions/tool-cache": "^2.0.1",
    "axios": "^1.6.0",
    "tar": "^6.1.11"
  },
  "devDependencies": {
    "@vercel/ncc": "^0.36.1",
    "typescript": "^5.3.3"
  }
}

📄 tsconfig.json

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "lib": ["ES2020"],
    "outDir": "dist",
    "rootDir": "src",
    "strict": true,
    "esModuleInterop": true
  }
}

📄 src/main.ts

import * as core from '@actions/core'
import * as io from '@actions/io'
import * as tc from '@actions/tool-cache'
import * as path from 'path'
import * as fs from 'fs'
import axios from 'axios'
import * as os from 'os'

async function run() {
  try {
    const arch = core.getInput('architecture') || 'linux-x86_64'
    const channel = core.getInput('channel') || 'beta'
    const versionInput = core.getInput('version')

    const manifestUrl = `https://www.zotero.org/download/client/manifests/${channel}/updates-${arch}.json`
    const { data: manifest } = await axios.get(manifestUrl)

    const versionEntry = versionInput
      ? manifest.find((v: any) => v.version === versionInput)
      : manifest[manifest.length - 1]

    if (!versionEntry) {
      throw new Error(`Version ${versionInput} not found in manifest`)
    }

    const version = versionEntry.version
    const buildID = versionEntry.buildID
    const cacheKey = `zotero-${channel}-${arch}-${version}-${buildID}`
    const cachedPath = tc.find('zotero', version, arch)

    let zoteroPath: string

    if (cachedPath) {
      core.info(`Using cached Zotero: ${cachedPath}`)
      zoteroPath = cachedPath
    } else {
      const downloadUrl = `https://www.zotero.org/download/client/dl?platform=${arch}&channel=${channel}`
      const archivePath = await tc.downloadTool(downloadUrl)
      const extractDir = await tc.extractTar(archivePath)
      zoteroPath = await tc.cacheDir(extractDir, 'zotero', version, arch)
    }

    // Detect platform and setup xvfb-run if needed
    const bin = path.join(zoteroPath, 'zotero')
    const wrappedBin = path.join(zoteroPath, 'zotero-wrapper')

    if (os.platform() === 'linux' && !process.env.DISPLAY) {
      // Rename real binary and create wrapper
      const realBin = path.join(zoteroPath, 'zotero-real')
      await io.mv(bin, realBin)
      fs.writeFileSync(
        bin,
        `#!/bin/bash\nexec xvfb-run -a "${realBin}" "$@"\n`
      )
      await fs.promises.chmod(bin, 0o755)
    }

    core.exportVariable('ZOTERO_PLUGIN_ZOTERO_BIN_PATH', bin)
    core.setOutput('zotero-version', version)
    core.setOutput('zotero-bin-path', bin)
    core.info(`Zotero ${version} setup complete`)
  } catch (error: any) {
    core.setFailed(error.message)
  }
}

run()

🏁 构建并发布

npm install
npm run build
git add dist
git commit -am "build: initial release"
git tag v1
git push origin v1

✅ 功能汇总

功能	支持情况
自定义架构/通道/版本	✅ inputs
自动选择最新版本	✅
下载并缓存 Zotero 安装包	✅
设置 ZOTERO_PLUGIN_ZOTERO_BIN_PATH	✅
输出版本号和路径	✅
Linux CI 自动使用 xvfb-run	✅
纯 TypeScript	✅