release: rename artifacts to AgentPack-<ver>-<platform>[-<arch>].<ext>

Adopt a consistent, self-describing naming scheme across all three
platforms so users can tell at a glance which file is theirs:

  AgentPack-1.0.0-windows-x64.exe      (was AgentPack-Setup-1.0.0.exe)
  AgentPack-1.0.0-macos-universal.pkg  (was AgentPack-1.0.0.pkg)
  AgentPack-1.0.0-linux.sh             (was install.sh)

Also bundle linux/install.sh as a release asset so the Linux download
matches Windows/macOS — users can grab a single file instead of relying
on the curl | bash one-liner (which still works, and still documented).

Changed:
- windows/installer.iss OutputBaseFilename
- macos/build-pkg.sh productbuild output path
- .github/workflows/release.yml artifact globs + Linux staging step
- scripts/release.sh filename expectations
- README.md / README.zh-CN.md download table + "Build from Source" output paths

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: yysjasmine

.github/workflows/release.yml

@@ -52,7 +52,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: windows-exe
-          path: dist/AgentPack-Setup-*.exe
+          path: dist/AgentPack-*-windows-*.exe
           if-no-files-found: error
 
   build-macos:
@@ -69,14 +69,20 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: macos-pkg
-          path: dist/AgentPack-*.pkg
+          path: dist/AgentPack-*-macos-*.pkg
           if-no-files-found: error
 
   release:
     name: Create GitHub Release
     needs: [build-windows, build-macos]
     runs-on: ubuntu-latest
     steps:
+      # Checkout so we can grab linux/install.sh for the Linux download.
+      # Nothing to build for Linux — install.sh bootstraps itself by
+      # cloning agent_pack on the user's machine, same shape as the
+      # curl | bash one-liner in the README.
+      - uses: actions/checkout@v4
+
       - name: Download Windows artifact
         uses: actions/download-artifact@v4
         with:
@@ -89,19 +95,29 @@ jobs:
           name: macos-pkg
           path: dist
 
-      - name: Resolve tag
+      - name: Resolve tag and version
         id: tag
         # On tag pushes, github.ref_name is the tag (e.g. v1.0.0).
         # On workflow_dispatch, the user-supplied input is the tag.
+        # Also expose the bare version (no leading v) — build-pkg.sh and
+        # installer.iss both hard-code "1.0.0" internally and we match that.
         run: |
           if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
-            echo "tag=${{ inputs.tag }}" >> "$GITHUB_OUTPUT"
+            tag="${{ inputs.tag }}"
           else
-            echo "tag=${{ github.ref_name }}" >> "$GITHUB_OUTPUT"
+            tag="${{ github.ref_name }}"
           fi
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          echo "version=${tag#v}" >> "$GITHUB_OUTPUT"
+
+      - name: Stage Linux installer
+        # Rename to AgentPack-<ver>-linux.sh so all three downloads share
+        # the same "AgentPack-<ver>-<platform>[-<arch>].<ext>" shape.
+        run: cp linux/install.sh "dist/AgentPack-${{ steps.tag.outputs.version }}-linux.sh"
 
       - name: Generate checksums
         working-directory: dist
+        # Cover all three platforms' downloads.
         run: sha256sum AgentPack-* > SHA256SUMS
 
       - name: Create / update Release
@@ -114,6 +130,7 @@ jobs:
           # silently went missing before upload.
           fail_on_unmatched_files: true
           files: |
-            dist/AgentPack-Setup-*.exe
-            dist/AgentPack-*.pkg
+            dist/AgentPack-*-windows-*.exe
+            dist/AgentPack-*-macos-*.pkg
+            dist/AgentPack-*-linux.sh
             dist/SHA256SUMS

README.md

@@ -89,9 +89,9 @@ Pre-built installers live on the [GitHub Releases page](https://github.com/Sense
 
 | Platform | Download | How to Use |
 |----------|----------|------------|
-| Windows | [`AgentPack-Setup-1.0.0.exe`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-Setup-1.0.0.exe) | Double-click and follow the wizard; installation runs inside WSL2, and the PowerShell window is taken over by the installed agent when setup finishes |
-| macOS | [`AgentPack-1.0.0.pkg`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0.pkg) | Double-click, then complete setup in the Terminal window that opens; the same window becomes the agent's REPL / gateway once installation finishes |
-| Linux | bash one-liner | `curl -fsSL https://raw.githubusercontent.com/SenseTime-FVG/agent_pack/main/linux/install.sh \| bash` — the shell that ran the installer is handed over to the agent via `exec` |
+| Windows | [`AgentPack-1.0.0-windows-x64.exe`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0-windows-x64.exe) | Double-click and follow the wizard; installation runs inside WSL2, and the PowerShell window is taken over by the installed agent when setup finishes |
+| macOS | [`AgentPack-1.0.0-macos-universal.pkg`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0-macos-universal.pkg) | Double-click, then complete setup in the Terminal window that opens; the same window becomes the agent's REPL / gateway once installation finishes |
+| Linux | [`AgentPack-1.0.0-linux.sh`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0-linux.sh) *or* the one-liner below | Download and run `chmod +x AgentPack-1.0.0-linux.sh && ./AgentPack-1.0.0-linux.sh`, or paste `curl -fsSL https://raw.githubusercontent.com/SenseTime-FVG/agent_pack/main/linux/install.sh \| bash` — either way the shell that ran the installer is handed over to the agent via `exec` |
 
 ## Building from Source
 
@@ -104,7 +104,7 @@ cd windows
 iscc installer.iss
 ```
 
-Output: `dist/AgentPack-Setup-1.0.0.exe`
+Output: `dist/AgentPack-1.0.0-windows-x64.exe`
 
 ### macOS (.pkg)
 
@@ -115,7 +115,7 @@ cd macos
 ./build-pkg.sh
 ```
 
-Output: `dist/AgentPack-1.0.0.pkg`
+Output: `dist/AgentPack-1.0.0-macos-universal.pkg`
 
 ### Linux
 

README.zh-CN.md

@@ -88,9 +88,9 @@ Bundled skills 已经直接放进 `repos/hermes-agent/skills/` 和 `repos/opencl
 
 | 平台 | 下载 | 使用方式 |
 |------|------|---------|
-| Windows | [`AgentPack-Setup-1.0.0.exe`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-Setup-1.0.0.exe) | 双击运行向导；安装过程在 WSL2 中执行，安装完成后当前 PowerShell 窗口会被接管，直接跑起 agent |
-| macOS | [`AgentPack-1.0.0.pkg`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0.pkg) | 双击后在自动打开的 Terminal 窗口中完成安装；安装结束后同一个窗口会变成 agent 的 REPL / gateway |
-| Linux | bash 一行命令 | `curl -fsSL https://raw.githubusercontent.com/SenseTime-FVG/agent_pack/main/linux/install.sh \| bash` — 安装结束后会在当前 shell 里 `exec` 拉起 agent |
+| Windows | [`AgentPack-1.0.0-windows-x64.exe`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0-windows-x64.exe) | 双击运行向导；安装过程在 WSL2 中执行，安装完成后当前 PowerShell 窗口会被接管，直接跑起 agent |
+| macOS | [`AgentPack-1.0.0-macos-universal.pkg`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0-macos-universal.pkg) | 双击后在自动打开的 Terminal 窗口中完成安装；安装结束后同一个窗口会变成 agent 的 REPL / gateway |
+| Linux | [`AgentPack-1.0.0-linux.sh`](https://github.com/SenseTime-FVG/agent_pack/releases/latest/download/AgentPack-1.0.0-linux.sh) 或下面的一行命令 | 下载后 `chmod +x AgentPack-1.0.0-linux.sh && ./AgentPack-1.0.0-linux.sh`，或直接粘贴 `curl -fsSL https://raw.githubusercontent.com/SenseTime-FVG/agent_pack/main/linux/install.sh \| bash` — 两种方式都会在安装结束后用 `exec` 在当前 shell 里拉起 agent |
 
 ## 从源码构建
 
@@ -103,7 +103,7 @@ cd windows
 iscc installer.iss
 ```
 
-产物：`dist/AgentPack-Setup-1.0.0.exe`
+产物：`dist/AgentPack-1.0.0-windows-x64.exe`
 
 ### macOS (.pkg)
 
@@ -114,7 +114,7 @@ cd macos
 ./build-pkg.sh
 ```
 
-产物：`dist/AgentPack-1.0.0.pkg`
+产物：`dist/AgentPack-1.0.0-macos-universal.pkg`
 
 ### Linux
 

macos/build-pkg.sh

@@ -33,10 +33,10 @@ productbuild \
     --distribution "$SCRIPT_DIR/distribution.xml" \
     --resources "$SCRIPT_DIR/resources" \
     --package-path "$BUILD_DIR" \
-    "$DIST_DIR/AgentPack-$VERSION.pkg"
+    "$DIST_DIR/AgentPack-$VERSION-macos-universal.pkg"
 
 echo ""
-echo "Built: $DIST_DIR/AgentPack-$VERSION.pkg"
+echo "Built: $DIST_DIR/AgentPack-$VERSION-macos-universal.pkg"
 
 # Cleanup
 rm -rf "$BUILD_DIR"

scripts/release.sh

@@ -10,7 +10,7 @@
 #   scripts/release.sh v1.0.0 --notes-file RELEASE_NOTES.md
 #
 # What it does:
-#   1. Verifies dist/AgentPack-Setup-<ver>.exe exists (mandatory).
+#   1. Verifies dist/AgentPack-<ver>-windows-x64.exe exists (mandatory).
 #   2. Includes dist/AgentPack-<ver>.pkg if present (skipped with a warning
 #      otherwise — you can re-run with --include-pkg-only after you build
 #      the .pkg on a Mac, and `gh release upload` will add it then).
@@ -56,10 +56,17 @@ command -v sha256sum >/dev/null 2>&1 || command -v shasum >/dev/null 2>&1 \
     || die "sha256sum / shasum not found."
 
 # Extract the version from the tag (strip leading v).  We use it to locate
-# files by exact name, so a tag like v1.0.0 must match AgentPack-Setup-1.0.0.exe.
+# files by exact name, so a tag like v1.0.0 must match the
+# AgentPack-1.0.0-<platform>[-<arch>].<ext> naming produced by the builders.
 VER="${TAG#v}"
-EXE="$DIST_DIR/AgentPack-Setup-${VER}.exe"
-PKG="$DIST_DIR/AgentPack-${VER}.pkg"
+EXE="$DIST_DIR/AgentPack-${VER}-windows-x64.exe"
+PKG="$DIST_DIR/AgentPack-${VER}-macos-universal.pkg"
+# Stage the Linux installer next to the other artifacts.  linux/install.sh
+# is a self-bootstrapping script — if the user downloads just this file and
+# runs it, it'll clone agent_pack on its own (same shape as the curl | bash
+# one-liner in the README) — so nothing to build, just copy + rename.
+LINUX_SRC="$PROJECT_ROOT/linux/install.sh"
+LINUX_DST="$DIST_DIR/AgentPack-${VER}-linux.sh"
 
 # Collect whatever's actually built.  The .exe is required — releasing
 # without the Windows installer would mean the README links 404 on Windows.
@@ -77,6 +84,13 @@ else
     echo "    Then: gh release upload $TAG '$PKG' --clobber" >&2
 fi
 
+# Linux installer: copy from linux/ into dist/ so SHA256SUMS and gh upload
+# both see it under a flat, versionless name.
+[ -f "$LINUX_SRC" ] || die "Missing $LINUX_SRC (unexpected — it's tracked in git)."
+cp "$LINUX_SRC" "$LINUX_DST"
+FILES+=("$LINUX_DST")
+ok "Staged $(basename "$LINUX_DST") (from linux/install.sh)"
+
 # Generate checksums for everything we're about to upload.
 CHECKSUMS="$DIST_DIR/SHA256SUMS"
 note "Writing $CHECKSUMS"

windows/installer.iss

@@ -15,7 +15,7 @@ AppPublisherURL={#MyAppURL}
 DefaultDirName={autopf}\AgentPack
 DefaultGroupName={#MyAppName}
 OutputDir=..\dist
-OutputBaseFilename=AgentPack-Setup-{#MyAppVersion}
+OutputBaseFilename=AgentPack-{#MyAppVersion}-windows-x64
 Compression=lzma2
 SolidCompression=yes
 WizardStyle=modern