blog: publish 2025-final

blog: 2025-final (#23 )
Reviewed-on: #23
2026-05-08 01:23:40 +08:00 · 2026-05-07 02:04:01 +00:00 · 2026-04-03 17:16:52 +08:00 · 2026-03-29 16:14:47 +08:00 · 2026-03-29 16:10:59 +08:00 · 2026-03-28 21:59:54 +08:00
68 changed files with 720 additions and 162 deletions
--- a/YaeBlog.slnx
+++ b/YaeBlog.slnx
@@ -12,6 +12,7 @@
    <File Path="README.md" />
  </Folder>
  <Folder Name="/src/">
+    <Project Path="src/YaeBlog.Abstractions/YaeBlog.Abstractions.csproj" />
    <Project Path="src/YaeBlog.Tests/YaeBlog.Tests.csproj" />
    <Project Path="src/YaeBlog/YaeBlog.csproj" />
  </Folder>
--- a/build.ps1
+++ b/build.ps1
@@ -146,10 +146,6 @@ process {
            dotnet run -- serve
            break
        }
-        "list" {
-            dotnet run -- list
-            break
-        }
    }
 }

--- a/source/posts/2025-final.md
+++ b/source/posts/2025-final.md
@@ -0,0 +1,174 @@
+---
+title: 2025年终总结
+date: 2026-05-08T01:22:18.6904350+08:00
+updateTime: 2026-05-08T01:22:18.8859180+08:00
+tags:
+- 杂谈
+- 年终总结
+---
+
+
+
+越来越晚的年终总结是本站不得不品的一大特色，在这样下去2026年的年终总结要到2028年才能面世了（绝望）。不过2025年确实是非常丰富多彩的一年，这一年的经历是如此的多样，以至于真正需要提笔写下来的时候反而不知道可以写什么。
+
+<!--more-->
+
+### 毕业
+
+在2025年的6月，我从明光村幼儿园附属大学的括号学院毕业了。
+
+毕业本身似乎并不是什么特别需要记录的事情，不过是一篇论文、两张证书和几次合照，现在回想起来只有一种如堕梦中的感觉。
+
+虽然对于其他的事情都已经几乎淡忘，但是因为我提前自愿（？）选修了研究生课程《高性能计算》，而这门课的期末考试日期甚至在毕业典礼之后。这不得不使得我在毕业季各种事务缠身的情况下还得抽出时间准备考试，而这个《高性能计算》课程的内容又多又杂，实在是又难学又难背。这使得我对于这个毕业季影响最深刻的事情不是什么毕业合照，而是SMP和CUDA！
+
+不过说都说到这里了，顺便回忆一下我的四年大学生活吧。
+
+### 我的大学
+
+还记得2021年的暑假，我还在和一个名叫Microsoft Visual Studio的神秘软件搏斗，并不知道这个软件中某个叫作.NET SDK的东西会成为这四年中的一个重要组成部分，当时还创作了本博客的[第一篇文章](https://rrricardo.top/blog/essays/question-in-install-vs-2019)。
+
+2021年的9月第一次来到校园，不得不说该附属大学的偏远校区还是很符合我对于大学校园的刻板印象的。标准的四人间、高大的图书馆，迷宫一样的教学楼设计充分满足了我对于大学生活的一切想象，甚至到主校区需要坐一个半小时地铁也是刻板印象的一部分。
+
+不过这样的“幸福大学生活”只持续了四个月。在2022年9月份就回到了宇宙中心的南边，中国最宽公路的东边，我们伟大的明光村。很高情商地说，在这个校区中学习和生活，可以**随时随地**地品味到这个学校深厚的历史底蕴。例如我现在居住的宿舍，在20年前也居住过我的导师。课间在窗边踱步，你可以欣赏到墙上的照片里，脚下的教学楼在1956年落成时的雄姿。
+
+还是谈谈在这四年中我所修过的那些课程吧。本来在2025年6月毕业之后，我打算写一篇文章，结合我四年中的经历，详细分析一下我所经历的计算机科学本科教学。但是迟迟没有时间落笔，就在这里简单评述一下。
+
+![image-20260503175234105](./2025-final/image-20260503175234105.webp)
+
+首先是培养方案中归类为“数学与自然科学”的课程：《高等数学A》和《线性代数》是必修课，其中《高等数学A》因为代课老师江彦是一个**认真负责**的好老师，这里给到一个夯。《线性代数》则是因为课程设计和老师只能给到一个NPC，说实话本来想给到一个拉完了，但是考虑到这门课算是计算机科学比较重要的数学基础，还是给到NPC。
+
+两门概率论课程我选的是《概率论与随机过程》，同样因为代课老师鞠红杰给到一个顶级，而且随机过程本来就是一个非常有趣的研究课题，这门课的课程论文就是博客中的[原神抽卡研究](https://rrricardo.top/blog/essays/genshin-gacha-1)。至于《组合数学》、《运筹学》、《数学建模与模拟》和《矩阵理论与方法》四选一，我选择的是《数学建模与模拟》，这个课程只能给到NPC，听了和没听一样，老师脾气还不太好。《大学物理C》同样只能给到一个NPC，虽然我对于物理还是挺感兴趣的~~还参加了大学生物理竞赛~~，但是这实在和计算机学科关系不太大，安排这个不如多安排一些通信和电子的内容。
+
+然后是培养方案中“学科基础”大类课程，这个课程组中的课程都是必修课程。《计算导论与程序设计》是大一上学期的唯一一门专业课，也是计算机科学的入门课，我会说它很好的完成了这个任务，虽然还有不少的优化空间，这里给到一个顶级。
+
+《电路与电子学基础》我直接给到一个顶级，老师非常风趣幽默，教学内容不能说是和计算机科学直接相关，但也算是计算机的基石了。《离散数学》这里是一个拉完了，从理论上来说离散数学的教学内容可以算是实际上的计算机科学核心，但是正是这种极端重要性更加凸显出了这个课程拉完了的程度，而且还是中英文混合教学，我的评价是没有金刚钻就别揽瓷器活。
+
+《数字逻辑与数字系统》，还可以，归类到人上人，课程内容本身比较重要，算是之后的计算机组成原理的先修课程。《形式语言与自动机》，这门课的代课老师石川老师算是北邮的风云人物，其他的东西不评价，但是他在这门课程上的表现还是值得肯定的，这里归到人上人。
+
+下面正式进入计算机科学中的真·核心课程，即培养方案中的“专业基础”课程组。首先是《数据结构》，因为考试要求手写代码直接给到一个拉完了，我得承认这个有我自己的一些偏见。《算法设计与分析》本来想以同样的理由给到一个拉完了，~~但是考虑到我的成绩比《数据结构》高~~，这里给到一个NPC。《计算机系统基础》课程，使用的教材是大名鼎鼎的*Computer System: A Programmer Perspective* ，虽然课程并没有完全覆盖CSAPP中所有内容，但是还是给到一个夯！
+
+《操作系统》，按道理讲也是计算机科学中的核心课程，但是课程内容我现在就记得一个信号量控制抢水果和挑水，老师也非常莫名其妙，直接给到拉完了，正所谓学完这门课你也不懂操作系统。然后是《编译原理与技术》，可以算是计算机科学中最难的课程之一，但是因为课程核心都放在了编译器的前端部分，教学语言还是老掉牙的Pascal，只能给到一个人上人。
+
+《计算机组成原理》，考虑老师直接在课程推销王道考研，直接给到拉完了。《计算机系统结构》，算是《计算机组成原理》的进阶课，老师讲得也非常不错，和之前的《计算机组成原理》相比简直是天差地别，直接给到一个顶级，如果实验部分改进一下，和《计算机组成原理课程设计》结合一下，就可以直接给到夯了。《计算机网络》直接给到夯，算是课程与现实结合最紧密的课程，和《离散数学》同样都是中英文混合教学，只能说人与人之间亦有差距。《数据库系统原理》获得夯的理由和《计算机网络》比较一致，都是同现实紧密关联的课程，任课老师教学非常不错，也是中英文混合教学。
+
+《软件工程》和《现代交换原理》则是难兄难弟，两门都是拉完了：《软件工程》被称为计算机科学中的政治，我认为与其死记硬背一些非常抽象的概念、参加两次考试不如多写几行代码来得体会深刻。而且这门课的实践部分也非常抽象，要求几个小组联合验收：而且这些小组的前后端之间需要可以随机组合。虽然这个要求可以说是非常的软件工程，但是和你合作的哥们可能并不是特别拟人，只能唉唉唉。至于《现代交换原理》，第一次看到这门课的时候我很怀疑这是否是打印错误，虽然代课老师挺不错的，但是它唯一的问题就是不该出现在计算机科学的培养方案上。退一步说就算学校设计培养方案的时候希望计算机科学的同学也懂一点通信，也是应该设计简单一点的通信原理而不是设计一门不知所云的“古代交换原理”课程（毕竟课程的主体部分是电话交换机）。
+
+然后是专业课选修课组部分。在“网络&开发技术模块”，我选修的课程是《下一代Internet技术与协议》、《移动互联网技术及应用》和《Python程序设计》三门课。其中《下一代Internet技术与协议》是中规中矩的选修课程，只能归到NPC一档，课程的主要内容就是讲IPv6协议栈，考虑到现在IPv6协议栈已经在大规模的普及推进，建议把课程名称中的“下一代”去掉。《移动互联网技术及应用》就是教写Android应用，考虑到这门课的老师是北邮少数敢于在课程上打开IDE写代码的老师，出于对这位老师的敬佩，这里给到人上人。《Python程序设计》也是一门平平无奇的选修课，同时是出于对踢球骨折了还拄着拐杖来上课的老师之敬佩，这里给到人上人。
+
+在“大数据技术模块”，我选修的课程是《大数据技术基础》和《信息与知识获取》。其中的《大数据技术基础》的实验部分非常抽象，要求使用容器技术模拟出多个节点来搭建大数据系统，比如Hadoop和Spark，还需要在华为的ARM云服务器上进行实验，与其叫作是《大数据技术基础》不如改名为《Linux系统运维基础》。不过考虑到这是我本科期间唯一一门愿意给100分的课程，这门还是给到人上人。《信息与知识获取》则是“大海呀，你全部都是水~”，这里给到NPC。
+
+在“技术拓展模块”，我选修的课程是《人工智能原理》和《程序设计实践》。这两门都给到NPC，《人工智能原理》是因为它讲授的原理有点太古老了，连深度神经网络都没有涉及，还需要考试，只能给到NPC。《程序设计实践》则是普通的水课，项目开源在[github](https://github.com/jackfiled/Katheryne)上，看上去这个题目也是祖传题目了。
+
+然后我们可以来谈论一下最激动人心的实践课课组。首先是《物理实验A》，由于是线上教学做实验，直接给到一个拉完了。《计算导论与程序设计课程设计》（不太可能会有“普通人”在大一的下学期就选择《程序设计竞赛基础》吧）是大一下学期开设，课程设计的题目是公交车的调度，对大一新人来说还是挺合适的，这里给到一个人上人。面向对象的程序设计实践我选择的是Java，这个只能说拉完了，Java感觉没学到什么有用的，最后交作业的时候还要求提交一大堆软件工程的UML图。
+
+《计算机组成原理课程设计》和《数字逻辑与数字系统课程设计》二选一我选择是《计算机组成原理课程设计》，题目是设计一个单周期的CPU，非常好课程直接给到夯！唯一的问题似乎因为小学期时间安排的问题，导致最后只有三四天的时间来完成整个作业，这种课程就应该设计为一个必修实验，而且最好需要设计一个完整的五段流水线CPU。
+
+《操作系统课程设计》和《编译原理课程设计》二选一我选择了《编译原理课程设计》，这更多是一个历史和“人民”的选择，当时我们课程班100多个人，最后只有一个小组大概8个人选择了《操作系统课程设计》。不过《编译原理课程设计》确实可以给到夯！首先是老师非常不错，然后课程设计的内容也确实可以说是循序渐进。唯一的问题是设计的编译器是从Pascal翻译到C，和编译原理课程本身的衔接也不是特别紧密，尤其是考虑到编译原理课程本身自带的两个实验就是词法分析和语法分析，课程设计还把重点放在前端上就有点不太好了。最好是把题目修改到C到某门汇编语言，例如RISC-V，然后和《编译原理》课程本身的实验衔接设计，课程设计的重点就可以放在代码生成和代码优化上面了。
+
+至于最后的三选二选修课，在《数据结构课程设计》、《计算机网络课程设计》和《数据库系统原理课程设计》三门中我选择的前两门。《数据结构课程设计》有一个非常奇葩的要求，不能使用自带的数据结构实现（比如说标准库中的列表、哈希表等），而是要求自行实现，但是在最后验收时并没有突出这一点，这里只能给到一个人上人，算是实践课程中比较低的评价了。《计算机网络课程设计》要求设计一个DNS Relay服务器，比较典型的计算机网络课程设计的要求，唯一的问题是要求必须要用C语言完成，只能给到一个顶级。这里我感觉老师做出这个限制的主要理由是希望大家多钻研一下和网络相关的高并发设计，但是直接限制到C语言级别有点强人所难了。
+
+最后锐评一下我选过的公选课和体育课，在我的培养方案中，我需要选修两门以上的公选课（人文艺术类型）和四门体育课（其中一门必修的《体育基础》）。我为了满足培养方案选修的公选课是《人工智能与社会发展》和《显示技术发展与游戏应用》两门，普通的水课没什么好说的，给到NPC。不过在培养方案之外我还选修了一门《基于Arduino的开源手机设计》，非常好的选修课，课程内容是基于ESP8266设计一个支持2G和Wi-Fi的按键手机。所有上课的同学都可以免费获得一个板子，值得选修，这里给到一个夯。
+
+至于体育课，因为我本人体育苦手，评价略有失真之处，仅供参考。首先是在**线上**进行的《体育基础》课，直接给到NPC，至于《健美》和《乒乓球》，考虑到我学得不好应该是我的问题，给到一个顶级。至于最后的《太极拳》因为体育苦手的缘故，简直就是我等的福音，给到夯！
+
+### 实习与工作
+
+在毕业之后不能躲过的话题自然就是工作，虽然正式的找工作离我还有~~三年~~两年半的时间。尤其是考虑到我们伟大的学校并不打算为保研的同学提供宿舍，在6月被赶出校门之后，一个比较正确的选择就是找一份实习。
+
+大概从2025年的5月份我就开始在BOSS直聘上找实习，首选的工作意向就是和我现在研究方向相关联的编译器、高性能计算和AI Infra方向，考虑到这些方向的工作岗位数量如同食堂番茄蛋花汤中的蛋花，我也填上了后端方向作为备选。不过找工作真的好痛苦啊：从事后统计来看，在那半个月的时间里我大概投出去了60多份简历，其中只有个位数的HR回复了消息，只约上了一场面试。这便是今天的主角——理想汽车。
+
+说起来也奇怪，招聘的这个岗位，理想汽车的图编译器开发，并不是我自己找上门去的，而是对方的HR主动要走了我的简历。下面就简单记录一下理想汽车的图编译器开发实习生的面经吧，不过说实话这已经是接近一年之前的事情了，如果有错漏之处还请谅解。
+
+上来还是自我介绍起手，并介绍自己简历上的一些项目。因为我当时没有任何的实习经历，简历上主要的项目其实是本科的毕业设计。不过因为这个毕业设计题目取得非常高大上，但是实现上非常一坨，所以拷打的过程个人感觉漏洞百出。
+
+然后是一些基础的编译器知识，比如说你是否知道什么是静态单赋值形式，MLIR中的IR是否是SSA等等，还结合MLIR问了很多MLIR中的细节开发问题，如果你是否定义过Dialect，是否写过operation的parser和printer等等。还有MLIR中的pass分为什么，是否了解这些pass是如何运行的，有一些非常细节的问题我当时就直接回答不知道了（捂脸）。
+
+中间还拷打了一些`C++`开发的知识，比如说CRTP这种在MLIR中非常常用的模板范式，不过我当时因为对`C++`开发还不是特别熟悉，将中间的`static_cast`说成了`dynamic_cast`，非常的尴尬。面试官还问了问我研究生和本科的主修课程。
+
+编程的题目是手撕堆排序，但是面试官找了半天都没有找到测试的题目，只让我口述了算法的过程，不过我当时过度紧张（毕竟是人生的第一场面试），什么归并快排桶排堆排的都丢到九霄云外去了，只能阿巴阿巴地说一些建堆、排序之内的车轱辘话，幸好面试官也没有特别纠结这一块。反问的环节我是询问了一下我们工作的对象，理想汽车自研汽车芯片的情况，也就是现在即将发布的马赫100芯片。
+
+幸好最终的结果还是比较好的，顺利拿到了offer并入职理想。不过当时暑假期间的工资是按照本科生算的，只有230一天，考虑到当时我在北京还需要租房居住，差点付费上班（幸好还有第二份兼职）。而且当时部门正处于芯片即将上车的集中开发阶段，8月份还把我们一起打包送到杭州去上班，血亏一个月房租，~~不过住一个月的酒店还是蛮爽的，谢谢想哥~~。
+
+不过说来我还是非常感谢在理想的这段实习经历的。在进入理想实习之前，虽然我已经在导师的手下干了一年，但是感觉对于编译器，尤其是这种面向NPU的AI编译器，总感觉还是有一种雾里看花的感觉。但是在实习过程中，实际接触了编译器的开发和优化流程，瞬间感觉过程论文和课本中的编译器活了过来。同样也是在这段经历中，我对于MLIR的了解和认识也是飞速增长。
+
+在理想的实习经历之外，~~为了赚房租~~为了进一步提高自己的能力，同时在为我在开源世界中开辟一块立锥之地，我报名并参加了2025年的开源之夏（OSPP）项目，中选的题目是[RustSBI原型系统引导生态完善](https://summer-ospp.ac.cn/org/prodetail/256590172?lang=zh&list=pro)。不过这次OSPP的经历我打算单出一篇文章来分享（挖坑x1），这里就不多赘述了。
+
+### 研究生
+
+讲道理，在9月份开学之后我就回到明光村幼儿园附属大学继续攻读我的硕士学位了，这段研究生时光也占据了2025年度三分之一的长度。但是我在撰写本年终总结的时候却对于这段时光一点回忆也没有，真是令人感到好奇！
+
+### 第一台NAS
+
+上面拖拖拉拉地讲了一堆令人悲伤的话题，还是一转聊一聊一些开心的话题吧。
+
+经过若干个月的精心筹备，在2025年的一季度，我终于组建了我的个人NAS，虽然这台NAS里面目前只有1块4T 3.5英寸硬盘和几块从笔记本上拆下来的2.5英寸硬盘，显得我精心挑选的8 STAT接口主板和8个3.5英寸硬盘位的机箱显得很呆。不过还是很开心，谁叫组装好硬件就遇上了AI导致的硬件大涨价呢。
+
+![](./2025-final/IMG_20250301_164145.webp)
+
+这里也是简单列一下硬件配置：
+
+1. CPU：Intel Xeon E3-1245v5
+2. 内存：镁光DDR4 ECC 16G 2400 x2
+3. 主板：超微X11SSH-F
+4. 电源：全汉 蓝暴经典PLUS 450W
+5. 机箱：联宇 见方L
+6. CPU散热器：利民AXP90-X36
+
+这里我也打算后面单独出一篇文章分享设计和配置这个NAS的点点滴滴（挖坑x2），这里就简单吐槽一件令我非常绷不住的事。这里选择E3-1245v5这颗带有核显的CPU简直就是我最大的错误，我设计的时候考虑的是这颗核显可以极大地加快NAS上各种媒体的解码速度。但是E3-1245v5这颗CPU带的核显简直就是垃圾中的垃圾：它不支持H265/HEVC 10 bit的解码，简直就是屁用没用！
+
+而且，这颗CPU在秋季开学之后就挂掉了，还贡献了我的第一张Linux蓝屏~~扫码即可查看当时的Kernel日志~~：
+
+![](./2025-final/IMG_20251021_160338.webp)
+
+我不得不购入了第二块CPU，也就是现在机器上使用的Intel Xeon E3-1240v5。谢天谢地，这颗CPU到目前还工作正常，而它比它带核显的兄弟足足便宜了三分之二。
+
+### 第一台台式机
+
+除了这台，我还在暑假的时候组装了我人生的第一台台式机：
+
+![](./2025-final/IMG_20260506_201126.webp)
+
+这里也简单列举一下这台主机的配置：
+
+- CPU： AMD 锐龙 5 9600X
+- 内存：光威龙武弈 DDR5 长鑫颗粒 6000 CL36 16G x2
+- 主板：华硕TX B650EM WIFI W
+- GPU：ONIX Intel ARC B580 LUMI 12G
+- 电源：鑫谷 GM650W 金牌全模组
+- CPU散热器：九州风神 玄冰400V5 晴雪白
+- 机箱散热器：酷冷至尊莫比乌斯120白色 x2
+- 立牌：psplive 2025校园主题亚克力立牌-[李豆沙_Channel](https://space.bilibili.com/1703797642)
+
+组装这台主机的时间非常巧妙，我是在7月初的时候下定决心组装这台台式机，这几乎是在电子产品大涨价之前最后一个上车的时间窗口了。
+
+关于我选择的这些配置我也想简单讨论一下。主要的争议点可能是我选择的显卡，当时我的决赛圈里面几乎就是了两张显卡：NVIDIA的RTX 5060和Intel的Arc B580。最终驱动我做出决定的因素主要是预算，RTX 5060的价格基本上都在2500元以上，而我拿下的这块Intel Arc B580只花了我1800元。虽然当时网上对于Intel显卡驱动的批评甚嚣尘上，但是我决定对Intel这家老牌的半导体厂商保持基本的信任（至少到目前为止，Intel还没有辜负我的信任）。而且考虑到我实际上也是一个Linux用户，NVIDIA的Linux驱动是个什么样子是不言自明的，至少Intel的Linux支持情况要好得多。
+
+而且在我目前的日常游玩的所有游戏中这块显卡都表现正常，例如《三角洲行动》在我目前的2K分辨率下可以取得90~110FPS的水平。《原神》和《戴森球计划》这种对于显卡需求比较低的游戏更是轻松拿下。
+
+### 玫瑰色生活
+
+2025年也是一个旅行颇多的年份。
+
+首先是趁着毕业的时候，去北京一个著名的小众冷门（这是否矛盾？）景点——中央礼品文物管理中心参观，算是一个非常有首都特色的景点了。然后是忙碌的8月份，在北京和杭州之间飞来飞去，很幸运地是在其中的一次坐到了国产大飞机C919前往杭州：
+
+![](./2025-final/IMG_20250824_183058.webp)
+
+还前往了内蒙古的鄂尔多斯参加全国高性能计算学术年会CCF HPC China 2025。学术上的东西在下人微言轻不做评价，不过至少HPC China在茶歇上比之前去参加了CNCC 2024要慷慨的多。其他的内容可以参见同行者的[文章](https://www.chenxutalk.top/posts/life/travel/neimenggu/)。
+
+正所谓“读万卷书，行万里路”。在2025年还读了下面这几本书：
+
+- [*GOSICK*](https://mzh.moegirl.org.cn/GOSICK)，樱庭一树著，不算是一般意义上的轻小说，而是比较严肃的推理小说，好看！
+- 《浪潮之巅》，吴军创作的科技产业发展史的书籍，对于计算机相关领域从业者来说可以说是必读的经典书籍了。
+
+还看了不少的电影：一部是看上去比较冷门的电影《商海通牒》，原名*Margin Call*，记录的是2008年到2009年发生金融危机时一家华尔街投行中发生的故事。另一部则是学校组织放映的《窗外是蓝星》，记录的是神舟十三号乘组首次在中国空间站执行在轨驻留六个月任务的故事。岁月如梭啊，现在已经是神舟二十一号乘组了。
+
+本来在年终总结的末尾，按照传统还是应该放一下B站的观看时长，但是在撰写本文时B站似乎已经下架了2025年度报告的查看页面了（悲）。
+
+
+
+
+
+
+
+
+
--- a/source/posts/2025-final/IMG_20250301_164145.webp
+++ b/source/posts/2025-final/IMG_20250301_164145.webp
--- a/source/posts/2025-final/IMG_20250824_183058.webp
+++ b/source/posts/2025-final/IMG_20250824_183058.webp
--- a/source/posts/2025-final/IMG_20251021_160338.webp
+++ b/source/posts/2025-final/IMG_20251021_160338.webp
--- a/source/posts/2025-final/IMG_20260506_201126.webp
+++ b/source/posts/2025-final/IMG_20260506_201126.webp
--- a/source/posts/2025-final/image-20260503175234105.webp
+++ b/source/posts/2025-final/image-20260503175234105.webp
--- a/source/posts/system-text-json.md
+++ b/source/posts/system-text-json.md
@@ -1,7 +1,7 @@
 ---
 title: 使用System.Text.Json序列化和反序列化JSON
 date: 2026-01-21T22:07:38.4297603+08:00
-updateTime: 2026-01-21T22:07:38.4370636+08:00
+updateTime: 2026-04-03T17:16:16.0831040+08:00
 tags:
 - 技术笔记
 - dotnet
@@ -9,6 +9,7 @@ tags:



+
 如何使用`System.Text.Json`高效地序列化和反序列化JSON？

 <!--more-->
@@ -217,6 +218,14 @@ record MyPoco(
    }
 ```

+但是在实际的生产和生活中，并不会有人将可选的属性序列化为`null` 之后再返回，而是直接忽略这个属性。这就让“可为空”这个属性显得有点鸡肋，因此可为空的属性一般也需要提供了一个可选的构造函数参数：
+
+```csharp
+record MyPocp(string RequiredField, string? NotRequiredField = null)
+```
+
+更本质的说，这是因为Javascript中提供了两种空`undefined`和`null`，然而在C#中并没有提供`undefined`对应的语言构造，因此只能通过这种默认值为`null`的构造函数参数来模拟。
+
 #### 反序列化为结构

 结构作为值类型，虽然在函数之间传递时需要被拷贝而带来了额外的性能开销，但是也因为这一点而可以被直接分配在栈上，给GC带来的压力较小。因此在部分需要极端性能优化的场景可以直接针对`struct`进行反序列化。
--- a/source/posts/tarjan-bridge.md
+++ b/source/posts/tarjan-bridge.md
@@ -0,0 +1,215 @@
+---
+title: Tarjan算法与实现
+date: 2026-03-28T21:53:45.1681856+08:00
+updateTime: 2026-03-28T21:53:45.1733146+08:00
+tags:
+- 技术笔记
+- 算法
+---
+
+
+Tarjan算法是一类用于无向图中割边和割点的算法。
+
+<!--more-->
+
+## Tarjan算法
+
+Tarjan算法是图论中非常常用的一种算法，基于深度优先搜索（DFS），基础版本的Tarjan算法用于求解无向图中的割点和桥。基于此可以求解图论中的一系列问题，例如无向图的双连通分量、有向图的强连通分量等问题。
+
+Tarjan算法由计算机科学家Robert Tarjan在1972年于论文*Depth-First Search And Linear Graph Algorithms*中提出。Robert Tarjan是一位著名的计算机科学家，解决了图论中的一系列重大问题，同时也是斐波那契堆（Fibonacci Heap）和伸展树（Splay Tree）的开发者之一。他于1986年获得了图灵奖，目前仍在普林斯顿大学担任教职。
+
+## 无向图的割点与桥
+
+如果一个图中所有的边都是无向边，则称之为无向图。
+
+### 割点
+
+如果从无向图中删除节点x和所有与节点x关联的边之后，图将会被分成两个或者两个以上不相连的子图，那么节点x就是这个图的割点。下图中标注为红色的点就是该图的割点。
+
+![image-20260328213522542](./tarjan-bridge/image-20260328213522542.webp)
+
+### 桥
+
+如果从图中删除边e之后，图将分裂为两个不相连的子图，那么就称e是图的桥，或者割边。
+
+![image-20260328213554309](./tarjan-bridge/image-20260328213554309.webp)
+
+图中被标注为红色的边就是该图的桥。
+
+## 求解图中的割点
+
+Tarjan算法中为了求解桥和割点，首先定义了如下几个概念。
+
+### 时间戳
+
+时间戳用来标记图中每个节点在进行深度优先搜索的过程中被访问的时间顺序，这个概念起始也就是在遍历的时候给每个节点编号。
+
+这个编号用`search_number[x]`来表示，其中的x是节点。
+
+### 搜索树
+
+在图中，如果从一个节点x出发进行深度优先的搜索，在搜索的过程中每个节点只能访问一次，所有被访问的节点可以构成一棵树，这棵树就被称为无向连通图的搜索树。
+
+### 追溯值
+
+追溯值的定义和计算是Tarjan算法的核心。
+
+追溯值被定义为，从当前节点x作为搜索树的根节点出现，能够访问到的所有节点中，时间戳的最小值，被记为`low[x]`。
+
+定义中主要的限定条件是“能够访问到的所有节点”，主要考虑的是如下两种访问方式：
+
+- 这个节点在以x为根的搜索树上
+- 通过一条不属于搜索树的边，可以到达搜索树的节点。
+
+例如上图的例子中，考虑直接从节点1出发开始深度优先的遍历，此时使用的遍历顺序是节点1、节点2、节点3、节点4、节点5。
+
+![image-20260328213641303](./tarjan-bridge/image-20260328213641303.webp)
+
+当遍历到节点5时，考虑以节点5为根的搜索树（可以认为此时的搜索树中只有节点5一个节点），可以发现有两条不属于搜索树的边(2, 5)和(1, 5)，使得节点1和节点2成为了上述“可以访问到的节点”，因此将节点5的追溯值更新为1。
+
+![image-20260328213702466](./tarjan-bridge/image-20260328213702466.webp)
+
+此时，算法按照深度优先搜索的顺序开始回溯，在回溯的过程中逐步更新当前节点的追溯值，此时就是按照上面“可以访问的所有节点”中的搜索树情形工作了。例如当回溯到节点3时，可以认为存在以节点3为根节点的搜索树{3, 4, 5}，其中追溯值的最小值为1, 将节点3的追溯值更新为1。
+
+![image-20260328213720719](./tarjan-bridge/image-20260328213720719.webp)
+
+### 桥的判定法则
+
+在无向图中，对于一条边`e = (u ,v)`，如果满足`search_number[u] < low[v]`，那么该边就是图中的一个桥。
+
+这个条件所蕴含的意思是，节点u被访问的时间，要小于（优先于）以下所有这些节点被访问的时间：
+
+- 以节点v为根节点的搜索树中的所有节点
+- 通过一条非搜索树上的边，能否到达搜索树的所有节点。
+
+## 实现
+
+以下以[1192. 查找集群内的关键连接 - 力扣（LeetCode）](https://leetcode.cn/problems/critical-connections-in-a-network/description/)为例，给出Tarjan算法的实现。
+
+```cpp
+namespace {
+/// Graph structure.
+/// Store the graph using linked forwarded stars.
+/// The linked forwarded stars store the graph using linked list.
+///
+/// To accelerate the loading and storing, use array to simulate the linked
+/// list.
+struct Graph {
+  explicit Graph(const size_t nodeCount, const size_t edgeCount) {
+    // The edgeID starts from 2, as 0 is used as null value.
+    // And to find the reverse edge by i ^ 1, so 0 and 1 are both skipped.
+    endNodes = vector<size_t>(edgeCount + 2, 0);
+    nextEdges = vector<size_t>(edgeCount + 2, 0);
+    headEdges = vector<size_t>(nodeCount, 0);
+  }
+
+  void addEdge(const size_t x, const size_t y) {
+    endNodes[edgeID] = y;
+    nextEdges[edgeID] = headEdges[x];
+    headEdges[x] = edgeID;
+
+    edgeID += 1;
+  }
+
+  vector<bool> calculateBridges() {
+    // Initialize values used by tarjan algorithm.
+    const auto nodeCount = headEdges.size();
+    bridges = vector(endNodes.size(), false);
+    nodeIDs = vector<size_t>(nodeCount, 0);
+    lowValues = vector<size_t>(nodeCount, 0);
+
+    number = 1;
+
+    for (auto i = 0; i < nodeCount; i++) {
+      if (nodeIDs[i] == 0) {
+        tarjan(i, 0);
+      }
+    }
+
+    return bridges;
+  }
+
+private:
+  size_t edgeID = 2;
+
+  /// Represent the end node of edge i.
+  vector<size_t> endNodes;
+
+  /// Represent the next edge of edge i.
+  vector<size_t> nextEdges;
+
+  /// Represent the head edge of node i.
+  /// Also, head of simulated linked list.
+  vector<size_t> headEdges;
+
+  vector<bool> bridges;
+
+  /// Represent timestamp of node i, 0 is used as unvisited.
+  vector<size_t> nodeIDs;
+
+  vector<size_t> lowValues;
+
+  size_t number = 1;
+
+  void tarjan(const size_t node, const size_t inEdge) {
+    nodeIDs[node] = lowValues[node] = number;
+    number += 1;
+
+    for (auto i = headEdges[node]; i != 0; i = nextEdges[i]) {
+
+      // If the next node is not visited.
+      if (const auto end = endNodes[i]; nodeIDs[end] == 0) {
+        tarjan(end, i);
+
+        lowValues[node] = min(lowValues[node], lowValues[end]);
+        if (lowValues[end] > nodeIDs[node]) {
+          // Subtract 2 as the edge ID starts from 2.
+          bridges[i - 2] = true;
+          bridges[(i ^ 1) - 2] = true;
+        }
+      } else {
+        // If edge i is visited and edge i is not the coming edge.
+        if (i != (inEdge ^ 1)) {
+          lowValues[node] = min(lowValues[node], nodeIDs[end]);
+        }
+      }
+    }
+  }
+};
+} // namespace
+
+class Solution {
+public:
+  vector<vector<int>> criticalConnections(int n,
+                                          vector<vector<int>> &connections) {
+    // To store the undirected graph, double the edge count.
+    auto g = Graph{static_cast<size_t>(n), connections.size() * 2};
+
+    for (const auto &edge : connections) {
+      g.addEdge(edge[0], edge[1]);
+      g.addEdge(edge[1], edge[0]);
+    }
+
+    auto bridges = g.calculateBridges();
+    vector<vector<int>> result;
+    for (auto i = 0; i < bridges.size(); i = i + 2) {
+      if (bridges[i]) {
+        const auto &edge = connections[i / 2];
+        result.push_back(edge);
+      }
+    }
+
+    return result;
+  }
+};
+
+
+```
+
+### 链式前向星
+
+在上面的实现中使用了一种较为高效的图存储方法-链式前向星（Linked Forward Star）。
+
+链式前向星是一种类似于邻接表的图存储方法，提供了较为高效的边遍历方法。这种方法的本质上是按节点聚合的边链表，不过在上面的实现中使用了数组来存储链表的头结点和每个节点的下一个节点指针。
+
+同时这种存储方法还提供了一种非常方便的反向边查找方法：考虑在存储无向图中的边时，将一条边成对的存储在数组中，由此针对任意一条边i，`i ^ 1`就是这条边的反向边。
--- a/source/posts/tarjan-bridge/image-20260328213522542.webp
+++ b/source/posts/tarjan-bridge/image-20260328213522542.webp
--- a/source/posts/tarjan-bridge/image-20260328213554309.webp
+++ b/source/posts/tarjan-bridge/image-20260328213554309.webp
--- a/source/posts/tarjan-bridge/image-20260328213641303.webp
+++ b/source/posts/tarjan-bridge/image-20260328213641303.webp
--- a/source/posts/tarjan-bridge/image-20260328213702466.webp
+++ b/source/posts/tarjan-bridge/image-20260328213702466.webp
--- a/source/posts/tarjan-bridge/image-20260328213720719.webp
+++ b/source/posts/tarjan-bridge/image-20260328213720719.webp
--- a/src/YaeBlog.Abstractions/IEssayContentService.cs
+++ b/src/YaeBlog.Abstractions/IEssayContentService.cs
@@ -1,7 +1,7 @@
 using System.Diagnostics.CodeAnalysis;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

-namespace YaeBlog.Abstraction;
+namespace YaeBlog.Abstractions;

 public interface IEssayContentService
 {
--- a/src/YaeBlog.Abstractions/IEssayScanService.cs
+++ b/src/YaeBlog.Abstractions/IEssayScanService.cs
@@ -1,6 +1,6 @@
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

-namespace YaeBlog.Abstraction;
+namespace YaeBlog.Abstractions;

 public interface IEssayScanService
 {
--- a/src/YaeBlog.Abstractions/IPostRenderProcessor.cs
+++ b/src/YaeBlog.Abstractions/IPostRenderProcessor.cs
@@ -1,6 +1,6 @@
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

-namespace YaeBlog.Abstraction;
+namespace YaeBlog.Abstractions;

 public interface IPostRenderProcessor
 {
--- a/src/YaeBlog.Abstractions/IPreRenderProcessor.cs
+++ b/src/YaeBlog.Abstractions/IPreRenderProcessor.cs
@@ -1,6 +1,6 @@
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

-namespace YaeBlog.Abstraction;
+namespace YaeBlog.Abstractions;

 public interface IPreRenderProcessor
 {
--- a/src/YaeBlog.Abstractions/Models/BlogContent.cs
+++ b/src/YaeBlog.Abstractions/Models/BlogContent.cs
@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 /// <summary>
 /// 单个博客文件的所有数据和元数据
--- a/src/YaeBlog.Abstractions/Models/BlogContents.cs
+++ b/src/YaeBlog.Abstractions/Models/BlogContents.cs
@@ -1,7 +1,7 @@
 using System.Collections;
 using System.Collections.Concurrent;

-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 public record BlogContents(ConcurrentBag<BlogContent> Drafts, ConcurrentBag<BlogContent> Posts)
    : IEnumerable<BlogContent>
--- a/src/YaeBlog.Abstractions/Models/BlogEssay.cs
+++ b/src/YaeBlog.Abstractions/Models/BlogEssay.cs
@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 public record BlogEssay(
    string Title,
--- a/src/YaeBlog.Abstractions/Models/BlogHeadline.cs
+++ b/src/YaeBlog.Abstractions/Models/BlogHeadline.cs
@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 public class BlogHeadline(string title, string selectorId)
 {
--- a/src/YaeBlog.Abstractions/Models/BlogImageInfo.cs
+++ b/src/YaeBlog.Abstractions/Models/BlogImageInfo.cs
@@ -1,6 +1,6 @@
 using System.Text;

-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 public record BlogImageInfo(FileInfo File, long Width, long Height, string MineType, byte[] Content, bool IsUsed)
    : IComparable<BlogImageInfo>
--- a/src/YaeBlog.Abstractions/Models/BlogOptions.cs
+++ b/src/YaeBlog.Abstractions/Models/BlogOptions.cs
@@ -1,6 +1,6 @@
 using System.ComponentModel.DataAnnotations;

-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 /// <summary>
 /// 友链模型类
--- a/src/YaeBlog.Abstractions/Models/EssayTag.cs
+++ b/src/YaeBlog.Abstractions/Models/EssayTag.cs
@@ -1,6 +1,6 @@
 using System.Text.Encodings.Web;

-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 public class EssayTag(string tagName) : IEquatable<EssayTag>
 {
--- a/src/YaeBlog.Abstractions/Models/GiteaOptions.cs
+++ b/src/YaeBlog.Abstractions/Models/GiteaOptions.cs
@@ -1,6 +1,6 @@
 using System.ComponentModel.DataAnnotations;

-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 public class GiteaOptions
 {
@@ -8,7 +8,7 @@ public class GiteaOptions

    [Required] public required string BaseAddress { get; init; }

-    [Required] public required string ApiKey { get; init; }
+    public string? ApiKey { get; init; }

    [Required] public required string HeatMapUsername { get; init; }
 }
--- a/src/YaeBlog.Abstractions/Models/HeatMapItem.cs
+++ b/src/YaeBlog.Abstractions/Models/HeatMapItem.cs
@@ -1,5 +1,8 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

-public record GitContributionItem(DateOnly Time, long ContributionCount);
+public record GitContributionItem(DateOnly Time, long ContributionCount)
+{
+    public string ItemId => $"item-{Time:yyyy-MM-dd}";
+}

 public record GitContributionGroupedByWeek(DateOnly Monday, List<GitContributionItem> Contributions);
--- a/src/YaeBlog.Abstractions/Models/MarkdownMetadata.cs
+++ b/src/YaeBlog.Abstractions/Models/MarkdownMetadata.cs
@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;

 public class MarkdownMetadata
 {
--- a/src/YaeBlog.Abstractions/YaeBlog.Abstractions.csproj
+++ b/src/YaeBlog.Abstractions/YaeBlog.Abstractions.csproj
@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <TargetFramework>net10.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+    </PropertyGroup>
+
+</Project>
--- a/src/YaeBlog.Tests/GiteaFetchServiceTests.cs
+++ b/src/YaeBlog.Tests/GiteaFetchServiceTests.cs
@@ -1,7 +1,8 @@
 using DotNext;
+using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 using Moq;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;
 using YaeBlog.Services;

 namespace YaeBlog.Tests;
@@ -9,6 +10,7 @@ namespace YaeBlog.Tests;
 public sealed class GiteaFetchServiceTests
 {
    private static readonly Mock<IOptions<GiteaOptions>> s_giteaOptionsMock = new();
+    private static readonly Mock<ILogger<GiteaFetchService>> s_logger = new();
    private readonly GiteaFetchService _giteaFetchService;

    public GiteaFetchServiceTests()
@@ -16,12 +18,10 @@ public sealed class GiteaFetchServiceTests
        s_giteaOptionsMock.SetupGet(o => o.Value)
            .Returns(new GiteaOptions
            {
-                BaseAddress = "https://git.rrricardo.top/api/v1/",
-                ApiKey = "7e33617e5d084199332fceec3e0cb04c6ddced55",
-                HeatMapUsername = "jackfiled"
+                BaseAddress = "https://git.rrricardo.top/api/v1/", HeatMapUsername = "jackfiled"
            });

-        _giteaFetchService = new GiteaFetchService(s_giteaOptionsMock.Object, new HttpClient());
+        _giteaFetchService = new GiteaFetchService(s_giteaOptionsMock.Object, new HttpClient(), s_logger.Object);
    }

    [Fact]
--- a/src/YaeBlog.Tests/OptionsMock.cs
+++ b/src/YaeBlog.Tests/OptionsMock.cs
@@ -1,6 +1,6 @@
 using Microsoft.Extensions.Options;
 using Moq;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Tests;

--- a/src/YaeBlog/Components/BlogInformationCard.razor
+++ b/src/YaeBlog/Components/BlogInformationCard.razor
@@ -1,6 +1,6 @@
@using Microsoft.Extensions.Options
-@using YaeBlog.Abstraction
-@using YaeBlog.Models
+@using YaeBlog.Abstractions
+@using YaeBlog.Abstractions.Models

@inject IEssayContentService Contents
@inject IOptions<BlogOptions> Options
--- a/src/YaeBlog/Components/EssayCard.razor
+++ b/src/YaeBlog/Components/EssayCard.razor
@@ -1,5 +1,5 @@
@using System.Text.Encodings.Web
-@using YaeBlog.Models
+@using YaeBlog.Abstractions.Models

 <div class="flex flex-col p-3">
    <div class="text-3xl font-bold py-2">
--- a/src/YaeBlog/Components/Foonter.razor
+++ b/src/YaeBlog/Components/Foonter.razor
@@ -7,10 +7,13 @@
            <Anchor Address="https://dotnet.microsoft.com" Text="@DotnetVersion"/>
            驱动。
        </p>
-        <p class="text-md">
-            Build Commit #
-            <Anchor Address="@BuildCommitUrl" Text="@BuildCommitId"/>
-        </p>
+        @if (!string.IsNullOrEmpty(BuildCommitId))
+        {
+            <p class="text-md">
+                Build Commit #
+                <Anchor Address="@BuildCommitUrl" Text="@BuildCommitId" NewPage="true"/>
+            </p>
+        }
    </div>

    <div>
@@ -24,7 +27,7 @@
 {
    private static string DotnetVersion => $".NET {Environment.Version}";

-    private static string BuildCommitId => Environment.GetEnvironmentVariable("COMMIT_ID") ?? "local_build";
+    private static string? BuildCommitId => Environment.GetEnvironmentVariable("COMMIT_ID");

    private static string BuildCommitUrl => $"https://git.rrricardo.top/jackfiled/YaeBlog/commit/{BuildCommitId}";
 }
--- a/src/YaeBlog/Components/GitHeatMap.razor
+++ b/src/YaeBlog/Components/GitHeatMap.razor
@@ -1,4 +1,4 @@
-@using YaeBlog.Models
+@using YaeBlog.Abstractions.Models
@using YaeBlog.Services
@inject GitHeapMapService GitHeapMapInstance

@@ -7,13 +7,13 @@
        <SvgGroup Transform="@GlobalMonthTransform">
            @foreach ((int i, string text) in _monthIndices)
            {
-                <SvgText Content="@text" Transform="@(MonthTextTransform(i))" Class="text-[10px]"/>
+                <SvgText Content="@text" Transform="@(MonthTextTransform(i))" Class="text-[8px] font-light"/>
            }
        </SvgGroup>
        <SvgGroup Transform="@GlobalWeekTransform">
            @foreach ((int i, string text) in Weekdays.Index())
            {
-                <SvgText Content="@text" Transform="@(DayTextTransform(i))" Class="text-[10px]"/>
+                <SvgText Content="@text" Transform="@(DayTextTransform(i))" Class="text-[8px] font-light"/>
            }
        </SvgGroup>
        <SvgGroup Transform="@GlobalMapTransform">
@@ -23,7 +23,8 @@
                    @foreach ((int j, GitContributionItem item) in contribution.Contributions.Index())
                    {
                        <Rectangle Width="@Width" Height="@Width" Transform="@(WeekdayGridTransform(j))"
-                                   Class="@(GetColorByContribution(item.ContributionCount))"/>
+                                   Class="@(GetColorByContribution(item.ContributionCount))"
+                                   Id="@(item.ItemId)"/>
                    }
                </SvgGroup>
            }
@@ -118,5 +119,4 @@
            _ => "fill-blue-800"
        };
    }
-
 }
--- a/src/YaeBlog/Components/Layout/BlogLayout.razor
+++ b/src/YaeBlog/Components/Layout/BlogLayout.razor
@@ -24,5 +24,5 @@
        @Body
    </div>

-    <Foonter/>
+    <Footer/>
 </main>
--- a/src/YaeBlog/Components/Layout/MainLayout.razor
+++ b/src/YaeBlog/Components/Layout/MainLayout.razor
@@ -32,5 +32,5 @@
        </div>
    </div>

-    <Foonter/>
+    <Footer/>
 </main>
--- a/src/YaeBlog/Components/Pages/About.razor
+++ b/src/YaeBlog/Components/Pages/About.razor
@@ -6,7 +6,7 @@

 <div class="flex flex-col">
    <div>
-        <h1 class="text-4xl">关于</h1>
+        <h1 class="text-4xl page-starter">关于</h1>
    </div>

    <div class="py-4">
--- a/src/YaeBlog/Components/Pages/Archives.razor
+++ b/src/YaeBlog/Components/Pages/Archives.razor
@@ -1,6 +1,6 @@
@page "/blog/archives"
-@using YaeBlog.Abstraction
-@using YaeBlog.Models
+@using YaeBlog.Abstractions
+@using YaeBlog.Abstractions.Models

@inject IEssayContentService Contents

@@ -10,7 +10,7 @@

 <div class="flex flex-col">
    <div>
-        <h1 class="text-4xl">归档</h1>
+        <h1 class="text-4xl page-starter">归档</h1>
    </div>

    <div class="py-4">
--- a/src/YaeBlog/Components/Pages/BlogIndex.razor
+++ b/src/YaeBlog/Components/Pages/BlogIndex.razor
@@ -1,6 +1,6 @@
@page "/blog"
-@using YaeBlog.Abstraction
-@using YaeBlog.Models
+@using YaeBlog.Abstractions
+@using YaeBlog.Abstractions.Models

@inject IEssayContentService Contents
@inject NavigationManager NavigationInstance
@@ -10,6 +10,7 @@
 </PageTitle>

 <div>
+    <div class="page-starter"></div>
    <div class="grid grid-cols-4">
        <div class="col-span-4 md:col-span-3">
            @foreach (BlogEssay essay in _essays)
--- a/src/YaeBlog/Components/Pages/Essays.razor
+++ b/src/YaeBlog/Components/Pages/Essays.razor
@@ -1,7 +1,7 @@
@page "/blog/essays/{BlogKey}"
@using System.Text.Encodings.Web
-@using YaeBlog.Abstraction
-@using YaeBlog.Models
+@using YaeBlog.Abstractions
+@using YaeBlog.Abstractions.Models

@inject IEssayContentService Contents
@inject NavigationManager NavigationInstance
@@ -14,7 +14,7 @@
    <div>
        <div class="flex flex-col items-center">
            <div>
-                <h1 id="title" class="text-4xl">@(_essay!.Title)</h1>
+                <h1 id="title" class="text-4xl page-starter">@(_essay!.Title)</h1>
            </div>

            <div class="flex flex-row gap-4 py-2">
--- a/src/YaeBlog/Components/Pages/Friends.razor
+++ b/src/YaeBlog/Components/Pages/Friends.razor
@@ -1,6 +1,6 @@
@page "/friends"
@using Microsoft.Extensions.Options
-@using YaeBlog.Models
+@using YaeBlog.Abstractions.Models
@inject IOptions<BlogOptions> BlogOptionInstance

 <PageTitle>
@@ -9,7 +9,7 @@

 <div class="flex flex-col">
    <div>
-        <h1 class="text-4xl">
+        <h1 class="text-4xl page-starter">
            友链
        </h1>
    </div>
--- a/src/YaeBlog/Components/Pages/Index.razor
+++ b/src/YaeBlog/Components/Pages/Index.razor
@@ -1,6 +1,6 @@
@page "/"
-@using YaeBlog.Abstraction
-@using YaeBlog.Models
+@using YaeBlog.Abstractions
+@using YaeBlog.Abstractions.Models
@inject IEssayContentService EssayContentInstance

 <PageTitle>
@@ -17,7 +17,7 @@
        <div class="col-span-3 md:col-span-2">
            <div class="flex flex-col gap-y-3 items-center md:items-start md:px-6">
                <div class="">
-                    <div class="text-3xl font-bold">初冬的朝阳</div>
+                    <div class="text-3xl font-bold page-starter">初冬的朝阳</div>
                </div>

                <div class="">
--- a/src/YaeBlog/Components/Pages/NotFound.razor
+++ b/src/YaeBlog/Components/Pages/NotFound.razor
@@ -5,7 +5,7 @@
 </PageTitle>

 <div>
-    <h3 class="text-3xl">NotFound!</h3>
+    <h3 class="text-3xl page-starter">NotFound!</h3>
 </div>

@code {
--- a/src/YaeBlog/Components/Pages/Tags.razor
+++ b/src/YaeBlog/Components/Pages/Tags.razor
@@ -1,7 +1,7 @@
@page "/blog/tags/"
@using System.Text.Encodings.Web
-@using YaeBlog.Abstraction
-@using YaeBlog.Models
+@using YaeBlog.Abstractions
+@using YaeBlog.Abstractions.Models

@inject IEssayContentService Contents
@inject NavigationManager NavigationInstance
@@ -11,7 +11,7 @@
 </PageTitle>

 <div class="flex flex-col">
-    <div>
+    <div class="page-starter">
        @if (TagName is null)
        {
            <h1 class="text-4xl">标签</h1>
--- a/src/YaeBlog/Components/Routes.razor
+++ b/src/YaeBlog/Components/Routes.razor
@@ -9,6 +9,6 @@
            <RouteView RouteData="@routeData" DefaultLayout="@typeof(Layout.MainLayout)"></RouteView>
        }

-        <FocusOnNavigate RouteData="routeData" Selector="h1"/>
+        <FocusOnNavigate RouteData="routeData" Selector="page-starter"/>
    </Found>
 </Router>
--- a/src/YaeBlog/Extensions/DateOnlyExtensions.cs
+++ b/src/YaeBlog/Extensions/DateOnlyExtensions.cs
@@ -18,5 +18,17 @@ public static class DateOnlyExtensions
                };
            }
        }
+
+        public int DayNumberOfWeek
+        {
+            get
+            {
+                return date.DayOfWeek switch
+                {
+                    DayOfWeek.Sunday => 7,
+                    _ => (int)date.DayOfWeek + 1
+                };
+            }
+        }
    }
 }
--- a/src/YaeBlog/Extensions/HostApplicationBuilderExtensions.cs
+++ b/src/YaeBlog/Extensions/HostApplicationBuilderExtensions.cs
@@ -1,26 +1,73 @@
 using AngleSharp;
 using Microsoft.Extensions.Options;
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Services;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;
 using YaeBlog.Processors;

 namespace YaeBlog.Extensions;

-public static class WebApplicationBuilderExtensions
+public static class HostApplicationBuilderExtensions
 {
-    extension(WebApplicationBuilder builder)
+    extension(IHostApplicationBuilder builder)
    {
-        public WebApplicationBuilder AddYaeBlog()
+        public ConsoleInfoService AddYaeCommand(string[] arguments)
        {
-            builder.ConfigureOptions<BlogOptions>(BlogOptions.OptionName)
-                .ConfigureOptions<GiteaOptions>(GiteaOptions.OptionName);
+            builder.AddCommonServices();

+            builder.Logging.AddFilter("Microsoft.Hosting.Lifetime", LogLevel.Warning);
+
+            builder.Services.AddTransient<ImageCompressService>();
+            builder.Services.AddHostedService<YaeCommandService>(provider =>
+            {
+                IEssayScanService essayScanService = provider.GetRequiredService<IEssayScanService>();
+                ImageCompressService imageCompressService = provider.GetRequiredService<ImageCompressService>();
+                ConsoleInfoService consoleInfoService = provider.GetRequiredService<ConsoleInfoService>();
+                IOptions<BlogOptions> blogOptions = provider.GetRequiredService<IOptions<BlogOptions>>();
+                ILogger<YaeCommandService> logger = provider.GetRequiredService<ILogger<YaeCommandService>>();
+                IHostApplicationLifetime hostApplicationLifetime =
+                    provider.GetRequiredService<IHostApplicationLifetime>();
+
+                return new YaeCommandService(arguments, essayScanService, imageCompressService, consoleInfoService,
+                    hostApplicationLifetime, blogOptions, logger);
+            });
+
+            ConsoleInfoService infoService = new();
+            builder.Services.AddSingleton<ConsoleInfoService>(_ => infoService);
+
+            return infoService;
+        }
+
+        private void AddCommonServices()
+        {
            builder.Services.AddHttpClient()
                .AddMarkdig()
                .AddYamlParser();

+            builder.ConfigureOptions<BlogOptions>(BlogOptions.OptionName)
+                .ConfigureOptions<GiteaOptions>(GiteaOptions.OptionName);
+
+            builder.Services.AddSingleton<IEssayScanService, EssayScanService>();
+        }
+
+        private IHostApplicationBuilder ConfigureOptions<T>(string optionSectionName) where T : class
+        {
+            builder.Services
+                .AddOptions<T>()
+                .Bind(builder.Configuration.GetSection(optionSectionName))
+                .ValidateDataAnnotations();
+            return builder;
+        }
+    }
+
+    extension(WebApplicationBuilder builder)
+    {
+        public WebApplicationBuilder AddYaeServer(ConsoleInfoService consoleInfoService)
+        {
+            builder.AddCommonServices();
+
            builder.Services.AddSingleton<AngleSharp.IConfiguration>(_ => Configuration.Default)
+                .AddSingleton<ConsoleInfoService>(_ => consoleInfoService)
                .AddSingleton<IEssayScanService, EssayScanService>()
                .AddSingleton<RendererService>()
                .AddSingleton<IEssayContentService, EssayContentService>()
@@ -32,31 +79,8 @@ public static class WebApplicationBuilderExtensions
                .AddTransient<BlogHotReloadService>()
                .AddSingleton<GitHeapMapService>();

-            return builder;
-        }
+            builder.Services.AddHostedService<StartServerService>();

-        public WebApplicationBuilder AddYaeCommand(string[] arguments)
-        {
-            builder.Services.AddHostedService<YaeCommandService>(provider =>
-            {
-                IEssayScanService essayScanService = provider.GetRequiredService<IEssayScanService>();
-                IOptions<BlogOptions> blogOptions = provider.GetRequiredService<IOptions<BlogOptions>>();
-                ILogger<YaeCommandService> logger = provider.GetRequiredService<ILogger<YaeCommandService>>();
-                IHostApplicationLifetime applicationLifetime = provider.GetRequiredService<IHostApplicationLifetime>();
-
-                return new YaeCommandService(arguments, essayScanService, provider, blogOptions, logger,
-                    applicationLifetime);
-            });
-
-            return builder;
-        }
-
-        private WebApplicationBuilder ConfigureOptions<T>(string optionSectionName) where T : class
-        {
-            builder.Services
-                .AddOptions<T>()
-                .Bind(builder.Configuration.GetSection(optionSectionName))
-                .ValidateDataAnnotations();
            return builder;
        }
    }
--- a/src/YaeBlog/Extensions/WebApplicationExtensions.cs
+++ b/src/YaeBlog/Extensions/WebApplicationExtensions.cs
@@ -1,4 +1,4 @@
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Processors;
 using YaeBlog.Services;

--- a/src/YaeBlog/Processors/EssayStylesPostRenderProcessor.cs
+++ b/src/YaeBlog/Processors/EssayStylesPostRenderProcessor.cs
@@ -1,8 +1,8 @@
 using AngleSharp;
 using AngleSharp.Dom;
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Extensions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Processors;

--- a/src/YaeBlog/Processors/HeadlinePostRenderProcessor.cs
+++ b/src/YaeBlog/Processors/HeadlinePostRenderProcessor.cs
@@ -1,7 +1,7 @@
 using AngleSharp;
 using AngleSharp.Dom;
-using YaeBlog.Abstraction;
-using YaeBlog.Models;
+using YaeBlog.Abstractions;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Processors;

--- a/src/YaeBlog/Processors/ImagePostRenderProcessor.cs
+++ b/src/YaeBlog/Processors/ImagePostRenderProcessor.cs
@@ -1,9 +1,9 @@
 using AngleSharp;
 using AngleSharp.Dom;
 using Microsoft.Extensions.Options;
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Core.Exceptions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Processors;

--- a/src/YaeBlog/Program.cs
+++ b/src/YaeBlog/Program.cs
@@ -1,13 +1,25 @@
 using YaeBlog.Components;
 using YaeBlog.Extensions;
+using YaeBlog.Services;
+
+HostApplicationBuilder consoleBuilder = Host.CreateApplicationBuilder(args);
+
+ConsoleInfoService consoleInfoService = consoleBuilder.AddYaeCommand(args);
+
+IHost consoleApp = consoleBuilder.Build();
+await consoleApp.RunAsync();
+
+if (consoleInfoService.IsOneShotCommand)
+{
+    return;
+}

 WebApplicationBuilder builder = WebApplication.CreateBuilder(args);

 builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents();
 builder.Services.AddControllers();
-builder.AddYaeBlog();
-builder.AddYaeCommand(args);
+builder.AddYaeServer(consoleInfoService);

 WebApplication application = builder.Build();

--- a/src/YaeBlog/Services/BlogChangeWatcher.cs
+++ b/src/YaeBlog/Services/BlogChangeWatcher.cs
@@ -1,5 +1,5 @@
 using Microsoft.Extensions.Options;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services;

--- a/src/YaeBlog/Services/BlogHotReloadService.cs
+++ b/src/YaeBlog/Services/BlogHotReloadService.cs
@@ -1,4 +1,4 @@
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;

 namespace YaeBlog.Services;

--- a/src/YaeBlog/Services/ConsoleInfoService.cs
+++ b/src/YaeBlog/Services/ConsoleInfoService.cs
@@ -0,0 +1,14 @@
+namespace YaeBlog.Services;
+
+public enum ServerCommand
+{
+    Serve,
+    Watch
+}
+
+public sealed class ConsoleInfoService
+{
+    public bool IsOneShotCommand { get; set; }
+
+    public ServerCommand Command { get; set; }
+}
--- a/src/YaeBlog/Services/EssayContentService.cs
+++ b/src/YaeBlog/Services/EssayContentService.cs
@@ -1,7 +1,7 @@
 using System.Collections.Concurrent;
 using System.Diagnostics.CodeAnalysis;
-using YaeBlog.Abstraction;
-using YaeBlog.Models;
+using YaeBlog.Abstractions;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services;

--- a/src/YaeBlog/Services/EssayScanService.cs
+++ b/src/YaeBlog/Services/EssayScanService.cs
@@ -3,9 +3,9 @@ using System.Text.RegularExpressions;
 using Imageflow.Bindings;
 using Imageflow.Fluent;
 using Microsoft.Extensions.Options;
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Core.Exceptions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;
 using YamlDotNet.Core;
 using YamlDotNet.Serialization;

--- a/src/YaeBlog/Services/GitHeatMapService.cs
+++ b/src/YaeBlog/Services/GitHeatMapService.cs
@@ -1,11 +1,13 @@
 using DotNext;
 using Microsoft.Extensions.Options;
 using YaeBlog.Extensions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services;

-public sealed class GitHeapMapService(IServiceProvider serviceProvider, IOptions<GiteaOptions> giteaOptions,
+public sealed class GitHeapMapService(
+    IServiceProvider serviceProvider,
+    IOptions<GiteaOptions> giteaOptions,
    ILogger<GitHeapMapService> logger)
 {
    /// <summary>
@@ -83,7 +85,24 @@ public sealed class GitHeapMapService(IServiceProvider serviceProvider, IOptions
            groupedContribution.Contributions.Add(new GitContributionItem(date, contributions));
        }

-        // Not fill the last item and add directly.
+        // If the last contributing day is not today, fill the spacing.
+        // But be careful here! If the last grouped contribution is current week, just fill the spacing until today.
+        // If the last grouped contribution is before current week, first fill the blank week then fill until today.
+        while (groupedContribution.Monday < today.LastMonday)
+        {
+            FillSpacing(groupedContribution, today);
+            result.Add(groupedContribution);
+            groupedContribution = new GitContributionGroupedByWeek(groupedContribution.Monday.AddDays(7), []);
+        }
+
+        // Currently the grouped contribution must be current week.
+        for (DateOnly date = groupedContribution.Monday.AddDays(groupedContribution.Contributions.Count);
+             date <= today;
+             date = date.AddDays(1))
+        {
+            groupedContribution.Contributions.Add(new GitContributionItem(date, 0));
+        }
+
        result.Add(groupedContribution);

        _gitContributionsGroupedByWeek = result;
--- a/src/YaeBlog/Services/GiteaFetchService.cs
+++ b/src/YaeBlog/Services/GiteaFetchService.cs
@@ -3,34 +3,45 @@ using System.Text.Json;
 using DotNext;
 using Microsoft.Extensions.Options;
 using YaeBlog.Core.Exceptions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services;

 public sealed class GiteaFetchService
 {
    private readonly HttpClient _httpClient;
+    private readonly ILogger<GiteaFetchService> _logger;

    private static readonly JsonSerializerOptions s_serializerOptions = new()
    {
-        PropertyNameCaseInsensitive = true, PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower,
-        RespectRequiredConstructorParameters = true, RespectNullableAnnotations = true
+        PropertyNameCaseInsensitive = true,
+        PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower,
+        RespectRequiredConstructorParameters = true,
+        RespectNullableAnnotations = true
    };

    /// <summary>
    /// For test only.
    /// </summary>
-    internal GiteaFetchService(IOptions<GiteaOptions> giteaOptions, HttpClient httpClient)
+    internal GiteaFetchService(IOptions<GiteaOptions> giteaOptions, HttpClient httpClient,
+        ILogger<GiteaFetchService> logger)
    {
        _httpClient = httpClient;
+        _logger = logger;

        _httpClient.BaseAddress = new Uri(giteaOptions.Value.BaseAddress);
-        _httpClient.DefaultRequestHeaders.Authorization =
-            new AuthenticationHeaderValue("Bearer", giteaOptions.Value.ApiKey);
+        if (string.IsNullOrWhiteSpace(giteaOptions.Value.ApiKey))
+        {
+            return;
+        }
+
+        logger.LogInformation("Api Token is set.");
+        httpClient.DefaultRequestHeaders.Authorization =
+            new AuthenticationHeaderValue("token", giteaOptions.Value.ApiKey);
    }

-    public GiteaFetchService(IOptions<GiteaOptions> giteaOptions, IHttpClientFactory httpClientFactory) : this(
-        giteaOptions, httpClientFactory.CreateClient())
+    public GiteaFetchService(IOptions<GiteaOptions> giteaOptions, IHttpClientFactory httpClientFactory,
+        ILogger<GiteaFetchService> logger) : this(giteaOptions, httpClientFactory.CreateClient(), logger)
    {
    }

@@ -50,6 +61,7 @@ public sealed class GiteaFetchService
                    new GiteaFetchException("Failed to fetch valid data."));
            }

+            _logger.LogInformation("Fetch new user heat map data.");
            return Result.FromValue(data.Select(i =>
                new GitContributionItem(DateOnly.FromDateTime(DateTimeOffset.FromUnixTimeSeconds(i.Timestamp).DateTime),
                    i.Contributions)).ToList());
--- a/src/YaeBlog/Services/ImageCompressService.cs
+++ b/src/YaeBlog/Services/ImageCompressService.cs
@@ -1,7 +1,7 @@
 using Imageflow.Fluent;
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Core.Exceptions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services;

@@ -34,6 +34,7 @@ public sealed class ImageCompressService(IEssayScanService essayScanService, ILo

        if (needCompressContents.Count == 0)
        {
+            logger.LogInformation("No candidates found to be compressed.");
            return;
        }

@@ -51,7 +52,7 @@ public sealed class ImageCompressService(IEssayScanService essayScanService, ILo

            foreach (BlogImageInfo image in uncompressedImages)
            {
-                logger.LogInformation("Uncompressed image: {} belonging to blog {}.", image.File.Name,
+                logger.LogInformation("Uncompressed image: {filename} belonging to blog {blog}.", image.File.Name,
                    content.BlogName);
            }

@@ -82,7 +83,7 @@ public sealed class ImageCompressService(IEssayScanService essayScanService, ILo

        logger.LogInformation("Compression ratio: {}%.", (double)compressedSize / uncompressedSize * 100.0);

-        if (dryRun is false)
+        if (!dryRun)
        {
            await Task.WhenAll(from content in compressedContent
                select essayScanService.SaveBlogContent(content, content.IsDraft));
--- a/src/YaeBlog/Services/MarkdownWordCounter.cs
+++ b/src/YaeBlog/Services/MarkdownWordCounter.cs
@@ -1,5 +1,5 @@
 using YaeBlog.Extensions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services
 {
--- a/src/YaeBlog/Services/RendererService.cs
+++ b/src/YaeBlog/Services/RendererService.cs
@@ -3,9 +3,9 @@ using System.Diagnostics;
 using System.Text;
 using System.Text.RegularExpressions;
 using Markdig;
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Core.Exceptions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services;

--- a/src/YaeBlog/Services/StartServerService.cs
+++ b/src/YaeBlog/Services/StartServerService.cs
@@ -0,0 +1,27 @@
+namespace YaeBlog.Services;
+
+public sealed class StartServerService(ConsoleInfoService consoleInfoService,
+    RendererService rendererService,
+    BlogHotReloadService blogHotReloadService) : IHostedService
+{
+    public async Task StartAsync(CancellationToken cancellationToken)
+    {
+        switch (consoleInfoService.Command)
+        {
+            case ServerCommand.Serve:
+                {
+                    await rendererService.RenderAsync();
+                    break;
+                }
+            case ServerCommand.Watch:
+                {
+                    await blogHotReloadService.StartAsync(cancellationToken);
+                    break;
+                }
+            default:
+                throw new InvalidOperationException();
+        }
+    }
+
+    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+}
--- a/src/YaeBlog/Services/YaeCommandService.cs
+++ b/src/YaeBlog/Services/YaeCommandService.cs
@@ -2,30 +2,31 @@
 using System.CommandLine.Invocation;
 using System.Text;
 using Microsoft.Extensions.Options;
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Core.Exceptions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;

 namespace YaeBlog.Services;

-public class YaeCommandService(
+public sealed class YaeCommandService(
    string[] arguments,
    IEssayScanService essayScanService,
-    IServiceProvider serviceProvider,
+    ImageCompressService imageCompressService,
+    ConsoleInfoService consoleInfoService,
+    IHostApplicationLifetime hostApplicationLifetime,
    IOptions<BlogOptions> blogOptions,
-    ILogger<YaeCommandService> logger,
-    IHostApplicationLifetime applicationLifetime)
-    : IHostedService
+    ILogger<YaeCommandService> logger)
+    : BackgroundService
 {
    private readonly BlogOptions _blogOptions = blogOptions.Value;
    private bool _oneShotCommandFlag = true;

-    public async Task StartAsync(CancellationToken cancellationToken)
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        RootCommand rootCommand = new("YaeBlog CLI");

        RegisterServeCommand(rootCommand);
-        RegisterWatchCommand(rootCommand, cancellationToken);
+        RegisterWatchCommand(rootCommand);

        RegisterNewCommand(rootCommand);
        RegisterUpdateCommand(rootCommand);
@@ -33,6 +34,10 @@ public class YaeCommandService(
        RegisterPublishCommand(rootCommand);
        RegisterCompressCommand(rootCommand);

+        // Shit code: wait for the application starting.
+        // If the command service finished early before the application starting, there will be an ugly exception.
+        await Task.Delay(500, stoppingToken);
+        logger.LogInformation("Running YaeBlog Command.");
        int exitCode = await rootCommand.InvokeAsync(arguments);

        if (exitCode != 0)
@@ -40,13 +45,14 @@ public class YaeCommandService(
            throw new BlogCommandException($"YaeBlog command exited with no-zero code {exitCode}");
        }

-        if (_oneShotCommandFlag)
-        {
-            applicationLifetime.StopApplication();
-        }
-    }
+        consoleInfoService.IsOneShotCommand = _oneShotCommandFlag;

-    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+        if (!consoleInfoService.IsOneShotCommand)
+        {
+            logger.LogInformation("Start YaeBlog command: {}", consoleInfoService.Command);
+        }
+        hostApplicationLifetime.StopApplication();
+    }

    private void RegisterServeCommand(RootCommand rootCommand)
    {
@@ -59,27 +65,23 @@ public class YaeCommandService(
        rootCommand.SetHandler(HandleServeCommand);
    }

-    private async Task HandleServeCommand(InvocationContext context)
+    private Task HandleServeCommand(InvocationContext context)
    {
        _oneShotCommandFlag = false;
+        consoleInfoService.Command = ServerCommand.Serve;

-        logger.LogInformation("Failed to load cache, re-render essays.");
-        RendererService rendererService = serviceProvider.GetRequiredService<RendererService>();
-        await rendererService.RenderAsync();
+        return Task.CompletedTask;
    }

-    private void RegisterWatchCommand(RootCommand rootCommand, CancellationToken cancellationToken)
+    private void RegisterWatchCommand(RootCommand rootCommand)
    {
        Command command = new("watch", "Start a blog watcher that re-render when file changes.");
        rootCommand.AddCommand(command);

-        command.SetHandler(async _ =>
+        command.SetHandler(_ =>
        {
            _oneShotCommandFlag = false;
-
-            // BlogHotReloadService is derived from BackgroundService, but we do not let framework trigger it.
-            BlogHotReloadService blogHotReloadService = serviceProvider.GetRequiredService<BlogHotReloadService>();
-            await blogHotReloadService.StartAsync(cancellationToken);
+            consoleInfoService.Command = ServerCommand.Watch;
        });
    }

@@ -270,12 +272,6 @@ public class YaeCommandService(
            getDefaultValue: () => false);
        command.AddOption(dryRunOption);

-        command.SetHandler(HandleCompressCommand, dryRunOption);
-    }
-
-    private async Task HandleCompressCommand(bool dryRun)
-    {
-        ImageCompressService imageCompressService = serviceProvider.GetRequiredService<ImageCompressService>();
-        await imageCompressService.Compress(dryRun);
+        command.SetHandler(async dryRun => { await imageCompressService.Compress(dryRun); }, dryRunOption);
    }
 }
--- a/src/YaeBlog/YaeBlog.csproj
+++ b/src/YaeBlog/YaeBlog.csproj
@@ -13,6 +13,7 @@

  <ItemGroup>
    <ProjectReference Include="../../third-party/BlazorSvgComponents/src/BlazorSvgComponents/BlazorSvgComponents.csproj" />
+    <ProjectReference Include="..\YaeBlog.Abstractions\YaeBlog.Abstractions.csproj" />
  </ItemGroup>

  <ItemGroup>
--- a/src/YaeBlog/appsettings.json
+++ b/src/YaeBlog/appsettings.json
@@ -38,7 +38,6 @@
  },
  "Gitea": {
    "BaseAddress": "https://git.rrricardo.top/api/v1/",
-    "ApiKey": "7e33617e5d084199332fceec3e0cb04c6ddced55",
    "HeatMapUsername": "jackfiled"
  }
 }
Author	SHA1	Message	Date
jackfiled	3f1711e789	blog: publish 2025-final All checks were successful Build blog docker image / Build-Blog-Image (push) Successful in 3m38s Details	2026-05-08 01:23:40 +08:00
jackfiled	455b716b15	blog: 2025-final (#23 ) All checks were successful Build blog docker image / Build-Blog-Image (push) Successful in 5m28s Details Reviewed-on: #23	2026-05-07 02:04:01 +00:00
jackfiled	0c0e721e8f	feat: update system-text-json All checks were successful Build blog docker image / Build-Blog-Image (push) Successful in 1m4s Details Signed-off-by: jackfiled <xcrenchangjun@outlook.com>	2026-04-03 17:16:52 +08:00
jackfiled	dfb66b4301	refact: introduce YaeBlog.Abstractions layer. All checks were successful Build blog docker image / Build-Blog-Image (push) Successful in 1m0s Details Signed-off-by: jackfiled <xcrenchangjun@outlook.com>	2026-03-29 16:14:47 +08:00
jackfiled	05f99f4b79	feat: Use seperate application to parse and run command line. Signed-off-by: jackfiled <xcrenchangjun@outlook.com>	2026-03-29 16:10:59 +08:00
jackfiled	5fef951d36	feat: publish blog tarjan-bridge. All checks were successful Build blog docker image / Build-Blog-Image (push) Successful in 1m20s Details Signed-off-by: jackfiled <xcrenchangjun@outlook.com>	2026-03-28 21:59:54 +08:00
jackfiled	c9f6d638b9	fix: set gitea api key header correctly. All checks were successful Build blog docker image / Build-Blog-Image (push) Successful in 1m4s Details Rename Foonter to Footer. Fix the heatmap not rendering until today bug. Signed-off-by: jackfiled <xcrenchangjun@outlook.com>	2026-03-18 16:33:16 +08:00