Upload 439 files

CONTRIBUTING.md

@@ -0,0 +1,20 @@
+# Contributing
+
+Thank you for your interest in contributing!
+
+## Before You Start
+
+If you plan to make major changes (especially new features or design changes), please open an issue or discussion before starting work. This helps ensure your effort aligns with the project's direction.
+
+## Submitting Code
+
+Please keep each pull request focused on a single purpose. Avoid mixing unrelated changes in one PR, as this can make reviewing and merging code more difficult.
+
+Please use the [Conventional Commits](https://www.conventionalcommits.org/) format for your commit messages whenever possible. This keeps our history clear and consistent.
+
+Before submitting code, please run the appropriate commands to check for errors and format your code.
+
+```bash
+pnpm check
+pnpm format
+```

README.zh.md

@@ -0,0 +1,301 @@
+
+<img src="./docs/images/1131.png" width = "350" height = "500" alt="Firefly" align=right />
+
+<div align="center">
+
+# 流萤 / Firefly 
+> 一款清新美观的 Astro 静态博客主题模板
+> 
+> ![Node.js >= 22](https://img.shields.io/badge/node.js-%3E%3D22-brightgreen) 
+![pnpm >= 9](https://img.shields.io/badge/pnpm-%3E%3D9-blue)
+![Astro](https://img.shields.io/badge/Astro-5.16.15-orange)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.9.2-blue)
+>
+> [![Stars](https://img.shields.io/github/stars/CuteLeaf/Firefly?style=social)](https://github.com/CuteLeaf/Firefly/stargazers)
+[![Forks](https://img.shields.io/github/forks/CuteLeaf/Firefly?style=social)](https://github.com/CuteLeaf/Firefly/network/members)
+[![Issues](https://img.shields.io/github/issues/CuteLeaf/Firefly)](https://github.com/CuteLeaf/Firefly/issues)
+> 
+> [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Z8Z41NQALY)
+> 
+> ![GitHub License](https://img.shields.io/github/license/CuteLeaf/Firefly)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/CuteLeaf/Firefly)
+[![爱发电赞助](https://img.shields.io/badge/爱发电-赞助作者-ff69b4.svg)](https://afdian.com/a/cuteleaf)
+
+</div>
+
+
+---
+📖 README：
+**[简体中文](README.zh.md)** | **[繁體中文](docs/README.zh-TW.md)** | **[English](README.md)** | **[日本語](docs/README.ja.md)** | **[Русский](docs/README.ru.md)**
+
+🚀 快速指南：
+[**🖥️在线预览**](https://firefly.cuteleaf.cn/) /
+[**📝使用文档**](https://docs-firefly.cuteleaf.cn/) /
+[**🍀我的博客**](https://blog.cuteleaf.cn) 
+
+⚡ 静态站点生成: 基于Astro的超快加载速度和SEO优化
+
+🎨 现代化设计: 简洁美观的界面，支持自定义主题色
+
+📱 移动友好: 完美的响应式体验，移动端专项优化
+
+🔧 高度可配置: 大部分功能模块均可通过配置文件自定义
+
+<img alt="firefly" src="./docs/images/1.webp" />
+<img alt="Lighthouse" src="./docs/images/Lighthouse.png" />
+
+>[!TIP]
+>
+>Firefly 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题模板，专为技术爱好者和内容创作者设计。该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。
+> 
+>在重要的布局上，Firefly 创新性地增加了左右双侧边栏、文章网格(多列)布局、瀑布流布局，增加了站点统计、日历组件、文章目录等小组件，让侧边栏更加丰富，同时也保留了原版 fuwari 的布局，可根据自己的喜好在配置文件中自由切换。
+>
+>**更多布局配置及演示请查看：[Firefly 布局系统详解](https://firefly.cuteleaf.cn/posts/firefly-layout-system/)**
+>
+>Firefly 支持i18n多语言切换，但除了简体中文，其他语言均为AI翻译转换，如有错误，欢迎提交 [Pull Request](https://github.com/CuteLeaf/Firefly/pulls) 修正。
+
+## ✨ 功能特性
+
+### 核心功能
+
+- [x] **Astro + Tailwind CSS** - 基于现代技术栈的超快静态站点生成
+- [x] **流畅动画** - Swup 页面过渡动画，提供丝滑的浏览体验
+- [x] **响应式设计** - 完美适配桌面端、平板和移动设备
+- [x] **多语言支持** - i18n 国际化，支持简体中文、繁体中文、英文、日文、俄语
+- [x] **全文搜索** - 基于 Pagefind 的客户端搜索，支持文章内容索引
+
+### 个性化
+- [x] **动态侧边栏** - 支持配置单侧边栏、双侧边栏
+- [x] **文章布局** - 支持配置(单列)列表、网格(多列/瀑布流)布局
+- [x] **字体管理** - 支持自定义字体，丰富的字体选择器
+- [x] **页脚配置** - HTML 内容注入，完全自定义
+- [x] **亮暗色模式** - 支持亮色/暗色/跟随系统三种模式
+- [x] **导航栏自定义** - Logo、标题、链接全面自定义
+- [x] **壁纸模式切换** - 横幅壁纸、全屏透明壁纸、纯色背景
+- [x] **主题色自定义** - 360° 色相调节
+
+### 页面组件
+   
+- [x] **留言板** - 支持留言页面
+- [x] **公告栏** - 支持侧边栏公告提示
+- [x] **看板娘** - 支持 Spine 和 Live2D 两种动画引擎
+- [x] **站点统计** - 显示文章、分类、标签数目、文章总字数等数据
+- [x] **站点日历** - 显示当月日历，以及当月的发布文章
+- [x] **赞助页面** - 赞助链接跳转、收款码展示、赞助者列表、文章内赞助按钮
+- [x] **分享海报** - 支持生成精美的文章分享海报
+- [x] **樱花特效** - 支持樱花特效，全屏樱花效果
+- [x] **友情链接** - 精美的友情链接展示页面
+- [x] **广告组件** - 支持自定义侧边栏广告内容
+- [x] **番组计划** - 基于 Bangumi API 的追番和游戏等记录展示
+- [x] **评论系统** - 集成 Twikoo、Waline、Giscus、Disqus、Artalk 评论系统
+- [x] **访问量统计** - 支持调用 Waline、Twikoo 自带的访问量追踪
+- [x] **音乐播放器** - Material Design 3 设计风格的音乐播放器
+
+### 内容增强
+- [x] **图片灯箱** - Fancybox 图片预览功能
+- [x] **浮动目录** - 动态显示文章目录，支持锚点跳转，在侧边栏目录隐藏后显示
+- [x] **邮箱保护** - 让自动化爬虫程序无法直接爬到邮箱地址，被垃圾邮件骚扰
+- [x] **侧边栏目录** - 动态显示文章目录，支持锚点跳转
+- [x] **增强代码块** - 基于 Expressive Code，支持代码折叠、行号、语言标识
+- [x] **数学公式支持** - KaTeX 渲染引擎，支持行内和块级公式
+- [x] **文章随机封面图** - 支持通过 API 获取随机封面图
+- [x] **Markdown扩展** - 更多的 Markdown 扩展语法
+
+### SEO
+- [x] **SEO 优化** - 完整的 meta 标签和结构化数据
+- [x] **RSS 订阅** - 自动生成 RSS Feed
+- [x] **站点地图** - 自动生成 XML Sitemap，支持页面过滤配置
+- [x] **统计分析** - 集成 Google Analytics、Microsoft Clarity
+
+
+如果你有好用的功能和优化，请提交 [Pull Request](https://github.com/CuteLeaf/Firefly/pulls)
+
+## 🚀 快速开始
+
+### 环境要求
+
+- Node.js ≤ 22
+- pnpm ≤ 9
+
+### 本地开发部署
+
+1. **克隆仓库：**
+   ```bash
+   git clone https://github.com/Cuteleaf/Firefly.git
+   cd Firefly
+   ```
+   
+   **先 [Fork](https://github.com/CuteLeaf/Firefly/fork) 到自己仓库在克隆（推荐），记得先点 Star 在 Fork 哦！**
+
+   ```bash
+   git clone https://github.com/you-github-name/Firefly.git
+   cd Firefly
+   ```
+3. **安装依赖：**
+   ```bash
+   # 如果没有安装 pnpm，先安装
+   npm install -g pnpm
+   
+   # 安装项目依赖
+   pnpm install
+   ```
+
+4. **配置博客：**
+   - 编辑 `src/config/` 目录下的配置文件自定义博客设置
+
+5. **启动开发服务器：**
+   ```bash
+   pnpm dev
+   ```
+   博客将在 `http://localhost:4321` 可用
+
+### 平台托管部署
+- **参考[官方指南](https://docs.astro.build/zh-cn/guides/deploy/)将博客部署至 Vercel, Netlify, GitHub Pages, Cloudflare Pages, EdgeOne Pages 等。**
+
+   框架预设： `Astro`
+
+   根目录： `./`
+
+   输出目录： `dist`
+
+   构建命令： `pnpm run build`
+
+   安装命令： `pnpm install`
+
+## 📖 配置说明
+
+> 📚 **详细配置文档**: 查看 [Firefly使用文档](https://docs-firefly.cuteleaf.cn/) 获取完整的配置指南
+
+### 设置网站语言
+
+要设置博客的默认语言，请编辑 `src/config/siteConfig.ts` 文件：
+
+```typescript
+// 定义站点语言
+const SITE_LANG = "zh_CN";
+```
+
+**支持的语言代码：**
+- `zh_CN` - 简体中文
+- `zh_TW` - 繁体中文
+- `en` - 英文
+- `ja` - 日文
+- `ru` - 俄文
+
+### 配置文件结构
+
+```
+src/
+├── config/
+│   ├── index.ts              # 配置索引文件
+│   ├── siteConfig.ts         # 站点基础配置
+│   ├── backgroundWallpaper.ts # 背景壁纸配置
+│   ├── profileConfig.ts      # 用户资料配置
+│   ├── commentConfig.ts      # 评论系统配置
+│   ├── announcementConfig.ts # 公告配置
+│   ├── licenseConfig.ts      # 许可证配置
+│   ├── footerConfig.ts       # 页脚配置
+│   ├── FooterConfig.html     # 页脚HTML内容
+│   ├── expressiveCodeConfig.ts # 代码高亮配置
+│   ├── sakuraConfig.ts       # 樱花特效配置
+│   ├── fontConfig.ts         # 字体配置
+│   ├── sidebarConfig.ts      # 侧边栏布局配置
+│   ├── navBarConfig.ts       # 导航栏配置
+│   ├── musicConfig.ts        # 音乐播放器配置
+│   ├── pioConfig.ts          # 看板娘配置
+│   ├── adConfig.ts           # 广告配置
+│   ├── friendsConfig.ts      # 友链配置
+│   ├── sponsorConfig.ts      # 赞助配置
+│   └── coverImageConfig.ts  # 文章封面图配置
+```
+
+## ⚙️ 文章 Frontmatter
+
+```yaml
+---
+title: My First Blog Post
+published: 2023-09-09
+description: This is the first post of my new Astro blog.
+image: ./cover.jpg  # 或使用 "api" 来启用随机封面图
+tags: [Foo, Bar]
+category: Front-end
+draft: false
+lang: zh-CN      # 仅当文章语言与 `siteConfig.ts` 中的网站语言不同时需要设置
+pinned: false    # 置顶
+comment: true    # 是否允许评论
+---
+```
+
+## 🧩 Markdown 扩展语法
+
+除了 Astro 默认支持的 [GitHub Flavored Markdown](https://github.github.com/gfm/) 之外，还包含了一些额外的 Markdown 功能：
+
+- 提醒块（Admonitions） - 支持 GitHub, Obsidian, VitePress 三种风格主题配置 ([预览和用法](https://firefly.cuteleaf.cn/posts/markdown-extended/))
+- GitHub 仓库卡片 ([预览和用法](https://firefly.cuteleaf.cn/posts/markdown-extended/))
+- 基于 Expressive Code 的增强代码块 ([预览](http://firefly.cuteleaf.cn/posts/code-examples/) / [文档](https://expressive-code.com/))
+
+## 🧞 指令
+
+下列指令均需要在项目根目录执行：
+
+| Command                    | Action                                              |
+|:---------------------------|:----------------------------------------------------|
+| `pnpm install`             | 安装依赖                               |
+| `pnpm dev`                 | 在 `localhost:4321` 启动本地开发服务器        |
+| `pnpm build`               | 构建网站至 `./dist/`            |
+| `pnpm preview`             | 本地预览已构建的网站        |
+| `pnpm check`               | 检查代码中的错误                 |
+| `pnpm format`              | 使用Biome格式化您的代码                        |
+| `pnpm new-post <filename>` | 创建新文章                                   |
+| `pnpm astro ...`           | 执行 `astro add`, `astro check` 等指令    |
+| `pnpm astro --help`        | 显示 Astro CLI 帮助                        |
+
+## 🙏 致谢
+
+- 非常感谢 [saicaca](https://github.com/saicaca) 开发的 [fuwari](https://github.com/saicaca/fuwari) 模板，Firefly 就是基于这个模板二次开发
+- 参考了博主 [霞葉](https://kasuha.com) 分享的 [Bangumi 收藏展示](https://kasuha.com/posts/fuwari-enhance-ep2/) 和 [邮箱保护/图片标题](https://kasuha.com/posts/fuwari-enhance-ep1/) 方案
+- 参考了 [Mizuki](https://github.com/matsuzaka-yuki/Mizuki) 的横幅标题/多级菜单导航栏/樱花特效/KaTeX/Fancybox方案
+- 使用了 [Astro](https://astro.build) 和 [Tailwind CSS](https://tailwindcss.com) 构建
+- 使用了b站up [公公的日常](https://space.bilibili.com/3546750017080050) 提供的Q版 `流萤` 看板娘切片数据模型
+- 图标来自 [Iconify](https://iconify.design/)
+- 流萤部分相关图片素材版权归游戏 [《崩坏：星穹铁道》](https://sr.mihoyo.com/) 开发商 [米哈游](https://www.mihoyo.com/) 所有
+
+## 📝 许可协议
+
+本项目遵循 [MIT license](https://mit-license.org/) 开源协议，详细查看 [LICENSE](./LICENSE) 文件
+
+最初 Fork 自 [saicaca/fuwari](https://github.com/saicaca/fuwari)，感谢原作者的贡献，原项目采用 [MIT license](https://mit-license.org/)
+
+**版权声明：**
+- Copyright (c) 2024 [saicaca](https://github.com/saicaca) - [fuwari](https://github.com/saicaca/fuwari)
+- Copyright (c) 2025 [CuteLeaf](https://github.com/CuteLeaf) - [Firefly](https://github.com/CuteLeaf/Firefly) 
+
+根据 MIT 开源协议，你可以自由使用、修改、分发代码，但需保留上述版权声明。
+
+## 🍀 贡献者
+
+感谢以下贡献者对本项目做出的贡献，如有问题或建议，请提交 [Issue](https://github.com/CuteLeaf/Firefly/issues) 或 [Pull Request](https://github.com/CuteLeaf/Firefly/pulls)。
+
+><a href="https://github.com/CuteLeaf/Firefly/graphs/contributors">
+>  <img src="https://contrib.rocks/image?repo=CuteLeaf/Firefly" />
+></a>
+
+感谢以下贡献者对原项目 [fuwari](https://github.com/saicaca/fuwari) 做出的贡献，为本项目奠定了基础。
+
+><a href="https://github.com/saicaca/fuwari/graphs/contributors">
+>  <img src="https://contrib.rocks/image?repo=saicaca/fuwari" />
+></a>
+
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=CuteLeaf/Firefly&type=Date)](https://star-history.com/#CuteLeaf/Firefly&Date)
+
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->

_frontmatter.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://frontmatter.codes/frontmatter.schema.json",
+  "frontMatter.framework.id": "astro",
+  "frontMatter.preview.host": "http://localhost:4321",
+  "frontMatter.content.publicFolder": "public",
+  "frontMatter.content.pageFolders": [
+    {
+      "title": "posts",
+      "path": "[[workspace]]/src/content/posts"
+    }
+  ],
+  "frontMatter.taxonomy.contentTypes": [
+    {
+      "name": "default",
+      "pageBundle": true,
+      "previewPath": "'blog'",
+      "filePrefix": null,
+      "clearEmpty": true,
+      "fields": [
+        {
+          "title": "title",
+          "name": "title",
+          "type": "string",
+          "single": true
+        },
+        {
+          "title": "description",
+          "name": "description",
+          "type": "string"
+        },
+        {
+          "title": "published",
+          "name": "published",
+          "type": "datetime",
+          "default": "{{now}}",
+          "isPublishDate": true
+        },
+        {
+          "title": "preview",
+          "name": "image",
+          "type": "image",
+          "isPreviewImage": true
+        },
+        {
+          "title": "tags",
+          "name": "tags",
+          "type": "list"
+        },
+        {
+          "title": "category",
+          "name": "category",
+          "type": "string"
+        },
+        {
+          "title": "draft",
+          "name": "draft",
+          "type": "boolean"
+        },
+        {
+          "title": "language",
+          "name": "language",
+          "type": "string"
+        }
+      ]
+    }
+  ]
+}

biome.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.14/schema.json",
+  "vcs": {
+    "enabled": false,
+    "clientKind": "git",
+    "useIgnoreFile": false
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "includes": [
+      "**",
+      "!**/src/**/*.css",
+      "!**/src/public/**/*",
+      "!**/dist/**/*",
+      "!**/node_modules/**/*",
+      "!**/src/constants/icons.ts"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "tab"
+  },
+  "assist": { "actions": { "source": { "organizeImports": "on" } } },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "style": {
+        "noParameterAssign": "error",
+        "useAsConstAssertion": "error",
+        "useDefaultParameterLast": "error",
+        "useEnumInitializers": "error",
+        "useSelfClosingElements": "error",
+        "useSingleVarDeclarator": "error",
+        "noUnusedTemplateLiteral": "error",
+        "useNumberNamespace": "error",
+        "noInferrableTypes": "error",
+        "noUselessElse": "error"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double"
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/*.svelte", "**/*.astro", "**/*.vue"],
+      "linter": {
+        "rules": {
+          "style": {
+            "useConst": "off",
+            "useImportType": "off"
+          },
+          "correctness": {
+            "noUnusedVariables": "off",
+            "noUnusedImports": "off"
+          }
+        }
+      }
+    }
+  ]
+}

server/index.mjs

@@ -150,6 +150,13 @@ function respondError(res, statusCode, message, details = undefined) {
 	});
 }
 
+function redirect(res, location, statusCode = 302) {
+	respond(res, statusCode, "", {
+		"Cache-Control": "no-store",
+		Location: location,
+	});
+}
+
 function parseCookies(req) {
 	const header = req.headers.cookie || "";
 	return header
@@ -218,6 +225,12 @@ async function readJsonBody(req) {
 	return raw ? JSON.parse(raw) : {};
 }
 
+async function readFormBody(req) {
+	const raw = await readRequestBody(req);
+	const params = new URLSearchParams(raw);
+	return Object.fromEntries(params.entries());
+}
+
 async function statSafe(filePath) {
 	try {
 		return await fs.stat(filePath);
@@ -462,6 +475,36 @@ function isAdminConfigured() {
 	return Boolean(process.env.ADMIN && process.env.PASSWORD);
 }
 
+function completeAdminLogin(res, username) {
+	const token = createSession(String(username));
+	setCookie(res, SESSION_COOKIE, token, {
+		maxAge: Math.floor(SESSION_TTL_MS / 1000),
+	});
+	return token;
+}
+
+function getAdminEntryPath(pathname = "/admin/login") {
+	return pathname.startsWith("/cmsadmin") ? "/cmsadmin/" : "/admin/";
+}
+
+async function handleAdminFormLogin(req, res, url) {
+	const entryPath = getAdminEntryPath(url.pathname);
+	if (!isAdminConfigured()) {
+		return redirect(res, entryPath + "?login=disabled");
+	}
+	const contentType = String(req.headers["content-type"] || "");
+	const payload = contentType.includes("application/json")
+		? await readJsonBody(req)
+		: await readFormBody(req);
+	const username = String(payload.username || "");
+	const password = String(payload.password || "");
+	if (username !== process.env.ADMIN || password !== process.env.PASSWORD) {
+		return redirect(res, entryPath + "?login=invalid");
+	}
+	completeAdminLogin(res, username);
+	return redirect(res, entryPath);
+}
+
 async function walkFiles(dirPath) {
 	const stats = await statSafe(dirPath);
 	if (!stats?.isDirectory()) {
@@ -841,10 +884,7 @@ async function handleApiRequest(req, res, url) {
 		if (payload.username !== process.env.ADMIN || payload.password !== process.env.PASSWORD) {
 			return respondError(res, 401, "Invalid username or password");
 		}
-		const token = createSession(String(payload.username));
-		setCookie(res, SESSION_COOKIE, token, {
-			maxAge: Math.floor(SESSION_TTL_MS / 1000),
-		});
+		completeAdminLogin(res, payload.username);
 		return respondJson(res, 200, {
 			success: true,
 			authenticated: true,
@@ -1092,6 +1132,12 @@ async function handleRequest(req, res) {
 		if (url.pathname.startsWith("/api/")) {
 			return await handleApiRequest(req, res, url);
 		}
+		if (
+			(url.pathname === "/admin/login" || url.pathname === "/cmsadmin/login") &&
+			req.method === "POST"
+		) {
+			return await handleAdminFormLogin(req, res, url);
+		}
 		if (url.pathname.startsWith(PUBLIC_MEDIA_ROUTE)) {
 			const filePath = await resolveSourceStaticFile(
 				PUBLIC_ADMIN_ASSETS_DIR,

src/components/admin/AdminApp.svelte

@@ -125,6 +125,7 @@
 		| "sakura";
 
 	export let initialSnapshot: AdminSnapshot;
+	export let entryPath = "/admin";
 
 	const navItems: Array<{ key: NavKey; label: string; hint: string }> = [
 		{ key: "overview", label: "总览", hint: "状态、统计与快捷操作" },
@@ -281,7 +282,8 @@
 		};
 	}
 
-	let sessionLoading = true;
+	let sessionLoading = false;
+	let sessionRefreshing = false;
 	let authenticated = false;
 	let configured = true;
 	let username = "";
@@ -428,12 +430,24 @@
 	}
 
 	async function refreshSession() {
-		const data = await api<any>("/api/admin/session");
-		authenticated = Boolean(data.authenticated);
-		configured = data.configured !== false;
-		username = String(data.username || "");
-		if (data.build) applyBuild(data);
-		sessionLoading = false;
+		sessionRefreshing = true;
+		try {
+			const data = await api<any>("/api/admin/session");
+			authenticated = Boolean(data.authenticated);
+			configured = data.configured !== false;
+			username = String(data.username || "");
+			if (data.build) applyBuild(data);
+		} catch (error) {
+			authenticated = false;
+			configured = true;
+			showToast(
+				"error",
+				error instanceof Error ? error.message : "后台会话检查失败",
+			);
+		} finally {
+			sessionLoading = false;
+			sessionRefreshing = false;
+		}
 	}
 
 	async function loadBuild() {
@@ -552,7 +566,24 @@
 		syncEditors();
 	}
 
-	async function handleLogin() {
+	function applyLoginSearchFeedback() {
+		const currentUrl = new URL(window.location.href);
+		const loginStatus = currentUrl.searchParams.get("login");
+		if (loginStatus === "invalid") {
+			showToast("error", "账号或密码错误，请重新输入");
+		} else if (loginStatus === "disabled") {
+			showToast("error", "后台尚未启用，请先配置 ADMIN 和 PASSWORD");
+		}
+		if (!loginStatus) {
+			return;
+		}
+		currentUrl.searchParams.delete("login");
+		const nextPath = currentUrl.pathname + currentUrl.search + currentUrl.hash;
+		window.history.replaceState({}, "", nextPath || currentUrl.pathname);
+	}
+
+	async function handleLogin(event?: SubmitEvent) {
+		event?.preventDefault();
 		try {
 			const response = await api<any>("/api/admin/login", {
 				method: "POST",
@@ -565,7 +596,7 @@
 			await loadAll();
 			showToast("success", "登录成功");
 		} catch (error) {
-			showToast("error", error instanceof Error ? error.message : "登录失败");
+			showToast("error", error instanceof Error ? error.message : "\u767b\u5f55\u5931\u8d25");
 		}
 	}
 
@@ -742,6 +773,7 @@
 		}, 3000);
 
 		(async () => {
+			applyLoginSearchFeedback();
 			await refreshSession();
 			if (authenticated) {
 				await loadAll();
@@ -757,22 +789,23 @@
 		<div class={`admin-toast ${toast.tone}`}>{toast.text}</div>
 	{/if}
 
-	{#if sessionLoading}
-		<div class="card-base admin-panel admin-empty">正在连接后台服务...</div>
-	{:else if !configured}
+	{#if !configured}
 		<div class="card-base admin-panel admin-empty">
 			<h2>后台尚未启用</h2>
 			<p>请在 Hugging Face Space 中配置环境变量 <code>ADMIN</code> 和 <code>PASSWORD</code> 后再访问管理页。</p>
 		</div>
 	{:else if !authenticated}
-		<div class="card-base admin-login">
+		<form class="card-base admin-login" method="post" action={`${entryPath}/login`} on:submit|preventDefault={handleLogin}>
 			<div class="admin-login-badge">Firefly Admin</div>
 			<h2>登录后台</h2>
 			<p>使用 Space 环境变量中的管理员账号和密码进入管理页面。</p>
-			<input class="admin-input" placeholder="管理员账号" bind:value={loginForm.username} />
-			<input class="admin-input" type="password" placeholder="密码" bind:value={loginForm.password} />
-			<button class="btn-regular admin-button primary" on:click={handleLogin}>登录</button>
-		</div>
+			<input class="admin-input" name="username" autocomplete="username" placeholder="管理员账号" bind:value={loginForm.username} />
+			<input class="admin-input" name="password" autocomplete="current-password" type="password" placeholder="密码" bind:value={loginForm.password} />
+			<button class="btn-regular admin-button primary" type="submit">&#30331;&#24405;</button>
+			{#if sessionRefreshing || sessionLoading}
+				<p class="admin-login-status">正在检查当前后台会话...</p>
+			{/if}
+		</form>
 	{:else}
 		<div class="admin-workbench">
 			<aside class="admin-sidebar">
@@ -1002,8 +1035,8 @@
 	.admin-toast.error { background: color-mix(in oklch, oklch(0.68 0.18 25) 16%, var(--card-bg) 84%); }
 	.admin-toast.info { background: color-mix(in oklch, var(--btn-regular-bg-hover) 35%, var(--card-bg) 65%); }
 	.admin-sidebar-card h3, .admin-panel h3, .admin-panel h4, .admin-login h2 { margin: 0; }
-	.admin-sidebar-card p, .admin-panel p, .admin-login p { margin: 0; color: rgba(0,0,0,.72); }
-	:root.dark .admin-sidebar-card p, :root.dark .admin-panel p, :root.dark .admin-login p { color: rgba(255,255,255,.72); }
+	.admin-sidebar-card p, .admin-panel p, .admin-login p, .admin-login-status { margin: 0; color: rgba(0,0,0,.72); }
+	:root.dark .admin-sidebar-card p, :root.dark .admin-panel p, :root.dark .admin-login p, :root.dark .admin-login-status { color: rgba(255,255,255,.72); }
 	.admin-quick-actions { display: flex; gap: 0.6rem; align-items: center; }
 	.admin-quick-actions.wrap { flex-wrap: wrap; }
 	.admin-button { min-height: 2.7rem; padding: 0.65rem 1rem; border-radius: 0.95rem; }

src/pages/admin/index.astro

@@ -11,5 +11,5 @@ const initialSnapshot = getAdminSnapshot();
 
 <AdminLayout title="博客后台管理" description="Firefly 博客后台管理面板">
 	<KatexManager slot="head" />
-	<AdminApp client:load initialSnapshot={initialSnapshot} />
+	<AdminApp client:load initialSnapshot={initialSnapshot} entryPath="/admin" />
 </AdminLayout>

src/pages/cmsadmin/index.astro

@@ -11,5 +11,5 @@ const initialSnapshot = getAdminSnapshot();
 
 <AdminLayout title="博客后台管理" description="Firefly 博客后台管理面板">
 	<KatexManager slot="head" />
-	<AdminApp client:load initialSnapshot={initialSnapshot} />
+	<AdminApp client:load initialSnapshot={initialSnapshot} entryPath="/cmsadmin" />
 </AdminLayout>

storage/admin/config.json

@@ -165,6 +165,11 @@
             "preset": "about"
           }
         ]
+      },
+      {
+        "name": "Admin",
+        "url": "/admin",
+        "external": false
       }
     ]
   },

vercel.json

@@ -0,0 +1,39 @@
+{
+  "buildCommand": "pnpm build",
+  "outputDirectory": "dist",
+  "installCommand": "pnpm install",
+  "framework": "astro",
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        {
+          "key": "X-Content-Type-Options",
+          "value": "nosniff"
+        },
+        {
+          "key": "X-Frame-Options",
+          "value": "DENY"
+        },
+        {
+          "key": "X-XSS-Protection",
+          "value": "1; mode=block"
+        },
+        {
+          "key": "Referrer-Policy",
+          "value": "strict-origin-when-cross-origin"
+        }
+      ]
+    },
+    {
+      "source": "/_astro/(.*)",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=31536000, immutable"
+        }
+      ]
+    }
+  ],
+  "cleanUrls": true
+}