feat(deploy): 新增 Windows 桌面客户端构建与发布支持

CI 拆成三个 job（mac 构建 Linux/Web、windows 构建 Windows 桌面、mac 发布部署）；新增 compile-windows.sh 用 Flutter 构建并打包为 jiu-windows-x64.zip；release.sh 自动写入 Windows 下载 URL 到 version.yaml 并上传 zip。下载页 Windows 卡片从"敬请期待"改为真实下载按钮，URL 由 API 动态填充。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.gitea/workflows/deploy.yml

@@ -6,7 +6,7 @@ on:
       - 'v[0-9]*.[0-9]*.[0-9]*'
 
 jobs:
-  deploy:
+  build-linux-web:
     runs-on: mac
     env:
       GOPROXY: https://goproxy.cn,direct
@@ -16,9 +16,58 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Compile
+      - name: Compile (Linux backend + Flutter Web)
         run: sh scripts/ci/compile.sh "${{ gitea.ref_name }}"
 
+      - name: Upload linux-web artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: linux-web
+          path: dist/
+
+  build-windows:
+    runs-on: windows
+    env:
+      GOPROXY: https://goproxy.cn,direct
+      PUB_HOSTED_URL: https://pub.flutter-io.cn
+      FLUTTER_STORAGE_BASE_URL: https://storage.flutter-io.cn
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Compile (Flutter Windows)
+        shell: bash
+        run: sh scripts/ci/compile-windows.sh "${{ gitea.ref_name }}"
+
+      - name: Upload windows artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: windows
+          path: dist/
+
+  release-deploy:
+    needs: [build-linux-web, build-windows]
+    runs-on: mac
+    env:
+      GOPROXY: https://goproxy.cn,direct
+      PUB_HOSTED_URL: https://pub.flutter-io.cn
+      FLUTTER_STORAGE_BASE_URL: https://storage.flutter-io.cn
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download linux-web artifacts
+        uses: actions/download-artifact@v3
+        with:
+          name: linux-web
+          path: dist/
+
+      - name: Download windows artifacts
+        uses: actions/download-artifact@v3
+        with:
+          name: windows
+          path: dist/
+
       - name: Test
         run: sh scripts/ci/test.sh
 

scripts/ci/compile-windows.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# compile-windows.sh <tag>  —  build Flutter Windows desktop, package into dist/
+set -euo pipefail
+
+export GOPROXY="${GOPROXY:-https://goproxy.cn,direct}"
+export PUB_HOSTED_URL="${PUB_HOSTED_URL:-https://pub.flutter-io.cn}"
+export FLUTTER_STORAGE_BASE_URL="${FLUTTER_STORAGE_BASE_URL:-https://storage.flutter-io.cn}"
+
+TAG="$1"
+VER="${TAG#v}"
+
+echo "==> compile-windows: version=${VER}"
+
+# Sync Flutter pubspec version
+sed -i "s/^version:.*/version: ${VER}+1/" client/pubspec.yaml
+
+# Build Flutter Windows
+cd client
+flutter build windows --release \
+  "--dart-define=BASE_URL=https://jiu.51yanmei.com" \
+  "--dart-define=PUBLIC_URL=https://jiu.51yanmei.com" \
+  "--dart-define=APP_VERSION=${TAG}"
+cd ..
+
+# Package release folder into zip using Python (available on all platforms)
+mkdir -p dist
+python3 - <<'PYEOF'
+import zipfile, os
+
+src = os.path.join('client', 'build', 'windows', 'x64', 'runner', 'Release')
+dst = os.path.join('dist', 'jiu-windows-x64.zip')
+
+with zipfile.ZipFile(dst, 'w', zipfile.ZIP_DEFLATED) as zf:
+    for root, dirs, files in os.walk(src):
+        for fname in files:
+            fp = os.path.join(root, fname)
+            zf.write(fp, os.path.relpath(fp, src))
+
+size = os.path.getsize(dst)
+print(f'Packaged {dst} ({size // 1024 // 1024} MB)')
+PYEOF
+
+echo "==> compile-windows: done — dist/ contents:"
+ls -lh dist/

scripts/ci/release.sh

@@ -36,11 +36,16 @@ PYEOF
 
 echo "==> release: release_notes=${RELEASE_NOTES}"
 
-# Update backend/config/version.yaml
-python3 - "${VER}" "${RELEASE_NOTES}" <<'PYEOF'
+# Update backend/config/version.yaml (version, build_number, release_notes, windows URL)
+python3 - "${VER}" "${RELEASE_NOTES}" "${TAG}" "${FORGEJO_URL}" "${GITEA_REPOSITORY}" <<'PYEOF'
 import sys
-ver = sys.argv[1]
+ver   = sys.argv[1]
 notes = sys.argv[2]
+tag   = sys.argv[3]
+furl  = sys.argv[4].rstrip('/')
+repo  = sys.argv[5]
+win_url = f"{furl}/{repo}/releases/download/{tag}/jiu-windows-x64.zip"
+
 lines = []
 with open('backend/config/version.yaml') as f:
     for line in f:
@@ -54,11 +59,13 @@ with open('backend/config/version.yaml') as f:
             lines.append('build_number: ' + str(build) + '\n')
         elif line.startswith('release_notes:'):
             lines.append('release_notes: "' + notes.replace('\\', '\\\\').replace('"', '\\"') + '"\n')
+        elif line.startswith('  windows:'):
+            lines.append('  windows: "' + win_url + '"\n')
         else:
             lines.append(line)
 with open('backend/config/version.yaml', 'w') as f:
     f.writelines(lines)
-print('version.yaml updated to', ver)
+print('version.yaml updated to', ver, '| windows:', win_url)
 PYEOF
 
 # Package configs.tar.gz (includes updated version.yaml)
@@ -115,5 +122,6 @@ upload_asset() {
 upload_asset dist/jiu-server
 upload_asset dist/web.tar.gz
 upload_asset dist/configs.tar.gz
+upload_asset dist/jiu-windows-x64.zip
 
 echo "==> release: done — Release ${TAG} created"

web/content/system-requirements.md

@@ -5,7 +5,7 @@
 | 浏览器 | Chrome 90 / Firefox 90 / Safari 15 / Edge 90 | 最新稳定版 |
 | 网络 | 任意宽带 | 10 Mbps+ |
 
-## Windows（敬请期待）
+## Windows（已支持）
 
 | 要求 | 版本 |
 |---|---|

web/download.njk

@@ -258,7 +258,7 @@ pageStyle: |
       </div>
       <h1 class="ph-title">随时随地，<br/>轻松管理酒库。</h1>
       <p class="ph-lead">
-        Web 版已正式上线，浏览器直接访问，无需安装。Windows、macOS、iOS、Android 客户端即将推出。
+        Web 版与 Windows 桌面版已正式上线，macOS、iOS、Android 客户端即将推出。
       </p>
       <div class="ph-meta">
         <div class="ph-meta-item">
@@ -271,7 +271,7 @@ pageStyle: |
         </div>
         <div class="ph-meta-item">
           <div class="ph-meta-label">可用平台</div>
-          <div class="ph-meta-val">Web 浏览器</div>
+          <div class="ph-meta-val">Web / Windows</div>
         </div>
       </div>
     </div>
@@ -308,7 +308,7 @@ pageStyle: |
 <section class="section">
   <div class="container">
     <h2 class="fs-3xl fw-6 text-brand-900 m-0 mb-6" style="letter-spacing: var(--tracking-cn-display);">支持的平台</h2>
-    <p class="fs-md text-muted m-0 mb-8">Web 版现已可用，其余平台正在开发中。</p>
+    <p class="fs-md text-muted m-0 mb-8">Web 版与 Windows 桌面版现已可用，其余平台正在开发中。</p>
 
     <div class="dl-grid" id="platform-grid">
       <!-- Web -->
@@ -323,14 +323,14 @@ pageStyle: |
       </div>
 
       <!-- Windows -->
-      <div class="dl-card coming-soon" data-platform="windows">
+      <div class="dl-card" data-platform="windows">
         <div class="dl-card-icon"><i data-lucide="monitor" class="icon"></i></div>
         <h3 class="dl-card-name">Windows</h3>
-        <p class="dl-card-desc">原生桌面客户端，支持离线模式与本地打印。</p>
-        <span class="dl-status soon">敬请期待</span>
-        <span class="dl-card-btn disabled">
-          <i data-lucide="clock" class="icon"></i>即将推出
-        </span>
+        <p class="dl-card-desc">原生桌面客户端，支持 Win 10/11（64 位），离线模式与本地打印。</p>
+        <span class="dl-status available">✓ 已支持</span>
+        <a href="#" class="dl-card-btn primary" id="windows-dl-btn">
+          <i data-lucide="download" class="icon"></i>下载 Windows 版
+        </a>
       </div>
 
       <!-- macOS -->
@@ -431,7 +431,7 @@ pageStyle: |
     web:     { name: 'Web 版',      desc: '浏览器直接访问，功能完整，无需下载安装。',     icon: 'globe',   btnText: '立即使用 Web 版', btnHref: 'https://jiu.51yanmei.com/app/', available: true },
     ios:     { name: 'iOS',         desc: 'iOS 客户端正在开发中，敬请期待。',              icon: 'smartphone',        btnText: '敬请期待', available: false },
     android: { name: 'Android',     desc: 'Android 客户端正在开发中，敬请期待。',          icon: 'tablet-smartphone', btnText: '敬请期待', available: false },
-    windows: { name: 'Windows 桌面', desc: 'Windows 客户端正在开发中，敬请期待。',          icon: 'monitor',           btnText: '敬请期待', available: false },
+    windows: { name: 'Windows 桌面', desc: '原生桌面客户端，支持 Win 10/11（64 位），离线模式与本地打印。', icon: 'monitor', btnText: '下载 Windows 版', btnHref: '#', available: true },
     macos:   { name: 'macOS 桌面',  desc: 'macOS 客户端正在开发中，敬请期待。',            icon: 'laptop',            btnText: '敬请期待', available: false }
   };
 
@@ -499,7 +499,16 @@ pageStyle: |
 
     fetch('https://jiu.51yanmei.com/api/v1/public/release')
       .then(function(r) { return r.json(); })
-      .then(function(data) { if (data && data.version) updateVersionBadges(data.version); })
+      .then(function(data) {
+        if (data && data.version) updateVersionBadges(data.version);
+        if (data && data.download_urls && data.download_urls.windows) {
+          platforms.windows.btnHref = data.download_urls.windows;
+          var btn = document.getElementById('windows-dl-btn');
+          if (btn) btn.href = data.download_urls.windows;
+          // 若用户在 Windows 上，同步更新自动识别卡片
+          if (detected === 'windows') updateDetectCard(detected);
+        }
+      })
       .catch(function() {});
   });
 })();