(开源)OneHome

项目名：One Home · 开源名：vuepress-theme-onehome

一个基于 Vue 3 + Vite 构建的粉色系个人主页 / 博客开源项目，所有页面内容（首页、公告、文章、友情链接）完全由 Markdown 驱动——不改代码、不重启服务，改 .md 文件即改页面。

特性

• 低饱和粉色系主题，高级不艳俗；渐变背景 + 圆润 Q 弹的微交互（站酷快乐体，加载失败自动回退系统圆体）
• 纯静态渲染，无重滤镜动画，性能友好
• 首页完全由 home.md 驱动：昵称、头像、简介、个人链接、分组链接一键编排；头像带旋转渐变边框，鼠标悬停时头像逆时针旋转 360° 并放大、边框全程跟随，移开后还原
• 公告栏：announcement.md 一条 Frontmatter 即可开关
• 文章写作：posts/ 目录放 .md 即发布，支持标签、分类、日期
• 文档中心模式：docs: /docs 一个字段即可把一组文章变成带侧栏的文档站（章节自动生成 /docs/1、/docs/2…）
• 自定义文章路径：url: /my-post 直接指定文章的访问地址，摆脱固定目录
• 文章加密：password 字段一键加密，输入密码才能阅读
• 友情链接：friends.md 声明式友链卡片，头像支持透明图白底显示、加载失败自动回退白底粉字圆标
• 短链接：shortlinks.md 一个文件配置，/Heflt 这样的短地址直达任意链接；站外新标签页、站内本页跳转；路径自由定义（大小写字母/数字// 等）
• 短链接确认页：访问短链接先显示确认卡片（防止误触、避免浏览器拦截自动弹窗），确认后跳转；标签页标题显示「短链接确认 | 网站名称」，绝不会误显示「文章不存在」
• 防洪提示：检测到 QQ / 微信等内置浏览器访问短链接时弹出「复制链接到浏览器打开」提示，防外链被拦截；默认仅短链接，可配置为全站生效或关闭
• 互动小功能：抽奖轮盘、投票，一行 Markdown 即可嵌入
• 代码高亮、图片灯箱、文章目录、返回顶部、一键收藏 / 分享 / 复制链接
• 站内链接无刷新跳转，站外链接新标签页打开
• 响应式布局，移动端友好；history 路由，URL 干净

环境要求

• Node.js ≥ 18（Vite 5 要求）

快速开始

npm install
npm run dev

启动后访问 http://localhost:5173（端口被占用时 Vite 会自动 +1）。

常用命令

| 命令 | 作用 | |