MacWk Halo Theme v1.0.0

这是 MacWk Halo Theme 的首个稳定版本。主题以 Halo 原生服务端渲染为基础，面向软件目录、专题和内容站点提供完整的 MacWk 展示体验，同时保持与 plugin-software 的职责边界清晰。

版本亮点

• 现代 SSR 主题架构：使用 Astro 组织组件和样式，构建为 Halo Thymeleaf 模板；核心页面无需 JavaScript 即可访问，Vue Island 仅用于评论和下载等必要交互。
• 完整内容与软件页面：覆盖首页、文章、分类、标签、归档、独立页面、404/500，以及软件列表、筛选、分页、详情、版本、下载、评论和软件专题。
• 丰富的站点页面模板：内置关于、隐私政策、留言反馈、打赏支持、正版推荐、装机必备、精彩软件推荐、推荐应用和软件专题列表等自定义 Page 模板。
• 安全下载流程：适配 plugin-software 的安全下载授权；公开详情不携带最终下载地址，受保护下载按需加载 Turnstile，并在授权成功后于新标签页打开下载。
• 可配置的外观系统：提供自动、明亮、复古、护眼、海天、深邃和暗黑模式，支持自定义强调色，并记忆访客的外观和软件列表显示偏好。
• 渐进增强的浏览体验：保留服务端链接和正文，使用 Swup 只替换主内容区域；登录、Console、API、附件和下载链接维持正常的浏览器导航行为。
• SEO、可访问性与响应式：包含 Canonical、结构化数据、动态页面 noindex、键盘交互、焦点管理、reduced motion，以及桌面端和移动端布局。
• 可控的插件依赖：plugin-software 可用时展示软件目录和专题数据；插件未安装或未启用时隐藏相关入口并显示降级提示，Halo 原生内容仍可继续使用。
• 发布质量门禁：包含 Biome、Astro Check、Vitest、Playwright、视觉回归、资源预算、生成资源引用校验和主题 ZIP allowlist 校验。

兼容性

• Halo >= 2.25.0
• plugin-software 1.0.0（软件目录、专题和下载功能需要；主题的 Halo 原生内容不依赖该插件）
• Node.js >= 22.12.0、pnpm 10（仅从源码构建主题时需要）

安装与启用

1. 从 GitHub Releases 下载 frontend-macwk-halo-theme-1.0.0.zip。
2. 在 Halo Console 的“主题”页面上传并启用主题。
3. 在主题设置中配置站点标题、Logo、导航、首页内容和强调色。
4. 创建或编辑对应的独立页面，并为其选择主题内置的自定义模板（关于、隐私、反馈、打赏、正版、装机必备、推荐和专题等）。
5. 如需软件目录能力，先安装并启用 plugin-software，再按插件文档配置软件和专题数据。

升级注意

• 主题清单或设置发生变化后，请在 Halo Console 执行主题配置重载，并重新确认独立页面使用的模板。
• 下载交互依赖插件的 download-options/download-grants 公共契约；自定义页面不要直接读取 Console API、原始 Extension 或旧的详情下载 URL。
• 主题会在新标签页打开已授权的下载链接；提取码和密码只在当前下载面板内存中使用，不写入初始 HTML、本地存储或日志。
• 若禁用 plugin-software，/soft/... 和插件专题路由不可用是预期行为；主题自有的推荐、装机必备等页面会显示降级提示。

已知边界

• AI Foundation 不是主题运行依赖；AI 能力只影响插件 Console 编辑辅助，不影响公开页面渲染。
• 应用市场发布当前未启用，本版本通过 GitHub Release 分发。

许可证

GPL-3.0