refact: introduce YaeBlog.Abstractions layer.

Signed-off-by: jackfiled <xcrenchangjun@outlook.com>

.gitea/workflows/build.yaml

@@ -8,19 +8,19 @@ jobs:
     runs-on: archlinux
     steps:
       - name: Check out code.
-        uses: https://mirrors.rrricardo.top/actions/checkout.git@v4
+        uses: http://github-mirrors.infra.svc.cluster.local/actions/checkout.git@v4
         with:
           lfs: true
       - name: Build project.
         run: |
+          git submodule update --init
           podman pull mcr.azure.cn/dotnet/aspnet:10.0
-          cd YaeBlog
           pwsh build.ps1 build
       - name: Workaround to make sure podman-login working.
         run: |
-          mkdir /root/.docker
+          mkdir -p /root/.docker
       - name: Login tencent cloud docker registry.
-        uses: https://mirrors.rrricardo.top/actions/podman-login.git@v1
+        uses: http://github-mirrors.infra.svc.cluster.local/actions/podman-login.git@v1
         with:
           registry: ccr.ccs.tencentyun.com
           username: 100044380877

.gitignore

@@ -184,6 +184,7 @@ DocProject/Help/html
 
 # Click-Once directory
 publish/
+out/
 
 # Publish Web Output
 *.[Pp]ublish.xml

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>

build.ps1

@@ -3,16 +3,15 @@
 [cmdletbinding()]
 param(
     [Parameter(Mandatory = $true, Position = 0, HelpMessage = "Specify the build target")]
-    [ValidateSet("tailwind", "publish", "compress", "build", "dev", "new", "watch", "serve", "list")]
+    [ValidateSet("publish", "compress", "build", "dev", "new", "watch", "serve")]
     [string]$Target,
-    [string]$Output = "wwwroot",
     [string]$Essay,
     [switch]$Compress,
     [string]$Root = "source"
 )
 
 begin {
-    if ($Target -eq "tailwind")
+    if (($Target -eq "tailwind") -or ($Target -eq "build"))
     {
         # Handle tailwind specially.
         return
@@ -82,8 +81,11 @@ process {
     function Build-Image
     {
         $commitId = git rev-parse --short=10 HEAD
-        dotnet publish
-        podman build . -t ccr.ccs.tencentyun.com/jackfiled/blog --build-arg COMMIT_ID=$commitId
+        dotnet publish ./src/YaeBlog/YaeBlog.csproj -o out
+        Write-Host "Succeed to build blog appliocation."
+        podman build . -t ccr.ccs.tencentyun.com/jackfiled/blog --build-arg COMMIT_ID=$commitId `
+            -f ./src/YaeBlog/Dockerfile
+        Write-Host "Succeed to build ccr.ccs.tencentyun.com/jackfiled/blog image."
     }
 
     function Start-Develop {
@@ -111,11 +113,6 @@ process {
 
     switch ($Target)
     {
-        "tailwind" {
-            Write-Host "Build tailwind css into $Output."
-            pnpm tailwindcss -i wwwroot/tailwind.css -o $Output/tailwind.g.css
-            break
-        }
         "publish" {
             Write-Host "Publish essay $Essay..."
             dotnet run -- publish $Essay
@@ -149,10 +146,6 @@ process {
             dotnet run -- serve
             break
         }
-        "list" {
-            dotnet run -- list
-            break
-        }
     }
 }
 

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`就是这条边的反向边。

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
 {

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
 {

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
 {

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
 {

src/YaeBlog.Abstractions/Models/BlogContent.cs

@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;
 
 /// <summary>
 /// 单个博客文件的所有数据和元数据

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>

src/YaeBlog.Abstractions/Models/BlogEssay.cs

@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;
 
 public record BlogEssay(
     string Title,

src/YaeBlog.Abstractions/Models/BlogHeadline.cs

@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;
 
 public class BlogHeadline(string title, string selectorId)
 {

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>

src/YaeBlog.Abstractions/Models/BlogOptions.cs

@@ -1,6 +1,6 @@
 using System.ComponentModel.DataAnnotations;
 
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;
 
 /// <summary>
 /// 友链模型类

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>
 {

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; }
 }

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);

src/YaeBlog.Abstractions/Models/MarkdownMetadata.cs

@@ -1,4 +1,4 @@
-namespace YaeBlog.Models;
+namespace YaeBlog.Abstractions.Models;
 
 public class MarkdownMetadata
 {

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>

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]

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;
 

src/YaeBlog/Commands/Binders/BlogOptionsBinder.cs

@@ -1,33 +0,0 @@
-using System.CommandLine.Binding;
-using System.Text.Json;
-using Microsoft.Extensions.Options;
-using YaeBlog.Models;
-
-namespace YaeBlog.Commands.Binders;
-
-public sealed class BlogOptionsBinder : BinderBase<IOptions<BlogOptions>>
-{
-    protected override IOptions<BlogOptions> GetBoundValue(BindingContext bindingContext)
-    {
-        bindingContext.AddService<IOptions<BlogOptions>>(_ =>
-        {
-            FileInfo settings = new(Path.Combine(Environment.CurrentDirectory, "appsettings.json"));
-            if (!settings.Exists)
-            {
-                throw new InvalidOperationException("Failed to load YaeBlog configurations.");
-            }
-
-            using StreamReader reader = settings.OpenText();
-            using JsonDocument document = JsonDocument.Parse(reader.ReadToEnd());
-            JsonElement root = document.RootElement;
-            JsonElement optionSection = root.GetProperty(BlogOptions.OptionName);
-
-            BlogOptions? result = optionSection.Deserialize<BlogOptions>();
-            return result is null
-                ? throw new InvalidOperationException("Failed to load YaeBlog configuration in appsettings.json.")
-                : new OptionsWrapper<BlogOptions>(result);
-        });
-
-        return bindingContext.GetRequiredService<IOptions<BlogOptions>>();
-    }
-}

src/YaeBlog/Commands/Binders/EssayScanServiceBinder.cs

@@ -1,32 +0,0 @@
-using System.CommandLine.Binding;
-using Microsoft.Extensions.Options;
-using YaeBlog.Abstraction;
-using YaeBlog.Models;
-using YaeBlog.Services;
-using YamlDotNet.Serialization;
-using YamlDotNet.Serialization.NamingConventions;
-
-namespace YaeBlog.Commands.Binders;
-
-public sealed class EssayScanServiceBinder : BinderBase<IEssayScanService>
-{
-    protected override IEssayScanService GetBoundValue(BindingContext bindingContext)
-    {
-        bindingContext.AddService<IEssayScanService>(provider =>
-        {
-            DeserializerBuilder deserializerBuilder = new();
-            deserializerBuilder.WithNamingConvention(CamelCaseNamingConvention.Instance);
-            deserializerBuilder.IgnoreUnmatchedProperties();
-
-            SerializerBuilder serializerBuilder = new();
-            serializerBuilder.WithNamingConvention(CamelCaseNamingConvention.Instance);
-
-            IOptions<BlogOptions> options = provider.GetRequiredService<IOptions<BlogOptions>>();
-            ILogger<EssayScanService> logger = provider.GetRequiredService<ILogger<EssayScanService>>();
-
-            return new EssayScanService(serializerBuilder.Build(), deserializerBuilder.Build(), options, logger);
-        });
-
-        return bindingContext.GetRequiredService<IEssayScanService>();
-    }
-}

src/YaeBlog/Commands/Binders/ImageCompressServiceBinder.cs

@@ -1,21 +0,0 @@
-using System.CommandLine.Binding;
-using YaeBlog.Abstraction;
-using YaeBlog.Services;
-
-namespace YaeBlog.Commands.Binders;
-
-public sealed class ImageCompressServiceBinder : BinderBase<ImageCompressService>
-{
-    protected override ImageCompressService GetBoundValue(BindingContext bindingContext)
-    {
-        bindingContext.AddService(provider =>
-        {
-            IEssayScanService essayScanService = provider.GetRequiredService<IEssayScanService>();
-            ILogger<ImageCompressService> logger = provider.GetRequiredService<ILogger<ImageCompressService>>();
-
-            return new ImageCompressService(essayScanService, logger);
-        });
-
-        return bindingContext.GetRequiredService<ImageCompressService>();
-    }
-}

src/YaeBlog/Commands/Binders/LoggerBinder.cs

@@ -1,18 +0,0 @@
-using System.CommandLine.Binding;
-
-namespace YaeBlog.Commands.Binders;
-
-public sealed class LoggerBinder<T> : BinderBase<ILogger<T>>
-{
-    protected override ILogger<T> GetBoundValue(BindingContext bindingContext)
-    {
-        bindingContext.AddService(_ => LoggerFactory.Create(builder => builder.AddConsole()));
-        bindingContext.AddService<ILogger<T>>(provider =>
-        {
-            ILoggerFactory factory = provider.GetRequiredService<ILoggerFactory>();
-            return factory.CreateLogger<T>();
-        });
-
-        return bindingContext.GetRequiredService<ILogger<T>>();
-    }
-}

src/YaeBlog/Commands/YaeBlogCommand.cs

@@ -1,296 +0,0 @@
-using System.CommandLine;
-using Microsoft.Extensions.Options;
-using YaeBlog.Abstraction;
-using YaeBlog.Commands.Binders;
-using YaeBlog.Components;
-using YaeBlog.Extensions;
-using YaeBlog.Models;
-using YaeBlog.Services;
-
-namespace YaeBlog.Commands;
-
-public sealed class YaeBlogCommand
-{
-    private readonly RootCommand _rootCommand = new("YaeBlog Cli");
-
-    public YaeBlogCommand()
-    {
-        AddServeCommand(_rootCommand);
-        AddWatchCommand(_rootCommand);
-        AddListCommand(_rootCommand);
-        AddNewCommand(_rootCommand);
-        AddUpdateCommand(_rootCommand);
-        AddPublishCommand(_rootCommand);
-        AddScanCommand(_rootCommand);
-        AddCompressCommand(_rootCommand);
-    }
-
-    public Task<int> RunAsync(string[] args)
-    {
-        return _rootCommand.InvokeAsync(args);
-    }
-
-    private static void AddServeCommand(RootCommand rootCommand)
-    {
-        Command serveCommand = new("serve", "Start http server.");
-        rootCommand.AddCommand(serveCommand);
-
-        serveCommand.SetHandler(async context =>
-        {
-            WebApplicationBuilder builder = WebApplication.CreateBuilder();
-
-            builder.Services.AddRazorComponents()
-                .AddInteractiveServerComponents();
-            builder.Services.AddControllers();
-            builder.AddYaeBlog();
-            builder.AddServer();
-
-            WebApplication application = builder.Build();
-
-            application.MapStaticAssets();
-            application.UseAntiforgery();
-            application.UseYaeBlog();
-
-            application.MapRazorComponents<App>()
-                .AddInteractiveServerRenderMode();
-            application.MapControllers();
-
-            CancellationToken token = context.GetCancellationToken();
-            await application.RunAsync(token);
-        });
-    }
-
-    private static void AddWatchCommand(RootCommand rootCommand)
-    {
-        Command command = new("watch", "Start a blog watcher that re-render when file changes.");
-        rootCommand.AddCommand(command);
-
-        command.SetHandler(async context =>
-        {
-            WebApplicationBuilder builder = WebApplication.CreateBuilder();
-
-            builder.Services.AddRazorComponents()
-                .AddInteractiveServerComponents();
-            builder.Services.AddControllers();
-            builder.AddYaeBlog();
-            builder.AddWatcher();
-
-            WebApplication application = builder.Build();
-
-            application.MapStaticAssets();
-            application.UseAntiforgery();
-            application.UseYaeBlog();
-
-            application.MapRazorComponents<App>()
-                .AddInteractiveServerRenderMode();
-            application.MapControllers();
-
-            CancellationToken token = context.GetCancellationToken();
-            await application.RunAsync(token);
-        });
-    }
-
-    private static void AddNewCommand(RootCommand rootCommand)
-    {
-        Command newCommand = new("new", "Create a new blog file and image directory.");
-        rootCommand.AddCommand(newCommand);
-
-        Argument<string> filenameArgument = new(name: "blog name", description: "The created blog filename.");
-        newCommand.AddArgument(filenameArgument);
-
-        newCommand.SetHandler(async (file, blogOption, _, essayScanService) =>
-            {
-                BlogContents contents = await essayScanService.ScanContents();
-
-                if (contents.Posts.Any(content => content.BlogName == file))
-                {
-                    Console.WriteLine("There exists the same title blog in posts.");
-                    return;
-                }
-
-                await essayScanService.SaveBlogContent(new BlogContent(
-                    new FileInfo(Path.Combine(blogOption.Value.Root, "drafts", file + ".md")),
-                    new MarkdownMetadata
-                    {
-                        Title = file,
-                        Date = DateTimeOffset.Now.ToString("o"),
-                        UpdateTime = DateTimeOffset.Now.ToString("o")
-                    },
-                    string.Empty, true, [], []));
-
-                Console.WriteLine($"Created new blog '{file}.");
-            }, filenameArgument, new BlogOptionsBinder(), new LoggerBinder<EssayScanService>(),
-            new EssayScanServiceBinder());
-    }
-
-    private static void AddUpdateCommand(RootCommand rootCommand)
-    {
-        Command newCommand = new("update", "Update the blog essay.");
-        rootCommand.AddCommand(newCommand);
-
-        Argument<string> filenameArgument = new(name: "blog name", description: "The blog filename to update.");
-        newCommand.AddArgument(filenameArgument);
-
-        newCommand.SetHandler(async (file, _, _, essayScanService) =>
-            {
-                Console.WriteLine("HINT: The update command only consider published blogs.");
-                BlogContents contents = await essayScanService.ScanContents();
-
-                BlogContent? content = contents.Posts.FirstOrDefault(c => c.BlogName == file);
-                if (content is null)
-                {
-                    Console.WriteLine($"Target essay {file} is not exist.");
-                    return;
-                }
-
-                content.Metadata.UpdateTime = DateTimeOffset.Now.ToString("o");
-                await essayScanService.SaveBlogContent(content, content.IsDraft);
-            }, filenameArgument,
-            new BlogOptionsBinder(), new LoggerBinder<EssayScanService>(), new EssayScanServiceBinder());
-    }
-
-    private static void AddListCommand(RootCommand rootCommand)
-    {
-        Command command = new("list", "List all blogs");
-        rootCommand.AddCommand(command);
-
-        command.SetHandler(async (_, _, essyScanService) =>
-        {
-            BlogContents contents = await essyScanService.ScanContents();
-
-            Console.WriteLine($"All {contents.Posts.Count} Posts:");
-            foreach (BlogContent content in contents.Posts.OrderBy(x => x.BlogName))
-            {
-                Console.WriteLine($" - {content.BlogName}");
-            }
-
-            Console.WriteLine($"All {contents.Drafts.Count} Drafts:");
-            foreach (BlogContent content in contents.Drafts.OrderBy(x => x.BlogName))
-            {
-                Console.WriteLine($" - {content.BlogName}");
-            }
-        }, new BlogOptionsBinder(), new LoggerBinder<EssayScanService>(), new EssayScanServiceBinder());
-    }
-
-    private static void AddScanCommand(RootCommand rootCommand)
-    {
-        Command command = new("scan", "Scan unused and not found images.");
-        rootCommand.AddCommand(command);
-
-        Option<bool> removeOption =
-            new(name: "--rm", description: "Remove unused images.", getDefaultValue: () => false);
-        command.AddOption(removeOption);
-
-        command.SetHandler(async (_, _, essayScanService, removeOptionValue) =>
-        {
-            BlogContents contents = await essayScanService.ScanContents();
-            List<BlogImageInfo> unusedImages = (from content in contents
-                from image in content.Images
-                where image is { IsUsed: false }
-                select image).ToList();
-
-            if (unusedImages.Count != 0)
-            {
-                Console.WriteLine("Found unused images:");
-                Console.WriteLine("HINT: use '--rm' to remove unused images.");
-            }
-
-            foreach (BlogImageInfo image in unusedImages)
-            {
-                Console.WriteLine($" - {image.File.FullName}");
-            }
-
-            if (removeOptionValue)
-            {
-                foreach (BlogImageInfo image in unusedImages)
-                {
-                    image.File.Delete();
-                }
-            }
-
-            Console.WriteLine("Used not existed images:");
-
-            foreach (BlogContent content in contents)
-            {
-                foreach (FileInfo file in content.NotfoundImages)
-                {
-                    Console.WriteLine($"- {file.Name} in {content.BlogName}");
-                }
-            }
-        }, new BlogOptionsBinder(), new LoggerBinder<EssayScanService>(), new EssayScanServiceBinder(), removeOption);
-    }
-
-    private static void AddPublishCommand(RootCommand rootCommand)
-    {
-        Command command = new("publish", "Publish a new blog file.");
-        rootCommand.AddCommand(command);
-
-        Argument<string> filenameArgument = new(name: "blog name", description: "The published blog filename.");
-        command.AddArgument(filenameArgument);
-
-        command.SetHandler(async (blogOptions, _, essayScanService, filename) =>
-            {
-                BlogContents contents = await essayScanService.ScanContents();
-
-                BlogContent? content = (from blog in contents.Drafts
-                    where blog.BlogName == filename
-                    select blog).FirstOrDefault();
-
-                if (content is null)
-                {
-                    Console.WriteLine("Target blog does not exist.");
-                    return;
-                }
-
-                // 设置发布的时间
-                content.Metadata.Date = DateTimeOffset.Now.ToString("o");
-                content.Metadata.UpdateTime = DateTimeOffset.Now.ToString("o");
-
-                // 将选中的博客文件复制到posts
-                await essayScanService.SaveBlogContent(content, isDraft: false);
-
-                // 复制图片文件夹
-                DirectoryInfo sourceImageDirectory =
-                    new(Path.Combine(blogOptions.Value.Root, "drafts", content.BlogName));
-                DirectoryInfo targetImageDirectory =
-                    new(Path.Combine(blogOptions.Value.Root, "posts", content.BlogName));
-
-                if (sourceImageDirectory.Exists)
-                {
-                    targetImageDirectory.Create();
-                    foreach (FileInfo file in sourceImageDirectory.EnumerateFiles())
-                    {
-                        file.CopyTo(Path.Combine(targetImageDirectory.FullName, file.Name), true);
-                    }
-
-                    sourceImageDirectory.Delete(true);
-                }
-
-                // 删除原始的文件
-                FileInfo sourceBlogFile = new(Path.Combine(blogOptions.Value.Root, "drafts", content.BlogName + ".md"));
-                sourceBlogFile.Delete();
-            }, new BlogOptionsBinder(),
-            new LoggerBinder<EssayScanService>(), new EssayScanServiceBinder(), filenameArgument);
-    }
-
-    private static void AddCompressCommand(RootCommand rootCommand)
-    {
-        Command command = new("compress", "Compress png/jpeg image to webp image to reduce size.");
-        rootCommand.Add(command);
-
-        Option<bool> dryRunOption = new("--dry-run", description: "Dry run the compression task but not write.",
-            getDefaultValue: () => false);
-        command.AddOption(dryRunOption);
-
-        command.SetHandler(ImageCommandHandler,
-            new BlogOptionsBinder(), new LoggerBinder<EssayScanService>(), new LoggerBinder<ImageCompressService>(),
-            new EssayScanServiceBinder(), new ImageCompressServiceBinder(), dryRunOption);
-    }
-
-    private static async Task ImageCommandHandler(IOptions<BlogOptions> _, ILogger<EssayScanService> _1,
-        ILogger<ImageCompressService> _2,
-        IEssayScanService _3, ImageCompressService imageCompressService, bool dryRun)
-    {
-        await imageCompressService.Compress(dryRun);
-    }
-}

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

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">

src/YaeBlog/Components/Footer.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}";
 }

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"
         };
     }
-
 }

src/YaeBlog/Components/Layout/BlogLayout.razor

@@ -24,5 +24,5 @@
         @Body
     </div>
 
-    <Foonter/>
+    <Footer/>
 </main>

src/YaeBlog/Components/Layout/MainLayout.razor

@@ -32,5 +32,5 @@
         </div>
     </div>
 
-    <Foonter/>
+    <Footer/>
 </main>

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">

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">

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)

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">

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>

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="">

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 {

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>

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>

src/YaeBlog/Dockerfile

@@ -4,8 +4,10 @@ ARG COMMIT_ID
 ENV COMMIT_ID=${COMMIT_ID}
 
 WORKDIR /app
-COPY bin/Release/net10.0/publish/ ./
+COPY out/ ./
 COPY source/ ./source/
-COPY appsettings.json .
+COPY src/YaeBlog/appsettings.json .
+
+ENV BLOG__ROOT="./source"
 
 ENTRYPOINT ["dotnet", "YaeBlog.dll", "serve"]

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
+                };
+            }
+        }
     }
 }

src/YaeBlog/Extensions/HostApplicationBuilderExtensions.cs

@@ -0,0 +1,87 @@
+using AngleSharp;
+using Microsoft.Extensions.Options;
+using YaeBlog.Abstractions;
+using YaeBlog.Services;
+using YaeBlog.Abstractions.Models;
+using YaeBlog.Processors;
+
+namespace YaeBlog.Extensions;
+
+public static class HostApplicationBuilderExtensions
+{
+    extension(IHostApplicationBuilder builder)
+    {
+        public ConsoleInfoService AddYaeCommand(string[] arguments)
+        {
+            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>()
+                .AddTransient<ImagePostRenderProcessor>()
+                .AddTransient<HeadlinePostRenderProcessor>()
+                .AddTransient<EssayStylesPostRenderProcessor>()
+                .AddTransient<GiteaFetchService>()
+                .AddTransient<BlogChangeWatcher>()
+                .AddTransient<BlogHotReloadService>()
+                .AddSingleton<GitHeapMapService>();
+
+            builder.Services.AddHostedService<StartServerService>();
+
+            return builder;
+        }
+    }
+}

src/YaeBlog/Extensions/WebApplicationBuilderExtensions.cs

@@ -1,59 +0,0 @@
-using AngleSharp;
-using YaeBlog.Abstraction;
-using YaeBlog.Services;
-using YaeBlog.Models;
-using YaeBlog.Processors;
-
-namespace YaeBlog.Extensions;
-
-public static class WebApplicationBuilderExtensions
-{
-    extension(WebApplicationBuilder builder)
-    {
-        public WebApplicationBuilder AddYaeBlog()
-        {
-            builder.ConfigureOptions<BlogOptions>(BlogOptions.OptionName)
-                .ConfigureOptions<GiteaOptions>(GiteaOptions.OptionName);
-
-            builder.Services.AddHttpClient()
-                .AddMarkdig()
-                .AddYamlParser();
-
-            builder.Services.AddSingleton<AngleSharp.IConfiguration>(_ => Configuration.Default)
-                .AddSingleton<IEssayScanService, EssayScanService>()
-                .AddSingleton<RendererService>()
-                .AddSingleton<IEssayContentService, EssayContentService>()
-                .AddTransient<ImagePostRenderProcessor>()
-                .AddTransient<HeadlinePostRenderProcessor>()
-                .AddTransient<EssayStylesPostRenderProcessor>()
-                .AddTransient<GiteaFetchService>()
-                .AddSingleton<GitHeapMapService>();
-
-            return builder;
-        }
-
-        public WebApplicationBuilder AddServer()
-        {
-            builder.Services.AddHostedService<BlogHostedService>();
-
-            return builder;
-        }
-
-        public WebApplicationBuilder AddWatcher()
-        {
-            builder.Services.AddTransient<BlogChangeWatcher>();
-            builder.Services.AddHostedService<BlogHotReloadService>();
-
-            return builder;
-        }
-
-        private WebApplicationBuilder ConfigureOptions<T>(string optionSectionName) where T : class
-        {
-            builder.Services
-                .AddOptions<T>()
-                .Bind(builder.Configuration.GetSection(optionSectionName))
-                .ValidateDataAnnotations();
-            return builder;
-        }
-    }
-}

src/YaeBlog/Extensions/WebApplicationExtensions.cs

@@ -1,4 +1,4 @@
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 using YaeBlog.Processors;
 using YaeBlog.Services;
 

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;
 

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;
 

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;
 

src/YaeBlog/Program.cs

@@ -1,4 +1,34 @@
-using YaeBlog.Commands;
+using YaeBlog.Components;
+using YaeBlog.Extensions;
+using YaeBlog.Services;
 
-YaeBlogCommand command = new();
-await command.RunAsync(args);
+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.AddYaeServer(consoleInfoService);
+
+WebApplication application = builder.Build();
+
+application.MapStaticAssets();
+application.UseAntiforgery();
+application.UseYaeBlog();
+
+application.MapRazorComponents<App>()
+    .AddInteractiveServerRenderMode();
+application.MapControllers();
+
+await application.RunAsync();

src/YaeBlog/Services/BlogChangeWatcher.cs

@@ -1,5 +1,5 @@
 using Microsoft.Extensions.Options;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;
 
 namespace YaeBlog.Services;
 

src/YaeBlog/Services/BlogHotReloadService.cs

@@ -1,4 +1,4 @@
-using YaeBlog.Abstraction;
+using YaeBlog.Abstractions;
 
 namespace YaeBlog.Services;
 

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; }
+}

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;
 

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;
 

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;

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());

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));

src/YaeBlog/Services/MarkdownWordCounter.cs

@@ -1,5 +1,5 @@
 using YaeBlog.Extensions;
-using YaeBlog.Models;
+using YaeBlog.Abstractions.Models;
 
 namespace YaeBlog.Services
 {

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;
 

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;
+}

src/YaeBlog/Services/YaeCommandService.cs

@@ -0,0 +1,277 @@
+using System.CommandLine;
+using System.CommandLine.Invocation;
+using System.Text;
+using Microsoft.Extensions.Options;
+using YaeBlog.Abstractions;
+using YaeBlog.Core.Exceptions;
+using YaeBlog.Abstractions.Models;
+
+namespace YaeBlog.Services;
+
+public sealed class YaeCommandService(
+    string[] arguments,
+    IEssayScanService essayScanService,
+    ImageCompressService imageCompressService,
+    ConsoleInfoService consoleInfoService,
+    IHostApplicationLifetime hostApplicationLifetime,
+    IOptions<BlogOptions> blogOptions,
+    ILogger<YaeCommandService> logger)
+    : BackgroundService
+{
+    private readonly BlogOptions _blogOptions = blogOptions.Value;
+    private bool _oneShotCommandFlag = true;
+
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        RootCommand rootCommand = new("YaeBlog CLI");
+
+        RegisterServeCommand(rootCommand);
+        RegisterWatchCommand(rootCommand);
+
+        RegisterNewCommand(rootCommand);
+        RegisterUpdateCommand(rootCommand);
+        RegisterScanCommand(rootCommand);
+        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)
+        {
+            throw new BlogCommandException($"YaeBlog command exited with no-zero code {exitCode}");
+        }
+
+        consoleInfoService.IsOneShotCommand = _oneShotCommandFlag;
+
+        if (!consoleInfoService.IsOneShotCommand)
+        {
+            logger.LogInformation("Start YaeBlog command: {}", consoleInfoService.Command);
+        }
+        hostApplicationLifetime.StopApplication();
+    }
+
+    private void RegisterServeCommand(RootCommand rootCommand)
+    {
+        Command command = new("serve", "Start http server.");
+        rootCommand.AddCommand(command);
+
+        command.SetHandler(HandleServeCommand);
+
+        // When invoking the root command without sub command, fallback to serve command.
+        rootCommand.SetHandler(HandleServeCommand);
+    }
+
+    private Task HandleServeCommand(InvocationContext context)
+    {
+        _oneShotCommandFlag = false;
+        consoleInfoService.Command = ServerCommand.Serve;
+
+        return Task.CompletedTask;
+    }
+
+    private void RegisterWatchCommand(RootCommand rootCommand)
+    {
+        Command command = new("watch", "Start a blog watcher that re-render when file changes.");
+        rootCommand.AddCommand(command);
+
+        command.SetHandler(_ =>
+        {
+            _oneShotCommandFlag = false;
+            consoleInfoService.Command = ServerCommand.Watch;
+        });
+    }
+
+    private void RegisterNewCommand(RootCommand rootCommand)
+    {
+        Command command = new("new", "Create a new blog file and image directory.");
+        rootCommand.AddCommand(command);
+
+        Argument<string> filenameArgument = new(name: "blog name", description: "The created blog filename.");
+        command.AddArgument(filenameArgument);
+
+        command.SetHandler(HandleNewCommand, filenameArgument);
+    }
+
+    private async Task HandleNewCommand(string filename)
+    {
+        BlogContents contents = await essayScanService.ScanContents();
+
+        if (contents.Posts.Any(content => content.BlogName == filename))
+        {
+            throw new BlogCommandException("There exits the same title blog in posts.");
+        }
+
+        await essayScanService.SaveBlogContent(new BlogContent(
+            new FileInfo(Path.Combine(_blogOptions.Root, "drafts", filename + ".md")),
+            new MarkdownMetadata
+            {
+                Title = filename,
+                Date = DateTimeOffset.Now.ToString("o"),
+                UpdateTime = DateTimeOffset.Now.ToString("o")
+            },
+            string.Empty, true, [], []
+        ));
+
+        logger.LogInformation("Create new blog '{}'", filename);
+    }
+
+    private void RegisterUpdateCommand(RootCommand rootCommand)
+    {
+        Command command = new("update", "Update the blog essay.");
+        rootCommand.AddCommand(command);
+
+        Argument<string> filenameArgument = new(name: "blog name", description: "The blog filename to update.");
+        command.AddArgument(filenameArgument);
+
+        command.SetHandler(HandleUpdateCommand, filenameArgument);
+    }
+
+    private async Task HandleUpdateCommand(string filename)
+    {
+        logger.LogInformation("The update command only considers published blogs.");
+        BlogContents contents = await essayScanService.ScanContents();
+
+        BlogContent? content = contents.Posts.FirstOrDefault(c => c.BlogName == filename);
+        if (content is null)
+        {
+            throw new BlogCommandException($"Target essay {filename} is not exist.");
+        }
+
+        content.Metadata.UpdateTime = DateTimeOffset.Now.ToString("o");
+        await essayScanService.SaveBlogContent(content, content.IsDraft);
+        logger.LogInformation("Update time of essay '{}' updated.", content.BlogName);
+    }
+
+    private void RegisterScanCommand(RootCommand rootCommand)
+    {
+        Command command = new("scan", "Scan unused and not found images.");
+        rootCommand.AddCommand(command);
+
+        Option<bool> removeOption =
+            new(name: "--rm", description: "Remove unused images.", getDefaultValue: () => false);
+        command.AddOption(removeOption);
+
+        command.SetHandler(HandleScanCommand, removeOption);
+    }
+
+    private async Task HandleScanCommand(bool removeUnusedImages)
+    {
+        BlogContents contents = await essayScanService.ScanContents();
+        List<BlogImageInfo> unusedImages = (from content in contents
+            from image in content.Images
+            where image is { IsUsed: false }
+            select image).ToList();
+
+        if (unusedImages.Count != 0)
+        {
+            StringBuilder builder = new();
+            builder.Append("Found unused images:").Append('\n');
+
+            foreach (BlogImageInfo image in unusedImages)
+            {
+                builder.Append('\t').Append("- ").Append(image.File.FullName).Append('\n');
+            }
+
+            logger.LogInformation("{}", builder.ToString());
+            logger.LogInformation("HINT: use '--rm' to remove unused images.");
+        }
+
+        if (removeUnusedImages)
+        {
+            foreach (BlogImageInfo image in unusedImages)
+            {
+                image.File.Delete();
+            }
+        }
+
+        StringBuilder infoBuilder = new();
+        infoBuilder.Append("Used not existed images:\n");
+
+        bool flag = false;
+        foreach (BlogContent content in contents)
+        {
+            foreach (FileInfo file in content.NotfoundImages)
+            {
+                flag = true;
+                infoBuilder.Append('\t').Append("- ").Append(file.Name).Append(" in ").Append(content.BlogName)
+                    .Append('\n');
+            }
+        }
+
+        if (flag)
+        {
+            logger.LogInformation("{}", infoBuilder.ToString());
+        }
+    }
+
+    private void RegisterPublishCommand(RootCommand rootCommand)
+    {
+        Command command = new("publish", "Publish a new blog file.");
+        rootCommand.AddCommand(command);
+
+        Argument<string> filenameArgument = new(name: "blog name", description: "The published blog filename.");
+        command.AddArgument(filenameArgument);
+
+        command.SetHandler(HandlePublishCommand, filenameArgument);
+    }
+
+    private async Task HandlePublishCommand(string filename)
+    {
+        BlogContents contents = await essayScanService.ScanContents();
+
+        BlogContent? content = (from blog in contents.Drafts
+            where blog.BlogName == filename
+            select blog).FirstOrDefault();
+
+        if (content is null)
+        {
+            throw new BlogCommandException("Target blog doest not exist.");
+        }
+
+        logger.LogInformation("Publish blog {}", content.BlogName);
+
+        // 设置发布的时间
+        content.Metadata.Date = DateTimeOffset.Now.ToString("o");
+        content.Metadata.UpdateTime = DateTimeOffset.Now.ToString("o");
+
+        // 将选中的博客文件复制到posts
+        await essayScanService.SaveBlogContent(content, isDraft: false);
+
+        // 复制图片文件夹
+        DirectoryInfo sourceImageDirectory =
+            new(Path.Combine(blogOptions.Value.Root, "drafts", content.BlogName));
+        DirectoryInfo targetImageDirectory =
+            new(Path.Combine(blogOptions.Value.Root, "posts", content.BlogName));
+
+        if (sourceImageDirectory.Exists)
+        {
+            targetImageDirectory.Create();
+            foreach (FileInfo file in sourceImageDirectory.EnumerateFiles())
+            {
+                file.CopyTo(Path.Combine(targetImageDirectory.FullName, file.Name), true);
+            }
+
+            sourceImageDirectory.Delete(true);
+        }
+
+        // 删除原始的文件
+        FileInfo sourceBlogFile = new(Path.Combine(blogOptions.Value.Root, "drafts", content.BlogName + ".md"));
+        sourceBlogFile.Delete();
+    }
+
+    private void RegisterCompressCommand(RootCommand rootCommand)
+    {
+        Command command = new("compress", "Compress png/jpeg image to webp image to reduce size.");
+        rootCommand.Add(command);
+
+        Option<bool> dryRunOption = new("--dry-run", description: "Dry run the compression task but not write.",
+            getDefaultValue: () => false);
+        command.AddOption(dryRunOption);
+
+        command.SetHandler(async dryRun => { await imageCompressService.Compress(dryRun); }, dryRunOption);
+    }
+}

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>
@@ -27,6 +28,6 @@
 
   <PropertyGroup>
     <ClientAssetsRestoreCommand>pnpm install</ClientAssetsRestoreCommand>
-    <ClientAssetsBuildCommand>pwsh ../../build.ps1 tailwind</ClientAssetsBuildCommand>
+    <ClientAssetsBuildCommand>pwsh tailwind.ps1</ClientAssetsBuildCommand>
   </PropertyGroup>
 </Project>

src/YaeBlog/appsettings.json

@@ -18,7 +18,7 @@
     "Links": [
       {
         "Name": "Ichirinko",
-        "Description": "这是个大哥",
+        "Description": "黑历史集合地，naive的代价",
         "Link": "https://ichirinko.top",
         "AvatarImage": "https://ichirinko-blog-img-1.oss-cn-shenzhen.aliyuncs.com/Pic_res/img/202209122110798.png"
       },

src/YaeBlog/tailwind.ps1

@@ -0,0 +1,11 @@
+#!/pwsh
+
+[cmdletbinding()]
+param(
+    [string]$Output = "wwwroot"
+)
+
+end {
+    Write-Host "Build tailwind css into $Output."
+    pnpm tailwindcss -i wwwroot/tailwind.css -o $Output/tailwind.g.css
+}