Skip to content
/ Shiro Public

📜 A minimalist personal website embodying the purity of paper and freshness of snow.

License

Notifications You must be signed in to change notification settings

Innei/Shiro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,443 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shiro

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

专为 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 等社区贡献者编写的详细文档。

📷 界面预览

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

页面截图 1 页面截图 2

⚡ 性能测试

在 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

⭐ 白い (Shiroi) - 赞助版

白い 是 Shiro 的付费赞助版本,包含更多高级功能和持续更新。以下是赞助版相对于开源版的新增功能:

🤖 AI 智能功能

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

✨ 高级视觉效果

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

👥 实时协作

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

🔒 认证系统

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

💬 评论系统增强

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

📊 后台系统

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

📈 分析集成

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

❤️ 致谢与许可

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

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


个人网站 · GitHub @Innei

About

📜 A minimalist personal website embodying the purity of paper and freshness of snow.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors

Languages