ALCOMD3 官方网站

ALCOMD3 官方网站，基于 Astro 与 Material Web 构建。

环境要求

• Node.js：使用 Astro 当前支持的 Node.js LTS 版本
• npm：随 Node.js 安装

本地开发

npm install
npm run dev

开发服务器默认运行在 http://localhost:4321。

常用命令

命令	说明
npm run dev	启动本地开发服务器
npm run check	执行 Astro 与 TypeScript 检查
npm run build	检查并构建生产版本
npm run preview	本地预览生产构建
npm run test:unit	执行下载清单与主题生成测试
npm run test:e2e	执行浏览器端关键流程测试

项目结构

/
├── alcomd.config.json
├── public/
│   ├── api/gui/                # v3.4.0 迁移入口
│   ├── api/v1/updates/         # 3.4.0 后续 Bridge API
│   └── assets/
├── scripts/
│   └── generate-theme.mjs
├── src/
│   ├── components/
│   ├── generated/mcp/       # 构建时生成，不纳入 Git
│   ├── data/
│   ├── generated/
│   ├── layouts/
│   ├── pages/
│   └── styles/
└── tests/

网站提供 en-US、zh-CN、zh-TW 和 ja-JP 四种语言。根路径仅负责按浏览器或已保存偏好跳转到对应语言；首页、下载页和 MCP 文档页均为静态生成。

MCP 主指南和工具参考不在网站仓库维护副本。predev、precheck 和 prebuild 会运行 scripts/sync-mcp-docs.mjs，先解析 ALCOMD/ALCOMD 的最新 main commit，再从该固定 commit 下载全部语言版本到被 Git 忽略的 src/generated/mcp/， 随后由 Astro 生成静态页面。本地也可运行 npm run sync:mcp-docs -- --source ../ALCOMD 从相邻仓库生成内容。

主题令牌由 alcomd.config.json 中的种子色生成。稳定版与测试版下载信息分别读取新标准 API 的 public/api/v1/updates/stable.json 和 public/api/v1/updates/beta.json。

public/api/gui/tauri-updater.json 是早于 3.4.0 的客户端使用的冻结迁移入口；旧域名会保留路径重定向到这里。public/_redirects 将旧 beta 路径内部代理到同一 Stable JSON，使所有旧频道只迁移到最终 v3 Bridge 版本 3.4.0。该 JSON 只能由 ALCOMD3 正式发布 workflow 在公开 Release 资产验证完成后更新。

许可证

本项目采用 GNU Affero General Public License v3.0 许可证。