halo-theme-ethereal/
├── .github/                     # GitHub 配置
│   ├── ISSUE_TEMPLATE/          # Issue 模板
│   ├── workflows/
│   │   ├── ci.yaml              # 构建、版本检测与发布 Release
│   │   ├── cd.yaml              # 发布时同步到 Halo 应用市场
│   │   └── codeql.yml           # 代码安全扫描
│   └── dependabot.yml           # 依赖自动更新
├── .husky/                      # git 钩子
├── .nvmrc                       # Node 版本
├── i18n/                        # 国际化翻译文件
│   ├── default.properties       # 默认语言（英文）
│   ├── zh_CN.properties         # 简体中文
│   └── zh_TW.properties         # 繁体中文
├── public/                      # 静态资源
│   ├── assets/                  # JS 脚本、图片等
│   ├── fragments/               # Halo 页面片段
│   └── gateway_fragments/       # 网关认证片段
├── screenshot/                  # 主题截图
├── scripts/                     # 构建脚本
├── src/
│   ├── components/              # 组件
│   │   ├── *.astro              # Astro 静态组件
│   │   ├── *.svelte             # Svelte 交互组件
│   │   ├── control/             # 控件组件
│   │   ├── misc/                # 杂项组件
│   │   ├── photos/              # 照片相关组件
│   │   └── widget/              # 侧边栏小部件
│   ├── constants/               # 常量定义
│   ├── env.d.ts                 # 环境类型声明
│   ├── global.d.ts              # 全局类型声明
│   ├── layouts/                 # 页面布局
│   │   ├── Layout.astro         # 根布局
│   │   └── MainGridLayout.astro # 主网格布局
│   ├── pages/                   # 页面模板
│   │   ├── index.astro          # 首页
│   │   ├── post.astro           # 文章页
│   │   ├── archives.astro       # 归档页
│   │   ├── tags.astro           # 标签列表
│   │   ├── tag.astro            # 标签详情
│   │   ├── categories.astro     # 分类列表
│   │   ├── category.astro       # 分类详情
│   │   ├── photos.astro         # 图库列表
│   │   ├── photo.astro          # 图库详情
│   │   ├── moment.astro         # 瞬间详情
│   │   ├── moments.astro        # 瞬间列表
│   │   ├── links.astro          # 友情链接
│   │   ├── friends.astro        # 朋友圈
│   │   ├── equipments.astro     # 装备展示
│   │   ├── portfolio.astro      # 项目集列表
│   │   ├── portfolio-detail.astro # 项目集详情
│   │   ├── wishes.astro         # 心愿便签
│   │   ├── schedule-calendar.astro # 日程日历
│   │   ├── schedule-calendar-card.astro # 日程日历卡片组件
│   │   ├── timeline.astro        # 时间轴页面
│   │   ├── skills.astro          # 技能页面
│   │   ├── bangumis.astro        # 追番页面
│   │   ├── layout.astro          # 插件前台页面契约布局模板
│   │   ├── error/               # 错误页面
│   │   │   └── 404.astro        # 404 页面
│   │   └── page.astro           # 自定义页面
│   ├── scripts/                 # 脚本源码
│   │   ├── app.ts               # 初始化逻辑
│   │   ├── assets/              # 经典脚本源码
│   │   └── vendor/              # 第三方脚本
│   ├── styles/                  # 全局样式
│   ├── types/                   # TypeScript 类型定义
│   │   ├── config.ts            # 主题配置类型
│   │   └── searchResult.ts      # 搜索结果类型
│   └── utils/                   # 工具函数
│       └── photos/              # 相册相关工具
├── AGENTS.md                    # AI 协作开发约定
├── CHANGELOG.md                 # 更新日志
├── CONTRIBUTING.md              # 贡献指南
├── LICENSE                      # 许可证
├── annotation-setting.yaml      # Halo 注解设置
├── release.md                   # 发布说明
├── astro.config.mjs             # Astro 构建配置
├── nodemon.json                 # 开发热更新配置
├── settings.yaml                # Halo 主题设置定义
├── svelte.config.js             # Svelte 配置
├── theme.yaml                   # Halo 主题元信息
├── tsconfig.json                # TypeScript 配置
├── pnpm-lock.yaml               # pnpm 依赖锁定文件
├── pnpm-workspace.yaml          # pnpm 工作区配置
└── package.json                 # 项目依赖与脚本