Loading...
;
+ * if (error) return Error: {error}
;
+ *
+ * return (
+ *
+ *
+ * );
+ * }
+ * ```
+ */
+export const useDesktopVersion = (): DesktopVersionContextValue => {
+ const context = useContext(DesktopVersionContext);
+
+ if (context === defaultValue) {
+ console.warn(
+ 'useDesktopVersion used outside of DesktopVersionProvider, ' +
+ 'data will be fetched but not shared across components'
+ );
+ }
+
+ return context;
+};
diff --git a/shared/src/desktop-utils.ts b/shared/src/desktop-utils.ts
new file mode 100644
index 0000000..59a2def
--- /dev/null
+++ b/shared/src/desktop-utils.ts
@@ -0,0 +1,456 @@
+/**
+ * Hagicode Desktop 工具函数
+ * 用于获取和处理版本数据
+ */
+
+import type {
+ DesktopAsset,
+ DesktopIndexResponse,
+ PlatformDownload,
+ PlatformGroup,
+ DesktopVersion,
+} from './types/desktop';
+import { AssetType } from './types/desktop';
+import semver from 'semver';
+
+const INDEX_JSON_URL = "https://desktop.dl.hagicode.com/index.json";
+const LOCAL_VERSION_INDEX = "/version-index.json";
+const DOWNLOAD_BASE_URL = "https://desktop.dl.hagicode.com/";
+const TIMEOUT_MS = 30000;
+
+/**
+ * 平台推荐配置
+ */
+export const PLATFORM_RECOMMENDATIONS: Record<
+ "windows" | "macos" | "linux",
+ { recommendedType: AssetType; label: string; icon: string }
+> = {
+ windows: {
+ recommendedType: AssetType.WindowsSetup,
+ label: "Windows",
+ icon: "seti:windows",
+ },
+ macos: {
+ recommendedType: AssetType.MacOSApple,
+ label: "macOS",
+ icon: "seti:apple",
+ },
+ linux: {
+ recommendedType: AssetType.LinuxAppImage,
+ label: "Linux",
+ icon: "seti:linux",
+ },
+};
+
+/**
+ * 比较两个版本字符串
+ * @param v1 - 第一个版本
+ * @param v2 - 第二个版本
+ * @returns -1 如果 v1 < v2, 0 如果 v1 = v2, 1 如果 v1 > v2
+ */
+function compareVersions(v1: string, v2: string): number {
+ const cleaned1 = v1.replace(/^v/, '');
+ const cleaned2 = v2.replace(/^v/, '');
+
+ const cmp = semver.compare(cleaned1, cleaned2);
+ // semver.compare 返回：负数如果 a < b, 0 如果相等, 正数如果 a > b
+ if (cmp < 0) return -1;
+ if (cmp > 0) return 1;
+ return 0;
+}
+
+/**
+ * 从文件名推断资源类型
+ * @param filename - 文件名
+ * @returns 资源类型枚举值
+ */
+export function inferAssetType(filename: string): AssetType {
+ const name = filename.toLowerCase();
+
+ // Windows
+ if (name.includes("setup") && name.endsWith(".exe")) {
+ return AssetType.WindowsSetup;
+ }
+ if (name.endsWith(".exe")) {
+ return AssetType.WindowsPortable;
+ }
+ if (name.endsWith(".appx")) {
+ return AssetType.WindowsStore;
+ }
+
+ // macOS
+ if (name.includes("arm64") && name.endsWith(".dmg")) {
+ return AssetType.MacOSApple;
+ }
+ if (name.includes("arm64-mac.zip")) {
+ return AssetType.MacOSApple;
+ }
+ if (name.endsWith(".dmg")) {
+ return AssetType.MacOSIntel;
+ }
+ if (name.includes("-mac.zip")) {
+ return AssetType.MacOSIntel;
+ }
+
+ // Linux
+ if (name.endsWith(".appimage")) {
+ return AssetType.LinuxAppImage;
+ }
+ if (name.includes("_amd64.deb")) {
+ return AssetType.LinuxDeb;
+ }
+ if (name.includes(".tar.gz")) {
+ return AssetType.LinuxTarball;
+ }
+
+ return AssetType.Unknown;
+}
+
+/**
+ * 格式化文件大小
+ * @param bytes - 文件大小（字节）
+ * @returns 格式化后的文件大小字符串
+ */
+export function formatFileSize(bytes: number): string {
+ const gb = bytes / (1024 * 1024 * 1024);
+ if (gb >= 1) {
+ return `${gb.toFixed(1)} GB`;
+ }
+ const mb = bytes / (1024 * 1024);
+ return `${mb.toFixed(0)} MB`;
+}
+
+/**
+ * 平台图标常量（用于 UI 显示）
+ */
+export const PLATFORM_ICONS: RecordLatest: {latest?.version}
+ * {platforms.map(p => ( + *{p.platform}
+ * ))}
+ *
+
+
+
+
diff --git a/src/components/Clarity.astro b/src/components/Clarity.astro
new file mode 100644
index 0000000..a968bbe
--- /dev/null
+++ b/src/components/Clarity.astro
@@ -0,0 +1,36 @@
+---
+/**
+ * Microsoft Clarity 用户行为分析集成组件
+ * 仅在生产环境加载 Clarity 脚本
+ *
+ * @see https://learn.microsoft.com/en-us/clarity/
+ */
+// Astro 组件在服务端执行时可以直接访问 process.env
+// 对于构建时静态生成，process.env 在构建时可用
+const clarityProjectId = process.env.VITE_CLARITY_PROJECT_ID || process.env.CLARITY_PROJECT_ID;
+const isProduction = import.meta.env.PROD;
+
+// 在构建时检查是否应该加载 Clarity
+// 仅在生产环境且配置了 Project ID 时加载
+const shouldLoadClarity = isProduction && clarityProjectId;
+
+// 可选的构建时调试日志
+if (process.env.VITE_CLARITY_DEBUG || process.env.CLARITY_DEBUG) {
+ console.log('[Clarity] Build-time state:', {
+ isProduction,
+ clarityProjectId: clarityProjectId ? '***' + clarityProjectId.slice(-4) : 'not set',
+ shouldLoadClarity: !!shouldLoadClarity,
+ NODE_ENV: process.env.NODE_ENV,
+ });
+}
+---
+
+{shouldLoadClarity && (
+
+)}
diff --git a/src/components/ClarityDebug.astro b/src/components/ClarityDebug.astro
new file mode 100644
index 0000000..0b34f90
--- /dev/null
+++ b/src/components/ClarityDebug.astro
@@ -0,0 +1,19 @@
+---
+// 调试组件 - 输出环境变量状态
+const clarityProjectId = import.meta.env.VITE_CLARITY_PROJECT_ID;
+const isProduction = import.meta.env.PROD;
+const clarityDebug = import.meta.env.CLARITY_DEBUG;
+
+console.log('[ClarityDebug] Build-time state:', {
+ clarityProjectId,
+ isProduction,
+ clarityDebug,
+ shouldLoad: isProduction && clarityProjectId,
+});
+---
+
diff --git a/src/components/InstallButton.tsx b/src/components/InstallButton.tsx
new file mode 100644
index 0000000..1e16a2e
--- /dev/null
+++ b/src/components/InstallButton.tsx
@@ -0,0 +1,336 @@
+/**
+ * InstallButton 组件 - 文档站点版本 (React)
+ * 支持自动平台检测、下拉菜单选择版本、Docker 版本跳转
+ * 用于 Header 导航栏
+ */
+import React, { useState, useMemo, useEffect } from 'react';
+import { getLink } from '@shared/links';
+import {
+ groupAssetsByPlatform,
+ detectOS,
+ getAssetTypeLabel,
+ inferAssetType,
+ getArchitectureLabel,
+ PLATFORM_ICONS,
+ getFileExtension
+} from '@shared/desktop-utils';
+import { getDesktopVersionData } from '@shared/version-manager';
+import type { DesktopVersion, PlatformGroup } from '@shared/desktop';
+
+interface DownloadOption {
+ label: string;
+ url: string;
+ size?: string;
+ assetType: string;
+}
+
+interface PlatformDownloads {
+ platform: 'windows' | 'macos' | 'linux';
+ platformLabel: string;
+ options: DownloadOption[];
+}
+
+interface InstallButtonProps {
+ /**
+ * 显示模式
+ * - full: 完整模式（预留）
+ * - compact: 紧凑模式，用于 Header 导航栏
+ */
+ variant?: 'full' | 'compact';
+
+ /**
+ * 可选的额外类名
+ */
+ className?: string;
+
+ /**
+ * 版本数据（服务端传入，优先使用）
+ */
+ initialVersion?: DesktopVersion | null;
+
+ /**
+ * 平台数据（服务端传入，优先使用）
+ */
+ initialPlatforms?: PlatformGroup[];
+
+ /**
+ * 错误信息
+ */
+ versionError?: string | null;
+
+ /**
+ * 版本渠道（默认 'stable'）
+ * - stable: 稳定版
+ * - beta: 测试版
+ */
+ channel?: 'stable' | 'beta';
+}
+
+/**
+ * 将 PlatformGroup[] 转换为 PlatformDownloads[] 格式
+ */
+function convertPlatformGroups(platforms: PlatformGroup[]): PlatformDownloads[] {
+ const platformLabels = { windows: 'Windows', macos: 'macOS', linux: 'Linux' };
+
+ return platforms.map(platform => ({
+ platform: platform.platform,
+ platformLabel: platformLabels[platform.platform],
+ options: platform.downloads.map(download => ({
+ label: download.filename,
+ url: download.url,
+ size: download.size,
+ assetType: download.assetType
+ }))
+ }));
+}
+
+export default function InstallButton({
+ variant = 'compact',
+ className = '',
+ initialVersion = null,
+ initialPlatforms = [],
+ versionError = null,
+ channel = 'stable'
+}: InstallButtonProps) {
+ const [isDropdownOpen, setIsDropdownOpen] = useState(false);
+ const [version, setVersion] = useState
+
+
+ {glmCoding.label}
+
+
+
+ 速来拼好模，智谱 GLM Coding 超值订阅
+ （本项目同样使用智谱 AI 开发）
+
+
+ {glmCoding.description}立即开拼，享限时惊喜价！
+
+
+
+ );
+ }
+
+ return (
+
+
+
+ 立即安装
+
+
+
+
+ );
+}
diff --git a/src/components/MarkdownContent.astro b/src/components/MarkdownContent.astro
new file mode 100644
index 0000000..62a0685
--- /dev/null
+++ b/src/components/MarkdownContent.astro
@@ -0,0 +1,56 @@
+---
+/**
+ * 自定义 MarkdownContent 组件
+ * 覆盖 starlight-blog 的 MarkdownContent 组件，添加广告支持
+ *
+ * 此组件基于 starlight-blog 的原始实现，添加了以下功能：
+ * - 在博客文章开头显示 BlogHeaderAd 广告
+ * - 在博客文章结尾显示 BlogFooterAd 广告
+ * - 支持通过 frontmatter 的 hideAd 属性控制广告显示
+ */
+import Default from '@astrojs/starlight/components/MarkdownContent.astro'
+import StarlightBlogMarkdownContent from 'starlight-blog/components/MarkdownContent.astro'
+
+import BlogHeaderAd from './BlogHeaderAd.astro'
+import BlogFooterAd from './BlogFooterAd.astro'
+
+const { id, locale } = Astro.locals.starlightRoute
+
+// 检查是否为博客文章页面
+// 博客文章的 id 格式为 "blog/YYYY-MM-DD-xxx"
+const isBlogPost = id?.startsWith('blog/') && !id.endsWith('blog/') && !id.endsWith('blog')
+
+// 获取 hideAd 设置
+// 从 starlightBlog 数据中查找当前文章，然后获取 hideAd 属性
+let hideAd = false
+if (isBlogPost && Astro.locals.starlightBlog) {
+ const blogData = Astro.locals.starlightBlog
+ // 查找匹配当前 id 的博客文章
+ const currentPost = blogData.posts.find(post => post.entry.id === id)
+ if (currentPost) {
+ hideAd = currentPost.entry.data.hideAd ?? false
+ }
+}
+---
+
+{
+ isBlogPost ? (
+
+ {/* 主下载按钮 */}
+
+
+ 立即安装
+
+
+ {/* 下拉切换按钮 */}
+ {platformData.length > 0 && (
+ <>
+
+
+ {/* 下拉菜单 */}
+
+
+ )}
+
+
+
+
+
+ ) : (
+ 
+
+ {/* 渲染逻辑 */}
+
+ );
+}
+```
+
+在 Markdown 中使用时，我们明确告诉 Astro："这个组件需要 JS"：
+
+```markdown
+// src/content/docs/example.mdx
+import Tabs from '../../components/Tabs.jsx';
+
+
+正在跳转到产品概述，如果没有自动跳转，请点击这里。
+ + +