Shiro

[!IMPORTANT] Shiro 已进入维护模式，将停留在当前版本，不再添加新功能，仅修复关键 Bug。

如果你正在寻找一个全新的个人博客前端，请关注 余白 / Yohaku — 一个独立的新项目，拥有全新的设计语言与视觉体系。完整代码需 赞助 获取访问权限。

Shiro 要求 Mix Space Core 版本 == 10.x，不兼容更高版本。

一个极简主义的个人网站主题，如纸的纯净，似雪的清新。

专为 Mix Space 生态系统设计的现代化个人站点前端。

✨ 示例站点

以下是一些使用 Shiro 主题的精美站点：

• 静かな森
• 可愛い松

欢迎体验 Shiro 带来的极简之美！

🚀 核心特性

• ⚡ 极致性能：在 LightHouse 测试中表现卓越，Performance 和 Best Practice 均超过 90%
• 🎨 现代设计：简洁而不简单的用户界面，提供流畅优雅的用户体验
• 💎 细节至上：采用符合物理学的 Spring 弹性动画，每一帧都如自然般舒适
• 🔔 实时通知：通过 WebSocket 连接，访客可实时接收最新文章推送
• 💻 活动状态：结合 ProcessReporter，在主页展示实时活动状态
• 📝 扩展语法：支持丰富的 Markdown 扩展语法，满足多样化写作需求
• 🏠 精美首页：Hero 区域、活动流、时间线展示、风向标导航
• 💡 思考系统：独立的思考（Recently）页面，支持评论、点赞、RSS Feed
• 🕒 时间线：按年份、类型筛选的文章/手记时间线
• 🌐 多语言：基于 next-intl 的国际化支持

⚙️ 技术架构

基于现代化的前端技术栈构建：

• NextJS 16 (App Router) - React 全栈框架
• Jotai - 原子化状态管理
• Motion - 流畅动画库
• Radix UI - 无障碍组件库
• Socket.IO - 实时通信
• TailwindCSS v4 - 原子化 CSS 框架
• DaisyUI v5 - 组件库
• TanStack Query - 服务端状态管理

📖 部署指南

详细的部署教程请参考：https://mx-space.js.org/docs/themes/shiro/deploy

感谢 @wibus-wee、@wuhang2003 等社区贡献者编写的详细文档。

📷 界面预览

点击查看更多完整页面截图

⚡ 性能测试

在 M2 MacBook Air 环境下对重负载页面的性能测试结果：

🐳 快速开始

📦 预构建版本

从 Releases 页面下载最新的 release.zip 压缩包并解压：

cd standalone
vim .env # 配置环境变量
export PORT=2323
node server.js

:docker: Docker Compose（推荐）

mkdir shiro && cd shiro
wget https://raw.githubusercontent.com/Innei/Shiro/main/docker-compose.yml
wget https://raw.githubusercontent.com/Innei/Shiro/main/.env.template .env

vim .env # 配置环境变量
mkdir public # 放置自定义 Favicon
docker compose up -d

# 后续更新
docker compose pull

📝 Markdown 扩展

了解更多 Markdown 扩展语法，请访问：https://shiro.innei.in/#/markdown

⭐ 余白 / Yohaku

余白 / Yohaku 是一个全新的个人博客项目，拥有独立的设计语言与视觉体系。如果你希望获得持续更新的体验，推荐关注 Yohaku。

⭐ 白い (Shiroi) - 赞助版

白い 是 Shiro 的付费赞助版本，包含更多高级功能：

🤖 AI 智能功能

• AI 智能摘要生成
• AI 内容翻译系统（支持实时翻译推送）
• AI 生成标记系统（支持标记翻译、摘要、自动生成等内容来源）

✨ 高级视觉效果

• WebGPU 雪花背景效果（高级粒子物理系统）
• 萤火虫粒子效果
• 纹理背景系统
• 页面渐变色背景
• 噪声背景生成

👥 实时协作

• Socket.IO 房间管理
• 在线用户实时展示（Presence 组件）
• 访客信息追踪

🔒 认证系统

• Passkey 无密码认证支持
• Passkey 管理页面（创建、列表）

💬 评论系统增强

• Lexical 富文本评论编辑器
• 评论内联编辑功能
• 评论操作按钮组（编辑/回复）

📊 后台系统

• 完整的仪表盘界面
• Lexical 富文本编辑器
• 文章/笔记编辑器增强
• 每日诗词展示（今日诗词 API）

📈 分析集成

• OpenPanel 用户行为分析
• 屏幕视图追踪
• 外链点击追踪

❤️ 致谢与许可

© 2026 Innei - 本项目采用 AGPLv3 许可证，并附加特定的商业使用条件。

使用本项目需要遵循 附加条款和条件。

---

个人网站 · GitHub @Innei