头像 One
头像 One

更多功能请点顶栏「快捷菜单」

博客 oneblog 3454 字 12 分钟 -- 次

初始需求

最后更新于:

OneBlog的初始需求

博客名称，我给它取名叫：OneBlog 。

 1OneBlog
 2
 3描述：一款 简约、唯美、丝滑且强大的博客！（体验和性能的极致😊，不极致，不博客。）
 4
 5原则：
 6	漂亮为先（大道至简）
 7	性能为先（快如闪电）
 8	体验为先（丝滑流畅）
 9	
10	
11丝滑：	
12	架构丝滑
13	体验丝滑
14	文档库丝滑
15	管理后台丝滑
16	代码丝滑
17	开源丝滑
18	迭代频率丝滑
19		
20	
21核心：
22	站点整体风格
23	首页加载速度
24	切面页面加载速度
25	文档库侧边栏切换速度
26	文档库3栏（侧边文件栏、正文阅读栏、右侧文章目录栏）阅读体验
27	w级别md 免构建
28	博客文章阅读体验
29	博客功能完整性
30	博客现存bug数量
31	可持续迭代能力

建站缘由

为什么要创建个人博客？

  1. 个人博客，不止是技术的记录，也是生活，更是人生。
  2. 让别人拿着我写的文档保准出效果，避免踩坑。
  3. 热爱分享、传播、开源。
  4. 记录博客的人，多半也是孤独的人吧。
  5. 每更新一次博客，就像在精心打理着自己的小庄园。
  6. ……

🍀 你的需求

所以，对一个写博客的人来说，他自己的需求是什么？（很关键）

1.是想要一个博客，有空了写几篇文章丢上去 –那么建议选择 博客风格的；（很多，例如wp，hexo，astro……等等）

2.是想要一个同时支持 博客和文档库 的博客，后续会持续且成体系地更新数据 —–那么建议选择 文档分割&博客风格的；（推荐RZ博客、teek、vdoing博客等……）

精华要点

首先，我们需要知道的2点：

  1. 博客只适合碎片化知识分享，而知识库才是沉淀知识的理想方式；
  2. 博客一般都是给自己看的，除非这个博主的文章质量很高，且高产，不然很少有别人去经常看，别人多半都是瞅瞅这个博客的整体风格咋样，丝滑不；
  3. 虽然说博客的内容很重要，但同时能拥有一款体验丝滑的博客，那会是一件很酷的事儿；😎

下面几点供大家讨论哈哈：

  1. 凡是不支持将本地文档库渲染到首页博客的博客都❌；
  2. 凡是不支持本地md维护的博客都❌；
  3. 凡是部署复杂、配置复杂的博客都❌；
  4. 凡是耗费大配置云服务器的博客都❌；
  5. 凡是太过于花里胡哨的博客都❌；
  6. 凡是打开速度慢、页面不流畅、样式不唯美的博客都❌；
  7. 凡是作者未能持续更新、优化的博客都❌；(如果博客没啥大的bug，功能模块也基本趋于完善，样式足够唯美丝滑，基本可以放慢迭代频率；但如果有用户有新需求产生，看作者有空没，或者赞助让作者帮实现，都行。😊)
  8. 再牛逼的架构，没有极致丝滑的主题也是不行哈哈哈；🤣

问题背景

当前时间是 2026年4月17日

本人喜欢研究博客，特别是一些简约、唯美、丝滑且强大的博客架构。可以用它来记录一下技术文章或者一些生活感悟，体验很棒。

自己对hexo/wordpress/halo/vuepress/vitepress/hugo等博客都体验过，折腾博客不容易呀哈哈哈哈。

😎 自己目前在用的RouxZhee博客存在不足之处（更新）

  1. 在低性能电脑上卡的不要不要的；
  2. rz博客 没法满足 0构建，在线编辑，实时更新；
  3. rz博客 目前无 （完整博客风/简约博客风/文档风/产品官网风）4种风格；
  4. rz博客 未能支持ssr；
  5. rz博客 如果md达到百万级，会卡si哦哈哈哈，且构建时间会随着md数量而增加；
  6. 开发进度90%，停滞了；
  7. astro的确更适合做个人站点；
  8. 待补充……

在用站点

我当前在用的rz站点：https://onedayxyy.cn/ （基于hugo）

我当前在用的rz站点 开源仓库：https://cnb.cool/yuwen-gueen/hugo-teeker-theme

astro主题：https://docs.astro.build/zh-cn/getting-started/ （基于astro）

astro主题开源仓库：https://github.com/withastro/astro

预期目标

  1. 基于 astro主题（https://docs.astro.build/zh-cn/getting-started/） 把我站点（https://onedayxyy.cn/） 的风格和功能 完整迁移过去，并自动修复所有Bug；
  2. 希望OneBlog是 一款 简约现代、清爽漂亮、流畅丝滑、功能完整、功能强大的专业博客。

2026.7.8 提出：

astro的ssr，eo pages的kv或者blob，eo边缘函数，cnb仓库，等，可以弄一个实时更新且具有后台的博客嘛？😊😊😊

适用场景

  1. 个人技术博客、个人生活分享站点、个人知识库
  2. API 文档、产品手册、开源项目文档、团队知识库
  3. 产品官网、公司官网
  4. 作品集展示、摄影集展示

主要特性

如下是自己的最终需求：更新于2026年6月4日15:10:59

细节

  1. 大道至简：一切的花里胡哨都是虚无；（整体风格要简约、清爽、唯美、丝滑且强大）
  2. 快如闪电：首页打开速度、切换页面速度 要轻量、流畅丝滑且快如闪电；
  3. 部署简单：博客部署必须简单；
  4. 身轻如燕：博客在低性能电脑上也不会卡顿；
  5. 二者得兼：必须同时支持博客和文档库：
    1. 方案1：vdoing思想：把文档库里文档渲染到博客首页；（个人更喜欢这种风格💖）（备注：支持文档库，支持万级md文档，且文档体验要舒服、丝滑；）
    2. 方案2：首页为博客风格，但也支持一个个知识库专题；
  6. 小小面板：首页 导航栏 顶部 具有 站点配置 小面板
    1. 支持壁纸模式切换；（横幅壁纸、全屏壁纸、全屏透明、纯色背景）
    2. 支持4种站点风格切换；（完整博客风/简约博客风/文档风/产品官网风）
    3. 支持字体切换；
    4. 支持主题色切换；
    5. 文章布局：列表（图片在一侧、图片两侧交替出现、备注：图片与文字的分隔线（直线或斜线）） 或 网格；
  7. 小小卡片：首页侧边栏卡片模块
    1. 个人简介、重要通告、地理位置欢迎语/天气、日历 节假日倒计时、最新评论、精选文章、文章分类、热门标签、友情链接、赞赏清单、站点统计、关注公众号、网页音乐播放器；
  8. 漂亮壁纸：（banner壁纸、文章封面图/博客背景大图）(博客背景大图使用文章封面图即可)
    1. 方案1：壁纸存放在对象存储里，博客项目里直接写图片的固定路径；
    2. 方案2：api方式 banner壁纸api & 文章封面api；
    3. 扩展：pc壁纸和移动端壁纸需分离；
  9. 无服务器：0服务器方案；（01.前后端分类博客等依赖云服务器的博客相比ssg还是太重了 02.每年还要支出云服务器费用 哈哈哈哈😂）
  10. 在线编辑：支持 在线编辑，实时更新；
  11. 内置功能（必须内置，无需额外部署才行！！！）
    1. 全文搜索（必须支持全文模糊搜索）
    2. 评论
    3. 站点统计、页面浏览量统计、pv统计
    4. 点赞、纠错
  12. 博客后台
    1. 方案
      1. 方案1：一种是在线的后台
      2. 方案2：一种是本地，类似RouxZhee那种，只是本地代替你改配置文件，改完，然后用改好的配置文件继续构建生成；
    2. 需求：
      1. 凡是代码已经实现的博客配置功能，都必须拆解到 博客后台，用户能够通过图形化点点点就能选择开启或关闭某个博客功能，或者配置某个模块；
      2. 博客某个模块需要以哪种方式呈现给用户，完全由用户自己说了算，在图形化点点点就完事儿；
      3. 常见的例如壁纸模式（4种风格）、站点风格（4种风格）、文章布局、主题颜色、字体类型等可以放进博客首页右上角一个小面板里，但这里对用户而言修改后只是在本地浏览器缓存上。真正的默认配置还是需要在博客后台配置，当然这里只有博客管理员才有权限去配置的。
      4. 博客后台基本包含如下部分：站点配置、个人资料、主题切换、菜单映射、赞助者、网站导航、关于我、关于本站、网页音乐播放器、壁纸管理、封面管理、文章管理、评论管理、友联管理、图床管理、统计分析、一键WEB升级、备份恢复……
      5. 博客后台不能太重，但得体验流畅，满足基本功能；
    3. 优势：
      1. 上手成本极低：对刚接手这款博客的小白非常友好，只要登录博客后台，都可以在图形化点点点就能完整配置好自己博客了，而无需一直追着作者问这里要怎么配置呢，那里要怎么配置呢哈哈哈，大大节省了彼此的时间；
      2. 各司其职：博客开发者只需关注博客代码，持续迭代新功能和修复bug。而用户只需关注自己文档和博客后台图形化配置即可，真正做到代码和博客功能/文档完全隔离；
    4. 其余
      1. 另外，我们可以在博客后台，一键web升级到新版本哦；
      2. 后端最好是用博客域名/admin就能直接登录的后台（这里必须是强加密），对移动端编辑md文章要友好（方便后续移动端发表文章、修改博客配置等）；
      3. 支持 即使后端挂掉，也不影响站点正常访问（备注：这里的后端我希望是eo边缘函数提供的类似后端功能）；
    5. 案例
      1. 案例1：RouxZhee博客后台截图 https://img2.onedayxyy.cn/images/image-20260528165839.avif
      2. 案例2：hyde博客后台截图 https://img2.onedayxyy.cn/images/image-20260528170014.avif
      3. 案例3：w3c博客后台截图 https://img2.onedayxyy.cn/images/image-20260528170039.avif
  13. 样式细节
    1. banner壁纸轮播、打字机（毛玻璃 & 字体为渐变色）、向下小箭头、大波浪
    2. 好看的彩色滚动条：首页侧边栏、文章目录侧边栏、代码块底部滑动栏
    3. 复制后提示
    4. 代码块 显示更多、点击收缩；代码块暗黑风格；代码块标题；代码块语言图标；
    5. 首页 向下箭头、向上箭头（小火箭）；
    6. 顶部进度条
    7. footer：可爱小熊、徽标、技术架构/版权/备案号/公安备案号、访客数据、寄语；
    8. 常见markdown语法：告警容器风格、高亮部分行、代码组、代码折叠展开效果；
    9. 选择一款 好看的图标
    10. 选择一款 好看的中文字体
    11. 首页顶部右上角数字时钟
    12. 3栏自适应宽度（侧边栏、正文、文章目录）
    13. 移动端文章阅读风格
  14. 扩展模块
    1. 关于我、关于本站、网站导航、友联(需支持表单)、评论、留言区；
    2. 朋友圈、思考、好物分享；
    3. 相册、音乐、电影 模块；（利用openlist的302挂在云盘即可！ 可以看下我的demo站点）
    4. 图床；
    5. 强加密 & 付费阅读；
    6. 本地typora主题 和 网站页面 风格 需要保持一致；
    7. 常用服务；
    8. 实用工具；
    9. 菜单映射；（一个个目录被映射成一个个文档库）
    10. formatter工具；
  15. 生生不息：能持续开发和优化博客主题（修复遇到的bug & 开发新功能 & 美化博客元素）；

解决方案

astro+cnb+eo边缘函数 解决方案

另外，如下这个方案好像很厉害哦：astro ssr + cnb + eo边缘函数，貌似可以实现上面的这些全部需求。

  1. 这种方案可以实现，把md文档存放在cnb仓库，然后编辑md后，可以实现动态更新。 我记得w3c 大佬好像实现过，利用eo的云函数来实现的。这样的话我有100w md文档，也会实时动态更新，就会免去构建这个工作，很香哦。

  2. 这种方案 同时也能够实现强加密 & 付费阅读 功能；

  3. 同样，这个方案，也可以实现把 博客后台 托管在eo边缘函数，这样就无需后端服务器，完全实现0服务器方案。

这个w3c大佬的域名是：

https://image.js.cn/ （核心站点）

https://demo.w3c.cool/

https://astro.w3c.cool/

请根据以上需求 提供完整的解决方案和代码，要求无bug，多谢。

结束。

新风格博客首页

请设计一款 简约、清爽、漂亮、有特色的 个人博客站点首页。

首页卡片问题：

1首页必须出现的卡片：
2个人简介、重要通告、文章分类、热门标签、站点统计
3
4
5放在小按钮里的卡片：
6友情链接、赞赏清单、最新评论、日历 节假日倒计时、关注公众号、网页音乐播放器、地理位置欢迎语/天气（右下角 弹出）
📡
👤 作者: One
🔗 链接: https://onedayxyy.cn/topics/csxq
🌐 版权: 本站文章除特别声明外，均采用 CC BY-NC-SA 4.0 协议，转载请注明来自 One Blog！
最新文章

文档导航