Mansus

一个基于 Firefly 二次开发的 Astro 博客模板，保留准则分类、文章墨水混色、RSS、全文搜索和响应式布局。

在线示范 ｜ 快速部署 ｜ 内容与配置 ｜ 本地运行

Mansus 能做什么？

• 让文章拥有自己的颜色。 选择单个或多个准则，由墨水系统生成文章主题色。
• 让内容保持简单可维护。 使用 Markdown 写作，文章、图片和站点配置都有明确目录。
• 让个人博客快速上线。 Fork 后可通过 GitHub Actions 自动构建并部署到 GitHub Pages。

页面预览

Mansus 首页

核心能力

准则与墨水

• 支持单准则、多准则和自定义点数混色。
• 文章卡片、标题、徽标和正文强调色会随准则组合变化。
• 内置八个可见准则，并保留加密文章使用的隐藏准则约束。

写作与内容

• 使用 Astro 内容集合校验文章元数据。
• 支持 Markdown、MDX、文章封面、正文图片、标签、分类和置顶。
• 内置 RSS、归档、分类、标签、准则页面和 Pagefind 全文搜索。

部署与维护

• 自动识别 GitHub Pages 的仓库子路径。
• 支持自定义域名、Vercel 和 Cloudflare Workers。
• GitHub Actions 会执行内容校验、构建和静态站点部署。

快速部署

GitHub Pages

1. Fork 仓库。
2. 打开仓库的 Settings > Pages。
3. 将 Source 设为 GitHub Actions。
4. 在 Actions 中运行一次 Deploy to GitHub Pages。

以后推送到 main 或 master 会自动更新站点。默认地址会自动适配为：

https://<用户名>.github.io/<仓库名>/

自定义域名

在 Settings > Secrets and variables > Actions > Variables 中添加：

变量	用途	示例
SITE_URL	站点完整地址	https://blog.example.com
BASE_PATH	站点基础路径；自定义域名通常使用根路径	/

其他平台

• Vercel： 导入仓库，使用默认配置构建。
• Cloudflare Workers： 设置 CF_WORKERS=1 后执行构建，再通过 wrangler.jsonc 部署。

内容与配置

要修改的内容	文件或目录
站点标题、描述、页面开关	src/config/siteConfig.ts
头像、昵称和个人链接	src/config/profileConfig.ts
导航栏	src/config/navBarConfig.ts
主页背景与横幅文字	src/config/backgroundWallpaper.ts
文章	src/content/posts/
正文图片	public/assets/uploads/
文章封面	src/assets/images/mansus/
准则名称与颜色	src/data/aspects.ts

示例文章

示例	文件	说明
单准则	src/content/posts/01-single-aspect.md	只使用一个准则颜色
多准则	src/content/posts/02-multiple-aspects.md	主准则与相关准则自动混色
自定义混色	src/content/posts/03-custom-color-mix.md	使用高级点数控制颜色比例

本地运行

corepack enable
pnpm install
pnpm dev

生产构建：

pnpm build

构建产物位于 dist/。

来源与致谢

• 感谢 CuteLeaf/Firefly 提供原始主题与工程基础。
• 感谢 Astro 提供静态站点框架。
• 准则名称与相关美术源自《密教模拟器》世界观，权利归原权利方所有。

许可

MIT。公开部署前，请自行确认第三方美术素材的使用范围。