DarkMinimal 是一套面向前端开发者、独立开发者和技术自由职业者的个人作品集网站模板。暗色背景、紫色强调和大号职业标题构成首页，介绍、技能与项目都在同一页，方便访客了解你擅长什么、做过哪些作品。
当前下载资源仍待处理：本次本地文件的 astro.config.mjs 附有混淆的远程脚本执行代码，不能直接运行。在线演示由清除该代码后的副本构建；下载包替换或确认完成前，不应执行原包中的构建命令。
暗色首屏与技能展示
首屏左侧是两行职业标题，右侧放一句个人定位，下方接社交图标和循环移动的技术标志。模板默认采用接近黑色的 #101010 背景，紫色 #a476ff 用于强调词和细节，灰白文字拉开主次，整体更适合以技术能力和项目经历为主的个人站。
这里没有大幅人物照片，识别度主要来自标题、技术标志和右侧的字符动画。手头缺少成套摄影素材的开发者，可以先准备职业描述、技能和作品截图；若主要展示摄影或插画作品，则需要另行扩大图片的展示面积。
“What I do?” 把能力分为 Web Development、Mobile Development 和 UI/UX Design & Prototyping，点击分类可展开具体条目。同一时间只展开一组，适合放简短的服务范围。右侧的 React 字符动画可调整颜色和变化速度；不需要动态效果时，也可以删除，不影响技能列表和项目区。
导航包含 Home、Projects、Contact 三个页内入口。桌面端固定在顶部，窄屏改为底部图标导航；首页布局和项目网格也通过断点切换。改中文文案时，需要留意职业标题换行，以及长技能名称是否会挤压小屏空间。
四张项目卡片
项目区提供四张示例卡片，桌面两列、窄屏单列。每张卡片包含图片、标题、状态、代码入口和预览入口，数据集中在 src/components/projects.astro 的 projects 数组中。
| 卡片字段 | 当前示例 | 替换内容 |
|---|---|---|
title | Project One 等通用名称 | 项目名称或简短定位 |
image | 600×400 远程占位图 | 真实界面或作品截图 |
status | Deployed、On Development、Contributor | 上线、开发中或参与角色 |
link | 代码平台首页占位 | 具体项目仓库地址 |
preview | #! 占位 | 可访问的演示或案例地址 |
这些状态是手动填写的文字，不会自动查询部署或仓库进度。模板也没有独立项目详情页。准备上线时，除了换图和标题，还要把每张卡片的两个入口补齐，否则访客只能看到项目外观，无法继续了解作品。
原包图片来自外部占位服务，不是随包附带的真实项目截图。本次在线演示换成了本地占位图，并处理了卡片中的嵌套链接；正式作品集仍需填入自己的内容。
点赞、音乐与联系
这三个部分都在首页内，但依赖条件不同，可以按需要保留。
点赞计数
原包的点赞组件使用 Firebase Firestore，监听 likes/counter 文档，并对其中的 likes 字段加一。接入前需要填写 .env.example 对应的 PUBLIC_FIREBASE_* 配置，准备初始文档，并设置数据库访问规则。
浏览器本地存储只用于记录“这台浏览器是否点过赞”，不等于完整的身份验证或防刷机制。个人主页不需要计数时，可以从页脚移除该组件；本次在线演示已改为标明 Demo 的本地交互，不连接 Firebase，也不累计真实访客点赞。
Spotify 播放器
页脚放置的是 Spotify 公开歌单的嵌入播放器，不需要为主体页面配置 Spotify API 密钥。更换歌单只需修改 iframe 地址，也可以整块删除。播放器依赖外部服务，实际能否播放还受网络、地区和访问端条件影响，不影响上方的个人介绍与项目展示。
联系表单
联系区有姓名、邮箱和消息输入框，提交脚本会向 Formspree 发送请求，但原包的表单地址仍是 YOUR_FORM_ID_HERE 占位。需要收件时，应换成自己的表单端点并确认收件配置；页面出现输入框，并不代表已经能收到邮件。本次静态演示已停用外发请求，点击提交只显示演示提示。
改成自己的个人站
定制时可以先换展示内容，再决定是否接入点赞和收件服务。主要修改位置如下。
- 姓名、职业与一句话介绍：修改
src/components/home.astro，同时替换社交入口和示例邮箱。 - 技能与服务范围：修改
src/React/SkillsList.tsx的分类和条目；技术标志在src/components/logoWall.astro中维护。 - 项目内容：修改
projects.astro的四条数据，将远程占位图换为自己的图片，并检查代码与预览入口。 - 配色与文字样式：从
src/layouts/Layout.astro的全局变量、字体声明及相关 Tailwind 类入手。标题、副标题和按钮应一起检查，避免只换强调色。 - 页脚与页面身份：修改
footer.astro和Layout.astro中的国家、年份相关文案、页面标题、描述、canonical 与分享图配置，清除示例姓名和域名。
构建前先处理配置
本地锁文件对应 Astro 7.2.9、React 19.2.8 和 Tailwind CSS 3.4.17。项目使用 pnpm，虽然 README 写有 npm 安装示例，package.json 中的安装前检查会限定包管理器，继续维护时宜沿用 pnpm 与现有锁文件。
先处理前文指出的异常配置，再安装和构建。清理完成后，开发入口为 pnpm dev；pnpm build 会先执行 Astro 检查，再生成静态文件到 dist/。本次已在临时副本完成生产构建，产物只有一个正式 HTML 页面，没有博客、后台或额外项目内页。
部署到独立域名时，需要调整 astro.config.mjs 的 site 与 base，并一起检查字体路径、favicon、分享图和页面元信息。在线演示已适配 /dark-minimal/ 子目录；演示副本中的路径和业务停用设置，不应直接当作个人正式站的最终配置。
暂无评论内容