Aliso' Blog

从 Hexo 迁移到 Astro

Wed, 08 Jul 2026 00:00:00 GMT

为什么迁移

最开始搭建这个博客的时候，我还是一个刚接触前端的新手。那时候对于静态博客框架并没有太多了解，最后看教程直接选择了 Hexo 作为博客框架，使用的是 Vivia 主题，也陆续根据自己的需求对博客做了不少修改。

前段时间，我偶然发现 Vivia 已经推出了基于 Astro 的版本，而且项目一直保持着持续维护。然后发现自己以前花了不少时间手动实现的很多功能，在新版本中都已经得到了原生支持，整体的设计和开发体验也更加现代化。不仅如此，Astro 本身在性能、构建速度以及内容管理方面也比当初的 Hexo 更有优势。

于是现在我把博客从 Hexo 迁移到 Astro。一方面可以摆脱过去自己改的主题的各种丑陋的代码，另一方面也能借着这次迁移重新整理博客的结构和配置，让后续的维护更加轻松。

保留旧站

迁移不是为了丢弃过去。旧的 Hexo 站点被整树保留下来，作为可点开浏览的「时间胶囊」快照，搬进新站的 public/legacy/ 目录，随构建产物一起发布到 /legacy/ 路径下。

这样既不丢历史内容，也让新站保持干净——旧站是只读快照，新内容只写在 Astro 这边。

改路径让旧站自洽

旧站所有链接都是根路径，举例如下：

/css/style.css
/archives
/tags/Linux/
/2025/09/02/无限进步/

放进 /legacy/ 子路径后，这些链接会全部指到新站根，样式断、跳转断。

写了一个脚本 scripts/prepare-legacy.js，递归遍历旧站所有 HTML，把根路径属性重写成 /legacy/ 开头，举例如下：

# 改动前
src="/js/script.js"
href="/archives"

# 改动后
src="/legacy/js/script.js"
href="/legacy/archives"

跳过 //cdn 和完整 URL，顺便给每个 body 标签加上 data-pagefind-ignore。跑一次后旧站就能在新站子路径里完整自洽浏览，导航、翻页、样式都不坏。

排除出新站索引

旧站快照不应该污染新站的搜索结果和 SEO：

Pagefind：靠脚本注入的 body[data-pagefind-ignore]，搜索索引自动跳过旧站整页。
Sitemap：在 astro.config.mjs 给 sitemap() 加了一行 filter，把含 /legacy/ 的 URL 排除出 sitemap。具体写法如下：

filter: (page) => !page.includes("/legacy/")

这样搜索框只反映新内容，搜索引擎也只收录新站页面。

验证与小结

构建后访问博文里的链接跳到 /legacy/，旧站的首页、归档、分类、标签、文章内页都能正常导航，样式不崩、不跳回新站根。新旧两套互不干扰，迁移完成。

如果你想看看这次迁移前是什么样子，可以点这里访问旧版博客，整个 Hexo 站点被原样保留下来作为快照。

NoMaD项目复现

Wed, 04 Feb 2026 00:00:00 GMT

NoMaD项目复现

NoMaD: Goal Masked Diffusion Policies for Navigation and Exploration提出了一种基于 Transformer 与扩散模型的统一导航策略，能够在未知的环境中同时进行无目标探索和目标条件导航，并以更高效率实现更强泛化能力。

Train

最初训练模型是在本地电脑上进行，但是遇到训练速度过慢的问题，于是后续训练在服务器中进行。配置好环境之后，进行数据处理，此次训练采用 go_stanford 数据集（数据量小，适合学习用），但是因为 go_stanford 数据里的 yaw 和 position 在格式上不稳定（常见是多一维、不是标量、长度不够），而原始 _compute_actions 默认它们是形状固定的一维数组。结果在数据处理阶段做切片、拼接和 padding 时，yaw 会因为多出来的一维或类型不一致直接导致 shape 不匹配、np.concatenate / np.repeat 报错。所以要将以下文件的代码进行修改：

file：train/vint_train/data/vint_dataset.py

# Original code:
    def _compute_actions(self, traj_data, curr_time, goal_time):
        start_index = curr_time
        end_index = curr_time + self.len_traj_pred * self.waypoint_spacing + 1
        yaw = traj_data["yaw"][start_index:end_index:self.waypoint_spacing]
        positions = traj_data["position"][start_index:end_index:self.waypoint_spacing]
        goal_pos = traj_data["position"][min(goal_time, len(traj_data["position"]) - 1)]

        if len(yaw.shape) == 2:
            yaw = yaw.squeeze(1)

        if yaw.shape != (self.len_traj_pred + 1,):
            const_len = self.len_traj_pred + 1 - yaw.shape[0]
            yaw = np.concatenate([yaw, np.repeat(yaw[-1], const_len)])
            positions = np.concatenate([positions, np.repeat(positions[-1][None], const_len, axis=0)], axis=0)

        assert yaw.shape == (self.len_traj_pred + 1,), f"{yaw.shape} and {(self.len_traj_pred + 1,)} should be equal"
        assert positions.shape == (self.len_traj_pred + 1, 2), f"{positions.shape} and {(self.len_traj_pred + 1, 2)} should be equal"

        waypoints = to_local_coords(positions, positions[0], yaw[0])
        goal_pos = to_local_coords(goal_pos, positions[0], yaw[0])

        assert waypoints.shape == (self.len_traj_pred + 1, 2), f"{waypoints.shape} and {(self.len_traj_pred + 1, 2)} should be equal"

        if self.learn_angle:
            yaw = yaw[1:] - yaw[0]
            actions = np.concatenate([waypoints[1:], yaw[:, None]], axis=-1)
        else:
            actions = waypoints[1:]
        
        if self.normalize:
            actions[:, :2] /= self.data_config["metric_waypoint_spacing"] * self.waypoint_spacing
            goal_pos /= self.data_config["metric_waypoint_spacing"] * self.waypoint_spacing

        assert actions.shape == (self.len_traj_pred, self.num_action_params), f"{actions.shape} and {(self.len_traj_pred, self.num_action_params)} should be equal"

        return actions, goal_pos

# Modified code:
    def _compute_actions(self, traj_data, curr_time, goal_time):
        start_index = curr_time
        end_index = curr_time + self.len_traj_pred * self.waypoint_spacing + 1

        yaw = np.array(traj_data["yaw"][start_index:end_index:self.waypoint_spacing], dtype=np.float32).flatten()
        positions = np.array(traj_data["position"][start_index:end_index:self.waypoint_spacing], dtype=np.float32)
        goal_pos = np.array(traj_data["position"][min(goal_time, len(traj_data["position"]) - 1)], dtype=np.float32)

        # 补齐长度
        if yaw.shape[0] != self.len_traj_pred + 1:
            const_len = self.len_traj_pred + 1 - yaw.shape[0]
            yaw = np.concatenate([yaw, np.repeat(yaw[-1], const_len)])
            positions = np.concatenate([positions, np.repeat(positions[-1][None], const_len, axis=0)], axis=0)

        # 确保都是 float32
        yaw = yaw.astype(np.float32)
        positions = positions.astype(np.float32)

        waypoints = to_local_coords(positions, positions[0], float(yaw[0]))
        goal_pos = to_local_coords(goal_pos, positions[0], float(yaw[0]))

        if self.learn_angle:
            yaw_delta = (yaw[1:] - yaw[0]).astype(np.float32)
            actions = np.concatenate([waypoints[1:], yaw_delta[:, None]], axis=-1)
        else:
            actions = waypoints[1:]

        # 标准化
        if self.normalize:
            actions[:, :2] /= self.data_config["metric_waypoint_spacing"] * self.waypoint_spacing
            goal_pos /= self.data_config["metric_waypoint_spacing"] * self.waypoint_spacing

        # 最终确保是 float32
        actions = np.asarray(actions, dtype=np.float32)
        goal_pos = np.asarray(goal_pos, dtype=np.float32)

        return actions, goal_pos

在完成数据处理后，进行了模型训练，共训练 30 epochs，最终得到模型权重文件（.pth）。训练过程中，各项参数的变化情况均可在 Weights & Biases（wandb）中进行可视化查看。

Deployment

由于没有实机部署的条件，于是采用https://github.com/Mrakas/nomad的方案。

配置好环境之后，需要导入权重文件（.pth）并将代码结构统一，主要是修改相关文件中的路径设置。需要注意的是，diffusion_policy 是通过直接 git clone 得到的：外层是一个大文件夹，里面又包含一个同名的 diffusion_policy 子文件夹，这种结构很容易导致路径重复或引用混乱。因此，可能需要在多个地方进行调整，包括 diffusion_policy 内部的文件以及 deployment 相关文件中的路径引用。

相关代码完成之后，选择图片文件进行处理即可运行。目前程序最初的执行逻辑是：只取某一条轨迹中的某一个点，因此只会返回一个二维的 waypoint。需要对这部分逻辑进行如下修改：

api_explore_RGB.py

    # ...

    def navigate(self,
                 single_img = None,# priority
                 num_samples: int = 8, 
                 waypoint_index: int = 2,
                 return_traj: bool = False) -> np.ndarray:
        """
        Main navigation method to generate navigation actions.

        Args:
            context_images (List[str]): List of image paths for context
            num_samples (int, optional): Number of action samples. Defaults to 8.
            waypoint_index (int, optional): Waypoint to use for navigation. Defaults to 2.
            return_traj (bool, optional): Whether to return full trajectory. Defaults to False.

        Returns:
            np.ndarray: Chosen navigation waypoint
        """
        # Check context size
        
        # Load and transform images
        
        if len(self.context_queue) < 4:
            self.context_queue = [single_img,single_img,single_img,single_img] # 4imgs !!
        else:
            self.context_queue = self.context_queue[1:] + [single_img]

        context_queue = self.context_queue
        
        obs_images = transform_images(context_queue, self.model_params["image_size"], center_crop=False)
        obs_images = obs_images.to(self.device)

        # Prepare goal and mask
        fake_goal = torch.randn((1, 3, *self.model_params["image_size"])).to(self.device)
        mask = torch.ones(1).long().to(self.device)

        # Inference
        with torch.no_grad():
            # Encode vision features
            obs_cond = self.model('vision_encoder', obs_img=obs_images, goal_img=fake_goal, input_goal_mask=mask)
            
            # Repeat condition for multiple samples
            obs_cond = obs_cond.repeat(num_samples, 1) if len(obs_cond.shape) == 2 else obs_cond.repeat(num_samples, 1, 1)
            
            # Initialize noisy action
            noisy_action = torch.randn(
                (num_samples, self.model_params["len_traj_pred"], 2), device=self.device)
            naction = noisy_action

            # Run noise scheduler
            self.noise_scheduler.set_timesteps(self.num_diffusion_iters)
            for k in self.noise_scheduler.timesteps[:]:
                noise_pred = self.model(
                    'noise_pred_net',
                    sample=naction,
                    timestep=k,
                    global_cond=obs_cond
                )
                naction = self.noise_scheduler.step(
                    model_output=noise_pred,
                    timestep=k,
                    sample=naction
                ).prev_sample

        # Process actions
        naction = to_numpy(get_action(naction))

        if return_traj:
            return naction  # (num_samples, T, 2)

        naction = naction[0]  # Select first sample
        chosen_waypoint = naction[waypoint_index]

        # Normalize if required
        if self.model_params.get("normalize", False):
            chosen_waypoint *= (self.MAX_V / self.RATE)

        return chosen_waypoint

    # ...

api_test_RGB.py

import sys
sys.path.append('../vint_release/deployment')

from deployment.src.api_explore_RGB import VisualNavigationAPI
import PIL.Image as PILImage
import numpy as np

def main():
    single_img_path = 'path/to/0.jpg'
    single_img = PILImage.open(single_img_path).convert("RGB")

    nav_api = VisualNavigationAPI(model_name="nomad")

    # 核心：返回整条轨迹
    naction = nav_api.navigate(
        single_img=single_img,
        num_samples=8,
        return_traj=True
    )

    print("naction shape:", naction.shape)  # (8, 8, 2)
    np.save("naction.npy", naction)
    print("saved naction.npy")

if __name__ == "__main__":
    main()

最后，利用 show.py 生成轨迹。

import numpy as np
import matplotlib.pyplot as plt

naction = np.load("naction.npy")

plt.figure(figsize=(6, 6))
for i in range(naction.shape[0]):
    x = naction[i, :, 0]
    y = naction[i, :, 1]
    plt.plot(x, y, marker='o', alpha=0.8)

plt.axis("equal")
plt.grid(True)
plt.title("Predicted Trajectories")
plt.show()

尽管代码改的十分丑陋，但好在是完成了 ಥ_ಥ 。

服务器搭建代理环境

Thu, 22 Jan 2026 00:00:00 GMT

Clash 代理服务在服务器上快速部署

上传文件到服务器主目录

将以下两个文件上传到服务器主目录：

准备配置文件

在本地的 Clash 客户端中找到你的代理配置文件（通常是 .yml 后缀），将其改名为 config.yaml，并上传到服务器主目录。

启动 Clash

在服务器终端执行以下命令：

chmod +x clash
./clash -d .

如果能够弹出代理节点，说明 Clash 启动成功。(不能退出这个终端)

在终端中使用代理

在需要使用代理的终端输入以下命令（根据实际 IP 和端口调整）：

export https_proxy=127.0.0.1:7890
export http_proxy=127.0.0.1:7890

设置成功后，终端的网络请求就会通过 Clash 代理。

搭建WSL

Tue, 13 Jan 2026 00:00:00 GMT

Win11 下 WSL2 搭建记录

本文记录一次从零开始搭建 WSL2的完整过程，同时整理相关的关键命令。

一、什么是 WSL？

WSL（Windows Subsystem for Linux）是 Windows 提供的 Linux 子系统，使我们可以在 Windows 下直接运行原生 Linux 环境。其中：

WSL1：系统调用翻译层（已基本淘汰）

WSL2：基于轻量虚拟机，完整 Linux 内核（当前主流）

本文全部基于 WSL2 + Win11。

二、先安装，再迁移至 D 盘

2.1 安装 Ubuntu（默认在 C 盘）

wsl --install

安装完成后：首次启动会创建用户和密码

2.2 关闭 WSL

wsl --shutdown

2.3 导出 Ubuntu（生成 tar 备份）

先查看发行版名称：

wsl -l -v

然后导出：

wsl --export Ubuntu D:\WSL\ubuntu_backup.tar

该 tar 文件包含：

-系统
-用户
-home 目录
-已安装的软件和配置

2.4 注销原有 Ubuntu（删除 C 盘那份）

wsl --unregister Ubuntu

⚠️ 此操作会删除 C 盘里的 Ubuntu，但 tar 备份是完整的。

2.5 导入到 D 盘

先创建目标目录，例如：

D:\WSL\Ubuntu

然后执行：

wsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu_backup.tar --version 2

此时：Ubuntu 被重新注册，ext4.vhdx 会生成在 D 盘

三、成功标志与环境说明

当你看到类似提示：

username@HOSTNAME:~$

并伴随提示：

To run a command as administrator (user "root"), use "sudo <command>".

说明：Ubuntu 已正常启动，当前为普通用户，可通过 sudo 获取管理员权限

四、安装CUDA

在确认 WSL2 已正确启用、Ubuntu 子系统可正常运行，且 Windows 侧显卡驱动已支持 WSL GPU 后，下一步便是为 Linux 环境配置 CUDA 开发工具链。

考虑到稳定性、维护成本以及 WSL 环境的兼容性，本文选择 Ubuntu 官方仓库提供的 CUDA Toolkit，而非 NVIDIA 官方 runfile 安装方式。

4.1 更新系统软件源

在安装 CUDA 之前，建议先同步系统的软件索引并升级已有组件，以避免依赖冲突：

sudo apt update

sudo apt upgrade

该步骤不会影响 Windows 系统，只作用于 WSL 内部的 Ubuntu 文件系统。如果提示可升级大量基础库，属于正常现象，建议确认执行。

4.2 查询可用的 CUDA Toolkit 版本

Ubuntu 官方仓库并不会提供所有 NVIDIA 官网的 CUDA 版本，而是提供经过适配与验证的稳定版本。可以通过以下命令查看当前可用的 CUDA Toolkit：

apt search nvidia-cuda-toolkit

典型输出如下：

nvidia-cuda-toolkit 12.0.x

这意味着当前系统可直接安装 CUDA 12.0，对大多数深度学习与科研项目已经完全足够。

4.3 安装 CUDA Toolkit

直接通过 apt 安装即可：

sudo apt install nvidia-cuda-toolkit -y

该命令会自动安装以下内容：

CUDA 编译器（nvcc）

CUDA Runtime 与开发库

标准头文件与调试工具

安装过程中无需手动配置环境变量，这是官方仓库方案的一个重要优势。

4.4 验证 CUDA 安装状态

安装完成后，首先检查 CUDA 编译器是否可用：

nvcc --version

若输出类似以下内容，说明 CUDA Toolkit 已成功安装：

Cuda compilation tools, release 12.0

接着确认 nvcc 是否已加入系统 PATH：

which nvcc

在官方仓库方案下，返回路径通常为：

/usr/bin/nvcc

这是完全正常且推荐的结果，无需额外修改 .bashrc 或手动添加环境变量。

4.6 小结

至此，WSL2 下的 CUDA 开发环境已经搭建完成：

无需手动配置环境变量

无需下载 NVIDIA runfile

可直接用于 PyTorch、CUDA C++ 或科研项目开发

后续只需根据具体项目需求，安装对应的深度学习框架或编译 CUDA 程序即可。

五、WSL 使用

Windows 访问 Linux：

\\wsl$\Ubuntu\home\<user>

Linux 访问 Windows：

/mnt/c
/mnt/d

WSL（Windows 侧）管理命令【PowerShell / CMD】

⚠️ 以下命令在 Windows 终端 / PowerShell / CMD 中执行

wsl --list --verbose
# 列出所有已安装的 WSL 发行版，并显示使用的是 WSL1 还是 WSL2

wsl -l -v
# 上一条命令的简写形式，效果完全一致

wsl -d Ubuntu
# 启动名为 Ubuntu 的 WSL 发行版

wsl --set-default Ubuntu
# 将 Ubuntu 设置为默认发行版（直接输入 wsl 时启动它）

wsl --set-version Ubuntu 2
# 将 Ubuntu 切换为 WSL2（需要系统支持虚拟化）

wsl --shutdown
# 强制关闭所有正在运行的 WSL 实例（解决 90% 的异常问题）

WSL 迁移到 D 盘的核心命令串（重点）

wsl --shutdown
# 确保所有 WSL 实例已完全关闭，否则 vhdx 文件会被占用

wsl --export Ubuntu D:\WSL\ubuntu.tar
# 将 Ubuntu 发行版导出为一个 tar 包（不包含运行状态）

wsl --unregister Ubuntu
# 从 WSL 中注销 Ubuntu（不会影响刚刚导出的 tar 包）

wsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu.tar --version 2
# 将 Ubuntu 重新导入到 D 盘指定目录，并指定使用 WSL2

📌 说明：

D:\WSL\Ubuntu 下会生成 ext4.vhdx

以后 Ubuntu 的所有 Linux 文件都物理存放在 D 盘

WSL 内 Ubuntu：系统与软件管理

⚠️ 以下命令在 Ubuntu 终端中执行

sudo apt update
# 更新软件包索引（不安装软件）

sudo apt upgrade -y
# 升级所有已安装的软件到最新版本

sudo apt install git vim curl wget -y
# 安装常用基础工具：git、vim、curl、wget

sudo apt autoremove
# 删除不再被依赖的软件包，释放空间

系统信息与资源查看

uname -a
# 查看 Linux 内核信息（WSL 内核版本）

lsb_release -a
# 查看 Ubuntu 发行版版本信息

df -h
# 查看磁盘使用情况（人类可读格式）

free -h
# 查看内存使用情况（单位自动换算）

目录与文件操作

pwd
# 显示当前所在的完整路径

ls
# 列出当前目录下的文件和文件夹

ls -lah
# 以详细形式列出文件（含隐藏文件），并显示文件大小

cd /path/to/dir
# 切换到指定目录

cd ~
# 回到当前用户的 home 目录（/home/用户名）

mkdir project
# 创建名为 project 的文件夹

rm file.txt
# 删除文件 file.txt

rm -rf folder
# 强制递归删除 folder 目录（危险命令）

cp a.txt b.txt
# 复制文件 a.txt 为 b.txt

mv old new
# 重命名或移动文件/目录

Windows 与 WSL 文件互通

cd /mnt/c
# 进入 Windows 的 C 盘

cd /mnt/d/WSL
# 进入 Windows 的 D:\WSL 目录

explorer.exe .
# 用 Windows 资源管理器打开当前 Linux 目录

wsl
# 从 Windows 直接进入默认 WSL 发行版

权限与用户相关

whoami
# 显示当前登录的用户名

id
# 显示当前用户的 UID、GID 以及所属用户组

sudo command
# 以管理员（root）权限执行 command

sudo -i
# 切换到 root 用户（不建议长期使用）

开发常用（Git / Python）

Git

git clone https://github.com/user/repo.git
# 克隆远程仓库到本地

git status
# 查看当前仓库状态

git pull
# 拉取远程更新

git add .
# 将所有改动加入暂存区

git commit -m "message"
# 提交代码并添加提交说明

Python 虚拟环境

python3 --version
# 查看 Python 版本

sudo apt install python3-venv -y
# 安装 Python 虚拟环境模块

python3 -m venv venv
# 创建名为 venv 的虚拟环境

source venv/bin/activate
# 激活虚拟环境

deactivate
# 退出虚拟环境

更新

sudo apt update
# 从软件源同步可用软件列表

apt list --upgradable
# 查看当前有哪些软件可以升级

sudo apt upgrade
# 安全升级已安装的软件，不删除也不新增依赖

sudo apt full-upgrade
# 在必要时允许新增或删除依赖完成升级

sudo apt autoremove
# 删除升级后不再需要的旧依赖，释放磁盘空间

sudo apt clean
# 清空已下载的软件包缓存，不影响已安装的软件

df -h
# 查看磁盘剩余空间，避免升级或安装过程中空间不足

sudo apt update && sudo apt upgrade -y
# 一条命令完成日常系统更新（不需要逐条确认）

进程 / 网络 / 排错

top
# 实时查看系统进程和资源占用

htop
# 更友好的进程查看工具（需提前安装）

ps aux | grep python
# 查找包含 python 的进程

ping google.com
# 测试网络连通性

ip a
# 查看网络接口和 IP 地址

WSL 救命级命令

wsl --shutdown
# WSL 出现任何奇怪问题，第一步永远是它

df -h
# 检查磁盘是否已满（ext4.vhdx 满了会导致大量异常）

sudo apt --fix-broken install
# 修复损坏的软件依赖关系

Blog搭建

Sat, 20 Sep 2025 00:00:00 GMT

本网站基于 Hexo 构建，采用了 Vivia 主题，是一个风格简洁的个人博客模板。在当前版本中，“返回至顶端”、主页预览博客内容等功能尚不完善或者不符合我的使用习惯，这些都正在改进中改进。总体而言，在美观成都与易用性而言，这个模板表现非常不错。

作为该方向的初学者，我在此次网站搭建过程中基本依赖 AI 协助完成。

完成Blog基础功能的搭建

#2025年9月4日

在移除“返回至顶端”按钮后，发现主题切换按钮因继承了原按钮的点击方式，导致无法在页面顶端正常使用。为修复此 bug，需要定位相关文件，并将其中的指定代码完全删除。

以下为相关文件路径：

Blog\node_modules\hexo-theme-vivia\layout\_partial\back-to-top.ejs

以下为源文件代码（留着以防以后有用）：

<div class="back-to-top-wrapper">
    <button id="back-to-top-btn" class="back-to-top-btn hide" onclick="topFunction()">
        <i class="fa-solid fa-angle-up"></i>
    </button>
</div>

<script>
    function topFunction() {
        window.scroll({ top: 0, behavior: 'smooth' });
    }
    let btn = document.getElementById('back-to-top-btn');
    function scrollFunction() {
        if (document.body.scrollTop > 600 || document.documentElement.scrollTop > 600) {
            btn.classList.remove('hide')
        } else {
            btn.classList.add('hide')
        }
    }
    window.onscroll = function() {
        scrollFunction();
    }
</script>

接下来将进行下一步的开发，希望一切顺利。

主页展示方式的修改

#2025年9月8日

添加abstract

Blog\node_modules\hexo-theme-vivia\source\css\_partial

在上述文件夹中，创建 abstract.styl 文件，文件中代码如下：

.abstract-box
  border-left 4px solid skyblue
  color #000
  padding-left 10px
  line-height 1.6
  margin 16px 0
  display block

html[theme="dark"] .abstract-box
  color #fff

修改展示方式

Blog\node_modules\hexo-theme-vivia\layout\_partial\artical.ejs

在上述文件中，将以下部分:

<div class="e-content article-entry" itemprop="articleBody">
  <% if (post.excerpt && index){ %>
    <%- post.excerpt %>
  <% } else if (is_home() && !post.excerpt && theme.home.style != 'detail') { %>
    <div class="truncate-text">
     <% if(description){ %>
      <%- strip_html(post.description) %>
     <% } else{ %>
      <%- truncate(strip_html(post.content), {length: 500}) %>
     <% } %>
    </div>
  <% } else { %>
    <%- post.content %>
  <% } %>
</div>

修改为：

<div class="e-content article-entry" itemprop="articleBody">
  <% if (is_home() && post.abstract) { %>
    <div class="post-abstract abstract-box">
      <%= post.abstract %>
    </div>
  <% } else if (post.excerpt && index) { %>
    <%- post.excerpt %>
  <% } else if (is_home() && !post.excerpt && theme.home.style != 'detail') { %>
    <div class="truncate-text">
     <% if(description){ %>
      <%- strip_html(post.description) %>
     <% } else{ %>
      <%- truncate(strip_html(post.content), {length: 500}) %>
     <% } %>
    </div>
  <% } else { %>
    <%- post.content %>
  <% } %>
</div>

在修改之后，若加入了abstract，则会直接显示abstract；否则显示原文内容。

修改About的显示方式

#2025年9月8日

Blog\node_modules\hexo-theme-vivia\layout\_partial\article.ejs

在以上文件路径中，找到以下代码：

<div class='meta-info-bar'>    
  <%- partial('post/date', {class_name: 'meta-info', date_format: null}) %>    
  <div class="need-seperator meta-info">    
    <%- partial('post/category') %>     
  </div>    
  <div class="wordcount need-seperator meta-info">    
    <%- symbolsCount(post) %> <%- __('words') %>     
  </div>    
</div>

修改为：

<% if (post.layout !== 'page') { %>
  <div class='meta-info-bar'>    
    <%- partial('post/date', {class_name: 'meta-info', date_format: null}) %>    
    <div class="need-seperator meta-info">    
      <%- partial('post/category') %>     
    </div>    
    <div class="wordcount need-seperator meta-info">    
      <%- symbolsCount(post) %> <%- __('words') %>     
    </div>    
  </div>
<% } %>

在修改之后，About界面就不再显示时间、分类与字数。

完善Blog字数的计算

#2025年9月8日

Blog\node_modules\hexo-theme-vivia\languages\zh-CN.yml

以上文件中把 words 中的“词”改为“字”，则主页显示的则为字而不是词。

Blog\node_modules\hexo-theme-vivia\scripts

在以上文件夹中添加文件wordcount.js，以下为代码：

hexo.extend.helper.register('symbolsCount', function(post) {
  let content = post.content || '';

  // 1. 去掉多行代码块 <pre><code>...</code></pre>
  content = content.replace(/<pre.*?>[\s\S]*?<\/pre>/g, '');

  // 2. 去掉行内代码 <code>...</code>
  content = content.replace(/<code.*?>[\s\S]*?<\/code>/g, '');

  // 3. 去掉 HTML 标签
  content = content.replace(/<[^>]*>/g, '');

  // 4. 去掉空格、换行、制表符
  content = content.replace(/\s+/g, '');

  return content.length;
});

修改之后，Blog计数统计就不会计算代码。

PS：因为不支持ejs语法高亮，此处使用的html来添加代码高亮，实际为ejs.

添加Blog评论功能

#2025年9月18日

本功能基于giscus，简单实用。首先安装giscus app，并按照相关提示完成配置，得到配置代码。

Blog\node_modules\hexo-theme-vivia\layout\_partial

在以上路径中创建文件comment.ejs，加入giscus的相关配置代码。

Blog\node_modules\hexo-theme-vivia\layout\post.ejs

然后在以上文件中，加入以下代码:

<%- partial('_partial/comment') %>

配置完成。

添加友链版块

#2025年9月20日

很简单，在主题yaml文件中menu中添加Friends，在以下路径中：

\Blog\source\friends

创建index.md，以下为相关代码：

---
title: Friends
---


<div class="links-content">

  <div class="card">
    <img class="ava" src="/images/example.png" />
    <div class="card-header">
      <a href="https://friend1.com">Friend One</a>
      <div class="info">个人Blog</div>
    </div>
  </div>

</div>



<style>
.links-content {
  margin-top: 2rem;
  display: grid;
  grid-template-columns: 1fr;
  gap: 1.5rem;
  padding: 0 1rem;
}

/* 768px为moblile到tablet，1024为tablet到desktop */
@media screen and (min-width: 768px) {
  .links-content {
    grid-template-columns: repeat(2, 1fr);
  }
}

.card {
  display: flex;
  align-items: center;
  padding: 16px;
  border-radius: 8px;
  box-shadow: 0 2px 8px rgba(0,0,0,0.06);
  background-color: #ffffff;
  transition: transform 0.2s ease;
}

.card:hover {
  transform: scale(1.02);
}

.ava {
  width: 128px;
  height: 128px;
  border-radius: 50%;
  object-fit: cover;
  margin-right: 1rem;
  flex-shrink: 0;
}

.card-header {
  display: flex;
  flex-direction: column;
  align-items: flex-end;
  text-align: right;
  flex-grow: 1;
}

.card-header a {
  font-weight: bold;
  font-size: 1.1rem;
  color: #007acc;
  text-decoration: none;
}

.card-header a:hover {
  color: #005fa3;
}

.info {
  color: #666;
  font-size: 0.95rem;
  margin-top: 4px;
}
</style>

完成。

总结

完成Blog搭建，我对于这方面不够了解，所以整个Blog都是拆东墙补西墙的，缺乏作为一个项目的整体感（尽管尽量在主题上做出统一性）。

事情告一段落，要开始摆烂了QAQ.

配置ssh

Tue, 09 Sep 2025 00:00:00 GMT

Hexo 使用 SSH 部署到 GitHub 完整指南

生成 SSH Key

在命令行（CMD、PowerShell 或 Git Bash）执行：

ssh-keygen -t rsa -C "GitHub-Email@example.com"

测试ssh

ssh -T git@github.com

第一次连接时会提示：

The authenticity of host 'github.com (IP)' can't be established.
Are you sure you want to continue connecting (yes/no)?

输入yes并回车，如果显示：

Hi <用户名>! You've successfully authenticated...

说明SSH配置成功

注意事项

默认SSH端口会使用22端口，若22端口被墙，则用443端口。

22端口格式：

git@github.com:User/repo.git

443端口格式：

ssh://git@ssh.github.com:443/User/repo.git

无限进步

Tue, 02 Sep 2025 00:00:00 GMT

技术宅拯救世界

Examples

Mon, 01 Jan 2024 00:00:00 GMT

本篇合并了 Fuwari 模板的所有示例文章，涵盖 Markdown 基础语法、扩展功能、Expressive Code 代码块、嵌入视频以及使用指南。

Markdown 基础语法

标题与段落

Paragraphs are separated by a blank line.

2nd paragraph. Italic, bold, and monospace. Itemized lists look like:

this one
that one
the other one

Block quotes are written like so.

They can span multiple paragraphs, if you like.

Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all in chapters 12--14"). Three dots ... will be converted to an ellipsis. Unicode is supported. ☺

有序列表

first item
second item
third item

代码块

import time
# Quick, count to ten!
for i in range(10):
    # (but not *too* quick)
    time.sleep(0.5)
    print(i)

表格

size	material	color
9	leather	brown
10	hemp	canvas natural
11	glass	transparent

数学公式

Inline math equations go in like so: $\omega = d\phi / dt$. Display math should get its own line and be put in in double-dollarsigns:

$$I = \int \rho R^{2} dV$$

$$ \begin{equation*} \pi = 3.1415926535 ; 8979323846 ; 2643383279 ; 5028841971 ; 6939937510 ; 5820974944 \end{equation*} $$

脚注

Here's a footnote [^1].

[^1]: Footnote text goes here.

Markdown 扩展功能

GitHub 仓库卡片

::github{repo="Fabrizz/MMM-OnSpotify"}

::github{repo="saicaca/fuwari"}

Admonitions 提示框

:::note Highlights information that users should take into account, even when skimming. :::

:::tip Optional information to help a user be more successful. :::

:::important Crucial information necessary for users to succeed. :::

:::warning Critical content demanding immediate user attention due to potential risks. :::

:::caution Negative potential consequences of an action. :::

自定义标题

:::note[自定义标题] This is a note with a custom title. :::

GitHub 语法

[!TIP] The GitHub syntax is also supported.

Spoiler 剧透

The content :spoiler[is hidden ayyy]!

Expressive Code 代码块

语法高亮

console.log('This code is syntax highlighted!')

编辑器与终端框架

代码编辑器框架

console.log('Title attribute example')

终端框架

echo "This terminal frame has no title"

覆盖框架类型

echo "Look ma, no frame!"

文本与行标记

标记整行

// Line 1 - targeted by line number
// Line 2
// Line 3
// Line 4 - targeted by line number
// Line 5
// Line 6
// Line 7 - targeted by range "7-8"
// Line 8 - targeted by range "7-8"

选择标记类型

function demo() {
  console.log('this line is marked as deleted')
  // This line and the next one are marked as inserted
  console.log('this is the second inserted line')

  return 'this line uses the neutral default marker type'
}

Diff 语法

+this line will be marked as inserted
-this line will be marked as deleted
this is a regular line

  function thisIsJavaScript() {
    // This entire block gets highlighted as JavaScript,
    // and we can still add diff markers to it!
-   console.log('Old code to be removed')
+   console.log('New and shiny code!')
  }

可折叠区域

// All this boilerplate setup code will be collapsed
import { someBoilerplateEngine } from '@example/some-boilerplate'
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'

const engine = someBoilerplateEngine(evenMoreBoilerplate())

// This part of the code will be visible by default
engine.doSomething(1, 2, 3, calcFn)

function calcFn() {
  // You can have multiple collapsed sections
  const a = 1
  const b = 2
  const c = a + b

  // This will remain visible
  console.log(`Calculation result: ${a} + ${b} = ${c}`)
  return c
}

// All this code until the end of the block will be collapsed again
engine.closeConnection()
engine.freeMemory()
engine.shutdown({ reason: 'End of example boilerplate code' })

行号

// This code block will show line numbers
console.log('Greetings from line 2!')
console.log('I am on line 3')

console.log('Greetings from line 5!')
console.log('I am on line 6')

自动换行

// Example with wrap
function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}

嵌入视频

Just copy the embed code from YouTube or other platforms, and paste it in the markdown file.

YouTube

Bilibili

Fuwari 使用指南

文章 Front-matter

---
title: My First Blog Post
published: 2023-09-09
description: This is the first post of my new Astro blog.
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
---

Attribute	Description
`title`	The title of the post.
`published`	The date the post was published.
`description`	A short description of the post. Displayed on index page.
`image`	The cover image path of the post.<br/>1. Start with `http://` or `https://`: Use web image<br/>2. Start with `/`: For image in `public` dir<br/>3. With none of the prefixes: Relative to the markdown file
`tags`	The tags of the post.
`category`	The category of the post.
`draft`	If this post is still a draft, which won't be displayed.

文件放置位置

Your post files should be placed in src/content/posts/ directory. You can also create sub-directories to better organize your posts and assets.

src/content/posts/
├── post-1.md
└── post-2/
    ├── cover.png
    └── index.md

博客使用指南

创建新文章

在 src/content/posts/ 目录下新建 .md 文件，文件头部使用以下 front-matter：

---
title: 我的第一篇文章
published: 2025-09-20
description: 这是文章的简短描述，会显示在首页列表中。
image: ./cover.jpg   # 可选，文章封面图
tags: [学习, 教程]    # 可选，标签
category: 学习经历     # 可选，分类
draft: false         # 是否草稿（草稿不会显示）
---

字段	说明
`title`	文章标题
`published`	发布日期
`description`	简短描述，显示在首页
`image`	封面图路径。1. `http://` 开头：网络图片 2. `/` 开头：`public` 目录 3. 无前缀：相对于 md 文件
`tags`	标签数组
`category`	分类名称
`draft`	是否为草稿

如何添加 Projects 项目

打开 src/pages/projects.astro，在顶部的 projects 数组中添加你的项目即可。

添加一个有 GitHub 链接的项目

{
    name: "🏠 我的博客",
    description: "基于 Astro + Fuwari 搭建的个人博客。",
    date: "2025-09",
    primaryUrl: "https://github.com/Visa-Aliso/Asipe",
    links: [
        { icon: "fa6-brands:github", url: "https://github.com/Visa-Aliso/Asipe" },
    ],
}

添加一个有多个链接的项目

{
    name: "🤖 刷课机",
    description: "自动选课脚本。",
    date: "2025-08",
    primaryUrl: "https://github.com/Visa-Aliso/AutoElective",
    links: [
        { icon: "fa6-brands:github", url: "https://github.com/Visa-Aliso/AutoElective" },
        { icon: "material-symbols:description-outline-rounded", url: "https://docs.example.com" },
        { icon: "fa6-solid:flask", url: "https://demo.example.com" },
    ],
}

添加一个占位项目

还没有内容时用占位卡片填充：

{ name: "📐 Coming Soon", description: "Work in progress, stay tuned.", date: "", links: [], placeholder: true }

字段说明

字段	必填	说明
`name`	是	项目名称，建议以 emoji 开头
`description`	是	一行描述
`date`	是	格式 `YYYY-MM`，越新的越靠前；占位项目留空
`primaryUrl`	否	点击项目名称跳转的链接
`links`	是	底部图标按钮数组；占位项目为空 `[]`
`placeholder`	否	设为 `true` 表示占位卡片（虚线边框 + 半透明）

排序与折叠规则

项目按 date 从新到旧自动排序，占位项目排最后
每个分区超过 4 个项目时自动折叠，点击「展开更多」展开
分区只有 Projects 和 Learning 两个，不要随意增减

可用图标

图标来自 Iconify，常用图标集：

图标集	前缀	示例
Material Symbols	`material-symbols:`	`material-symbols:description-outline-rounded`
FA6 Brands	`fa6-brands:`	`fa6-brands:github`
FA6 Solid	`fa6-solid:`	`fa6-solid:flask`

前往 icones.js.org 搜索图标，复制名称填入 icon 字段即可。

添加友链

编辑 src/pages/links.astro 文件顶部的 friends 数组：

const friends = [
    {
        name: "KiloxGo",
        description: "Homepage",
        avatar: "https://github.com/KiloxGo.png",  // 头像 URL
        url: "https://profile.kilox.top",           // 站点链接
    },
    // 添加更多友链...
];

可用图标

本站使用 Iconify 图标库，支持以下图标集：

图标集	前缀	示例
Material Symbols	`material-symbols:`	`material-symbols:home-outline-rounded`
Font Awesome 6 Brands	`fa6-brands:`	`fa6-brands:github`
Font Awesome 6 Regular	`fa6-regular:`	`fa6-regular:address-card`
Font Awesome 6 Solid	`fa6-solid:`	`fa6-solid:star`

前往 icones.js.org 搜索图标，复制图标名称即可使用。

在 Projects 中使用图标

links: [
    { icon: "fa6-brands:github", url: "https://github.com/..." },
    { icon: "material-symbols:article-outline-rounded", url: "https://docs.example.com" },
    { icon: "fa6-solid:flask", url: "https://demo.example.com" },
]

在 Profile 侧栏使用图标

编辑 src/config.ts 中的 profileConfig.links：

links: [
    { name: "GitHub", icon: "fa6-brands:github", url: "https://github.com/Visa-Aliso" },
    { name: "Bilibili", icon: "fa6-brands:bilibili", url: "https://space.bilibili.com/..." },
    { name: "Email", icon: "material-symbols:mail-outline-rounded", url: "mailto:xxx@example.com" },
]

修改主题色

在线调色

点击导航栏右侧的调色板图标 🎨，拖动滑块即可实时切换整站色相（0-360）。颜色会保存在浏览器的 localStorage 中。

修改默认色相

编辑 src/config.ts：

export const siteConfig: SiteConfig = {
    themeColor: {
        hue: 250,  // 0-360，250 = 青色，0 = 红色，300 = 紫色，345 = 粉色
        fixed: false,  // 设为 true 则隐藏调色器，锁定颜色
    },
};

修改站点信息

编辑 src/config.ts：

export const siteConfig: SiteConfig = {
    title: "Aliso' Blog",           // 站点标题
    subtitle: "技术宅拯救世界",       // 副标题
    lang: "zh_CN",                  // 语言
    banner: {
        enable: true,               // 是否显示横幅
        src: "/images/seele.jpg",   // 横幅图片
    },
};

评论系统配置

评论使用 Giscus（基于 GitHub Discussions）。编辑 src/components/misc/Giscus.astro 顶部的默认参数，或前往 giscus.app 获取你的配置：

const {
    repo = "Visa-Aliso/Visa-Aliso.github.io",
    repoId = "R_kgDOPp3XLg",
    category = "Announcements",
    categoryId = "DIC_kwDOPp3XLs4Cvl5a",
} = Astro.props;

评论会自动出现在每篇博客文章底部和友链页面，主题跟随 fuwari 的亮色/暗色模式切换。

Aliso' Blog

从 Hexo 迁移到 Astro

为什么迁移

保留旧站

改路径让旧站自洽

排除出新站索引

验证与小结

NoMaD项目复现

NoMaD项目复现

Train

Deployment

服务器搭建代理环境

Clash 代理服务在服务器上快速部署

上传文件到服务器主目录

准备配置文件

启动 Clash

在终端中使用代理

搭建WSL

Win11 下 WSL2 搭建记录

一、什么是 WSL？

二、先安装，再迁移至 D 盘

2.1 安装 Ubuntu（默认在 C 盘）

2.2 关闭 WSL

2.3 导出 Ubuntu（生成 tar 备份）

2.4 注销原有 Ubuntu（删除 C 盘那份）

2.5 导入到 D 盘

三、成功标志与环境说明

四、安装CUDA

4.1 更新系统软件源

4.2 查询可用的 CUDA Toolkit 版本

4.3 安装 CUDA Toolkit

4.4 验证 CUDA 安装状态

4.6 小结

五、WSL 使用

推荐的长期结构：

Windows 访问 Linux：

Linux 访问 Windows：

WSL（Windows 侧）管理命令【PowerShell / CMD】

WSL 迁移到 D 盘的核心命令串（重点）

WSL 内 Ubuntu：系统与软件管理

系统信息与资源查看

目录与文件操作

Windows 与 WSL 文件互通

权限与用户相关

开发常用（Git / Python）

更新

进程 / 网络 / 排错

WSL 救命级命令

Blog搭建

完成Blog基础功能的搭建

主页展示方式的修改

添加abstract

修改展示方式

修改About的显示方式

完善Blog字数的计算

添加Blog评论功能

添加友链版块

总结

配置ssh

Hexo 使用 SSH 部署到 GitHub 完整指南

生成 SSH Key

测试ssh

注意事项

无限进步

技术宅拯救世界

Examples

Markdown 基础语法

标题与段落

有序列表

代码块

表格

数学公式

脚注

Markdown 扩展功能

GitHub 仓库卡片

Admonitions 提示框

自定义标题

GitHub 语法

Spoiler 剧透

Expressive Code 代码块