cursor-byok/Taskfile.yml

version: "3"

includes:
  common: ./build/Taskfile.yml
  windows: ./build/windows/Taskfile.yml
  darwin: ./build/darwin/Taskfile.yml
  linux: ./build/linux/Taskfile.yml

vars:
  APP_NAME: "Cursor助手"
  BIN_DIR: "bin"
  APP_VERSION:
    sh: 'go run ./scripts/release version -config ./build/config.yml'
  RELEASE_REPO: "leookun/cursor-byok"
  RELEASE_BASE_NAME: "cursor-byok"
  RELEASE_SOURCE_PATH: "release-notes.md"
  RELEASE_DIR: '{{.BIN_DIR}}/release/{{.APP_VERSION}}'
  RELEASE_NOTES_PATH: '{{.RELEASE_DIR}}/.release-notes.md'
  VITE_PORT: '{{.WAILS_VITE_PORT | default 9245}}'
  SCAN: '{{.SCAN | default "false"}}'
  CURRENT_WINDOWS_ARCH: '{{if eq ARCH "386"}}386{{else}}amd64{{end}}'
  CURRENT_WINDOWS_NAME: '{{if eq .CURRENT_WINDOWS_ARCH "386"}}windows-32{{else}}windows-64{{end}}'
  CURRENT_DARWIN_NAME: '{{if eq ARCH "arm64"}}macos-arm64{{else}}macos-intel{{end}}'
  CURRENT_LINUX_ARCH: "amd64"
  CURRENT_LINUX_NAME: "linux-amd64"

tasks:
  build:
    summary: 构建当前系统分发包
    preconditions:
      - sh: '[ "{{OS}}" = "darwin" ] || [ "{{OS}}" = "windows" ] || [ "{{OS}}" = "linux" ]'
        msg: "仅支持在 macOS、Windows 或 Linux 上执行 task build"
    cmds:
      - task: clean:dist
      - task: build:current

  run:
    summary: 运行当前系统版本
    cmds:
      - task: "{{OS}}:run"

  build:all:
    summary: 构建全部 macOS/Windows 分发包（Linux 需在原生 Linux 主机单独构建）
    preconditions:
      - sh: '[ "{{OS}}" = "darwin" ]'
        msg: "task build:all 仅支持在 macOS 上执行；Linux 需在原生 Linux 主机构建。"
    cmds:
      - task: clean:dist
      - task: build:darwin:arm64
      - task: build:darwin:amd64
      - task: build:windows:386
      - task: build:windows:amd64

  build:current:
    internal: true
    cmds:
      - task: '{{if eq OS "darwin"}}build:darwin:current{{else if eq OS "linux"}}build:linux:current{{else}}build:windows:current{{end}}'

  build:darwin:current:
    internal: true
    cmds:
      - task: darwin:package:dmg
        vars:
          ARCH: '{{ARCH}}'
          BINARY_NAME: '{{.CURRENT_DARWIN_NAME}}'
          OUTPUT: '{{.BIN_DIR}}/{{.CURRENT_DARWIN_NAME}}'
          APP_BUNDLE: '{{.CURRENT_DARWIN_NAME}}.app'
          DMG_NAME: '{{.CURRENT_DARWIN_NAME}}.dmg'
          SCAN: '{{.SCAN}}'

  build:darwin:arm64:
    internal: false
    cmds:
      - task: darwin:package:dmg
        vars:
          ARCH: arm64
          BINARY_NAME: macos-arm64
          OUTPUT: '{{.BIN_DIR}}/macos-arm64'
          APP_BUNDLE: macos-arm64.app
          DMG_NAME: macos-arm64.dmg
          SCAN: '{{.SCAN}}'

  build:darwin:amd64:
    internal: true
    cmds:
      - task: darwin:package:dmg
        vars:
          ARCH: amd64
          BINARY_NAME: macos-intel
          OUTPUT: '{{.BIN_DIR}}/macos-intel'
          APP_BUNDLE: macos-intel.app
          DMG_NAME: macos-intel.dmg
          SCAN: '{{.SCAN}}'

  build:windows:current:
    internal: true
    cmds:
      - task: windows:create:zip
        vars:
          ARCH: '{{.CURRENT_WINDOWS_ARCH}}'
          OUTPUT: '{{.BIN_DIR}}/{{.CURRENT_WINDOWS_NAME}}.exe'
          ZIP_NAME: '{{.CURRENT_WINDOWS_NAME}}.zip'
          SCAN: '{{.SCAN}}'

  build:windows:386:
    internal: true
    cmds:
      - task: windows:create:zip
        vars:
          ARCH: 386
          OUTPUT: '{{.BIN_DIR}}/windows-32.exe'
          ZIP_NAME: windows-32.zip
          SCAN: '{{.SCAN}}'

  build:windows:amd64:
    cmds:
      - task: windows:create:zip
        vars:
          ARCH: amd64
          OUTPUT: '{{.BIN_DIR}}/windows-64.exe'
          ZIP_NAME: windows-64.zip
          SCAN: '{{.SCAN}}'

  build:linux:current:
    internal: true
    cmds:
      - task: linux:package:archive
        vars:
          ARCH: '{{.CURRENT_LINUX_ARCH}}'
          BINARY_NAME: '{{.CURRENT_LINUX_NAME}}'
          OUTPUT: '{{.BIN_DIR}}/{{.CURRENT_LINUX_NAME}}'
          ARCHIVE_BINARY_NAME: '{{.APP_NAME}}'
          ARCHIVE_PATH: '{{.BIN_DIR}}/{{.CURRENT_LINUX_NAME}}.tar.gz'
          SCAN: '{{.SCAN}}'

  build:linux:amd64:
    cmds:
      - task: linux:package:archive
        vars:
          ARCH: amd64
          BINARY_NAME: linux-amd64
          OUTPUT: '{{.BIN_DIR}}/linux-amd64'
          ARCHIVE_BINARY_NAME: '{{.APP_NAME}}'
          ARCHIVE_PATH: '{{.BIN_DIR}}/linux-amd64.tar.gz'
          SCAN: '{{.SCAN}}'

  cursor-tab-server:docker:amd64:
    summary: 构建 cursor-tab-server 的 linux/amd64 Docker 镜像并保存到 cursor-tab-server 目录
    vars:
      IMAGE_NAME: '{{.IMAGE_NAME | default "cursor-tab-server:linux-amd64"}}'
      IMAGE_TAR: '{{.IMAGE_TAR | default "cursor-tab-server/cursor-tab-server-linux-amd64.tar"}}'
      CONTEXT_DIR: cursor-tab-server
      DOCKERFILE: cursor-tab-server/Dockerfile
    preconditions:
      - sh: docker info >/dev/null 2>&1
        msg: "未检测到可用的 Docker daemon，请先启动 Docker。"
      - sh: test -f "{{.DOCKERFILE}}"
        msg: "未找到 cursor-tab-server/Dockerfile。"
      - sh: test -f "{{.CONTEXT_DIR}}/go.mod"
        msg: "未找到 cursor-tab-server/go.mod。"
    cmds:
      - mkdir -p "{{.CONTEXT_DIR}}"
      - docker build --platform linux/amd64 -t "{{.IMAGE_NAME}}" -f "{{.DOCKERFILE}}" "{{.CONTEXT_DIR}}"
      - docker save "{{.IMAGE_NAME}}" -o "{{.IMAGE_TAR}}"
      - ls -lh "{{.IMAGE_TAR}}"

  clean:dist:
    internal: true
    cmds:
      - mkdir -p "{{.BIN_DIR}}"
      - rm -f "{{.BIN_DIR}}/macos-arm64.dmg" "{{.BIN_DIR}}/macos-intel.dmg" "{{.BIN_DIR}}/windows-32.zip" "{{.BIN_DIR}}/windows-64.zip" "{{.BIN_DIR}}/linux-amd64.tar.gz"
      - rm -f "{{.BIN_DIR}}/macos-arm64" "{{.BIN_DIR}}/macos-intel" "{{.BIN_DIR}}/windows-32.exe" "{{.BIN_DIR}}/windows-64.exe" "{{.BIN_DIR}}/linux-amd64"
      - rm -f "{{.BIN_DIR}}/{{.APP_NAME}}" "{{.BIN_DIR}}/{{.APP_NAME}}.exe"
      - rm -rf "{{.BIN_DIR}}/macos-arm64.app" "{{.BIN_DIR}}/macos-intel.app" "{{.BIN_DIR}}/{{.APP_NAME}}.app" "{{.BIN_DIR}}/{{.APP_NAME}}.dev.app"

  dev:
    summary: 启动开发模式（前台，终端会保持占用）
    cmds:
      - wails3 dev -config ./build/config.yml -port {{.VITE_PORT}}

  ads:install:
    summary: 安装广告页依赖
    dir: '{{.TASKFILE_DIR}}/ads-page'
    sources:
      - package.json
      - yarn.lock
    generates:
      - node_modules
    cmds:
      - yarn install --frozen-lockfile

  ads:dev:
    summary: 启动广告页开发服务（http://127.0.0.1:5174/ad/）
    dir: '{{.TASKFILE_DIR}}/ads-page'
    deps:
      - task: ads:install
    cmds:
      - yarn dev

  ads:build:
    summary: 构建广告 ZIP 产物
    dir: '{{.TASKFILE_DIR}}/ads-page'
    deps:
      - task: ads:install
    cmds:
      - yarn build

  setup:docker:
    summary: 构建 Linux 交叉编译 Docker 镜像
    cmds:
      - task: common:setup:docker

  release:clean:
    summary: 清理当前版本的发布目录
    cmds:
      - rm -rf "{{.RELEASE_DIR}}"
      - mkdir -p "{{.RELEASE_DIR}}"

  release:ensure:dir:
    internal: true
    cmds:
      - mkdir -p "{{.RELEASE_DIR}}"

  release:notes:
    summary: 从 release-notes.md 生成当前版本的发布说明文件（README.md 仅用于公开仓库同步）
    internal: true
    preconditions:
      - sh: test -f "{{.RELEASE_SOURCE_PATH}}"
        msg: "未找到 release-notes.md，请先创建发布日志文件。"
      - sh: test -n "$(tr -d '[:space:]' < "{{.RELEASE_SOURCE_PATH}}")"
        msg: "release-notes.md 不能为空，请先填写发布日志。"
    cmds:
      - go run ./scripts/release notes -config ./build/config.yml -out "{{.RELEASE_NOTES_PATH}}" -source "{{.RELEASE_SOURCE_PATH}}"

  release:build:macos:arm64:
    cmds:
      - task: darwin:package:archive
        vars:
          ARCH: arm64
          BINARY_NAME: cursor-release-macos-arm64
          OUTPUT: '{{.BIN_DIR}}/cursor-release-macos-arm64'
          APP_BUNDLE: '{{.APP_NAME}}.app'
          ARCHIVE_PATH: '{{.RELEASE_DIR}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-macos-arm64.tar.gz'
          SCAN: '{{.SCAN}}'

  release:build:macos:amd64:
    internal: true
    cmds:
      - task: darwin:package:archive
        vars:
          ARCH: amd64
          BINARY_NAME: cursor-release-macos-amd64
          OUTPUT: '{{.BIN_DIR}}/cursor-release-macos-amd64'
          APP_BUNDLE: '{{.APP_NAME}}.app'
          ARCHIVE_PATH: '{{.RELEASE_DIR}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-macos-amd64.tar.gz'
          SCAN: '{{.SCAN}}'

  release:build:windows:amd64:
    cmds:
      - task: windows:create:zip
        vars:
          ARCH: amd64
          OUTPUT: '{{.BIN_DIR}}/{{.RELEASE_BASE_NAME}}-windows-amd64.exe'
          ZIP_NAME: 'release/{{.APP_VERSION}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-windows-amd64.zip'
          SCAN: '{{.SCAN}}'

  release:build:linux:amd64:
    cmds:
      - task: linux:package:archive
        vars:
          ARCH: amd64
          BINARY_NAME: cursor-release-linux-amd64
          OUTPUT: '{{.BIN_DIR}}/cursor-release-linux-amd64'
          ARCHIVE_BINARY_NAME: '{{.APP_NAME}}'
          ARCHIVE_PATH: '{{.RELEASE_DIR}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-linux-amd64.tar.gz'
          SCAN: '{{.SCAN}}'

  release:manifest:
    summary: 生成 update.json
    internal: true
    cmds:
      - go run ./scripts/release manifest -config ./build/config.yml -assets-dir "{{.RELEASE_DIR}}" -out "{{.RELEASE_DIR}}/update.json" -repo "{{.RELEASE_REPO}}" -base-name "{{.RELEASE_BASE_NAME}}" -notes "{{.RELEASE_NOTES_PATH}}"

  release:prepare:
    summary: 在当前主机上生成对应的发布资产
    preconditions:
      - sh: '[ "{{OS}}" = "darwin" ] || [ "{{OS}}" = "linux" ]'
        msg: "release:prepare 仅支持在 macOS 或 Linux 上执行。"
      - sh: wails3 version >/dev/null 2>&1
        msg: "未检测到 wails3，请先安装 Wails v3 CLI。"
    cmds:
      - task: '{{if eq OS "darwin"}}release:prepare:darwin{{else}}release:prepare:linux{{end}}'

  release:prepare:darwin:
    summary: 在 macOS 上生成 macOS/Windows/Linux 发布资产
    preconditions:
      - sh: '[ "{{OS}}" = "darwin" ]'
        msg: "release:prepare:darwin 仅支持在 macOS 上执行。"
      - sh: wails3 version >/dev/null 2>&1
        msg: "未检测到 wails3，请先安装 Wails v3 CLI。"
    cmds:
      - task: release:clean
      - task: common:update:build-assets
      - task: release:notes
      - task: release:build:macos:arm64
      - task: release:build:macos:amd64
      - task: release:build:windows:amd64
      - task: release:build:linux:amd64

  release:prepare:linux:
    summary: 在当前主机上生成 Linux 发布资产
    preconditions:
      - sh: '[ "{{OS}}" = "linux" ] || [ "{{OS}}" = "darwin" ]'
        msg: "release:prepare:linux 当前仅支持在 Linux 或 macOS 上执行。"
      - sh: wails3 version >/dev/null 2>&1
        msg: "未检测到 wails3，请先安装 Wails v3 CLI。"
    cmds:
      - task: release:ensure:dir
      - task: common:update:build-assets
      - task: release:notes
      - task: release:build:linux:amd64

  release:verify:assets:
    summary: 验证当前版本发布资产是否齐全
    preconditions:
      - sh: test -f "{{.RELEASE_NOTES_PATH}}"
        msg: "未找到发布说明，请先执行对应的 release:prepare 任务。"
      - sh: test -f "{{.RELEASE_DIR}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-macos-arm64.tar.gz"
        msg: "缺少 macOS arm64 发布资产。"
      - sh: test -f "{{.RELEASE_DIR}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-macos-amd64.tar.gz"
        msg: "缺少 macOS amd64 发布资产。"
      - sh: test -f "{{.RELEASE_DIR}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-windows-amd64.zip"
        msg: "缺少 Windows amd64 发布资产。"
      - sh: test -f "{{.RELEASE_DIR}}/{{.RELEASE_BASE_NAME}}-{{.APP_VERSION}}-linux-amd64.tar.gz"
        msg: "缺少 Linux amd64 发布资产。"
    cmds:
      - echo "release assets verified"

  release:sync:readme:
    summary: 同步 README 到公开发布仓库（发布日志来源固定为 release-notes.md）
    internal: true
    env:
      GH_PAGER: cat
      GIT_PAGER: cat
      PAGER: cat
    preconditions:
      - sh: gh --version >/dev/null 2>&1
        msg: "未检测到 gh，请先安装 GitHub CLI。"
      - sh: gh auth token >/dev/null 2>&1
        msg: "gh 未登录，请先执行 gh auth login。"
    cmds:
      - |
        python3 - <<'PY'
        import base64
        import json
        import pathlib
        import subprocess
        import sys
        import time

        RETRYABLE_TOKENS = ("EOF", "timeout", "TLS", "temporarily unavailable", "connection reset", "connection refused")

        def run_gh(cmd, *, input_text=None, allow_404=False, retries=4):
            last = None
            for attempt in range(1, retries + 1):
                completed = subprocess.run(
                    cmd,
                    input=input_text,
                    text=True,
                    capture_output=True,
                )
                if completed.returncode == 0:
                    return completed
                stderr = (completed.stderr or "").strip()
                stdout = (completed.stdout or "").strip()
                combined = f"{stderr}\n{stdout}".strip()
                if allow_404 and "404" in combined:
                    return completed
                last = completed
                if not any(token.lower() in combined.lower() for token in RETRYABLE_TOKENS):
                    return completed
                if attempt < retries:
                    time.sleep(min(2 ** (attempt - 1), 5))
            return last

        repo = "{{.RELEASE_REPO}}"
        readme_path = pathlib.Path("README.md")
        content = readme_path.read_bytes()
        encoded = base64.b64encode(content).decode("ascii")

        get_cmd = [
            "gh", "api",
            f"repos/{repo}/contents/README.md",
        ]
        result = run_gh(get_cmd, allow_404=True)

        payload = {
            "message": "docs: sync README from source repo",
            "content": encoded,
            "branch": "main",
        }

        if result.returncode == 0:
            existing = json.loads(result.stdout)
            existing_content = base64.b64decode(existing["content"])
            if existing_content == content:
                sys.exit(0)
            payload["sha"] = existing["sha"]

        put_cmd = [
            "gh", "api",
            f"repos/{repo}/contents/README.md",
            "--method", "PUT",
            "--input", "-",
        ]
        completed = run_gh(put_cmd, input_text=json.dumps(payload))
        if completed.returncode != 0 and completed.stderr:
            sys.stderr.write(completed.stderr)
        sys.exit(completed.returncode)
        PY

  release:github:
    summary: 发布当前版本到 GitHub Releases
    env:
      GH_PAGER: cat
      GIT_PAGER: cat
      PAGER: cat
    preconditions:
      - sh: gh --version >/dev/null 2>&1
        msg: "未检测到 gh，请先安装 GitHub CLI。"
      - sh: gh auth token >/dev/null 2>&1
        msg: "gh 未登录，请先执行 gh auth login。"
    cmds:
      - task: release:verify:assets
      - task: release:manifest
      - task: release:sync:readme
      - |
        python3 - <<'PY'
        import mimetypes
        import json
        import pathlib
        import subprocess
        import sys
        import time

        RETRYABLE_TOKENS = ("EOF", "timeout", "TLS", "temporarily unavailable", "connection reset", "connection refused")

        def run_gh(cmd, *, input_text=None, allow_404=False, retries=4):
            last = None
            for attempt in range(1, retries + 1):
                completed = subprocess.run(
                    cmd,
                    input=input_text,
                    text=True,
                    capture_output=True,
                )
                if completed.returncode == 0:
                    return completed
                stderr = (completed.stderr or "").strip()
                stdout = (completed.stdout or "").strip()
                combined = f"{stderr}\n{stdout}".strip()
                if allow_404 and "404" in combined:
                    return completed
                last = completed
                if not any(token.lower() in combined.lower() for token in RETRYABLE_TOKENS):
                    return completed
                if attempt < retries:
                    time.sleep(min(2 ** (attempt - 1), 5))
            return last

        repo = "{{.RELEASE_REPO}}"
        version = "{{.APP_VERSION}}"
        tag = f"v{version}"
        notes = pathlib.Path("{{.RELEASE_NOTES_PATH}}").read_text(encoding="utf-8")
        assets = sorted([
            pathlib.Path("{{.RELEASE_DIR}}/update.json"),
            *pathlib.Path("{{.RELEASE_DIR}}").glob("*.tar.gz"),
            *pathlib.Path("{{.RELEASE_DIR}}").glob("*.zip"),
        ])

        get_cmd = [
            "gh", "api",
            f"repos/{repo}/releases/tags/{tag}",
        ]
        result = run_gh(get_cmd, allow_404=True)

        payload = {
            "tag_name": tag,
            "target_commitish": "main",
            "name": tag,
            "body": notes,
            "draft": False,
            "prerelease": False,
        }

        if result.returncode == 0:
            release = json.loads(result.stdout)
            release_id = release["id"]
            edit_cmd = [
                "gh", "api",
                f"repos/{repo}/releases/{release_id}",
                "--method", "PATCH",
                "--input", "-",
            ]
            completed = run_gh(edit_cmd, input_text=json.dumps(payload))
            if completed.returncode != 0:
                if completed.stderr:
                    sys.stderr.write(completed.stderr)
                sys.exit(completed.returncode)
            refreshed = run_gh(get_cmd)
            if refreshed.returncode != 0:
                if refreshed.stderr:
                    sys.stderr.write(refreshed.stderr)
                sys.exit(refreshed.returncode)
            release = json.loads(refreshed.stdout)
        else:
            create_cmd = [
                "gh", "api",
                f"repos/{repo}/releases",
                "--method", "POST",
                "--input", "-",
            ]
            completed = run_gh(create_cmd, input_text=json.dumps(payload))
            if completed.returncode != 0:
                sys.stderr.write(completed.stderr)
                sys.exit(completed.returncode)
            release = json.loads(completed.stdout)

        upload_url = release["upload_url"].split("{", 1)[0]
        existing = {asset["name"]: asset["id"] for asset in release.get("assets", [])}

        for asset in assets:
            name = asset.name
            if name in existing:
                delete_cmd = [
                    "gh", "api",
                    f"repos/{repo}/releases/assets/{existing[name]}",
                    "--method", "DELETE",
                ]
                deleted = run_gh(delete_cmd)
                if deleted.returncode != 0:
                    if deleted.stderr:
                        sys.stderr.write(deleted.stderr)
                    sys.exit(deleted.returncode)

            content_type = mimetypes.guess_type(name)[0] or "application/octet-stream"
            upload_cmd = [
                "gh", "api",
                f"{upload_url}?name={name}",
                "--method", "POST",
                "--header", f"Content-Type: {content_type}",
                "--input", str(asset),
            ]
            uploaded = run_gh(upload_cmd)
            if uploaded.returncode != 0:
                if uploaded.stderr:
                    sys.stderr.write(uploaded.stderr)
                sys.exit(uploaded.returncode)
        PY