记录自己的摆烂日常与学习记录https://blog.hpcesia.com/https://blog.hpcesia.com/posts/nix-and-dendritic-pattern/https://blog.hpcesia.com/posts/nix-and-dendritic-pattern/Wed, 31 Dec 2025 10:26:26 GMT<article> <p>你使用 NixOS（或者 nix-darwin/Home Manager）吗？你的 Nix 配置是什么样子的？这不是在查户口，也不是为了说一句「I use NixOS, btw」，而是想介绍一个全新（其实并不太新）的 Nix 配置范式：<a href="https://github.com/mightyiam/dendritic">Dendritic 模式</a>。我承认，我就是想说那句「btw」。</p> <blockquote> <div><span>tips</span></div> <div> <p>如果你从来没有听说过 Nix 与 NixOS，可以去看看这篇 <a href="https://nixos-cn.org/tutorials/concept/BinaryAndSourceDistribution.html">关于 Nix 语言与 NixOS 的简单介绍</a>；如果想更进一步了解，可以看看 <a href="https://nixos-and-flakes.thiscute.world/zh/">NixOS &amp; Flakes Book</a>。</p> </div> </blockquote> <h2>一般的 Nix 配置都长啥样<a href="#一般的-nix-配置都长啥样">#</a></h2> <p>对于一个最小化安装的 NixOS 系统，整个系统的配置由一个固定的 <code>configuration.nix</code> 文件与一个自动扫描生成的 <code>hardware-configuration.nix</code> 两个 Nix 文件组成。理论上来说，可以一直只使用这两个文件，编写出几千上万行的单文件地狱级代码组成的配置文件，并构建出任何满足要求且可行的 NixOS 系统。但应该没人想阅读这种量级的单个源代码文件吧。</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>写这段代码的时候，只有上帝和我知道它是干嘛的 </span><span>// 现在只有上帝知道。</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>没人想读，更没人想维护，除非你想跟未来的自己结仇。还好 Nix 有一个 <code>import</code> 功能，不然故事到这里就结束了。Nix 的 <code>import</code> 可以将一个 Nix 文件整体作为一个值来使用，例如 <code>a = import ./a.nix;</code> 这一语句，与 <code>a = &lt;a.nix 的内容&gt;</code> 是完全等价的。但如果只使用 Nix 原生的 <code>import</code>，对于需要各种复杂输入参数的 Nix 配置来说，手动维护各个 Nix 文件的函数输入是一个很麻烦的事情，所以 Nixpkgs 为 Nix 带来了模块系统。只需一行</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>imports = </span><span>[</span><span>./another-module.nix</span><span>]</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>就可以将另一个内容符合 Nix 模块定义的文件作为整个 Nix 配置的一部分。通过这种方式，可以很快速地将多个 Nix 文件组织起来。因此，对多 Nix 配置文件的组织结构与方式就成了一个 Nix 配置的重点之一。如果你简单翻看过 GitHub 上 Star 数量比较高的 Nix 配置仓库，你会发现，这些仓库或多或少地都遵循了一种类似的组织结构，即将不同的功能划分到不同路径的文件当中。</p> <p>以 <a href="https://nixos-and-flakes.thiscute.world/zh/">NixOS &amp; Flakes Book</a> 作者 <a href="https://github.com/ryan4yan">ryan4yin</a> 的 <a href="https://github.com/ryan4yin/nix-config">Nix 配置</a>为例，该配置将不同的功能按等级划分在了不同模块（例如基础、TUI、GUI 三个等级）下的不同文件中，并在多台主机中通过复用这些功能模块；通过一个手搓的函数实现自动导入一个文件夹中的所有 <code>.nix</code> 文件。大概长下面这样：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>nix-config/</span></div></div><div><div><div>2</div></div><div><span>├── flake.nix</span></div></div><div><div><div>3</div></div><div><span>├── hosts/</span></div></div><div><div><div>4</div></div><div><span>│ └── laptop-01/</span></div></div><div><div><div>5</div></div><div><span>│ ├── configuration.nix # &lt;-- NixOS 入口</span></div></div><div><div><div>6</div></div><div><span>│ └── home.nix # &lt;-- Home Manager 入口</span></div></div><div><div><div>7</div></div><div><span>│</span></div></div><div><div><div>8</div></div><div><span>├── modules/ # &lt;-- 系统级模块</span></div></div><div><div><div>9</div></div><div><span>│ └── nixos/</span></div></div><div><div><div>10</div></div><div><span>│ ├── desktop.nix</span></div></div><div><div><div>11</div></div><div><span>│ ├── server.nix</span></div></div><div><div><div>12</div></div><div><span>│ └── ...</span></div></div><div><div><div>13</div></div><div><span>│</span></div></div><div><div><div>14</div></div><div><span>└── home/ # &lt;-- 用户级模块 (Home Manager)</span></div></div><div><div><div>15</div></div><div><span><span> </span></span><span>└── linux/</span></div></div><div><div><div>16</div></div><div><span><span> </span></span><span>├── gui/</span></div></div><div><div><div>17</div></div><div><span><span> </span></span><span>│ ├── vscode/</span></div></div><div><div><div>18</div></div><div><span><span> </span></span><span>│ │ └── default.nix</span></div></div><div><div><div>19</div></div><div><span><span> </span></span><span>│ └── ...</span></div></div><div><div><div>20</div></div><div><span><span> </span></span><span>└── ...</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>每个模块的路径就是它的功能描述。这种“看文件名知其意”的模式，已经比“单文件地狱”好太多了。但生命不息折腾不止，Nix 玩家永远在找轮子和造轮子中无限循环。于是有人更进一步，将这种范式提炼出来，提出了这篇文章的主题——<a href="https://github.com/mightyiam/dendritic">Dendritic 模式</a>。</p> <h2>Dendritic 模式是什么？<a href="#dendritic-模式是什么">#</a></h2> <p>Dendritic 模式是一种基于 <a href="https://flake.parts/"><code>flake-parts</code></a> 的 Nix 配置组织方式，在这种组织方式下，每一个 <code>.nix</code> 文件都是一个 <code>flake-parts</code> 模块。而 <code>flake-parts</code> 是一个 Nix 配置框架，用于将一个 Nix flake 配置拆分为多个独立的可重用模块，以保持 flake 的整洁性和可维护性。Dendritic 模式利用了 <a href="https://flake.parts/options/flake-parts-modules.html"><code>flake-parts</code> 的 <code>modules</code> 功能</a>定义并集成模块化的配置。</p> <p>Dendritic 的名字意为“树枝状的”，它也确实以一种树状结构来组织文件。所有的模块都存放在 <code>modules</code> 目录下，并根据功能进行分类，通过 <a href="https://github.com/vic/import-tree">vic/import-tree</a> 自动导入所有的模块。</p> <p>一段时间以前，我把之前的 Nix 配置重构为了 Dendritic 模式。在此之前，我的 Nix 配置总体上是从 <a href="https://github.com/ryan4yin/nix-config">Ryan Yin 的 Nix 配置</a> 那里抄来的架构，我自己只是稍微改了改 (毕竟天下代码一大抄)。一开始的时候，抄来的成熟的配置架构用起来还是很快乐的——直到我遇到需要横跨 NixOS 和 Home Manager 的配置。一旦配置需要横跨 NixOS 和 Home Manager，整个配置就会变得比较繁琐：虽然配置对应的功能与文件路径是相关的，但是几个从文件路径上看关系不大的配置文件事实上是耦合在一起的。</p> <p>一个简单的例子是在启用某类软件时禁用桌面环境提供的同类软件包。比如我选择使用 DeaDBeeF 作为我的音乐播放器后，我想禁用 KDE Plasma 6 自带的音乐播放器 Elisa。为此，在旧的架构中，我需要依靠注释手动维护 <code>home</code> 和 <code>modules</code> 两个目录中的不同的文件的同步关系：</p> <div><figure><figcaption><span>modules/nixos/desktop.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span><span> </span><span>pkgs</span><span>,</span><span> </span><span>...</span><span>}:</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span># ...</span></div></div><div><div><div>3</div></div><div><span> </span><span>environment</span><span>.</span><span>plasma6</span><span>.</span><span>excludePackages</span><span> </span><span>=</span><span> </span><span>with</span><span> pkgs</span><span>.</span><span>kdePackages; </span><span>[</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>konsole </span><span># 因为 Ghostty</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>kdepim-runtime </span><span># 因为 Thunderbird</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>kate </span><span># 因为 VSCode</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>elisa </span><span># 因为 DeaDBeeF</span></div></div><div><div><div>8</div></div><div><span> </span><span>];</span></div></div><div><div><div>9</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <div><figure><figcaption><span>home/linux/gui/thunderbird.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>programs</span><span>.</span><span>thunderbird</span><span>.</span><span>enable</span><span> </span><span>=</span><span> ture</span><span>;</span></div></div><div><div><div>3</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>这些关联的配置是否可以同步，完全取决于我修改配置时有没有按照注释去同步修改其他地方的配置。这可不兴赌啊！要知道，最不可靠的就是未来的自己会不会记得遵守过去的约定，注释和文档过时也是家常便饭的事。然而，在 Dendritic 模式中，我完全可以通过同一个文件中编写不同的模块来实现跨 NixOS 与 Home Manager 的配置的同步：</p> <div><figure><figcaption><span>modules/desktop/thunderbird.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>flake</span><span>.</span><span>modules</span><span>.</span><span>nixos</span><span>.</span><span>desktop</span><span> </span><span>=</span><span> </span><span>{</span><span>pkgs</span><span>,</span><span> </span><span>...</span><span>}:</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>environment</span><span>.</span><span>plasma6</span><span>.</span><span>excludePackages</span><span> </span><span>=</span><span> </span><span>with</span><span> pkgs</span><span>.</span><span>kdePackages; </span><span>[</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>kdepim-runtime </span><span># No needed if using Thunderbird.</span></div></div><div><div><div>5</div></div><div><span> </span><span>];</span></div></div><div><div><div>6</div></div><div><span> </span><span>};</span></div></div><div><div><div>7</div></div><div> </div></div><div><div><div>8</div></div><div><span> </span><span>flake</span><span>.</span><span>modules</span><span>.</span><span>homeManager</span><span>.</span><span>desktop</span><span> </span><span>=</span><span> </span><span>_</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span> </span><span>programs</span><span>.</span><span>thunderbird</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>10</div></div><div><span> </span><span>enable</span><span> </span><span>=</span><span> </span><span>true</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span>};</span></div></div><div><div><div>12</div></div><div><span> </span><span>};</span></div></div><div><div><div>13</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>此时 <code>kdepim-runtime</code> 是否启用是与 Thunderbird 这一模块是否被导入是完全一致的。</p> <p>为什么原先就要这么麻烦？因为通常情况下，Nixpkgs 提供的 <code>imports</code> 功能是局限于 NixOS/Home Manager/nix-darwin 内部的，你在 Home Manager 里导入的模块无法修改外层的 NixOS 配置。与此同时，在外层的 NixOS 配置中，也难以访问 Home Manager 中的配置，除非硬编码 Home Manager 的用户名。</p> <p>那为什么不自定义几个 option？就像这样：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span><span>lib</span><span>,</span><span> </span><span>pkgs</span><span>,</span><span> </span><span>config</span><span>,</span><span> </span><span>...</span><span>}:</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>options</span><span>.</span><span>myoption</span><span>.</span><span>app</span><span>.</span><span>deadbeef</span><span>.</span><span>enable</span><span> </span><span>=</span><span> lib</span><span>.</span><span>mkEnableOption </span><span>"Enable DeaDBeeF"</span><span>;</span></div></div><div><div><div>3</div></div><div><span> </span><span>config</span><span> </span><span>=</span><span> lib</span><span>.</span><span>mkIf config</span><span>.</span><span>myoption</span><span>.</span><span>app</span><span>.</span><span>deadbeef</span><span>.</span><span>enable </span><span>{</span></div></div><div><div><div>4</div></div><div><span> </span><span>environment</span><span>.</span><span>plasma6</span><span>.</span><span>excludePackages</span><span> </span><span>=</span><span> </span><span>with</span><span> pkgs</span><span>.</span><span>kdePackages; </span><span>[</span><span>elisa</span><span>];</span></div></div><div><div><div>5</div></div><div><span> </span><span>};</span></div></div><div><div><div>6</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span><span>lib</span><span>,</span><span> </span><span>pkgs</span><span>,</span><span> </span><span>osConfig</span><span>,</span><span> </span><span>...</span><span>}:</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>config</span><span> </span><span>=</span><span> lib</span><span>.</span><span>mkIf osConfig</span><span>.</span><span>myoption</span><span>.</span><span>app</span><span>.</span><span>deadbeef</span><span>.</span><span>enable </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>home</span><span>.</span><span>packages</span><span> </span><span>=</span><span> </span><span>[];</span></div></div><div><div><div>4</div></div><div><span> </span><span>};</span></div></div><div><div><div>5</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>当然可以！但每加一个横跨 NixOS 与 Home Manager 的程序就得写一套这样的 option，久而久之，你就创造了一个全新的复杂系统，只有上帝看得懂，真是可喜可贺可喜可贺。况且由于 Nix 的几个 LSP 实现的功能都并不够强大，这种方式在自动补全上也没有什么优势。</p> <p>通过上面的例子，我们可以看到 Dendritic 模式的核心优势：<strong>将高度耦合的配置项聚合到同一个文件中</strong>。这带来了几个显而易见的好处：</p> <ol> <li>原子性：一个功能的所有相关配置都在一个模块里。启用或禁用这个功能，只需要在主机配置中添加或移除这一个模块的导入，而不需要在文件系统的多个角落里进行增删改查。</li> <li>可发现性：想了解一个程序或一项服务是如何配置时，不再需要在 <code>nixos/</code>、<code>home/</code>、<code>services/</code> 等多个目录中来回跳转，寻找散落的配置片段。所有相关的逻辑都集中在一个地方，极大地提高了配置的可读性和可维护性。</li> <li>减少心智负担：不再需要通过注释或者单纯依靠记忆来维护不同配置文件之间的隐式依赖。配置本身就是自洽和内聚的。</li> </ol> <h2>编写一个符合 Dendritic 模式的配置<a href="#编写一个符合-dendritic-模式的配置">#</a></h2> <blockquote> <p>叽里咕噜说半天搞啥名堂呢，快把焚决交出来！</p> </blockquote> <p>有的，兄弟/姐妹/any pronoun you want，有的，这不就给你安排上了！Dendritic 模式的介绍仓库里提供了一个<a href="https://github.com/mightyiam/dendritic/tree/master/example">最基础的模板</a>，不过我个人更推荐去啃别人实际的 Dendritic 模式的配置来做参考。啃别人的仓库是一个麻烦事，因为一个显而易见的事实：个人的配置仓库不是为了让别人学习而设计的。我自然也「深受其害」，啃了半天才大概看明白配置仓库的大致结构。</p> <p>首先创建一个简单的目录结构，这就是接下来的配置的主要内容。</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>nix-config/</span></div></div><div><div><div>2</div></div><div><span>├── flake.nix</span></div></div><div><div><div>3</div></div><div><span>└── modules/</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>├── flake/</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>├── hosts/</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>└── ... # &lt;--- 任何你想要的功能分类方式</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>首先自然是最基本的，给 <code>flake.nix</code> 添加主要的输入和唯一的输出：</p> <div><figure><figcaption><span>flake.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>inputs</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>flake-parts</span><span>.</span><span>url</span><span> </span><span>=</span><span> </span><span>"github:hercules-ci/flake-parts"</span><span>;</span></div></div><div><div><div>4</div></div><div><span> </span><span>import-tree</span><span>.</span><span>url</span><span> </span><span>=</span><span> </span><span>"github:vic/import-tree"</span><span>;</span></div></div><div><div><div>5</div></div><div><span> </span><span>nixpkgs</span><span>.</span><span>url</span><span> </span><span>=</span><span> </span><span>"github:NixOS/nixpkgs/nixos-unstable"</span><span>;</span></div></div><div><div><div>6</div></div><div><span> </span><span>};</span></div></div><div><div><div>7</div></div><div> </div></div><div><div><div>8</div></div><div><span> </span><span>outputs</span><span> </span><span>=</span><span> </span><span>inputs</span><span>:</span></div></div><div><div><div>9</div></div><div><span><span> </span></span><span>inputs</span><span>.</span><span>flake-parts</span><span>.</span><span>lib</span><span>.</span><span>mkFlake </span><span>{</span><span>inherit</span><span> </span><span>inputs</span><span>;}</span><span> </span><span>{</span></div></div><div><div><div>10</div></div><div><span> </span><span>imports</span><span> </span><span>=</span><span> </span><span>[(</span><span>inputs</span><span>.</span><span>import</span><span>-</span><span>tree </span><span>./modules</span><span>)];</span></div></div><div><div><div>11</div></div><div><span> </span><span>};</span></div></div><div><div><div>12</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>其中 <code>import-tree ./modules</code> 的作用就是导入 <code>./modules</code> 文件夹中所有不以 <code>_</code> 开头的 <code>.nix</code> 文件，方便省略掉大部分的 <code>imports = [...]</code>；<code>flake-parts</code> 是 Dendritic 模式的核心组件；<code>nixpkgs</code> 应该不用多说，不过使用的分叉也不一定是 <code>unstable</code>，根据实际情况选择即可。接下来就该构建整个配置了。</p> <div><figure><figcaption><span>modules/flake/default.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span><span>inputs</span><span>,</span><span> </span><span>...</span><span>}:</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>imports</span><span> </span><span>=</span><span> </span><span>[</span><span>inputs</span><span>.</span><span>flake-parts</span><span>.</span><span>flakeModules</span><span>.</span><span>modules</span><span>];</span><span> </span><span># 使用 flake module</span></div></div><div><div><div>3</div></div><div><span> </span><span>systems</span><span> </span><span>=</span><span> </span><span>[</span><span>"x86_64-linux"</span><span>];</span><span> </span><span># 根据实际情况添加对应的平台，例如 aarch64-darwin 等。</span></div></div><div><div><div>4</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <div><figure><figcaption><span>modules/flake/nixos.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>inputs</span><span>,</span></div></div><div><div><div>3</div></div><div><span> </span><span>lib</span><span>,</span></div></div><div><div><div>4</div></div><div><span> </span><span>config</span><span>,</span></div></div><div><div><div>5</div></div><div><span> </span><span>withSystem</span><span>,</span></div></div><div><div><div>6</div></div><div><span> </span><span>...</span></div></div><div><div><div>7</div></div><div><span>}:</span><span> </span><span>let</span></div></div><div><div><div>8</div></div><div><span> </span><span>prefix</span><span> </span><span>=</span><span> </span><span>"hosts/"</span><span>;</span><span> </span><span># 主机对应的 flake module 的前缀，可以修改</span></div></div><div><div><div>9</div></div><div><span> </span><span>collectHostsModules</span><span> </span><span>=</span><span> </span><span>modules</span><span>:</span></div></div><div><div><div>10</div></div><div><span><span> </span></span><span>lib</span><span>.</span><span>filterAttrs</span></div></div><div><div><div>11</div></div><div><span> </span><span>(</span><span>name</span><span>:</span><span> </span><span>_</span><span>:</span><span> lib</span><span>.</span><span>hasPrefix prefix name</span><span>)</span></div></div><div><div><div>12</div></div><div><span><span> </span></span><span>modules</span><span>;</span></div></div><div><div><div>13</div></div><div><span>in</span><span> </span><span>{</span></div></div><div><div><div>14</div></div><div><span> </span><span>flake</span><span>.</span><span>nixosConfigurations</span><span> </span><span>=</span></div></div><div><div><div>15</div></div><div><span><span> </span></span><span>lib</span><span>.</span><span>pipe</span></div></div><div><div><div>16</div></div><div><span> </span><span>(</span><span>collectHostsModules config</span><span>.</span><span>flake</span><span>.</span><span>modules</span><span>.</span><span>nixos</span><span>)</span><span> </span><span># 此处依照实际的 NixOS 配置所在的 flake module</span></div></div><div><div><div>17</div></div><div><span> </span><span>[</span></div></div><div><div><div>18</div></div><div><span> </span><span># 删除主机配置名称的前缀，例如 `hosts/abc` -&gt; `abc`</span></div></div><div><div><div>19</div></div><div><span> </span><span>(</span><span>lib</span><span>.</span><span>mapAttrs' </span><span>(</span></div></div><div><div><div>20</div></div><div><span> </span><span>name</span><span>:</span><span> </span><span>value</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>21</div></div><div><span> </span><span>name</span><span> </span><span>=</span><span> lib</span><span>.</span><span>removePrefix prefix name</span><span>;</span></div></div><div><div><div>22</div></div><div><span> </span><span>inherit</span><span> </span><span>value</span><span>;</span></div></div><div><div><div>23</div></div><div><span> </span><span>}</span></div></div><div><div><div>24</div></div><div><span> </span><span>))</span></div></div><div><div><div>25</div></div><div><span> </span><span># 生成 NixOS 配置所需的结构</span></div></div><div><div><div>26</div></div><div><span> </span><span>(</span><span>lib</span><span>.</span><span>mapAttrs' </span><span>(</span></div></div><div><div><div>27</div></div><div><span> </span><span>name</span><span>:</span><span> </span><span>module</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>28</div></div><div><span> </span><span>inherit</span><span> </span><span>name</span><span>;</span></div></div><div><div><div>29</div></div><div><span> </span><span>value</span><span> </span><span>=</span><span> inputs</span><span>.</span><span>nixpkgs</span><span>.</span><span>lib</span><span>.</span><span>nixosSystem </span><span>{</span></div></div><div><div><div>30</div></div><div><span> </span><span>modules</span><span> </span><span>=</span><span> </span><span>[</span></div></div><div><div><div>31</div></div><div><span> </span><span>{</span><span>networking</span><span>.</span><span>hostName</span><span> </span><span>=</span><span> name</span><span>;}</span></div></div><div><div><div>32</div></div><div><span><span> </span></span><span>module</span></div></div><div><div><div>33</div></div><div><span> </span><span>];</span></div></div><div><div><div>34</div></div><div><span> </span><span>}</span></div></div><div><div><div>35</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>36</div></div><div><span><span> </span></span><span>))</span></div></div><div><div><div>37</div></div><div><span><span> </span></span><span>]</span><span>;</span></div></div><div><div><div>38</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>这样一来，名称为 <code>"hosts/&lt;hostname&gt;"</code> 的 flake module 的内容就会变成一个名为 <code>&lt;hostname&gt;</code> 的 NixOS 配置。在这之后，只需在 <code>modules/hosts</code> 目录中添加主机对应的 flake module，并在该模块中导入所有该主机需要的功能即可，例如：</p> <div><figure><figcaption><span>modules/hosts/foobar.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>flake</span><span>.</span><span>modules</span><span>.</span><span>nixos</span><span>.</span><span>"hosts/foobar"</span><span> </span><span>=</span><span> </span><span>_</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>nixpkgs</span><span>.</span><span>system</span><span> </span><span>=</span><span> </span><span>"x86_64-linux"</span><span>;</span></div></div><div><div><div>4</div></div><div> </div></div><div><div><div>5</div></div><div><span> </span><span>imports</span><span> </span><span>=</span><span> </span><span>with</span><span> config</span><span>.</span><span>flake</span><span>.</span><span>modules</span><span>.</span><span>nixos; </span><span>[</span></div></div><div><div><div>6</div></div><div><span> </span><span># 这些 flake module 的名称仅作为示范，不代表你只能这样取名</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>core</span></div></div><div><div><div>8</div></div><div><span> </span><span>"hardware/cpu/intel"</span></div></div><div><div><div>9</div></div><div><span> </span><span>"hardware/gpu/amd"</span></div></div><div><div><div>10</div></div><div><span> </span><span>"services/caddy"</span></div></div><div><div><div>11</div></div><div><span> </span><span>"services/ollama"</span></div></div><div><div><div>12</div></div><div><span> </span><span>...</span></div></div><div><div><div>13</div></div><div><span> </span><span>];</span></div></div><div><div><div>14</div></div><div> </div></div><div><div><div>15</div></div><div><span> </span><span>fileSystems</span><span>.</span><span>"/"</span><span> </span><span>=</span><span> </span><span>{</span><span>...</span><span>};</span></div></div><div><div><div>16</div></div><div><span> </span><span>};</span></div></div><div><div><div>17</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>而导入的这些模块，则写在 <code>modules/{core,hardware,services}/*.nix</code> 这样与模块名和功能相对应的路径中。</p> <h2>写在结尾<a href="#写在结尾">#</a></h2> <p>说实话，断更四个月然后憋出来一个三千字不到的水货文章（甚至包含这三段话），我的码字速度还是太懈怠了。虽然开的草稿越来越多，但实际上写了超过三分之一的少之又少。<a href="/posts/serbia-travel-journal-1/">塞尔维亚游记</a>发出来已经一年多了，到现在也没写好中下两篇，以至于实际上已经快把当时的故事给忘光了。看到隔壁<a href="https://chlo.is/">小氯</a>动不动就更新一篇万字长文，压力更大了。</p> <p>这篇文章断断续续写了大概两个月，从刚换到 Dendritic 模式之后就开始动笔了，但是由于之前在备战考研二战，考完了又在到处旅游，实在是没什么空写东西，所以一直拖到了现在。好在赶在 2025 年的尾巴上写完了，不然 2025 年的更新状况就太难看了，可喜可贺可喜可贺。</p> <p>希望后面还有更多东西能够写出来吧，2026 再见！</p> </article> https://blog.hpcesia.com/posts/essays-3/https://blog.hpcesia.com/posts/essays-3/Fri, 29 Aug 2025 05:09:47 GMT<article> <h2>小屋装修<a href="#小屋装修">#</a></h2> <p>趁着之前赶上，有了些动力，花了点时间给小屋狠狠装修了一下。</p> <p>首先是把图片灯箱给换掉了。此前小屋使用的是非常轻量所以功能也很少的 MediumZoom，这个灯箱库在博文的图片里用用还行，但是遇到动态生成的图片和裁切过的图片就有点力不从心了，而<a href="/musings">我的 Fediverse 贴文展示页面</a> 的图片都是动态生成和前端裁切过的，所以需要更换灯箱库。</p> <p>PhotoSwipe 是一个更重一点的灯箱库，默认的效果很好，可自定义程度也更高。选择 PhotoSwipe 的主要原因是 GoToSocial 的前端也是用的这个库，兼容性不用多说。目前只实现了 Fediverse 的图片附件的灯箱效果，从 GoToSocial 的源码来看还可以实现视频附件的灯箱效果，不过我一是还没有发过带视频附件的贴文，二是 GoToSocial 的实现是 AGPL v3 的不能直接抄，所以暂且搁置到我真的发了带视频附件的公开贴文再说。</p> <p>下一个重构的就是<a href="/musings">碎语</a>页面。此前小屋的碎语页是<a href="/posts/miscellaneous-notes-2/">基于 RSS 的</a>，写起来非常简单的代价是功能也非常少，不支持敏感内容隐藏，每个贴文的图片在 RSS 里只会有第一张（所以我干脆没有展示）。</p> <p>现在改为了基于调用 GoToSocial API 的方式来实现。默认情况下，GoToSocial 的绝大多数 API 端点都需要身份验证，而我不打算暴露多余的 API（比如可以设置公共时间线可以无认证访问，但是我还保留着这个实例未来加人的可能，不像公开整个时间线），所以我 Vibe Coding 了一层 Cloudflare Worker 套壳，用来把查询 API 暴露给前端。</p> <p>接着又把代码块的美化给换掉了。在此之前我使用的是自己手搓的代码块美化，主题切换、复制、行号等都是靠 remark 插件 + shiki 插件实现的。现在我换成了更好看功能也更多的 <a href="https://expressive-code.com">Expressive Code</a>，并更新了一下过往文章进行适配，结果还是不错的。</p> <p>最后是换了一下配色方案，改成了 <a href="https://catppuccin.com/">Catppuccin Latte/Macchiato</a>，比自己之前搓的要好看一些。</p> <h2>新服务器<a href="#新服务器">#</a></h2> <p>Nix 的优势区就是管理多个主机的配置，所以在<a href="/posts/miscellaneous-notes-2/">把笔记本换成 NixOS 系统</a>以后，我便把目光看向了服务器。但是现有的服务器不能乱动――第一次配远程 NixOS，肯定是错误百出，要是直接在现有服务器上搞，跑着的服务多半要停上几周。正好我也对现在服务器的配置和续费价格不甚满意，很快就趁着主机商周年庆打折，入手了一个新的 2C4G 云服务器。</p> <p>到手后 SSH 上去传一下公钥并开启仅密钥登录，然后就可以根据服务器的硬件配置写对应的 NixOS 配置，写完就可以准备推送过去了。主机商没有提供挂载任意镜像的功能，，可选的系统镜像里也没有 NixOS，所以需要自行安装。这里我参考的是 Lan Tian 的<a href="https://lantian.pub/article/modify-computer/nixos-low-ram-vps.lantian/">这篇文章</a>，不过我的 VPS 内存足够大，所以就直接使用 nix-anywhere 来部署系统了。（PS：从 NixOS 的 TG 群里了解到还有个<a href="https://github.com/bin456789/reinstall">自动重装/更换系统的脚本</a>，下次再远程部署 NixOS 就准备用这个了）</p> <p>部署 NixOS 的过程里最大的错误是图省事，没有写一个最简系统配置，而是直接在我的现有配置基础上写了对应主机的配置，结果就是状况不断，排查起来相当麻烦。安装 NixOS 的时候，LLM 出力不少，让我这个对非 NixOS 的 Linux 系统两眼一抹黑的人能够快速开始编写主机的启动配置。中间三番五次使用 nix-anywhere 部署完毕后连不上 SSH，好在主机商提高了网页 VNC，我还能看到报错信息，不至于一直重装。</p> <p>在成功连上部署好的 NixOS 的 SSH 之后，接下来就属于是重复性工作了。把原本 VPS 上的服务容器停掉，在 Nix 配置里启用对应的服务，把配置迁移到 Nix 上，再把数据也拉到服务器上，迁移就算完工了。迁移也有一些无伤大雅的小 Bug，比如 Forgejo 以前部署在容器里，存储的 Git 仓库的权限和 Nix 部署的不一样，chown 改了一下权限后所有仓库的文件修改时间都被刷新了；比如 Forgejo 的密钥发生变化，导致以前的 SSH 仓库镜像推送全炸了，但总的来说修起来都不难。</p> <h2>离开 GitHub<a href="#离开-github">#</a></h2> <p>8 月 11 日，<a href="https://www.theverge.com/news/757461/microsoft-github-thomas-dohmke-resignation-coreai-team-transition">一则重磅消息</a>在开发者圈子里传开了：GitHub 的 CEO Thomas Dohmke 辞职了，而微软不打算找一个新的 CEO，而是让 GitHub 直接由微软的 CoreAI 部门管理，这意味着 GitHub 不再是微软的一个独立子公司，并且 GitHub 会更加注重 AI 的发展 意思就是 GitHub 可以改名叫 Microsoft 365 Copilot Version Control Platform 了。虽然我还在使用薅资本主义羊毛学生免费的 GitHub Copilot Pro，没啥底气喷 GitHub 的 AI 发展方向，但也得给自己留点后路了。</p> <p>后路自然是 Codeberg 和自托管 Forgejo。在 Forgejo 的联邦功能基本可用之前，我选择暂时将 Codeberg 作为主要活动区域。完全脱离 GitHub 是不太现实的，我有不少东西是完全依赖于 GitHub 的，比如学生认证薅的 Copilot Pro，比如 Nix 整个生态都严重依赖于 GitHub，所以现在只是部分迁移。</p> <h2>Hello, Jujutsu<a href="#hello-jujutsu">#</a></h2> <p><a href="https://jj-vcs.github.io/">Jujutsu</a> 是一个兼容 Git^{<a href="#user-content-fn-1">1</a>} 的版本管理系统，非常适合喜欢干净漂亮的提交历史的人和喜欢 Vibe Coding 的人。我自己在 Fediverse 上刷到它以后，装上使用了 Jujutsu 半个月，就已经完全离不开它了。Jujutsu 到底好在哪里呢？我觉得是非常灵活的提交管理方式和稳定的快照机制。</p> <p>你可以随心所欲地在任何一个你想在的提交上开始工作，可以随心所欲地去修改自己的提交历史，不管是拆分还是合并还是移动，Jujutsu 绝不会在你进行这些工作的时候跳出一堆冲突让你处理，或是让你手动处理分支的变基，不会打断工作的心流。合并和变基的冲突当然存在，但 Jujutsu 把他们放到后面去了，你可以在任何你想处理的时候去处理那些冲突，而不是每次操作都要马上处理冲突。</p> <p>快照机制保存了每次操作时当前提交的快照，且每次修改追踪的文件都会创建一个快照――用 Git 的方式来形容的话，就是每改一次文件都新建一个分支提交。所以，你永远不用担心手滑/手贱的自己、LLM Agent、闯进你房间的亲戚家小孩、不悦的机魂等各路神仙把你的仓库改得乱七八糟无法挽回，只需一行 <code>jj undo</code>，仓库便会回到原来的状态。</p> <p>例如我喜欢一次性修改许多功能，再通过暂存来拆分提交，有时候还会使用修补功能来小幅修改提交记录。使用 Git 时，一旦手滑把不该修补的东西加进去了，再想改回来就会很麻烦。而 Jujutsu 的 squash 和空提交功能，天生就是为我这种需求而生的。我可以在当前修改前面创建任意个空的提交，然后通过交互式的 squash 将各个不同的功能拆分到新建的提交中，并随时移动到拆分的提交中进行小修小补。</p> <p>不过目前而言，Jujutsu 也有一些痛点。比如自带的 jj graph 在特定场合下可阅读性相当差，尤其是在我的博客的分支中：</p> <p><a></a></p> <p>看到这一堆竖线，很难忍住不笑。我也尝试过 Jujutsu 的 GUI 版本 <a href="https://github.com/gulbanana/gg">GG</a>，graph 也是一模一样，还是一大堆竖线堆成一座高山。只有 VSCode 插件 <a href="https://marketplace.visualstudio.com/items?itemName=jjk.jjk">Jujutsu Kaizen</a> 的图像没那么抽象。而 VSCode 的 Git Graph 插件给出的提交图（Jujutsu 与 Git 提交同步）就很简洁直观明了：</p> <p><a></a></p> <p>这个问题确实是影响我用 Jujutsu 用得舒服的一大弊病。</p> <h2>迈向封闭<a href="#迈向封闭">#</a></h2> <p>8 月 25 日，<a href="https://www.androidauthority.com/android-developer-verification-requirements-3590911/">谷歌宣布了一个重磅的新政策</a>：2026 年中起，被安装或侧载的应用的开发者必须进行实名认证。谷歌宣称此举是为「让 Android 更安全」及「保护 Android 的开放环境」，政策将于 2026 年九月在部分地区（巴西、印尼、新加坡、泰国等）生效；后续将覆盖更多地区。</p> <p>结合此前 8 月 14 日<a href="https://bbs.oneplus.com/thread/1926504022886318086">一加宣布 ColorOS 16 系统将开始限制 Bootloader 解锁</a>^{<a href="#user-content-fn-2">2</a>}，7 月 26 日<a href="https://xdaforums.com/t/bootloader-unlocking-option-removed-from-one-ui-8-0.4751904/#post-90208099">三星在 One UI 8 中移除了 Bootloader 解锁选项</a>，这种事在短短一个月的时间里就上演了三次，迈向封闭已成大势所趋。</p> <p>我一个用着华为全家桶（除了电脑）的人，自是没有什么特别重的自由系统情结，换 Linux 系统也只是因为 Linux 的文件结构和开发体验更好。但看到所有大厂都在迈向封闭，还是有点不爽。之前 618 那会儿手机价格低的时候，有考虑过买个骁龙 8 Elite 处理器的一加安卓手机来折腾，但最后还是作罢；现在一看，8 Elite 这代怕不是安卓机最后的荣光了。8 Elite 还蹭到了高通 X Elite 的驱动和内核，或许过上两年，8 Elite 就会成为继 845 后又一个可以刷桌面系统的手机 CPU；过上五六年，还能看到不少 8 Elite 一代的「钉子户」。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p>准确地说，是支持（且目前仅支持）使用 Git 作为后端。 <a href="#user-content-fnref-1">↩</a></p> </li> <li> <p>此前一加是最后一个完全不限制 Bootloader 解锁的国内手机大厂品牌。 <a href="#user-content-fnref-2">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/1st-anniversary/https://blog.hpcesia.com/posts/1st-anniversary/小屋也算是迎来一周年纪念日了，真是可喜可贺可喜可贺。另：文章链接进行了大批量更新，此次应该是最后一次更新链接，如有打扰，非常抱歉。Tue, 19 Aug 2025 05:46:53 GMT<article> <p>小屋也算是迎来一周年纪念日了，真是可喜可贺可喜可贺。</p> <p>其实我自己早已记不清小屋到底是什么时间建的了，最早使用的主题的相关仓库都已经删掉了，没法通过查 commit 记录来获取时间，所以就用了小屋的发布时间来作为小屋的建立时间。</p> <p>这篇文章也是 7 月初就开了草稿――因为我知道自己有多能拖更 拖了多久了都，8 月再开坑包写不完的。开坑的契机则是看到首页侧边栏的建站时间已经变成了一年（dayjs 的相对时间默认逻辑似乎是满 10 个月就显示一年），才意识到已经建站快一周年了。</p> <h2>回望过去一年<a href="#回望过去一年">#</a></h2> <p>新的一年开始前，总得回头看看吧。有的博主会把过去一年以来的站点数据都搬上来，不过我在从 Hexo 迁移到 Astro 之后，直到最近部署了 GoatCounter 为止，将近半年的时间里没有使用网站统计工具，我之前用的自建 Unami 也把库都删了，所以这里没什么可以放的。不过也可以放一点 GoatCounter 一个月以来的访问统计数据：</p> <p><a></a></p> <p>第二名真是毫不意外，这种东西看的人就是多。第三名倒是有些小意外，没想到 Typst 会是第三名虽然和前两名有断崖般差距。从 GoutCounter 的操作系统统计数据来看，GoatCounter 统计到的大部分访问量应该都是活人贡献的，毕竟 AI 爬虫怎么想都会用 Linux 吧（）。</p> <p><a></a></p> <p>统计的部分到这里就差不多了，一个月的数据也没啥好看的，只写这么点东西也不够一篇文章的量，索性再详细聊聊里写过的东西吧。去年 8 月的暑假，抱着分享我辛辛苦苦写的的想法，先是去了 CSDN，结果我当时没有密码管理器，把以前注册的账号密码给忘了；然后去了博客园，结果当时博客园正处于困难阶段，到处筹钱，加上还要实名申请发博客的功能，也就放弃了这个选项；最后便盯上了独立博客，使用搜索引擎找到了静态博客里用得最多的 Hexo，挑了个还将就的主题 Fluid，便使用 GitHub Pages 搭建了这个博客，发布了我的。</p> <p>显然，这种专业性稍微强一点的东西，除了和我一样被计算数学折磨的冤种外，是没什么人看的。于是我就水了一个，顺便给博客加上了 Twikoo 评论系统，以及去 Bing 把博客给收录了（还）。</p> <p>Fluid 主题挺美观的，该有的什么 SEO 啊什么 PWA 啊都有，但一些花里胡哨的功能就比较欠缺了。在后，我决定换成一个自带更多花里胡哨功能的主题。Hexo 博客里，比较出名的就是<a href="https://blog.zhheo.com/">张洪Heo</a> 的了。我从<a href="https://blog.starsharbor.com/">星港</a>的主题链接了解到了 <a href="https://solitude.js.org/cn">Solitude</a> 主题，其效果足够炫酷，所以最终选择了这一主题。</p> <p>Solitude 主题的持久度比较高，我用了刚好半年时间（2024.09 - 2025.03）。刚开始对于这个主题我还是非常喜欢的，经过了一番简单的魔改，把它变成了<a href="https://solitude.blog-archive.hpcesia.com/">自己喜欢的样子</a>。但很快，Hexo 的弊病就暴露出来了。</p> <p>Hexo 是一个比较<em>古老</em>的静态站点框架――React 和 Hexo 是同一时代的产物，而 React 就是现代 Web 框架本身。所以，Hexo 使用的是现代 Web 框架以前的字符串拼接技术生成 HTML，并且至今也只支持直接使用 CommonJS。后者在 <a href="https://github.com/HPCesia/hexo-highlighter-shiki">hexo-highlighter-shiki</a> 的初步开发中给了我不小苦头，最后还是抄了别人的代码，靠 ESBuild 打包解决了问题。在和 Shiki 进行搏斗的时候，我在文档里看到 Astro 是默认使用 Shiki 进行代码高亮渲染的，所以心中也就种下了改用 Astro 写一个自己的博客主题的想法。</p> <p>真正付诸实践则是在 25 年的 1 月初，此时的我考研失败，只有毕业论文需要花时间，于是便开始鼓捣起了博客。当时的我对 Astro 几乎没有了解，对 TypeScript 的了解仅限于给 Solitude 魔改和贡献时的那一小点积累，从 GitHub 上拉了 <a href="https://github.com/saicaca/fuwari">Fuwari</a> 的源码下来就直接边抄边写边学，少量借用 LLM 补全，花费两个多月完成了一个基本可用的博客主题 <a href="https://codeberg.org/HPCesia/AstralHalo">Astral Halo</a>。</p> <p>在完成绝大部分需要的功能以后，博客的开发也就放慢了脚步（事实上，抛开周年纪念前的小装修不谈，上次修改博客源码已经是一个月前了）。博客文章也放慢了脚步，六月七月都是月更状态。并不是我没写东西，只是单纯没写完不能发出来，比如拖了大半年的的中下两篇其实都写了一半多点，还有另外两篇完成度比较高但是一直拖着没写完的文章没发。开的只有标题和一点点思路的坑也有四五个，没有整理和扩充的随笔草稿也一大堆，只是单纯的不想动。除去杂谈和经验以外，我还是希望写点新的东西的，比如找一个自己比较感兴趣又比较小众的东西，深挖一下历史，然后写出来，目前开的坑有：排版、终端、TSF^{<a href="#user-content-fn-1">1</a>} 作品。写完不一定会发出来，尤其是最后那个肯定是含 NSFW^{<a href="#user-content-fn-2">2</a>} 内容的，发出来需要做一些心理准备。</p> <h2>新的开始<a href="#新的开始">#</a></h2> <p>可能有人注意到了，小屋文章的永久链接不一样了。小屋最初使用 Hexo 的 abbrlink 插件，为每个文章生成随机字符串，作为永久链接使用。当时的考量是这样一来，修改标题也不会影响链接，不会导致标题和链接对不上。后来我才发现这是个伪需求――我压根不会去改已发布文章的标题，文章更新量也轮不到我费心思去想不重复的标题。所以正好在一周年之际，我把博客文章的永久链接换成了有意义的英文字符串。</p> <p>当然永久链接需要处理的事情也不能少――我在修改旧文章永久链接时，也加上了对旧永久链接的重定向，就像之前我更换博客主题并舍弃部分主题特定文章时那样。好在文章不算太多~~（拖更还骄傲上了）~~，花了一点时间挨个在 <code>astro.mjs</code> 里加上了路径重定向。此外，我还删掉了一些现在看来并无用处的和重复的标签，重新整理了一遍过去的文章。</p> <p>下一步准备使用 API 重构一下目前<a href="/posts/miscellaneous-notes-2/">使用 RSS 制作的 GoToSocial</a> 的<a href="/musings">碎语</a>页面，目前出于半成品状态，正在和一些 corner case 进行搏斗。此外还准备把图片灯箱^{<a href="#user-content-fn-3">3</a>}库从虽然超轻量但是功能太少不好用的 <a href="https://github.com/francoischalifour/medium-zoom">Medium Zoom</a> 换成 GoToSocial 前端也在用的 <a href="https://github.com/dimsemenov/photoswipe">PhotoSwipe</a>，以便适配修改后的<a href="/musings">碎语</a>页面，顺便还自动适配了 Artalk 的评论里的图片灯箱功能 虽然只有我能直接发图片。还有一个受<a href="https://i.myriad-dreamin.com/">纸夜姐姐</a>^{<a href="#user-content-fn-4">4</a>}启发的使用 Typst 来直接编写博客文章的想法，不过目前 Typst 的手机端编辑体验实在烂透了，暂时不做过多打算。</p> <p>此外，本站也正式<a href="https://github.com/HPCesia/blog-astral-halo-oss">开源</a>了。但这不是中文通常意义下的「开源」，而只是<em>公开网页构建必须源代码</em>。这意味着你可以从这份源代码中构建一个原封不动的本站同款站点，但你不会看到我在我自己博客站点分支中的实际提交，而是定期同步的、清理了与网站生产构建无关部分的提交。用这种方式来开放源代码获取，是因为我当初把草稿部分也纳入了 Git 管理，因此我的实际提交中包含不少我还没写完的草稿，这些内容我不想公开。公开则是因为我写了 GoToSocial 的贴文展示页面，而这部分代码我不准备放到 Astral Halo 的主线中。</p> <h2>后话<a href="#后话">#</a></h2> <p>这篇文章最后一行字编写于 2025-08-19 04:22:00 (UTC+8:00)，从七月初断断续续写到现在，只能说拖延症和死线冲刺还在发力。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p><strong>T</strong>rans <strong>S</strong>exual <strong>F</strong>iction/<strong>F</strong>antasy <a href="#user-content-fnref-1">↩</a></p> </li> <li> <p><strong>N</strong>ot <strong>S</strong>afe/<strong>S</strong>uitable <strong>F</strong>or <strong>W</strong>ork <a href="#user-content-fnref-2">↩</a></p> </li> <li> <p>指「点击图片放大查看」的功能 <a href="#user-content-fnref-3">↩</a></p> </li> <li> <p>Typst 最常用的 LSP <a href="https://github.com/Myriad-Dreamin/tinymist">tinymist</a> 的主要开发者 <a href="#user-content-fnref-4">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/miscellaneous-notes-2/https://blog.hpcesia.com/posts/miscellaneous-notes-2/Thu, 03 Jul 2025 10:17:56 GMT<article> <h2>Hello, Fediverse<a href="#hello-fediverse">#</a></h2> <p>最近在<a href="https://chlo.is/">小氯</a>的蛊惑下我搭建了一个 <a href="https://gotosocial.org/">GoToSocial</a> 实例，加入了联邦宇宙（Fediverse）。我是个起名废，所以实例的名字就在喜欢的二次元角色里面选了。在综合考虑喜爱程度、角色故事与联邦宇宙契合度和域名 hack 后，我选择的实例名称是 Trinnon――来自星穹铁道的<a href="https://mzh.moegirl.org.cn/%E7%BC%87%E5%AE%9D">缇宁</a>，域名则是根据选定的名字简单 hack 一下的 <a href="https://trin.one/">trin.one</a>。<a href="https://mzh.moegirl.org.cn/%E7%BC%87%E5%AE%9D">缇宁</a>的角色背景设定之一：分身千瓣，跨越门扉，在世界各地传信，也算是与联邦宇宙的概念略有契合。</p> <p>联邦宇宙这个概念，最初还是看<a href="https://www.eallion.com/">大大的小蜗牛</a>的文章了解到的。当时我还没买现在博客的域名，对联邦这个东西只觉得「看起来还行」，没啥特别想法。最近因为我自己 Memos 用法也是全部公开，加上用联邦实例还可以有人互动，所以就换成了 GoToSocial。</p> <p>在联邦宇宙里发贴文，目前最大感受是：写 <ruby>ALT<rp>(</rp><rt>Alternative Text</rt><rp>)</rp></ruby> 是真费劲，经常出现 ALT 比正文还长的情况。虽然也有 ALT bot 这种使用 AI 识别图像内容生成 ALT 文本的工具，但我还是更喜欢手写。不写其实也不是不行，因为反正也没几个人会看我发的贴文。</p> <p>我也在博客里做了个<a href="/musings">简单的 Fediverse 时间线展示页面</a>，目前用的是 GoToSocial 自带的 RSS 功能，将 RSS 处理为展示页面。但是这种方式不能正常地不显示某些东西，所以后续准备用 API 重构一次。</p> <h2>Hello, NixOS<a href="#hello-nixos">#</a></h2> <p>出于对 <a href="https://trin.one/@hpcesia/statuses/01JW6GKZJ7VKMJWDAEVDEBVCY9">WSL 的不满</a>，以及又双叒叕受到<a href="https://chlo.is/">小氯</a>的<a href="https://spect.im/@chlorine/statuses/01JW6J2SW73G193PZASAPRZ9TX">蛊惑</a>， 我把笔记本上原来装的 Windows 11 换成了 Windows 10 + <a href="https://nixos.org/">NixOS</a> 双系统。</p> <p>选择 NixOS，有几个原因。琪一是因为 NixOS 的包数量够多，即便去掉 Haskell 的一堆包，也仅次于 <a href="https://archlinux.org/">Arch Linux</a> 的包数量，并且也有类似 <a href="https://aur.archlinux.org/">AUR</a> 的 <a href="https://nur.nix-community.org/">NUR</a>；其二是因为决心换双系统的时候 <a href="https://typst-doc-cn.github.io/guide/">Typst 中文群</a>里正好在聊 NixOS，看着挺感兴趣的；其三是因为 Nix 的「环境只配一次」的卖点很对我胃口，换电脑的环境配置确实让人不爽；其四是因为 NixOS 的雪花标志很适合在中间放个蓝色系的二次元角色，比如<a href="https://mzh.moegirl.org.cn/%E7%90%AA%E9%9C%B2%E8%AF%BA">琪露诺</a>。</p> <p><a></a></p> <p>不过我对东方不熟，放<a href="https://mzh.moegirl.org.cn/%E7%90%AA%E9%9C%B2%E8%AF%BA">琪露诺</a>似乎不太合适。于是自己 P 了个自己喜欢的<ruby>蓝色系二次元角色<rp>(</rp><rt>格蕾修</rt><rp>)</rp></ruby>上去，效果还算不错。不过在用 fastfetch 的时候才发现，zellij 只支持 Sixel 终端图像协议，而 fastfetch 的 Sixel 版 logo 不能很好的显示透明背景，有点可惜。</p> <p><a></a></p> <h2>MCP<a href="#mcp">#</a></h2> <p>最近尝试用 Context7 这个 MCP 来加强 Roo Code + Copilot 的开发能力，不得不说，很猛。Context7 部分地解决了 LLM 出幻觉瞎编 API 或者调用老版本 API 的问题，对我这种喜欢用新东西的人来说很舒服。</p> <p>曾见过一种论调，认为 LLM 需要借助 MCP 才能正确完成一些任务，说明 LLM 还不够智能。但是人也不能立刻报出两个大数相乘的结果，需要借助计算器（MCP）或者心算（推理模型），正确使用工具本就是致力于「模仿人类行为」的人工智能应有的行为。</p> <h2>延毕<a href="#延毕">#</a></h2> <p>是的，虽然很突兀，但是，我要延毕了。</p> <h3>发生什么事了<a href="#发生什么事了">#</a></h3> <p>并不是因为毕业论文没写好。虽然我论文答辩答得很烂，但是结果多少还算是能看的。厦门大学有一个必修的学分，名为「创新学分」，其获取方式是：参加竞赛得奖、大创项目，或者获取专利。不幸的是，我只参加过一次数学建模竞赛，还没拿奖，而参加竞赛未获奖至多只能获得一个创新学分――毕业必修两个。结果就是，我的创新学分到月底还是不够，喜提延毕。</p> <h3>不走心的挣扎<a href="#不走心的挣扎">#</a></h3> <p>面对延毕，有些病急乱投医。在小红书上找到，隔壁经济学院有人用一个线上答题就能拿获奖证书的水货竞赛申请成功了学分，于是我也赶紧去参加并申报剩下的一个学分。很不幸，厦大数院笑话^{<a href="#user-content-fn-1">1</a>}又多了一个――我的申请被教秘打了回来：「该竞赛不在学校竞赛库中」。</p> <p>学院审查宽松是情分，严格是本分，也没啥好埋怨的。况且我自己的问题还很大。早在去年九月，我就意识到了创新学分的问题，并决定用软件著作权来水两个学分――然后写了两天代码就半途而废了。</p> <p>年前我也选择在网上购买一个软著来水学分，但是很不幸的是，这个软著没有顺利下证。虽然商家退款了，但在五月底，创新学分的认定就截止了，而各种专利和软著最快也要一个月才能拿证――但凡我去年坚持写完一个软件，也不会闹成现在这样。实际上，我从今年年初开始写的目前在用着的博客主题，到现在分量已经完全足够申请软著了，但时间上已经来不及了。</p> <h3>接下来？<a href="#接下来">#</a></h3> <p>延毕这事对我的实际影响其实不是很大。因为各种工作所需经验都很匮乏（比如前端刚需 Vue 经验，而我的水平约等于培训班两天），我本就将「回家认真复习，再战一次考研」放在了找不到工作的备选项中，而现在不过是把备选项变成了必选项罢了。在就业市场竞争越发激烈的当下，我不幸地选择了大部分人读了都没啥用的数学专业，属实有些难受。但幸运地是我有一个还算富裕的家庭，能够为我提供一个兜底的选择，也不缺我刚出来工作能挣的那点钱。</p> <p>每年的十二月还有一次毕业认定机会，我也就差点创新学分，完全可以不用待在学校上课，只要把现在的博客主题申请一下软著或者买一个软著就行了。理论上还可以利用延毕的时间刷实习经历，不过我更想通过读研来逃避就业问题。</p> <p>因为只差创新学分没有拿，我大概率是不需要再回学校待上一整个学期了。这段时间，就待在家里安静再次备考考研了。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p>参看知乎问题：<a href="https://www.zhihu.com/question/666296682">「如何看待厦门大学数学科学学院 2024 年毕业生去向？」</a>。题主虽然因为深受厦大数院所害（在大三下转外语专业跑路了），情绪很大，但厦大数院的「严格」还是可见一斑。不幸的是，我为 25 届学生的毕业率「添砖加瓦」了。 <a href="#user-content-fnref-1">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/solve-vscode-write-settings-in-nixos-home-manager/https://blog.hpcesia.com/posts/solve-vscode-write-settings-in-nixos-home-manager/Mon, 16 Jun 2025 07:02:21 GMT<article> <div><div>更新日志</div><div><ul> <li>2025-08-15 <ul> <li>更新为更完善的版本</li> </ul> </li> <li>2025-06-16 <ul> <li>发布文章。</li> </ul> </li> </ul></div></div> <p>如果使用 Home Manager 配置 VSCode 的设置的话，因为 VSCode 启动时会写入 settings.json，导致每次打开 VSCode 都会弹出一个 settings.json 无法保存的弹窗。最简单的解决方案是直接不用 Nix 配置 VSCode。好处是简单粗暴，但是这样就需要用其他方法管理 VSCode 的配置了，和 Nix 的哲学不符。</p> <p>通过搜索，我找到了一个 21 年的相关 issue <a href="https://github.com/nix-community/home-manager/issues/1800">#1800</a>，里面获赞最多的是一个 <a href="https://gist.github.com/piousdeer/b29c272eaeba398b864da6abf6cb5daa">gist</a>，给出了一个模块，可以让 <code>home.file</code> 引入的文件变得可写。但是我更想使用 Home Manager 提供的 <code>profile</code> 选项来配置我的 VSCode，于是我注意到了该 issue 下还有一个比较简短的<a href="https://github.com/nix-community/home-manager/issues/1800#issuecomment-853589961">评论</a>，给出了第三种解决方案的可能。</p> <p>显然，一条 21 年的评论里的代码是没法直接用的，于是我顺藤摸瓜找到了<a href="https://github.com/kamadorueda/machine">评论者的 Nix 配置仓库</a>（顺带一提，这位也是一个相当好用的 Nix 格式化软件 <a href="https://github.com/kamadorueda/alejandra">Alejandra</a> 的作者），在里面找到了他最新的 <a href="https://github.com/kamadorueda/machine/blob/0c61ad9d7ce988d81c4180a4d4b630d27b53a7e5/nixos-modules/editor/default.nix">VSCode 配置代码</a>。简单总结一下，就是改了一下 VSCode 的配置和扩展文件存储位置，再在开机时清理掉该位置的文件，把 Home Manager 生成的配置和扩展文件复制过去。这种方法既可以避免弹窗，还快速调试 VSCode 的配置，而不需要改一两行配置就要 <code>nix-rebuild</code>；同时也保证了 Nix 配置的稳定性。</p> <p>但是由于用到了这位作者自己定义的一些库，并且他也不是为了 Home Manager 管理的配置编写的，这个配置代码也是不能直接用的。我这里给一个我的 NixOS 25.05 版本的 Home Manager 模块配置，以供参考：</p> <div><div>第一版</div><div><div><figure><figcaption><span>./home/linux/gui/vscode.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>config</span><span>,</span></div></div><div><div><div>3</div></div><div><span> </span><span>lib</span><span>,</span></div></div><div><div><div>4</div></div><div><span> </span><span>pkgs</span><span>,</span></div></div><div><div><div>5</div></div><div><span> </span><span>...</span></div></div><div><div><div>6</div></div><div><span>}:</span><span> </span><span>let</span></div></div><div><div><div>7</div></div><div><span> </span><span>inherit</span><span> </span><span>(</span><span>lib</span><span>.</span><span>lists</span><span>)</span><span> </span><span>concatLists</span><span>;</span></div></div><div><div><div>8</div></div><div> </div></div><div><div><div>9</div></div><div><span> </span><span>homeDir</span><span> </span><span>=</span><span> config</span><span>.</span><span>home</span><span>.</span><span>homeDirectory</span><span>;</span></div></div><div><div><div>10</div></div><div><span> </span><span>userDataDir</span><span> </span><span>=</span><span> </span><span>"</span><span>${</span><span>homeDir</span><span>}</span><span>/.data/vscode/data"</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span>extensionsDir</span><span> </span><span>=</span><span> </span><span>"</span><span>${</span><span>homeDir</span><span>}</span><span>/.data/vscode/extensions"</span><span>;</span></div></div><div><div><div>12</div></div><div> </div></div><div><div><div>13</div></div><div><span> </span><span>pkg</span><span> </span><span>=</span><span> pkgs</span><span>.</span><span>vscode</span><span>.</span><span>override </span><span>{</span></div></div><div><div><div>14</div></div><div><span> </span><span>commandLineArgs</span><span> </span><span>=</span><span> concatLists </span><span>[</span></div></div><div><div><div>15</div></div><div><span> </span><span>[</span><span>"--extensions-dir"</span><span> extensionsDir</span><span>]</span></div></div><div><div><div>16</div></div><div><span> </span><span>[</span><span>"--user-data-dir"</span><span> userDataDir</span><span>]</span></div></div><div><div><div>17</div></div><div><span> </span><span>];</span></div></div><div><div><div>18</div></div><div><span> </span><span>};</span></div></div><div><div><div>19</div></div><div><span>in</span><span> </span><span>{</span></div></div><div><div><div>20</div></div><div><span> </span><span>imports</span><span> </span><span>=</span><span> </span><span>[</span><span>./profiles</span><span>];</span></div></div><div><div><div>21</div></div><div> </div></div><div><div><div>22</div></div><div><span> </span><span>programs</span><span>.</span><span>vscode</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>23</div></div><div><span> </span><span>enable</span><span> </span><span>=</span><span> </span><span>true</span><span>;</span></div></div><div><div><div>24</div></div><div><span> </span><span>package</span><span> </span><span>=</span><span> pkg</span><span>;</span></div></div><div><div><div>25</div></div><div><span> </span><span>mutableExtensionsDir</span><span> </span><span>=</span><span> </span><span>false</span><span>;</span></div></div><div><div><div>26</div></div><div><span> </span><span>};</span></div></div><div><div><div>27</div></div><div> </div></div><div><div><div>28</div></div><div><span> </span><span># To solve VSCode wants to write settings.json</span></div></div><div><div><div>29</div></div><div><span> </span><span># VSCode will reset per reboot/rebuild.</span></div></div><div><div><div>30</div></div><div><span> </span><span>systemd</span><span>.</span><span>user</span><span>.</span><span>services</span><span>.</span><span>vscode-setup</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>31</div></div><div><span> </span><span>Unit</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>32</div></div><div><span> </span><span>Description</span><span> </span><span>=</span><span> </span><span>"VSCode Setup service"</span><span>;</span></div></div><div><div><div>33</div></div><div><span> </span><span>After</span><span> </span><span>=</span><span> </span><span>[</span><span>"graphical-session-pre.target"</span><span>];</span></div></div><div><div><div>34</div></div><div><span> </span><span>Wants</span><span> </span><span>=</span><span> </span><span>[</span><span>"graphical-session-pre.target"</span><span>];</span></div></div><div><div><div>35</div></div><div><span> </span><span>};</span></div></div><div><div><div>36</div></div><div><span> </span><span>Install</span><span>.</span><span>WantedBy</span><span> </span><span>=</span><span> </span><span>[</span><span>"graphical-session.target"</span><span>];</span></div></div><div><div><div>37</div></div><div><span> </span><span>Service</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>38</div></div><div><span> </span><span>Type</span><span> </span><span>=</span><span> </span><span>"oneshot"</span><span>;</span></div></div><div><div><div>39</div></div><div><span> </span><span>ExecStart</span><span> </span><span>=</span><span> lib</span><span>.</span><span>getExe </span><span>(</span><span>pkgs</span><span>.</span><span>writeShellApplication </span><span>{</span></div></div><div><div><div>40</div></div><div><span> </span><span>name</span><span> </span><span>=</span><span> </span><span>"vscode-setup"</span><span>;</span></div></div><div><div><div>41</div></div><div><span> </span><span>text</span><span> </span><span>=</span><span> </span><span>''</span></div></div><div><div><div>42</div></div><div><span><span> </span></span><span>rm -rf "</span><span>${</span><span>userDataDir</span><span>}</span><span>/User"</span></div></div><div><div><div>43</div></div><div><span><span> </span></span><span>rm -rf "</span><span>${</span><span>extensionsDir</span><span>}</span><span>"</span></div></div><div><div><div>44</div></div><div> </div></div><div><div><div>45</div></div><div><span><span> </span></span><span>mkdir -p "</span><span>${</span><span>userDataDir</span><span>}</span><span>"</span></div></div><div><div><div>46</div></div><div><span><span> </span></span><span>mkdir -p "</span><span>${</span><span>extensionsDir</span><span>}</span><span>"</span></div></div><div><div><div>47</div></div><div> </div></div><div><div><div>48</div></div><div><span><span> </span></span><span>cp -r --dereference --no-preserve=mode,ownership \</span></div></div><div><div><div>49</div></div><div><span><span> </span></span><span>"</span><span>${</span><span>homeDir</span><span>}</span><span>/.config/Code/User" "</span><span>${</span><span>userDataDir</span><span>}</span><span>/User"</span></div></div><div><div><div>50</div></div><div><span><span> </span></span><span>cp -r --dereference --no-preserve=mode,ownership \</span></div></div><div><div><div>51</div></div><div><span><span> </span></span><span>"</span><span>${</span><span>homeDir</span><span>}</span><span>/.vscode/extensions/." "</span><span>${</span><span>extensionsDir</span><span>}</span><span>"</span></div></div><div><div><div>52</div></div><div><span><span> </span></span><span>''</span><span>;</span></div></div><div><div><div>53</div></div><div><span> </span><span>});</span></div></div><div><div><div>54</div></div><div><span> </span><span>};</span></div></div><div><div><div>55</div></div><div><span> </span><span>};</span></div></div><div><div><div>56</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div></div></div> <p>第一版缺陷很多，所以我编写了第二版：</p> <div><figure><figcaption><span>./home/linux/gui/vscode.nix</span></figcaption><pre><code><div><div><div>1</div></div><div><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>config</span><span>,</span></div></div><div><div><div>3</div></div><div><span> </span><span>lib</span><span>,</span></div></div><div><div><div>4</div></div><div><span> </span><span>pkgs</span><span>,</span></div></div><div><div><div>5</div></div><div><span> </span><span>...</span></div></div><div><div><div>6</div></div><div><span>}:</span><span> </span><span>let</span></div></div><div><div><div>7</div></div><div><span> </span><span>homeDir</span><span> </span><span>=</span><span> config</span><span>.</span><span>home</span><span>.</span><span>homeDirectory</span><span>;</span></div></div><div><div><div>8</div></div><div><span> </span><span>dataDir</span><span> </span><span>=</span><span> config</span><span>.</span><span>xdg</span><span>.</span><span>dataHome</span><span>;</span></div></div><div><div><div>9</div></div><div><span> </span><span>userDataDir</span><span> </span><span>=</span><span> </span><span>"</span><span>${</span><span>dataDir</span><span>}</span><span>/vscode/data"</span><span>;</span></div></div><div><div><div>10</div></div><div><span> </span><span>extensionsDir</span><span> </span><span>=</span><span> </span><span>"</span><span>${</span><span>dataDir</span><span>}</span><span>/vscode/extensions"</span><span>;</span></div></div><div><div><div>11</div></div><div><span>in</span><span> </span><span>{</span></div></div><div><div><div>12</div></div><div><span> </span><span>programs</span><span>.</span><span>vscode</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>13</div></div><div><span> </span><span>enable</span><span> </span><span>=</span><span> </span><span>true</span><span>;</span></div></div><div><div><div>14</div></div><div><span> </span><span>mutableExtensionsDir</span><span> </span><span>=</span><span> </span><span>false</span><span>;</span></div></div><div><div><div>15</div></div><div><span> </span><span>};</span></div></div><div><div><div>16</div></div><div> </div></div><div><div><div>17</div></div><div><span> </span><span># To solve VSCode wants to write settings.json</span></div></div><div><div><div>18</div></div><div><span> </span><span># VSCode will reset per reboot/rebuild.</span></div></div><div><div><div>19</div></div><div><span> </span><span>systemd</span><span>.</span><span>user</span><span>.</span><span>services</span><span>.</span><span>vscode-setup</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>20</div></div><div><span> </span><span>Unit</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>21</div></div><div><span> </span><span>Description</span><span> </span><span>=</span><span> </span><span>"VSCode Setup service"</span><span>;</span></div></div><div><div><div>22</div></div><div><span> </span><span>After</span><span> </span><span>=</span><span> </span><span>[</span><span>"graphical-session-pre.target"</span><span>];</span></div></div><div><div><div>23</div></div><div><span> </span><span>Wants</span><span> </span><span>=</span><span> </span><span>[</span><span>"graphical-session-pre.target"</span><span>];</span></div></div><div><div><div>24</div></div><div><span> </span><span>};</span></div></div><div><div><div>25</div></div><div><span> </span><span>Install</span><span>.</span><span>WantedBy</span><span> </span><span>=</span><span> </span><span>[</span><span>"graphical-session.target"</span><span>];</span></div></div><div><div><div>26</div></div><div><span> </span><span>Service</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>27</div></div><div><span> </span><span>Type</span><span> </span><span>=</span><span> </span><span>"oneshot"</span><span>;</span></div></div><div><div><div>28</div></div><div><span> </span><span>UMask</span><span> </span><span>=</span><span> </span><span>"0022"</span><span>;</span></div></div><div><div><div>29</div></div><div><span> </span><span>ExecStart</span><span> </span><span>=</span><span> lib</span><span>.</span><span>getExe </span><span>(</span><span>pkgs</span><span>.</span><span>writeShellApplication </span><span>{</span></div></div><div><div><div>30</div></div><div><span> </span><span>name</span><span> </span><span>=</span><span> </span><span>"vscode-setup"</span><span>;</span></div></div><div><div><div>31</div></div><div><span> </span><span>runtimeInputs</span><span> </span><span>=</span><span> </span><span>with</span><span> pkgs; </span><span>[</span><span>coreutils gnutar jq</span><span>];</span></div></div><div><div><div>32</div></div><div><span> </span><span>text</span><span> </span><span>=</span><span> </span><span>let</span></div></div><div><div><div>33</div></div><div><span> </span><span>userSrc</span><span> </span><span>=</span><span> </span><span>"</span><span>${</span><span>homeDir</span><span>}</span><span>/.config/Code/User"</span><span>;</span></div></div><div><div><div>34</div></div><div><span> </span><span>userDst</span><span> </span><span>=</span><span> </span><span>"</span><span>${</span><span>userDataDir</span><span>}</span><span>/User"</span><span>;</span></div></div><div><div><div>35</div></div><div><span> </span><span>extSrc</span><span> </span><span>=</span><span> </span><span>"</span><span>${</span><span>homeDir</span><span>}</span><span>/.vscode/extensions"</span><span>;</span></div></div><div><div><div>36</div></div><div><span> </span><span>extDst</span><span> </span><span>=</span><span> extensionsDir</span><span>;</span></div></div><div><div><div>37</div></div><div> </div></div><div><div><div>38</div></div><div><span> </span><span>dirsToPreserve</span><span> </span><span>=</span><span> </span><span>[</span></div></div><div><div><div>39</div></div><div><span> </span><span>"workspaceStorage"</span></div></div><div><div><div>40</div></div><div><span> </span><span>"History"</span></div></div><div><div><div>41</div></div><div><span> </span><span>];</span></div></div><div><div><div>42</div></div><div><span> </span><span>backupCmds</span><span> </span><span>=</span><span> </span><span>builtins</span><span>.</span><span>concatStringsSep </span><span>"</span><span>\n</span><span>"</span><span> </span><span>(</span><span>map</span><span> </span><span>(</span><span>dir</span><span>:</span><span> </span><span>''</span></div></div><div><div><div>43</div></div><div><span><span> </span></span><span>if [ -e "</span><span>${</span><span>userDst</span><span>}</span><span>/</span><span>${</span><span>dir</span><span>}</span><span>" ]; then</span></div></div><div><div><div>44</div></div><div><span><span> </span></span><span>echo "Backing up data/User/</span><span>${</span><span>dir</span><span>}</span><span>..."</span></div></div><div><div><div>45</div></div><div><span><span> </span></span><span>mv "</span><span>${</span><span>userDst</span><span>}</span><span>/</span><span>${</span><span>dir</span><span>}</span><span>" "/tmp/vscode-</span><span>${</span><span>dir</span><span>}</span><span>-$$"</span></div></div><div><div><div>46</div></div><div><span><span> </span></span><span>fi</span></div></div><div><div><div>47</div></div><div><span><span> </span></span><span>''</span><span>)</span></div></div><div><div><div>48</div></div><div><span> </span><span>(</span><span>dirsToPreserve </span><span>++</span><span> </span><span>[</span><span>"globalStorage"</span><span>]));</span></div></div><div><div><div>49</div></div><div><span> </span><span>restoreCmds</span><span> </span><span>=</span><span> </span><span>builtins</span><span>.</span><span>concatStringsSep </span><span>"</span><span>\n</span><span>"</span><span> </span><span>(</span><span>map</span><span> </span><span>(</span><span>dir</span><span>:</span><span> </span><span>''</span></div></div><div><div><div>50</div></div><div><span><span> </span></span><span>if [ -e "/tmp/vscode-</span><span>${</span><span>dir</span><span>}</span><span>-$$" ]; then</span></div></div><div><div><div>51</div></div><div><span><span> </span></span><span>echo "Restoring data/User/</span><span>${</span><span>dir</span><span>}</span><span>..."</span></div></div><div><div><div>52</div></div><div><span><span> </span></span><span>mv "/tmp/vscode-</span><span>${</span><span>dir</span><span>}</span><span>-$$" "</span><span>${</span><span>userDst</span><span>}</span><span>/</span><span>${</span><span>dir</span><span>}</span><span>"</span></div></div><div><div><div>53</div></div><div><span><span> </span></span><span>fi</span></div></div><div><div><div>54</div></div><div><span><span> </span></span><span>''</span><span>)</span></div></div><div><div><div>55</div></div><div><span><span> </span></span><span>dirsToPreserve</span><span>);</span></div></div><div><div><div>56</div></div><div><span> </span><span>in</span><span> </span><span>''</span></div></div><div><div><div>57</div></div><div><span><span> </span></span><span>set -eu</span></div></div><div><div><div>58</div></div><div> </div></div><div><div><div>59</div></div><div><span> </span><span>${</span><span>backupCmds</span><span>}</span></div></div><div><div><div>60</div></div><div> </div></div><div><div><div>61</div></div><div><span><span> </span></span><span>echo "Cleaning old directories..."</span></div></div><div><div><div>62</div></div><div><span><span> </span></span><span>rm -rf "</span><span>${</span><span>userDst</span><span>}</span><span>"</span></div></div><div><div><div>63</div></div><div><span><span> </span></span><span>rm -rf "</span><span>${</span><span>extDst</span><span>}</span><span>"</span></div></div><div><div><div>64</div></div><div> </div></div><div><div><div>65</div></div><div><span><span> </span></span><span>mkdir -p "</span><span>${</span><span>userDataDir</span><span>}</span><span>"</span></div></div><div><div><div>66</div></div><div><span><span> </span></span><span>mkdir -p "</span><span>${</span><span>extDst</span><span>}</span><span>"</span></div></div><div><div><div>67</div></div><div> </div></div><div><div><div>68</div></div><div><span><span> </span></span><span>echo "Copying user settings from </span><span>${</span><span>userSrc</span><span>}</span><span>..."</span></div></div><div><div><div>69</div></div><div><span><span> </span></span><span>cp -r --dereference --no-preserve=mode,ownership </span><span>${</span><span>userSrc</span><span>}</span><span> "</span><span>${</span><span>userDst</span><span>}</span><span>"</span></div></div><div><div><div>70</div></div><div> </div></div><div><div><div>71</div></div><div><span><span> </span></span><span>echo "Copying extensions from </span><span>${</span><span>extSrc</span><span>}</span><span>..."</span></div></div><div><div><div>72</div></div><div><span><span> </span></span><span>tar -h -C "</span><span>${</span><span>extSrc</span><span>}</span><span>" -cf - . | tar -C "</span><span>${</span><span>extDst</span><span>}</span><span>" -xf - --no-same-owner --no-same-permissions --mode='u=rX,go=rX'</span></div></div><div><div><div>73</div></div><div><span><span> </span></span><span>chmod u+w -R "</span><span>${</span><span>extDst</span><span>}</span><span>" 2&gt;/dev/null || true</span></div></div><div><div><div>74</div></div><div> </div></div><div><div><div>75</div></div><div><span> </span><span>${</span><span>restoreCmds</span><span>}</span></div></div><div><div><div>76</div></div><div> </div></div><div><div><div>77</div></div><div><span><span> </span></span><span>echo "Restoring and merging data/User/globalStorage..."</span></div></div><div><div><div>78</div></div><div><span><span> </span></span><span>if [ -e "/tmp/vscode-globalStorage-$$" ]; then</span></div></div><div><div><div>79</div></div><div><span><span> </span></span><span>cp -rT "/tmp/vscode-globalStorage-$$" "</span><span>${</span><span>userDst</span><span>}</span><span>/globalStorage"</span></div></div><div><div><div>80</div></div><div> </div></div><div><div><div>81</div></div><div><span><span> </span></span><span>src_storage_json="</span><span>${</span><span>userSrc</span><span>}</span><span>/globalStorage/storage.json"</span></div></div><div><div><div>82</div></div><div><span><span> </span></span><span>dst_storage_json="</span><span>${</span><span>userDst</span><span>}</span><span>/globalStorage/storage.json"</span></div></div><div><div><div>83</div></div><div> </div></div><div><div><div>84</div></div><div><span><span> </span></span><span>if [ -f "$src_storage_json" ] &amp;&amp; [ -f "$dst_storage_json" ]; then</span></div></div><div><div><div>85</div></div><div><span><span> </span></span><span>echo "Merging data/globalStorage/storage.json with new data..."</span></div></div><div><div><div>86</div></div><div><span><span> </span></span><span>merged_json=$(mktemp)</span></div></div><div><div><div>87</div></div><div><span><span> </span></span><span>jq -s '.[0] * .[1]' "$dst_storage_json" "$src_storage_json" &gt; "$merged_json"</span></div></div><div><div><div>88</div></div><div><span><span> </span></span><span>mv "$merged_json" "$dst_storage_json"</span></div></div><div><div><div>89</div></div><div><span><span> </span></span><span>echo "Merge complete."</span></div></div><div><div><div>90</div></div><div><span><span> </span></span><span>else</span></div></div><div><div><div>91</div></div><div><span><span> </span></span><span>echo "Skipping storage.json merge: one or both files do not exist."</span></div></div><div><div><div>92</div></div><div><span><span> </span></span><span>fi</span></div></div><div><div><div>93</div></div><div><span><span> </span></span><span>else</span></div></div><div><div><div>94</div></div><div><span><span> </span></span><span>echo "No backed-up globalStorage found to restore."</span></div></div><div><div><div>95</div></div><div><span><span> </span></span><span>fi</span></div></div><div><div><div>96</div></div><div> </div></div><div><div><div>97</div></div><div><span><span> </span></span><span>echo "VSCode setup complete."</span></div></div><div><div><div>98</div></div><div><span><span> </span></span><span>''</span><span>;</span></div></div><div><div><div>99</div></div><div><span> </span><span>});</span></div></div><div><div><div>100</div></div><div><span> </span><span>};</span></div></div><div><div><div>101</div></div><div><span> </span><span>};</span></div></div><div><div><div>102</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>你也可以直接查看<a href="https://codeberg.org/HPCesia/nix-config">我的 Nix 配置文件仓库</a>。</p> </article> https://blog.hpcesia.com/posts/notes-of-starrail-land/https://blog.hpcesia.com/posts/notes-of-starrail-land/Fri, 23 May 2025 11:43:29 GMT<article> <p>这是 2024 年五一假期期间居然都是一年前的事了吗，我前往上海参加<a href="https://act.mihoyo.com/puzzle/hkrpg/pz_IGTUvZSn2l/index.html">星铁 LAND 活动</a>的旅行回忆。这也是旅行回忆这个分类里的第二篇文章。塞尔维亚的中篇在写了在写了</p> <h2>Day1 - 赶路休整与群友与 KTV<a href="#day1---赶路休整与群友与-ktv">#</a></h2> <p>由于买的是 5 月 4 日的门票，所以我决定 5 月 2 日再出发前往上海。5 月 2 日一早，我便坐上了前往上海的火车。一路上，我基本都是在小桌板上用笔记本打绝区零的三测，打累了就写计算机辅助几何设计这门课程的期末大作业放松（?）一下。</p> <p><a></a></p> <p>6 个小时的火车旅程并不算长，很快，我就成功到达上海虹桥火车站。出火车站的时候就看到了不少穿着 cos 服进站的人；刚进入火车站的地铁，又看到了一大群提着星铁 LAND 袋子的乘客。想必这些大都是参加完当天的星铁 LAND，准备坐火车/飞机回家的人。</p> <p><a></a></p> <p>到达住处后躺了大半小时，接到了同在上海的群友^{<a href="#user-content-fn-1">1</a>}<em>红白</em>的邀请，前往南京路逛步行街。逛街过程说不上美好，因为人太多了，五一假期常态了属于是。本来<em>红白</em>想去线下买点周边的，但排了半天队进了大楼以后，发现里面商店买周边还得继续排队，只能放弃这个打算。</p> <p>随后又接到了来着另一个群友<em>天使羊</em>的邀请，前往纯 K 和几个参加了第一天星铁 LAND 的群友一起唱歌。由于先前逛步行街拖了不少时间，等我和<em>红白</em>到达 KTV 的时候，几个要赶当天飞机/火车的群友正准备离开，算是一点小小的遗憾。</p> <p><a></a></p> <p>以一首<a href="https://music.163.com/#/song?id=1480344409">《未来再见》</a>为结尾，聚众 K 歌环节算是圆满结束。虽然我会唱的歌数量不多，但唱完下来，嗓子还是有点累的。<em>天使羊</em>作为发起者实力相当强悍，作为唯一的女生也是直接霸占大部分高音环节；<em>红白</em>倒是没怎么唱，一直推脱不会唱歌。</p> <p>从纯 K 出来，和几个群友对付了一顿晚饭，今天就算到此为止，回去打打游戏睡觉。</p> <h2>Day2 - 米哈游大楼与崩三线下活动<a href="#day2---米哈游大楼与崩三线下活动">#</a></h2> <p>前一天晚上一不留神打游戏打到了凌晨四点，但不管怎样，今天还是得出来逛的。早上十点，我从住处出发，前往米哈游的光启园总部参观。</p> <p>中午十一点半，我来到了光启园的外面。从地铁站出来的时候，还碰到个穿着米哈游工服的小姐姐，站在树荫下发着微信。一进园区，就看到了米哈游的楼下排着的长队。所幸队伍看着长，但排起来却很快，不到十分钟，我便踏入了米哈游总部大楼。</p> <p><a></a></p> <p>一进门，最显眼的就是各种大型周边了，比如看起来应该是 1:2 比例的七天神像，袖珍版的正机之神上半身等。</p> <p><a></a></p> <p><a></a></p> <p>当然也有等比的可爱猫猫糕。</p> <p><a></a></p> <p>除去这些大型周边外，还有琳琅满目的各种正常大小周边。</p> <p><a></a></p> <p>因为只开发一楼大厅参观，本身大小也不算大，大概逛个不到十分钟，米哈游就算逛完了。从米哈游大楼出来，下一站则是崩坏三在上海美罗城的线下快闪活动。</p> <p><a></a></p> <p>虽说只用集三个章就可以领集章奖励，但是嘛，「来都来了」，不是吗？当然得全部打卡地点都走一遍才行！</p> <p><a></a></p> <p>快闪活动的打卡地点附加有很多前来参加活动的普通玩家 coser，当然也有官方请来负责让大伙拍照的高质量 coser。</p> <p><a></a></p> <p>暴走一个小时，把所有打卡地点都走了一遍后，总算是可以回到开始的地方抽取集章奖励。当时运气比较一般，只抽到一张合影卡^{<a href="#user-content-fn-2">2</a>}。不过值得一提的是，有一个打卡地点的打卡要求是在社交平台发布带打卡地点照片和活动 tag 的动态，而这刚好也是 B 站上一个抽奖活动的参与要求。我的意思是――<em>你怎么知道我那个动态中奖了？</em>(*´ω｀*)</p> <p><a></a></p> <p>咳咳，言归正传。领完奖励，正好旁边也有不少群友在坐着休息，于是我也跟着凑过去蹲着玩会儿手机。玩到了下午两点，赶紧跟着大部队一起去线下音乐演出的地方占位置。但赶到的时候还是稍微晚了点，没能挤到最好的位置，只能在稍微靠边的点的位置占到最前排。</p> <p><a></a></p> <p>听完演出，我又跟着大部队回到领奖的地方附加坐着。附近有与线下活动同期开放的崩坏三线下周边快闪店，本来我是不打算进去逛的，但正巧有个群友（印象里应该是<em>红白</em>，但记不清了）预约了两个时间段的快闪店名额，已经逛过一遍了，我也就用着群友的名额进去逛了逛。逛线下周边店的结果嘛……当然是新周边喜加 N 了。</p> <p><a></a></p> <p>逛完又坐了十来分钟，实在是饿得不行了，下楼去肯德基对付了一顿。好在已是下午三点半，人不算太多――至少我还有位置可坐。</p> <p>吃完迟到的午饭，我也不想再多跑几轮打卡地点多抽几次周边了。正好离美罗城不算远的地方，有一个米游社的线下快闪周边店，我也就跑去那边看看有没有别的周边可以看看。结果嘛，到了地方才发现，人实在是太多了，只好放弃这个想法。连给米哈游送钱的机会都没有</p> <p>简单逛上一圈后，我和几个群友前往附近的一家自助烤肉聚餐。当时还在上交读书的群友<em>蓝老师</em>也被<em>红白</em>拉过来一起吃饭了。</p> <p><a></a></p> <p>烤肉没太多好说的，很常规的自助烤肉体验。吃完饭，有几个比较急着赶路的群友先行离开了，剩下的几个人则是跑到了深空之锚前面合影――就是上面那张 coser 照片背后的摆设。</p> <h2>Day3 - 星铁LAND!!!<a href="#day3---星铁land">#</a></h2> <p>很不幸地，前一天晚上又没睡好觉，大概是<a href="/posts/weekly-journal-2/">小学生春游综合症</a>犯了吧。不过这三天其实都只睡了三四个小时就是了什么大学生特种兵。</p> <p>总之勉强从两点睡到了早上五点，就被闹钟吵起来了。一起床，我就先在外卖上买了个小折叠凳，免得今天一天都要站着等到脚麻。等待外卖送达的时候吃了点昨天买好的面包当早餐，再收拾了一下要带进场馆的袋子，便出门拿着外卖送来的凳子出发，前往半公里外的国家会展中心。</p> <p>本以为早上六点来排队已经算早的了，没想到一到会场，已是一大群人在排队了。</p> <p><a></a></p> <p>从 6 点 等到 8 点，终于开始正式入场了。来之前就问了参加了前两天星铁 LAND 的群友，知道了一个不第一时间去排队就几乎不可能再排到的项目：匹诺康尼 VR 游览。</p> <p>说不可能排到，是因为这个项目体验很好的同时，单次只能容纳 10 人游玩（其中有 5 个是靠运气抽的快速体验票的位置），每轮包含上下设备的时间需要五分钟。所以，只有第一时间前往排队，才能在两个小时以内玩到这个项目。于是从安检开始我便是一路狂奔，总算是赶在比较靠前的位置，排在了 VR 项目的队伍中。</p> <p>好在虽然不是特别靠前，但我来得也算够早。排了一个半小时后，我总算来到了队伍的最前端。</p> <p><a></a></p> <p>在等待我前面一批人游玩项目的时候，跟我同一批的几个人还顺便和一旁的志愿者小姐姐聊了聊星铁 LAND 第一天的乱象。听小姐姐说，第一天的时候，上午是半天不开检票口的，伴手礼是缺周边的，排队也很少有工作人员来维持秩序；前一天志愿者招募的时候，还闹出了一大群志愿者等几个小时，结果被工作人员放鸽子的闹剧。</p> <p>聊了一会儿，前一批体验完了，终于轮到了我。VR 的体验相当不错，实际上是 VR + 体感椅子 + <a href="https://mzh.moegirl.org.cn/%E6%B5%81%E8%90%A4">流萤</a>的 ASMR。反正我是一脸傻笑地走出来的</p> <p>从 VR 项目出来，就不用考虑买官方的场贩周边了――排队的人和 VR 项目一样多，搞不好得下午四点才能排到。伴手礼中有一个纪念票，可以通过游玩项目来集章兑换一个小周边盲盒，所以我也就到处找找人比较少的项目排队集章，排累了就到处转悠看看场馆布设。下面就随便放点图吧。</p> <p><a></a></p> <p>特别大的三只猫猫糕，看起来应该是充气的。</p> <p><a></a></p> <p>等比的罗浮龙尊雕像，属于本次展出的牌面了。</p> <p><a></a></p> <p>一尊在场馆内的 KFC 附近当气氛组的金人雕像。</p> <p><a></a></p> <p>以及一个等比的匹诺康尼钟表小子雕像。而在钟表小子雕像下面，有一对 coser 正在排队接受合照。这对 coser 分别 cos 的是<a href="https://mzh.moegirl.org.cn/%E6%B5%81%E8%90%A4">流萤</a>和装甲「<a href="https://mzh.moegirl.org.cn/%E8%90%A8%E5%A7%86">萨姆</a>」，<a href="https://mzh.moegirl.org.cn/%E8%90%A8%E5%A7%86">萨姆</a>的这身 cos 道具服做工还行，我也去凑热闹合了个影。</p> <p><a></a></p> <p>走半天走不动了，就在群聊水一水，找今天同在星铁 LAND 的群友会合。聚在那一块的群友大概有七八个，已经记不得有哪些人了，还有印象的只有<em>凋零的迷罪</em>和<em>磁暴步兵54</em>两位，一位是身高一米九的狱警，另一位举着个希儿表情包牌子蹲着（昨天崩三快闪活动里他也举着这个牌子），很难不印象深刻。</p> <p>跟算不上很熟（至少不记得名字）的群友们随便寒暄了几句，也饿得差不多了。虽然场馆里面也有肯德基，但是排队的人很多，要等上一个小时才有饭吃，所以我选择临时离场，和<em>红白</em>一起去楼下的麦当劳吃饭。结果因为吃饭，错过了群友们的合影环节，有点可惜。</p> <p>吃完饭上楼，慢慢把章集完。走在路上却是看到一群人围着一位坐着轮椅的<a href="https://zh.moegirl.org.cn/%E5%8F%AF%E5%8F%AF%E5%88%A9%E4%BA%9A%C2%B7%E5%85%B0%E5%BE%B7">可可利亚</a> coser，打开 B 站刷了一会儿动态才知道，原来是<a href="https://zh.moegirl.org.cn/%E5%8F%AF%E5%8F%AF%E5%88%A9%E4%BA%9A%C2%B7%E5%85%B0%E5%BE%B7">可可利亚</a>的中文 CV <a href="https://zh.moegirl.org.cn/%E6%B2%90%E9%9C%8F">沐霏</a>，于是赶紧过去排队合了个影。</p> <p><a></a></p> <p>逛到下午三点左右，就算是逛得差不多了。离场回民宿躺了一个小时，又被群友叫去聚餐。这次是吃海底捞。</p> <p><a></a></p> <p>吃完这顿，这个五一假期旅行就算是结束了。回到民宿睡了几天来第一次好觉，第二天中午就坐火车回学校了。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p>本文中所有「群友」，均特指我加入的一个米哈游游戏相关 QQ 群的群友。 <a href="#user-content-fnref-1">↩</a></p> </li> <li> <p>一种印有二次元角色的透明小卡片，可以放在相机前面用于和二次元角色合影。 <a href="#user-content-fnref-2">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/hello-authelia/https://blog.hpcesia.com/posts/hello-authelia/Thu, 15 May 2025 13:54:24 GMT<article> <h2>什么是 Authelia<a href="#什么是-authelia">#</a></h2> <p><a href="https://www.authelia.com/">Authelia</a> 是一个开源的身份验证和授权服务器，它通过 Web 界面提供应用程序的两因素认证（2FA）和单点登录（SSO）。它作为反向代理的伴侣，能够允许、拒绝或重定向请求。</p> <h2>为什么是 Authelia<a href="#为什么是-authelia">#</a></h2> <p>随着服务器上的服务越来越多，为每个服务都设置一个单独的密码实在是有些麻烦了（而且还加重 <a href="https://github.com/dani-garcia/vaultwarden">VaultWarden</a> 负担），更直接的原因是 <a href="https://gethomepage.dev/">Homepage</a> 不支持用户密码登录功能，而反向代理的密码功能用起来又实在是不舒服，因此我需要一个 SSO 应用，用于统合各个服务，并为无登录系统的服务添加一个好用的登录系统。</p> <p>其实 1Panel 上是有现成的 SSO 应用 <a href="https://logto.io/zh-CN/">Logto</a> 可以部署的，但问题在于：Logto 刚需 PostgreSQL，而我不想在小服务器上部署这种比较重的应用，因此我只能选择支持 SQLite 的 Authelia。</p> <h2>使用 1Panel 部署轻量 Authelia<a href="#使用-1panel-部署轻量-authelia">#</a></h2> <p>由于我个人使用 <a href="https://1panel.cn/">1Panel</a> 来可视化管理我的服务器，因此我写了一个 1Panel 的本地应用，方便使用 1Panel 的功能。由于应用写得有点拉胯，暂不打算 PR 到官方或第三方仓库，你可以在我的 <a href="https://github.com/HPCesia/1panel-apps/">GitHub 仓库</a>上获取<a href="https://github.com/HPCesia/1panel-apps/tree/main/apps/authelia">该本地应用</a>，放到服务器上就可以快速部署了。个人的轻量级使用环境建议部署 lite 版本，可以省去其他服务（目前只有 lite 版本，全量版本因为自己暂时用不上，还没做）。</p> <p>安装完成后先不急着使用，先打开应用的安装目录，在 data 目录下找到 configuration.yml 文件，这里就是 Authelia 的配置文件。以下是应用自带的默认配置文件，我将需要修改的部分进行了高亮。</p> <div><figure><figcaption><span>configuration.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>server</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>address</span><span>:</span><span> </span><span>'tcp://:9091'</span></div></div><div><div><div>3</div></div><div> </div></div><div><div><div>4</div></div><div><span>authentication_backend</span><span>:</span></div></div><div><div><div>5</div></div><div><span> </span><span>file</span><span>:</span></div></div><div><div><div>6</div></div><div><span> </span><span>path</span><span>:</span><span> </span><span>'/config/users_database.yml'</span></div></div><div><div><div>7</div></div><div> </div></div><div><div><div>8</div></div><div><span>totp</span><span>:</span></div></div><div><div><div>9</div></div><div><span> </span><span>disable</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>10</div></div><div><span> </span><span>issuer</span><span>:</span><span> </span><span>'authelia.com'</span><span> </span><span># 改为你的域名</span></div></div><div><div><div>11</div></div><div> </div></div><div><div><div>12</div></div><div><span>identity_validation</span><span>:</span></div></div><div><div><div>13</div></div><div><span> </span><span>reset_password</span><span>:</span></div></div><div><div><div>14</div></div><div><span> </span><span>jwt_algorithm</span><span>:</span><span> </span><span>'HS512'</span></div></div><div><div><div>15</div></div><div> </div></div><div><div><div>16</div></div><div><span>identity_providers</span><span>:</span></div></div><div><div><div>17</div></div><div><span> </span><span>oidc</span><span>:</span></div></div><div><div><div>18</div></div><div><span> </span><span>jwks</span><span>:</span></div></div><div><div><div>19</div></div><div><span> </span><span>-</span><span> </span><span>key_id</span><span>:</span><span> </span><span>'example'</span><span> </span><span># 随便改个名字</span></div></div><div><div><div>20</div></div><div><span> </span><span>algorithm</span><span>:</span><span> </span><span>'RS256'</span></div></div><div><div><div>21</div></div><div><span> </span><span>use</span><span>:</span><span> </span><span>'sig'</span></div></div><div><div><div>22</div></div><div><span> </span><span>key</span><span>:</span><span> </span><span>{</span><span> </span><span>{</span><span> </span><span>secret "/config/secrets/oidc/jwks/rsa.2048.key" | mindent 10 "|" | msquote</span><span> </span><span>}</span><span> </span><span>}</span></div></div><div><div><div>23</div></div><div> </div></div><div><div><div>24</div></div><div><span>session</span><span>:</span></div></div><div><div><div>25</div></div><div><span> </span><span>cookies</span><span>:</span></div></div><div><div><div>26</div></div><div><span> </span><span>-</span><span> </span><span>name</span><span>:</span><span> </span><span>'authelia_session'</span><span> </span><span># 随便改个名字</span></div></div><div><div><div>27</div></div><div><span> </span><span>domain</span><span>:</span><span> </span><span>'example.com'</span><span> </span><span># 改为你的域名</span></div></div><div><div><div>28</div></div><div><span> </span><span>authelia_url</span><span>:</span><span> </span><span>'https://authelia.example.com'</span><span> </span><span>#</span></div></div><div><div><div>29</div></div><div><span> </span><span>expiration</span><span>:</span><span> </span><span>'1 hour'</span></div></div><div><div><div>30</div></div><div><span> </span><span>inactivity</span><span>:</span><span> </span><span>'5 minutes'</span></div></div><div><div><div>31</div></div><div><span> </span><span>remember_me</span><span>:</span><span> </span><span>'1 week'</span></div></div><div><div><div>32</div></div><div> </div></div><div><div><div>33</div></div><div><span>access_control</span><span>:</span></div></div><div><div><div>34</div></div><div><span> </span><span>default_policy</span><span>:</span><span> </span><span>'deny'</span></div></div><div><div><div>35</div></div><div><span> </span><span>rules</span><span>:</span></div></div><div><div><div>36</div></div><div><span> </span><span>-</span><span> </span><span>domain</span><span>:</span><span> </span><span>'public.example.com'</span><span> </span><span># 改为你的域名</span></div></div><div><div><div>37</div></div><div><span> </span><span>policy</span><span>:</span><span> </span><span>'bypass'</span><span> </span><span>#</span></div></div><div><div><div>38</div></div><div><span> </span><span>-</span><span> </span><span>domain</span><span>:</span><span> </span><span>'private.example.com'</span><span> </span><span># 改为你的域名</span></div></div><div><div><div>39</div></div><div><span> </span><span>policy</span><span>:</span><span> </span><span>'one_factor'</span><span> </span><span>#</span></div></div><div><div><div>40</div></div><div><span> </span><span>-</span><span> </span><span>domain</span><span>:</span><span> </span><span>'secure.example.com'</span><span> </span><span># 改为你的域名</span></div></div><div><div><div>41</div></div><div><span> </span><span>policy</span><span>:</span><span> </span><span>'two_factor'</span><span> </span><span>#</span></div></div><div><div><div>42</div></div><div> </div></div><div><div><div>43</div></div><div><span>regulation</span><span>:</span></div></div><div><div><div>44</div></div><div><span> </span><span>max_retries</span><span>:</span><span> </span><span>3</span></div></div><div><div><div>45</div></div><div><span> </span><span>find_time</span><span>:</span><span> </span><span>'2 minutes'</span></div></div><div><div><div>46</div></div><div><span> </span><span>ban_time</span><span>:</span><span> </span><span>'5 minutes'</span></div></div><div><div><div>47</div></div><div> </div></div><div><div><div>48</div></div><div><span>storage</span><span>:</span></div></div><div><div><div>49</div></div><div><span> </span><span>local</span><span>:</span></div></div><div><div><div>50</div></div><div><span> </span><span>path</span><span>:</span><span> </span><span>'/config/db.sqlite3'</span></div></div><div><div><div>51</div></div><div> </div></div><div><div><div>52</div></div><div><span>notifier</span><span>:</span></div></div><div><div><div>53</div></div><div><span> </span><span>filesystem</span><span>:</span></div></div><div><div><div>54</div></div><div><span> </span><span>filename</span><span>:</span><span> </span><span>'/config/notification.txt'</span></div></div><div><div><div>55</div></div><div><span> </span><span># smtp: # 要用 smtp 就把上面的注释掉</span></div></div><div><div><div>56</div></div><div><span> </span><span># username: 'test'</span></div></div><div><div><div>57</div></div><div><span> </span><span># password: 'password'</span></div></div><div><div><div>58</div></div><div><span> </span><span># address: 'smtp://mail.example.com:25'</span></div></div><div><div><div>59</div></div><div><span> </span><span># sender: 'admin@example.com'</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接着要修改保存在文件中的各个机密：</p> <ul> <li><code>STORAGE_ENCRYPTION</code>：应为不低于 20 位的随机字符串</li> <li><code>SESSION_SECRET</code>：应为不低于 64 位，且仅包含大小写字母与数字的随机字符串</li> <li><code>JWT_SECRET</code>：应为不低于 64 位，且仅包含大小写字母与数字的随机字符串</li> <li><code>HMAC_SECRET</code>：应为不低于 64 位，且仅包含大小写字母与数字的随机字符串</li> <li><code>oidc/jwks/rsa.2048.key</code> 与 <code>oidc/jwks/rsa.2048.key.pub</code>：应为使用 RSA 方法生成的、位数不低于 2048 的一对公私钥</li> </ul> <p>所有机密均可通过 Authelia 提供的生成器生成，在容器终端中执行命令即可：</p> <ul> <li> <p>随机字符串：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>authelia</span><span> </span><span>crypto</span><span> </span><span>rand</span><span> </span><span>--length</span><span> </span><span>64</span><span> </span><span>--charset</span><span> </span><span>alphanumeric</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p>RSA 密钥对：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>authelia</span><span> </span><span>crypto</span><span> </span><span>pair</span><span> </span><span>rsa</span><span> </span><span>generate</span><span> </span><span>--directory</span><span> </span><span>/config/secrets/oidc/jwks</span><span> </span><span>--file.private-key</span><span> </span><span>rsa.2048.key</span><span> </span><span>--file.public-key</span><span> </span><span>rsa.2048.key.pub</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> </ul> <p>最后修改 users_database.yml，添加上自己的账户，其中密码需要在容器终端中执行命令：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>authelia</span><span> </span><span>crypto</span><span> </span><span>hash</span><span> </span><span>generate</span><span> </span><span>argon2</span><span> </span><span>--password</span><span> </span><span>'password'</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>或者直接生成随机密码：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>authelia</span><span> </span><span>crypto</span><span> </span><span>hash</span><span> </span><span>generate</span><span> </span><span>argon2</span><span> </span><span>--random</span><span> </span><span>--random.length</span><span> </span><span>64</span><span> </span><span>--random.charset</span><span> </span><span>alphanumeric</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>然后将 <code>Digest</code> 的内容放到 <code>password</code> 字段中，Authelia 就算是部署完成了。</p> <h2>站点接入单点登录<a href="#站点接入单点登录">#</a></h2> <p>当我们部署的站点较多的时候，管理大量非公开站点的登录信息就成了一个问题。如果只是单人使用，或许还可以靠密码管理工具来简单管理；但使用人数一多，光是帮每个使用者注册账户就够喝一壶了。Authelia 这类单点登录工具便为此而生。下面我以官方文档中没有示例的 <a href="https://alistgo.com/zh/">Alist</a> 接入为例，演示如何为一步步为一个支持 OIDC 登录，但是没有 Authelia 教程的站点接入 Authelia。</p> <p>阅读 Alist 文档，可以找到 Alist 单点登录的 callback 链接：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>https://your.alist.domain/api/auth/sso_callback\?method=sso_get_token</span></div></div><div><div><div>2</div></div><div><span>https://your.alist.domain/api/auth/sso_callback\?method=get_sso_id</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>于是可以根据这个链接使用 Authelia 设置单点登录。首先在 Authelia 的 configuration.yml 中添加如下设置：</p> <div><figure><figcaption><span>configuration.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>identity_providers</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>oidc</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>clients</span><span>:</span></div></div><div><div><div>4</div></div><div><span> </span><span>-</span><span> </span><span>client_id</span><span>:</span><span> </span><span>'alist'</span></div></div><div><div><div>5</div></div><div><span> </span><span>client_name</span><span>:</span><span> </span><span>'Alist'</span></div></div><div><div><div>6</div></div><div><span> </span><span>client_secret</span><span>:</span><span> </span><span>'$pbkdf2-sha512$310000$c8p78n7pUMln0jzvd4aK4Q$JNRBzwAo0ek5qKn50cFzzvE9RXV88h1wJn5KGiHrD0YKtZaR/nCb2CJPOsKaPK0hjf.9yHxzQGZziziccp6Yng'</span><span> </span><span># 示例密钥哈希值，对应客户端示例密钥为 `insecure_secret`</span></div></div><div><div><div>7</div></div><div><span> </span><span>public</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>8</div></div><div><span> </span><span>authorization_policy</span><span>:</span><span> </span><span>'one_factor'</span></div></div><div><div><div>9</div></div><div><span> </span><span>redirect_uris</span><span>:</span></div></div><div><div><div>10</div></div><div><span> </span><span>-</span><span> </span><span>'https://alist.example.com/api/auth/sso_callback?method=sso_get_token'</span></div></div><div><div><div>11</div></div><div><span> </span><span>-</span><span> </span><span>'https://alist.example.com/api/auth/sso_callback?method=get_sso_id'</span></div></div><div><div><div>12</div></div><div><span> </span><span>scopes</span><span>:</span></div></div><div><div><div>13</div></div><div><span> </span><span>-</span><span> </span><span>'openid'</span></div></div><div><div><div>14</div></div><div><span> </span><span>-</span><span> </span><span>'profile'</span></div></div><div><div><div>15</div></div><div><span> </span><span>userinfo_signed_response_alg</span><span>:</span><span> </span><span>'none'</span></div></div><div><div><div>16</div></div><div><span> </span><span>token_endpoint_auth_method</span><span>:</span><span> </span><span>'client_secret_post'</span><span> </span><span># Alist 使用 POST 进行单点登录，不设置会报错，提示使用该设置。</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>然后，在 Alist 的单点登录设置页面选择平台为 OIDC，设置如下选项：</p> <ul> <li><strong>单点登录客户端 ID</strong>: <code>alist</code></li> <li><strong>单点登录客户端机密</strong>: <code>insecure_secret</code></li> <li><strong>Sso oidc 用户名键</strong>: <code>preferred_username</code></li> <li><strong>单点登录端点名称</strong>: <code>https://authelia.example.com</code></li> </ul> <p>重启 Authelia，退出 Alist 登录，现在就可以通过单点登录登录到 Alist 了。</p> <blockquote> <div><span>一些设置项的来历</span></div> <div> <p></p> <ul> <li><strong>Sso oidc 用户名键</strong>: 来自 Authelia 的文档，一部分集成指南中使用了类似的配置。</li> <li><strong>单点登录端点名称</strong>: 先随意设置了一个名称，报错信息显示其访问了 .well_know-known 路径，所以使用 Authelia 部署根路径。</li> </ul> </div> </blockquote> <h2>站点外挂登录系统<a href="#站点外挂登录系统">#</a></h2> <p>还有一些站点根本没有用户登录这个功能，但有时候我们又不想对外公开这个站点，因此我们需要为网站外挂一个登录系统。Authelia 便可以很好地承担这项任务，对于 1Panel 用户来说，只需要在网站的配置文件中添加少量代码，即可为网站接入 Authelia 的登录系统。</p> <p>1Panel 的网站管理使用的是基于 Nginx 的 OpenRestry，因此只要是基于 Nginx 的反向代理网站管理系统，都可以参考接下来的配置方法。</p> <p>打开 1Panel 中需要外挂登录的网站配置页面，找到反向代理一栏，添加一个新的反向代理，修改源文如下：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>location</span><span> /internal/authelia/authz {</span></div></div><div><div><div>2</div></div><div><span> <span> </span></span><span>proxy_pass </span><span>http://127.0.0.1:9091/api/authz/auth-request</span><span>;</span><span> </span><span># 取决于 Authelia 部署的位置与端口号</span></div></div><div><div><div>3</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>Host $host</span><span>;</span></div></div><div><div><div>4</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Original-URL $scheme://$http_host$request_uri</span><span>;</span></div></div><div><div><div>5</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Forwarded-Proto $scheme</span><span>;</span></div></div><div><div><div>6</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Forwarded-Host $http_host</span><span>;</span></div></div><div><div><div>7</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Forwarded-URI $request_uri</span><span>;</span></div></div><div><div><div>8</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Forwarded-Ssl </span><span>on</span><span>;</span></div></div><div><div><div>9</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Forwarded-For $remote_addr</span><span>;</span></div></div><div><div><div>10</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Original-Method $request_method</span><span>;</span></div></div><div><div><div>11</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Original-URL $scheme://$http_host$request_uri</span><span>;</span></div></div><div><div><div>12</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Forwarded-For $remote_addr</span><span>;</span></div></div><div><div><div>13</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>Content-Length </span><span>""</span><span>;</span></div></div><div><div><div>14</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>Connection </span><span>""</span><span>;</span></div></div><div><div><div>15</div></div><div><span> <span> </span></span><span>proxy_pass_request_body </span><span>off</span><span>;</span></div></div><div><div><div>16</div></div><div><span> <span> </span></span><span>proxy_next_upstream </span><span>error</span><span> timeout invalid_header http_500 http_502 http_503</span><span>;</span></div></div><div><div><div>17</div></div><div><span> <span> </span></span><span>proxy_redirect </span><span>http:// $scheme://</span><span>;</span></div></div><div><div><div>18</div></div><div><span> <span> </span></span><span>proxy_http_version </span><span>1.1</span><span>;</span></div></div><div><div><div>19</div></div><div><span> <span> </span></span><span>proxy_cache_bypass </span><span>$cookie_session</span><span>;</span></div></div><div><div><div>20</div></div><div><span> <span> </span></span><span>proxy_no_cache </span><span>$cookie_session</span><span>;</span></div></div><div><div><div>21</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>然后修改默认的反向代理源文，添加一段内容：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>location</span><span> / {</span></div></div><div><div><div>2</div></div><div><span> </span><span><span> </span>auth_request </span><span>/internal/authelia/authz</span><span>;</span></div></div><div><div><div>3</div></div><div><span> </span><span><span> </span>auth_request_set </span><span>$user $upstream_http_remote_user</span><span>;</span></div></div><div><div><div>4</div></div><div><span> </span><span><span> </span>auth_request_set </span><span>$groups $upstream_http_remote_groups</span><span>;</span></div></div><div><div><div>5</div></div><div><span> </span><span><span> </span>auth_request_set </span><span>$name $upstream_http_remote_name</span><span>;</span></div></div><div><div><div>6</div></div><div><span> </span><span><span> </span>auth_request_set </span><span>$email $upstream_http_remote_email</span><span>;</span></div></div><div><div><div>7</div></div><div><span> </span><span><span> </span>proxy_set_header </span><span>Remote-User $user</span><span>;</span></div></div><div><div><div>8</div></div><div><span> </span><span><span> </span>proxy_set_header </span><span>Remote-Groups $groups</span><span>;</span></div></div><div><div><div>9</div></div><div><span> </span><span><span> </span>proxy_set_header </span><span>Remote-Name $name</span><span>;</span></div></div><div><div><div>10</div></div><div><span> </span><span><span> </span>proxy_set_header </span><span>Remote-Email $email</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span><span> </span>auth_request_set </span><span>$redirection_url $upstream_http_location</span><span>;</span></div></div><div><div><div>12</div></div><div><span> </span><span><span> </span>error_page </span><span>401</span><span> </span><span>=302</span><span> $redirection_url</span><span>;</span></div></div><div><div><div>13</div></div><div> </div></div><div><div><div>14</div></div><div><span> <span> </span></span><span>proxy_pass </span><span>http://127.0.0.1:23423</span><span>;</span></div></div><div><div><div>15</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>Host $host</span><span>;</span></div></div><div><div><div>16</div></div><div><span> <span> </span></span><span>proxy_set_header </span><span>X-Real-IP $remote_addr</span><span>;</span></div></div><div><div><div>17</div></div><div><span> </span><span># ...</span></div></div><div><div><div>18</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>就算大功告成了。</p> </article> https://blog.hpcesia.com/posts/miscellaneous-notes-1/https://blog.hpcesia.com/posts/miscellaneous-notes-1/Mon, 05 May 2025 14:59:47 GMT<article> <p>因为更新时间实在是波动极大，月记/周记已经不能描述这一系列杂记的更新时间了明明是你拖更拖久了导致的吧 ，所以本系列直接叫杂记了。诶这个人怎么这么起名废啊，你看隔壁<a href="https://chlo.is/">小氯</a>就起名一套一套的。反观这个人连自托管的 Git Forge 平台都懒得改名，博客也只想得到小屋这种烂大街名。</p> <h2>需要被推着走的人<a href="#需要被推着走的人">#</a></h2> <p>在一次次拖延中，我的论文总算是给导师交上了初稿。其实也不算初稿，因为还没有查重，不过也算是告一段落了，可以稍微休息几天，打打游戏放松一下。</p> <p>如果专心写论文的话，这份初稿大概半个月前就该交到导师手上了。但是这段时间里我花了不少时间在搓博客代码、打游戏和随缘找工作中渡过，直到导师来催论文了，我才紧赶慢赶地把论文搞完――第一次来催初稿的时候我论文甚至还没有开始动笔。这属于是我这个 DDL^{<a href="#user-content-fn-1">1</a>} 战士日常了。</p> <p>我刚才说说到了「随缘找工作」。正所谓「金三银四」，到了四月底，春招已经快结束了，我却还在随缘找工作，完全不上心。这大概是因为我有「后路」：家里虽说不算大富大贵，但也算是小有资产，还轮不到我来赚钱养家，实在找不到工作也可以选择回家继承家业。这使得我在找工作这方面没有 DDL 可言，于是 DDL 战士就开始华丽地摆烂了。</p> <p>我是一个需要被推着走的人。在大二那年，我就意识到了这一点。那时我开始了持续至大四的学习状态：上课刷手机，偶尔看看教材自学一下勉强跟进度，能独立（含查资料）做完作业就算成功。得到的结果是：大部分专业课程，我的分数都比较一般，只有几门重实践的课分数好看点。</p> <p>类似的状态曾出现在我的初三与高一上的时候，那段时间我上课的时候，右手里一定揣着一个小 mp3 在看小说。高一下的时候，因为差点被老师抓现行，以及上课看小说对成绩影响很大，我丢掉了 mp3，只在中午、下午与晚上的时候，在宿舍里偷偷玩手机。那时我有学校的规则推着走，最后成绩至少还算说得过去。</p> <p>对我自己来说，这种性格感觉改也不知道怎么改了。「学习搭子」这种机制大概会有点用，或者是花钱找人管也不失为一种办法。就连这篇文章都是在「再不更新就会被博客寥寥几个读者来问」的状态下完成的。</p> <h2>Hello, Codeberg<a href="#hello-codeberg">#</a></h2> <p><a href="https://codeberg.org">Codeberg</a> 这个非盈利代码仓库托管服务商，我还是从小氯那里知道的。</p> <p>Codeberg 很小众——小众到整个站点最高 star 的仓库 <a href="https://codeberg.org/forgejo/forgejo">Forgejo</a>^{<a href="#user-content-fn-2">2</a>} 也只有 2.2k star。这个 star 数量是什么概念呢？GitHub Copilot Pro 对「知名开源仓库的维护者」免费开放，而这个「知名开源仓库」的要求是 1k star。Forgejo 刚刚超过这个门槛的一倍，而整个 Codeberg 上，也只有三个仓库达到了这一门槛。</p> <p>Codeberg 不受支持——例如 Netlify 的持续集成部署只支持从 GitHub、GitLab、Bitbucket 和 Azure 中导入项目，其他的 Git 托管服务商用都没法用。</p> <p>另一方面，FOSS^{<a href="#user-content-fn-3">3</a>} 爱好者可能会喜欢 Codeberg，因为它是非盈利组织，且使用 GPL 3.0 协议的 Forgejo 提供服务。以及 Forgejo/Gitea 在某些方面比 GitHub 做的更好，比如多语言支持——GitHub 需要手动在 README 里添加其他语言 README 链接，比起 Forgejo/Gitea 根据页面语言选择对应版本 REAMD 还是差太多了。</p> <p>此外，小众也有小众的好处——GFW^{<a href="#user-content-fn-4">4</a>} 并没有注意到这个站点，不需要再折腾半天不同软件的代理配置了（这大概也是最现实的因素了）。</p> <p>目前我只迁移了 Astral Halo 项目——也就是我现在在用的博客模板——到 Codeberg 上，然后通过 Forgejo/Gitea 的镜像推送功能，每次提交都会推送到 GitHub 的仓库中，触发 Netlify 的重新构建（博客主题的 Demo 站点）。而现在的博客源码我则是放在了自部署的 Forgejo 上，同样通过镜像功能推送到 GitHub。</p> <p>4 月 13 日中午，惊闻 <a href="https://github.com/orgs/community/discussions/156515">GitHub 主动禁止了来自中国（港澳似乎也受影响）的 IP 对 github.com 子路径的访问</a>。虽然<a href="https://www.githubstatus.com/incidents/jfvgcls9swln">在 4 月 13 日晚上，GitHub 恢复了中国地区的访问</a>，并声明这是网络配置错误导致的问题，但也说明做两手准备总不是坏事，有必要提前做好准备，把 GitHub 上的一些仓库做个备份。当然，也可以干脆把重心移出 GitHub，转向其他 git 托管平台。此时 Codeberg 就成为了一个脱离 GitHub 的优秀选择。</p> <p>为什么还是用国外的 git 托管服务商？因为国内的几个 git 托管服务商一个比一个看不下去。Gitee 生态烂的同时还有代码文本审查机制，J**aScript 这种笑话还是快端下去吧。GitCode 本身就是毒瘤，有着从 CSDN 继承来的登录后复制（虽然众所周知前端挡不住人，但还是恶心），还从 GitHub 上镜像了海量的仓库和组织。其实镜像仓库不算什么大事，仓库开源出来还能不让人 clone 了？但是 GitCode 还顺便把账号、组织的公开信息等一起镜像了，之前有段时间还不标注原仓库链接，这就很恶心了。</p> <p>综上，小众、未被屏蔽且服务端开源的 Codeberg 就成为了离开 GitHub 的一个好去处。Codeberg 当然也有他自己的风险，但 git 托管服务商哪有没风险的呢？自托管放在 VPS 要考虑 VPS 提供商是否靠谱；放在家里的 NAS 上虽然服务本身靠谱，但光是申请固定 IP 就够喝一壶了。至少，现在 Codeberg 用起来还算不错，不是吗？</p> <h2>Hello, Rime<a href="#hello-rime">#</a></h2> <p>大约一年以前，我就在 PC 上使用 <a href="https://github.com/rime/librime">Rime</a> 输入法了，使用的是<a href="https://github.com/rime/weasel">小狼毫</a>和<a href="https://github.com/iDvel/rime-ice">雾凇拼音</a>。但是手机上，我则是一直使用的华为自带的小艺输入法。在遇到了几次刚在 QQ 群聊完某个东西，打开淘宝里面看到相关推荐的事后，我决定在手机上也改用 Rime。</p> <p>既然要用 Rime 了，前端自然是要用开源的。在 F-Droid 里翻了一下，安卓的开源 Rime 前端就两个选择：<a href="https://f-droid.org/packages/org.fcitx.fcitx5.android">小企鹅输入法</a>和<a href="https://f-droid.org/packages/com.osfans.trime">同文输入法</a>。</p> <p>小企鹅输入法使用手感很好，但是它存在一个问题：它的 Rime 配置文件是放在 data 目录下的，我还用的是阉割掉安卓 12 无线调试设置页面的华为鸿蒙 4 系统，不方便通过 <a href="https://shizuku.rikka.app/zh-hans/">Shizuku</a> 来访问 data 目录内容。结果就是我只能手动连接数据线到电脑上才能同步用户词典数据。</p> <p>同文输入法则可以自定义 Rime 配置目录路径，从而可以通过 Syncthing 实时与电脑上的用户词典进行同步。但是我能找到的所有主题配置都非常不顺手，打字时很容易莫名其妙打出一些错误的内容。并且似乎是因为主题太老以及同文输入法本身配置过于自由的原因，几乎所有其他输入法中可以通过滑动来浏览的菜单，在同文输入法都需要按翻页键才能实现。同时同文输入法的很多主题都年久失修，偶尔会出现崩溃的情况。</p> <p>最后我还是选择了小企鹅输入法。手动同步虽然麻烦了点，但本身词库同步也不是什么需要特别频繁进行的操作，每个月拿一天时间出来同步一下数据就好。</p> <h2>Hello, Artalk<a href="#hello-artalk">#</a></h2> <p>4 月初，我把小屋的评论换成了 Artalk。一方面，是因为 Twikoo 管理评论实在是太太太麻烦了，对于一些错误的评论，想修改会非常麻烦。比如我有时候会把 Twikoo 用于隐藏设置面板的用户名用于回复评论，这是不应该出现的情况。但如果我想修改这一用户名，就需要删除全部评论，再将导出并修改的评论数据重新导入 Twikoo。另一方面，我的 2H2G^{<a href="#user-content-fn-5">5</a>} 的 VPS 在精简掉不常用的服务后，还有一半多点的内存没用上，部署一个 Artalk 正合适。</p> <p>Artalk 的评论区我并没有添加自定义样式，而是直接使用 Artalk 自己的样式。这主要是因为我正在使用的框架 Astro 对 CSS 的 tree-shaking^{<a href="#user-content-fn-6">6</a>} 不够强，未被使用的评论系统的自定义样式也会被打包到构建产物中。而我的博客整理出了一个主题 Astral Halo，我如果写了 Artalk 自定义样式，也应该放到这个主题中，导致主题打包产物体积膨胀。</p> <p>另一方面，也是因为早些时候给 Twikoo 搓自定义样式花了很多精力才搞好，有点懒得动手。所以，在我找到解决方案，或者上游解决了这个问题之前，我就先用着 Artalk 的默认样式了。</p> <h2>Hello, WezTerm<a href="#hello-wezterm">#</a></h2> <p>怎么这么多 Hello 环节啊。</p> <p>WezTerm 是一个 Rust 编写的跨平台终端仿真器，使用 Lua 作为配置文件。相比于 Windows Terminal，WezTerm 的自定义程度更高，性能更好，也不存在一些神必快捷键冲突。其跨平台的特性和基于 Lua 的配置文件也使得 WezTerm 可以在多种系统的桌面环境共享同一套配置文件。</p> <p>考虑到 WezTerm 的稳定版本已经超过一年没有更新了，此时更建议使用 nightly 版本。nightly 版本相比稳定版本修复了不少 bug，比如在 WSL2 中使用 yazi 时，稳定版本会炸掉，而 nightly 版本则不会出现该问题。</p> <h2>一篇故事<a href="#一篇故事">#</a></h2> <p>最近才看到 <a href="https://github.com/zloirock/core-js/blob/master/docs/zh_CN/2023-02-14-so-whats-next.md">core.js 作者的故事</a>，一个如此符合下面这张梗图的压抑的故事。</p> <p><a></a></p> <p>如果你没有看过上面链接中的文章，我建议你看一下――我相信能够来到小屋的读者，有耐心读完那篇长文。</p> <h3>开源的幻觉<a href="#开源的幻觉">#</a></h3> <p>开源会给一些人带来一种幻觉：「你不做有的是人做」。你可以在很多地方看到类似的言论，比如「美国要是禁止国人参与 Linux 开发，国内就自己分叉一个」、「开源库总会有人审查代码安全，不用担心内藏病毒和后门」，以及在 <a href="https://github.com/zloirock/core-js/issues/1179">core.js 关于这篇文章的 issue</a> 中<a href="https://github.com/zloirock/core-js/issues/1179#issuecomment-1428787965">出现的</a>：</p> <blockquote> <p>The community at large will pick it up and maintain it. Your legacy is intact. Such is FOSS.</p> <p>整个社区会接手并维护它。你的遗产是完整的。这就是开源软件的魅力。</p> </blockquote> <p>那篇文章中提前对此给出了<a href="https://github.com/zloirock/core-js/blob/d99bd3f20044bca033d82feedd30bcf4b371fd86/docs/2023-02-14-so-whats-next.md?plain=1#L363">回应</a></p> <blockquote> <p>Q: <strong>这是开源的，我们将分叉（fork）它，滚开。</strong></p> <p>A: 我经常看到这样的评论，有人甚至试图用分叉吓唬我。我已经说过太多次了，如果有人能分叉并正确维护 <code>core-js</code>，我会很高兴——在没有人维护的情况下，分叉有什么意义呢。现在我根本没有看到任何人试图为 <code>core-js</code> 添加一些重要的东西，或者至少定期做出贡献。项目应该跟进每个新的 JavaScript 引擎版本，更新兼容性数据，修复或至少考虑每个引擎的每个新错误（无论多大的错误），查看并实现每个可能的新的 JavaScript 功能，最大限度地正确执行，测试并考虑每个现代引擎或老引擎的每个版本的具体细节。这是一项艰苦的工作，你准备好了吗，并且有所需的知识和时间吗？举个例子，当我在监狱里时，Babel 说他们搞不定：</p> <p><a></a></p> </blockquote> <p>「Talk is cheap, show me your code」。虽然说出这话的 Linus^{<a href="#user-content-fn-7">7</a>} 本人也因为偷偷摸摸踢走 Linux 的俄罗斯维护者^{<a href="#user-content-fn-8">8</a>} 而「塌房」了，但这话对上文提到的幻觉依旧有用。因为上文提到的幻觉，实质上是给出了这样的回答：「Someone will show you the code, but <strong>NOT ME</strong>」。</p> <h3>莫名的恶意<a href="#莫名的恶意">#</a></h3> <p>我不知道这种莫名的恶意从何而来：怨恨软件作者任何与该软件无关的言论，比如「如何去除 Vim 启动页面中的『帮助乌干达的可怜儿童』」，比如 core.js 作者因为在 npm 包安装过程中添加了寻求赞助的提示被大量辱骂。引用那篇长文中的话：</p> <blockquote> <p>开发人员喜欢使用免费的开源软件——免费，效果好。他们对背后数千小时的开发不感兴趣，他们对项目背后那个真人的问题和需求不感兴趣。他们认为，提及这些就是对他们个人空间的侵犯，甚至是对他们个人的冒犯。对他们来说，这些开源项目，就是一些齿轮，应该自动耦合，不应该有任何噪音，也不应该要他们参与。</p> </blockquote> <h3>好人应有好报<a href="#好人应有好报">#</a></h3> <p>好人没好报的故事，我见过太多了。从互联网方面看，有上面那样得不到回报的开源库维护者，有免费分享的资源被淘宝/闲鱼/拼多多等平台的贩子倒卖的，有免费帮助他人结果因为做的没付费的好反被辱骂的，我都或多或少见过实例。</p> <p>而从现实方面看，「得益」于各路媒体总是将「歌颂面对苦难的精神」搞成「歌颂苦难」，各种行业领头人没工资，家人一直住在贫困农村的故事已经屡见不鲜了；抛开这些故事，也有「不是你撞的你为什么要扶」这种令全国社会道德大滑坡的事迹，什么免费送水/食品的人因为送得不够「好」反被指着骂的情况也算是屡见不鲜了。</p> <p>好人应有好报，我如此认为。所以我向这位致力于维护开源仓库的作者捐赠了 140 元――和目前的 AI 产品常用定价 20 美元一致。</p> <h2>后话<a href="#后话">#</a></h2> <p>本次月记的脚注格外的多，大概是因为最近写论文找参考文献找魔怔了吧（笑）。还有一部分考虑，是小屋确实有一些读者了。虽然数量不多，但确实有考虑他人阅读感受的必要，姑且也算是一个好习惯吧。</p> <p>这篇月记拖了两周才写好，原计划是 4 月 21 日发布，现在都拖到五一假期结束了，不能再拖了。为了达成月更，所以四月底<a href="/posts/my-awesome-windows-apps/">水了一篇文章</a>出来凑数。希望以后不会再水了……吧。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p>Deadline 的缩写，一般代指截止日期。 <a href="#user-content-fnref-1">↩</a></p> </li> <li> <p>也是 Codeberg 自己使用的 Git 托管服务，从 Gitea 分叉而来。 <a href="#user-content-fnref-2">↩</a></p> </li> <li> <p>自由开源软件（Free and Open Source Software）的简称。 <a href="#user-content-fnref-3">↩</a></p> </li> <li> <p>长城防火墙（Great Firewall）的简称，代指中国大陆地区对部分网站实行的包括但不限于 IP 屏蔽、DNS 劫持、间歇性阻断等措施。 <a href="#user-content-fnref-4">↩</a></p> </li> <li> <p>xHyG，代指服务器的配置，x 表示虚拟处理器核心数量，y 表示内存容量（GB）。 <a href="#user-content-fnref-5">↩</a></p> </li> <li> <p>前端优化术语，指像摇掉树上的枯枝烂叶一样，去除未被使用的代码的前端性能优化技术。 <a href="#user-content-fnref-6">↩</a></p> </li> <li> <p>Linus Benedict Torvalds，Linux 内核的发明人与核心维护者。 <a href="#user-content-fnref-7">↩</a></p> </li> <li> <p>Linus 通过<a href="https://lwn.net/ml/all/CAHk-=whNGNVnYHHSXUAsWds_MoZ-iEgRMQMxZZ0z-jY4uHT+Gg@mail.gmail.com/">邮件</a>支持了这一<a href="https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=6e90b675cf942e50c70e8394dfb5862975c3b3b2">提交</a> <a href="#user-content-fnref-8">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/my-awesome-windows-apps/https://blog.hpcesia.com/posts/my-awesome-windows-apps/记录一些个人用过的优质 Windows 软件Mon, 21 Apr 2025 15:39:02 GMT<article> <h2>前言<a href="#前言">#</a></h2> <p>这篇文章记录的是我个人用过或者云过的优质 Windows 软件。软件介绍中会记录软件的官网，避免迷路；对于开源软件，还会额外记录软件的源代码仓库地址。</p> <p>所有软件均按首字母进行排序。</p> <p>标记说明：</p> <ul> <li><span></span>：我个人喜欢的软件。</li> <li><span></span>：开源软件。</li> <li><span></span>：多语言软件，指至少同时包含中文和英文的软件。</li> <li><span></span>：<strong>只能</strong>使用命令行操作的软件，不包括 TUI 软件。</li> <li><span></span>：<strong>必须</strong>付费才能使用的软件。</li> <li><span></span>：存在某些问题的软件，会具体说明。</li> </ul> <h2>AI 工具<a href="#ai-工具">#</a></h2> <h3>AnythingLLM <span></span> <span></span><a href="#anythingllm-">#</a></h3> <p><a href="https://anythingllm.com/">官网</a> | <a href="https://github.com/Mintplex-Labs/anything-llm">源代码</a></p> <h3>Cherry Studio <span></span> <span></span><a href="#cherry-studio-">#</a></h3> <p><a href="https://cherry-ai.com/">官网</a> | <a href="https://github.com/CherryHQ/cherry-studio">源代码</a></p> <p>整合式的 LLM 对话软件，可以使用各家的 API，连接各种 MCP 进行对话/翻译/助理等工作。</p> <h3>LM Studio <span></span><a href="#lm-studio">#</a></h3> <p><a href="https://lmstudio.ai/">官网</a></p> <p>功能强大的 LLM 本地部署工具。适合高端显卡用户，可以方便地配置各种模型参数，并下载适合自己显卡的模型。</p> <h3>Ollama <span></span> <span></span> <span></span><a href="#ollama--">#</a></h3> <p><a href="https://ollama.com/">官网</a> | <a href="https://github.com/ollama/ollama">源代码</a></p> <p>轻量的本地 LLM 部署工具，适合消费级显卡用户使用，可以自动混合使用 GPU 与 CPU 进行模型推理。相比 LM Studio，Ollama 的国内网络环境拉取模型速度比较快，但是没有 GUI 页面，CLI 使用和 Docker 比较类似。</p> <h2>安全<a href="#安全">#</a></h2> <h3>Bitwarden <span></span> <span></span><a href="#bitwarden-">#</a></h3> <p><a href="https://bitwarden.com/">官网</a> | <a href="https://github.com/bitwarden/clients">源代码</a></p> <p>开源的在线密码管理器，可以自行部署^{<a href="#user-content-fn-1">1</a>}。有浏览器扩展和 Windows 应用。</p> <h3>Gpg4win <span></span> <span></span><a href="#gpg4win-">#</a></h3> <p><a href="https://www.gpg4win.org/">官网</a> | <a href="https://git.gnupg.org/cgi-bin/gitweb.cgi?p=gpg4win.git">源代码</a></p> <p>适用于 Windows 系统的 GnuPG 官方发行版。主要作用是给 GitHub 提交加一个 Verified 标志。</p> <h3>KeePass <span></span> <span></span><a href="#keepass-">#</a></h3> <p><a href="https://keepass.info/">官网</a> | <a href="https://sourceforge.net/projects/keepass/">源代码</a></p> <p>强大且可定制的开源本地密码管理器。</p> <h2>包管理器<a href="#包管理器">#</a></h2> <h3>Chocolaty <span></span><a href="#chocolaty">#</a></h3> <p><a href="https://chocolatey.org/">官网</a> | <a href="https://github.com/chocolatey/choco">源代码</a></p> <p>Windows 命令行包管理器，有<a href="https://github.com/chocolatey/ChocolateyGUI">配套 GUI</a>。</p> <h3>Scoop <span></span> <span></span><a href="#scoop-">#</a></h3> <p><a href="https://scoop.sh/">官网</a> | <a href="https://github.com/ScoopInstaller">源代码</a></p> <p>Windows 命令行软件安装器，有一定的包管理能力。</p> <h3>UniGetUI <span></span> <span></span> <span></span><a href="#unigetui--">#</a></h3> <p><a href="https://www.marticliment.com/unigetui/">官网</a> | <a href="https://github.com/marticliment/UniGetUI">源代码</a></p> <p>Windows 上各种 CLI 包管理器的整合 GUI。</p> <h3>Winget <span></span> <span></span><a href="#winget-">#</a></h3> <p><a href="https://learn.microsoft.com/zh-cn/windows/package-manager/">官网</a> | <a href="https://github.com/microsoft/winget-cli/">源代码</a></p> <p>Windows 程序包管理器服务的客户端接口。</p> <h2>开发工具<a href="#开发工具">#</a></h2> <h3>GitUI <span></span><a href="#gitui">#</a></h3> <p><a href="https://github.com/gitui-org/gitui">源代码</a></p> <p>Rust 版 LazyGit。作者给出的 BenchMark 中，GitUI 在解析整个 Linux 的源代码仓库时，用时为 LazyGit 的一半，占用内存更是不到十分之一，且更加稳定。</p> <h3>LazyGit <span></span> <span></span><a href="#lazygit-">#</a></h3> <p><a href="https://github.com/jesseduffield/lazygit">源代码</a></p> <p>好用的 Git TUI，适合不想记 Git 命令行操作又懒得开 Git GUI 的情况。</p> <h2>浏览器<a href="#浏览器">#</a></h2> <p>本节所有软件默认带 <span></span> 标记。一个现代浏览器要是还不支持多语言，不如直接埋了算了。</p> <h3>Chrome <span></span><a href="#chrome">#</a></h3> <p><a href="https://www.google.com/chrome/">官网</a> | <a href="https://github.com/chromium/chromium">源代码</a></p> <p>市占率最高的浏览器，也是绝大多数网页的主要兼容对象。Google 的同步功在大陆地区属于不可用状态，需要自行配置代理使用。</p> <h3>Firefox <span></span><a href="#firefox">#</a></h3> <p><a href="https://www.mozilla.org/zh-CN/firefox/">官网</a> | <a href="https://searchfox.org/mozilla-central/source">源代码</a></p> <p>唯一的非营利属性主流浏览器（虽然市占率已经低得不能看了（悲））。Firefox 的同步功能在国内也能流畅访问，这点算是优势了。此外 Firefox 还高度可自定义，可以自己搓 CSS、调配置，来获得真正「自己的」浏览器。但是魔改一时爽，更新火葬场。</p> <h3>Floorp <span></span> <span></span><a href="#floorp-">#</a></h3> <p><a href="https://floorp.app/">官网</a> | <a href="https://github.com/Floorp-Projects/Floorp">源代码</a></p> <p>基于 Firefox ESR 的开源浏览器，更新较慢，支持多行/垂直标签页和工作区功能（多行/垂直标签页设置需要手动打开）。Floorp 也自带并默认开启了很多实用的 Firefox 配置项，属于是懒人福音版 Firefox。</p> <h3>LibreWolf <span></span><a href="#librewolf">#</a></h3> <p><a href="https://librewolf.net/">官网</a> | <a href="https://codeberg.org/librewolf/source">源代码</a></p> <h3>Microsoft Edge<a href="#microsoft-edge">#</a></h3> <p><a href="https://www.microsoft.com/edge">官网</a></p> <p>微软自带的浏览器，纵向标签页和工作区还是比较好用的。且同步功能国内无需魔法即可访问，作为 Chrome 的替代品还是不错的。</p> <p>此外这个浏览器还是「不可替代」的，因为牢软在 Windows 11 中将系统里的网页链接设置为只能跳转到 Edge 打开，卸掉 Edge 直接不能打开，有点恶心人了（反垄断法呢，救一救啊）。</p> <h3>Thorium <span></span><a href="#thorium">#</a></h3> <p><a href="https://thorium.rocks/">官网</a> | <a href="https://github.com/Alex313031/Thorium">源代码</a></p> <p>Chromium 性能天花板，号称是最快的浏览器，低配置特攻。隐私保护上比 Chrome 强很多，去掉了很多谷歌的遥测，但终究还是 Chromium，Manifest V3 还是逃不掉的</p> <h3>Zen <span></span><a href="#zen">#</a></h3> <p><a href="https://zen-browser.app/">官网</a> | <a href="https://github.com/zen-browser/desktop">源代码</a></p> <p>Zen 是一个基于 Firefox 的浏览器，Arc 浏览器平替，只支持垂直标签页。</p> <h2>视频<a href="#视频">#</a></h2> <h3>Potplayer <span></span> <span></span><a href="#potplayer-">#</a></h3> <p><a href="https://potplayer.daum.net/">官网</a></p> <p>强大的多媒体播放器。</p> <p><span></span>：<a href="https://github.com/FFmpeg/web/blob/master/src/shame#L63">违反 FFmpeg 公共许可证</a></p> <h3>MPV <span></span> <span></span><a href="#mpv-">#</a></h3> <p><a href="https://mpv.io/">官网</a></p> <p>功能强大的多媒体播放器，默认 GUI 较简陋，但可扩展性极强。有一个开箱即用的 lazy-mpv 项目，更适合普通人使用。</p> <h2>同步<a href="#同步">#</a></h2> <h3>KDE Connect <span></span> <span></span><a href="#kde-connect-">#</a></h3> <p><a href="https://kdeconnect.kde.org/">官网</a> | <a href="https://invent.kde.org/network/kdeconnect-kde">源代码</a></p> <p>KDE 旗下用于电脑与手机协同的开源软件，可以共享剪贴板、跨设备访问文件、用手机遥控电脑、通过电脑查找手机位置、在电脑上查看手机的通知等。</p> <h3>Syncthing <span></span> <span></span> <span></span><a href="#syncthing--">#</a></h3> <p><a href="https://syncthing.net/">官网</a> | <a href="https://github.com/syncthing/syncthing">源代码</a></p> <p>文件夹同步软件，可以在不同设备中同步文件夹。自带 Web GUI，但是只能命令行启动。可以自行配置开机静默启动的脚本，或使用第三方包装器。</p> <h2>图像处理<a href="#图像处理">#</a></h2> <h3>Inkscape <span></span> <span></span><a href="#inkscape-">#</a></h3> <p><a href="https://inkscape.org/zh-hans/">官网</a> | <a href="https://gitlab.com/inkscape/inkscape">源代码</a></p> <p>专业的矢量图编辑器。</p> <h3>Krita <span></span> <span></span><a href="#krita-">#</a></h3> <p><a href="https://krita.org/zh-cn/">官网</a> | <a href="https://invent.kde.org/graphics/krita">源代码</a></p> <p>KDE 旗下的开源专业绘画软件。</p> <h3>Paint.NET <span></span><a href="#paintnet">#</a></h3> <p><a href="https://www.getpaint.net/">官网</a></p> <p>轻量级的图像编辑软件，适合不想启动 PhotoShop 这种重量级软件的场合。类似于 Notepad 和 IDE 的使用场景区别。</p> <h2>文本编辑器<a href="#文本编辑器">#</a></h2> <h3>Micro <span></span><a href="#micro">#</a></h3> <p><a href="https://github.com/zyedidia/micro">源代码</a></p> <p>轻量级 TUI 文本编辑器，Nano 的替代品。其快捷键符合 Windows 用户的习惯，也有 Nano 同款快捷键提示栏，学习曲线很平整。还自带简单的语法高亮，也可以添加 lua 插件，兼具一定的可拓展性。</p> <h3>NeoVim <span></span><a href="#neovim">#</a></h3> <p><a href="https://neovim.io/">官网</a> | <a href="https://github.com/neovim/neovim/">源代码</a></p> <p>TUI 文本编辑器，适合轻中量级文本编辑场景。使用 Lua 作为配置文件，可扩展性很强，可以通过配置与扩展支持 LSP，喜欢用 Vim 的话可以花时间把 NeoVim 配置成 IDE。</p> <h3>Notepad 3 <span></span> <span></span><a href="#notepad-3-">#</a></h3> <p><a href="https://rizonesoft.com/downloads/notepad3/">官网</a> | <a href="https://github.com/rizonesoft/Notepad3">源代码</a></p> <p>轻量级文本编辑器，适合用来干查看日志、调整配置文件、临时编写简单脚本的轻量使用场景，不用打开 VSCode 或其他 IDE。</p> <h3>Visual Studio Code <span></span> <span></span> <span></span><a href="#visual-studio-code--">#</a></h3> <p><a href="https://code.visualstudio.com/">官网</a> | <a href="https://github.com/microsoft/vscode">源代码</a></p> <p>开源^{<a href="#user-content-fn-2">2</a>}的 GUI 文本编辑器，Electron 的性能巅峰之作，微软的开源项目头牌之一。</p> <p>一点简单的使用建议：通过不同的配置文件和工作区来管理 VSCode，保证默认情况下能以最快速度打开 VSCode 而不必等待无用插件加载。</p> <h2>下载<a href="#下载">#</a></h2> <h3>Aria2 <span></span> <span></span><a href="#aria2-">#</a></h3> <p><a href="https://aria2.github.io/">官网</a> | <a href="https://github.com/aria2/aria2">源代码</a></p> <h3>Internet Download Manager <span></span> <span></span><a href="#internet-download-manager-">#</a></h3> <p><a href="https://www.internetdownloadmanager.com/">官网</a></p> <p>下载速度很好、网页嗅探能力很强的下载器。</p> <h3>Motrix <span></span> <span></span> <span></span><a href="#motrix--">#</a></h3> <p><a href="https://motrix.app/">官网</a> | <a href="https://github.com/agalwood/Motrix">源代码</a></p> <p>Aria2 的包装版，使用修改的 Aria2 作为内核。</p> <p><span></span>：自 2023 年后不再维护</p> <h2>压缩<a href="#压缩">#</a></h2> <h3>7-Zip <span></span> <span></span><a href="#7-zip-">#</a></h3> <p><a href="https://www.7zip.com/cn/">官网</a> | <a href="https://sourceforge.net/projects/sevenzip/">源代码</a></p> <p>老牌开源压缩软件，界面比较简陋。</p> <h3>Bandizip <span></span> <span></span><a href="#bandizip-">#</a></h3> <p><a href="https://www.bandisoft.com/bandizip/">官网</a></p> <p>免费好用的压缩软件。</p> <p><span></span>：目前最新版的免费版本会有无法关闭的广告，甚至有桌面弹窗广告。可以通过下载<a href="https://www.bandisoft.com/bandizip/old/6/">无广告的旧版</a>来解决该问题。</p> <h3>NanaZip <span></span> <span></span> <span></span><a href="#nanazip--">#</a></h3> <p><a href="https://github.com/M2Team/NanaZip">源代码</a></p> <p>基于 7-Zip 的开源压缩软件，优化了 GUI 以及 Windows 10/11 上的使用体验。</p> <h2>音乐<a href="#音乐">#</a></h2> <h3>Dopamine <span></span> <span></span> <span></span><a href="#dopamine--">#</a></h3> <p><a href="https://digimezzo.github.io/site/">官网</a> | <a href="https://github.com/digimezzo/dopamine-windows">源代码</a></p> <p>界面美观清爽的开源音乐播放器。</p> <p><span></span>：不能识别音乐标签内的歌词</p> <h3>Listen1 <span></span> <span></span><a href="#listen1-">#</a></h3> <p><a href="https://listen1.github.io/listen1/">官网</a> | <a href="https://github.com/listen1/listen1_desktop">源代码</a></p> <p>N 合一的国内在线音乐平台播放器，可以不用安装国内的几个音乐平台的客户端了。</p> <h3>MusicPlayer2 <span></span> <span></span><a href="#musicplayer2-">#</a></h3> <p><a href="https://github.com/zhongyang219/MusicPlayer2">源代码</a></p> <p>好用的本地音乐播放器。</p> <h3>Nora <span></span> <span></span> <span></span><a href="#nora--">#</a></h3> <p><a href="https://noramusic.netlify.app/">官网</a> | <a href="https://github.com/Sandakan/Nora">源代码</a></p> <p>基于 Electron 和 React 的音乐播放器。</p> <p><span></span>: 无法播放部分未处理的 FLAC 格式音乐。</p> <h3>Salt Player for Windows <span></span> <span></span><a href="#salt-player-for-windows-">#</a></h3> <p><a href="https://moriafly.com/program/spw.html">官网</a></p> <p>安卓上广受好评的 <a href="https://moriafly.com/program/salt-player.html">Salt Player</a> 的 Windows 版本，目前处于开发测试阶段，需要在 Telegram 群上获取测试版本安装包。</p> <h2>邮件<a href="#邮件">#</a></h2> <h3>Thunderbird <span></span> <span></span> <span></span><a href="#thunderbird--">#</a></h3> <p><a href="https://www.thunderbird.net/zh-CN/">官网</a> | 源代码</p> <p>Mozilla 旗下的开源邮件客户端，界面不太现代，但是使用可以使用插件修改。</p> <h3>Mailspring <span></span> <span></span><a href="#mailspring-">#</a></h3> <p><a href="https://getmailspring.com/">官网</a> | <a href="https://github.com/Foundry376/Mailspring">源代码</a></p> <h2>游戏<a href="#游戏">#</a></h2> <h3>Epic <span></span><a href="#epic">#</a></h3> <p><a href="https://www.epicgames.com/store/">官网</a></p> <p>赠送大量游戏的游戏平台。</p> <h3>GOG <span></span><a href="#gog">#</a></h3> <p><a href="https://www.gog.com/">官网</a></p> <p>售卖未加密（DRM-free）游戏的游戏平台</p> <h3>Playnite <span></span> <span></span><a href="#playnite-">#</a></h3> <p><a href="https://www.playnite.link/">官网</a> | <a href="https://github.com/JosefNemec/Playnite/">源代码</a></p> <p>开源的本地游戏管理平台，可以管理各个游戏平台上的游戏与本地的游戏。优势在于统一管理分散在各种不同平台的游戏，并通过插件提供统一的游戏信息统计。如果玩的游戏的平台很混乱，或者玩的很多游戏是没有比较细游戏数据统计的，或者干脆就是本地的游戏，可以考虑使用该软件整合所有游戏。</p> <h3>Steam <span></span><a href="#steam">#</a></h3> <p><a href="https://store.steampowered.com/">官网</a></p> <p>使用体验上最好的游戏平台，靠着使用体验来让人买正版游戏。</p> <h2>终端<a href="#终端">#</a></h2> <h3>Alacritty <span></span><a href="#alacritty">#</a></h3> <p><a href="https://alacritty.org/">官网</a> | <a href="https://github.com/alacritty/alacritty">源代码</a></p> <p>Rust 编写的高性能跨平台终端模拟器。速度比 WezTerm 更快，但是功能支持少一些（如连字特性）。使用 YAML 作为配置文件，没有图形化配置界面。是少数支持触控屏使用的终端模拟器。需要使用 Tmux 才能实现其他终端的一些功能。</p> <h3>Warp<a href="#warp">#</a></h3> <p><a href="https://www.warp.dev/">官网</a></p> <p>嵌入 AI 功能的终端模拟器。颜值高，功能多，但是强制登录后使用。</p> <h3>WezTerm <span></span><a href="#wezterm">#</a></h3> <p><a href="http://wezterm.org/">官网</a> | <a href="https://github.com/wezterm/wezterm">源代码</a></p> <p>Rust 编写的高性能跨平台终端模拟器。使用 Lua 作为配置文件，可扩展性和配置文件可复用性都很强。</p> <p>正式版本长期（一年）未更新，但是开发并未暂停，一部分 BUG 可以通过使用 nightly 版本解决。</p> <h3>Windows Terminal <span></span> <span></span><a href="#windows-terminal-">#</a></h3> <p><a href="https://learn.microsoft.com/zh-cn/windows/terminal/">官网</a> | <a href="https://github.com/microsoft/terminal">源代码</a></p> <p>Windows 11 自带的终端模拟器。颜值高，集成 Windows 和微软的部分功能（如 WSL、Azure 等）。</p> <h2>自定义<a href="#自定义">#</a></h2> <h3>Rainmeter <span></span> <span></span><a href="#rainmeter-">#</a></h3> <p><a href="https://www.rainmeter.net/">官网</a> | <a href="https://github.com/rainmeter/rainmeter">源代码</a></p> <p>知名的桌面美化软件。</p> <h3>Sucrose Wallpaper Engine <span></span> <span></span><a href="#sucrose-wallpaper-engine-">#</a></h3> <p><a href="https://github.com/Taiizor/Sucrose">源代码</a></p> <p>Wallpaper Engine 的开源替代品。</p> <h3>Wallpaper Engine <span></span> <span></span><a href="#wallpaper-engine-">#</a></h3> <p><a href="https://www.wallpaperengine.io/">官网</a></p> <p>著名的小红车，为桌面添加各式各样的动态壁纸以及<strong>滥用</strong>地使用它传输资源。</p> <h3>WindHawk <span></span> <span></span><a href="#windhawk-">#</a></h3> <p><a href="https://windhawk.net/">官网</a> | <a href="https://github.com/ramensoftware/windhawk">源代码</a></p> <p>各种实用的 Windows 软件修改的集合。常见用处是修改 Windows 11 天怒人怨的右键菜单与开始菜单。</p> <h2>BLACKLIST<a href="#blacklist">#</a></h2> <p>虽然是 Awesome 软件，但黑名单感觉还是有必要记一个的。</p> <h3>360、2345 等一众全家桶<a href="#3602345-等一众全家桶">#</a></h3> <p>味大，无需多言。典型的有 360、2345、百度、腾讯、搜狗、瑞星等，尽量避免下载这些全家桶软件。</p> <p>其中 360 安全卫士极速版可用于快速清理被各种全家桶污染的系统，自己卸载起来也还算简单；几个输入法可以使用，但需要火绒之类的软件清理弹窗广告。</p> <h3>Notepad++<a href="#notepad">#</a></h3> <p>作者曾表示会在不认可其政治观点的使用者的源代码中添加随机字符（虽然作者随后称之为玩笑）。</p> <p>即便你有审查其代码下毒情况的能力与精力，也不建议花费在这个有众多相似生态位替代品的软件上。</p> <h2>致谢<a href="#致谢">#</a></h2> <p>本篇文章灵感来自于 <a href="https://github.com/0PandaDEV/awesome-windows">awesome-windows</a> 项目。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p>自行部署建议使用 Rust 编写的轻量版本 <a href="https://github.com/dani-garcia/vaultwarden">VaultWarden</a>。 <a href="#user-content-fnref-1">↩</a></p> </li> <li> <p>VSCode 绝大部分是开源的，但是少部分功能（如微软账号登录和遥测）和官方插件（如 Pylance）是闭源的。 <a href="#user-content-fnref-2">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/data-loss-by-foolish-mistake/https://blog.hpcesia.com/posts/data-loss-by-foolish-mistake/Sun, 30 Mar 2025 07:28:00 GMT<article> <h2>发生了什么<a href="#发生了什么">#</a></h2> <p><a href="/posts/monthly-journal-4/">月寄（四）</a>中有提到，我因为之前在用的电脑突然坏了，换了一台新电脑。过了一段时间，旧电脑修好了，我自然是要把数据转移到新电脑上的。</p> <p>一开始，我是用的局域网无线传输，受宿舍的路由器小水管限制，速度只能说相当便秘。所以就先传了一些小文件，比如 ssh 私钥、一些当时想起来了的配置文件，以及没有上传到在线存储库的代码之类的。等到传完我存的两个 G 多点的教材电子书之后，我就受不了这传输速度了。</p> <p>但问题在于，我的两个电脑的接口配置比较尴尬。新电脑有雷电 4 接口，但是没 RJ45 网口；旧电脑有 RJ45 网口，但是只有 USB Gen2 Type-C 口，正好错开，没法一根线互传。雷电 4 的扩展坞又价格不菲，所以我最后选择直接把旧电脑上的硬盘拆下来装在新电脑上来传文件。</p> <p>但是我忘了一件事——我也没考虑过——旧电脑的两块硬盘，是组了 RAID0 的。事后诸葛亮一下，也是有不少迹象说明了这个事实，比如我的旧电脑 D 盘容量是正正好好的 1T，超出了硬盘的物理容量。</p> <p>但是我当时并未考虑这些，只是在插上硬盘后，发现没有直接显示，于是去 Win 11 的磁盘管理那里给旧电脑的硬盘点了下「新建卷」。当 Windows 提示我这个硬盘里全是 RAW 数据，需要格式化的时候，我才发现有点不对劲，赶紧把硬盘拆了重新装回旧电脑。果不其然，进不去系统了，甚至 BIOS 里找不到另一张旧硬盘。</p> <p>之后又是调 BIOS 设置，又是做 PE 系统（还好前两天想着可能新电脑会用上 PE 系统，才买了个 U 盘），又是各种软件恢复分区恢复数据的，各家 AI 也问了一圈，花了两个多小时，也只能看到旧电脑的部分目录信息。进一步恢复需要 DiskGenius 的专业版，还不知道行不行得通。</p> <p>考虑到重要文件其实之前就已经转移出来了，剩下的基本都是各种游戏，我选择不再浪费更多时间，直接格式化重装系统完事。反正这台旧电脑最后要给家里长辈用，交过去之前肯定要重装系统的。</p> <h2>清点损失<a href="#清点损失">#</a></h2> <p>既然决定放弃剩下的数据，那就该清点一下这次犯蠢导致的损失了。</p> <p>比较心痛的是在一开始局域网转移数据的时候落下的 WSL 中的 .zshrc 配置文件。当初花了两天多的时间才配好一个用起来顺手性能也不错的 zsh，而且当时也没写经验纪录，丢了还是挺可惜的。</p> <p>其次是几个玩 MOD 的游戏的存档。Mod Organizer 2 的不同 MOD 配置独立存档的功能在这时候反而害了我，因为 Steam 云存档管不到。以及有个游戏玩的不是整合包，而是我自己一点点配的 MOD，整理的 MOD 列表和花时间做的冲突兼容补丁也没了。</p> <p>再之后就是几个比较难找的黄油资源了，不过平时因为都待在宿舍，也不会拿出来玩，丢了就丢了吧。</p> <p>C++、Python 和 Rust 的一些学习的时候写的代码丢了可能也算损失，不过这部分代码我自己看了都嫌丢人，还是不算在损失里了。</p> <p>剩下的被丢掉的大部分数据都是在云端有备份的，最多就是一些资源受限于百度云无 SVIP 的超绝下载速度和破除限制插件的用量限制，需要花不少时间才能下回来。</p> <p>总的来说，损失还处于可接受的范围。就是损失的原因太蠢了，想跑回去给自己扇个耳光让自己想清楚自己到底在干啥。</p> </article> https://blog.hpcesia.com/posts/monthly-journal-4/https://blog.hpcesia.com/posts/monthly-journal-4/Sun, 23 Mar 2025 11:54:26 GMT<article> <h2>前言<a href="#前言">#</a></h2> <p>是久违的月记！本次月记记录时间为：2 月 10 日 - 3 月 23 日。这些天都是在写论文、改代码和打游戏中度过的，如果有一直等着我更新月记的朋友，真的非常非常抱歉（鞠躬）。</p> <h2>毕业寄<a href="#毕业寄">#</a></h2> <p>又到了一年一度的毕业寄了。考研成绩上个月已经出来了，我只有 297 分，属于是烂得惨不忍睹了。一起考研的舍友倒是考得不错，拿了 412 分 (我口嗨也只敢写 404 分，后面还跟个 not found)，初试排名第二，想必是十拿九稳了。虽说今年分数普遍低，297 分接受调剂至少是能去个一般的学校读研的，不过为了读研而读研，实在是有点难看了。</p> <p>既然不能读研，就得准备工作了。我的专业此时就非常地尴尬——我熟悉的是前端开发和数值方法两个完全不搭边的领域。前端开发相关岗位普遍要求计算机相关专业，而且还需要掌握 Vue、React 等框架；而数值方法相关岗位则普遍要求有独立的数学建模能力，这又恰巧是我的弱项。</p> <p>目前先投了个拼多多的前端开发岗，还没笔试，希望问题不大。去不去是另一回事，至少得有点笔试面试经验是吧。21 号还去参加了一个学校组织的双选会，只投出去两份纸质简历，大概会是一轮游。</p> <p>毕业论文也在紧张刺激地进行当中了。花了两天时间写了个 Typst 的厦大本科毕业论文模板，用惯了 Typst 以后， 真的回不去了。</p> <p>论文本身倒是没写多少，深度学习这方面实在是有些玄学，调参和炼丹调配方简直如出一辙，都是看结果调整 magic number。我知道其中确实有某种深层的原理，但我没能力也没动力了解，毕竟又不是写硕士博士论文，要求这么高干嘛。</p> <p>导师倒是不怎么急，这周才告诉我该写初稿了。我各种笔记整理了不少，写个综述算是绰绰有余了，正文写什么东西还是没啥头绪。</p> <h2>更换电脑<a href="#更换电脑">#</a></h2> <h3>旧电脑的离去<a href="#旧电脑的离去">#</a></h3> <p>非常不幸地，与我相伴了大学四年时光的笔记本，在 3 月 21 日周五这天突然开机失灵。</p> <p>其实这台电脑开机键失灵有一段时间了，所以我一般不会关机。奈何宿舍在工作日的 0-6 点会断电，虽然一般来说，断电后过一阵子，笔记本就会进入 Windows 系统的休眠模式，第二天早上只需要点几下鼠标就能唤醒。但有时候也会出现点鼠标不能唤醒的情况，这时候就需要按开机键唤醒休眠了。</p> <p>在此之前，开机键失灵的问题是华硕的开机键使用的是薄膜键盘，使用超过两年后（经典过保就坏的计划报废），薄膜的触点就可能黏连在一起，导致开机失灵。解决方法就是拆开开机键，用牙签或是镊子手动把两片薄膜挑开 （什么赛博微创手术）。</p> <p>但是 21 号不一样。面对开机键的失灵，我像往常一样把薄膜挑开又装回去，但笔记本并未像往常一样正常地开机。鉴于此时插拔电源时，电源指示灯还能正常的亮起，我并未太在意，在网上翻找了一些攻略后，选择按住开机键来释放静电。</p> <p>但这一按就按出事来了。也许是因为忘记了拔掉电源排线，按完三十秒开机键后，笔记本不仅没有正常开机，反倒是插拔电源时电源指示灯也不会亮起了。这种一般是主板出了点问题，比如南桥炸了之类的，我自己手上的工具是搞不定的，于是只能寄修。寄修花费倒是不算大，加上快递费用也没到 500 元。</p> <h3>新电脑的到来<a href="#新电脑的到来">#</a></h3> <p>寄修本身不是啥大事，但问题在于：我还有论文要写，还有几个安排在之后几天的计算机相关岗位的笔试。</p> <p>而且论文需要高性能笔记本跑代码，正好临近毕业，也差不多是时候换电脑了。所以我选择直接买了一台新电脑——联想 Thinkbook 16p。</p> <p>其实这个点买台 4060 显卡的笔记本，多少是有点亏的，尤其是我自己预算其实很充足的情况下。因为到 3 月底，搭载 RTX 50 系显卡的中高端游戏本就该上架了，一台 5080 显卡的笔记本，算上国补和加配内存硬盘，也只要一万六左右就能拿下，而我自己是出得起这个钱的。事实上，我本来也是打算买一台 4080 显卡的笔记本的，但问题是我想要的 4080 笔记本，京东自营没有一个是有货的；而非京东自营的发货速度又不如干脆等电脑修好。于是我选择了 Thinkbook 16p，一台 4060 显卡全能本。</p> <p>选择 4060 显卡的笔记本还有一点，就是 5060 显卡的笔记本还要再等一个多月才会上，显得我现在提前买不那么亏（笑）。以及能给家里省五千块钱，虽然也不缺我这五千，省点总是好的。反正也不是不能用是吧，我 2060 能用 4 年，打游戏也没觉得有多难受，4060 自然也不会有问题。</p> <p>此外，Thinkbook 16p 本身的外观设计和噪音控制我也还算满意，平时用着基本是听不到声音的，打打游戏噪音也没多大，还算不错。屏幕素质还算将就，16:10 的屏幕比例，以及支持 PD 的雷电 4 接口，在外面写写代码也能看。</p> <p>电脑刚到的兴奋劲已经过了，写着写着，就越来越后悔。写论文似乎是个伪需求——之前的数据和代码都不在，写也写不了多少东西，初稿也没到 DDL，不急于这一时。但是电脑已经联网激活了，七天无理由退货算是用不了了，还是就此为止吧，买完后悔也不是一次两次了。^{<a href="#user-content-fn-1">1</a>}</p> <blockquote> <p>当你有机会做出选择的时候，不要让自己后悔。</p> </blockquote> <h2>宝贵而又无谓的时间<a href="#宝贵而又无谓的时间">#</a></h2> <h3>白白浪费的时间<a href="#白白浪费的时间">#</a></h3> <p>开学以来的这些天，我的作息都是完全混乱的，通宵次数比我大学之前三年加起来都多，而且还没做什么有意义的事，不外乎把时间耗费在了刷知乎、刷视频上。有时候会想，我浪费的那么多时间，哪怕是用来打游戏呢？起码用在打游戏上面，我会少很多手游活动等到最后「死线冲刺」的情况。</p> <p>为什么说刷知乎、刷视频是无意义的事呢？因为作为一个娱乐行为，它几乎没有给我留下任何印象。这些时间用在玩游戏上，我留下了对游戏里的剧情、风景、战斗、玩法的印象；用在看小说、漫画、番剧上，我也留下了对他们剧情的印象；用在解数学题、写代码上（是的，我认为这两件事完全可以是娱乐活动），更是收获了经验和知识。这些娱乐留下的痕迹可能非常轻微，但我可以系统地回忆起它们，它们的存在，证明着我为此消耗的时间是真切存在的。</p> <p>但刷视频，尤其是刷一些甚至翻来覆去看过好多遍的段子视频，它们似乎是直接从我的大脑皮层上滑走了，我现在也只记得「我看过许多相同的段子」这个事实，对这些段子表达了什么，则是难以回想起来。</p> <h3>重视与轻视的集合<a href="#重视与轻视的集合">#</a></h3> <p>我「不爱看」动画番剧。我的硬盘里存储着全集的《BangDream It’s MyGO!!!》 和 《Girl Bands Cry》，两部我久闻盛名的少女乐队番剧^{<a href="#user-content-fn-2">2</a>}，但是我把它们下载下来以后，就再也没打开过。我想过在坐飞机的时候，时间正好可以拿来补补番——自认为多少算个二次元，不看点番成何体统。但实际情况是，我飞机上并没有打开下载好的番剧，而是在玩「毫无意义」的数独。</p> <p>为什么我会想着在坐飞机的时候补番呢？因为那段时间恰好是「不那么有意义」的。我担心，甚至恐惧着，长时间的观看番剧，会浪费掉我「本该有意义的时间」。</p> <h3>自己骗自己<a href="#自己骗自己">#</a></h3> <p>但是，对浪费时间的恐惧，于我而言，只是一个伪命题。没有选择花费在补番上的时间，它们并没有去到多少「有意义」的事情上。因为害怕浪费时间而没有做的某件事，只不过是自己骗自己。</p> <p>不过，自己骗自己，多少也是有点用的吧。</p> <p>我给自己的手机设置了「健康时间手机」的限制——每个应用^{<a href="#user-content-fn-3">3</a>}每天使用时长不能超过半小时。这个限制有三种状态：第一种，我记得设置的 6 位数密码；第二种，我可以使用早已熟悉的密保问题「你的小学班主任是谁」来重置密码；第三种，我需要在手机上一个混杂这特殊字符和大小写字母手机账号密码来重置「健康使用手机」的密码。</p> <p>显然，这三种状态的限制，本质都是「自己骗自己」，因为我随时可以解开这个限制，只需要花费不到半分钟。但是它们确实产生了截然不同的效果。</p> <p>第一种限制，它甚至不能打断我使用这个应用。当禁止使用的页面弹出来时，我会顺手输入密码延长使用时间，然后继续沉迷于刷视频/知乎之中。</p> <p>第二种限制，它能够打断我连续使用被限制的应用，但是当我突然兴致来了的时候，它无法阻挡我的使用。</p> <p>第三种限制，能够让我在一定程度上打消打开应用的想法。打开被限制的应用，弹出已达限制的窗口时，一想到要输一个又臭又长的密码才能用，我就瞬间懒癌发作不想打开这个应用了。</p> <h3>思考的时间<a href="#思考的时间">#</a></h3> <p>上面三种限制，除去越来越麻烦的流程本身，还有随着流程变麻烦而越来越长的思考时间。回忆和输入密码的这点时间，足够让我短暂地脱离沉迷，对自己是否还需要继续使用这个软件进行一个简单的判断。</p> <p>所以我喜欢博客评论这种非即时的网络社交模式，它留给我的思考时间足够长，足以让我斟酌用词、整理观点，给出我自己还算满意的文字。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p>其实写完这一节以后，我已经在考虑等月底把新电脑拿闲鱼去卖了，换台 5080 的笔记本来用。但是回过头来思考了一下，光是二手卖掉这一步就至少会亏掉国补的 2000 块，外加少许折旧，都够我买 64G 内存和 2T 硬盘了，还是算了。而且低价位的 5080 笔记本在游戏性能以外的配置多少会比较拉胯，刷了一堆吹现在新电脑的视频以后还是打消了这个念头。 <a href="#user-content-fnref-1">↩</a></p> </li> <li> <p>虽然 GBC 在国内人气其实比 MyGO 低不少，此处在名气上将其并列属于结合自身实际情况。 <a href="#user-content-fnref-2">↩</a></p> </li> <li> <p>其实并不是所有应用，像是 Obsidian 或者各种计算器、词典等学习软件，我都没有进行限制。 <a href="#user-content-fnref-3">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/astro-migration-journal/https://blog.hpcesia.com/posts/astro-migration-journal/这个人在摸鱼一个月之后终于舍得更新了。花了两天时间搬迁到了 Astro，新的开始！Sat, 15 Mar 2025 08:59:30 GMT<article> <h2>前言<a href="#前言">#</a></h2> <p>各位，许久不见。上次更新已经是整整一个月前了，这些天在和毕业论文和找工作进行激烈的豆蒸，都没多少时间折腾新主题。不过超过一个月时间不更新，多少有点说不过去，所以抽了一天时间出来，把博客迁移到了基础功能写得差不多的新主题 <a href="https://github.com/HPCesia/astral-halo">Astral Halo</a> 上来。</p> <p>写一个 <a href="https://astro.build/">Astro</a> 主题的想法，最初要追溯到 24 年 10 月。当时正在开发 <a href="https://github.com/HPCesia/hexo-highlighter-shiki">hexo-highlight-shiki</a>，被 Hexo （得益于厚重的历史） 不能原生支持 ESM 气晕。虽然最后使用 esbuild 解决了问题，但是给博客更换一个现代的前端框架也顺势加入了日程表。至于为什么是 Astro？一方面是在开发上述 Hexo 插件的时候，注意到了 Astro 是自带 <a href="https://shiki.tmrs.site/">Shiki</a> 作为代码块语法高亮器的；另一方面，则是<a href="https://github.com/chlorine3545/hugo-theme-efimero">小氯之前使用的主题</a>的<a href="https://github.com/kkbt0/Hugo-Landscape">原版</a>的原版：<a href="https://github.com/saicaca/fuwari">Fuwari</a>，是个 Astro 主题，正好可以参考。</p> <p>Astral Halo 主题本身则是从 25 年 1 月初开始动工的。最初的时候属于是两眼一抹黑，Fuwari 的源码看着是一头雾水，充斥着各种看不懂的逻辑。花了三个月时间，从简单粗暴地复制逻辑地面向报错编程，到 AI 辅助编写脚本，再到现在进化到 AI 只能帮倒忙，总算是做出现在的主题。直到昨天把博客迁移过来以后，我才发现了许多此前并未注意到的 bug。不过目前来看，至少是能跑的，所以暂且慢慢修复，再慢慢把 TODO list 肝完。</p> <h2>主题风格<a href="#主题风格">#</a></h2> <p>我自己并没有什么设计天赋，所以主题也就主打一个缝合怪，把自己喜欢的东西缝进去。主题的基底，是小屋使用的上一个主题 <a href="https://solitude.js.org/cn">Solitude</a>；更准确的来说，是<a href="https://blog.zhheo.com/">张洪Heo</a> 的博客主题，首页的整体布局缝自这里。精髓来自 Fuwari，我相当喜欢它的升降 Banner 的设计，所以花了点心思缝进了主题里，这也是我对这个主题最满意的功能之一。微妙的圆角和细边框则来自 <a href="https://ui.shadcn.com/">ShadcnUI</a>，相比于 Solitude 的粗边框更得我心。不过我并没有使用 ShadcnUI 的组件，而是使用的 <a href="https://daisyui.com/">DaisyUI</a>，这是一个纯 CSS 的 UI 库，免去了引入大量 JS 脚本。</p> <p>主题配色最终选择的是青色+粉色+米色/青褐，是从原神的<a href="https://genshin-impact.fandom.com/zh/wiki/%E5%B8%8C%E6%A0%BC%E9%9B%AF">希格雯</a>身上吸的颜色（准确地来说，是从<a href="https://www.bilibili.com/opus/1032545788390014999">角色介绍的配图</a>里吸的颜色），配色水平比我硬凑的好多了。本来目标是粉粉嫩嫩的可爱风，但实际效果嘛……浅色配浅色的可阅读性完全是灾难级的，几种颜色彻底糊成一团，对屏幕阅读相当不友好。所以我最终把对比度拉高了不少，看着还算不错。</p> <h2>开发流程<a href="#开发流程">#</a></h2> <p><a href="/posts/monthly-journal-3/">月寄（三）</a> 里有提到，我在开发新主题的时候，有使用 <a href="https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline">Roo Cline</a>（现在叫 Roo Code）辅助开发。我的 Roo Cline 使用的是 VSCode 的 Copilot LLM API，优点是 GitHub 学生认证后 Copilot Pro 是免费的，缺点则是不能使用图像^{<a href="#user-content-fn-1">1</a>}。Cursor 倒是没用过，有图像识别助力，想必开发速度能大大提高吧。</p> <p>Astral Halo 用的是最新的 <a href="https://tailwindcss.com/">TailWind4</a>，考虑到 AI 的对于较新或较小众的框架/语言的开发水平，我让 AI 负责的都是一次性代码和机械重复工作。一次性代码，主要是一些创建文章模板用的脚本，这些脚本只需要正常实现功能即可，代码的可阅读性、可维护性不重要，因此我让 AI 来编写。机械重复工作，则是有多份逻辑相似，但又不好提炼为模块的代码，需要重复填充，或是翻译不同语言的代码，这种工作正适合 AI 进行。比如，主题的创建文章草稿的功能，就是完全由 AI 编写的，我只负责提供最佳实践的思路和校验结果。</p> <p>因为没有图像识别功能，所以样式就不能交给 AI 来写，只能自己手搓。样式写起来最累的，还是 Twikoo 的样式。因为不想慢慢覆盖 Twikoo 的原生样式，我选择的是导入 nocss 版本，从零开始直接手搓自己的样式。不过根据<a href="https://chlo.is/">小氯</a>的说法，AI 对于搓 Twikoo 样式方面大概无能为力就是了。写这么久新主题，感觉所谓「前端三大护城河」里，只有 CSS 才是正儿八经的护城河（笑）。开发过程中，<a href="https://daisyui.com/">DaisyUI</a> 给了我相当多的思路，其使用的一些 CSS 技巧，在和 <a href="https://swup.js.org/">Swup.js</a> 豆蒸的时候相当实用——把 JS 脚本全干掉，就不用考虑 Swup 引入的 JS 脚本加载问题了。</p> <p>虽然 Astro 的<a href="https://docs.astro.build/zh-cn/concepts/islands/">群岛架构</a>提供了在 Astro 中嵌入 React、Vue、SolidJS 等一众前端框架组件的能力，但因为我自己并不会这些框架，只在集成 <a href="https://waline.js.org/">Waline</a> 的时候用上了群岛功能，内嵌了 <a href="https://waline.js.org/cookbook/import/project.html#%E5%9C%A8-vue-%E9%A1%B9%E7%9B%AE%E4%B8%AD%E5%AF%BC%E5%85%A5">Waline 提供的 Vue 组件</a>。后续开发过程中，可能也就音乐播放器会用得上群岛架构了。</p> <p>总之，先慢慢修 bug 吧，今天再修一天，明天又得继续和毕业论文与春招搏斗了（悲）。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p>注：在写完这篇文章后的某次更新中，GitHub Copilot 已经可以上传附件并调用图像识别功能了。 <a href="#user-content-fnref-1">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/monthly-journal-3/https://blog.hpcesia.com/posts/monthly-journal-3/Tue, 11 Feb 2025 11:43:43 GMT<article> <p>本次月记记录时间为：1 月 17 日 - 2 月 9 日。</p> <h2>AI 辅助开发<a href="#ai-辅助开发">#</a></h2> <p>最近，我在使用 Astro 给自己开发一个全新的主题，同时也第一次尝试了新一代的 AI 辅助开发。此前，我主要都是在使用 VSCode 的 Continue 插件，使用 AI 进行代码补全，以及使用对话功能来问问题。随着 Cursor、DeepSeek 的火爆，我决定也尝试一下新一代的 AI 辅助编程。</p> <p>出于某种 VSCode 情结，我没有选择去试用 Cursor，而是选择了 VSCode 的插件 Roo Cline。选择 Cline 的分支 Roo Cline 是因为这个分支版本可以调用 VSCode 自己的大模型接口，即调用 GitHub Copilot，而 GitHub Copilot 只限制对话次数，不限制每次对话使用的 token 量，Pro 版本不限次数，10 刀每月的价格也还算负担得起。</p> <p>使用体验下来，用来写一些简单的脚本，或者使用 AI 来进行「重复性」的修改，比如相似的两个代码，改完一个，让 AI 参考已有修改帮忙改另一个代码，这类工作 AI 做的还是很不错的。但是，对于一些复杂的逻辑，或者小众一点的插件，AI 的表现就不尽如人意了。很多时候 AI 会生成一些完全不可用的代码，与其慢慢通过对话让 AI 调整，还不如我自己直接看文档和其他开源代码自己手搓。</p> <h2>新主题<a href="#新主题">#</a></h2> <p>经过大半个月的爆肝开发，目前我的 Astro 新主题已经基本可用了。新主题基本就是缝的 <a href="https://github.com/saicaca/fuwari">Fuwari</a> 和现在用的 Solitude，而且因为用了比较新的包，比如 Tailwind 4，所以浏览器兼容性也比较悲惨。目前，新主题还处于开发阶段，我个人想要的功能还差一些没实现，但基本的功能已经差不多了，所以我就先把它开源并上线了一个 <a href="https://astral-halo.netlify.app/">Demo</a>。</p> <p>新主题名字叫「Astral Halo」，从「Moon Halo」根据开发框架的名字 Astro 变化而来，和 Halo 框架没啥关系就是了。等搓好了就可以切换到新主题了，这篇文章大概是最后一篇使用 Solitude 主题的文章了。</p> <h2>初试 DeepSeek<a href="#初试-deepseek">#</a></h2> <p>初试 DeepSeek R1，我选择让它来从我的过往周/月记来分析我在这个博客中的人设。得到的结果，让我亲身体验了一把什么叫“作者本人做阅读理解都及不了格”（笑）。比如在 周寄（三） 中，我聊到了我的保温杯迭代史。DeepSeek R1 分析认为，保温杯这节“是作者生存焦虑的具象化，反映了作者对完美容器的追寻，最终选择将博客作为自己的精神容器”。</p> <p>嗯，分析得很好，要是我自己写的时候也是这么想的就好了。事实只是我只是没啥好写的了，就拿保温杯来说事。</p> <h2>游戏<a href="#游戏">#</a></h2> <p>最近又把《辐射：新维加斯》（以下简称 FONV）捡回来了。之前因为这游戏翻来覆去玩了太多遍有些腻，外加上游戏原先使用的内核汉化（翻译游戏内部的文本字符串）会和我喜欢的 mod 起冲突，直接玩英文原版看着又太费劲，所以弃了半年。</p> <p>最近翻到之前知乎上对我配置畅玩 FONV 的 mod 配置帮助极大的《游骑兵指南》更新了，将汉化换成了外挂汉化（直接翻译游戏时屏幕显示文本）。外挂汉化除去一些文字位置和大小的问题外，与各种 mod 都算兼容相当良好的。简单尝试了一下后，我对 FONV 的激情又重新点燃了，这些天基本就是肝论文学习进度、肝新主题和打 FONV，顺便穿插一下几个米哈游游戏的活动和日常。 （然后因为春节活动相比惯例提前一天结束，错过了好多剧情和奖励，死线战士大失败）</p> <h2>轻功<a href="#轻功">#</a></h2> <p>起因是我最近做的一个梦，梦里我被人追杀，跑着跑着就开始飘了起来，追逐直接变成了皇牌空战。这种飘起来的感觉我很熟悉——在记忆里，我小时候经常在回家路上走着走着就飘起来，一开始是一步能跨上两三米才落地，然后越飘越高，直接飘到和家里阳台齐平。理性告诉我，这应当是我将自己的梦境和小时候的记忆混淆了，但这种印象却如此真实，让我难以否定这种飘起来的感觉只是臆想。</p> <p>过了两天，和我爸在吃完饭后闲聊，聊到我妈最近在学习中医，顺带着就聊到了一些比较「封建迷信」的东西。我爸说，他以前会做梦梦到自己飘了起来，就像小说里的轻功一般。我听了这话，心里一惊，这不就是我梦里的感觉吗？很好奇，这种感觉是不是人人都有的。此前我从没想过会有人与我有相同的「飘起来」的感受，如果这种感受是普遍存在的，那这可能就是所谓轻功的源头之一吧。</p> <h2>中医与「科学迷信」<a href="#中医与科学迷信">#</a></h2> <p>既然上文提到了我妈在学中医，那就顺便聊聊这个可能有点争议的点吧。我对中医的看法，很长一段时间都是「中医作为一种经验医学，应当通过科学的方式现代化」，具体到治疗手段，我对中药基本是嗤之以鼻的，对理疗则还算接受。</p> <p>而转折点则是我妈，在当了几十年医生以后，选择自学中医，并自费报名中医院的中医课程（正规课程，学习完可以开中药处方，但不能以中医身份行医）。这种中医学习名额，在不少医院都是免费拉人都难，但我妈却选择交钱也要学，还会通宵背书考试。本来在一开始，看到我妈买了一堆中药熬汤喝、拉住我去中医院看病的时候，我还觉得只是她人老了开始搞迷信了，直到我开始思考。</p> <p>我意识到一个问题：我有什么资格，来认为一个当了几十年医生，还会偶尔去任教医学生的人，她学习中医就是「封建迷信」？我自己又有什么资格，来认为中医是「迷信」？我对中医是「迷信」的认知，来源于网络上各种评论、文章对中医、中药的攻击，但我自己又有多少了解中医呢？我只有对中医是「迷信」的认知，却对这些认知的来源没有足够的了解，这不就是「科学迷信」吗？</p> </article> https://blog.hpcesia.com/posts/hello-pytorch-1-5/https://blog.hpcesia.com/posts/hello-pytorch-1-5/Fri, 31 Jan 2025 15:30:36 GMT<article> <h2>安装 pixi<a href="#安装-pixi">#</a></h2> <p>pixi 是一个跨平台的、与 conda 兼容的、通过 lock 文件保证可移植性的 python 管理工具。在终端中执行如下命令安装 pixi，其中进行了一次字符串替换，以使用 github 镜像站点进行下载：</p> <ul> <li> <p><strong>Windows</strong>：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>powershell</span><span> </span><span>-ExecutionPolicy</span><span> </span><span>ByPass</span><span> </span><span>-c</span><span> </span><span>"(irm -useb https://pixi.sh/install.ps1).Replace('https://github.com', 'https://github.site') | iex"</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p><strong>Linux/macOS</strong>：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>curl</span><span> </span><span>-sSL</span><span> </span><span>https://pixi.sh/install.sh</span><span> </span><span>|</span><span> </span><span>sed</span><span> </span><span>'s|https://github.com|https://github.site|g'</span><span> </span><span>|</span><span> </span><span>bash</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> </ul> <p>安装完成后，可以使用 <code>pixi</code> 命令进行包管理。建议参考<a href="https://pixi.sh/latest/#autocompletion">官网</a>为 pixi 添加命令补全。还需要为 pixi 添加国内镜像源，以加速包的下载。在终端中执行如下命令：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pixi</span><span> </span><span>config</span><span> </span><span>edit</span><span> </span><span>--global</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>此时会用系统自带的文本编辑器打开一个文件，在其中粘贴如下内容：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>~/.pixi/config.toml</span></div></div><div><div><div>2</div></div><div><span>[</span><span>pypi-config</span><span>]</span></div></div><div><div><div>3</div></div><div><span>index-url </span><span>=</span><span> </span><span>"https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h2>使用 pixi 安装 Pytorch 环境<a href="#使用-pixi-安装-pytorch-环境">#</a></h2> <p>新建一个目录，例如 ~/workspace/python，用于存放所有新的 Python 项目的文件夹。在终端中进入该文件夹后执行如下命令：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pixi</span><span> </span><span>init</span><span> </span><span>any_name</span><span> </span><span>--format</span><span> </span><span>pyproject</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>这会创建一个 ~/workspace/python/any_name 文件夹，目录结构为：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>any_name/</span></div></div><div><div><div>2</div></div><div><span>├── src/</span></div></div><div><div><div>3</div></div><div><span>│ └── any_name/</span></div></div><div><div><div>4</div></div><div><span>│ └── __init__.py</span></div></div><div><div><div>5</div></div><div><span>└── pyproject.toml</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>其中 <code>pyproject.toml</code> 是项目的配置文件，<code>src/</code> 是项目的源代码目录。打开 <code>pyproject.toml</code> 文件，添加如下内容：</p> <div><figure><figcaption><span>pyproject.toml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>[</span><span>tool.pixi.feature.gpu.system-requirements</span><span>]</span></div></div><div><div><div>2</div></div><div><span>cuda </span><span>=</span><span> </span><span>"12.0"</span></div></div><div><div><div>3</div></div><div> </div></div><div><div><div>4</div></div><div><span>[</span><span>tool.pixi.feature.gpu.dependencies</span><span>]</span></div></div><div><div><div>5</div></div><div><span>cuda-version </span><span>=</span><span> </span><span>"12.6"</span></div></div><div><div><div>6</div></div><div><span>pytorch-gpu </span><span>=</span><span> </span><span>"*"</span></div></div><div><div><div>7</div></div><div> </div></div><div><div><div>8</div></div><div><span>[</span><span>tool.pixi.feature.cpu.dependencies</span><span>]</span></div></div><div><div><div>9</div></div><div><span>pytorch-cpu </span><span>=</span><span> </span><span>"*"</span></div></div><div><div><div>10</div></div><div> </div></div><div><div><div>11</div></div><div><span>[</span><span>tool.pixi.environments</span><span>]</span></div></div><div><div><div>12</div></div><div><span>cpu </span><span>=</span><span> </span><span>[</span><span>"cpu"</span><span>]</span></div></div><div><div><div>13</div></div><div><span>default </span><span>=</span><span> </span><span>[</span><span>"gpu"</span><span>]</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接着在终端中执行如下命令：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pixi</span><span> </span><span>add</span><span> </span><span>scipy</span><span> </span><span>matplotlib</span><span> </span><span>deepxde</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>安装 pyproject.toml 中列出的依赖和新增的绘图库和深度学习库依赖，其中 DeepXDE 是一个多后端的深度学习库，主要用于数学求解。</p> </article> https://blog.hpcesia.com/posts/weekly-journal-4/https://blog.hpcesia.com/posts/weekly-journal-4/昼夜颠倒的拖延症废宅也能写点东西出来吗？Thu, 16 Jan 2025 14:01:22 GMT<article> <p>本次周记为期两周，记录时间：2024 年 12 月 30 日至 2025 年 1 月 16 日。拖了两周半才发，主要是因为我太懒狗了，写不动（悲）。</p> <h2>和论文搏斗<a href="#和论文搏斗">#</a></h2> <p>这一周，除去刷社交媒体、打游戏、写博客等阶段性考试结束后必备的娱乐生活外，我还在干正事——开始为写毕业论文做准备。虽然跟导师说好了每周汇报一下进度，不过这周还是没跟导师汇报。主要原因是写一个配置环境的文档比我想象中要麻烦不少，花了不少功夫才把论文的学习进度笔记写了个大概出来。好在导师没有太在意，问题不大。</p> <p>顺便期末成绩也出来了，我自己预估期末卷面只有 15 分不到的多复变函数论，最终成绩是 61 分刚刚过线，只能说感谢老师不杀之恩了（笑）。</p> <p><a></a></p> <h2>足部保暖<a href="#足部保暖">#</a></h2> <p>现在已经是完全入冬了，虽然厦门的温度其实不算冷——白天 18°C 上下，晚上 10°C 上下，但很不幸，学校宿舍的空调没有暖风功能，所以即便平时都待在宿舍，也只能硬抗冷空气。而我又不想买一双一年只能用一个月的保暖拖鞋，所以我得想其他办法来熬过冬天。我的选择是：多穿点袜子。我买了两双迪卡侬的滑雪长袜穿在外面，负责保暖和挡住漏进来冷风，内层则是一直在穿的五指袜（注：好的五指袜穿着真的很舒服，对脚汗很多的人很友好，就是 30+/双的价格还是有点不友好）。虽然长时间在宿舍坐着还是很冷，但只要喝点热水，或者出去走走，脚就会相当暖和。</p> <h2>阴间作息<a href="#阴间作息">#</a></h2> <p>自从期末考完后，我便开始了每天的阴间作息：凌晨 4-5 点才睡觉，中午 12 点以后才起床，伴有偶尔通宵。就连这段字都是我在凌晨 3 点半的时候，既不想睡觉又不想打游戏，躺在床上用手机码的（自从写作工作流更新，手机与电脑可以无感同步写的博客文章以后，躺床上码字就成了我写博客的重要组成部分）。然后饮食也相当混乱，经常下午三四点去吃午饭，然后晚上十点左右吃顿夜宵。</p> <p>制约我熬夜时长的唯一要素是手机的电量，通常在夜间的高强度使用下，我这用了3年半、电池健康只剩77%的手机的电量就只剩20%不到了，如果再多玩一会儿，等早上起来，我就会收获一个没电关机的手机。甚至这点制约，只要我愿意下床拿一下充电宝，也不是不能解决。</p> <p>不过回家以后，为了省自己的零花钱和给家里省事，我每天早上都会开车跟我爸一起去他公司（顺便练练车技），我在我爸的房间里看文献/打游戏/鼓捣博客，中午蹭一顿饭。出于对汽车的力量的敬畏，我在家里的这几天都是至少保证 7 小时睡眠，作息多少调整得正常了一点。</p> <h2>新手机<a href="#新手机">#</a></h2> <p>一放假回到家，我便拿到了我的新手机（如果考研没过，就是家里买的最后一个了）：华为 Mate 70 RS。由于需要玩一些手游、使用 Syncthing、Obsidian，我没有选择升级到鸿蒙 Next，而是使用了鸿蒙 4.3。使用了一周下来，对比我之前用的 Mate 40 RS，感觉还是不错的。</p> <p>芯片性能方面，自华为被制裁以来，我就从来没对华为新手机的芯片性能有多大的指望，比麒麟 9000 强就算胜利。实际游戏体验也和 Mate 40 差距不大，稍微流畅一点。拍照和录像感觉效果还是可以的，麦克风收音效果不错，微距拍照很舒服，比 40 一凑近就糊完了强太多了。续航算是最惊喜的方面了，个人体感目前轻度使用一整天不充电是完全没问题的，相当持久。总体来说，还算是一次满意的手机换代体验。</p> <h2>新手办<a href="#新手办">#</a></h2> <p>顺便地，我买的手办也到了。其实早在上个月初，商家就已经发货了，只是我因为快毕业了，所以选择将手办寄到了家里，现在放假回家，才将其拆箱检视。由于造型比较复杂，加上网上看有不少翻车的情况，所以我拆箱的时候还是有点提心吊胆的，不过好在没有断件，粗看下来颜色也没啥问题，算是没翻车。</p> <p><a></a></p> <p>这算是我买的第二个比例手办了，上一个还是 21 年买的可莉。由于可莉的体形比较小，加上坐姿降了高度，导致我对最近到的这个爱莉的手办的大小产生了误判——直到我回家，发现床边那个跟床头柜一样大的箱子装着的是我的手办。虽然实际盒子大小没那么离谱，但也差不多有半个床头柜大小了。</p> <p><a></a></p> <p>不幸的是，拆开检查过以后，我也只能请手办回盒子里吃灰了，因为家里已经被我妈的衣服堆满了（悲）。只有等家里的新房装修完毕，我大概才有地方用来展示这个大手办。</p> <h2>听歌<a href="#听歌">#</a></h2> <p>不知道从什么时候开始，HOYO-MiX 就成为了我曲库中新歌几乎唯一的来源。目前我手机里共存有 3810 首歌曲，其中 2039 首来自 HOYO-MiX。一方面，是我个人很喜欢将音乐存到本地，这意味着 QQ 音乐、网易云音乐、Apple Music 等在线音乐软件的会员显得几乎没有必要（反正开了会员，下的歌也得把加密格式转换为普通的格式），因此我很少有其他渠道去听新歌；另一方面，HOYO-MiX 的歌真的是量大管饱、质量还好、风格多变，对我这种喜欢纯音乐的人来说，HOYO-MiX 创作的游戏配乐中大量的纯音乐正合适。</p> <p>这里推荐一些 HOYO-MiX 的歌里，我个人最喜欢的一部分歌曲（此处列出的均为我本地的歌曲信息）：</p> <ul> <li><strong>中文歌</strong>： <ul> <li>《Rage Beneath the Mountains 岩壑之崩》- 陈致逸/HOYO-MiX（这首不放在纯音乐是因为确实有不少中文歌词）</li> <li>《不眠之夜》- 张杰/HOYO-MiX</li> <li>《一颗方糖悬滞的时间》- 阿兰/HOYO-MiX</li> </ul> </li> <li><strong>英文歌</strong>： <ul> <li>《Rubia》- 周深</li> <li>《Oracle》- 黄霄雲/HOYO-MiX</li> <li>《No Ceiling》- HOYO-MiX</li> <li>《烬火 Emberfire》- 希林娜依高/HOYO-MiX</li> <li>《未行之路 The Road Not Taken》- HOYO-MiX/Aimer</li> <li>《踏上旅途 Take the Journey》- HOYO-MiX/Anthony Lynch</li> <li>《野火 Wildfire》- HOYO-MiX/Jonathan Steingard</li> <li>《WHITE NIGHT》- Jake Miller/HOYO-MiX</li> <li>《使一颗心免于哀伤》- 知更鸟/HOYO-MiX/Chevy</li> <li>《希望有羽毛和翅膀》- 知更鸟/HOYO-MiX/Chevy</li> <li>《pinKing》- ChiliChill/三Z-STUDIO/HOYO-MiX</li> <li>《火狱骑行》- 三Z-STUDIO/HOYO-MiX</li> <li>《Fearless》- 三Z-STUDIO/HOYO-MiX</li> </ul> </li> <li><strong>其他语言歌曲</strong>： <ul> <li>《轻涟 La vaguelette》- HOYO-MiX</li> <li>《纳塔 Natlan》- HOYO-MiX</li> <li>《崩坏世界的歌姬 (Movie Ver.)》- 小林未郁</li> <li>《不乱不破》- HOYO-MiX/Reol</li> <li>《小停再出发》- 三Z-STUDIO/HOYO-MiX</li> </ul> </li> <li><strong>纯音乐</strong>： <ul> <li>《For Kevin》- HOYO-MiX</li> <li>《Fantasy Note》- HOYO-MiX</li> <li>《Caelestinum Finale Termini 终天的闭幕曲》- 陈致逸/HOYO-MiX</li> <li>《璃月 Liyue》- 陈致逸/HOYO-MiX</li> <li>《皎洁的笑颜 Moonlike Smile》- 陈致逸/HOYO-MiX</li> <li>《浪沫起舞 Dance of Aphros》- HOYO-MiX</li> <li>《Innocent Age 无虑无猜的岁月》- 陈致逸/HOYO-MiX</li> <li>《无虑的应许 Pledge of Peace》- HOYO-MiX</li> <li>《Inevitable Conflict 激扬的韧战》- HOYO-MiX</li> <li>《寒光裂涛 Combat Beneath the Waves》- HOYO-MiX</li> <li>《仲夏夜绮思 Die Mittsommernacht-Fantasie》- HOYO-MiX</li> <li>《水仙十字安眠曲 A Narcissus Lullaby》- HOYO-MiX</li> <li>《夜诞的花冠 Night’s Crown of Flowers》- HOYO-MiX</li> <li>《绝命舞曲 Acoustic.》- 三Z-STUDIO/HOYO-MiX</li> </ul> </li> </ul> </article> https://blog.hpcesia.com/posts/hello-pytorch-1/https://blog.hpcesia.com/posts/hello-pytorch-1/Wed, 08 Jan 2025 16:50:49 GMT<article> <h2>安装 Docker<a href="#安装-docker">#</a></h2> <h3>Windows<a href="#windows">#</a></h3> <p>Windows 系统不能直接安装使用 Docker，需要先安装 WSL2（Windows Subsystem Linux 2）。以下以 x86 架构的 Windows 10 系统为例，进行 WSL2 的安装流程说明。</p> <ul> <li> <p><strong>检查系统版本</strong>（Windows 11 无需进行此步骤）：打开设置→系统→关于页面，检查 Windows 版本号，应为 2004、20H2、21H1、21H2、22H2 中的任意一个，否则需要更新 Windows 版本。</p> </li> <li> <p><strong>安装 Windows Terminal</strong>（Windows 11 无需进行此步骤。此步骤非必须，但建议进行）：访问 <a href="https://aka.ms/terminal">Windows Terminal | 微软应用商店</a> 并下载 Windows Terminal 安装器，运行该安装器即可安装 Windows Terminal。</p> </li> <li> <p><strong>安装 WSL2</strong>：在开始菜单中找到上一步安装的 Windows Terminal（或「终端」），右键→更多→以管理员身份运行，然后在其中输入并按回车执行如下命令：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>wsl</span><span> </span><span>--install</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>等待自动安装完成即可，过程中可能需要重启计算机。</p> </li> <li> <p><strong>设置 WSL2</strong>：打开开始菜单，找到上一步安装的「Ubuntu」并打开，初次使用会要求设置用户名与密码（输入密码时，屏幕不会显示任何字符，这称为「盲人键入」，是完全正常的现象），密码建议妥善保管（如果忘记密码，可以在 PowerShell 中使用 <code>wsl -u root</code> 进入 root 账户，然后使用 <code>passwd &lt;username&gt;</code> 命令为账户设置新密码。）。</p> </li> <li> <p><strong>设置软件仓库镜像源</strong>：由于国内大陆地区网络问题，需要为 Ubuntu 的软件仓库设置国内镜像源。以清华镜像源为例，在 Ubuntu 中执行如下指令：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>cat</span><span> </span><span>/etc/os-release</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>查看 Ubuntu 的版本号，在<a href="https://mirror.tuna.tsinghua.edu.cn/help/ubuntu/">清华镜像站</a>中找到并复制对应版本的代码。接着执行如下指令（注意 Ubuntu 24.04 版本及以上，需要将下面指令中的地址安装清华镜像源中的说明进行对应的替换）：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>cp</span><span> </span><span>/etc/apt/sources.list</span><span> </span><span>/etc/apt/sources.list.bak</span><span> </span><span># 备份</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>vi</span><span> </span><span>/etc/apt/sources.list</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 vi 打开文件，直接输入 ggdG （区分大小写）删除全部内容，接着按 i 键进入插入模式，单击右键将复制的代码粘贴进去，随后按 ESC 键退出插入模式，再输入 ，按回车保存并退出 vi。镜像源配置完成后，在 Ubuntu 中执行如下命令更新软件。</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>update</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>upgrade</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p><strong>安装 Docker</strong>：按照 Linux 系统的安装步骤，在 WSL2 中安装 Docker 即可。</p> </li> </ul> <h3>Linux<a href="#linux">#</a></h3> <p>Linux 系统可以直接安装使用 docker-ce，由于国内大陆地区网络问题，需要通过国内镜像源安装。下面以清华镜像源与 Ubuntu 系统（其他 Linux 发行版可参考 <a href="https://mirrors.tuna.tsinghua.edu.cn/help/docker-ce/">docker-ce | 清华大学开源软件镜像站</a>进行相关配置）为例，进行安装流程说明。</p> <ul> <li> <p><strong>卸载旧版本（如有）</strong>：在 bash 中输入并执行如下命令，下同：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt-get</span><span> </span><span>remove</span><span> </span><span>docker.io</span><span> </span><span>docker-doc</span><span> </span><span>docker-compose</span><span> </span><span>podman-docker</span><span> </span><span>containerd</span><span> </span><span>runc</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p><strong>安装依赖</strong>：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt-get</span><span> </span><span>update</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt-get</span><span> </span><span>install</span><span> </span><span>ca-certificates</span><span> </span><span>curl</span><span> </span><span>gnupg</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p><strong>下载 GPG key</strong>：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>mkdir</span><span> </span><span>-m</span><span> </span><span>0755</span><span> </span><span>-p</span><span> </span><span>/etc/apt/keyrings</span></div></div><div><div><div>2</div></div><div><span>curl</span><span> </span><span>-fsSL</span><span> </span><span>https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg</span><span> </span><span>|</span><span> </span><span>sudo</span><span> </span><span>gpg</span><span> </span><span>--dearmor</span><span> </span><span>-o</span><span> </span><span>/etc/apt/keyrings/docker.gpg</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p><strong>添加镜像源软件仓库</strong>：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>echo</span><span> </span><span>"deb [arch=</span><span>$(</span><span>dpkg</span><span> --print-architecture</span><span>)</span><span> signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu"</span><span>$(</span><span>.</span><span> </span><span>/etc/os-release</span><span> </span><span>&amp;&amp;</span><span> </span><span>echo</span><span> </span><span>"</span><span>$VERSION_CODENAME</span><span>"</span><span>)</span><span>" stable"</span><span> </span><span>|</span><span> </span><span>sudo</span><span> </span><span>tee</span><span> </span><span>/etc/apt/sources.list.d/docker.list</span><span> </span><span>&gt;</span><span> </span><span>/dev/null</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p><strong>安装 docker-ce</strong>：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt-get</span><span> </span><span>update</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt-get</span><span> </span><span>install</span><span> </span><span>docker-ce</span><span> </span><span>docker-ce-cli</span><span> </span><span>containerd.io</span><span> </span><span>\</span></div></div><div><div><div>3</div></div><div><span> </span><span>docker-buildx-plugin</span><span> </span><span>docker-compose-plugin</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </li> <li> <p><strong>配置 Docker 镜像仓库的镜像</strong>：由于国内大陆地区网络问题，需要为 Docker Hub 配置镜像或代理。目前较正规的镜像（即各大高校或腾讯、阿里、字节等大企业建立的镜像源）均已关停，需要自行寻找可用镜像源，此处使用目前可用的一个镜像 <a href="https://docker.1panel.live/">https://docker.1panel.live/</a> 讲解如何配置 Docker Hub 镜像。对于其他来源的镜像，如 nvcr.io、ghcr.io 等来源的镜像，目前南京大学仍有可用<a href="https://doc.nju.edu.cn/books/e1654">镜像源</a>。同时也可参考<a href="#%E8%87%AA%E5%BB%BA-docker-%E9%95%9C%E5%83%8F">附录</a>自建 Docker 镜像使用。同样使用 vi 打开 docker 的配置文件 /etc/docker/daemon.json</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>vi</span><span> </span><span>/etc/docker/daemon.json</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>通过方向键将光标移动到最外层的大括号对（<code>{}</code>）之间，按 i 键进入插入模式，输入如下内容（如果已有 <code>"registry-mirrors"</code>，则换成修改）：</p> <div><figure><figcaption><span>daemon.json</span></figcaption><pre><code><div><div><div>1</div></div><div><span>"registry-mirrors"</span><span>: </span><span>[</span><span>"https://docker.1panel.live"</span><span>]</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>随后按 ESC 键退出插入模式，再输入 ，按回车保存并退出。</p> </li> </ul> <h2>安装 PyTorch<a href="#安装-pytorch">#</a></h2> <p>安装完成 Docker 后，就可以开始配置 PyTorch 环境了。创建一个合适的目录用于存放 Docker 镜像，以下以 ~/workspace/pinn 作为示例目录进行讲解。</p> <p>在 Docker 中进行 Python 开发需要一个可以连接到容器内进行开发的集成开发环境（IDE），如 VSCode(Visual Studio Code) 或 Pycharm。如果不想安装集成开发环境，也可使用 Jupyter Lab 在浏览器中进行开发（但建议使用集成开发环境，而非 Jupyter）。</p> <h3>安装 CUDA 与 CuDNN<a href="#安装-cuda-与-cudnn">#</a></h3> <p>本节仅 Nvidia 显卡需要进行，默认系统已安装 Nvidia 显卡驱动。在终端中执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>nvidia-smi</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>可以看到一个报告显卡驱动状态的表格，找到「CUDA Version」，记下后面的版本号。打开 Nvidia 的 CUDA 下载网站 <a href="https://developer.nvidia.com/cuda-toolkit-archive">CUDA Toolkit Archive | NVIDIA Developer</a>，根据之前记下的版本号，点击进入对应版本的 CUDA 下载页面。下载界面会有 Linux/Windows 的版本选项，尽量选择下载本地（locally）版本。Windows 系统是一个 .exe 格式的安装器，下载后执行安装即可；Linux 版本是几行命令，复制到终端中执行即可，注意最新驱动下 Windows 系统无需额外为 WSL 安装 CUDA。</p> <p>如果 CUDA 为最新版（目前最新版为 12.6），可以直接在 <a href="https://developer.nvidia.com/cudnn-downloads">cuDNN Downloads | NVIDIA Developer</a> 下载最新版的 CuDNN，否则需要在 <a href="https://developer.nvidia.com/rdp/cudnn-archive">cuDNN Archive | NVIDIA Developer</a> 处下载对应 CUDA 版本的 CuDNN，注意需要注册一个账号才能下载。与 CUDA 相同，下载页面也提供了不同系统的不同版本安装下载方式。</p> <p>对 Windows 系统来说，此时在 WSL 中就已经可以使用 <code>nvidia-smi</code> 命令显示穿透到 WSL 中的显卡信息了。</p> <h3>构建镜像<a href="#构建镜像">#</a></h3> <p>新建一个文件 ~/workspace/pytorch/dockerfile，由于此时不再有 Linux 系统权限限制，Windows 系统可以使用</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>notepad.exe</span><span> </span><span>~/workspace/pytorch/dockerfile</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>调用 Windows 系统自带记事本进行编辑（如果安装了 VSCode，则 <code>notepad.exe</code> 改为 <code>code</code>）；Linux 系统仍可使用 vi 或 vim 进行编辑。</p> <p>由于不同的电脑配置需要使用不同的镜像，因此以下将分类讲解 Nvidia 显卡、AMD 显卡与纯 CPU 三种不同配置下构建镜像的方式。此处使用<a href="https://github.com/cnstark/pytorch-docker">前人已构建好的镜像</a>。</p> <div> <div> <p>Nvidia 显卡可以直接使用 PyTorch 提供的 docker 镜像作为基础进行开发。在 dockerfile 文件中输入如下内容：</p><div><figure><figcaption><span>~/workspace/pytorch/dockerfile</span></figcaption><pre><code><div><div><div>1</div></div><div><span>FROM</span><span> cnstark/pytorch:2.3.1-py3.10.15-cuda12.1.0-ubuntu22.04</span></div></div><div><div><div>2</div></div><div><span>WORKDIR</span><span> /workspace</span></div></div><div><div><div>3</div></div><div><span>COPY</span><span> requirements.txt requirements.txt</span></div></div><div><div><div>4</div></div><div><span>RUN</span><span> pip install -r requirements.txt -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div><span>RUN</span><span> rm -r /temp &amp;&amp; rm -r /root/.cache/pip</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </div> <div> <p>AMD 显卡可以使用 ROCm 来进行 PyTorch 开发（需要参考 <a href="https://rocm.docs.amd.com/projects/radeon/en/latest/docs/install/wsl/howto_wsl.html">WSL How to guide - Use ROCm on Radeon GPUs — Use ROCm on Radeon GPUs</a> 进行相关配置）。在 dockerfile 文件中输入如下内容：</p><div><figure><figcaption><span>~/workspace/pytorch/dockerfile</span></figcaption><pre><code><div><div><div>1</div></div><div><span>FROM</span><span> rocm/pytorch:rocm6.1.3_ubuntu22.04_py3.10_pytorch_release-2.1.2</span></div></div><div><div><div>2</div></div><div><span>WORKDIR</span><span> /workspace</span></div></div><div><div><div>3</div></div><div><span>COPY</span><span> requirements.txt requirements.txt</span></div></div><div><div><div>4</div></div><div><span>RUN</span><span> pip install -r requirements.txt -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div><span>RUN</span><span> rm -r /temp &amp;&amp; rm -r /root/.cache/pip</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </div> <div> <p>在 dockerfile 文件中输入如下内容：</p><div><figure><figcaption><span>~/workspace/pytorch/dockerfile</span></figcaption><pre><code><div><div><div>1</div></div><div><span>FROM</span><span> cnstark/pytorch:2.3.1-py3.10.15-ubuntu22.04</span></div></div><div><div><div>2</div></div><div><span>WORKDIR</span><span> /workspace</span></div></div><div><div><div>3</div></div><div><span>COPY</span><span> requirements.txt requirements.txt</span></div></div><div><div><div>4</div></div><div><span>RUN</span><span> pip install -r requirements.txt -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div><span>RUN</span><span> rm -r /temp &amp;&amp; rm -r /root/.cache/pip</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </div> </div> <p>如果使用 Jupyter Lab，则需要在 dockerfile 末尾添加两行：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>EXPOSE</span><span> 8888</span></div></div><div><div><div>2</div></div><div><span>ENTRYPOINT</span><span> [</span><span>"jupyter"</span><span>,</span><span>"lab"</span><span>,</span><span>"--ip=0.0.0.0"</span><span>,</span><span>"--allow-root"</span><span>,</span><span>"--no-browser"</span><span>]</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接着在同一目录下新建 requirements.txt 文件，这个文件里是其他需要的 Python 包，例如：</p> <div><figure><figcaption><span>~/workspace/pytorch/requirements.txt</span></figcaption><pre><code><div><div><div>1</div></div><div><span># Jupyter Lab 配置</span></div></div><div><div><div>2</div></div><div><span># 使用 Pycharm/VSCode/其他 IDE 编辑代码，这部分可以全部注释掉</span></div></div><div><div><div>3</div></div><div><span>jupyterlab </span><span># Jupyter Lab 本体</span></div></div><div><div><div>4</div></div><div><span>jupyterlab-language-pack-zh-CN </span><span># Jupyter Lab 中文语言包</span></div></div><div><div><div>5</div></div><div><span>jupyterlab-lsp </span><span># Jupyter Lab 语言服务器（LSP）支持</span></div></div><div><div><div>6</div></div><div><span>jedi-language-server </span><span># Jedi 语言服务器</span></div></div><div><div><div>7</div></div><div> </div></div><div><div><div>8</div></div><div><span># 其他需要的包</span></div></div><div><div><div>9</div></div><div><span>ipykernel </span><span># 运行 Jupyter Notebook 的核心包，使用 VSCode 时需要</span></div></div><div><div><div>10</div></div><div><span>scipy </span><span># 提供一些实用函数</span></div></div><div><div><div>11</div></div><div><span>pandas </span><span># 数据处理包，可以注释掉</span></div></div><div><div><div>12</div></div><div><span>matplotlib </span><span># 绘图包，如果需要导出数据用其他软件绘图，可以注释掉</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>最后再在统一目录下创建 docker-compose.yaml，根据创建 dockerfile 时的不同，分别填入如下内容：</p> <div> <div> <div><figure><figcaption><span>~/workspace/pytorch/docker-compose.yaml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>services</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>nvidia-pytorch</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>build</span><span>:</span><span> </span><span>.</span></div></div><div><div><div>4</div></div><div><span> </span><span>ipc</span><span>:</span><span> </span><span>host</span></div></div><div><div><div>5</div></div><div><span> </span><span>volumes</span><span>:</span></div></div><div><div><div>6</div></div><div><span> </span><span>-</span><span> </span><span>./data:/workspace</span></div></div><div><div><div>7</div></div><div><span> </span><span>deploy</span><span>:</span></div></div><div><div><div>8</div></div><div><span> </span><span>resources</span><span>:</span></div></div><div><div><div>9</div></div><div><span> </span><span>reservations</span><span>:</span></div></div><div><div><div>10</div></div><div><span> </span><span>devices</span><span>:</span></div></div><div><div><div>11</div></div><div><span> </span><span>-</span><span> </span><span>driver</span><span>:</span><span> </span><span>nvidia</span></div></div><div><div><div>12</div></div><div><span> </span><span>count</span><span>:</span><span> </span><span>1</span></div></div><div><div><div>13</div></div><div><span> </span><span>capabilities</span><span>:</span><span> </span><span>[</span><span>gpu</span><span>]</span></div></div><div><div><div>14</div></div><div><span> </span><span>tty</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>15</div></div><div><span> </span><span>stdin_open</span><span>:</span><span> </span><span>true</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </div> <div> <div><figure><figcaption><span>~/workspace/pytorch/docker-compose.yaml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>services</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>rocm-pytorch</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>build</span><span>:</span><span> </span><span>.</span></div></div><div><div><div>4</div></div><div><span> </span><span>cap_add</span><span>:</span></div></div><div><div><div>5</div></div><div><span> </span><span>-</span><span> </span><span>SYS_PTRACE</span></div></div><div><div><div>6</div></div><div><span> </span><span>security_opt</span><span>:</span></div></div><div><div><div>7</div></div><div><span> </span><span>-</span><span> </span><span>seccomp=unconfined</span></div></div><div><div><div>8</div></div><div><span> </span><span>ipc</span><span>:</span><span> </span><span>host</span></div></div><div><div><div>9</div></div><div><span> </span><span>shm_size</span><span>:</span><span> </span><span>8G</span></div></div><div><div><div>10</div></div><div><span> </span><span>devices</span><span>:</span></div></div><div><div><div>11</div></div><div><span> </span><span>-</span><span> </span><span>/dev/dxg</span></div></div><div><div><div>12</div></div><div><span> </span><span>volumes</span><span>:</span></div></div><div><div><div>13</div></div><div><span> </span><span>-</span><span> </span><span>./data:/workspace</span></div></div><div><div><div>14</div></div><div><span> </span><span>-</span><span> </span><span>/usr/lib/wsl/lib/libdxcore.so:/usr/lib/libdxcore.so</span></div></div><div><div><div>15</div></div><div><span> </span><span>-</span><span> </span><span>/opt/rocm/lib/libhsa-runtime64.so.1:/opt/rocm/lib/libhsa-runtime64.so.1</span></div></div><div><div><div>16</div></div><div><span> </span><span>tty</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>17</div></div><div><span> </span><span>stdin_open</span><span>:</span><span> </span><span>true</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>需要注意的是以上为 Windows 系统下的 docker-compose.ymal 文件，如果是 Linux，则需删除 volumes 中 workspace 以外的两项，同时修改 devices：</p><div><figure><figcaption><span>~/workspace/pytorch/docker-compose.yaml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>services</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>rocm-pytorch</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>build</span><span>:</span><span> </span><span>.</span></div></div><div><div><div>4</div></div><div><span> </span><span>cap_add</span><span>:</span></div></div><div><div><div>5</div></div><div><span> </span><span>-</span><span> </span><span>SYS_PTRACE</span></div></div><div><div><div>6</div></div><div><span> </span><span>security_opt</span><span>:</span></div></div><div><div><div>7</div></div><div><span> </span><span>-</span><span> </span><span>seccomp=unconfined</span></div></div><div><div><div>8</div></div><div><span> </span><span>ipc</span><span>:</span><span> </span><span>host</span></div></div><div><div><div>9</div></div><div><span> </span><span>shm_size</span><span>:</span><span> </span><span>8G</span></div></div><div><div><div>10</div></div><div><span> </span><span>devices</span><span>:</span></div></div><div><div><div>11</div></div><div><span> </span><span>-</span><span> </span><span>/dev/dxg</span></div></div><div><div><div>12</div></div><div><span> </span><span>-</span><span> </span><span>/dev/kfd</span></div></div><div><div><div>13</div></div><div><span> </span><span>-</span><span> </span><span>/dev/dri</span></div></div><div><div><div>14</div></div><div><span> </span><span>volumes</span><span>:</span></div></div><div><div><div>15</div></div><div><span> </span><span>-</span><span> </span><span>./data:/workspace</span></div></div><div><div><div>16</div></div><div><span> </span><span>-</span><span> </span><span>/usr/lib/wsl/lib/libdxcore.so:/usr/lib/libdxcore.so</span></div></div><div><div><div>17</div></div><div><span> </span><span>-</span><span> </span><span>/opt/rocm/lib/libhsa-runtime64.so.1:/opt/rocm/lib/libhsa-runtime64.so.1</span></div></div><div><div><div>18</div></div><div><span> </span><span>tty</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>19</div></div><div><span> </span><span>stdin_open</span><span>:</span><span> </span><span>true</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </div> <div> <div><figure><figcaption><span>~/workspace/pytorch/docker-compose.yaml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>services</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>pytorch</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>build</span><span>:</span><span> </span><span>.</span></div></div><div><div><div>4</div></div><div><span> </span><span>volumes</span><span>:</span></div></div><div><div><div>5</div></div><div><span> </span><span>-</span><span> </span><span>./data:/workspace</span></div></div><div><div><div>6</div></div><div><span> </span><span>tty</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>7</div></div><div><span> </span><span>stdin_open</span><span>:</span><span> </span><span>true</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </div> </div> <p>如果使用 Jupyter Lab，则需要在 volumes 前新增两行：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>ports</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>'8888:8888'</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>最后在 Linux/WSL 终端中执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>docker-compose</span><span> </span><span>up</span><span> </span><span>-d</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>即可启动容器，如果使用 Jupyter Lab，此时在浏览器中访问 <a href="https://127.0.0.1:8888/">https://127.0.0.1:8888/</a> 即可进入 Jupyter Lab 页面。对 VSCode，需要安装 Docker 扩展，在扩展侧边栏中右键刚刚建立的容器，启动并附加 VSCode 页面；对 Pycharm 或其他 IDE，请参考对应的官方文档。</p> <h2>附录<a href="#附录">#</a></h2> <h3>自建 Docker 镜像<a href="#自建-docker-镜像">#</a></h3> <p>Cloudflare Worker 搭建 Github 与 Docker 加速，来自<a href="https://linux.do/t/topic/107428">用GPT融了一个Cloudflare Workers的github下载 + Docke pull加速 - 开发调优 - LINUX DO</a>。建议自行修改部分代码（比如用 LLM 洗一遍），以防有大量相似代码的 Worker 导致被 Cloudflare 认定为滥用 Worker。</p> <div><figure><figcaption><span>worker.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>'use strict'</span><span>;</span></div></div><div><div><div>2</div></div><div> </div></div><div><div><div>3</div></div><div><span>const</span><span> HUB_HOST </span><span>=</span><span> </span><span>'registry-1.docker.io'</span><span>;</span></div></div><div><div><div>4</div></div><div><span>const</span><span> AUTH_URL </span><span>=</span><span> </span><span>'https://auth.docker.io'</span><span>;</span></div></div><div><div><div>5</div></div><div><span>const</span><span> WORKERS_URL </span><span>=</span><span> </span><span>'https://你的域名'</span><span>;</span></div></div><div><div><div>6</div></div><div><span>const</span><span> ASSET_URL </span><span>=</span><span> </span><span>'https://hunshcn.github.io/gh-proxy/'</span><span>;</span></div></div><div><div><div>7</div></div><div><span>const</span><span> PREFIX </span><span>=</span><span> </span><span>'/'</span><span>;</span></div></div><div><div><div>8</div></div><div><span>const</span><span> Config </span><span>=</span><span> </span><span>{</span><span> jsdelivr</span><span>:</span><span> </span><span>0</span><span> </span><span>};</span></div></div><div><div><div>9</div></div><div><span>const</span><span> whiteList </span><span>=</span><span> []</span><span>;</span></div></div><div><div><div>10</div></div><div> </div></div><div><div><div>11</div></div><div><span>const</span><span> exp1 </span><span>=</span><span> </span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>github</span><span>\.</span><span>com</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>\/</span><span>(</span><span>?:</span><span>releases</span><span>|</span><span>archive)</span><span>\/.</span><span>*</span><span>$</span><span>/</span><span>i</span><span>;</span></div></div><div><div><div>12</div></div><div><span>const</span><span> exp2 </span><span>=</span><span> </span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>github</span><span>\.</span><span>com</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>\/</span><span>(</span><span>?:</span><span>blob</span><span>|</span><span>raw)</span><span>\/.</span><span>*</span><span>$</span><span>/</span><span>i</span><span>;</span></div></div><div><div><div>13</div></div><div><span>const</span><span> exp3 </span><span>=</span><span> </span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>github</span><span>\.</span><span>com</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>\/</span><span>(</span><span>?:</span><span>info</span><span>|</span><span>git-)</span><span>.</span><span>*</span><span>$</span><span>/</span><span>i</span><span>;</span></div></div><div><div><div>14</div></div><div><span>const</span><span> exp4 </span><span>=</span><span> </span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>raw</span><span>\.</span><span>(</span><span>?:</span><span>githubusercontent</span><span>|</span><span>github)</span><span>\.</span><span>com</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>\/.</span><span>+</span><span>$</span><span>/</span><span>i</span><span>;</span></div></div><div><div><div>15</div></div><div><span>const</span><span> exp5 </span><span>=</span><span> </span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>gist</span><span>\.</span><span>(</span><span>?:</span><span>githubusercontent</span><span>|</span><span>github)</span><span>\.</span><span>com</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>\/.</span><span>+</span><span>$</span><span>/</span><span>i</span><span>;</span></div></div><div><div><div>16</div></div><div><span>const</span><span> exp6 </span><span>=</span><span> </span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>github</span><span>\.</span><span>com</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>\/</span><span>tags</span><span>.</span><span>*</span><span>$</span><span>/</span><span>i</span><span>;</span></div></div><div><div><div>17</div></div><div> </div></div><div><div><div>18</div></div><div><span>/** </span><span>@</span><span>type</span><span> </span><span>{</span><span>RequestInit</span><span>}</span><span> */</span></div></div><div><div><div>19</div></div><div><span>const</span><span> PREFLIGHT_INIT </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>20</div></div><div><span> </span><span>// @ts-ignore</span></div></div><div><div><div>21</div></div><div><span><span> </span></span><span>status</span><span>:</span><span> </span><span>204</span><span>,</span></div></div><div><div><div>22</div></div><div><span><span> </span></span><span>headers</span><span>:</span><span> </span><span>new</span><span> </span><span>Headers</span><span>(</span><span>{</span></div></div><div><div><div>23</div></div><div><span> </span><span>'access-control-allow-origin'</span><span>:</span><span> </span><span>'*'</span><span>,</span></div></div><div><div><div>24</div></div><div><span> </span><span>'access-control-allow-methods'</span><span>:</span><span> </span><span>'GET, POST, PUT, PATCH, TRACE, DELETE, HEAD, OPTIONS'</span><span>,</span></div></div><div><div><div>25</div></div><div><span> </span><span>'access-control-max-age'</span><span>:</span><span> </span><span>'1728000'</span><span>,</span></div></div><div><div><div>26</div></div><div><span> </span><span>}</span><span>)</span><span>,</span></div></div><div><div><div>27</div></div><div><span>};</span></div></div><div><div><div>28</div></div><div> </div></div><div><div><div>29</div></div><div><span>/**</span></div></div><div><div><div>30</div></div><div><span><span> </span></span><span>* Create a new response.</span></div></div><div><div><div>31</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>any</span><span>}</span><span> </span><span>body</span></div></div><div><div><div>32</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>number</span><span>}</span><span> </span><span>[</span><span>status</span><span>=</span><span>200</span><span>]</span></div></div><div><div><div>33</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>Object&lt;string, string&gt;</span><span>}</span><span> </span><span>headers</span></div></div><div><div><div>34</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>Response</span><span>}</span></div></div><div><div><div>35</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>36</div></div><div><span>function</span><span> </span><span>makeResponse</span><span>(</span><span>body</span><span>,</span><span> </span><span>status</span><span> </span><span>=</span><span> </span><span>200</span><span>,</span><span> </span><span>headers</span><span> </span><span>=</span><span> </span><span>{})</span><span> </span><span>{</span></div></div><div><div><div>37</div></div><div><span><span> </span></span><span>headers[</span><span>'access-control-allow-origin'</span><span>] </span><span>=</span><span> </span><span>'*'</span><span>;</span></div></div><div><div><div>38</div></div><div><span> </span><span>return</span><span> </span><span>new</span><span> </span><span>Response</span><span>(body</span><span>,</span><span> </span><span>{</span><span> status</span><span>,</span><span> headers </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>39</div></div><div><span>}</span></div></div><div><div><div>40</div></div><div> </div></div><div><div><div>41</div></div><div><span>/**</span></div></div><div><div><div>42</div></div><div><span><span> </span></span><span>* Create a new URL object.</span></div></div><div><div><div>43</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>string</span><span>}</span><span> </span><span>urlStr</span></div></div><div><div><div>44</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>URL|null</span><span>}</span></div></div><div><div><div>45</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>46</div></div><div><span>function</span><span> </span><span>createURL</span><span>(</span><span>urlStr</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>47</div></div><div><span> </span><span>try</span><span> </span><span>{</span></div></div><div><div><div>48</div></div><div><span> </span><span>return</span><span> </span><span>new</span><span> </span><span>URL</span><span>(urlStr)</span><span>;</span></div></div><div><div><div>49</div></div><div><span> </span><span>}</span><span> </span><span>catch</span><span> (err) </span><span>{</span></div></div><div><div><div>50</div></div><div><span> </span><span>return</span><span> </span><span>null</span><span>;</span></div></div><div><div><div>51</div></div><div><span> </span><span>}</span></div></div><div><div><div>52</div></div><div><span>}</span></div></div><div><div><div>53</div></div><div> </div></div><div><div><div>54</div></div><div><span>addEventListener</span><span>(</span><span>'fetch'</span><span>,</span><span> </span><span>(</span><span>event</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>55</div></div><div><span><span> </span></span><span>event</span><span>.</span><span>respondWith</span><span>(</span></div></div><div><div><div>56</div></div><div><span> </span><span>handleFetchEvent</span><span>(event)</span><span>.</span><span>catch</span><span>(</span><span>(</span><span>err</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>makeResponse</span><span>(</span><span>`cfworker error:</span><span>\n</span><span>${</span><span>err</span><span>.</span><span>stack</span><span>}</span><span>`</span><span>,</span><span> </span><span>502</span><span>))</span></div></div><div><div><div>57</div></div><div><span><span> </span></span><span>)</span><span>;</span></div></div><div><div><div>58</div></div><div><span>}</span><span>)</span><span>;</span></div></div><div><div><div>59</div></div><div> </div></div><div><div><div>60</div></div><div><span>/**</span></div></div><div><div><div>61</div></div><div><span><span> </span></span><span>* Handle the fetch event.</span></div></div><div><div><div>62</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>FetchEvent</span><span>}</span><span> </span><span>event</span></div></div><div><div><div>63</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>Promise&lt;Response&gt;</span><span>}</span></div></div><div><div><div>64</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>65</div></div><div><span>async</span><span> </span><span>function</span><span> </span><span>handleFetchEvent</span><span>(</span><span>event</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>66</div></div><div><span> </span><span>const</span><span> req </span><span>=</span><span> event</span><span>.</span><span>request</span><span>;</span></div></div><div><div><div>67</div></div><div><span> </span><span>const</span><span> url </span><span>=</span><span> </span><span>new</span><span> </span><span>URL</span><span>(req</span><span>.</span><span>url)</span><span>;</span></div></div><div><div><div>68</div></div><div> </div></div><div><div><div>69</div></div><div><span> </span><span>if</span><span> (url</span><span>.</span><span>pathname</span><span>.</span><span>startsWith</span><span>(</span><span>'/token'</span><span>) </span><span>||</span><span> url</span><span>.</span><span>pathname</span><span>.</span><span>startsWith</span><span>(</span><span>'/v2'</span><span>)) </span><span>{</span></div></div><div><div><div>70</div></div><div><span> </span><span>return</span><span> </span><span>handleDockerProxy</span><span>(req</span><span>,</span><span> url)</span><span>;</span></div></div><div><div><div>71</div></div><div><span> </span><span>}</span></div></div><div><div><div>72</div></div><div> </div></div><div><div><div>73</div></div><div><span> </span><span>if</span><span> (url</span><span>.</span><span>pathname</span><span>.</span><span>startsWith</span><span>(PREFIX)) </span><span>{</span></div></div><div><div><div>74</div></div><div><span> </span><span>return</span><span> </span><span>handleGitHubProxy</span><span>(req</span><span>,</span><span> url)</span><span>;</span></div></div><div><div><div>75</div></div><div><span> </span><span>}</span></div></div><div><div><div>76</div></div><div> </div></div><div><div><div>77</div></div><div><span> </span><span>return</span><span> </span><span>makeResponse</span><span>(</span><span>'Not Found'</span><span>,</span><span> </span><span>404</span><span>)</span><span>;</span></div></div><div><div><div>78</div></div><div><span>}</span></div></div><div><div><div>79</div></div><div> </div></div><div><div><div>80</div></div><div><span>/**</span></div></div><div><div><div>81</div></div><div><span><span> </span></span><span>* Handle token requests and Docker proxy.</span></div></div><div><div><div>82</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>Request</span><span>}</span><span> </span><span>req</span></div></div><div><div><div>83</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>URL</span><span>}</span><span> </span><span>url</span></div></div><div><div><div>84</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>Promise&lt;Response&gt;</span><span>}</span></div></div><div><div><div>85</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>86</div></div><div><span>async</span><span> </span><span>function</span><span> </span><span>handleDockerProxy</span><span>(</span><span>req</span><span>,</span><span> </span><span>url</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>87</div></div><div><span> </span><span>if</span><span> (url</span><span>.</span><span>pathname </span><span>===</span><span> </span><span>'/token'</span><span>) </span><span>{</span></div></div><div><div><div>88</div></div><div><span> </span><span>const</span><span> tokenURL </span><span>=</span><span> AUTH_URL </span><span>+</span><span> url</span><span>.</span><span>pathname </span><span>+</span><span> url</span><span>.</span><span>search</span><span>;</span></div></div><div><div><div>89</div></div><div><span> </span><span>const</span><span> headers </span><span>=</span><span> </span><span>new</span><span> </span><span>Headers</span><span>(</span><span>{</span></div></div><div><div><div>90</div></div><div><span><span> </span></span><span>Host</span><span>:</span><span> </span><span>'auth.docker.io'</span><span>,</span></div></div><div><div><div>91</div></div><div><span> </span><span>'User-Agent'</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'User-Agent'</span><span>)</span><span>,</span></div></div><div><div><div>92</div></div><div><span><span> </span></span><span>Accept</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'Accept'</span><span>)</span><span>,</span></div></div><div><div><div>93</div></div><div><span> </span><span>'Accept-Language'</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'Accept-Language'</span><span>)</span><span>,</span></div></div><div><div><div>94</div></div><div><span> </span><span>'Accept-Encoding'</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'Accept-Encoding'</span><span>)</span><span>,</span></div></div><div><div><div>95</div></div><div><span><span> </span></span><span>Connection</span><span>:</span><span> </span><span>'keep-alive'</span><span>,</span></div></div><div><div><div>96</div></div><div><span> </span><span>'Cache-Control'</span><span>:</span><span> </span><span>'max-age=0'</span><span>,</span></div></div><div><div><div>97</div></div><div><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>98</div></div><div><span> </span><span>return</span><span> </span><span>fetch</span><span>(</span><span>new</span><span> </span><span>Request</span><span>(tokenURL</span><span>,</span><span> req)</span><span>,</span><span> </span><span>{</span><span> headers </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>99</div></div><div><span> </span><span>}</span></div></div><div><div><div>100</div></div><div> </div></div><div><div><div>101</div></div><div><span><span> </span></span><span>url</span><span>.</span><span>hostname </span><span>=</span><span> HUB_HOST</span><span>;</span></div></div><div><div><div>102</div></div><div><span> </span><span>const</span><span> headers </span><span>=</span><span> </span><span>new</span><span> </span><span>Headers</span><span>(</span><span>{</span></div></div><div><div><div>103</div></div><div><span><span> </span></span><span>Host</span><span>:</span><span> HUB_HOST</span><span>,</span></div></div><div><div><div>104</div></div><div><span> </span><span>'User-Agent'</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'User-Agent'</span><span>)</span><span>,</span></div></div><div><div><div>105</div></div><div><span><span> </span></span><span>Accept</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'Accept'</span><span>)</span><span>,</span></div></div><div><div><div>106</div></div><div><span> </span><span>'Accept-Language'</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'Accept-Language'</span><span>)</span><span>,</span></div></div><div><div><div>107</div></div><div><span> </span><span>'Accept-Encoding'</span><span>:</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'Accept-Encoding'</span><span>)</span><span>,</span></div></div><div><div><div>108</div></div><div><span><span> </span></span><span>Connection</span><span>:</span><span> </span><span>'keep-alive'</span><span>,</span></div></div><div><div><div>109</div></div><div><span> </span><span>'Cache-Control'</span><span>:</span><span> </span><span>'max-age=0'</span><span>,</span></div></div><div><div><div>110</div></div><div><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>111</div></div><div> </div></div><div><div><div>112</div></div><div><span> </span><span>if</span><span> (req</span><span>.</span><span>headers</span><span>.</span><span>has</span><span>(</span><span>'Authorization'</span><span>)) </span><span>{</span></div></div><div><div><div>113</div></div><div><span><span> </span></span><span>headers</span><span>.</span><span>set</span><span>(</span><span>'Authorization'</span><span>,</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>get</span><span>(</span><span>'Authorization'</span><span>))</span><span>;</span></div></div><div><div><div>114</div></div><div><span> </span><span>}</span></div></div><div><div><div>115</div></div><div> </div></div><div><div><div>116</div></div><div><span> </span><span>const</span><span> response </span><span>=</span><span> </span><span>await</span><span> </span><span>fetch</span><span>(</span><span>new</span><span> </span><span>Request</span><span>(url</span><span>,</span><span> req)</span><span>,</span><span> </span><span>{</span><span> headers </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>117</div></div><div><span> </span><span>const</span><span> responseHeaders </span><span>=</span><span> </span><span>new</span><span> </span><span>Headers</span><span>(response</span><span>.</span><span>headers)</span><span>;</span></div></div><div><div><div>118</div></div><div><span> </span><span>const</span><span> status </span><span>=</span><span> response</span><span>.</span><span>status</span><span>;</span></div></div><div><div><div>119</div></div><div> </div></div><div><div><div>120</div></div><div><span> </span><span>if</span><span> (responseHeaders</span><span>.</span><span>get</span><span>(</span><span>'Www-Authenticate'</span><span>)) </span><span>{</span></div></div><div><div><div>121</div></div><div><span> </span><span>const</span><span> authHeader </span><span>=</span><span> responseHeaders</span><span>.</span><span>get</span><span>(</span><span>'Www-Authenticate'</span><span>)</span><span>;</span></div></div><div><div><div>122</div></div><div><span> </span><span>const</span><span> re </span><span>=</span><span> </span><span>new</span><span> </span><span>RegExp</span><span>(AUTH_URL</span><span>,</span><span> </span><span>'g'</span><span>)</span><span>;</span></div></div><div><div><div>123</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>set</span><span>(</span><span>'Www-Authenticate'</span><span>,</span><span> authHeader</span><span>.</span><span>replace</span><span>(re</span><span>,</span><span> WORKERS_URL))</span><span>;</span></div></div><div><div><div>124</div></div><div><span> </span><span>}</span></div></div><div><div><div>125</div></div><div> </div></div><div><div><div>126</div></div><div><span> </span><span>if</span><span> (responseHeaders</span><span>.</span><span>get</span><span>(</span><span>'Location'</span><span>)) </span><span>{</span></div></div><div><div><div>127</div></div><div><span> </span><span>return</span><span> </span><span>handleHttpRedirect</span><span>(req</span><span>,</span><span> responseHeaders</span><span>.</span><span>get</span><span>(</span><span>'Location'</span><span>))</span><span>;</span></div></div><div><div><div>128</div></div><div><span> </span><span>}</span></div></div><div><div><div>129</div></div><div> </div></div><div><div><div>130</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>set</span><span>(</span><span>'access-control-expose-headers'</span><span>,</span><span> </span><span>'*'</span><span>)</span><span>;</span></div></div><div><div><div>131</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>set</span><span>(</span><span>'access-control-allow-origin'</span><span>,</span><span> </span><span>'*'</span><span>)</span><span>;</span></div></div><div><div><div>132</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>set</span><span>(</span><span>'Cache-Control'</span><span>,</span><span> </span><span>'max-age=1500'</span><span>)</span><span>;</span></div></div><div><div><div>133</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>delete</span><span>(</span><span>'Content-Security-Policy'</span><span>)</span><span>;</span></div></div><div><div><div>134</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>delete</span><span>(</span><span>'Content-Security-Policy-Report-Only'</span><span>)</span><span>;</span></div></div><div><div><div>135</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>delete</span><span>(</span><span>'Clear-Site-Data'</span><span>)</span><span>;</span></div></div><div><div><div>136</div></div><div> </div></div><div><div><div>137</div></div><div><span> </span><span>return</span><span> </span><span>new</span><span> </span><span>Response</span><span>(response</span><span>.</span><span>body</span><span>,</span><span> </span><span>{</span><span> status</span><span>,</span><span> headers</span><span>:</span><span> responseHeaders </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>138</div></div><div><span>}</span></div></div><div><div><div>139</div></div><div> </div></div><div><div><div>140</div></div><div><span>/**</span></div></div><div><div><div>141</div></div><div><span><span> </span></span><span>* Handle GitHub proxy requests.</span></div></div><div><div><div>142</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>Request</span><span>}</span><span> </span><span>req</span></div></div><div><div><div>143</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>URL</span><span>}</span><span> </span><span>url</span></div></div><div><div><div>144</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>Promise&lt;Response&gt;</span><span>}</span></div></div><div><div><div>145</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>146</div></div><div><span>async</span><span> </span><span>function</span><span> </span><span>handleGitHubProxy</span><span>(</span><span>req</span><span>,</span><span> </span><span>url</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>147</div></div><div><span> </span><span>let</span><span> path </span><span>=</span><span> url</span><span>.</span><span>searchParams</span><span>.</span><span>get</span><span>(</span><span>'q'</span><span>)</span><span>;</span></div></div><div><div><div>148</div></div><div><span> </span><span>if</span><span> (path) </span><span>{</span></div></div><div><div><div>149</div></div><div><span> </span><span>return</span><span> Response</span><span>.</span><span>redirect</span><span>(</span><span>'https://'</span><span> </span><span>+</span><span> url</span><span>.</span><span>host </span><span>+</span><span> PREFIX </span><span>+</span><span> path</span><span>,</span><span> </span><span>301</span><span>)</span><span>;</span></div></div><div><div><div>150</div></div><div><span> </span><span>}</span></div></div><div><div><div>151</div></div><div><span><span> </span></span><span>path </span><span>=</span><span> url</span><span>.</span><span>href</span><span>.</span><span>substr</span><span>(url</span><span>.</span><span>origin</span><span>.</span><span>length </span><span>+</span><span> </span><span>PREFIX</span><span>.</span><span>length)</span><span>.</span><span>replace</span><span>(</span><span>/</span><span>^</span><span>https</span><span>?</span><span>:</span><span>\/</span><span>+</span><span>/</span><span>,</span><span> </span><span>'https://'</span><span>)</span><span>;</span></div></div><div><div><div>152</div></div><div><span> </span><span>if</span><span> (</span><span>checkUrl</span><span>(path)) </span><span>{</span></div></div><div><div><div>153</div></div><div><span> </span><span>return</span><span> </span><span>httpHandler</span><span>(req</span><span>,</span><span> path)</span><span>;</span></div></div><div><div><div>154</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>if</span><span> (path</span><span>.</span><span>search</span><span>(exp2) </span><span>===</span><span> </span><span>0</span><span>) </span><span>{</span></div></div><div><div><div>155</div></div><div><span> </span><span>if</span><span> (Config</span><span>.</span><span>jsdelivr) </span><span>{</span></div></div><div><div><div>156</div></div><div><span> </span><span>const</span><span> newUrl </span><span>=</span><span> path</span></div></div><div><div><div>157</div></div><div><span> </span><span>.</span><span>replace</span><span>(</span><span>'/blob/'</span><span>,</span><span> </span><span>'@'</span><span>)</span></div></div><div><div><div>158</div></div><div><span> </span><span>.</span><span>replace</span><span>(</span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>github</span><span>\.</span><span>com</span><span>/</span><span>,</span><span> </span><span>'https://cdn.jsdelivr.net/gh'</span><span>)</span><span>;</span></div></div><div><div><div>159</div></div><div><span> </span><span>return</span><span> Response</span><span>.</span><span>redirect</span><span>(newUrl</span><span>,</span><span> </span><span>302</span><span>)</span><span>;</span></div></div><div><div><div>160</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>161</div></div><div><span><span> </span></span><span>path </span><span>=</span><span> path</span><span>.</span><span>replace</span><span>(</span><span>'/blob/'</span><span>,</span><span> </span><span>'/raw/'</span><span>)</span><span>;</span></div></div><div><div><div>162</div></div><div><span> </span><span>return</span><span> </span><span>httpHandler</span><span>(req</span><span>,</span><span> path)</span><span>;</span></div></div><div><div><div>163</div></div><div><span> </span><span>}</span></div></div><div><div><div>164</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>if</span><span> (path</span><span>.</span><span>search</span><span>(exp4) </span><span>===</span><span> </span><span>0</span><span>) </span><span>{</span></div></div><div><div><div>165</div></div><div><span> </span><span>const</span><span> newUrl </span><span>=</span><span> path</span></div></div><div><div><div>166</div></div><div><span> </span><span>.</span><span>replace</span><span>(</span><span>/</span><span>(</span><span>?&lt;=</span><span>com</span><span>\/.</span><span>+?</span><span>\/.</span><span>+?</span><span>)</span><span>\/</span><span>(</span><span>.</span><span>+?</span><span>\/</span><span>)</span><span>/</span><span>,</span><span> </span><span>'@$1'</span><span>)</span></div></div><div><div><div>167</div></div><div><span> </span><span>.</span><span>replace</span><span>(</span></div></div><div><div><div>168</div></div><div><span> </span><span>/</span><span>^</span><span>(</span><span>?:</span><span>https</span><span>?</span><span>:</span><span>\/\/</span><span>)</span><span>?</span><span>raw</span><span>\.</span><span>(</span><span>?:</span><span>githubusercontent</span><span>|</span><span>github)</span><span>\.</span><span>com</span><span>/</span><span>,</span></div></div><div><div><div>169</div></div><div><span> </span><span>'https://cdn.jsdelivr.net/gh'</span></div></div><div><div><div>170</div></div><div><span><span> </span></span><span>)</span><span>;</span></div></div><div><div><div>171</div></div><div><span> </span><span>return</span><span> Response</span><span>.</span><span>redirect</span><span>(newUrl</span><span>,</span><span> </span><span>302</span><span>)</span><span>;</span></div></div><div><div><div>172</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>173</div></div><div><span> </span><span>return</span><span> </span><span>fetch</span><span>(ASSET_URL </span><span>+</span><span> path)</span><span>;</span></div></div><div><div><div>174</div></div><div><span> </span><span>}</span></div></div><div><div><div>175</div></div><div><span>}</span></div></div><div><div><div>176</div></div><div> </div></div><div><div><div>177</div></div><div><span>/**</span></div></div><div><div><div>178</div></div><div><span><span> </span></span><span>* Check if the URL matches GitHub patterns.</span></div></div><div><div><div>179</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>string</span><span>}</span><span> </span><span>url</span></div></div><div><div><div>180</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>boolean</span><span>}</span></div></div><div><div><div>181</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>182</div></div><div><span>function</span><span> </span><span>checkUrl</span><span>(</span><span>url</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>183</div></div><div><span> </span><span>return</span><span> [exp1</span><span>,</span><span> exp2</span><span>,</span><span> exp3</span><span>,</span><span> exp4</span><span>,</span><span> exp5</span><span>,</span><span> exp6]</span><span>.</span><span>some</span><span>(</span><span>(</span><span>exp</span><span>)</span><span> </span><span>=&gt;</span><span> url</span><span>.</span><span>search</span><span>(exp) </span><span>===</span><span> </span><span>0</span><span>)</span><span>;</span></div></div><div><div><div>184</div></div><div><span>}</span></div></div><div><div><div>185</div></div><div> </div></div><div><div><div>186</div></div><div><span>/**</span></div></div><div><div><div>187</div></div><div><span><span> </span></span><span>* Handle HTTP redirects.</span></div></div><div><div><div>188</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>Request</span><span>}</span><span> </span><span>req</span></div></div><div><div><div>189</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>string</span><span>}</span><span> </span><span>location</span></div></div><div><div><div>190</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>Promise&lt;Response&gt;</span><span>}</span></div></div><div><div><div>191</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>192</div></div><div><span>async</span><span> </span><span>function</span><span> </span><span>handleHttpRedirect</span><span>(</span><span>req</span><span>,</span><span> </span><span>location</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>193</div></div><div><span> </span><span>const</span><span> url </span><span>=</span><span> </span><span>createURL</span><span>(location)</span><span>;</span></div></div><div><div><div>194</div></div><div><span> </span><span>if</span><span> (</span><span>!</span><span>url) </span><span>{</span></div></div><div><div><div>195</div></div><div><span> </span><span>return</span><span> </span><span>makeResponse</span><span>(</span><span>'Invalid URL'</span><span>,</span><span> </span><span>400</span><span>)</span><span>;</span></div></div><div><div><div>196</div></div><div><span> </span><span>}</span></div></div><div><div><div>197</div></div><div><span> </span><span>return</span><span> </span><span>proxyRequest</span><span>(url</span><span>,</span><span> req)</span><span>;</span></div></div><div><div><div>198</div></div><div><span>}</span></div></div><div><div><div>199</div></div><div> </div></div><div><div><div>200</div></div><div><span>/**</span></div></div><div><div><div>201</div></div><div><span><span> </span></span><span>* Handle HTTP requests.</span></div></div><div><div><div>202</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>Request</span><span>}</span><span> </span><span>req</span></div></div><div><div><div>203</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>string</span><span>}</span><span> </span><span>pathname</span></div></div><div><div><div>204</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>Promise&lt;Response&gt;</span><span>}</span></div></div><div><div><div>205</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>206</div></div><div><span>async</span><span> </span><span>function</span><span> </span><span>httpHandler</span><span>(</span><span>req</span><span>,</span><span> </span><span>pathname</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>207</div></div><div><span> </span><span>if</span><span> (req</span><span>.</span><span>method </span><span>===</span><span> </span><span>'OPTIONS'</span><span> </span><span>&amp;&amp;</span><span> req</span><span>.</span><span>headers</span><span>.</span><span>has</span><span>(</span><span>'access-control-request-headers'</span><span>)) </span><span>{</span></div></div><div><div><div>208</div></div><div><span> </span><span>return</span><span> </span><span>new</span><span> </span><span>Response</span><span>(</span><span>null</span><span>,</span><span> PREFLIGHT_INIT)</span><span>;</span></div></div><div><div><div>209</div></div><div><span> </span><span>}</span></div></div><div><div><div>210</div></div><div> </div></div><div><div><div>211</div></div><div><span> </span><span>const</span><span> headers </span><span>=</span><span> </span><span>new</span><span> </span><span>Headers</span><span>(req</span><span>.</span><span>headers)</span><span>;</span></div></div><div><div><div>212</div></div><div><span> </span><span>let</span><span> flag </span><span>=</span><span> </span><span>!</span><span>whiteList</span><span>.</span><span>length</span><span>;</span></div></div><div><div><div>213</div></div><div><span> </span><span>for</span><span> (</span><span>const</span><span> i </span><span>of</span><span> whiteList) </span><span>{</span></div></div><div><div><div>214</div></div><div><span> </span><span>if</span><span> (pathname</span><span>.</span><span>includes</span><span>(i)) </span><span>{</span></div></div><div><div><div>215</div></div><div><span><span> </span></span><span>flag </span><span>=</span><span> </span><span>true</span><span>;</span></div></div><div><div><div>216</div></div><div><span> </span><span>break</span><span>;</span></div></div><div><div><div>217</div></div><div><span> </span><span>}</span></div></div><div><div><div>218</div></div><div><span> </span><span>}</span></div></div><div><div><div>219</div></div><div><span> </span><span>if</span><span> (</span><span>!</span><span>flag) </span><span>{</span></div></div><div><div><div>220</div></div><div><span> </span><span>return</span><span> </span><span>new</span><span> </span><span>Response</span><span>(</span><span>'blocked'</span><span>,</span><span> </span><span>{</span><span> status</span><span>:</span><span> </span><span>403</span><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>221</div></div><div><span> </span><span>}</span></div></div><div><div><div>222</div></div><div> </div></div><div><div><div>223</div></div><div><span> </span><span>if</span><span> (pathname</span><span>.</span><span>search</span><span>(</span><span>/</span><span>^</span><span>https</span><span>?</span><span>:</span><span>\/\//</span><span>) </span><span>!==</span><span> </span><span>0</span><span>) </span><span>{</span></div></div><div><div><div>224</div></div><div><span><span> </span></span><span>pathname </span><span>=</span><span> </span><span>'https://'</span><span> </span><span>+</span><span> pathname</span><span>;</span></div></div><div><div><div>225</div></div><div><span> </span><span>}</span></div></div><div><div><div>226</div></div><div> </div></div><div><div><div>227</div></div><div><span> </span><span>const</span><span> url </span><span>=</span><span> </span><span>createURL</span><span>(pathname)</span><span>;</span></div></div><div><div><div>228</div></div><div><span> </span><span>return</span><span> </span><span>proxyRequest</span><span>(url</span><span>,</span><span> </span><span>{</span><span> method</span><span>:</span><span> req</span><span>.</span><span>method</span><span>,</span><span> headers</span><span>,</span><span> body</span><span>:</span><span> req</span><span>.</span><span>body </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>229</div></div><div><span>}</span></div></div><div><div><div>230</div></div><div> </div></div><div><div><div>231</div></div><div><span>/**</span></div></div><div><div><div>232</div></div><div><span><span> </span></span><span>* Proxy a request.</span></div></div><div><div><div>233</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>URL</span><span>}</span><span> </span><span>url</span></div></div><div><div><div>234</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>param</span><span> </span><span>{</span><span>RequestInit</span><span>}</span><span> </span><span>reqInit</span></div></div><div><div><div>235</div></div><div><span><span> </span></span><span>* </span><span>@</span><span>returns</span><span> </span><span>{</span><span>Promise&lt;Response&gt;</span><span>}</span></div></div><div><div><div>236</div></div><div><span><span> </span></span><span>*/</span></div></div><div><div><div>237</div></div><div><span>async</span><span> </span><span>function</span><span> </span><span>proxyRequest</span><span>(</span><span>url</span><span>,</span><span> </span><span>reqInit</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>238</div></div><div><span> </span><span>const</span><span> response </span><span>=</span><span> </span><span>await</span><span> </span><span>fetch</span><span>(url</span><span>.</span><span>href</span><span>,</span><span> reqInit)</span><span>;</span></div></div><div><div><div>239</div></div><div><span> </span><span>const</span><span> responseHeaders </span><span>=</span><span> </span><span>new</span><span> </span><span>Headers</span><span>(response</span><span>.</span><span>headers)</span><span>;</span></div></div><div><div><div>240</div></div><div> </div></div><div><div><div>241</div></div><div><span> </span><span>if</span><span> (responseHeaders</span><span>.</span><span>has</span><span>(</span><span>'location'</span><span>)) </span><span>{</span></div></div><div><div><div>242</div></div><div><span> </span><span>const</span><span> location </span><span>=</span><span> responseHeaders</span><span>.</span><span>get</span><span>(</span><span>'location'</span><span>)</span><span>;</span></div></div><div><div><div>243</div></div><div><span> </span><span>if</span><span> (</span><span>checkUrl</span><span>(location)) </span><span>{</span></div></div><div><div><div>244</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>set</span><span>(</span><span>'location'</span><span>,</span><span> PREFIX </span><span>+</span><span> location)</span><span>;</span></div></div><div><div><div>245</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>246</div></div><div><span><span> </span></span><span>reqInit</span><span>.</span><span>redirect </span><span>=</span><span> </span><span>'follow'</span><span>;</span></div></div><div><div><div>247</div></div><div><span> </span><span>return</span><span> </span><span>proxyRequest</span><span>(</span><span>createURL</span><span>(location)</span><span>,</span><span> reqInit)</span><span>;</span></div></div><div><div><div>248</div></div><div><span> </span><span>}</span></div></div><div><div><div>249</div></div><div><span> </span><span>}</span></div></div><div><div><div>250</div></div><div> </div></div><div><div><div>251</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>set</span><span>(</span><span>'access-control-expose-headers'</span><span>,</span><span> </span><span>'*'</span><span>)</span><span>;</span></div></div><div><div><div>252</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>set</span><span>(</span><span>'access-control-allow-origin'</span><span>,</span><span> </span><span>'*'</span><span>)</span><span>;</span></div></div><div><div><div>253</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>delete</span><span>(</span><span>'content-security-policy'</span><span>)</span><span>;</span></div></div><div><div><div>254</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>delete</span><span>(</span><span>'content-security-policy-report-only'</span><span>)</span><span>;</span></div></div><div><div><div>255</div></div><div><span><span> </span></span><span>responseHeaders</span><span>.</span><span>delete</span><span>(</span><span>'clear-site-data'</span><span>)</span><span>;</span></div></div><div><div><div>256</div></div><div> </div></div><div><div><div>257</div></div><div><span> </span><span>return</span><span> </span><span>new</span><span> </span><span>Response</span><span>(response</span><span>.</span><span>body</span><span>,</span><span> </span><span>{</span></div></div><div><div><div>258</div></div><div><span><span> </span></span><span>status</span><span>:</span><span> response</span><span>.</span><span>status</span><span>,</span></div></div><div><div><div>259</div></div><div><span><span> </span></span><span>headers</span><span>:</span><span> responseHeaders</span><span>,</span></div></div><div><div><div>260</div></div><div><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>261</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h3>参考资料<a href="#参考资料">#</a></h3> <ul> <li><a href="https://zhuanlan.zhihu.com/p/621142457">2023最新WSL搭建深度学习平台教程（适用于Docker-gpu、tensorflow-gpu、pytorch-gpu） - 知乎</a></li> <li><a href="https://blog.csdn.net/anmin8888/article/details/127910084">CUDA与cuDNN安装教程（超详细）-CSDN博客</a></li> <li><a href="https://zhuanlan.zhihu.com/p/471484611">Pytorch Docker镜像构建教程（不同系统、CUDA、Python版本） - 知乎</a></li> <li><a href="https://rocm.docs.amd.com/projects/radeon/en/latest/docs/install/wsl/install-pytorch.html">Install PyTorch for ROCm — Use ROCm on Radeon GPUs</a></li> </ul> </article> https://blog.hpcesia.com/posts/set-proxy-for-docker-in-wsl/https://blog.hpcesia.com/posts/set-proxy-for-docker-in-wsl/为 Windows 10 上的 WSL2 安装的原生 Docker 配置代理Sat, 04 Jan 2025 11:19:35 GMT<article> <h2>WSL 中使用 Systemd 为 Docker 配置代理<a href="#wsl-中使用-systemd-为-docker-配置代理">#</a></h2> <p>对于 Windows 11 22H2 以上版本来说，为 WSL2 里的 Docker 配置代理，只需要将 WSL2 的网络切换为镜像模式，即可像配置原生 Linux 一样配置代理。但对 Windows 10 用户来说，配置代理就会麻烦一点。由于 WSL2 每次宿主机开机时，分配的虚拟网卡地址不一样，因此不能直接使用 127.0.0.1 访问宿主机上的代理。同时 Docker 使用 systemd 启动，写在终端中的代理配置，如</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>export</span><span> hostip=</span><span>(</span><span>cat</span><span> /etc/resolv.conf </span><span>|</span><span> </span><span>grep</span><span> -oP </span><span>'(?&lt;=nameserver\ ).*'</span><span>)</span></div></div><div><div><div>2</div></div><div><span>export</span><span> https_proxy=</span><span>"http://</span><span>$hostip</span><span>:7890"</span></div></div><div><div><div>3</div></div><div><span>export</span><span> http_proxy=</span><span>"http://</span><span>$hostip</span><span>:7890"</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>是不能正常生效的。</p> <p>网络上的相关教程基本都使用的是固定 ip，这样每次开机都需要改动 ip，或者写脚本固定分配给 WSL2 的ip。我研究了一段时间后，发现可以直接通过修改 systemd 配置来让 Docker 也使用宿主机的代理。</p> <p>以下以 Clash 为例，代理端口为 7890，WSL2 中用户名称为 hpcesia，请自行改动相关内容。首先创建配置文件：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>mkdir</span><span> </span><span>-p</span><span> </span><span>/etc/systemd/system/docker.service.d</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>vim</span><span> </span><span>/etc/systemd/system/docker.service.d/proxy.conf</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>在其中输入如下内容，注意替换端口号：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span># proxy.conf</span></div></div><div><div><div>2</div></div><div><span>[</span><span>Service</span><span>]</span></div></div><div><div><div>3</div></div><div><span>ExecStartPre</span><span>=</span><span>sudo /bin/bash -c </span><span>"echo http_proxy=http://$(cat /etc/resolv.conf | grep -oP '(?&lt;=nameserver\\ ).*'):7890 &gt; /tmp/docker_env"</span></div></div><div><div><div>4</div></div><div><span>ExecStartPre</span><span>=</span><span>sudo /bin/bash -c </span><span>"echo https_proxy=http://$(cat /etc/resolv.conf | grep -oP '(?&lt;=nameserver\\ ).*'):7890 &gt;&gt; /tmp/docker_env"</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div><span>[</span><span>Service</span><span>]</span></div></div><div><div><div>7</div></div><div><span>EnvironmentFile</span><span>=</span><span>-/tmp/docker_env</span></div></div><div><div><div>8</div></div><div><span>Environment</span><span>=</span><span>no_proxy</span><span>=</span><span>"127.0.0.1,localhost"</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>再重启 docker 即可。</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>daemon-reload</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>restart</span><span> </span><span>docker</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 hello-world 镜像进行测试，可以正常拉取，说明配置成功。</p> <h2>参考资料<a href="#参考资料">#</a></h2> <ul> <li><a href="https://www.jinbuguo.com/systemd/systemd.exec.html#%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F">systemd.exec 中文手册 [金步国]</a></li> <li><a href="https://www.jinbuguo.com/systemd/systemd.service.html#ExecStartPre=">systemd.service 中文手册 [金步国]</a></li> </ul> </article> https://blog.hpcesia.com/posts/monthly-journal-2/https://blog.hpcesia.com/posts/monthly-journal-2/Sun, 29 Dec 2024 04:01:02 GMT<article> <p>许久不见，上次更新博客已是一个月前的事情了。到现在，随着考研和期末考试的结束，这个学期的所有事情也算是告一段落了，只剩一个时间还算充裕的毕业论文需要忙，所以我赶紧码了一篇文章，以免整个 12 月都没一篇新博文。</p> <p>12 月事情比较多，所以把周记改成了月记，本次月记记录时长为 5 周：11.25 - 12.29。</p> <h2>非典型考研<a href="#非典型考研">#</a></h2> <p>今年的考研时间比以往提前了些许，是 12 月 21-22 日。为什么说是「非典型考研」呢？因为我自己的考研复习安排，现在回顾起来，我自己看着都想笑。</p> <p>我决定要考研并开始复习的时间其实还是蛮早的，今年春节时便已经决定要考研跨考到计算机，并开始学习 408（计算机综合统考科目）了。但是我在 12 月以前的复习，都可以用「随缘」来形容。一直到了 9 月，我才磨磨蹭蹭地把 408 的四门课程全部看了一遍，然后发现根本记不住那么多知识点，只能赶紧找到了专业课考自命题，只用学 408 中两门的西交。</p> <p>从9月开始，我就按考试顺序挨个说说自己各个科目的备考情况吧。</p> <p>首先是政治，我从 9 月开始磨磨蹭蹭地看徐涛老师的考研政治强化班，顺便做做《肖 1000》。中间分心于各种闲事，譬如鼓捣这个博客，直到 11 月底（本次月记开始的时间）强化班也才看了一半。感觉时间来不及了，于是我紧赶慢赶心不在焉地把剩下一半的课程在 12 月初《肖四》出来之前看完了。拿到《肖四》时，已是 12 月 13 日，当天我就开始背《肖四》分析题答案的提纲，顺便把四套卷子的选择题都做了一遍。（顺带一提，政治分析题的复习方式——背押题卷的答案——我是等肖四到了才在和一起备考的舍友那里知道的。）</p> <p>背一会儿玩一会儿地背了一个白天，我只背完了一道题（即四套押题卷的同一题的答案），但却感觉有些生理性的恶心想吐，完全背不下去也记不住，之后几天便换成了背诵提纲的提纲，即 B 站上带背视频总结的答案要点。（还是刚才那个舍友，他直接背了前两套卷的完整答案和后两套卷的提纲，我是真佩服。）</p> <p>政治今年卷子难度算是最近十几年来最难的一次了，表现就是《肖四》中押的考点，要么背的答案都写在材料里，要么压根不沾边，能用上的东西很少。不过对我这种没好好背《肖四》答案的人来说，倒算是一个利好，大伙都只能在考场上「守正创新」——抄材料和瞎编，背没背好押题卷的答案就不重要了（笑）。</p> <p>然后是英语。这科其实没什么好说的，在去年 6 月考完 4 级，发现自己单词量相当匮乏、试卷上有大量没见过的单词时，我便开始用「不背单词」这个应用来每天背单词，一直到上考场时，背过的单词数量是 5000 左右，记得比较熟的单词大概在 3500 左右，基本覆盖了考研考纲词汇。9 月初，我再 burningvocabulary 上下载了过往三年的英语一真题做了一下，发现难度并不高，于是便没有复习英语，只在临考的时候稍微看了下作文模板，记了下各种文章格式要求。</p> <p>英语一今年的考试难度据说也是近十年最难的了，试题难度仅次于 2010 年。我自己的做题感受就是：完形填空知道这个空该填什么意思的单词，但四个选项的短语都不知道是啥意思，单词本意看起来填上去基本都说得过去；阅读理解的文章自说自话逻辑不清，需要先帮作者厘清逻辑才能回答问题；段落排序虽然难度不大，但是也需要花不少时间仔细读一遍才能做出来；翻译中的长难句各种从句修饰相互嵌套好几层，费劲功夫厘清嵌套关系后（最想要编程语言的「{}」来清楚标识嵌套层级的一集），直译出来的中文语序过于怪异，还需要绞尽脑汁安排语序，让翻译出来的东西不至于变成「好小众的语言，长得和汉字好像」。作文就很凄惨了，前面花费太多时间，加上完全没背作文模板，硬着头皮写的东西自己都看不下去。</p> <p>接着是数学。这科是我最意外的一科，毕竟我是数学系的，对数学功底多少还有点自信。于是我就只在十一月底做了四五套往年的数学一真题练练手并检查一下自己遗忘较多的知识点，接着做了点遗忘知识点的题目，就去考试了。</p> <p>但是今年的数学一考研试题给了我一个迎头痛击：我能看出来题目本身不难，但要么需要花很多时间计算，要么涉及的解题技巧比较偏门。我压根没复习到。很多题目我知道只要我多刷点题，肯定能刷到类似题目，到了考场上自然也解得出来，可我仗着自己是数学系，没有多刷题，于是考场上就麻爪了。结果就是，数学系带给我的优势，只在唯一的一道证明题上体现了出来——那道题基本属于数分期末考试最前面的送分题水平。但这点优势又被没刷题导致的劣势拉回去了（悲）。与前两科不同的是，我考完出来时在社交媒体上看到的却是「这次数学一挺简单的」，吐槽难度的没多少，让我汗流浃背了。</p> <p>最后是专业课。直到 12 月 8 日，离考试还有两周的时候，我打算做点自命题考试的往年真题，才发现西交的自命题考的和 408 统考并不完全相同，于是紧急开始用西交的教材复习，以及写课后题。</p> <p>从考试体感来看，这最后一门自命题专业课，反倒是最简单、最眉清目秀的。基本全考的常规题，即便有些东西记得不清也能瞎扯上几句相关的蹭点分。</p> <p>对于上岸，估计是没啥指望了，数学给我拉下来了太多的分数。目前预估分数是政治 60 + 英语 70 + 数学 90 + 专业课 110，总计 330 分，而西交去年的复试线是 350 分，即使算上今年考研政治英语难度增加，分数线也大概在 340 上下，所以基本是没啥希望了，属于是这种吊儿郎当的学习态度应得的结果。</p> <h2>喝水<a href="#喝水">#</a></h2> <p>不知各位平时喜欢喝什么水呢？我个人最喜欢喝的是怡宝的纯净水。虽然网上不少认为各种水并没有多少区别，但就我个人体验来说，不同品种的水口感是相当不同的：纯净水是口感最好的，入口清冽甘甜，喝完不会有多余的味道停留在口中；矿泉水入口亦有微甘，但稍稍有些发涩，喝完后喉头回苦，不宜多喝；自来水烧的白开水当属口感最差的，入口苦涩，难以下咽，喝完舌根与喉咙都是苦的。</p> <p>水的温度也会影响口感。冰水和热水都会掩盖住口感差异，常温的冷水口感差异则会非常显著。所以只有白开水可喝时，我通常会喝 50℃ 左右的热水，否则根本喝不下去。做成饮品也不失为一种掩盖异味的选择，或是泡茶，或是煮咖啡，或是加些蜂蜜，总之都能让水变得可以入口。</p> <p>11月底的时候，我在网上图便宜买了 4 桶 5L 装的怡宝饮用水，但入口时才发现这个「饮用水」并非纯净水，入口一股涩味，大概是用的天然水。但买都买了，这种东西又不好退货，而且天然水的涩味也不算很难入口，于是也就这样喝着了。</p> <h2>写作工作流优化<a href="#写作工作流优化">#</a></h2> <p>本节还可以叫作「Hello, Syncthing」。</p> <p>这个月剩下的一点空闲时间里，我将编写文章的工作流进行了一些优化。最开始，我写文章全程都在 VSCode 内部进行。但很快我就发现了一个问题：坐在电脑前得来的灵感并不多，而灵感转瞬即逝，需要尽快记录下来，于是我开始研究如何多端同步编辑文章。此前，我是通过 Gitea 的在线编辑功能（小屋的源码托管在自建 Gitea 上）与安卓端的 Obsidian，使用手动复制的方式来多端同步编写文章。但这样做既不优雅，还有个问题：我必须在切换设备前提交文章更新并上传，这实在是太麻烦了。所以我开始研究一个更优雅的工作流。</p> <p>最近，由于对多端同步本地音乐库有了需求，我找到了 Syncthing 用于同步手机与 PC 上的音乐库。利用手上的香港 VPS 搭了一个发现服务器和中继服务器后，实现了音乐库的同步。在此之后，文档的同步自然也提上了日程。正好 Syncthing 可以自定义同步文件夹存储位置，而 Obsidian 也可以自定义存储库位置，一个同步工作流就此建成，终于不用每次换设备就 commit，污染 git 记录了。目前用起来感觉还算不错，虽然 Syncthing 的同步速度有点堪忧，例如对于上面提到的音乐库的同步来说，半天都同步不了几首歌，但胜在不需要额外关注，等哪天想在电脑上听歌的时候，音乐库就已经同步完成了。</p> <h2>Hello, WSL2<a href="#hello-wsl2">#</a></h2> <p>毕业论文需要使用到深度学习，需要使用 PyTorch，但是 Python 的环境管理又是个老大难的问题。为了不被虚拟环境和包管理气晕，再加上导师此前没做过深度学习方向，想让我留下一份论文学习开发笔记，方便未来他让其他人跟着我的经验来做这方向的项目，我决定直接使用 Docker 来开发，节省包管理的时间，也方便多系统移植环境。需要用 Docker，自然就得请出最好的 Linux 发行版 WSL2 了。</p> <p>在此之前，我虽然已经装了 WSL2，但也只是出于折腾工具的心理，配置了一下 zsh 就放着吃灰了。不幸的是，当时折腾的时候还没建博客，没想着留笔记，现在只剩下一份看不懂的 .zshrc 了，动不了一点配置。由于看不懂之前折腾的 .zshrc 配置，我选择换一个轻松，不用花过多精力配置的 Shell 来进行开发——Fish。Fish 的优势就是自带代码补全、高亮、提示等 zsh 需要花时间配置的功能（oh-my-zsh 配置起来很快，但性能堪忧，我自己花时间配置的性能高的 zsh 又没留笔记），且有可视化的配置网页，但缺点就是和 bash、zsh 不兼容，不能直接运行一些 shell 脚本。</p> <h2>Hello, Starship<a href="#hello-starship">#</a></h2> <p><a href="https://starship.rs/">Starship</a> 是一个 rust 编写的轻量、迅速、客制化的终端美化软件，Windows/Linux/macOS 三端适配，bash/zsh/cmd/fish/posh 等等终端均可使用，是美化中的强者。多系统、多 Shell 通用的好处就是高一致性，不同系统上的不同 Shell 可以使用同一个配置文件，比如我在 WSL 中同时安装了省心的 fish 和通用兼容的 zsh，加上自带的 bash，三个 Shell 外加 Windows 里的 PowerShell，都可以使用同一套配置文件（PowerShell 需要复制一份配置文件到 Windows 文件系统里），达成外观上的一致性。</p> <h2>Hello, Floorp<a href="#hello-floorp">#</a></h2> <p>在 B 站上看 Firefox 相关优化视频的时候，偶然看到了 Floorp 这个基于 Firefox 的浏览器，外观美观，自带功能丰富，适合我这种不想花太多时间折腾浏览器的懒人。缺点大概就是魔改的东西比较多，内核更新速度会比较慢。</p> <p>这段时间使用下来，个人觉得比较好用的几个功能：折叠侧边标签页可以方便地同时浏览更多网页；保存侧边栏网页应用可以在浏览网页的时候快速打开 OpenWebUI 来调用本地 Ollama 模型聊天；内置了一些方便的修改，就不用去翻 Firefox 的 config 页面了。</p> </article> https://blog.hpcesia.com/posts/weekly-journal-3/https://blog.hpcesia.com/posts/weekly-journal-3/写博客无聊吗？或许吧。但我愿意，这就够了。Wed, 27 Nov 2024 10:55:03 GMT<article> <p>本次周记记录时间为：11.18 - 11.24</p> <h2>碎碎念<a href="#碎碎念">#</a></h2> <p>本次周记其实本来打算鸽了的，因为确实没多少好写的东西，而且离考研只剩一个月了，也完全抽不出多少时间来写东西，最近的文章基本都是存稿补全 （是的，那篇塞尔维亚的旅游回忆已经在草稿箱里待了三个月了）。不过休息时间看了点东西，总算是有的写了，于是这篇周记还是发了出来 （不鸽掉原先说好要鸽的文章，这何尝不是一种鸽）。下个月的周记大概率是直接鸽了，真没时间了，估计会等到 12 月月底写个月记。</p> <p>有时挺羡慕<a href="https://chlo.is/">小氯</a>的，每周周报都能写五六千字，或许是我自己阅读量确实太少了？大学以来，没再读过严肃文学了，只读网络小说。等考研与毕业论文结束后，兴许应该读点书了，哲学也好历史也好，总之多吸收点东西，才不至于写周记时无话可讲，写旅游回忆时只有流水账。虽然目前小屋的文章多是技术类，可技术类虽然文笔重要性不高，但需要有大量干货才能动笔，而获取干货并不比读书简单。</p> <p>目前暂定后续会读的大概是各地神话故事与一些哲学书籍。其实感觉这个想读的书的取向属于是玩游戏玩的，在玩的游戏都有些剧情在探讨一些哲学，虽然 B 站上也有剧情解析，但只看别人的观点总归不是啥好事，需要自己得出观点，才不至于别人说啥我信啥。</p> <h2>最近喜欢的小说<a href="#最近喜欢的小说">#</a></h2> <p>既然谈到读书，虽然正经书没啥可分享的，但也可以在此处推荐几本比较喜欢的网络小说：</p> <ul> <li>《<a href="https://www.qidian.com/book/1036504904/">谁让他修仙的！</a>》：轻松搞笑的修仙爽文。作者喜欢写反套路的搞笑桥段，相当欢乐。但作者似乎不善感情描写，上本小说写到最后好几个暧昧对象，但却无女主；这本小说暧昧对象虽然也多，至少还有两个比较明显的女主，希望感情线写到后面不会太拉胯。</li> <li>《<a href="https://www.qidian.com/book/1039807042/">万历明君</a>》：明末历史小说，非爽文。主角是白手起家的高官魂穿幼年万历，政治斗争和谋略写得很精彩。作者古文功底也相当精悍 （就是读者看大量文言文会有点费劲），至少写得出举人级别的古文水平。</li> <li>《<a href="https://www.qidian.com/book/1037095853/">牧者密续</a>》：琥珀流奇幻小说，偏二次元风格。智斗谋略为主，主角的性格成长刻画得很好。感情线也写得不错，就是中期会有点作者个人二次元 XP 问题，但合我 XP 所以还是极力推荐。</li> </ul> <h2>保温杯<a href="#保温杯">#</a></h2> <p>我大学三年下来，换过 4 个保温杯。第一个是从高中带过来的 1.2L 容量大杯子，用起来还算不错，但有一个问题：太大了，我新背包的侧兜完全装不下。</p> <p>为此，我在淘宝上买了个 450mL 容量、方便携带的黑色保温杯，用来日常喝水。买来后的前几个月，这个新的保温杯用起来还是不错的；但是没过多久，保温杯外侧就开始掉漆了，一片片的黑色涂层脱落，经常附在杯口，实在膈应，只能丢掉，改为复用喝剩的饮料瓶子装水喝。</p> <p>过了一段时间，我在逛淘宝时发现哈尔斯的翻盖款智能保温杯叠劵后价格还算不错，和华为智慧生活连接的喝水量统计功能看起来也挺新奇，果断买下。但买来后饮水量统计和杯中水温的功能基本没用到过，反而充电是个麻烦。这个保温杯用到刚过保没多久时，水杯翻盖的锁舌就突然断裂，很难让人不怀疑是计划报废。锁舌断裂，水杯就合不上盖了，自然只能丢了。</p> <p>至于最后一个水杯，也是我现在用的水杯，在购买它时我吸取了前几个水杯的教训，选择了一个金属原色（不会掉漆）的旋盖（没有锁舌断裂风险）普通（没有用不上的智能）水杯。使用到现在，确实没有掉漆的问题，但旋盖与杯口的摩擦导致杯口有些诡异的黑色物质，也不知是因为杯盖质量不行、没有使用好的不锈钢导致的，还是摩擦刮下来的金属碎屑。看来再下一个保温杯，得选择塑料盖子的才行。</p> <h2>无聊的博客<a href="#无聊的博客">#</a></h2> <p>想了一下，还是把这一节调整到了最后。</p> <p>最近读到了<a href="https://onojyun.com/">莫比乌斯</a>的《<a href="https://onojyun.com/2024/11/22/%E6%97%A0%E8%81%8A%E7%9A%84%E4%B8%AD%E6%96%87%E5%8D%9A%E5%AE%A2%E5%9C%88/">无聊的中文博客圈</a>》。莫比乌斯写在他的博客内的不少观点我无法苟同，但这篇文章多多少少让我有些思考。</p> <hr /> <blockquote> <p>挺无聊的。</p> </blockquote> <p>中文博客圈里多是技术类博客，而技术这东西是很无聊的——在你用不上的时候。譬如我博客里的几篇数学相关的文章，相信大多数来到我博客并看到这段文字的人都不会有细看那几篇文章的想法。技术类的文章水字数简单，但没人看，因为「挺无聊的」。</p> <p>不过我还是会写技术类文章——但仅当这篇文章拥有充分的独创性。一篇东拼西凑整合教程的文章有多少用处呢？想必能从搜索引擎里看到这种「缝合怪」文章的人，也有能力自己找到哪些被引用的文章吧。</p> <p>写完上面一段后，我审视了一下小屋里已有的文章，看到了不少毫无独创性的「缝合怪」。譬如，还是上面说的那几篇数学文章，除去第一篇有限差分的文章，里面的证明均由我自己推导外，其余几篇多复变函数论「笔记」，其本质就是把老师给的 PPT 又抄了一遍，除去自我感动外，毫无用处。</p> <p>不过这些文章还是会先留着，等未来切换到 Astro（目前已有计划，但碍于空闲时间极少，无力实施）后会精简一次博客文章，届时再丢掉这些文章，连同那时的整个 Hexo 博客一起保留在一个存档站点中。</p> <hr /> <blockquote> <p>独立博客的「人设」功能，迫使它需要按照某种「姿态」去表达自我。</p> </blockquote> <p>网上冲浪，谁还没个人设啊。在这个小屋，我是一个普通的二次元「萌萌人」，会多给点情绪价值，大伙一起和和气气交流 （虽然实际上没几个人）。在别的地方，我也可以是别的人设，和和气气的地方我也和和气气，戾气较重的地方，我也多少带点戾气。即便在现实中，我又何尝不是带着面具说话呢？</p> <p>更何况小屋作为一个可公开浏览的地方，我并不愿意在这里写一些牵扯隐私的东西。对于一个在互联网暗区混过一段时间，现在时不时看一眼暗区边缘的我来说，被「开盒」是一个切实存在的风险。虽然对于有社工库的人来说，我在小屋里写不写这些牵扯隐私的东西并无区别——因为我全网同 ID。但通过搜索引擎获取公开信息进行推理的开盒方式还是要预防一下的。</p> <p>我也不愿在这里写太多敏感话题。一方面是上面说的锁定现实身份问题，既然公开信息都有可能锁定我了，那么网安要锁定我本人就更简单了；另一方面是我也自认为阅历和文笔还不足以在这些敏感话题上写出言之有物的文章。但莫比乌斯的一些敏感话题相关文章也提醒我了，既然我压根不打算备案，又何必费尽心思去严格地自我审查呢？写<a href="/posts/weekly-journal-2/">上次周记</a>中「BitWarden 客户端这种需求量不大的开源软件，短时间内肯定没人移植到鸿蒙，不像 Clash 这种刚需级软件，早早地就有人移植到鸿蒙 Next 上。」这段话时，我考虑过将 Clash 更换为 Clxxh 以规避审查，现在想来多少是有些搞笑了。在社交平台上要自我审查严防违规，到了不备案的独立博客上还得自我审查严防违规，那我这博客不就白搭了吗？</p> <p>当然，这不是说我真就完全不自我审查想说啥说啥了，虽然没啥人看，但是我还是要给国内用户提供一个较好的浏览速度的。因此我会保持自我审查与评论审查的限度，保证小屋不会被 GFW 掉即可。</p> <hr /> <blockquote> <p>不需要为写博客这个行为找一个合理正当的理由，喜欢写博客就像不喜欢吃香菜一样，天生的。</p> </blockquote> <p>上面这句引用自那篇文章的一个<a href="https://onojyun.com/2024/11/22/%e6%97%a0%e8%81%8a%e7%9a%84%e4%b8%ad%e6%96%87%e5%8d%9a%e5%ae%a2%e5%9c%88/comment-page-1/#comment-3986">匿名评论</a>。这句话说得难听且粗俗点，就是最近网上较为流行的一个对话模板：</p> <blockquote> <p>「我埃及吧写博客就写博客。」</p> <p>「太好了是法老，我们有救了！」</p> </blockquote> </article> https://blog.hpcesia.com/posts/serbia-travel-journal-1/https://blog.hpcesia.com/posts/serbia-travel-journal-1/记录 2024 春节进行的为期 7 天的塞尔维亚旅行。由于篇幅过多，分为三篇进行发布，此为上篇。本篇主要记录在塞尔维亚与波黑交界处附近的旅行。Sat, 23 Nov 2024 15:28:47 GMT<article> <blockquote> <div><span>note</span></div> <div> <p>本次旅游时间：2024 年 2 月 13 日 - 2024 年 2 月 21 日（北京时间）。</p> </div> </blockquote> <h2>Day1 - 启程<a href="#day1---启程">#</a></h2> <p>Day1 路线：重庆 → 卡塔尔 → 贝尔格莱德 → 兹拉蒂博尔</p> <p>一整天都基本在赶路，不是在飞机上就是在汽车上。</p> <h3>重庆 → 卡塔尔<a href="#重庆--卡塔尔">#</a></h3> <p>这次旅游是我爸拉着我去的，我们在卡塔尔航空上买了两张往返塞尔维亚的经济舱机票。由于重庆无直达航线，需经卡塔尔中转（</p> <p>理论上去北京中转也行，但是好像一周就一次航班），购买的是凌晨起飞，上午（当地时间）到达的机票。</p> <p><a></a></p> <p>2 月 12 日晚上 22 点整，我们到达了江北机场的国际候机室，等待登机。由于候机室的饮料实在太贵~~（一罐可乐 45 块，你怎么不去抢啊）~~，我爸又爱喝饮料，于是用了他的信用卡权益换了两个贵宾休息室的位置爽喝饮料爽恰零食。</p> <p>2 月 13 日凌晨 0 点 15 分，我们于江北机场坐上了前往卡塔尔的飞机。因为是春节期间，起飞后空姐给每个人都塞了个小红包，里面是两个金币巧克力：</p> <p><a></a></p> <p><a></a></p> <p>经济舱的环境实在是难受，整整 10 小时的飞行时间完全睡不着一点（悲）。而且我坐在靠窗位置，导致想去上厕所得先把我爸喊醒，就更麻烦了。</p> <h3>卡塔尔 → 贝尔格莱德<a href="#卡塔尔--贝尔格莱德">#</a></h3> <p>经过 10 小时的经济舱折磨，我们终于到达了中东土豪卡塔尔的多哈机场。整个候机楼到处都是奢侈品免税店，比迪拜的机场还让人眼花缭乱。</p> <p><a></a></p> <p><a></a></p> <p>在候机楼煎熬等待了两个小时一行，我们总算是坐上了前往贝尔格莱德的飞机。</p> <p><a></a></p> <h3>贝尔格莱德 → 兹拉蒂博尔<a href="#贝尔格莱德--兹拉蒂博尔">#</a></h3> <h4>中午<a href="#中午">#</a></h4> <p>经过 5 小时的旅程，我们总算是到达了塞尔维亚境内。</p> <p><a></a></p> <p>刚出机场，我就注意到了机场顶部的大字「BELGRADE AIRPORT NIKOLA TESLA」：</p> <p><a></a></p> <p>这时候我才知道原来特斯拉是塞尔维亚裔人😂。</p> <p>离开机场后，我跟着我爸在附近的租车点，提走了提前预订的车，开始塞尔维亚自驾游。不幸的是，我放假时忘记带驾照回家，因此只有拥有国际驾照的我爸能开车，我只能待在副驾驶位聊天、拍照和玩手机。</p> <p>贝尔格莱德机场附近全是农村小房子，最显眼的大概是成片打着中文标牌的赌场。不过我对赌博不感兴趣，我爸则锐评：真想玩赌博，这地方太掉价了，不如去澳门或者拉斯维加斯。刚进入贝尔格莱德市区，我看到的是成片的老旧居民楼：</p> <p><a></a></p> <p>说实话，和国内三四线小城里的小区给我的感觉差不多。掉色的外墙看着颇为破旧。正好已是当地时间中午，我们找了个居民楼楼下的比萨店，照着菜单上的图片点了一份看着还行的比萨作为午饭。</p> <p><a></a></p> <h4>下午<a href="#下午">#</a></h4> <p>吃过午饭，便该离开贝尔格莱德市区，一路向西南出发前往兹拉蒂博尔。一路上风景都还不错，也遇到了不少欧洲特色建筑（教堂和城堡）。</p> <div><div>多图折叠</div><div><p><a></a></p><p><a></a></p><p><a></a></p></div></div> <p>到达兹拉蒂博尔后，我们在预定好的民宿处安顿下来，然后出去觅食。</p> <p><a></a></p> <p><a></a></p> <p>晚上散步的时候看到了一个军官的雕像，上面写着「КАЈМАКЧАЛАН АРМИЈСКИ ЂЕНЕРАЛ КРСТА СМИЉАНИЋ 1868·1944」。</p> <p><a></a></p> <div><div>关于这个将领的信息</div><div><p>写这个博客的时候查了下维基，原来是南斯拉夫在一战时期的的陆军将军，名字可以翻译为「克尔斯塔·斯米尔贾尼奇」，照片长这样：</p><p><a></a></p><p>这个雕像是为了纪念这个将军在凯马克查伦（Kaymakchalan 或 Кајмакчалана）战役上带领德里纳（Drina 或 Дринска）师的成就而设立的。</p></div></div> <p>散完步，买了点饮料和零食，我们就回到民宿，准备第二天的旅程。</p> <h2>Day2 - 索道与雪山<a href="#day2---索道与雪山">#</a></h2> <h3>上午<a href="#上午">#</a></h3> <p>一大早，我们就起床出发，徒步前往不远处的兹拉蒂博尔缆车的出发点。一路上有不少售卖当地特产的商店，如果忽略掉招牌上的西里尔字母，似乎与国内一些古镇并无多少区别。</p> <p><a></a></p> <p>兹拉蒂博尔拥有目前世界最长的空中索道缆车，全长 9 公里，将兹拉蒂博尔城与 Tornik 山峰相连，一路上的风景基本都是草原与牧场。票价已经忘记是多少了，当时也没拍照片，但是印象里不算贵。包车会更贵一点，但是我们起得够早，此时缆车的出发点并没有人在排队，所以我们只需要正常购票就能事实上地达成包厢的目的。事实证明开头那段旅游景点介绍是真实的，路上的风景是相当美丽，一路上只会疯狂拍照了：</p> <div><div>多图折叠</div><div><p><a></a></p><p><a></a></p><p><a></a></p><p><a></a></p><p><a></a></p></div></div> <p>美妙的时光总算过得很快，一转眼，缆车就到达了此行的终点：山顶。对于常年居住在南方的我来说，雪景确实是个稀罕玩意儿，基本只有出去旅游才见得到。就是山上的温度实在是有点冷了，我在准备行李的时候不知道要到雪山上，只准备了适合山脚下温度的衣服，到了山上只能瑟瑟发抖（悲）。</p> <div><div>多图折叠</div><div><p><a></a></p><p><a></a></p><p><a></a></p><p><a></a></p></div></div> <p>这座山也是一个滑雪的好去处，除去我们所坐的观光缆车外，还有一个专为滑雪者提供服务的缆车，可以穿着滑雪板直达山顶，源源不断地有滑雪者坐着缆车到达山顶，然后沿着滑雪道飞驰。</p> <p><a></a></p> <p>由于我实在是扛不住山上的气温，只在山顶待了不到一个小时，我们便乘坐缆车回到了山下。回到山下的时候虽然才当地时间十点，但因为出门时没吃早饭，我和我爸都已经有些饿了，于是我们找了个路边的店，一人买了一个欧洲版肉夹馍作为今天的午餐。</p> <p><a></a></p> <h3>中午<a href="#中午-1">#</a></h3> <p>边走边吃地吃完了午饭后，我们决定先好好逛一下这个镇子，毕竟昨晚虽然也散步走了一小圈，但天色太黑看不真切。</p> <p><a></a></p> <p>镇上大部分其实只是看个新鲜，也就是常规的欧洲民居罢了，唯一值得放在文章里的是一个小教堂。教堂虽小，里面的装饰却不含糊，金碧辉煌~~（虽然见识过阿联酋的宫殿后已经不稀奇了）~~。说实话，我对这些教堂并不怎么感兴趣，尤其是这种小的，只是随便拍了几张照片。我爸倒是对此相当感兴趣，各种角度拍了半天。</p> <div><div>多图折叠</div><div><p><a></a></p><p><a></a></p><p><a></a></p></div></div> <h3>下午<a href="#下午-1">#</a></h3> <p>下午，依旧是我爸开车，去参观一个非常偏僻的教堂。一路基本都是乡间小路，虽然我爸几十年老司机技艺娴熟，但还是让我有些担心我们租的这辆奥迪轿车能否撑得住路上的颠簸。</p> <p><a></a></p> <p><a></a></p> <p>结果到了教堂，我们才发现今天教堂关门了，于是只能在外面拍几张照作罢。</p> <p>回民宿的路上，我爸突然发现有一条支路可以开到早上坐缆车到的山顶上，而我们租的这辆车的轮胎和性能都足够在较浅的雪地里行驶，因此我们又开着车前往山顶。</p> <p><a></a></p> <p>此时的山顶，在下午的阳光照耀下，雪相比早上少了不少，露出了下面的土地。气温也暖和了不少，至少不用在寒风中瑟瑟发抖了。</p> <p><a></a></p> <p>在山顶又拍了些照，我们便返回了民宿，买了些零食和饮料，为第三天的旅程做准备。</p> <p><a></a></p> <h2>Day3 - 古桥<a href="#day3---古桥">#</a></h2> <h3>上午<a href="#上午-1">#</a></h3> <p>一大早，我们便收拾好东西，退掉民宿，驱车前往波黑的莫斯塔尔。路上倒是没多少好说的，唯一值得一提的是手机信号。在塞尔维亚境内，一路上基本都是 4G 信号，至少是可以正常水群聊天的。但一到波黑境内，手机信号立马降到 2G，时不时会直接无信号。由于没料想到手机信号会那么差，我手机上没有多少适合消磨时间的东西，只能玩玩数独解闷。</p> <p>我们一直开到一个服务区才有手机信号，这时候也差不多该吃饭了。</p> <p><a></a></p> <p>但服务区的手机信号仍然值得吐槽：只有在外面信号才是能正常使用的，餐厅里面只有 2G 信号，相当难绷了。而我爸又要到餐厅外面抽烟，我只能待在餐厅里面空欢喜一场。</p> <h3>下午<a href="#下午-2">#</a></h3> <p>一路奔波到了莫斯塔尔，我们入住了一个离莫斯塔尔古桥不远的民宿，稍微休整了一下，便步行出来前往古桥。</p> <p>在民宿门口，正对着的是一个教堂。这个教堂比昨天小镇上的教堂要大上少许，放了一大排椅子，更符合我心中对教堂的印象。</p> <p><a></a></p> <p><a></a></p> <p>在教堂里拍了些照，我们便继续前往古桥。古桥位于莫斯塔尔老城当中，不过我更愿意称之为古镇，毕竟老城城区大小也就一个镇子左右，城里都是些狭窄的石子路，若是将石子换成青石板，白墙黑瓦换成木柱青瓦，倒是与国内古镇别无二致。</p> <p><a></a></p> <p>穿过一小段老城的道路，便是著名的莫斯塔尔古桥。说是古桥，其实这桥修成也才 20 年。1993 年，原先的古桥在波黑战争中被炸毁，直到 8 年后才重建，虽然新桥仿照原先古桥的样式修建，使用的材料大部分是被炸毁的古桥的石料，但确确实实是一座新桥了，只是在文化上仍是一座古桥。</p> <p><a></a></p> <p>桥上游客不少，能听到一些中文的交流声音，毕竟古桥是世界文化遗产，有我们之外的国人来此地一游也不奇怪。桥的两侧设有高高的铁栏杆，以防游客不慎跌落。据说几年前，这个桥上是没有额外布设铁栏杆的，兴许是近几年出现了一些游客跌落事件，这才加装了更高的栏杆吧。在古桥上可以拍到两侧的风景，远处还有一座更现代的桥，那也是我们来时驱车经过的桥梁。在晚上，古桥还会在两侧打上灯光，照亮桥拱。</p> <p><a></a></p> <p><a></a></p> <p>在老城里逛了一圈，人乏马困，于是便在回民宿的路上找了一家餐厅用餐。今天的晚餐是烤肉大餐，算是我这个肉食爱好者的福音了。</p> <p><a></a></p> <p>吃饱喝足，下楼时偶遇从北京过来旅游的一家三口，难得有缘遇见同胞，相互聊了五六分钟，便回了民宿休息，备战第四天的旅程了。</p> <blockquote> <div><span>note</span></div> <div> <p>中篇和下篇还处于只有图片占坑写了大半的草稿状态，等以后有时间会写完发出来的~~（在写了在写了）~~ 已经拖了九个月了。</p> </div> </blockquote> </article> https://blog.hpcesia.com/posts/weekly-journal-2/https://blog.hpcesia.com/posts/weekly-journal-2/Sun, 17 Nov 2024 11:22:17 GMT<article> <p>这次周记其实主要都是些闲聊，一周的时间里，想到什么就在写什么，最后再整理一下，兴许这才是周记的正确打开方式？但想不出一个好名字用来总结了，想到了再说，现在先用着没名字的标题吧。本次周记记录时间为：11.09 - 11.17。</p> <h2>体测<a href="#体测">#</a></h2> <p>这周的体测是霉好的一千米跑和坐位体前屈，而我这学期就跑过三四次长跑，体能下降严重。再加上经常熬夜，结果就是，我成功打破了我大学以来的一千米跑最差记录，用时五分零二秒，妥妥的不及格（悲）。</p> <h2>第一台 VPS<a href="#第一台-vps">#</a></h2> <p>这周，我拿下了年轻人的第一台 VPS，买的是香港 2H2G 的轻量云，首年 110，价格还算能接受 （两张大月卡的钱）。我馋 VPS 也有段时间了，主要是馋密码管理，也就是 <a href="https://github.com/dani-garcia/vaultwarden">VaultWarden</a>。</p> <p>火狐的密码管理其实用起来也还行，毕竟我现在用的不能网页登录的软件，基本都是用密码登录也要再输一遍手机验证码的。国内厂商的软件大都这样，123456 和 20 位的大小写字母数字符号混合密码没有本质区别，因为最后都要发一遍手机验证码。但是密码存火狐那里总归不是个事，还是存自己手上舒服。</p> <p>VPS 还部署了一些其他东西，截止本文发布时，除去上文提到的 VaultWarden，我在 VPS 上还部署了 <a href="https://github.com/louislam/uptime-kuma">Uptime Kuma</a>（部署的网站状态监测，未来可能也会给友链做一下监测）、<a href="https://github.com/usememos/memos">Memos</a> 说说（用于替换我博客原来使用的静态说说）、<a href="https://github.com/go-gitea/gitea">Gitea</a>（用于存储博客源码与持续部署，不用受制于 GitHub Action 的免费额度）、<a href="https://github.com/AlistGo/alist">Alist</a>（统一各个网盘，得益于服务器位置，可以直接访问谷歌云盘）、<a href="https://github.com/searxng/searxng">SearXNG</a>（搜索引擎聚合，同样得益于服务器位置，可以直接用谷歌搜索）、<a href="https://github.com/FreshRSS">FreshRSS</a>，还有个 <a href="https://github.com/gethomepage/homepage/">Homepage</a>（个人导航页）。虽然部署了不少东西，不过目前服务器内存只占用了 55%，CPU 更是占用不超过 20%，所以还可以再部署点别的东西，如果有好用的项目欢迎各位在评论区推荐一下。</p> <p><a></a></p> <p>这里避雷一下 <a href="https://github.com/Lissy93/dashy">Dashy</a>，这个项目作为仪表盘来说，实在是有点太重了——部署时需要本地编译网页而非拉取预编译文件，导致只有 4H8G 以上配置的实例才能正常使用。我逝了一次，直接 CPU 和内存双双爆满，等了五分钟还是没反应，1Panel 直接卡死，只能去服务商那里重启服务器后卸载 Dashy。如果是性能不错的 NAS，倒是可以考虑用这个项目作为仪表盘。Dashy 虽然还可以无服务器部署，但这样就丧失了 Dashy 最大的优势：可视化配置界面，只能慢慢改 yaml，所以我选择放弃， <a href="https://gethomepage.dev/">Homepage</a> 也就是不能可视化配置，又不是不能用。不过 Homepage 有个问题，那就是不支持设置密码，需要我使用反向代理提供的密码功能，但这样就会导致每次重新打开浏览器都需要重新输入密码，而且 Bitwarden 的浏览器扩展也不能自动填充，需要手动复制，有点麻烦。</p> <p>说到 <a href="https://github.com/1Panel-dev/1Panel">1Panel</a>，这里还要吐槽一下 1Panel 应用商店里的 Gitea，强制要求数据库从 MySQL 和 PostgreSQL 里二选一，而这两尊大神光是部署就能吃掉我 1/4 的内存。Gitea 本身是支持使用 SQLite 的，对于我这种仅限个人小项目使用的需求是完全够用的。好在 1Panel 支持从本地导入应用，我把应用商店里的 Gitea 下到本地删掉选择数据库相关的内容后，上传回服务器，顺利安装运行。</p> <p>另外 Gitea 的手机端编辑体验，相比 GitHub 也差了不少。比如这段文字就是在 Gitea 的网页端用手机码的，而这节上面的几段文字则是在手机端的 Obsidian 上码完再复制过来的。Gitea 在文本框内似乎只能唤起一次输入法界面，导致我换个地方点一下就不能正常输入，需要点一下文本框外面再点回来才能再次唤起输入法。不过手机端编辑代码的舒适度应该不是 Gitea 的重点，也就将就了。但是自部署的 Gitea 就不需要在同步的时候科学上网了，再在 Gitea 上配置一下仓库镜像推送到 GitHub，对写代码的体验提升还是不错的。</p> <h2>关于鸿蒙的一点担忧<a href="#关于鸿蒙的一点担忧">#</a></h2> <p>我个人是确定在年底会入手华为的 Mate70 作为时隔三年半的新手机了（据说是 11.26 发布），现在手上用的 Mate40 虽然还能用，但总归是有些不顺心的地方。Mate70 使用鸿蒙 Next 这个新系统，不顺心的地方肯定会更多，但我毕竟没有自己的收入，换新手机只能全力倚父，而家里出钱就只能换家里选定的华为手机，所以只能是我去适应一下系统了。而且到时候我自己还会把省下来的生活费拿出一部分买台方便折腾的安卓做备用机，弥补这么多年用华为所缺失的折腾手机的快乐。</p> <p>鸿蒙 Next 最让我担心的还是生态问题。虽然国内的软件大都在积极适配鸿蒙 Next，期间也闹了不少笑话（比如 QQ 忘记加密接口造福一众 QQ 机器人开发者，微信里的升级按钮会跳转到 App Store 怎么全是 TX 的），但待到年底 Mate70 发布时，鸿蒙的生态真的能满足我的日常使用需求吗？我对此深感怀疑。</p> <p>首先就是上面提到的 VaultWarden 了，BitWarden 客户端这种需求量不大的开源软件，短时间内肯定没人移植到鸿蒙，不像 Clash 这种刚需级软件，早早地就有人移植到鸿蒙 Next 上。</p> <p>VaultWarden 主要是我确实真金白银花在上面了，所以排在最前，但我日常使用最频繁的还是火狐的跨端同步功能。那么问题来了：Mozilla 今年都两次裁员了，真的还有人力来开发鸿蒙端的火狐吗？华为和 Mozilla 最大的关系大概是同为 Rust 基金会的董事，但是这层关系应该管不到浏览器适配。更何况鸿蒙 Next 的卖点之一就是只有系统自带的 WebView，其他非 Chromium 内核的浏览器真的有机会上鸿蒙吗？其他浏览器的同步能力大概是比不上火狐的，而且 Windows 端的对应浏览器使用体验肯定也远不如火狐，所以这对我影响也很大。</p> <p>接着是几个安卓的 Xpose 模块和功能软件，主要是优化 QQ、B站、知乎使用体验（他宝贝的 B 站小可爱天天给我贴脸推送低质逆天视频来吸引争议带来的流量，所以我用模块把推荐视频和评论区全屏蔽了）的模块，和跳开屏广告的软件。没了它们，手机用起来就不那么丝滑了。</p> <p>最后是几个米哈游的游戏。虽然我大部分时间都是在电脑上打这几个游戏，手机就起个收菜清日常任务的作用，但少了他们，多少会不习惯一阵子。虽说米哈游早早就宣布要进行鸿蒙适配，但目前还是毫无音讯。虽然原神和星铁也有网页版的云游戏，但是使用体验只能说，比没有强。希望等到 Mate70 发布的时候，至少官方的云游戏能适配鸿蒙。</p> <p>担忧说完了，总归是得有点好消息才行。好消息是，虽然华为学苹果搞封闭应用商店，但是在侧载安装上留的口子比苹果大：鸿蒙目前应用自签名有效期是一年，侧载安装的开源软件可以过很长时间才重新签名一遍，比苹果只有七天好不少。</p> <h2>国产虫豸软件<a href="#国产虫豸软件">#</a></h2> <p>上文提到我在用 Xpose 模块精简软件界面，事实上，我对某些国产虫豸软件的臃肿界面诟病已久。我用过界面最舒适的正版在线音乐软件，居然是安卓端的 Apple Music，国内的软件，像 Q 音、网易、酷狗等，一个二个都是恨不得在音乐软件里再塞个直播软件，太难绷了。在线听歌其实也有开源的 <a href="https://github.com/listen1">Listen 1</a> 可用，但是我还是更喜欢本地听歌，所以没有用这个软件。</p> <p>刚才只是针对了音乐软件，事实上，大部分国产商业软件，都喜欢在一个本职功能很简单的软件上塞上视频直播、小游戏、借贷等功能，每个软件都在试图接管一切娱乐需求，这只让我极度恶心。</p> <p>但国产软件的界面还是有救的，那就是——关怀模式/大字模式/长辈模式。没错，给看不清屏幕的长辈用的界面，才是我这个年轻人最喜欢的界面：干净清爽，大部分花里胡哨没用的功能都不见了，但是厂商认为的核心功能绝对会保留。当然，也有像某宝这种虫豸，长辈模式依旧塞一堆垃圾功能，除了字大点没别的区别，不过大部分情况下使用长辈模式能够极大优化某些国产软件的使用体验。有的软件还会提供英文模式，可能比长辈模式还要简洁，例如中国移动 APP 的英文模式就只有话费、流量、通话时长和充值这几个功能。</p> <p><a></a></p> <p>使用体验上英文版 &gt;&gt; 中文版属于是国产虫豸软件的常态了。包括像各种功能也是一到英文版、一到国外，就开始收敛了。例如 Google Play Store 上的微信，在国外网络环境下就不会自己后台保活烧电量，而是走正常的消息推送路径；但只要让它发现使用者其实处于国内环境，各种妖魔鬼怪招式又会轮番上阵。</p> <h2>聊天分寸<a href="#聊天分寸">#</a></h2> <p>这周在好几个 QQ 群水群的时候都遇到了一些聊天分寸的问题，所以想在周记里聊聊。</p> <p>首先需要明确的是，不同的地方有不同的聊天氛围，有各自需要注意的分寸，就像星铁的这段剧情对话一样：</p> <p><a></a></p> <p>在我活跃过的 QQ 群里，有以发百草枯表情包为乐的群，满屏都是绿色农药图片乱飞；有全是老司机发车验车，满屏都是磁链种子的群；有每天话题在 emo→涩涩→文爱→学术→emo 之间循环的群；有专注技术讨论，闲聊超过三句就会因 ot(off topic) 被叫停的群，每个群都有不一样的聊天分寸。</p> <p>如果聊天环境完全陌生或者完全熟悉，我自然是不怕掌握不到分寸的，因为前者我基本不说话，自然不会冒犯他人；后者大家都熟悉聊天氛围，哪些冒犯的话并无恶意大家心里有数，即使稍微冒犯到了对方，也有沟通的余地。我最怕应对的是熟悉环境里的陌生人：熟悉意味着我会说些带有一定冒犯性质，但熟人不会在意的话；陌生人意味着他会在意我说的冒犯的话，结果就是我会无意间冒犯到他，然后吵起来（悲）。</p> <h2>小学生春游综合症<a href="#小学生春游综合症">#</a></h2> <p>其实就是「明明第二天有事需要早起，却辗转反侧难以入睡」的情况。虽然心情和原因大不相同，但我还是更喜欢称之为小学生春游综合症，听起来会更有乐趣一些。</p> <p>我经常会在第二天需要早起——通常是六七点——的时候，在床上闭着眼睛躺一两个小时就是睡不着。很明显，这和我的生物钟有关，常年累月的熬夜已经让我无法突然早睡了。我也尝试过前一天只睡四五个小时来强迫自己早睡，但结果往往是身体非常困，精神却很清醒，也不知道为什么。</p> </article> https://blog.hpcesia.com/posts/how-to-optimize-scanned-ebooks/https://blog.hpcesia.com/posts/how-to-optimize-scanned-ebooks/Sun, 10 Nov 2024 06:44:07 GMT<article> <h2>什么是优化的电子书<a href="#什么是优化的电子书">#</a></h2> <p>如果不看内容，只看阅读的方便程度，一本优秀的电子书应该是怎样的？最优秀的自然是由制作优良的 或 Typst 源码直接编译生成的 PDF 文件，有可跳转的目录，有目录书签，有可搜索文本。但这种电子书除非是开源的，否则只会在制作者的小圈子内流通，不会轻易流通。次一级，便是制作优良的扫描版电子书了。</p> <p>一个制作优良的扫描版电子书应该是怎样的？文字图片清晰，有目录书签与可搜索文本，这是我对制作优良的扫描版电子书的定义。我在学习一些专业课程、获取某些专业资料时，经常会遇到一些扫描版的电子书，这些电子书有一部分已经制作好了正确的目录书签，方便进行阅读，但文本不可搜索；更多的只有页码作为书签，甚至完全没有任何书签。这样的电子书显然是不方便阅读的，会极大降低学习效率，因此，我选择自力更生，对这些扫描版电子书进行优化。</p> <h2>怎么优化扫描版电子书<a href="#怎么优化扫描版电子书">#</a></h2> <p>考虑到可能的版权问题，我选择使用我自己的课程作业 pdf，通过开源在线项目 <a href="https://lookscanned.io/zh/">Look Scanned</a> 将其变成扫描件来演示。</p> <a href="https://github.com/rwv/lookscanned.io/"> <div> <div> <span>rwv/lookscanned.io</span> </div> <div> <div></div> <div></div> </div> <div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> </div> </div> </a> <h3>图像处理<a href="#图像处理">#</a></h3> <p>首先，需要将 PDF 的图像全部提取出来，这里 Windows 用户可以使用维护了 12 年、近两年开源的老牌免费 PDF 处理工具箱「PDF 补丁丁」：</p> <a href="https://github.com/wmjordan/PDFPatcher/"> <div> <div> <span>wmjordan/PDFPatcher</span> </div> <div> <div></div> <div></div> </div> <div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> </div> </div> </a> <p>macOS 与 Linux 用户可以使用下面的项目作为替代品：</p> <a href="https://github.com/Stirling-Tools/Stirling-PDF/"> <div> <div> <span>Stirling-Tools/Stirling-PDF</span> </div> <div> <div></div> <div></div> </div> <div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> </div> </div> </a> <p>Stirling-PDF 的图像提取功能似乎不够完善，不能直接提取扫描件的图像，需要使用 PDF 转图像功能才能正常导出图像，速度慢不少。</p> <p>提取出全部图像后，就该对其进行处理了。Scantailor Advanced 是一个开源的扫描件处理软件，虽然其基于的 Scantailor 已经 Public Archive 了，但是依旧好用。</p> <a href="https://github.com/4lex4/scantailor-advanced/"> <div> <div> <span>4lex4/scantailor-advanced</span> </div> <div> <div></div> <div></div> </div> <div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> </div> </div> </a> <p>在软件中新建项目，选择之前导出的图片，就可以开始图片处理了。</p> <p><a></a></p> <p>页面是全英文，没有中文翻译，但是看懂难度不大。点击右上角栏目右边的小绿三角就可以对所有页面执行当前的操作了，基本全部使用 auto 即可，效果相当不错。需要注意，右侧的选项调整默认只对当前页面生效，需要使用「Apply to」按钮来应用到全部页面。</p> <p><a></a></p> <p>需要注意的是，中文文档可能需要在 output 中关闭「Savitzky-Golay smoothing」，不然文字会糊成一团。DPI 可以调高一点，不然容易看不清，全是黑白页面的话 DPI 拉高，文件大小也不会太大。</p> <p>一路优化完成后，只要 output 中处理了全部页面且效果满意，就可以关闭软件了，输出的图片会保存在 out 目录中。接着使用 PDFPatcher 或 Stirling-PDF 合并导出的图片为 PDF，第一步处理大功告成。</p> <p><a></a> <a></a></p> <p>可以看出文字效果不错，图像效果有点差。</p> <h3>OCR<a href="#ocr">#</a></h3> <p>第二步，是对 PDF 做 OCR 处理，这里需要用到一个开源项目：</p> <a href="https://github.com/hiroi-sora/Umi-OCR/"> <div> <div> <span>hiroi-sora/Umi-OCR</span> </div> <div> <div></div> <div></div> </div> <div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> </div> </div> </a> <p>这是一个支持多种开源 OCR 模型的开源项目，支持 Windows 7 及以上的 Windows x64 平台与 Linux x64 平台，可以方便地将扫描版的 PDF 转换为带有可搜索图像文本的 PDF，同时使用了嵌入 Python 解释器，可以让小白开箱即用。</p> <p><a></a> <a></a></p> <p>对于 macOS 用户，由于该项目作者没钱买 mac （好真实的理由），所以目前只能通过 Docker 或虚拟机的方式来使用。</p> <p>由于该软件界面一目了然，因此不做过多说明，选择批量文档，内容提取模式选择「混合 OCR/原文本」即可。</p> <h3>目录书签制作<a href="#目录书签制作">#</a></h3> <p>第三步，则是制作目录书签。这里同样需要用到一个开源项目：</p> <a href="https://github.com/chroming/pdfdir/"> <div> <div> <span>chroming/pdfdir</span> </div> <div> <div></div> <div></div> </div> <div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> </div> </div> </a> <p>该项目可以将给定的目录作为书签嵌入到 PDF 当中。目录的获取有几种办法，首先是去一些有该电子书信息的的网站上查找是否有目录信息，有的话用网站上的最好；如果找不到现成信息，则可以使用刚才 OCR 好的 PDF，利用书里的目录来制作，但由于 OCR 识别的不稳定性，这种方式通常需要手动修正文本。</p> <p><a></a></p> <p>如图所示，该工具支持自定义正则表达式来匹配目录层级，也支持设置页差，可以方便快捷地将目录书签注入到 PDF 中。</p> <h3>效果演示<a href="#效果演示">#</a></h3> <p>将源文件和制作的优化版扫描文件进行对比，可以看出效果还是不错的：</p> <p><a></a> <a></a></p> </article> https://blog.hpcesia.com/posts/weekly-journal-1/https://blog.hpcesia.com/posts/weekly-journal-1/本次周记记录了在 11 月的个人博客优化工作与生活日常。Sat, 09 Nov 2024 07:27:11 GMT<article> <p>上回的月记还说自己没那信心周更，但这周事情不少，所以还是可以写一篇出来的。</p> <p>为了与之前的月记无缝衔接，本次周记记录时间为：11.01 - 11.08</p> <h2>小屋装修<a href="#小屋装修">#</a></h2> <h3>更换网站部署<a href="#更换网站部署">#</a></h3> <p>这周我把网站部署从 GitHub Page 切换到 Netlify 了。GitHub Page 用的好好的，为什么要换呢？因为 Netlify 速度确实快。得益于较高的审核门槛，Netlify 不像 Vercel 那样默认域名被完全屏蔽，挂上自己域名以后更是速度相当不错，比 GitHub Page 走 Cloudflare CDN 速度要快一些： <a></a> <a></a> 效果可以说是相当明显了。我还听了<a href="https://chlo.is/">小氯</a>的建议，挂了一下<a href="https://github.com/xingpingcn/enhanced-FaaS-in-China">优选线路</a>，速度更快了： <a></a></p> <p>另一方面则是，我认为 GitHub Page 应该留给更正经的项目的页面，而不是我的个人博客。由于我之前一段时间使用的是 github.io 域名，且做过 SEO，因此我现在将 GitHub Page 指向了 blog-backup 域名，该域名又会 301 重定向到主域名，以保证搜索结果正确跳转。等到我有合适的项目主页放到 GitHub Page 的时候，大概就不需要再考虑之前博客做的 SEO 了。</p> <h3>友链朋友圈<a href="#友链朋友圈">#</a></h3> <p>我看友链朋友圈这东西眼馋不少时间了 （主要是我没服务器不能部署 RSS），所以这周也花了点时间整了一个<a href="https://github.com/willow-god/Friend-Circle-Lite">轻量友链朋友圈</a>，目前姑且是作为我个人的丐版 RSS 来使用，等后续下定决心买云服务器了再自建一个 RSS 来用。</p> <h3>其他琐碎的装修<a href="#其他琐碎的装修">#</a></h3> <p>剩下的就是一些琐碎的装修内容了，比如改了下右键菜单「引用到评论」的逻辑，改了改游戏页面，往页脚加了只<a href="https://images.hpcesia.com/6729fd1e96b9d.webp">探头的七七</a>。</p> <h3>排版<a href="#排版">#</a></h3> <h4>Markdown 标题<a href="#markdown-标题">#</a></h4> <p>最近闲来无事，打开 Bing 的站点管理工具看了一眼，提示我页面中 <code>&lt;h1&gt;</code> 标签过多。我发现这是我的 Markdown 书写风格不太好导致的。知名 Markdown 语法检查器 <a href="https://github.com/DavidAnson/markdownlint">markdownlint</a> 的<a href="https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md025---multiple-top-level-headings-in-the-same-document">第 25 条规则</a>指出，一个 Markdown 文件中，一级标题 <code># Heading 1</code> 应该用作文章标题，有且只有一个，因此正文中最高的标题层级只能是二级标题 <code>## Heading 2</code>。但是我自己在写文章的时候，文章分段标题都是使用的一级标题，所以我需要对其进行修改。</p> <p>最开始我打算使用正则表达式，批量修改所有文章的标题层级。但是经过一番尝试，由于代码块中的代码注释也可能以 <code>#</code> 开头，正则表达式要考虑的东西有点多，果断放弃了。但幸运的是，我渲染文章使用的引擎是 <a href="https://github.com/hexojs/hexo-renderer-pandoc">hexo-renderer-pandoc</a>，而 pandoc 显然考虑到了这一问题，提供了一个选项来控制标题层级：<code>--shift-heading-level-by=NUMBER</code>，于是我愉快的避免了为此花时间搓一个重复的轮子。</p> <h4>行内公式与中文混排<a href="#行内公式与中文混排">#</a></h4> <p>我在翻看自己博客的时候，总有一点让我非常在意，那就是行间公式和中文的混排效果： <a></a> 可以发现，行间公式与中文混排时，右边是没有间距的，看着非常难受。但是当我在本地使用 <code>hexo server</code> 时，混排效果却是正常的两边都有间距，而按正常步骤生成静态页面后使用 <code>hexo server --static</code>，则是没有右边间距的混排效果。</p> <p>那么问题来了，是什么影响了这个混排效果？思来想去，发现是因为我使用了 Gulp 来压缩 html 文件，结果把正常的间距给压缩没了。翻了下文档，选择在使用 gulp-html-minifier-terser 压缩 html 时加上 <code>conservativeCollapse: true</code> 这个参数来解决问题。</p> <h4>Hello, AutoCorrect, and Goodbye<a href="#hello-autocorrect-and-goodbye">#</a></h4> <p>我在<a href="https://www.eallion.com/cjk-punctuation/">到处乱逛</a>的时候，发现了 <a href="https://github.com/huacnlee/autocorrect">AutoCorrect</a> 这个好东西。这个工具可以自动提示文章中英文混排的一些错误，并且可以使用命令行或 VSCode 插件进行自动格式化。</p> <p>这听起来相当诱人——尤其是我写文章的时候一般都会手动在中英文之间加上空格，而使用这个插件以后，我就不用再花费时间来手打空格了。但是只使用了十分钟，我便卸载了 AutoCorrect 的 VSCode 插件。这是因为 AutoCorrect 的自动格式化在各式各样的 Markdown 方言面前有些发力。例如 Hexo 支持文章中以 <code>{% tag_name ..args %}</code> 的方式来使用<a href="https://hexo.io/zh-cn/docs/tag-plugins">标签插件</a>，但是 AutoCorrect 的自定义 <code>textRules</code> 不支持使用正则匹配来忽略这些特殊方言语法，而我又经常需要使用这些标签插件，因此我最终还是卸载了这个插件。</p> <h4>Hello, 赫蹏<a href="#hello-赫蹏">#</a></h4> <p><a href="https://github.com/sivan/heti">赫蹏</a>（hètí）是专为中文内容展示设计的排版样式增强样式/脚本。因为我博客不需要使用赫蹏的字体，因此我按照下面这篇文章，提取了赫蹏的标点压缩和自动中英混排间距功能放到了博客里。</p> <p>{% link ‘博客排版 - 挤压中文标点符号’ 大大的小蜗牛 <a href="https://www.eallion.com/cjk-punctuation/">https://www.eallion.com/cjk-punctuation/</a> %}</p> <p>效果还是不错的： <a></a></p> <p>结果到了手机端一看，括号和逗号直接连在一起了，排查后发现，是因为霞鹜文楷最近支持了 OpenType 的 <code>halt</code> 特性。不知道为什么只有移动端的字体应用了该特性，导致 PC 端检查的时候没问题，移动端一看标点重叠，于是用 CSS 的 <code>@supports</code> 规则把这个 bug 修复了。希望火狐后续能支持 <code>text-spacing-trim</code> 特性吧。</p> <p>另外，不知道为什么，自从我开始用赫蹏以后，手机端就不能正确显示霞鹜文楷的字体了，很怪。</p> <h2>体测<a href="#体测">#</a></h2> <p>非常不幸的，我这周要进行体测。厦大的体测规则是，只要本学期选修了体育课，就要参加该体育课老师所组织的体测，而我这学期选修了羽毛球课，因此必须参加。上次的<a href="/posts/monthly-journal-1/">月记 true</a>里说过，我的膝盖受了擦伤。虽然不算严重，恢复得也还不错，但在周一的体测的时候，擦伤是没有完全恢复的。幸运的是，这周的体测不用考一千米——下周才考，所以我至少不会因为大量流汗感受伤口撒盐的痛苦了。</p> <h2>期中<a href="#期中">#</a></h2> <p>这周正好还是期中周，虽然大四基本没啥课了，但是为了凑够学分，我还是选了两门据说比较水的课：《经济学基础》和《多复变函数论》。</p> <p>《多复变函数论》课程本身并不水，老师讲的很好，每节课都是黑板哗哗写，但是——我听不懂（悲）。说这门课「水」，其实是因为这门课是选修课，一般不会卡人，而且老师也知道这门课难度比较大，所以考的基本都是 PPT 上的东西，而且期中并没有考试，而是布置了整个课程唯一一次作业，内容也都是 PPT 上的东西，只要看懂 PPT 上的定理证明，自己写一遍就行了。唯一比较花时间的是老师的 PPT 没用 XeTaX 生成，导致中文复制出来全是乱码，OCR 又不好处理公式，只能慢慢手打了。</p> <p>《经济学基础》倒是真水课，课程基本全念 PPT，作业也简单——导致我整个上半学期的课要么摸鱼要么翘了。因为保研已经结束了，绩点没啥用，所以这门课只需要不挂科，拿到学分就算成功。因此，直到考试前一天，我才开始突击复习 （预习），在 B 站上看一些经济学基础速成的视频，做一下往年的试卷，确保不会挂科。事实证明速成确实不靠谱，考试的时候一堆东西都是完全不清楚，不过靠着一点常识和推理，多少还是把大部分的题都做了，应该能及格……吧。</p> </article> https://blog.hpcesia.com/posts/monthly-journal-1/https://blog.hpcesia.com/posts/monthly-journal-1/本次月记记录了生日、寻找毕业论文导师的经历以及笔记本风扇损坏等问题。通过自学和开源项目改进了博客代码高亮功能，并探讨了构建多端同步编写博文的工作流方案。Fri, 01 Nov 2024 08:31:20 GMT<article> <p>因为看到一些好看的周记，所以也打算自己写点类似的东西。但是我实在是没有周更的信心（无论是从更新文字量还是从每周可写的经历量来说都是如此），因此决定先写个月记试试水。</p> <p>本次月记记录时长为 5 周：9.27 - 10.31。</p> <h2>生日<a href="#生日">#</a></h2> <p>是的，其实记录时长为五周就是为醋包的饺子——这样才能包含我的 21 岁生日。</p> <p>今年的生日似乎并没有什么特别的，仍然是自己一个人过，已经习惯如此了。回望整个大学生活，我似乎都没有多少社交，平日总是待在宿舍打游戏、写代码、赶作业，偶尔出去骑车也是独自一人默默骑行；出去旅游要么是为了参加漫展，要么是被父母拉着一起；除了舍友外，只有寥寥几个点头之交的同学，甚至三年来没有一个交流超过五句话的同龄异性。但我却没觉得缺了什么，或许是性格使然？只是每次父母半开玩笑地问我有没有耍朋友时只能尬笑着糊弄过去。</p> <p>其实本来是打算看场电影的，因为那几天正好要去万达影城，线下取原神和万达联动里买的一些周边。但可惜的是，翻了一圈当天的电影，没一个感兴趣的，唯一感兴趣的流浪地球 2 的 3D 版，也只有离得很远的几个影城还在上映，所以只能拿了周边就走人。但好歹是生日，总得犒劳一下自己吧。于是我在去万达影城的路上顺便在 B 站刷了刷厦门的各种自助餐厅的视频，选定了一家顺路的牛肉自助，准备拿完周边就去吃顿饱的。 <a></a></p> <p>说实话，自助味道不错——至少对得起价格。我吃得挺撑，炫了差不多二十盘现切牛肉，不知道算不算给老板上课？不过厦门能人这么多，我这点食量大抵是算不上号的吧（笑）。</p> <h2>毕业论文导师<a href="#毕业论文导师">#</a></h2> <p>在国庆假期前几天，我们年级的教秘在通知群里发了个通知：该找自己的本科毕业论文导师了！</p> <p>这实在是个晴天霹雳——我完全没有任何找导师的准备。更何况，这个毕业论文导师还是双向选择的，而我，一个专业课常年在挂科边缘试探的摆烂人，真的不会找一个导师就被拒一个吗（悲）。</p> <p>但咨询了下消息灵通的同学，毕业论文导师貌似没有保底分配的机制，所以只能硬着头皮去找导师了。从同学那里抄了份邮件模板，我便用学校的邮箱给数院唯一一个研究方向涉及计算机应用，也是唯一一个研究方向我感兴趣的教授发了封申请的邮件。</p> <p>显然，如果事情进展顺利，就不会有接下来这几段了。等到十一假期刚开始时，我收到了教授的回复：名额满了。看来你虾数院唯一和方向和计算机密切相关的教授真的很受欢迎（悲）。整理了下心态，我就找了个研究方向起码是计算数学的教授又发了份邮件，等待教授的回复。 <a></a></p> <p>这一等，就是一整个国庆假期。每天我都打开邮箱，期待有教授的回复，但是等到的都只有毫无变化的收件箱。待到十一假期结束，我也算是死了心了——大抵这位教授确实是不看邮箱吧。毕业论文导师的申报到16号就截止了，还有一周时间，我必须抓紧再找一个教授问问了。</p> <p>这次我选择想办法找个冷门的老师。我对照着我们学院的官网上的师资名单和可选择的导师列表，选择了一个看起来应该不会有多少人专门去选的导师，再次发了一封模板式的邮件过去。第二天，我就得到了老师的回复——Can Can Need 成绩单。</p> <p>好在我虽然大部分偏理论的课程绩点都是 1 和 2 开头，但总归是有那么一两个满绩的偏应用的专业课撑场面的，至少没让我再次被拒。很快，我便与预备导师约好了时间面谈。</p> <p>到了面谈的时候，略过一小段客套话，我便又听到了了一个噩耗：这位预备导师主要做的是理论分析——而从我的成绩单上就能看出，我对理论分析是一窍不通。好在我的预备导师也研究过我的成绩单，知道我“代码的课分都贼高，理论的课分就不怎么样”，于是为我找了个只要花时间啃代码就能做的题目（具体内容就不透露了）。</p> <p>就此，可喜可贺，我至少在申报截止前成功找到了本科毕业论文导师，并且导师看起来人还不错，实在是可喜可贺呐。</p> <h2>国庆<a href="#国庆">#</a></h2> <p>不知道看这篇文章的朋友们，国庆假期都去哪玩了呢？</p> <p>我……哪里也没去，整个假期都待在宿舍里折腾博客和备战考研。国庆假期里宿舍晚上不会断电，而我的舍友都出去玩去了，这也就意味着——我可以尽情通宵辣！</p> <p>整个国庆假期，我通宵搓博客代码搓了三次 （你见过凌晨四点的厦大校园吗），属实是昼夜颠倒了 （其实这段文字在码下来的时候正是凌晨四点，我躺床上半天睡不着，于是怒而编写本文）。</p> <p>值得一提的是，由于国庆假期玩得太疯，导致我完全忘了国庆假期什么时候结束。于是在国庆假期的最后一天，星期一的早晨，我怀揣着对舍友全体翘课的震惊，背着羽毛球拍到了室内羽毛球馆门口——然后看到了紧闭的大门。这时候我才反应过来：woc，该不会还在放假吧！（乐）</p> <p>在常冒泡的 QQ 群分享了这一发现，并收获了十几个「🐷？」的回复后，我终于确认现在确实还在放假的事实——我白早起白通勤了（悲）。</p> <h2>受伤<a href="#受伤">#</a></h2> <p>作为偶尔出去环岛骑行的单车佬，受点擦伤属于是家常便饭了。但这次不一样——我是在宿舍楼下推车的时候摔的。当时正是下课回宿舍，我把自行车推进宿舍大门，想着单脚踩在踏板上滑行大概会更快 （也更帅），于是就把一只脚踩在自行车上开始滑行——然后就直直地摔了下去。</p> <p>于是我就喜提了膝盖擦伤，图就不在这篇文章里发了，目前草稿箱里放了一篇擦伤恢复记录，后续大概会发出来，用于记录我自己的表浅擦伤处理经验 （摔车摔多了导致的）。</p> <h2>考研<a href="#考研">#</a></h2> <p>说实话，我自己对考研准备并不充分。一直到开始报名的时候，我都没想好到底要考什么学校，考什么科目。但是时间上已经来不及了，于是我选择了少数计算机还在考自命题而不是 408 的学校——虽然他复试还是会考 408，但总归是能多点时间复习了。</p> <h2>风扇<a href="#风扇">#</a></h2> <p>最近，我的笔记本风扇突然坏了——大概是我平时喜欢把笔记本竖起来当副屏使导致的。在这之前我的桌面是这样的 （口瓜，是二次元，大家快退啊）： <a></a></p> <p>总之，风扇就是这么突然的坏了。其实影响本身不算特别大：时不时会发出很大声的嗡嗡异响，没异响的时候长时间打游戏容易直接过热关机。不长时间打游戏的话，还可以凑合着用——直到有一天我带着笔记本去了教室，然后风扇正好在上课的时候响起来了（万众瞩目.webp）。于是我赶紧关机，并开始在某宝上搜索我的笔记本的替换风扇。</p> <p>不幸的是，我的笔记本是一个小众的型号，所以我花了半节课的时间也没搜到我的型号对应的风扇。但办法总比困难多：按某宝商品介绍的说法，一些风扇只是颜色不一样，但是电压、形状和孔位是一致的，也就是说只要找到和我的笔记本风扇除了颜色外一模一样的其他型号的风扇，也可以拿来作为替换。于是待到下课回宿舍，我便拿出螺丝刀开始拆机，查看风扇的外观，顺便清了一下陈年老灰。又花了半个多小时，总算是找到了合适的风扇，进行一个单的下。</p> <h2>Hello, Shiki<a href="#hello-shiki">#</a></h2> <p>这一节的标题是仿照的<a href="https://chlo.is/">小氯</a>的一个文章分类。（事实上，小氯的博客上也有<a href="https://www.yoghurtlee.com/hello-shiki/">相同标题的文章</a>）</p> <p>我最近一年一直在使用 <a href="https://typst.app/">Typst</a> 来完成各种专业课程的作业，现在建了博客，自然也需要在分享一些 Typst 代码片段。但这时候，问题出现了：Hexo 自带的 highlight.js 和 prismjs 均不支持比较新的 Typst 的语法高亮。</p> <p>最开始，我是参考 <a href="https://foolishfox.cn/posts/202402-typst-block.html">Foolish Fox 的文章</a>，利用纸夜姐姐的 <a href="https://github.com/Myriad-Dreamin/typst.ts">typst.ts</a> 解析 Typst 代码并利用 Hexo 的标签插件进行渲染，这也是这位大佬的博客出现在我的友链里的原因。但是这样总归不是一个一劳永逸的方法——未来还可能有新语言，但每个新语言都这样适配也太累了。于是我将目光转向了 <a href="https://shiki.tmrs.site/">Shiki</a>。</p> <p>第一步自然是先去找有没有现成的轮子可用。通过 GitHub 搜索 「hexo shiki」，我成功找到了适用于 <a href="https://github.com/fluid-dev/hexo-theme-fluid">Fluid 主题</a>的 <a href="https://github.com/nova1751/hexo-shiki-plugin">hexo-shiki-plugin</a>、做了 djot 适配的 <a href="https://github.com/Pcrab/hexo-highlight-shiki">hexo-highlight-shiki</a> 以及使用 TypeScript 编写的 <a href="https://github.com/ArcticLampyrid/hexo-shiki-highlighter">hexo-shiki-highlighter</a>。但很可惜，这些轮子都不适合在我的主题上直接使用，于是我选择——开缝！</p> <p>由于我事实上并没有任何 TypeScript 和 JavaScript 的开发经验，所以我选择 IDE 的提示更完善的 TypeScript 进行开发。基于 <a href="https://github.com/ArcticLampyrid/hexo-shiki-highlighter">hexo-shiki-highlighter</a>，我靠着 AI 摸索着写了个还算能用的插件：</p> <a href="https://github.com/HPCesia/hexo-highlighter-shiki/"> <div> <div> <span>HPCesia/hexo-highlighter-shiki</span> </div> <div> <div></div> <div></div> </div> <div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> <div> <span></span> </div> </div> </div> </a> <p>里面所有功能基本都是我自己用得上的功能，所以一些我没用上的功能可能会有 BUG，如果看到这段话的朋友愿意使用我的插件，并发现了一些 BUG，欢迎给我提 issue。</p> <h2>工作流<a href="#工作流">#</a></h2> <p>上文提到，我电脑的风扇坏了，而我在拆机检查完风扇后选择了偷懒：大部分螺丝都没有装回去，只装了必要的几颗螺丝，方便过几天拆机。这也意味着我不能长时间使用我的笔记本了——不然因为少装螺丝导致电脑坏了就麻烦了。但博客总得写啊！于是我开始思考，如何构建一个多端同步编写博文的工作流。</p> <p>我的博客源码同时上传到了 GitHub 的私有仓库上，所以最简单的工作流大概是使用 GitHub Action 了。但这就牵扯到了一个问题：正如上文所说，我同时还在开发 Hexo 插件，因此我的博客用到了一些 npm 本地包，这些包是不能直接在 GitHub Action 上使用的。</p> <p>当然了，实际上我也并不需要随时随地改博客的源码。对我来说，只需要多端同步我的博文就能满足需求了。但问题又出现了：我使用的是华为手机，而且年底估计会换搭载鸿蒙 Next 的 mate70，因此基于软件的同步方案就显得不靠谱了。</p> <p>目前想到的解决方案，是使用带 Markdown 编辑功能，且可以随意设置同步位置的同步云盘来管理博文，但目前还没找到合适的云盘（悲）。现阶段我暂时使用安卓端 Obsidian 码字，然后手动把写了一半的文章发给电脑，来达成随时编写文章的目的。</p> </article> https://blog.hpcesia.com/posts/cpp-dev-env-in-vscode-on-windows/https://blog.hpcesia.com/posts/cpp-dev-env-in-vscode-on-windows/使用 VSCode + MSYS2 + Clang + Clangd + Xmake 搭建优雅的 Windows C++ 开发环境。Sun, 13 Oct 2024 07:21:27 GMT<article> <h2>准备工作<a href="#准备工作">#</a></h2> <p>由于我们最终是要使用 VSCode 而非 Visual Studio 进行 C++ 开发，因此本节 Clang 的安装将使用 MSYS2 + mingw-w64 进行。</p> <h3>安装 MSYS2<a href="#安装-msys2">#</a></h3> <p>在 <a href="https://github.com/msys2/msys2-installer/releases">GitHub Release</a> 上下载最新版的 MSYS2 安装包。如果访问 GitHub 有困难，也可以使用<a href="https://mirrors.tuna.tsinghua.edu.cn/msys2/distrib/">清华镜像源</a>进行下载。</p> <p>下载后打开安装程序，选择一个合适的路径，然后一路点 next 即可安装完成。</p> <p>打开 Windows Terminal，在设置中选择打开 JSON 文件，然后将下列配置添加到打开的 JSON 文件中，注意更换 MSYS2 路径为自己的安装路径：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>"profiles"</span><span>: </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>"</span><span>list</span><span>"</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>[</span></div></div><div><div><div>4</div></div><div><span> </span><span>// ...</span></div></div><div><div><div>5</div></div><div><span> </span><span>{</span></div></div><div><div><div>6</div></div><div><span> </span><span>"</span><span>guid</span><span>"</span><span>:</span><span> </span><span>"{17da3cac-b318-431e-8a3e-7fcdefe6d114}"</span><span>,</span></div></div><div><div><div>7</div></div><div><span> </span><span>"</span><span>name</span><span>"</span><span>:</span><span> </span><span>"Clang64 / MSYS2"</span><span>,</span></div></div><div><div><div>8</div></div><div><span> </span><span>"</span><span>commandline</span><span>"</span><span>:</span><span> </span><span>"C:/msys64/msys2_shell.cmd -defterm -here -no-start -clang64"</span><span>,</span></div></div><div><div><div>9</div></div><div><span> </span><span>"</span><span>startingDirectory</span><span>"</span><span>:</span><span> </span><span>"C:/msys64/home/%USERNAME%"</span><span>,</span></div></div><div><div><div>10</div></div><div><span> </span><span>"</span><span>icon</span><span>"</span><span>:</span><span> </span><span>"C:/msys64/Clang64.ico"</span><span>,</span></div></div><div><div><div>11</div></div><div><span> </span><span>},</span></div></div><div><div><div>12</div></div><div><span> </span><span>{</span></div></div><div><div><div>13</div></div><div><span> </span><span>"</span><span>guid</span><span>"</span><span>:</span><span> </span><span>"{71160544-14d8-4194-af25-d05feeac7233}"</span><span>,</span></div></div><div><div><div>14</div></div><div><span> </span><span>"</span><span>name</span><span>"</span><span>:</span><span> </span><span>"MSYS / MSYS2"</span><span>,</span></div></div><div><div><div>15</div></div><div><span> </span><span>"</span><span>commandline</span><span>"</span><span>:</span><span> </span><span>"C:/msys64/msys2_shell.cmd -defterm -here -no-start -msys"</span><span>,</span></div></div><div><div><div>16</div></div><div><span> </span><span>"</span><span>startingDirectory</span><span>"</span><span>:</span><span> </span><span>"C:/msys64/home/%USERNAME%"</span><span>,</span></div></div><div><div><div>17</div></div><div><span> </span><span>"</span><span>icon</span><span>"</span><span>:</span><span> </span><span>"C:/msys64/msys2.ico"</span><span>,</span></div></div><div><div><div>18</div></div><div><span> </span><span>},</span></div></div><div><div><div>19</div></div><div><span> </span><span>// ...</span></div></div><div><div><div>20</div></div><div><span> </span><span>]</span></div></div><div><div><div>21</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接着在 Windows Terminal 中打开刚刚设置的 Clang64 / MSYS2 界面，在终端中输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sed</span><span> </span><span>-i</span><span> </span><span>"s#https\?://mirror.msys2.org/#https://mirrors.tuna.tsinghua.edu.cn/msys2/#g"</span><span> </span><span>/etc/pacman.d/mirrorlist</span><span>*</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>将 MSYS2 的包仓库更换为清华镜像源，然后输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pacman</span><span> </span><span>-Syu</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>更新系统。</p> <h3>安装 Clang 工具链<a href="#安装-clang-工具链">#</a></h3> <blockquote> <div><span>warning</span></div> <div> <p>clang 应当安装在 clang64 环境下，否则会导致 clangd 识别头文件出错</p> </div> </blockquote> <p>在 Clang64 / MSYS2 命令行中输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pacman</span><span> </span><span>-S</span><span> </span><span>mingw-w64-clang-x86_64-toolchain</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>即可安装 clang 工具链。</p> <h3>安装 Xmake<a href="#安装-xmake">#</a></h3> <ul> <li> <p><strong>Windows 安装包</strong></p> <p>在 <a href="https://github.com/xmake-io/xmake/releases">Release</a> 上下载最新版的 xmake-master.win64.exe，安装即可。</p> </li> <li> <p><strong>winget</strong></p> <p>在终端输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>winget</span><span> </span><span>install</span><span> </span><span>xmake</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>即可安装 Xmake。</p> </li> <li> <p><strong>msys2</strong></p> <p>在 Clang64 / MSYS2 命令行中输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pacman</span><span> </span><span>-Sy</span><span> </span><span>mingw-w64-x86_64-xmake</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>即可安装 Xmake。</p> </li> </ul> <h3>安装 VSCode 插件<a href="#安装-vscode-插件">#</a></h3> <p>在 VSCode 的扩展选项卡搜索 Clangd、CodeLLDB、Xmake 并安装。</p> <p>CodeLLDB 的安装过程中会下载一个文件，国内网络大概率下载失败，可以点击弹出消息的手动下载按钮，然后再从 VSIX 安装下载的包。</p> <h2>配置<a href="#配置">#</a></h2> <h3>VSCode 配置<a href="#vscode-配置">#</a></h3> <p>在 VSCode 的 setting.json 中添加如下内容：</p> <div><figure><figcaption><span>settings.json</span></figcaption><pre><code><div><div><div>1</div></div><div><span>// Xmake</span></div></div><div><div><div>2</div></div><div><span>"xmake.debugConfigType"</span><span>: </span><span>"codelldb"</span><span>, </span><span>// 使用 codelldb 插件而非 cpptools 进行调试</span></div></div><div><div><div>3</div></div><div><span>"xmake.runMode"</span><span>: </span><span>"buildRun"</span><span>, </span><span>// 运行前自动 build</span></div></div><div><div><div>4</div></div><div><span>"xmake.buildLevel"</span><span>: </span><span>"verbose"</span><span>, </span><span>// 设置编译时输出信息级别,默认是warnings级别,仅输出编译警告信息以及正常信息,verbose级别输出完整的编译命令行参数,debug级别对应 xmake -vD 的诊断信息，会打印出错的栈信息</span></div></div><div><div><div>5</div></div><div><span>"xmake.customDebugConfig"</span><span>: </span><span>{</span></div></div><div><div><div>6</div></div><div><span> </span><span>"</span><span>console</span><span>"</span><span>:</span><span> </span><span>"integratedTerminal"</span><span> </span><span>// XMake调试时使用集成终端而非 debug console,也可以使用 externalTerminal</span></div></div><div><div><div>7</div></div><div><span>}</span><span>,</span></div></div><div><div><div>8</div></div><div><span>// Clangd</span></div></div><div><div><div>9</div></div><div><span>"clangd.path"</span><span>: </span><span>"C:/msys64/clang64/bin/clangd.exe"</span><span>, </span><span>// Clangd 文件位置</span></div></div><div><div><div>10</div></div><div><span>"clangd.arguments"</span><span>: </span><span>[</span></div></div><div><div><div>11</div></div><div><span> </span><span>"--all-scopes-completion"</span><span>,</span><span> </span><span>// 全局补全(补全建议会给出在当前作用域不可见的索引,插入后自动补充作用域标识符),例如在main()中直接写cout,即使没有`#include &lt;iostream&gt;`,也会给出`std::cout`的建议,配合"--header-insertion=iwyu",还可自动插入缺失的头文件</span></div></div><div><div><div>12</div></div><div><span> </span><span>"--background-index"</span><span>,</span><span> </span><span>// 后台分析并保存索引文件</span></div></div><div><div><div>13</div></div><div><span> </span><span>"--clang-tidy"</span><span>,</span><span> </span><span>// 启用 Clang-Tidy 以提供「静态检查」</span></div></div><div><div><div>14</div></div><div><span> </span><span>"--clang-tidy-checks=performance-*, bugprone-*, misc-*, google-*, modernize-*, readability-*, portability-*"</span><span>,</span></div></div><div><div><div>15</div></div><div><span> </span><span>"--compile-commands-dir=${workspaceFolder}/.vscode"</span><span>,</span><span> </span><span>// 编译数据库(compile_commands.json 文件)的目录位置</span></div></div><div><div><div>16</div></div><div><span> </span><span>"--completion-parse=auto"</span><span>,</span><span> </span><span>// 当 clangd 准备就绪时，用它来分析建议</span></div></div><div><div><div>17</div></div><div><span> </span><span>"--completion-style=detailed"</span><span>,</span><span> </span><span>// 建议风格：打包(重载函数只会给出一个建议);还可以设置为 detailed</span></div></div><div><div><div>18</div></div><div><span> </span><span>"--enable-config"</span><span>,</span><span> </span><span>// 启用配置文件(YAML格式)</span></div></div><div><div><div>19</div></div><div><span> </span><span>"--fallback-style=LLVM"</span><span>,</span><span> </span><span>// 默认格式化风格: 在没找到 .clang-format 文件时采用,可用的有 LLVM, Google, Chromium, Mozilla, Webkit, Microsoft, GNU</span></div></div><div><div><div>20</div></div><div><span> </span><span>"--function-arg-placeholders=true"</span><span>,</span><span> </span><span>// 补全函数时，将会给参数提供占位符，键入后按 Tab 可以切换到下一占位符，乃至函数末</span></div></div><div><div><div>21</div></div><div><span> </span><span>"--header-insertion-decorators"</span><span>,</span><span> </span><span>// 输入建议中，已包含头文件的项与还未包含头文件的项会以圆点加以区分</span></div></div><div><div><div>22</div></div><div><span> </span><span>"--header-insertion=never"</span><span>,</span><span> </span><span>// 插入建议时不自动引入头文件</span></div></div><div><div><div>23</div></div><div><span> </span><span>"--log=verbose"</span><span>,</span><span> </span><span>// 让 Clangd 生成更详细的日志</span></div></div><div><div><div>24</div></div><div><span> </span><span>"--pch-storage=memory"</span><span>,</span><span> </span><span>// pch 优化的位置(Memory 或 Disk,前者会增加内存开销，但会提升性能)</span></div></div><div><div><div>25</div></div><div><span> </span><span>"--pretty"</span><span>,</span><span> </span><span>// 输出的 JSON 文件更美观</span></div></div><div><div><div>26</div></div><div><span> </span><span>"--ranking-model=decision_forest"</span><span>,</span><span> </span><span>// 建议的排序方案：hueristics (启发式), decision_forest (决策树)</span></div></div><div><div><div>27</div></div><div><span> </span><span>"-j=12"</span><span>,</span><span> </span><span>// 同时开启的任务数量</span></div></div><div><div><div>28</div></div><div><span> </span><span>"--query-driver=C:/msys64/clang64/bin/clang*"</span><span> </span><span>// clang 编译器的路径（设置错误会导致 clangd 无法识别标准库）</span></div></div><div><div><div>29</div></div><div><span>]</span><span>,</span></div></div><div><div><div>30</div></div><div><span>"clangd.checkUpdates"</span><span>: </span><span>true</span><span>, </span><span>// 自动检测 clangd 更新</span></div></div><div><div><div>31</div></div><div><span>"clangd.onConfigChanged"</span><span>: </span><span>"restart"</span><span>, </span><span>// 借助网上的信息排序建议</span></div></div><div><div><div>32</div></div><div><span>"clangd.detectExtensionConflicts"</span><span>: </span><span>true</span><span>, </span><span>// 当其它拓展与 clangd 冲突时警告并建议禁用</span></div></div><div><div><div>33</div></div><div><span>"editor.suggest.snippetsPreventQuickSuggestions"</span><span>: </span><span>false</span><span>, </span><span>// clangd的snippets有很多的跳转点，不用这个就必须手动触发Intellisense了</span></div></div><div><div><div>34</div></div><div><span>// LLDB</span></div></div><div><div><div>35</div></div><div><span>"lldb.commandCompletions"</span><span>: </span><span>true</span><span>, </span><span>// LLDB 指令自动补全</span></div></div><div><div><div>36</div></div><div><span>"lldb.dereferencePointers"</span><span>: </span><span>true</span><span>, </span><span>// LLDB 指针显示解引用内容</span></div></div><div><div><div>37</div></div><div><span>"lldb.evaluateForHovers"</span><span>: </span><span>true</span><span>, </span><span>// LLDB 鼠标悬停在变量上时预览变量值</span></div></div><div><div><div>38</div></div><div><span>"lldb.launch.expressions"</span><span>: </span><span>"native"</span><span>, </span><span>// LLDB 监视表达式的默认类型</span></div></div><div><div><div>39</div></div><div><span>"lldb.showDisassembly"</span><span>: </span><span>"never"</span><span>, </span><span>// LLDB 不显示汇编代码</span></div></div><div><div><div>40</div></div><div><span>"lldb.verboseLogging"</span><span>: </span><span>true</span><span>,</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接下来，就可以创建一个空文件夹，作为自己的一个 C++ 测试项目了。</p> <h3>项目配置文件<a href="#项目配置文件">#</a></h3> <p>在项目根目录下新建 <code>.clangd</code>、<code>.clang-tidy</code> 和 <code>.clang-format</code> 三个文件，分别填入如下内容：</p> <ul> <li><code>.clangd</code> 文件： 文件中 <code>readability-identifier-naming</code> 部分请参阅<a href="https://clang.llvm.org/extra/clang-tidy/checks/readability/identifier-naming.html">官方文档</a>进行个性化修改。</li> </ul> <div><figure><figcaption><span>.clangd</span></figcaption><pre><code><div><div><div>1</div></div><div><span>Diagnostics</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>ClangTidy</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>Add</span><span>:</span><span> </span><span>[</span><span>readability-identifier*</span><span>]</span></div></div><div><div><div>4</div></div><div><span> </span><span>CheckOptions</span><span>:</span></div></div><div><div><div>5</div></div><div><span> </span><span># 变量命名规则</span></div></div><div><div><div>6</div></div><div><span> </span><span># 详细请参考官方文档 https://clang.llvm.org/extra/clang-tidy/checks/readability/identifier-naming.html</span></div></div><div><div><div>7</div></div><div><span> </span><span>readability-identifier-naming.VariableCase</span><span>:</span><span> </span><span>lower_case</span></div></div><div><div><div>8</div></div><div><span> </span><span>readability-identifier-naming.GlobalVariableCase</span><span>:</span><span> </span><span>lower_case</span></div></div><div><div><div>9</div></div><div><span> </span><span>readability-identifier-naming.GlobalVariablePrefix</span><span>:</span><span> </span><span>g_</span></div></div><div><div><div>10</div></div><div> </div></div><div><div><div>11</div></div><div><span> </span><span>readability-identifier-naming.MemberPrefix</span><span>:</span><span> </span><span>m_</span></div></div><div><div><div>12</div></div><div><span> </span><span>readability-identifier-naming.MemberCase</span><span>:</span><span> </span><span>lower_case</span></div></div><div><div><div>13</div></div><div><span> </span><span>readability-identifier-naming.ClassMemberPrefix</span><span>:</span><span> </span><span>m_</span></div></div><div><div><div>14</div></div><div><span> </span><span>readability-identifier-naming.ClassMemberCase</span><span>:</span><span> </span><span>lower_case</span></div></div><div><div><div>15</div></div><div> </div></div><div><div><div>16</div></div><div><span> </span><span>readability-identifier-naming.EnumCase</span><span>:</span><span> </span><span>UPPER_CASE</span></div></div><div><div><div>17</div></div><div><span> </span><span>readability-identifier-naming.EnumConstantCase</span><span>:</span><span> </span><span>UPPER_CASE</span></div></div><div><div><div>18</div></div><div><span> </span><span>readability-identifier-naming.MacroDefinitionCase</span><span>:</span><span> </span><span>UPPER_CASE</span></div></div><div><div><div>19</div></div><div> </div></div><div><div><div>20</div></div><div><span> </span><span>readability-identifier-naming.ClassCase</span><span>:</span><span> </span><span>CamelCase</span></div></div><div><div><div>21</div></div><div><span> </span><span>readability-identifier-naming.StructCase</span><span>:</span><span> </span><span>Camelcase</span></div></div><div><div><div>22</div></div><div> </div></div><div><div><div>23</div></div><div><span> </span><span>readability-identifier-naming.FunctionCase</span><span>:</span><span> </span><span>camelCase</span></div></div><div><div><div>24</div></div><div><span> </span><span>readability-identifier-naming.ClassMethodCase</span><span>:</span><span> </span><span>camelCase</span></div></div><div><div><div>25</div></div><div><span> </span><span>readability-identifier-naming.MethodCase</span><span>:</span><span> </span><span>camelCase</span></div></div><div><div><div>26</div></div><div> </div></div><div><div><div>27</div></div><div><span> </span><span>readability-identifier-naming.ConstantCase</span><span>:</span><span> </span><span>UPPER_CASE</span></div></div><div><div><div>28</div></div><div><span> </span><span>readability-identifier-naming.ConstantParameterCase</span><span>:</span><span> </span><span>camel_Snake_Back</span></div></div><div><div><div>29</div></div><div> </div></div><div><div><div>30</div></div><div><span>CompileFlags</span><span>:</span></div></div><div><div><div>31</div></div><div><span> </span><span>Add</span><span>:</span></div></div><div><div><div>32</div></div><div><span> </span><span>-</span><span> </span><span>'-pedantic'</span></div></div><div><div><div>33</div></div><div><span> </span><span>-</span><span> </span><span>'-Wall'</span></div></div><div><div><div>34</div></div><div><span> </span><span>-</span><span> </span><span>'-Wextra'</span></div></div><div><div><div>35</div></div><div><span> </span><span>-</span><span> </span><span>'-Wcast-align'</span></div></div><div><div><div>36</div></div><div><span> </span><span>-</span><span> </span><span>'-Wdouble-promotion'</span></div></div><div><div><div>37</div></div><div><span> </span><span>-</span><span> </span><span>'-Wformat=2'</span></div></div><div><div><div>38</div></div><div><span> </span><span>-</span><span> </span><span>'-Wimplicit-fallthrough'</span></div></div><div><div><div>39</div></div><div><span> </span><span>-</span><span> </span><span>'-Wmisleading-indentation'</span></div></div><div><div><div>40</div></div><div><span> </span><span>-</span><span> </span><span>'-Wnon-virtual-dtor'</span></div></div><div><div><div>41</div></div><div><span> </span><span>-</span><span> </span><span>'-Wnull-dereference'</span></div></div><div><div><div>42</div></div><div><span> </span><span>-</span><span> </span><span>'-Wold-style-cast'</span></div></div><div><div><div>43</div></div><div><span> </span><span>-</span><span> </span><span>'-Woverloaded-virtual'</span></div></div><div><div><div>44</div></div><div><span> </span><span>-</span><span> </span><span>'-Wpedantic'</span></div></div><div><div><div>45</div></div><div><span> </span><span>-</span><span> </span><span>'-Wshadow'</span></div></div><div><div><div>46</div></div><div><span> </span><span>-</span><span> </span><span>'-Wunused'</span></div></div><div><div><div>47</div></div><div><span> </span><span>-</span><span> </span><span>'-pthread'</span></div></div><div><div><div>48</div></div><div><span> </span><span>-</span><span> </span><span>'-fuse-ld=lld'</span></div></div><div><div><div>49</div></div><div><span> </span><span>-</span><span> </span><span>'-fsanitize=address'</span></div></div><div><div><div>50</div></div><div><span> </span><span>-</span><span> </span><span>'-fsanitize=undefined'</span></div></div><div><div><div>51</div></div><div><span> </span><span>-</span><span> </span><span>'-stdlib=libc++'</span></div></div><div><div><div>52</div></div><div><span> </span><span>-</span><span> </span><span>'-std=c++20'</span><span> </span><span># 根据实际需要填写</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <ul> <li><code>.clang-tidy</code> 文件：</li> </ul> <div><figure><figcaption><span>.clangd-tidy</span></figcaption><pre><code><div><div><div>1</div></div><div><span>---</span></div></div><div><div><div>2</div></div><div><span>Checks</span><span>:</span><span> </span><span>"bugprone-*,</span><span>\</span></div></div><div><div><div>3</div></div><div><span><span> </span></span><span>google-*,</span><span>\</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>misc-*,</span><span>\</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>modernize-*,</span><span>\</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>performance-*,</span><span>\</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>readability-*,</span><span>\</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>portability-*,</span><span>\</span></div></div><div><div><div>9</div></div><div><span><span> </span></span><span>"</span></div></div><div><div><div>10</div></div><div><span>HeaderFilterRegex</span><span>:</span><span> </span><span>'Source/cm[^/]*\.(h|hxx|cxx)$'</span></div></div><div><div><div>11</div></div><div><span>CheckOptions</span><span>:</span></div></div><div><div><div>12</div></div><div><span> </span><span>-</span><span> </span><span>key</span><span>:</span><span> </span><span>modernize-use-default-member-init.UseAssignment</span></div></div><div><div><div>13</div></div><div><span> </span><span>value</span><span>:</span><span> </span><span>'1'</span></div></div><div><div><div>14</div></div><div><span> </span><span>-</span><span> </span><span>key</span><span>:</span><span> </span><span>modernize-use-equals-default.IgnoreMacros</span></div></div><div><div><div>15</div></div><div><span> </span><span>value</span><span>:</span><span> </span><span>'0'</span></div></div><div><div><div>16</div></div><div><span> </span><span>-</span><span> </span><span>key</span><span>:</span><span> </span><span>modernize-use-auto.MinTypeNameLength</span></div></div><div><div><div>17</div></div><div><span> </span><span>value</span><span>:</span><span> </span><span>'80'</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <ul> <li><code>.clang-format</code> 文件： 可以取消 <code>BasedOnStyle</code> 项的注释，然后只保留少数自定义修改。</li> </ul> <div><figure><figcaption><span>.clang-format</span></figcaption><pre><code><div><div><div>1</div></div><div><span>---</span></div></div><div><div><div>2</div></div><div><span>## 语言: None, Cpp, Java, JavaScript, ObjC, Proto, TableGen, TextProto</span></div></div><div><div><div>3</div></div><div><span>Language</span><span>:</span><span> </span><span>Cpp</span></div></div><div><div><div>4</div></div><div><span>## 基础风格</span></div></div><div><div><div>5</div></div><div><span>## BasedOnStyle: LLVM</span></div></div><div><div><div>6</div></div><div><span>## 访问说明符(public、private等)的偏移</span></div></div><div><div><div>7</div></div><div><span>AccessModifierOffset</span><span>:</span><span> </span><span>-4</span></div></div><div><div><div>8</div></div><div><span>## 开括号(开圆括号、开尖括号、开方括号)后的对齐: Align, DontAlign, AlwaysBreak(总是在开括号后换行)</span></div></div><div><div><div>9</div></div><div><span>AlignAfterOpenBracket</span><span>:</span><span> </span><span>Align</span></div></div><div><div><div>10</div></div><div><span>## 对齐数组列</span></div></div><div><div><div>11</div></div><div><span>AlignArrayOfStructures</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>12</div></div><div><span>## 对齐连续宏定义</span></div></div><div><div><div>13</div></div><div><span>AlignConsecutiveMacros</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>14</div></div><div><span>## 连续赋值时，对齐所有等号</span></div></div><div><div><div>15</div></div><div><span>AlignConsecutiveAssignments</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>16</div></div><div><span>## 对齐连续位字段</span></div></div><div><div><div>17</div></div><div><span>AlignConsecutiveBitFields</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>18</div></div><div><span>## 连续声明时，对齐所有声明的变量名</span></div></div><div><div><div>19</div></div><div><span>AlignConsecutiveDeclarations</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>20</div></div><div><span>## 左对齐逃脱换行(使用反斜杠换行)的反斜杠</span></div></div><div><div><div>21</div></div><div><span>AlignEscapedNewlines</span><span>:</span><span> </span><span>Left</span></div></div><div><div><div>22</div></div><div><span>## 水平对齐二元和三元表达式的操作数</span></div></div><div><div><div>23</div></div><div><span>AlignOperands</span><span>:</span><span> </span><span>Align</span></div></div><div><div><div>24</div></div><div><span>## 对齐连续的尾随的注释</span></div></div><div><div><div>25</div></div><div><span>AlignTrailingComments</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>26</div></div><div><span>## 允许函数声明的所有参数在放在下一行</span></div></div><div><div><div>27</div></div><div><span>AllowAllParametersOfDeclarationOnNextLine</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>28</div></div><div><span>## 允许短的枚举放在同一行</span></div></div><div><div><div>29</div></div><div><span>AllowShortEnumsOnASingleLine</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>30</div></div><div><span>## 允许短的块放在同一行</span></div></div><div><div><div>31</div></div><div><span>AllowShortBlocksOnASingleLine</span><span>:</span><span> </span><span>Never</span></div></div><div><div><div>32</div></div><div><span>## 允许短的case标签放在同一行</span></div></div><div><div><div>33</div></div><div><span>AllowShortCaseLabelsOnASingleLine</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>34</div></div><div><span>## 允许短的函数放在同一行</span></div></div><div><div><div>35</div></div><div><span>AllowShortFunctionsOnASingleLine</span><span>:</span><span> </span><span>All</span></div></div><div><div><div>36</div></div><div><span>## 允许短的匿名函数放在同一行</span></div></div><div><div><div>37</div></div><div><span>AllowShortLambdasOnASingleLine</span><span>:</span><span> </span><span>All</span></div></div><div><div><div>38</div></div><div><span>## 允许短的if语句保持在同一行</span></div></div><div><div><div>39</div></div><div><span>AllowShortIfStatementsOnASingleLine</span><span>:</span><span> </span><span>Never</span></div></div><div><div><div>40</div></div><div><span>## 允许短的循环保持在同一行</span></div></div><div><div><div>41</div></div><div><span>AllowShortLoopsOnASingleLine</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>42</div></div><div><span>## 总是在返回类型后换行</span></div></div><div><div><div>43</div></div><div><span>AlwaysBreakAfterReturnType</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>44</div></div><div><span>## 总是在多行string字面量前换行</span></div></div><div><div><div>45</div></div><div><span>AlwaysBreakBeforeMultilineStrings</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>46</div></div><div><span>## 总是在template声明后换行</span></div></div><div><div><div>47</div></div><div><span>AlwaysBreakTemplateDeclarations</span><span>:</span><span> </span><span>MultiLine</span></div></div><div><div><div>48</div></div><div><span>AttributeMacros</span><span>:</span></div></div><div><div><div>49</div></div><div><span> </span><span>-</span><span> </span><span>__capability</span></div></div><div><div><div>50</div></div><div><span>## false表示函数实参要么都在同一行，要么都各自一行</span></div></div><div><div><div>51</div></div><div><span>BinPackArguments</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>52</div></div><div><span>## false表示所有形参要么都在同一行，要么都各自一行</span></div></div><div><div><div>53</div></div><div><span>BinPackParameters</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>54</div></div><div><span>## 大括号换行，只有当BreakBeforeBraces设置为Custom时才有效</span></div></div><div><div><div>55</div></div><div><span>BraceWrapping</span><span>:</span></div></div><div><div><div>56</div></div><div><span> </span><span>AfterCaseLabel</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>57</div></div><div><span> </span><span>AfterClass</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>58</div></div><div><span> </span><span>AfterControlStatement</span><span>:</span><span> </span><span>Never</span></div></div><div><div><div>59</div></div><div><span> </span><span>AfterEnum</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>60</div></div><div><span> </span><span>AfterFunction</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>61</div></div><div><span> </span><span>AfterNamespace</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>62</div></div><div><span> </span><span>AfterObjCDeclaration</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>63</div></div><div><span> </span><span>AfterStruct</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>64</div></div><div><span> </span><span>AfterUnion</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>65</div></div><div><span> </span><span>AfterExternBlock</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>66</div></div><div><span> </span><span>BeforeCatch</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>67</div></div><div><span> </span><span>BeforeElse</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>68</div></div><div><span> </span><span>BeforeLambdaBody</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>69</div></div><div><span> </span><span>BeforeWhile</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>70</div></div><div><span> </span><span>IndentBraces</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>71</div></div><div><span> </span><span>SplitEmptyFunction</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>72</div></div><div><span> </span><span>SplitEmptyRecord</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>73</div></div><div><span> </span><span>SplitEmptyNamespace</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>74</div></div><div><span>## 在二元运算符前换行</span></div></div><div><div><div>75</div></div><div><span>BreakBeforeBinaryOperators</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>76</div></div><div><span>## 在concept前换行</span></div></div><div><div><div>77</div></div><div><span>BreakBeforeConceptDeclarations</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>78</div></div><div><span>## 在大括号前换行: Attach(始终将大括号附加到周围的上下文)</span></div></div><div><div><div>79</div></div><div><span>BreakBeforeBraces</span><span>:</span><span> </span><span>Attach</span></div></div><div><div><div>80</div></div><div><span>## 继承列表样式</span></div></div><div><div><div>81</div></div><div><span>BreakInheritanceList</span><span>:</span><span> </span><span>AfterComma</span></div></div><div><div><div>82</div></div><div><span>## 在三元运算符前换行</span></div></div><div><div><div>83</div></div><div><span>BreakBeforeTernaryOperators</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>84</div></div><div><span>## 构造函数初始值设定项换行样式</span></div></div><div><div><div>85</div></div><div><span>BreakConstructorInitializers</span><span>:</span><span> </span><span>BeforeComma</span></div></div><div><div><div>86</div></div><div><span>## 在java字段的注释后换行</span></div></div><div><div><div>87</div></div><div><span>BreakAfterJavaFieldAnnotations</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>88</div></div><div><span>## 每行字符的限制，0表示没有限制</span></div></div><div><div><div>89</div></div><div><span>ColumnLimit</span><span>:</span><span> </span><span>96</span></div></div><div><div><div>90</div></div><div><span>## 描述具有特殊意义的注释的正则表达式，它不应该被分割为多行或以其它方式改变</span></div></div><div><div><div>91</div></div><div><span>CommentPragmas</span><span>:</span><span> </span><span>'^ IWYU pragma:'</span></div></div><div><div><div>92</div></div><div><span>## 在新行上声明每个命名空间</span></div></div><div><div><div>93</div></div><div><span>CompactNamespaces</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>94</div></div><div><span>## 构造函数的初始化列表的缩进宽度</span></div></div><div><div><div>95</div></div><div><span>ConstructorInitializerIndentWidth</span><span>:</span><span> </span><span>4</span></div></div><div><div><div>96</div></div><div><span>## 延续的行的缩进宽度</span></div></div><div><div><div>97</div></div><div><span>ContinuationIndentWidth</span><span>:</span><span> </span><span>4</span></div></div><div><div><div>98</div></div><div><span>## 去除C++11的列表初始化的大括号{后和}前的空格</span></div></div><div><div><div>99</div></div><div><span>Cpp11BracedListStyle</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>100</div></div><div><span>## 继承最常用的换行方式</span></div></div><div><div><div>101</div></div><div><span>DeriveLineEnding</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>102</div></div><div><span>## 继承最常用的指针和引用的对齐方式</span></div></div><div><div><div>103</div></div><div><span>DerivePointerAlignment</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>104</div></div><div><span>## 关闭格式化</span></div></div><div><div><div>105</div></div><div><span>DisableFormat</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>106</div></div><div><span>## 删除访问修饰符后的所有空行</span></div></div><div><div><div>107</div></div><div><span>EmptyLineAfterAccessModifier</span><span>:</span><span> </span><span>Never</span></div></div><div><div><div>108</div></div><div><span>## 仅当访问修饰符开始一个新的逻辑块时才添加空行</span></div></div><div><div><div>109</div></div><div><span>EmptyLineBeforeAccessModifier</span><span>:</span><span> </span><span>LogicalBlock</span></div></div><div><div><div>110</div></div><div><span>## 自动检测函数的调用和定义是否被格式为每行一个参数(Experimental)</span></div></div><div><div><div>111</div></div><div><span>ExperimentalAutoDetectBinPacking</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>112</div></div><div><span>## 自动补充namespace注释</span></div></div><div><div><div>113</div></div><div><span>FixNamespaceComments</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>114</div></div><div><span>## 需要被解读为foreach循环而不是函数调用的宏</span></div></div><div><div><div>115</div></div><div><span>ForEachMacros</span><span>:</span></div></div><div><div><div>116</div></div><div><span> </span><span>-</span><span> </span><span>foreach</span></div></div><div><div><div>117</div></div><div><span> </span><span>-</span><span> </span><span>Q_FOREACH</span></div></div><div><div><div>118</div></div><div><span> </span><span>-</span><span> </span><span>BOOST_FOREACH</span></div></div><div><div><div>119</div></div><div><span>IfMacros</span><span>:</span></div></div><div><div><div>120</div></div><div><span> </span><span>-</span><span> </span><span>KJ_IF_MAYBE</span></div></div><div><div><div>121</div></div><div><span>## 多个#include块合并在一起并排序为一个</span></div></div><div><div><div>122</div></div><div><span>IncludeBlocks</span><span>:</span><span> </span><span>Merge</span></div></div><div><div><div>123</div></div><div><span>## 可以定义负数优先级从而保证某些#include永远在最前面</span></div></div><div><div><div>124</div></div><div><span>IncludeCategories</span><span>:</span></div></div><div><div><div>125</div></div><div><span> </span><span>-</span><span> </span><span>Regex</span><span>:</span><span> </span><span>'^"(llvm|llvm-c|clang|clang-c)/'</span></div></div><div><div><div>126</div></div><div><span> </span><span>Priority</span><span>:</span><span> </span><span>2</span></div></div><div><div><div>127</div></div><div><span> </span><span>SortPriority</span><span>:</span><span> </span><span>0</span></div></div><div><div><div>128</div></div><div><span> </span><span>CaseSensitive</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>129</div></div><div><span> </span><span>-</span><span> </span><span>Regex</span><span>:</span><span> </span><span>'^(&lt;|"(gtest|gmock|isl|json)/)'</span></div></div><div><div><div>130</div></div><div><span> </span><span>Priority</span><span>:</span><span> </span><span>3</span></div></div><div><div><div>131</div></div><div><span> </span><span>SortPriority</span><span>:</span><span> </span><span>0</span></div></div><div><div><div>132</div></div><div><span> </span><span>CaseSensitive</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>133</div></div><div><span> </span><span>-</span><span> </span><span>Regex</span><span>:</span><span> </span><span>'.*'</span></div></div><div><div><div>134</div></div><div><span> </span><span>Priority</span><span>:</span><span> </span><span>1</span></div></div><div><div><div>135</div></div><div><span> </span><span>SortPriority</span><span>:</span><span> </span><span>0</span></div></div><div><div><div>136</div></div><div><span> </span><span>CaseSensitive</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>137</div></div><div><span>IncludeIsMainRegex</span><span>:</span><span> </span><span>'(Test)?$'</span></div></div><div><div><div>138</div></div><div><span>IncludeIsMainSourceRegex</span><span>:</span><span> </span><span>''</span></div></div><div><div><div>139</div></div><div><span>## 缩进访问修饰符</span></div></div><div><div><div>140</div></div><div><span>IndentAccessModifiers</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>141</div></div><div><span>## 缩进case标签</span></div></div><div><div><div>142</div></div><div><span>IndentCaseLabels</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>143</div></div><div><span>## case 标签后面的块使用与 case 标签相同的缩进级别</span></div></div><div><div><div>144</div></div><div><span>IndentCaseBlocks</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>145</div></div><div><span>## 缩进goto标签。</span></div></div><div><div><div>146</div></div><div><span>IndentGotoLabels</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>147</div></div><div><span>## 缩进预处理器指令</span></div></div><div><div><div>148</div></div><div><span>IndentPPDirectives</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>149</div></div><div><span>## 向后兼容缩进外部块</span></div></div><div><div><div>150</div></div><div><span>IndentExternBlock</span><span>:</span><span> </span><span>AfterExternBlock</span></div></div><div><div><div>151</div></div><div><span>## 缩进模板中的requires子句</span></div></div><div><div><div>152</div></div><div><span>IndentRequires</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>153</div></div><div><span>## 缩进宽度</span></div></div><div><div><div>154</div></div><div><span>IndentWidth</span><span>:</span><span> </span><span>4</span></div></div><div><div><div>155</div></div><div><span>## 函数返回类型换行时，缩进函数声明或函数定义的函数名</span></div></div><div><div><div>156</div></div><div><span>IndentWrappedFunctionNames</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>157</div></div><div><span>## 插入尾随逗号</span></div></div><div><div><div>158</div></div><div><span>InsertTrailingCommas</span><span>:</span><span> </span><span>None</span></div></div><div><div><div>159</div></div><div><span>## 保留JavaScript字符串引号</span></div></div><div><div><div>160</div></div><div><span>JavaScriptQuotes</span><span>:</span><span> </span><span>Leave</span></div></div><div><div><div>161</div></div><div><span>## 包装 JavaScript 导入/导出语句</span></div></div><div><div><div>162</div></div><div><span>JavaScriptWrapImports</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>163</div></div><div><span>## 保留在块开始处的空行</span></div></div><div><div><div>164</div></div><div><span>KeepEmptyLinesAtTheStartOfBlocks</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>165</div></div><div><span>## 相对于 lambda 签名对齐 lambda 主体</span></div></div><div><div><div>166</div></div><div><span>LambdaBodyIndentation</span><span>:</span><span> </span><span>Signature</span></div></div><div><div><div>167</div></div><div><span>## 开始一个块的宏的正则表达式</span></div></div><div><div><div>168</div></div><div><span>MacroBlockBegin</span><span>:</span><span> </span><span>''</span></div></div><div><div><div>169</div></div><div><span>## 结束一个块的宏的正则表达式</span></div></div><div><div><div>170</div></div><div><span>MacroBlockEnd</span><span>:</span><span> </span><span>''</span></div></div><div><div><div>171</div></div><div><span>## 连续空行的最大数量</span></div></div><div><div><div>172</div></div><div><span>MaxEmptyLinesToKeep</span><span>:</span><span> </span><span>1</span></div></div><div><div><div>173</div></div><div><span>## 命名空间的缩进</span></div></div><div><div><div>174</div></div><div><span>NamespaceIndentation</span><span>:</span><span> </span><span>Inner</span></div></div><div><div><div>175</div></div><div><span>ObjCBinPackProtocolList</span><span>:</span><span> </span><span>Auto</span></div></div><div><div><div>176</div></div><div><span>## 使用ObjC块时缩进宽度</span></div></div><div><div><div>177</div></div><div><span>ObjCBlockIndentWidth</span><span>:</span><span> </span><span>4</span></div></div><div><div><div>178</div></div><div><span>ObjCBreakBeforeNestedBlockParam</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>179</div></div><div><span>## 在ObjC的@property后添加一个空格</span></div></div><div><div><div>180</div></div><div><span>ObjCSpaceAfterProperty</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>181</div></div><div><span>## 在ObjC的protocol列表前添加一个空格</span></div></div><div><div><div>182</div></div><div><span>ObjCSpaceBeforeProtocolList</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>183</div></div><div><span>PenaltyBreakAssignment</span><span>:</span><span> </span><span>2</span></div></div><div><div><div>184</div></div><div><span>PenaltyBreakBeforeFirstCallParameter</span><span>:</span><span> </span><span>19</span></div></div><div><div><div>185</div></div><div><span>PenaltyBreakComment</span><span>:</span><span> </span><span>300</span></div></div><div><div><div>186</div></div><div><span>PenaltyBreakFirstLessLess</span><span>:</span><span> </span><span>120</span></div></div><div><div><div>187</div></div><div><span>PenaltyBreakString</span><span>:</span><span> </span><span>1000</span></div></div><div><div><div>188</div></div><div><span>PenaltyBreakTemplateDeclaration</span><span>:</span><span> </span><span>10</span></div></div><div><div><div>189</div></div><div><span>PenaltyExcessCharacter</span><span>:</span><span> </span><span>1000000</span></div></div><div><div><div>190</div></div><div><span>PenaltyReturnTypeOnItsOwnLine</span><span>:</span><span> </span><span>60</span></div></div><div><div><div>191</div></div><div><span>PenaltyIndentedWhitespace</span><span>:</span><span> </span><span>0</span></div></div><div><div><div>192</div></div><div><span>## 指针的对齐: Left, Right, Middle</span></div></div><div><div><div>193</div></div><div><span>PointerAlignment</span><span>:</span><span> </span><span>Left</span></div></div><div><div><div>194</div></div><div><span>## 缩进预处理器语句的列数</span></div></div><div><div><div>195</div></div><div><span>PPIndentWidth</span><span>:</span><span> </span><span>-1</span></div></div><div><div><div>196</div></div><div><span>## 引用的对齐</span></div></div><div><div><div>197</div></div><div><span>ReferenceAlignment</span><span>:</span><span> </span><span>Pointer</span></div></div><div><div><div>198</div></div><div><span>## 允许重新排版注释</span></div></div><div><div><div>199</div></div><div><span>ReflowComments</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>200</div></div><div><span>## 短命名空间跨越的最大展开行数</span></div></div><div><div><div>201</div></div><div><span>ShortNamespaceLines</span><span>:</span><span> </span><span>1</span></div></div><div><div><div>202</div></div><div><span>## 允许排序#include</span></div></div><div><div><div>203</div></div><div><span>SortIncludes</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>204</div></div><div><span>## java静态导入放在非静态导入之前</span></div></div><div><div><div>205</div></div><div><span>SortJavaStaticImport</span><span>:</span><span> </span><span>Before</span></div></div><div><div><div>206</div></div><div><span>## 对using声明排序</span></div></div><div><div><div>207</div></div><div><span>SortUsingDeclarations</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>208</div></div><div><span>## 在C风格类型转换后添加空格</span></div></div><div><div><div>209</div></div><div><span>SpaceAfterCStyleCast</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>210</div></div><div><span>## 在!后添加空格</span></div></div><div><div><div>211</div></div><div><span>SpaceAfterLogicalNot</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>212</div></div><div><span>## 在Template关键字后添加空格</span></div></div><div><div><div>213</div></div><div><span>SpaceAfterTemplateKeyword</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>214</div></div><div><span>## 在赋值运算符之前添加空格</span></div></div><div><div><div>215</div></div><div><span>SpaceBeforeAssignmentOperators</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>216</div></div><div><span>## 不在case冒号之前添加空格</span></div></div><div><div><div>217</div></div><div><span>SpaceBeforeCaseColon</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>218</div></div><div><span>## 不在C++11大括号列表之前添加空格</span></div></div><div><div><div>219</div></div><div><span>SpaceBeforeCpp11BracedList</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>220</div></div><div><span>## 在构造函数初始化器冒号之前添加空格</span></div></div><div><div><div>221</div></div><div><span>SpaceBeforeCtorInitializerColon</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>222</div></div><div><span>## 在继承冒号前添加空格</span></div></div><div><div><div>223</div></div><div><span>SpaceBeforeInheritanceColon</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>224</div></div><div><span>## 开圆括号之前添加一个空格: Never, ControlStatements, Always</span></div></div><div><div><div>225</div></div><div><span>SpaceBeforeParens</span><span>:</span><span> </span><span>ControlStatements</span></div></div><div><div><div>226</div></div><div><span>## 不要确保指针限定符周围有空格，而是使用 PointerAlignment</span></div></div><div><div><div>227</div></div><div><span>SpaceAroundPointerQualifiers</span><span>:</span><span> </span><span>Default</span></div></div><div><div><div>228</div></div><div><span>## 在基于范围的for循环冒号之前添加空格</span></div></div><div><div><div>229</div></div><div><span>SpaceBeforeRangeBasedForLoopColon</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>230</div></div><div><span>## {}中间不添加空格</span></div></div><div><div><div>231</div></div><div><span>SpaceInEmptyBlock</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>232</div></div><div><span>## 在空的圆括号中添加空格</span></div></div><div><div><div>233</div></div><div><span>SpaceInEmptyParentheses</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>234</div></div><div><span>## 在尾随的评论前添加的空格数(只适用于//)</span></div></div><div><div><div>235</div></div><div><span>SpacesBeforeTrailingComments</span><span>:</span><span> </span><span>1</span></div></div><div><div><div>236</div></div><div><span>## 在尖括号的&lt;后和&gt;前添加空格</span></div></div><div><div><div>237</div></div><div><span>SpacesInAngles</span><span>:</span><span> </span><span>Never</span></div></div><div><div><div>238</div></div><div><span>## 不在if/for/switch/while条件周围插入空格</span></div></div><div><div><div>239</div></div><div><span>SpacesInConditionalStatement</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>240</div></div><div><span>## 在容器(ObjC和JavaScript的数组和字典等)字面量中添加空格</span></div></div><div><div><div>241</div></div><div><span>SpacesInContainerLiterals</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>242</div></div><div><span>## 在C风格类型转换的括号中添加空格</span></div></div><div><div><div>243</div></div><div><span>SpacesInCStyleCastParentheses</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>244</div></div><div><span>## 行注释开头允许有多少个空格。要禁用最大值，请将其设置为-1，除此之外，最大值优先于最小值</span></div></div><div><div><div>245</div></div><div><span>SpacesInLineCommentPrefix</span><span>:</span></div></div><div><div><div>246</div></div><div><span> </span><span>Minimum</span><span>:</span><span> </span><span>1</span></div></div><div><div><div>247</div></div><div><span> </span><span>Maximum</span><span>:</span><span> </span><span>-1</span></div></div><div><div><div>248</div></div><div><span>## 在圆括号的(后和)前添加空格</span></div></div><div><div><div>249</div></div><div><span>SpacesInParentheses</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>250</div></div><div><span>## 在方括号的[后和]前添加空格，lamda表达式和未指明大小的数组的声明不受影响</span></div></div><div><div><div>251</div></div><div><span>SpacesInSquareBrackets</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>252</div></div><div><span>## 不在[前添加空格</span></div></div><div><div><div>253</div></div><div><span>SpaceBeforeSquareBrackets</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>254</div></div><div><span>## 位域:每边都添加空格</span></div></div><div><div><div>255</div></div><div><span>BitFieldColonSpacing</span><span>:</span><span> </span><span>Both</span></div></div><div><div><div>256</div></div><div><span>## 标准</span></div></div><div><div><div>257</div></div><div><span>Standard</span><span>:</span><span> </span><span>Auto</span></div></div><div><div><div>258</div></div><div><span>## 在语句前面被忽略的宏定义，就好像它们是一个属性一样</span></div></div><div><div><div>259</div></div><div><span>StatementAttributeLikeMacros</span><span>:</span></div></div><div><div><div>260</div></div><div><span> </span><span>-</span><span> </span><span>Q_EMIT</span></div></div><div><div><div>261</div></div><div><span>## 应该被解释为完整语句的宏定义</span></div></div><div><div><div>262</div></div><div><span>StatementMacros</span><span>:</span></div></div><div><div><div>263</div></div><div><span> </span><span>-</span><span> </span><span>Q_UNUSED</span></div></div><div><div><div>264</div></div><div><span> </span><span>-</span><span> </span><span>QT_REQUIRE_VERSION</span></div></div><div><div><div>265</div></div><div><span>## tab宽度</span></div></div><div><div><div>266</div></div><div><span>TabWidth</span><span>:</span><span> </span><span>4</span></div></div><div><div><div>267</div></div><div><span>## 使用\n换行</span></div></div><div><div><div>268</div></div><div><span>UseCRLF</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>269</div></div><div><span>## 使用tab字符：ForIndentation——仅将制表符用于缩进</span></div></div><div><div><div>270</div></div><div><span>UseTab</span><span>:</span><span> </span><span>Never</span></div></div><div><div><div>271</div></div><div><span>## 对空格敏感的宏定义</span></div></div><div><div><div>272</div></div><div><span>WhitespaceSensitiveMacros</span><span>:</span></div></div><div><div><div>273</div></div><div><span> </span><span>-</span><span> </span><span>STRINGIZE</span></div></div><div><div><div>274</div></div><div><span> </span><span>-</span><span> </span><span>PP_STRINGIZE</span></div></div><div><div><div>275</div></div><div><span> </span><span>-</span><span> </span><span>BOOST_PP_STRINGIZE</span></div></div><div><div><div>276</div></div><div><span> </span><span>-</span><span> </span><span>NS_SWIFT_NAME</span></div></div><div><div><div>277</div></div><div><span> </span><span>-</span><span> </span><span>CF_SWIFT_NAME</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h3>Xmake 配置<a href="#xmake-配置">#</a></h3> <p>首先新建一个 <code>hello_world.cpp</code> 文件，然后在其中输入一个基础的 Hello world 程序：</p> <div><figure><figcaption><span>hello_world.cpp</span></figcaption><pre><code><div><div><div>1</div></div><div><span>#include</span><span> </span><span>&lt;iostream&gt;</span></div></div><div><div><div>2</div></div><div> </div></div><div><div><div>3</div></div><div><span>int</span><span> </span><span>main</span><span>()</span><span> </span><span>{</span></div></div><div><div><div>4</div></div><div><span> </span><span>std</span><span>::</span><span>cout </span><span>&lt;&lt;</span><span> </span><span>"Hello, world!"</span><span> </span><span>&lt;&lt;</span><span> </span><span>std</span><span>::</span><span>endl</span><span>;</span></div></div><div><div><div>5</div></div><div><span> </span><span>return</span><span> </span><span>0</span><span>;</span></div></div><div><div><div>6</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>然后在项目根目录下新建 <code>xmake.lua</code> 文件，这会激活 Xmake 扩展。在文件中输入：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>-- xmake.lua</span></div></div><div><div><div>2</div></div><div><span>add_defines</span><span>(</span><span>"ROOT"</span><span>)</span></div></div><div><div><div>3</div></div><div><span>add_rules</span><span>(</span><span>"mode.debug"</span><span>, </span><span>"mode.release"</span><span>)</span></div></div><div><div><div>4</div></div><div><span>set_toolchains</span><span>(</span><span>"clang"</span><span>)</span></div></div><div><div><div>5</div></div><div><span>set_languages</span><span>(</span><span>"cxx17"</span><span>,</span><span>"c11"</span><span>)</span></div></div><div><div><div>6</div></div><div><span>set_optimize</span><span>(</span><span>"fastest"</span><span>)</span></div></div><div><div><div>7</div></div><div><span>set_warnings</span><span>(</span><span>"all"</span><span>)</span></div></div><div><div><div>8</div></div><div> </div></div><div><div><div>9</div></div><div><span>-- 添加工程</span></div></div><div><div><div>10</div></div><div><span>target</span><span>(</span><span>"Hello world!"</span><span>)</span></div></div><div><div><div>11</div></div><div><span> </span><span>set_kind</span><span>(</span><span>"binary"</span><span>)</span></div></div><div><div><div>12</div></div><div><span> </span><span>add_files</span><span>(</span><span>"hello_world.cpp"</span><span>)</span></div></div><div><div><div>13</div></div><div><span>target_end</span><span>()</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>此时 VSCode 的底栏会出现 Xmake 的一系列选项，直接点击下方的 ▶️ 按钮，Xmake 就会调用 Clang 编译刚刚新建的 hello world 程序了。</p> <p>至此，一个优雅好用的 C++ 开发环境就算搭建完成了。更多相关配置请参考 <a href="https://xmake.io/#/zh-cn/about/introduction">Xmake 文档</a>。</p> <h2>参考资料<a href="#参考资料">#</a></h2> <p>本文的编写参考了下列文章：</p> <ul> <li><a href="https://zhuanlan.zhihu.com/p/398790625">[万字长文]Visual Studio Code 配置 C/C++ 开发环境的最佳实践(VSCode + Clangd + XMake) - 知乎</a></li> <li><a href="https://zhuanlan.zhihu.com/p/566365173">几乎无痛的VSCode+clangd+lldb+cmake配置C/C++开发环境指南 - 知乎</a></li> <li><a href="https://quadnucyard.github.io/posts/cpp/clang-std-modules.html">使用 VSCode + XMake + LLVM 开发现代 C++！（llvm-mingw + clangd + modules）</a></li> <li><a href="https://lazy-phosphorus.com/post/msys2-cmake-guide/">MSYS2 与 CMake 编程综合指引 | 惰性磷的博客</a></li> </ul> </article> https://blog.hpcesia.com/posts/how-to-use-hoyolab-emotions-in-twikoo/https://blog.hpcesia.com/posts/how-to-use-hoyolab-emotions-in-twikoo/利用 Pythopn 脚本实现自动化获取米游社表情包并添加到本地 Twikoo 表情包 json 中。Mon, 30 Sep 2024 07:54:16 GMT<article> <h2>Twikoo 评论系统表情包设置<a href="#twikoo-评论系统表情包设置">#</a></h2> <p>打开 Twikoo 设置面板，打开「配置管理」 - 「插件」 - 「EMOTION_CDN」，输入你自己的 emotion.json 路径即可。</p> <h2>Python 脚本<a href="#python-脚本">#</a></h2> <p>找个地方创建一个 <code>.py</code> 文件，填入以下内容（为了开箱即用，使用的是 <code>urllib</code> 库，可自行换成 <code>request</code> 库或 <code>httpx</code> 库）：</p> <div><figure><figcaption><span>path/to/your/file.py</span></figcaption><pre><code><div><div><div>1</div></div><div><span>import</span><span> json</span></div></div><div><div><div>2</div></div><div><span>import</span><span> urllib</span><span>.</span><span>request</span></div></div><div><div><div>3</div></div><div><span>from</span><span> pathlib </span><span>import</span><span> Path</span></div></div><div><div><div>4</div></div><div><span>import</span><span> re</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div> </div></div><div><div><div>7</div></div><div><span>def</span><span> </span><span>miyousheEmoticonsJsonToTwikooJson</span><span>(</span></div></div><div><div><div>8</div></div><div><span> </span><span>api_url</span><span>:</span><span> </span><span>str</span><span>,</span></div></div><div><div><div>9</div></div><div><span> </span><span>output_path</span><span>:</span><span> </span><span>str</span><span>,</span></div></div><div><div><div>10</div></div><div><span> </span><span>groups</span><span>:</span><span> </span><span>list</span><span>[</span><span>str</span><span>]</span><span> </span><span>=</span><span> </span><span>None</span><span>,</span></div></div><div><div><div>11</div></div><div><span> </span><span>use_index_img</span><span>:</span><span> </span><span>bool</span><span> </span><span>=</span><span> </span><span>False</span><span>,</span></div></div><div><div><div>12</div></div><div><span> </span><span>clean_output</span><span>:</span><span> </span><span>bool</span><span> </span><span>=</span><span> </span><span>False</span><span>,</span></div></div><div><div><div>13</div></div><div><span>):</span></div></div><div><div><div>14</div></div><div><span> </span><span>"""</span></div></div><div><div><div>15</div></div><div><span><span> </span></span><span>将米游社表情包的JSON数据转换为Twikoo格式的JSON数据。</span></div></div><div><div><div>16</div></div><div> </div></div><div><div><div>17</div></div><div><span><span> </span></span><span>该函数从指定的API URL获取米游社表情包数据，并将其转换为Twikoo格式的JSON文件。</span></div></div><div><div><div>18</div></div><div><span><span> </span></span><span>可以选择性地指定要处理的表情包分组，是否使用索引图片，以及是否清理输出文件。</span></div></div><div><div><div>19</div></div><div><span><span> </span></span><span>Args:</span></div></div><div><div><div>20</div></div><div><span><span> </span></span><span>api_url (str): 米游社表情包 API 的 URL。</span></div></div><div><div><div>21</div></div><div><span><span> </span></span><span>output_path (str): 输出 JSON 文件的路径。</span></div></div><div><div><div>22</div></div><div><span><span> </span></span><span>groups (list[str], optional): 要处理的表情包分组列表。如果为 `None`，则处理所有分组。默认为 `None`。</span></div></div><div><div><div>23</div></div><div><span><span> </span></span><span>use_index_img (bool, optional): 是否使用索引图片作为分组名称。默认为 `False`。</span></div></div><div><div><div>24</div></div><div><span><span> </span></span><span>clean_output (bool, optional): 是否清理输出文件。如果为 `True`，则覆盖输出文件。默认为 `False`。</span></div></div><div><div><div>25</div></div><div><span><span> </span></span><span>"""</span></div></div><div><div><div>26</div></div><div><span><span> </span></span><span>data </span><span>=</span><span> urllib</span><span>.</span><span>request</span><span>.</span><span>urlopen</span><span>(</span><span>api_url</span><span>).</span><span>read</span><span>().</span><span>decode</span><span>(</span><span>"utf-8"</span><span>)</span></div></div><div><div><div>27</div></div><div><span><span> </span></span><span>data </span><span>=</span><span> json</span><span>.</span><span>loads</span><span>(</span><span>data</span><span>)</span></div></div><div><div><div>28</div></div><div><span><span> </span></span><span>output_dict </span><span>=</span><span> </span><span>{}</span></div></div><div><div><div>29</div></div><div><span> </span><span>if</span><span> </span><span>Path</span><span>(</span><span>output_path</span><span>).</span><span>exists</span><span>()</span><span> </span><span>and</span><span> </span><span>not</span><span> clean_output</span><span>:</span></div></div><div><div><div>30</div></div><div><span> </span><span>with</span><span> </span><span>open</span><span>(</span><span>Path</span><span>(</span><span>output_path</span><span>),</span><span> </span><span>"r"</span><span>,</span><span> </span><span>encoding</span><span>=</span><span>"utf-8"</span><span>)</span><span> </span><span>as</span><span> f</span><span>:</span></div></div><div><div><div>31</div></div><div><span><span> </span></span><span>output_dict </span><span>=</span><span> json</span><span>.</span><span>load</span><span>(</span><span>f</span><span>)</span></div></div><div><div><div>32</div></div><div><span> </span><span>if</span><span> use_index_img</span><span>:</span></div></div><div><div><div>33</div></div><div><span><span> </span></span><span>STYLE </span><span>=</span><span> </span><span>"height: 20px;top: 4px;position: relative;"</span></div></div><div><div><div>34</div></div><div><span><span> </span></span><span>pattern </span><span>=</span><span> </span><span>r</span><span>"</span><span>&lt;img src='.</span><span>*?</span><span>' style='.</span><span>*?</span><span>' title='</span><span>(</span><span>.</span><span>*?</span><span>)</span><span>'&gt;</span><span>"</span></div></div><div><div><div>35</div></div><div> </div></div><div><div><div>36</div></div><div><span> </span><span>def</span><span> </span><span>sameTitle</span><span>(</span><span>key</span><span>,</span><span> </span><span>title</span><span>):</span></div></div><div><div><div>37</div></div><div><span><span> </span></span><span>match </span><span>=</span><span> re</span><span>.</span><span>match</span><span>(</span><span>pattern</span><span>,</span><span> key</span><span>)</span></div></div><div><div><div>38</div></div><div><span> </span><span>return</span><span> </span><span>not</span><span> </span><span>bool</span><span>(</span><span>match </span><span>and</span><span> match</span><span>.</span><span>group</span><span>(</span><span>1</span><span>)</span><span> </span><span>==</span><span> title</span><span>)</span></div></div><div><div><div>39</div></div><div> </div></div><div><div><div>40</div></div><div><span> </span><span>for</span><span> emoticon_group </span><span>in</span><span> </span><span>data</span><span>[</span><span>"</span><span>data</span><span>"</span><span>][</span><span>"list"</span><span>]:</span></div></div><div><div><div>41</div></div><div><span> </span><span>if</span><span> </span><span>emoticon_group</span><span>[</span><span>"</span><span>status</span><span>"</span><span>]</span><span> </span><span>==</span><span> </span><span>"draft"</span><span>:</span></div></div><div><div><div>42</div></div><div><span> </span><span>continue</span></div></div><div><div><div>43</div></div><div><span><span> </span></span><span>group_name</span><span>:</span><span> </span><span>str</span><span> </span><span>=</span><span> </span><span>emoticon_group</span><span>[</span><span>"</span><span>name</span><span>"</span><span>]</span></div></div><div><div><div>44</div></div><div><span> </span><span>if</span><span> groups </span><span>is</span><span> </span><span>not</span><span> </span><span>None</span><span> </span><span>and</span><span> group_name </span><span>not</span><span> </span><span>in</span><span> groups</span><span>:</span></div></div><div><div><div>45</div></div><div><span> </span><span>continue</span></div></div><div><div><div>46</div></div><div><span> </span><span>if</span><span> use_index_img</span><span>:</span></div></div><div><div><div>47</div></div><div><span><span> </span></span><span>index_url </span><span>=</span><span> </span><span>emoticon_group</span><span>[</span><span>"</span><span>icon</span><span>"</span><span>]</span></div></div><div><div><div>48</div></div><div><span><span> </span></span><span>origin_group_name </span><span>=</span><span> group_name</span></div></div><div><div><div>49</div></div><div><span><span> </span></span><span>group_name </span><span>=</span><span> </span><span>f</span><span>"&lt;img src='</span><span>{</span><span>index_url</span><span>}</span><span>' style='</span><span>{</span><span>STYLE</span><span>}</span><span>' title='</span><span>{</span><span>group_name</span><span>}</span><span>'&gt;"</span></div></div><div><div><div>50</div></div><div><span><span> </span></span><span>output_dict </span><span>=</span><span> </span><span>{</span><span>k</span><span>:</span><span> v </span><span>for</span><span> k</span><span>,</span><span> v </span><span>in</span><span> output_dict</span><span>.</span><span>items</span><span>()</span><span> </span><span>if</span><span> </span><span>sameTitle</span><span>(</span><span>k</span><span>,</span><span> origin_group_name</span><span>)}</span></div></div><div><div><div>51</div></div><div><span> </span><span>output_dict</span><span>[</span><span>group_name</span><span>]</span><span> </span><span>=</span><span> </span><span>{</span><span>"type"</span><span>:</span><span> </span><span>"image"</span><span>}</span></div></div><div><div><div>52</div></div><div><span><span> </span></span><span>container </span><span>=</span><span> </span><span>[]</span></div></div><div><div><div>53</div></div><div><span> </span><span>for</span><span> emoticon </span><span>in</span><span> </span><span>emoticon_group</span><span>[</span><span>"</span><span>list</span><span>"</span><span>]:</span></div></div><div><div><div>54</div></div><div><span> </span><span>if</span><span> </span><span>emoticon</span><span>[</span><span>"</span><span>status</span><span>"</span><span>]</span><span> </span><span>==</span><span> </span><span>"draft"</span><span>:</span></div></div><div><div><div>55</div></div><div><span> </span><span>continue</span></div></div><div><div><div>56</div></div><div><span><span> </span></span><span>url </span><span>=</span><span> </span><span>emoticon</span><span>[</span><span>"</span><span>icon</span><span>"</span><span>]</span></div></div><div><div><div>57</div></div><div><span><span> </span></span><span>name </span><span>=</span><span> </span><span>emoticon</span><span>[</span><span>"</span><span>name</span><span>"</span><span>].</span><span>replace</span><span>(</span><span>" "</span><span>,</span><span> </span><span>"-"</span><span>)</span></div></div><div><div><div>58</div></div><div><span><span> </span></span><span>name </span><span>=</span><span> </span><span>(</span></div></div><div><div><div>59</div></div><div><span><span> </span></span><span>origin_group_name</span><span>.</span><span>replace</span><span>(</span><span>" "</span><span>,</span><span> </span><span>"-"</span><span>)</span><span> </span><span>+</span><span> </span><span>"-"</span><span> </span><span>+</span><span> name</span></div></div><div><div><div>60</div></div><div><span> </span><span>if</span><span> </span><span>"origin_group_name"</span><span> </span><span>in</span><span> </span><span>locals</span><span>()</span></div></div><div><div><div>61</div></div><div><span> </span><span>else</span><span> group_name</span><span>.</span><span>replace</span><span>(</span><span>" "</span><span>,</span><span> </span><span>"-"</span><span>)</span><span> </span><span>+</span><span> </span><span>"-"</span><span> </span><span>+</span><span> name</span></div></div><div><div><div>62</div></div><div><span> </span><span>)</span></div></div><div><div><div>63</div></div><div><span><span> </span></span><span>container</span><span>.</span><span>append</span><span>({</span><span>"text"</span><span>:</span><span> name</span><span>,</span><span> </span><span>"icon"</span><span>:</span><span> </span><span>f</span><span>"&lt;img src='</span><span>{</span><span>url</span><span>}</span><span>'&gt;"</span><span>})</span></div></div><div><div><div>64</div></div><div><span> </span><span>output_dict</span><span>[</span><span>group_name</span><span>][</span><span>"container"</span><span>]</span><span> </span><span>=</span><span> container</span></div></div><div><div><div>65</div></div><div><span> </span><span>with</span><span> </span><span>open</span><span>(</span><span>Path</span><span>(</span><span>output_path</span><span>),</span><span> </span><span>"w"</span><span>,</span><span> </span><span>encoding</span><span>=</span><span>"utf-8"</span><span>)</span><span> </span><span>as</span><span> f</span><span>:</span></div></div><div><div><div>66</div></div><div><span><span> </span></span><span>json</span><span>.</span><span>dump</span><span>(</span><span>output_dict</span><span>,</span><span> f</span><span>,</span><span> </span><span>ensure_ascii</span><span>=</span><span>False</span><span>,</span><span> </span><span>indent</span><span>=</span><span>2</span><span>)</span></div></div><div><div><div>67</div></div><div> </div></div><div><div><div>68</div></div><div> </div></div><div><div><div>69</div></div><div><span>## 使用示例</span></div></div><div><div><div>70</div></div><div><span>api_url </span><span>=</span><span> </span><span>"https://bbs-api.mihoyo.com/misc/api/emoticon_set"</span></div></div><div><div><div>71</div></div><div><span>output </span><span>=</span><span> </span><span>"path/to/your/output.json"</span></div></div><div><div><div>72</div></div><div><span>emoticons_list </span><span>=</span><span> </span><span>[</span><span>"原神 V官方"</span><span>,</span><span> </span><span>"崩坏RPG"</span><span>,</span><span> </span><span>"崩坏 星穹铁道"</span><span>]</span><span> </span><span># 你想要的表情包列表</span></div></div><div><div><div>73</div></div><div><span>miyousheEmoticonsJsonToTwikooJson</span><span>(</span></div></div><div><div><div>74</div></div><div><span><span> </span></span><span>api_url</span><span>,</span><span> output</span><span>,</span><span> </span><span>use_index_img</span><span>=</span><span>True</span><span>,</span><span> </span><span>groups</span><span>=</span><span>emoticons_list</span></div></div><div><div><div>75</div></div><div><span>)</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>只需要修改 <code>output</code> 为自己的表情包路径，使用</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>python</span><span> </span><span>path/to/your/file.py</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>即可。</p> <h2>自动部署<a href="#自动部署">#</a></h2> <p>修改 <code>package.json</code> 的 <code>scripts</code> 项，将 <code>build</code> 改为 <code>python path/to/your/file.py &amp;&amp; hexo generate</code>，使用 <code>npm run build</code> 即可。</p> </article> https://blog.hpcesia.com/posts/typst-experiences/https://blog.hpcesia.com/posts/typst-experiences/关于 Typst 排版的使用经验，以及使用 Pandoc 转换为 Markdown 格式的经验Fri, 27 Sep 2024 15:14:17 GMT<article> <div><div>更新日志</div><div><ul> <li>2025-07-20 <ul> <li>更新了在博客中使用 Typst 的相关建议，以及转换为 Markdown 的相关建议</li> <li>添加了 Typst 符号手写识别的网页版本链接</li> <li>修正了部分用词</li> </ul> </li> <li>2025-03-20 <ul> <li>更新「目录不同层级标题使用不同样式」到 Typst 0.13 版本</li> <li>在「结合 showybox 与 ctheorems 包制作美观定理环境」添加了提示</li> </ul> </li> <li>2025-02-28 <ul> <li>更新「在 Typst 中绘制 LaTeX 符号」</li> </ul> </li> <li>2024-10-20 <ul> <li>更新文章中部分链接</li> </ul> </li> <li>2024-10-08 <ul> <li>更新「在文本中使用美观的大括号分类」</li> </ul> </li> <li>2024-10-02 <ul> <li>更新「结合 showybox 与 ctheorems 包制作美观定理环境」</li> </ul> </li> <li>2024-10-01 <ul> <li>更新「目录不同层级标题使用不同样式」</li> </ul> </li> <li>2024-09-27 <ul> <li>发布文章。</li> </ul> </li> </ul></div></div> <blockquote> <div><span>warning</span></div> <div> <p>本文主要编写于 Typst 0.12.0 版本，部分内容未考虑新版本更新内容，可能已经过时。</p> <p>如未特别注明，本文中的代码均基于 Typst 0.12.0 版本。</p> </div> </blockquote> <h2>怎么找解决方案<a href="#怎么找解决方案">#</a></h2> <p>多翻翻别人趟过的坑：</p> <ul> <li> <p>翻文档</p> <ul> <li><a href="https://typst-doc-cn.github.io/docs/">Typst 中文文档</a>（注：该文档长期未更新，已过时。建议参考官方英文文档。）</li> <li><a href="https://typst.app/docs">Typst Documentation</a></li> </ul> </li> <li> <p>翻示例</p> <ul> <li><a href="https://typst-doc-cn.github.io/guide/FAQ.html">常见问题 | Typst 中文社区导航</a></li> <li><a href="https://typst-doc-cn.github.io/tutorial/introduction.html">The Raindrop-Blue Book (Typst中文教程)</a></li> <li><a href="https://sitandr.github.io/typst-examples-book/book/">Typst Examples Book</a></li> </ul> </li> </ul> <h2>排版经验<a href="#排版经验">#</a></h2> <h3>不同层级标题使用不同序号格式<a href="#不同层级标题使用不同序号格式">#</a></h3> <p>其实是<a href="https://typst-doc-cn.github.io/guide/FAQ/heading-formats.html">如何为每一级标题指定不同的编号格式？ - 常见问题 | Typst 中文社区导航</a>的重复造轮子，但是造轮子的时候没看到这个东西，造都造了就发出来算了。（用 Typst 非官方中文群群友的说法，在 numbly 包出来之前，人人都有自己的 numbly 轮子（笑））</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#let</span><span> </span><span>diff_numbering</span><span>(</span><span>..</span><span>schemes</span><span>)</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>(</span><span>..</span><span>nums</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>let</span><span> nums_arr </span><span>=</span><span> nums.</span><span>pos</span><span>()</span></div></div><div><div><div>4</div></div><div><span> </span><span>let</span><span> schemes_arr </span><span>=</span><span> schemes.</span><span>pos</span><span>()</span></div></div><div><div><div>5</div></div><div><span> </span><span>if</span><span> nums_arr.</span><span>len</span><span>()</span><span> </span><span>&gt;=</span><span> schemes_arr.</span><span>len</span><span>()</span><span> </span><span>{</span></div></div><div><div><div>6</div></div><div><span> </span><span>numbering</span><span>(</span><span>schemes_arr.</span><span>at</span><span>(</span><span>-</span><span>1</span><span>),</span><span> </span><span>..</span><span>nums</span><span>)</span></div></div><div><div><div>7</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>8</div></div><div><span> </span><span>numbering</span><span>(</span><span>schemes_arr.</span><span>at</span><span>(</span><span>nums_arr.</span><span>len</span><span>()</span><span> </span><span>-</span><span> </span><span>1</span><span>),</span><span> </span><span>..</span><span>nums</span><span>)</span></div></div><div><div><div>9</div></div><div><span> </span><span>}</span></div></div><div><div><div>10</div></div><div><span> </span><span>}</span></div></div><div><div><div>11</div></div><div><span>}</span></div></div><div><div><div>12</div></div><div><span>// 使用</span></div></div><div><div><div>13</div></div><div><span>#set</span><span> </span><span>heading</span><span>(</span><span>numbering</span><span>:</span><span> </span><span>diff_numbering</span><span>(</span><span>"第一章"</span><span>,</span><span> </span><span>"1.1"</span><span>,</span><span> </span><span>"1-1-1"</span><span>))</span></div></div><div><div><div>14</div></div><div><span>= </span><span>一个章节</span></div></div><div><div><div>15</div></div><div><span>== </span><span>一个小节</span></div></div><div><div><div>16</div></div><div><span>=== </span><span>一个小节的小节</span></div></div><div><div><div>17</div></div><div><span>= </span><span>第二个章节</span></div></div><div><div><div>18</div></div><div><span>== </span><span>第二个章节的小节</span></div></div><div><div><div>19</div></div><div><span>=== </span><span>第二个章节的小节的小节</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>效果： <a></a></p> <p>使用 numbly 包可以达到更好的效果：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#import</span><span> </span><span>"@preview/numbly:0.1.0"</span><span>:</span><span> numbly</span></div></div><div><div><div>2</div></div><div><span>#set</span><span> </span><span>heading</span><span>(</span><span>numbering</span><span>:</span><span> </span><span>numbly</span><span>(</span><span>"一|{1:一}章"</span><span>,</span><span> </span><span>"a{1:1}.{2:1}"</span><span>,</span><span> </span><span>"1?{1:1}-{2:1}.{3:1}"</span><span>))</span></div></div><div><div><div>3</div></div><div><span>= #</span><span>lorem</span><span>(</span><span>1</span><span>)</span></div></div><div><div><div>4</div></div><div><span>== #</span><span>lorem</span><span>(</span><span>2</span><span>)</span></div></div><div><div><div>5</div></div><div><span>=== #</span><span>lorem</span><span>(</span><span>3</span><span>)</span></div></div><div><div><div>6</div></div><div><span>== #</span><span>lorem</span><span>(</span><span>2</span><span>)</span></div></div><div><div><div>7</div></div><div><span>=== #</span><span>lorem</span><span>(</span><span>3</span><span>)</span></div></div><div><div><div>8</div></div><div><span>=== #</span><span>lorem</span><span>(</span><span>3</span><span>)</span></div></div><div><div><div>9</div></div><div><span>= #</span><span>lorem</span><span>(</span><span>1</span><span>)</span></div></div><div><div><div>10</div></div><div><span>== #</span><span>lorem</span><span>(</span><span>2</span><span>)</span></div></div><div><div><div>11</div></div><div><span>=== #</span><span>lorem</span><span>(</span><span>3</span><span>)</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>效果： <a></a></p> <h3>填空栏<a href="#填空栏">#</a></h3> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#let</span><span> </span><span>grid_blanks</span><span>(</span><span>cell</span><span>:</span><span> grid.cell</span><span>,</span><span> </span><span>blank-width</span><span>:</span><span> </span><span>2em</span><span>,</span><span> </span><span>line-width</span><span>:</span><span> </span><span>0.05em</span><span>,</span><span> </span><span>colon</span><span>:</span><span> </span><span>[</span><span>: </span><span>],</span><span> </span><span>..</span><span>args</span><span>)</span><span> </span><span>=</span><span> </span><span>grid</span><span>(</span></div></div><div><div><div>2</div></div><div><span> </span><span>..</span><span>args.</span><span>named</span><span>(),</span></div></div><div><div><div>3</div></div><div><span> </span><span>..</span><span>args.</span><span>pos</span><span>()</span><span>.</span><span>map</span><span>(</span><span>label </span><span>=&gt;</span><span> </span><span>(</span><span>cell</span><span>([</span><span>#label#colon</span><span>#</span><span>box</span><span>(</span><span>width</span><span>:</span><span> blank-width</span><span>,</span><span> </span><span>stroke</span><span>:</span><span> </span><span>(</span><span>bottom</span><span>:</span><span> line-width</span><span>))])))</span></div></div><div><div><div>4</div></div><div><span>)</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div><span>// 使用</span></div></div><div><div><div>7</div></div><div><span>#</span><span>grid_blanks</span><span>(</span></div></div><div><div><div>8</div></div><div><span> </span><span>columns</span><span>:</span><span> </span><span>(</span><span>auto</span><span>,</span><span> </span><span>auto</span><span>),</span></div></div><div><div><div>9</div></div><div><span> </span><span>align</span><span>:</span><span> right</span><span>,</span></div></div><div><div><div>10</div></div><div><span> </span><span>row-gutter</span><span>:</span><span> </span><span>1.5em</span><span>,</span></div></div><div><div><div>11</div></div><div><span> </span><span>column-gutter</span><span>:</span><span> </span><span>1em</span><span>,</span></div></div><div><div><div>12</div></div><div><span> </span><span>blank-width</span><span>:</span><span> </span><span>3cm</span><span>,</span></div></div><div><div><div>13</div></div><div><span> </span><span>"姓名"</span><span>,</span></div></div><div><div><div>14</div></div><div><span> </span><span>"班级"</span><span>,</span></div></div><div><div><div>15</div></div><div><span> </span><span>"学号"</span><span>,</span></div></div><div><div><div>16</div></div><div><span> </span><span>"学校"</span><span>,</span></div></div><div><div><div>17</div></div><div><span>)</span></div></div><div><div><div>18</div></div><div> </div></div><div><div><div>19</div></div><div><span>#</span><span>grid_blanks</span><span>(</span></div></div><div><div><div>20</div></div><div><span> </span><span>columns</span><span>:</span><span> </span><span>(</span><span>auto</span><span>,</span><span> </span><span>auto</span><span>),</span></div></div><div><div><div>21</div></div><div><span> </span><span>align</span><span>:</span><span> right</span><span>,</span></div></div><div><div><div>22</div></div><div><span> </span><span>row-gutter</span><span>:</span><span> </span><span>1.5em</span><span>,</span></div></div><div><div><div>23</div></div><div><span> </span><span>column-gutter</span><span>:</span><span> </span><span>1em</span><span>,</span></div></div><div><div><div>24</div></div><div><span> </span><span>blank-width</span><span>:</span><span> </span><span>3cm</span><span>,</span></div></div><div><div><div>25</div></div><div><span> </span><span>colon</span><span>:</span><span> </span><span>[</span><span> </span><span>$==&gt; integral_0^1 pi - 1$</span><span> </span><span>],</span></div></div><div><div><div>26</div></div><div><span> </span><span>"Name"</span><span>,</span></div></div><div><div><div>27</div></div><div><span> </span><span>"Class"</span><span>,</span></div></div><div><div><div>28</div></div><div><span> </span><span>"Id"</span><span>,</span></div></div><div><div><div>29</div></div><div><span> </span><span>"Grade"</span><span>,</span></div></div><div><div><div>30</div></div><div><span>)</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>效果： <a></a> <a></a></p> <h3>页眉使用当前页面标题<a href="#页眉使用当前页面标题">#</a></h3> <p>使用 <a href="https://github.com/tingerrr/hydra">hydra</a> 包。需要其他设置可以参考 hydra 包的<a href="https://github.com/tingerrr/hydra/blob/main/doc/manual.pdf">文档</a></p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#import</span><span> </span><span>"@preview/hydra:0.5.1"</span><span>:</span><span> hydra</span></div></div><div><div><div>2</div></div><div> </div></div><div><div><div>3</div></div><div><span>#set</span><span> </span><span>page</span><span>(</span></div></div><div><div><div>4</div></div><div><span> </span><span>header</span><span>:</span><span> context </span><span>align</span><span>(</span></div></div><div><div><div>5</div></div><div><span> </span><span>{</span></div></div><div><div><div>6</div></div><div><span> </span><span>if</span><span> calc.</span><span>odd</span><span>(</span><span>here</span><span>()</span><span>.</span><span>page</span><span>())</span><span> </span><span>{</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>right</span></div></div><div><div><div>8</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span><span> </span></span><span>left</span></div></div><div><div><div>10</div></div><div><span> </span><span>}</span></div></div><div><div><div>11</div></div><div><span> </span><span>},</span></div></div><div><div><div>12</div></div><div><span> </span><span>emph</span><span>(</span><span>hydra</span><span>(</span><span>1</span><span>,</span><span> </span><span>skip-starting</span><span>:</span><span> </span><span>false</span><span>)),</span></div></div><div><div><div>13</div></div><div><span> </span><span>),</span></div></div><div><div><div>14</div></div><div><span>)</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>效果： <a></a></p> <blockquote> <div><span>note</span></div> <div> <p>效果演示使用的是我的<a href="/posts/notes-on-theory-of-several-complex-variables-1-1/">多复变函数论笔记</a>的 Typst 版本。</p> </div> </blockquote> <h3>目录不同层级标题使用不同样式<a href="#目录不同层级标题使用不同样式">#</a></h3> <h4>简易版<a href="#简易版">#</a></h4> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#show</span><span> </span><span>outline</span><span>.entry</span><span>:</span><span> it </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>if</span><span> it.level </span><span>==</span><span> </span><span>1</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>strong</span><span>(</span><span>it</span><span>)</span></div></div><div><div><div>4</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>if</span><span> it.level </span><span>&gt;=</span><span> </span><span>3</span><span> </span><span>{</span></div></div><div><div><div>5</div></div><div><span> </span><span>emph</span><span>(</span><span>it</span><span>)</span></div></div><div><div><div>6</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>it</span></div></div><div><div><div>8</div></div><div><span> </span><span>}</span></div></div><div><div><div>9</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>效果如下： <a></a> 可以发现，页码也变得歪七倒八的。如果不介意，那么用这个简易版即可；反之，可以看下面的复杂版</p> <h4>复杂版<a href="#复杂版">#</a></h4> <div><div>0.12 版本</div><div><blockquote> <div><span>warning</span></div> <div> <p>Typst 0.13 大幅修改了 <code>outline.entry</code> 的接口，以下只适用于 Typst 0.12</p> </div> </blockquote><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#show</span><span> </span><span>outline</span><span>.entry</span><span>:</span><span> it </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>let</span><span> loc </span><span>=</span><span> it.element.</span><span>location</span><span>()</span></div></div><div><div><div>3</div></div><div><span> </span><span>link</span><span>(</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>loc</span><span>,</span></div></div><div><div><div>5</div></div><div><span> </span><span>if</span><span> it.level </span><span>==</span><span> </span><span>1</span><span> </span><span>{</span></div></div><div><div><div>6</div></div><div><span> </span><span>strong</span><span>(</span><span>it.body</span><span>)</span></div></div><div><div><div>7</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>if</span><span> it.level </span><span>&gt;=</span><span> </span><span>3</span><span> </span><span>{</span></div></div><div><div><div>8</div></div><div><span> </span><span>emph</span><span>(</span><span>it.body</span><span>)</span></div></div><div><div><div>9</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>10</div></div><div><span><span> </span></span><span>it.body</span></div></div><div><div><div>11</div></div><div><span> </span><span>},</span></div></div><div><div><div>12</div></div><div><span> </span><span>)</span></div></div><div><div><div>13</div></div><div><span><span> </span></span><span>sym.space</span></div></div><div><div><div>14</div></div><div><span> </span><span>box</span><span>(</span><span>width</span><span>:</span><span> </span><span>1fr</span><span>,</span><span> it.fill</span><span>)</span></div></div><div><div><div>15</div></div><div><span><span> </span></span><span>sym.space</span></div></div><div><div><div>16</div></div><div><span> </span><span>link</span><span>(</span><span>loc</span><span>,</span><span> it.page</span><span>)</span></div></div><div><div><div>17</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>复杂版是直接照着 Typst 的 <code>outline</code> 函数<a href="https://github.com/typst/typst/blob/1b2714e1a758d6ee0f9471fd1e49cb02f6d8cde4/crates/typst-library/src/model/outline.rs">源码</a>来写的，只有标题的文字部分会修改样式，效果如下： <a></a></p></div></div> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#show</span><span> </span><span>outline</span><span>.entry</span><span>:</span><span> it </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>// 获取 entry 原本的内容</span></div></div><div><div><div>3</div></div><div><span> </span><span>let</span><span> prefix </span><span>=</span><span> outline.entry.</span><span>prefix</span><span>(</span><span>it</span><span>)</span></div></div><div><div><div>4</div></div><div><span> </span><span>let</span><span> body </span><span>=</span><span> outline.entry.</span><span>body</span><span>(</span><span>it</span><span>)</span></div></div><div><div><div>5</div></div><div><span> </span><span>let</span><span> page-number </span><span>=</span><span> outline.entry.</span><span>page</span><span>(</span><span>it</span><span>)</span></div></div><div><div><div>6</div></div><div> </div></div><div><div><div>7</div></div><div><span> </span><span>// 修改 body</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>body </span><span>=</span><span> </span><span>if</span><span> it.level </span><span>==</span><span> </span><span>1</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span> </span><span>strong</span><span>(</span><span>body</span><span>)</span></div></div><div><div><div>10</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>if</span><span> it.level </span><span>&gt;=</span><span> </span><span>3</span><span> </span><span>{</span></div></div><div><div><div>11</div></div><div><span> </span><span>emph</span><span>(</span><span>body</span><span>)</span></div></div><div><div><div>12</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>13</div></div><div><span><span> </span></span><span>body</span></div></div><div><div><div>14</div></div><div><span> </span><span>}</span></div></div><div><div><div>15</div></div><div> </div></div><div><div><div>16</div></div><div><span> </span><span>// 重新组装 inner</span></div></div><div><div><div>17</div></div><div><span> </span><span>// 保持和 `outline.entry.inner(it)` 获取的结构一致</span></div></div><div><div><div>18</div></div><div><span> </span><span>let</span><span> inner </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>19</div></div><div><span><span> </span></span><span>body</span></div></div><div><div><div>20</div></div><div><span><span> </span></span><span>sym.space</span></div></div><div><div><div>21</div></div><div><span> </span><span>box</span><span>(</span><span>width</span><span>:</span><span> </span><span>1fr</span><span>,</span><span> it.fill</span><span>)</span></div></div><div><div><div>22</div></div><div><span><span> </span></span><span>sym.space</span></div></div><div><div><div>23</div></div><div><span><span> </span></span><span>page-number</span></div></div><div><div><div>24</div></div><div><span> </span><span>}</span></div></div><div><div><div>25</div></div><div><span> </span><span>let</span><span> indented </span><span>=</span><span> outline.entry.</span><span>indented</span><span>(</span><span>it</span><span>,</span><span> prefix</span><span>,</span><span> inner</span><span>)</span></div></div><div><div><div>26</div></div><div><span> </span><span>link</span><span>(</span><span>it.element.</span><span>location</span><span>(),</span><span> indented</span><span>)</span></div></div><div><div><div>27</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h3>结合 showybox 与 ctheorems 包制作美观定理环境<a href="#结合-showybox-与-ctheorems-包制作美观定理环境">#</a></h3> <blockquote> <div><span>tip</span></div> <div> <p>目前有开箱即用的包 <a href="https://typst.app/universe/package/theorion">theorion</a>，推荐使用这个。</p> </div> </blockquote> <p>本节内容参考了 <a href="https://github.com/sahasatvik/typst-theorems/issues/15">showybox and ctheorems? · Issue #15 · sahasatvik/typst-theorems</a> 的内容并进行了部分修改。</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>// --------- 定义函数 ---------</span></div></div><div><div><div>2</div></div><div><span>#import</span><span> </span><span>"@preview/ctheorems:1.1.2"</span><span>:</span><span> </span><span>*</span></div></div><div><div><div>3</div></div><div><span>#import</span><span> </span><span>"@preview/showybox:2.0.1"</span><span>:</span><span> showybox</span></div></div><div><div><div>4</div></div><div> </div></div><div><div><div>5</div></div><div><span>#let</span><span> </span><span>showy-thm</span><span>(</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>identifier</span><span>,</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>head</span><span>,</span></div></div><div><div><div>8</div></div><div><span> </span><span>color</span><span>:</span><span> blue</span><span>,</span></div></div><div><div><div>9</div></div><div><span> </span><span>..</span><span>showy-args</span><span>,</span></div></div><div><div><div>10</div></div><div><span> </span><span>supplement</span><span>:</span><span> </span><span>auto</span><span>,</span></div></div><div><div><div>11</div></div><div><span> </span><span>base</span><span>:</span><span> </span><span>"heading"</span><span>,</span></div></div><div><div><div>12</div></div><div><span> </span><span>base_level</span><span>:</span><span> </span><span>none</span><span>,</span></div></div><div><div><div>13</div></div><div><span>)</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>14</div></div><div><span> </span><span>let</span><span> </span><span>showy-fmt</span><span>(</span><span>name</span><span>,</span><span> number</span><span>,</span><span> body</span><span>,</span><span> </span><span>..</span><span>args</span><span>)</span><span> </span><span>=</span><span> </span><span>{</span></div></div><div><div><div>15</div></div><div><span> </span><span>showybox</span><span>(</span></div></div><div><div><div>16</div></div><div><span> </span><span>title</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>17</div></div><div><span><span> </span></span><span>head</span></div></div><div><div><div>18</div></div><div><span><span> </span></span><span>number</span></div></div><div><div><div>19</div></div><div><span> </span><span>if</span><span> name </span><span>!=</span><span> </span><span>none</span><span> </span><span>{</span></div></div><div><div><div>20</div></div><div><span> </span><span>[</span><span>（#name）</span><span>]</span></div></div><div><div><div>21</div></div><div><span> </span><span>}</span></div></div><div><div><div>22</div></div><div><span> </span><span>},</span></div></div><div><div><div>23</div></div><div><span> </span><span>frame</span><span>:</span><span> </span><span>(</span></div></div><div><div><div>24</div></div><div><span><span> </span></span><span>border-color</span><span>:</span><span> color</span><span>,</span></div></div><div><div><div>25</div></div><div><span><span> </span></span><span>title-color</span><span>:</span><span> color.</span><span>lighten</span><span>(</span><span>30%</span><span>),</span></div></div><div><div><div>26</div></div><div><span><span> </span></span><span>body-color</span><span>:</span><span> color.</span><span>lighten</span><span>(</span><span>95%</span><span>),</span></div></div><div><div><div>27</div></div><div><span><span> </span></span><span>footer-color</span><span>:</span><span> color.</span><span>lighten</span><span>(</span><span>80%</span><span>),</span></div></div><div><div><div>28</div></div><div><span><span> </span></span><span>radius</span><span>:</span><span> </span><span>(</span><span>top-left</span><span>:</span><span> </span><span>7pt</span><span>,</span><span> bottom-right</span><span>:</span><span> </span><span>7pt</span><span>,</span><span> rest</span><span>:</span><span> </span><span>2pt</span><span>),</span></div></div><div><div><div>29</div></div><div><span> </span><span>),</span></div></div><div><div><div>30</div></div><div><span> </span><span>..</span><span>args.</span><span>named</span><span>(),</span></div></div><div><div><div>31</div></div><div><span><span> </span></span><span>body</span><span>,</span></div></div><div><div><div>32</div></div><div><span> </span><span>)</span></div></div><div><div><div>33</div></div><div><span> </span><span>}</span></div></div><div><div><div>34</div></div><div><span> </span><span>if</span><span> supplement </span><span>==</span><span> </span><span>auto</span><span> </span><span>{</span></div></div><div><div><div>35</div></div><div><span><span> </span></span><span>supplement </span><span>=</span><span> head</span></div></div><div><div><div>36</div></div><div><span> </span><span>}</span></div></div><div><div><div>37</div></div><div><span> </span><span>thmenv</span><span>(</span></div></div><div><div><div>38</div></div><div><span><span> </span></span><span>identifier</span><span>,</span></div></div><div><div><div>39</div></div><div><span> </span><span>"heading"</span><span>,</span></div></div><div><div><div>40</div></div><div><span> </span><span>none</span><span>,</span></div></div><div><div><div>41</div></div><div><span> </span><span>(</span><span>name</span><span>,</span><span> number</span><span>,</span><span> body</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>showy-fmt</span><span>(</span><span>name</span><span>,</span><span> number</span><span>,</span><span> body</span><span>,</span><span> </span><span>..</span><span>showy-args</span><span>),</span></div></div><div><div><div>42</div></div><div><span> </span><span>)</span><span>.</span><span>with</span><span>(</span><span>supplement</span><span>:</span><span> supplement</span><span>)</span></div></div><div><div><div>43</div></div><div><span>}</span></div></div><div><div><div>44</div></div><div> </div></div><div><div><div>45</div></div><div><span>#let</span><span> theorem </span><span>=</span><span> </span><span>showy-thm</span><span>(</span></div></div><div><div><div>46</div></div><div><span> </span><span>"theorem"</span><span>,</span></div></div><div><div><div>47</div></div><div><span> </span><span>"定理"</span><span>,</span></div></div><div><div><div>48</div></div><div><span> </span><span>title-style</span><span>:</span><span> </span><span>(</span></div></div><div><div><div>49</div></div><div><span><span> </span></span><span>weight</span><span>:</span><span> </span><span>"bold"</span><span>,</span></div></div><div><div><div>50</div></div><div><span><span> </span></span><span>boxed-style</span><span>:</span><span> </span><span>(</span></div></div><div><div><div>51</div></div><div><span><span> </span></span><span>anchor</span><span>:</span><span> </span><span>(</span><span>x</span><span>:</span><span> left</span><span>,</span><span> y</span><span>:</span><span> horizon</span><span>),</span></div></div><div><div><div>52</div></div><div><span><span> </span></span><span>offset</span><span>:</span><span> </span><span>(</span><span>x</span><span>:</span><span> </span><span>0pt</span><span>,</span><span> t</span><span>:</span><span> </span><span>0pt</span><span>),</span></div></div><div><div><div>53</div></div><div><span><span> </span></span><span>radius</span><span>:</span><span> </span><span>(</span><span>top-left</span><span>:</span><span> </span><span>7pt</span><span>,</span><span> bottom-right</span><span>:</span><span> </span><span>7pt</span><span>,</span><span> rest</span><span>:</span><span> </span><span>2pt</span><span>),</span></div></div><div><div><div>54</div></div><div><span> </span><span>),</span></div></div><div><div><div>55</div></div><div><span> </span><span>),</span></div></div><div><div><div>56</div></div><div><span>)</span><span>.</span><span>with</span><span>(</span><span>numbering</span><span>:</span><span> </span><span>"1.1"</span><span>)</span></div></div><div><div><div>57</div></div><div><span>#let</span><span> lemma </span><span>=</span><span> </span><span>showy-thm</span><span>(</span><span>"lemma"</span><span>,</span><span> </span><span>"引理"</span><span>,</span><span> </span><span>color</span><span>:</span><span> green.</span><span>darken</span><span>(</span><span>25%</span><span>))</span><span>.</span><span>with</span><span>(</span><span>numbering</span><span>:</span><span> </span><span>"1.1"</span><span>)</span></div></div><div><div><div>58</div></div><div><span>#let</span><span> proof </span><span>=</span><span> </span><span>thmproof</span><span>(</span><span>"proof"</span><span>,</span><span> </span><span>"证明"</span><span>,</span><span> </span><span>inset</span><span>:</span><span> </span><span>(</span><span>x</span><span>:</span><span> </span><span>0em</span><span>,</span><span> top</span><span>:</span><span> </span><span>0em</span><span>))</span></div></div><div><div><div>59</div></div><div><span>// --------- 定义函数 ---------</span></div></div><div><div><div>60</div></div><div> </div></div><div><div><div>61</div></div><div><span>// --------- 使用演示 ---------</span></div></div><div><div><div>62</div></div><div><span>#show</span><span>:</span><span> thmrules</span></div></div><div><div><div>63</div></div><div><span>#</span><span>theorem</span><span>[</span></div></div><div><div><div>64</div></div><div><span><span> </span></span><span>对任何子集 </span><span>$Omega subset CC^n$</span><span>，</span><span>$cal(O)(Omega)$</span><span> 在逐点加法和数乘意义下封闭。</span></div></div><div><div><div>65</div></div><div><span><span> </span></span><span>任一关于 </span><span>$z_1, dots.c, z_n$</span><span> 的复系数多项式在 </span><span>$CC^n$</span><span> 上是全纯的，从而在 </span><span>$cal(O)(Omega)$</span><span> 里。</span></div></div><div><div><div>66</div></div><div><span><span> </span></span><span>若 </span><span>$f, g in cal(O)(Omega)$</span><span>，且 </span><span>$g(z) eq.not 0, forall z in Omega$</span><span>，则 </span><span>$f slash g in cal(O)(Omega)$</span><span>。</span></div></div><div><div><div>67</div></div><div><span>]</span></div></div><div><div><div>68</div></div><div><span>#</span><span>theorem</span><span>(</span><span>"F. Hartogs, 1906"</span><span>,</span><span> </span><span>numbering</span><span>:</span><span> </span><span>none</span><span>)</span><span>[</span></div></div><div><div><div>69</div></div><div><span><span> </span></span><span>设 </span><span>$D subset CC^n$</span><span> 为一区域，</span><span>$f: D -&gt; CC$</span><span>。若 </span><span>$f$</span><span> 分别关于每一单复变量 </span><span>$z_j (1 &lt;= j &lt;= n)$</span></div></div><div><div><div>70</div></div><div><span><span> </span></span><span>全纯，则 </span><span>$f in cal(O)(D)$</span><span>。</span></div></div><div><div><div>71</div></div><div><span>]</span></div></div><div><div><div>72</div></div><div><span>#</span><span>lemma</span><span>(</span><span>"Osgood"</span><span>,</span><span> </span><span>numbering</span><span>:</span><span> </span><span>none</span><span>)</span><span>[</span></div></div><div><div><div>73</div></div><div><span><span> </span></span><span>设 </span><span>$D subset CC$</span><span> 为一区域，</span><span>$f: D -&gt; CC$</span><span>。若 </span><span>$f in C(D)$</span><span>，且 </span><span>$f$</span></div></div><div><div><div>74</div></div><div><span><span> </span></span><span>分别关于每一单复变量 </span><span>$z_j (1 &lt;= j &lt;= n)$</span><span> 全纯，则 </span><span>$f in cal(O)(D)$</span><span>。</span></div></div><div><div><div>75</div></div><div><span>]</span></div></div><div><div><div>76</div></div><div><span>// --------- 使用演示 ---------</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>效果： <a></a></p> <h3>在文本中使用美观的大括号分类<a href="#在文本中使用美观的大括号分类">#</a></h3> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#let</span><span> my-cases </span><span>=</span><span> </span><span>(</span><span>..</span><span>items</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>box</span><span>(</span></div></div><div><div><div>2</div></div><div><span> </span><span>baseline</span><span>:</span><span> </span><span>50%</span><span> </span><span>-</span><span> </span><span>0.5em</span><span>,</span></div></div><div><div><div>3</div></div><div><span> </span><span>width</span><span>:</span><span> </span><span>1fr</span><span>,</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>math.</span><span>cases</span><span>(</span></div></div><div><div><div>5</div></div><div><span> </span><span>..</span><span>items.</span><span>pos</span><span>()</span><span>.</span><span>map</span><span>(</span><span>item </span><span>=&gt;</span><span> math.</span><span>display</span><span>(</span><span>block</span><span>(</span><span>item</span><span>))),</span></div></div><div><div><div>6</div></div><div><span> </span><span>),</span></div></div><div><div><div>7</div></div><div><span>)</span></div></div><div><div><div>8</div></div><div> </div></div><div><div><div>9</div></div><div><span>*</span><span>TEST</span><span>*</span><span>: </span><span>#</span><span>my-cases</span><span>(</span></div></div><div><div><div>10</div></div><div><span> </span><span>lorem</span><span>(</span><span>20</span><span>),</span></div></div><div><div><div>11</div></div><div><span> </span><span>lorem</span><span>(</span><span>20</span><span>),</span></div></div><div><div><div>12</div></div><div><span> </span><span>lorem</span><span>(</span><span>20</span><span>),</span></div></div><div><div><div>13</div></div><div><span>)</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>效果： <a></a></p> <h3>在 Typst 中绘制 LaTeX 符号<a href="#在-typst-中绘制-latex-符号">#</a></h3> <p>Typst Universe 上有一个现成的包 <a href="https://typst.app/universe/package/metalogo">metalogo</a>，提供了各种 TeX 徽标的绘制函数</p> <p><a></a></p> <h3>其他<a href="#其他">#</a></h3> <ul> <li>对齐 <code>enum</code> / <code>list</code> 环境中的文本与标号：<a href="https://github.com/typst/typst/issues/1204">List and enum markers are not aligned with the baseline of the item’s contents · Issue #1204 · typst/typst</a></li> </ul> <h2>转换为 Markdown<a href="#转换为-markdown">#</a></h2> <p>我的一部分文章使用 Pandoc 将 Typst 转换为 Markdown 文件，方便放在博客。</p> <blockquote> <div><span>tip</span></div> <div> <p>如果你愿意折腾，可以尝试使用 <a href="https://github.com/Myriad-Dreamin/typst.ts/tree/main/projects/hexo-renderer-typst">hexo-renderer-typst</a> 直接在 Hexo 上渲染 Typst 文档。</p> <p>由于 Typst 0.13 版本已有实验性的 HTML 导出，也可以尝试通过 Typst.ts 进行 HTML 导出。对于 Astro，有可以直接使用 HTML 导出功能渲染为网页的 <a href="https://github.com/OverflowCat/astro-typst">astro-typst</a>，以及 tinymist 作者编写的 <a href="https://github.com/Myriad-Dreamin/tylant">基于 Typst 的 Astro 博客模板</a> 。</p> <p>此外，除去 Pandoc，你也可以尝试使用目前集成于 tinymist 内的 <a href="https://docs.rs/crate/typlite/latest">typlite</a> 来将 typst 文档转换为 Markdown。</p> </div> </blockquote> <h3>基础操作<a href="#基础操作">#</a></h3> <p>下载 <a href="https://github.com/jgm/pandoc/releases">Pandoc</a> 的最新版本，配置相应环境变量（如果有需要的话），然后就可以开始了。</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pandoc</span><span> </span><span>--from=typst</span><span> </span><span>--to=markdown</span><span> </span><span>--output=path/to/your/blog/source/_draft/post_name.md</span><span> </span><span>--wrap=preserve</span><span> </span><span>"path/to/your/typst_file.typ"</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h3>不能转换的情形<a href="#不能转换的情形">#</a></h3> <blockquote> <div><span>warning</span></div> <div> <p>以下内容基于 pandoc 3.4 说明</p> </div> </blockquote> <ul> <li><code>import</code> 和 <code>include</code> pandoc 会报错：<code>&lt;stderr&gt;: hPutChar: invalid argument</code>，因此本地包、本地文件和远程包都不能使用。</li> <li><code>context</code> pandoc 会报错：<code>&lt;stderr&gt;: hPutChar: invalid argument</code></li> </ul> <p>可能有更多转换失败的情形，欢迎在本文评论区留言告诉我。</p> <h3>转换可能出现的错误<a href="#转换可能出现的错误">#</a></h3> <ul> <li>与标签相关的内容，转换可能出错</li> <li>数学公式中未使用括号限制范围的嵌套上下标，转换可能出错，如<code>a_b^c_d</code>（）转换为 等</li> </ul> <p>可能有更多转换错误的情形，欢迎在本文评论区留言告诉我。</p> <h2>实用工具<a href="#实用工具">#</a></h2> <ul> <li>在线 Typst 公式识别：<a href="https://typress-web.vercel.app/">Typress</a></li> <li>在线 Typst 符号手写识别：<a href="https://detypify.quarticcat.com/">Detypify</a>（已集成于 Tinymist VSCode 插件中）</li> </ul> </article> https://blog.hpcesia.com/posts/notes-on-theory-of-several-complex-variables-1-2/https://blog.hpcesia.com/posts/notes-on-theory-of-several-complex-variables-1-2/多复变函数论学习笔记 - 复欧氏空间上的 Cauchy-Riemann 方程组Fri, 27 Sep 2024 15:04:16 GMT<article> <h2>多重指标记号<a href="#多重指标记号">#</a></h2> <p>定义如下<strong>多重指标记号</strong>：</p> <ul> <li>设 ，，记</li> </ul> <ul> <li> <p>记 为 ，。</p> </li> <li> <p>记</p> ≔ </li> </ul> <h2>复值连续可微空间<a href="#复值连续可微空间">#</a></h2> <p>对开集 与 ， 表示在 内 次连续可微的的复值函数全体，并记 。</p> <p>设 ，，定义 在 上的 范数为</p> <p>记 ≔，≔，空间</p> <p>关于 范数 是<strong>完备的</strong>，即 为 <strong>Banach 空间</strong>。</p> <p>类似地，空间</p> 可连续延拓到 <p>关于范数 也为 Banach 空间。</p> <h2>偏微分算子<a href="#偏微分算子">#</a></h2> <p>视 ，由 ，可引入偏微分算子</p> <p>容易验证</p> <p>多重指标记号也可扩充到偏微分算子：，</p> ≔ ≔≔ <p>其具有性质：，，有 。</p> <h2>区域上的全纯函数<a href="#区域上的全纯函数">#</a></h2> <p>设 为一区域， 为一复值函数，若 ，且 满足如下<strong>齐次 Cauchy-Riemann 方程组</strong>：</p> <p>则称 在 内<strong>全纯</strong>。</p> <p>在单变量的情形下，若一个定义在区域 上的复值函数 在 上任一点的局部均可展开为幂级数，则称 在 上全纯。多变量情形下，也有类似的全纯函数幂级数定义：</p> <p>设 为一区域， 为一复值函数。若对任一点 ，均存在 的一个开邻域 ，使得 ，</p> ≔ <p>则称 在 内<strong>全纯</strong>。上述两个全纯函数定义是<strong>等价</strong>的。</p> <h2>Hartogs 定理<a href="#hartogs-定理">#</a></h2> <p>记 为 上全体全纯函数的集合。若 是 中的任意子集（例如紧子集或更为一般的闭集），则 表示在包含 的某个邻域上的全纯函数的集合。</p> <p>约定 存在 的某一邻域 ，使得 。</p> <p>由全纯函数定义，立得：</p> <p><strong>定理</strong>: 对任何子集 ， 在逐点加法和数乘意义下封闭。任一关于 的复系数多项式在 上是全纯的，从而在 里。若 ，且 ，则 。</p> <p>任意满足齐次 Cauchy-Riemann 方程组的函数 也分别关于单复变量 全纯。反过来，则有如下 Hartogs 定理：</p> <p><strong>定理</strong> (F. Hartogs, 1906): 设 为一区域，。若 分别关于每一单复变量 全纯，则 。</p> <p>上述定理说明全纯函数定义中的 为多余条件。</p> <p>Hartogs 定理在实变函数论中不成立：设 ，</p> <p>显然 关于 均是实解析的，但其在 处无界。</p> <h2>Osgood 定理<a href="#osgood-定理">#</a></h2> <p><strong>引理</strong> (Osgood): 设 为一区域，。若 ，且 分别关于每一单复变量 全纯，则 。</p> <p><em>证明</em>: 任选一点 以及 ，由于 在 的邻域内关于每一单复变量全纯，可以重复使用单复变量全纯函数的 Cauchy 积分公式，得</p> <p>对任意 均成立。对任意固定点 ，上式各积分的被积函数均在 的紧子集</p> <p>上连续，于是上式的累次积分可替换为重积分</p> <p>注意到对固定的 ，级数</p> <p>对所有 绝对收敛、一致收敛。于是可将级数代入重积分中，并交换求和积分次序，得</p> <p>其中</p> ≔ <p>由 任意性可知 在 上全纯。</p> <p><strong>引理</strong> (Schwarz): 记 为复平面上的单位圆盘， 是 上全纯函数且 ，则 ， 且 。若存在 使得 或者 ，则 为一旋转 ，其中 。</p> <p><strong>定理</strong> (Osgood): 设 为一区域， 局部有界且分别关于每一单复变量 全纯，则 。</p> <p><em>证明</em>: 由 Osgood 引理，只需证 。设 ，任取 使得 ，记 ，对任意 有</p> <p> 局部有界，记</p> ≔ <p> 为单位圆盘。定义 ，取双全纯映射</p> <p>令</p> ≔ <p>则 ， 且 ，由 Schwarz 引理，。</p> <p>取 ，则有</p> <p>于是</p> <p>即 局部 Lipschitz 连续。</p> </article> https://blog.hpcesia.com/posts/notes-on-theory-of-several-complex-variables-1-1/https://blog.hpcesia.com/posts/notes-on-theory-of-several-complex-variables-1-1/多复变函数论学习笔记 - 复欧氏空间Fri, 20 Sep 2024 12:48:48 GMT<article> <h2>符号简述<a href="#符号简述">#</a></h2> <p> 和 分别表示实数域和复数域， 和 分别表示整数和非负整数， 表示正整数。</p> <h2>定义<a href="#定义">#</a></h2> <p>对 ，定义 个复平面的笛卡尔积为 维复数空间</p> <p>其具有自然的 维复向量空间结构。 上的<strong>标准 Hermite 内积</strong>为</p> <p>该内积产生的<strong>范数</strong> 诱导出了 中的<strong>欧氏距离</strong></p> <p>为与一维复空间的 书写形式统一，对 ，也记 。</p> <h2>与 R²ⁿ 的联系<a href="#与-rⁿ-的联系">#</a></h2> <p>定义以 为圆心， 为半径的<strong>开球</strong>为</p> <p>设 ，记 ，则映射</p> <p>是 到 的一个实线性同构，且对 上的 L-2 范数有 ，所以 为 上以 为圆心， 为半径的开球，即 与 拓扑同胚。</p> <p>由此可将 中的拓扑、分析的通常概念替换到 中。</p> <h2>基础概念<a href="#基础概念">#</a></h2> <ul> <li> <p><strong>开集</strong>：设 为一点集，若 ，，使得 ，则称 为开集。</p> </li> <li> <p><strong>连通集</strong>：设 为一点集，若 不能表示为两个非空开集之并，则称 是连通的。</p> </li> <li> <p><strong>区域</strong>：连通的开集。</p> </li> <li> <p><strong>相对紧子集</strong>：设 为一子集，若其闭包 ，则称 为 的一个相对紧子集，记为 。</p> </li> <li> <p><strong>多圆柱</strong>：</p> <p>定义以 为圆心， 为（多）半径的<strong>开多圆柱</strong>为</p> <p>其为 中 个开圆盘的笛卡尔积。</p> </li> <li> <p><strong>多圆域</strong>：</p> <p>更一般地，称 个复平面区域 的笛卡尔积 为一个<strong>多圆域</strong>。</p> </li> </ul> <p>点集 的<strong>拓扑边界</strong>记为 </p> <h2>绝对空间<a href="#绝对空间">#</a></h2> <p>称映射 为<strong>绝对空间</strong>， 中点集在绝对空间下的像可更为方便地用几何表示。</p> <p>例如，容易画出 和 在绝对空间的图形如下：</p> <p><a></a></p> <h2>Hartogs 图形<a href="#hartogs-图形">#</a></h2> <p>当 时，为简化书写，通常记 ，其中 。</p> <p>设 满足 ，定义区域</p> <p>则 的图形可表示如下：</p> <p><a></a></p> <p>称 这样的一个「对」为一个（欧式）Hartogs 图形。</p> <h2>Reinhardt 域<a href="#reinhardt-域">#</a></h2> <p>注意对 而言，</p> <p>是一个 维的实环面^{<a href="#user-content-fn-1">1</a>}。因此有如下定义：</p> <p>设 为一点集，若 ，环面</p> <p>也落在 内，则称 是<strong>圆形的</strong>。在 中，只有圆形点集的绝对空间表示才是有意义的。</p> <p>设 为以原点为中心的开圆形域，则称 为 <strong>Reinhardt 域</strong>。若 还满足 ，均有 ，则称 是<strong>完备的</strong>。 和 是完备的 Reinhardt 域，但是 是不完备的 Reinhardt 域。</p> <p>考虑全纯函数的洛朗级数展开时就会遇到 Reinhardt 域， 中典型的完备 Reinhardt 域是以原点为圆心的开圆盘，而典型的不完备 Reinhardt 域是以原点为圆心的圆环区域。</p> <section><h2>脚注<a href="#footnote-label">#</a></h2> <ol> <li> <p> 个圆环的笛卡尔积 <a href="#user-content-fnref-1">↩</a></p> </li> </ol> </section> </article> https://blog.hpcesia.com/posts/vscode-extension-recommendations/https://blog.hpcesia.com/posts/vscode-extension-recommendations/推荐一些好用实用的 VSCode 扩展。Thu, 05 Sep 2024 07:22:43 GMT<article> <div><div>更新日志</div><div><ul> <li>2025-03-03 <ul> <li>新增插件推荐： <ul> <li>Roo Code</li> </ul> </li> <li>移除插件推荐： <ul> <li>Continue</li> </ul> </li> </ul> </li> <li>2024-10-23 <ul> <li>新增插件推荐： <ul> <li>Continue</li> </ul> </li> <li>补充了部分扩展的效果图片</li> </ul> </li> <li>2024-09-10 <ul> <li>新增插件推荐： <ul> <li>SpaceBox UI Enhancer</li> </ul> </li> </ul> </li> <li>2024-09-06 <ul> <li>新增插件推荐： <ul> <li>Excalidraw</li> <li>CodeGeeX</li> <li>Code Spell Checker</li> </ul> </li> </ul> </li> <li>2024-09-05 <ul> <li>发布文章。</li> </ul> </li> </ul></div></div> <h2>功能<a href="#功能">#</a></h2> <p>这节推荐的都是比较通用的功能性扩展，针对某个语言的扩展也不需要我来推荐，自有大把针对性的文章进行介绍。</p> <h3>Path Intellisense<a href="#path-intellisense">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=christian-kohler.path-intellisense">Path Intellisense</a> 扩展可以在输入文件路径的时候给出自动补全提示，方便输入。</p> <h3>Project Manager<a href="#project-manager">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager">Project Manager</a> 扩展可以在侧边栏新增一个「项目管理器」选项，通过在项目管理器中保存项目，可以实现不同工作区之间的快速切换。</p> <p><a></a></p> <h3>Error Lens<a href="#error-lens">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=usernamehw.errorlens">Error Lens</a> 扩展可以直接把错误、警告与提示等信息直接显示在代码行后面，而不是只能把光标移动到下划线处才能看到。</p> <p><a></a></p> <p><a></a></p> <h3>Todo Tree<a href="#todo-tree">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=Gruntfuggly.todo-tree">Todo Tree</a> 扩展可以搜索整个工作区内的「TODO」、「FIXME」、「BUG」等字段，并在侧边栏的选项中查看。</p> <p><a></a></p> <h3>Trailing Spaces<a href="#trailing-spaces">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=shardulm94.trailing-spaces">Trailing Spaces</a> 扩展可以标红每行代码尾部多余的空格。</p> <p><a></a></p> <h3>Excalidraw<a href="#excalidraw">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=pomdtr.excalidraw-editor">Excalidraw</a> 扩展可以在 VSCode 内绘制手绘风格的矢量图片，支持导出 <code>.png</code> 和 <code>.svg</code> 格式。</p> <p><a></a></p> <h3>CodeGeeX<a href="#codegeex">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=aminer.codegeex">CodeGeeX</a> 扩展可以调用本地或网络的大模型，来加速代码编写。CodeGeeX 的大模型在 GitHub 上开源，因此可以通过本地运行大模型，放心地在涉及商业秘密的项目中使用。</p> <h3>Code Spell Checker<a href="#code-spell-checker">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker">Code Spell Checker</a> 扩展可以检测代码中的英文拼写错误并给出修改建议。</p> <h3>翻译(英汉词典)<a href="#翻译英汉词典">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=CodeInChinese.EnglishChineseDictionary">翻译(英汉词典)</a> 扩展可以在选中单词时在右下角给出单词的翻译，并且可以翻译下划线、驼峰等格式的单词，方便理解代码。</p> <p>:::collapse{title=“效果演示}</p> <p><a></a></p> <p><a></a></p> <p><a></a></p> <p><a></a></p> <p>:::</p> <h3>驼峰翻译助手<a href="#驼峰翻译助手">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=svenzhao.var-translation">驼峰翻译助手</a>扩展可以调用翻译 API，将中文直接翻译为英文的不同格式的变量名，再也不用发愁怎么命名变量。</p> <p><a></a></p> <h3>Roo Code<a href="#roo-code">#</a></h3> <p>Roo Code 是一个类似 Cursor 的 AI 代码助手插件。优势在于能够调用 VSCode 自带的 GitHub Copilot 的 API，对于有 GitHub Copilot Pro 免费访问的人（学生认证或 1k star 开源库的维护者）比较友好。不过 VSCode 的 API 不支持多模态，只能文字描述需求。</p> <h2>美化<a href="#美化">#</a></h2> <h3>Material Icon Theme<a href="#material-icon-theme">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=PKief.material-icon-theme">Material Icon Theme</a> 扩展是一个文件图标扩展，其为各种文件与文件夹都制作了特殊的图标，方便浏览。</p> <p><a></a></p> <h3>background-cover<a href="#background-cover">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=manasxx.background-cover">background-cover</a> 扩展可以直接在其自带的命令中修改更换 VSCode 背景图片。</p> <p><a></a></p> <p>更换背景图后效果如下：</p> <p><a></a></p> <h3>SpaceBox UI Enhancer<a href="#spacebox-ui-enhancer">#</a></h3> <p><a href="https://marketplace.visualstudio.com/items?itemName=SpaceBox.spacebox-ui">SpaceBox UI Enhancer</a> 扩展为 VSCode 的菜单增加了大量对效率影响较小的过渡动画效果。</p> <blockquote> <div><span>note</span></div> <div> <p>评论区反应 MacOS 下该插件可能不可用，请注意。</p> </div> </blockquote> <p><a></a></p> </article> https://blog.hpcesia.com/posts/hexo-blog-search-engine-indexing/https://blog.hpcesia.com/posts/hexo-blog-search-engine-indexing/简单记录了将 Hexo 博客收录进搜索引擎与优化 SEO 的经验。Tue, 03 Sep 2024 18:36:32 GMT<article> <div><div>更新日志</div><div><ul> <li>2024-09-04 <ul> <li>新增「添加 nofollow 标签」相关内容。</li> </ul> </li> <li>2024-09-03 <ul> <li>发布文章。</li> </ul> </li> </ul></div></div> <p>以下以 Bing 为例进行说明。</p> <h2>在 Bing Webmaster Tools 中登录并添加网站<a href="#在-bing-webmaster-tools-中登录并添加网站">#</a></h2> <p><a href="https://www.bing.com/webmasters">Bing Webmaster Tools</a> 是必应的网站管理员工具，可以添加个人网站并带进行一些网站操作。打开 <a href="https://www.bing.com/webmasters">Webmaster</a> 后点击「开始」或右上角「登录」以登录到官网。可以选择三种登录账号：Google、Microsoft、Facebook。</p> <p><a></a></p> <p>初次登录会提示添加网站，有两种添加方式：从 GSC 导入、手动添加。如果网站已通过 GSC 收录，可以直接用 GSC，我选择手动添加。然后在右侧的输入框中输入网站URL即可。</p> <p><a></a></p> <p>然后会要求验证网站。</p> <h2>验证网站<a href="#验证网站">#</a></h2> <p>验证网站有多种方式，我选择的是下载 <code>BingSiteAuth.xml</code> 文件进行验证。</p> <p>Webmaster 会要求你将这个文件放到网站的根目录，我们只需要将下载下来的 <code>BingSiteAuth.xml</code> 文件放到我们博客的 <code>source</code> 目录下，使用 <code>hexo d -g</code> 生成并推送到 GitHub 上即可，可以访问网站根目录下找到 <code>BingSiteAuth.xml</code>。</p> <p>然后在 Webmaster 页面中点击验证即可。</p> <h2>添加网站地图<a href="#添加网站地图">#</a></h2> <p>在博客根目录下打开终端，输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>hexo-generator-sitemap</span><span> </span><span>--save</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>并在 <code>_config.yaml</code> 中新增如下配置项：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>## Sitemap Generator</span></div></div><div><div><div>2</div></div><div><span>sitemap</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>path</span><span>:</span><span> </span><span>sitemap.xml</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接着使用 <code>hexo d -g</code> 生成并推送到 GitHub 上。在 Webmaster 左侧边栏选择「网站地图」选项</p> <p><a></a></p> <p>然后点击右上角的「提交网站地图」按钮，输入你的网站的 <code>sitemap.xml</code> 位置。按照上述配置方法，我输入的是 <code>https://blog.hpcesia.com/sitemap.xml</code>。等待一段时间后，网站地图就会审核成功，如图所示：</p> <p><a></a></p> <p>等待 48 小时审核后，就可以在搜索引擎上搜索到自己的博客了。</p> <p><a></a></p> <h2>编制 URL<a href="#编制-url">#</a></h2> <p>审核通过后，可能还是搜不到自己的博客，这时候就需要打开左侧边栏的「URL 检查」界面</p> <p><a></a></p> <p>输入自己的博客主页链接检查 URL，如果提示「已发现但未爬网，该 URL 无法在必应上显示」，先确认自己博客没有问题，然后选择「请求编制索引」即可，等待一段时间应该就好了。如果一直不进行索引，可以去联系客服处理。</p> <h2>GitHub Action 自动提交 URL<a href="#github-action-自动提交-url">#</a></h2> <p>如果博客更新较勤，可以使用 <a href="https://github.com/Lete114/Hexo-SEO-AutoPush"><code>Hexo-SEO-AutoPush</code></a> 插件来配置 GitHub Action 以定期推送 URL 到搜索引擎上，提高爬虫抓取几率。</p> <h3>安装<a href="#安装">#</a></h3> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>hexo-seo-autopush</span><span> </span><span>--save</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h3>配置文件<a href="#配置文件">#</a></h3> <p>在博客根目录下的 <code>_config.yml</code> 配置文件中添加以下内容：</p> <div><figure><figcaption><span>_config.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>## enable: 开启/关闭 推送</span></div></div><div><div><div>2</div></div><div><span>## cron: 执行时间周期</span></div></div><div><div><div>3</div></div><div><span>## deployBranch: 部署分支</span></div></div><div><div><div>4</div></div><div><span>## count: 每次提交最新的10篇文章，输入0或者不填写则默认为所有文章(建议是最新的10篇文章)</span></div></div><div><div><div>5</div></div><div><span>## date: 更新时间(updated)|创建日期(created)</span></div></div><div><div><div>6</div></div><div><span>## https://github.com/Lete114/hexo-seo-autopush.git</span></div></div><div><div><div>7</div></div><div><span>hexo_seo_autopush</span><span>:</span></div></div><div><div><div>8</div></div><div><span> </span><span>cron</span><span>:</span><span> </span><span>0 4 * * *</span></div></div><div><div><div>9</div></div><div><span> </span><span>deployBranch</span><span>:</span></div></div><div><div><div>10</div></div><div><span> </span><span>baidu</span><span>:</span></div></div><div><div><div>11</div></div><div><span> </span><span>enable</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>12</div></div><div><span> </span><span>date</span><span>:</span><span> </span><span>created</span></div></div><div><div><div>13</div></div><div><span> </span><span>count</span><span>:</span><span> </span><span>10</span></div></div><div><div><div>14</div></div><div><span> </span><span>bing</span><span>:</span></div></div><div><div><div>15</div></div><div><span> </span><span>enable</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>16</div></div><div><span> </span><span>date</span><span>:</span><span> </span><span>created</span></div></div><div><div><div>17</div></div><div><span> </span><span>count</span><span>:</span><span> </span><span>10</span></div></div><div><div><div>18</div></div><div><span> </span><span>google</span><span>:</span></div></div><div><div><div>19</div></div><div><span> </span><span>enable</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>20</div></div><div><span> </span><span>date</span><span>:</span><span> </span><span>created</span></div></div><div><div><div>21</div></div><div><span> </span><span>count</span><span>:</span><span> </span><span>10</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>由于生成的 actions 是在<code>.github/workflows/HexoSeoAutoPush.yml</code>，<code>.</code> 开头的文件或文件夹都会被视为隐藏文件，<code>hexo-deployer-git</code> 不会部署隐藏文件，所以需要新增配置项 <code>ignore_hidden</code></p> <div><figure><figcaption><span>_config.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>deploy</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>type</span><span>:</span><span> </span><span>'git'</span></div></div><div><div><div>3</div></div><div><span> </span><span>repo</span><span>:</span><span> </span><span>git@github.com:HPCesia/HPCesia.github.io.git</span></div></div><div><div><div>4</div></div><div><span> </span><span>branch</span><span>:</span><span> </span><span>master</span></div></div><div><div><div>5</div></div><div><span> </span><span>ignore_hidden</span><span>:</span><span> </span><span>false</span><span> </span><span># 忽略隐藏文件及文件夹(目录)</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h3>APIKEY 设置<a href="#apikey-设置">#</a></h3> <p>打开博客部署的 GitHub 仓库的「Setting」选项卡：</p> <p><a></a></p> <p>在侧边栏找到「Secrets and variables」选项，点开其中的「Actions」选项：</p> <p><a></a></p> <p>然后点击「New repository secret」：</p> <p><a></a></p> <p>在「Name」和「Secret」处分别填写下方表格中的内容：</p> <div> <table><thead><tr><th>Name</th><th>Value</th><th>说明</th></tr></thead><tbody><tr><td>baidu_token</td><td>UlxxxxxxxxxxxxxB9</td><td>【必填】Value 输入百度的 token</td></tr><tr><td>bing_apikey</td><td>47xxxxxxxxxxxxx91</td><td>【必填】Value 输入必应的 apikey</td></tr><tr><td>google_private_key</td><td>xxxxxxxxxxxxxxxxx</td><td>【必填】Value 输入谷歌的 private_key （注意：填写的时候需要使用<strong>双引号</strong>包起来，如: <code>"private_key"</code>）</td></tr><tr><td>google_client_email</td><td>xxxxxxxxxxxxxxxxx</td><td>【必填】Value 输入谷歌的 client_email</td></tr></tbody></table></div> <p>后续跟随<a href="https://github.com/Lete114/Hexo-SEO-AutoPush?tab=readme-ov-file#baidu-key">插件说明</a>操作即可。</p> <h2>添加 nofollow 标签<a href="#添加-nofollow-标签">#</a></h2> <p><a href="https://github.com/hexojs/hexo-filter-nofollow"><code>hexo-filter-nofollow</code></a> 插件可以自动化地为博客中的外链添加 <code>nofollow</code> 标签。</p> <p>输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>i</span><span> </span><span>hexo-filter-nofollow</span><span> </span><span>--save</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>安装 <code>hexo-filter-nofollow</code> 插件，然后在 <code>_config.yml</code> 中添加配置项：</p> <div><figure><figcaption><span>_config.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>## hexo-filter-nofollow</span></div></div><div><div><div>2</div></div><div><span>## field - 插件的处理范围，默认值为 site，可选 post 或 site</span></div></div><div><div><div>3</div></div><div><span>## post - 仅处理文章内容</span></div></div><div><div><div>4</div></div><div><span>## site - 处理全站所有页面</span></div></div><div><div><div>5</div></div><div><span>## exclude - 域名白名单，不同的子域名视为不同的域名（如 www）</span></div></div><div><div><div>6</div></div><div><span>## exclude1.com不包括 www.exclude1.com 或 en.exclude1.com</span></div></div><div><div><div>7</div></div><div><span>nofollow</span><span>:</span></div></div><div><div><div>8</div></div><div><span> </span><span>enable</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>9</div></div><div><span> </span><span>field</span><span>:</span><span> </span><span>site</span></div></div><div><div><div>10</div></div><div><span> </span><span>exclude</span><span>:</span></div></div><div><div><div>11</div></div><div><span> </span><span>-</span><span> </span><span>'exclude1.com'</span></div></div><div><div><div>12</div></div><div><span> </span><span>-</span><span> </span><span>'exclude2.com'</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl &amp;&amp; hexo g &amp;&amp; hexo d</code> 三连即可。</p> <h2>参考资料<a href="#参考资料">#</a></h2> <ul> <li><a href="https://www.cnblogs.com/RainbowC0/p/18107581">将 GitHub Pages 个人博客录入搜索引擎（以 Bing 为例） - RainbowC0 - 博客园</a></li> <li><a href="https://lengnian.github.io/posts/7cddb87d/">Hexo+GitHub Pages搭建的个人博客加入到Bing搜索引擎 | WeiSJ&amp;HEXO </a></li> <li><a href="https://www.ehcoo.com/seo.html">【搜索优化】Hexo-next百度和谷歌搜索优化 | Ehcoo</a></li> <li><a href="https://www.wrysmile.cn/Hexo-03.html">Hexo博客之高级优化教程 | Wrysmile 的博客</a></li> </ul> </article> https://blog.hpcesia.com/posts/fluid-theme-modification-notes/https://blog.hpcesia.com/posts/fluid-theme-modification-notes/非侵入式改造 Hexo 的 Fluid 主题的经验记录Mon, 26 Aug 2024 07:54:36 GMT<article> <div><div>更新日志</div><div><ul> <li> <p>2024-09-07</p> <ul> <li>更新主题更换提醒。</li> </ul> </li> <li> <p>2024-09-03</p> <ul> <li>规范了更新日志格式。</li> </ul> </li> <li> <p>2024-08-27</p> <ul> <li>新增「文章时效性显示」、「随机文章跳转」与「代码块美化」相关内容。</li> </ul> </li> <li> <p>2024-08-26</p> <ul> <li>新增「顶部阅读进度条」与「建站时间显示」相关内容。</li> </ul> </li> <li> <p>2024-08-26</p> <ul> <li>发布文章。</li> </ul> </li> </ul></div></div> <blockquote> <div><span>warning</span></div> <div> <p>本博客已更换至 <a href="https://solitude.js.org/zh/">Solitude</a> 主题，Fluid 主题相关内容仅供参考。</p> <p>本博客已更换至 <a href="https://github.com/HPCesia/astral-halo">Astral Halo</a> 主题，Solitude 与 Fluid 主题相关内容仅供参考。</p> </div> </blockquote> <p><a href="https://hexo.io">Hexo</a> 的 <a href="https://github.com/fluid-dev/hexo-theme-fluid">Fluid</a> 主题是一个很好的主题，功能基本完整，页面简洁，加载浏览都很流畅。但是我对这个主题的页面仍有想修改的地方，特此记录。</p> <p>同时为了保证在更新主题是不会影响我的修改，因此本文中所有修改都是<strong>非侵入式</strong>（不修改主题源代码）的。</p> <h2>文章时效性提示<a href="#文章时效性提示">#</a></h2> <p>在 <code>source/custom/js</code> 目录下新建 <code>outdate-notice.js</code> 文件：</p> <div><figure><figcaption><span>source/custom/js/outdate-notice.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>window</span><span>.</span><span>onload</span><span> </span><span>=</span><span> </span><span>function</span><span> </span><span>()</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>//不同的日期显示不同的样式，200 天为黄色提示，400天为红色提示，可以自己定义。</span></div></div><div><div><div>3</div></div><div><span> </span><span>let</span><span> warningDay </span><span>=</span><span> </span><span>200</span><span>;</span></div></div><div><div><div>4</div></div><div><span> </span><span>let</span><span> errorDay </span><span>=</span><span> </span><span>600</span><span>;</span></div></div><div><div><div>5</div></div><div><span> </span><span>// 确保能够获取到文章时间以及在文章详情页</span></div></div><div><div><div>6</div></div><div><span> </span><span>let</span><span> times </span><span>=</span><span> document</span><span>.</span><span>getElementsByTagName</span><span>(</span><span>'time'</span><span>)</span><span>;</span></div></div><div><div><div>7</div></div><div><span> </span><span>if</span><span> (times</span><span>.</span><span>length </span><span>===</span><span> </span><span>0</span><span>) </span><span>{</span></div></div><div><div><div>8</div></div><div><span> </span><span>return</span><span>;</span></div></div><div><div><div>9</div></div><div><span> </span><span>}</span></div></div><div><div><div>10</div></div><div><span> </span><span>let</span><span> posts </span><span>=</span><span> document</span><span>.</span><span>getElementsByClassName</span><span>(</span><span>'post-content'</span><span>)</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span>if</span><span> (posts</span><span>.</span><span>length </span><span>===</span><span> </span><span>0</span><span>) </span><span>{</span></div></div><div><div><div>12</div></div><div><span> </span><span>return</span><span>;</span></div></div><div><div><div>13</div></div><div><span> </span><span>}</span></div></div><div><div><div>14</div></div><div> </div></div><div><div><div>15</div></div><div><span> </span><span>// 获取系统当前的时间</span></div></div><div><div><div>16</div></div><div><span> </span><span>let</span><span> pubTime </span><span>=</span><span> </span><span>new</span><span> </span><span>Date</span><span>(times[</span><span>0</span><span>]</span><span>.</span><span>dateTime)</span><span>;</span><span> </span><span>/* 文章发布时间戳 */</span></div></div><div><div><div>17</div></div><div><span> </span><span>let</span><span> now </span><span>=</span><span> Date</span><span>.</span><span>now</span><span>()</span><span>;</span><span> </span><span>/* 当前时间戳 */</span></div></div><div><div><div>18</div></div><div><span> </span><span>let</span><span> interval </span><span>=</span><span> </span><span>parseInt</span><span>(now </span><span>-</span><span> pubTime)</span><span>;</span></div></div><div><div><div>19</div></div><div><span> </span><span>let</span><span> days </span><span>=</span><span> </span><span>parseInt</span><span>(interval </span><span>/</span><span> </span><span>86400000</span><span>)</span><span>;</span></div></div><div><div><div>20</div></div><div><span> </span><span>/* 发布时间超过指定时间（毫秒） */</span></div></div><div><div><div>21</div></div><div><span> </span><span>//note warning 以及 note danger 是 Next 主题的自定义模板语法，如果使用其他主题，请自行更改样式以达到最佳显示效果</span></div></div><div><div><div>22</div></div><div><span> </span><span>if</span><span> (interval </span><span>&gt;</span><span> warningDay </span><span>*</span><span> </span><span>3600</span><span> </span><span>*</span><span> </span><span>24</span><span> </span><span>*</span><span> </span><span>1000</span><span> </span><span>&amp;&amp;</span><span> interval </span><span>&lt;</span><span> errorDay </span><span>*</span><span> </span><span>3600</span><span> </span><span>*</span><span> </span><span>24</span><span> </span><span>*</span><span> </span><span>1000</span><span>) </span><span>{</span></div></div><div><div><div>23</div></div><div><span><span> </span></span><span>posts[</span><span>0</span><span>]</span><span>.</span><span>innerHTML </span><span>=</span></div></div><div><div><div>24</div></div><div><span> </span><span>'&lt;div class="note note-warning"&gt;'</span><span> </span><span>+</span></div></div><div><div><div>25</div></div><div><span> </span><span>'&lt;h5&gt;文章时效性提示&lt;/h5&gt;&lt;p&gt;这是一篇发布于 '</span><span> </span><span>+</span></div></div><div><div><div>26</div></div><div><span><span> </span></span><span>days </span><span>+</span></div></div><div><div><div>27</div></div><div><span> </span><span>' 天前的文章，部分信息可能已发生改变，请注意甄别。&lt;/p&gt;'</span><span> </span><span>+</span></div></div><div><div><div>28</div></div><div><span> </span><span>'&lt;/div&gt;'</span><span> </span><span>+</span></div></div><div><div><div>29</div></div><div><span><span> </span></span><span>posts[</span><span>0</span><span>]</span><span>.</span><span>innerHTML</span><span>;</span></div></div><div><div><div>30</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>if</span><span> (interval </span><span>&gt;=</span><span> errorDay </span><span>*</span><span> </span><span>3600</span><span> </span><span>*</span><span> </span><span>24</span><span> </span><span>*</span><span> </span><span>1000</span><span>) </span><span>{</span></div></div><div><div><div>31</div></div><div><span><span> </span></span><span>posts[</span><span>0</span><span>]</span><span>.</span><span>innerHTML </span><span>=</span></div></div><div><div><div>32</div></div><div><span> </span><span>'&lt;div class="note note-danger"&gt;'</span><span> </span><span>+</span></div></div><div><div><div>33</div></div><div><span> </span><span>'&lt;h5&gt;文章时效性提示&lt;/h5&gt;&lt;p&gt;这是一篇发布于 '</span><span> </span><span>+</span></div></div><div><div><div>34</div></div><div><span><span> </span></span><span>days </span><span>+</span></div></div><div><div><div>35</div></div><div><span> </span><span>' 天前的文章，部分信息可能已发生改变，请注意甄别。&lt;/p&gt;'</span><span> </span><span>+</span></div></div><div><div><div>36</div></div><div><span> </span><span>'&lt;/div&gt;'</span><span> </span><span>+</span></div></div><div><div><div>37</div></div><div><span><span> </span></span><span>posts[</span><span>0</span><span>]</span><span>.</span><span>innerHTML</span><span>;</span></div></div><div><div><div>38</div></div><div><span> </span><span>}</span></div></div><div><div><div>39</div></div><div><span>};</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>在之前创建的 <code>scripts/injector.js</code> 中新增：</p> <div><figure><figcaption><span>scripts/injector.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>// 注入文章时效性提示</span></div></div><div><div><div>2</div></div><div><span>hexo</span><span>.</span><span>extend</span><span>.</span><span>injector</span><span>.</span><span>register</span><span>(</span></div></div><div><div><div>3</div></div><div><span> </span><span>'body_end'</span><span>,</span></div></div><div><div><div>4</div></div><div><span> </span><span>`&lt;script src="custom/js/outdate-notice.js"&gt;&lt;/script&gt;`</span><span>,</span></div></div><div><div><div>5</div></div><div><span> </span><span>'post'</span></div></div><div><div><div>6</div></div><div><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <h2>代码块美化<a href="#代码块美化">#</a></h2> <p>在 <code>scripts</code> 目录下新建 <code>code-pretty.js</code> 文件：</p> <div><figure><figcaption><span>scripts/code-pretty.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>'use strict'</span><span>;</span></div></div><div><div><div>2</div></div><div> </div></div><div><div><div>3</div></div><div><span>// 获取唯一 ID</span></div></div><div><div><div>4</div></div><div><span>function</span><span> </span><span>getUuid</span><span>()</span><span> </span><span>{</span></div></div><div><div><div>5</div></div><div><span> </span><span>return</span><span> Math</span><span>.</span><span>random</span><span>()</span><span>.</span><span>toString</span><span>(</span><span>36</span><span>)</span><span>.</span><span>substring</span><span>(</span><span>2</span><span>,</span><span> </span><span>8</span><span>) </span><span>+</span><span> Date</span><span>.</span><span>now</span><span>()</span><span>.</span><span>toString</span><span>(</span><span>36</span><span>)</span><span>;</span></div></div><div><div><div>6</div></div><div><span>}</span></div></div><div><div><div>7</div></div><div> </div></div><div><div><div>8</div></div><div><span>hexo</span><span>.</span><span>extend</span><span>.</span><span>filter</span><span>.</span><span>register</span><span>(</span></div></div><div><div><div>9</div></div><div><span> </span><span>'after_post_render'</span><span>,</span></div></div><div><div><div>10</div></div><div><span> </span><span>(</span><span>data</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>11</div></div><div><span> </span><span>const</span><span> </span><span>{</span><span> line_number</span><span>,</span><span> lib </span><span>}</span><span> </span><span>=</span><span> hexo</span><span>.</span><span>theme</span><span>.</span><span>config</span><span>.</span><span>code</span><span>.</span><span>highlight</span><span>;</span></div></div><div><div><div>12</div></div><div> </div></div><div><div><div>13</div></div><div><span> </span><span>let</span><span> reg</span><span>;</span></div></div><div><div><div>14</div></div><div><span> </span><span>if</span><span> (lib </span><span>===</span><span> </span><span>'highlightjs'</span><span>) </span><span>{</span></div></div><div><div><div>15</div></div><div><span> </span><span>if</span><span> (line_number) </span><span>{</span></div></div><div><div><div>16</div></div><div><span><span> </span></span><span>reg </span><span>=</span><span> </span><span>/</span><span>(&lt;figure class="highlight</span><span>.</span><span>+?</span><span>&gt;)(</span><span>.</span><span>+?</span><span>hljs (</span><span>.</span><span>*?</span><span>)"</span><span>.</span><span>+?</span><span>)(&lt;</span><span>\/</span><span>figure&gt;)</span><span>/</span><span>gims</span><span>;</span></div></div><div><div><div>17</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>18</div></div><div><span><span> </span></span><span>reg </span><span>=</span><span> </span><span>/</span><span>(&lt;div class="code-wrapper</span><span>.</span><span>+?</span><span>&gt;)(</span><span>.</span><span>+?</span><span>hljs (</span><span>.</span><span>*?</span><span>)"</span><span>.</span><span>+?</span><span>)(&lt;</span><span>\/</span><span>div&gt;)</span><span>/</span><span>gims</span><span>;</span></div></div><div><div><div>19</div></div><div><span> </span><span>}</span></div></div><div><div><div>20</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>if</span><span> (lib </span><span>===</span><span> </span><span>'prismjs'</span><span>) </span><span>{</span></div></div><div><div><div>21</div></div><div><span><span> </span></span><span>reg </span><span>=</span><span> </span><span>/</span><span>(&lt;div class="code-wrapper</span><span>.</span><span>+?</span><span>&gt;)(</span><span>.</span><span>+?</span><span>data-language="(</span><span>.</span><span>*?</span><span>)"</span><span>.</span><span>+?</span><span>)(&lt;</span><span>\/</span><span>div&gt;)</span><span>/</span><span>gims</span><span>;</span></div></div><div><div><div>22</div></div><div><span> </span><span>}</span></div></div><div><div><div>23</div></div><div> </div></div><div><div><div>24</div></div><div><span><span> </span></span><span>data</span><span>.</span><span>content </span><span>=</span><span> data</span><span>.</span><span>content</span><span>.</span><span>replace</span><span>(</span></div></div><div><div><div>25</div></div><div><span><span> </span></span><span>reg</span><span>,</span></div></div><div><div><div>26</div></div><div><span> </span><span>(</span><span>match</span><span>,</span><span> </span><span>begin</span><span>,</span><span> </span><span>inner</span><span>,</span><span> </span><span>lang</span><span>,</span><span> </span><span>end</span><span>,</span><span> </span><span>offset</span><span>,</span><span> </span><span>string</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>27</div></div><div><span> </span><span>const</span><span> collapseId </span><span>=</span><span> </span><span>`collapse-</span><span>${</span><span>getUuid</span><span>()</span><span>}</span><span>`</span><span>;</span></div></div><div><div><div>28</div></div><div><span> </span><span>const</span><span> collapseBtn </span><span>=</span><span> </span><span>`&lt;i class="iconfont icon-code" type="button" data-toggle="collapse" data-target="#</span><span>${</span><span>collapseId</span><span>}</span><span>"&gt;&lt;/i&gt;`</span><span>;</span></div></div><div><div><div>29</div></div><div><span> </span><span>const</span><span> collapseDiv </span><span>=</span><span> </span><span>`&lt;div class="collapse show" id="</span><span>${</span><span>collapseId</span><span>}</span><span>"&gt;</span><span>${</span><span>inner</span><span>}</span><span>&lt;/div&gt;`</span><span>;</span></div></div><div><div><div>30</div></div><div><span> </span><span>const</span><span> langSpan </span><span>=</span><span> </span><span>`&lt;span&gt;</span><span>${</span><span>lang</span><span>.</span><span>toUpperCase</span><span>()</span><span>}</span><span>&lt;/span&gt;`</span><span>;</span></div></div><div><div><div>31</div></div><div><span> </span><span>return</span><span> begin </span><span>+</span><span> collapseBtn </span><span>+</span><span> langSpan </span><span>+</span><span> collapseDiv </span><span>+</span><span> end</span><span>;</span></div></div><div><div><div>32</div></div><div><span> </span><span>}</span></div></div><div><div><div>33</div></div><div><span><span> </span></span><span>)</span><span>;</span></div></div><div><div><div>34</div></div><div> </div></div><div><div><div>35</div></div><div><span> </span><span>return</span><span> data</span><span>;</span></div></div><div><div><div>36</div></div><div><span> </span><span>},</span></div></div><div><div><div>37</div></div><div><span> </span><span>10000</span><span> </span><span>// 应该在完成其他渲染后执行，因此将优先级设大一点</span></div></div><div><div><div>38</div></div><div><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <blockquote> <div><span>tip</span></div> <div> <p>如果需要修改代码块右上角图标，请更换 <code>collapseBtn</code> 的 icon 部分 <code>"iconfont icon-code"</code>。</p> </div> </blockquote> <p>再在 <code>custom/css</code> 中新建 <code>code-pretty.styl</code> 文件</p> <div><figure><figcaption><span>custom/css/code-pretty.styl</span></figcaption><pre><code><div><div><div>1</div></div><div><span>.</span><span>markdown-body</span><span> </span><span>.</span><span>highlight</span><span> </span><span>table</span><span>,</span></div></div><div><div><div>2</div></div><div><span>.</span><span>markdown-body</span><span> </span><span>.</span><span>code-wrapper</span><span> </span><span>pre</span><span> {</span></div></div><div><div><div>3</div></div><div><span> </span><span>border-radius</span><span>:</span><span> </span><span>0</span><span> </span><span>0</span><span> </span><span>0.5</span><span>rem</span><span> </span><span>0.5</span><span>rem</span><span>;</span></div></div><div><div><div>4</div></div><div><span>}</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div><span>.</span><span>markdown-body</span><span> </span><span>.</span><span>highlight</span><span>,</span></div></div><div><div><div>7</div></div><div><span>.</span><span>markdown-body</span><span> </span><span>.</span><span>code-wrapper</span><span> {</span></div></div><div><div><div>8</div></div><div><span> </span><span>background-color</span><span>:</span><span> </span><span>#</span><span>e6ebf1</span><span>;</span></div></div><div><div><div>9</div></div><div><span> </span><span>border-radius</span><span>:</span><span> </span><span>0.625</span><span>rem</span><span>;</span></div></div><div><div><div>10</div></div><div> </div></div><div><div><div>11</div></div><div><span> </span><span>// 折叠图标</span></div></div><div><div><div>12</div></div><div><span> </span><span>&gt;</span><span> </span><span>i</span><span> {</span></div></div><div><div><div>13</div></div><div><span> </span><span>color</span><span>:</span><span> </span><span>#</span><span>777777</span><span>;</span></div></div><div><div><div>14</div></div><div><span> </span><span>margin-left</span><span>:</span><span> </span><span>10</span><span>px</span><span>;</span></div></div><div><div><div>15</div></div><div><span> </span><span>line-height</span><span>:</span><span> </span><span>2</span><span>rem</span><span>;</span></div></div><div><div><div>16</div></div><div><span> </span><span>transform</span><span>:</span><span> none</span><span>;</span></div></div><div><div><div>17</div></div><div><span> </span><span>transition</span><span>:</span><span> color </span><span>0.2</span><span>s</span><span> ease-in-out, transform </span><span>0.2</span><span>s</span><span> ease-in-out</span><span>;</span></div></div><div><div><div>18</div></div><div> </div></div><div><div><div>19</div></div><div><span> </span><span>// &amp;.collapsed {</span></div></div><div><div><div>20</div></div><div><span> </span><span>// transform: rotate(-90deg);</span></div></div><div><div><div>21</div></div><div><span> </span><span>// }</span></div></div><div><div><div>22</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>23</div></div><div> </div></div><div><div><div>24</div></div><div><span> </span><span>// 代码语言</span></div></div><div><div><div>25</div></div><div><span> </span><span>&gt;</span><span> </span><span>span</span><span> {</span></div></div><div><div><div>26</div></div><div><span> </span><span>color</span><span>:</span><span> </span><span>#</span><span>777777</span><span>;</span></div></div><div><div><div>27</div></div><div><span> </span><span>margin-left</span><span>:</span><span> </span><span>10</span><span>px</span><span>;</span></div></div><div><div><div>28</div></div><div><span> </span><span>font-weight</span><span>:</span><span> bold</span><span>;</span></div></div><div><div><div>29</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>30</div></div><div><span>}</span></div></div><div><div><div>31</div></div><div> </div></div><div><div><div>32</div></div><div><span>.</span><span>copy-btn</span><span> {</span></div></div><div><div><div>33</div></div><div><span> </span><span>font-size</span><span>:</span><span> </span><span>1</span><span>rem</span><span>;</span></div></div><div><div><div>34</div></div><div><span> </span><span>color</span><span>:</span><span> darkslategrey</span><span>;</span></div></div><div><div><div>35</div></div><div> </div></div><div><div><div>36</div></div><div><span> </span><span>&gt;</span><span> </span><span>i</span><span> {</span></div></div><div><div><div>37</div></div><div><span> </span><span>font-size</span><span>:</span><span> </span><span>1</span><span>rem !important</span><span>;</span></div></div><div><div><div>38</div></div><div><span> </span><span>font-weight</span><span>:</span><span> bold</span><span>;</span></div></div><div><div><div>39</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>40</div></div><div><span>}</span></div></div><div><div><div>41</div></div><div> </div></div><div><div><div>42</div></div><div><span>[</span><span>data-user-color-scheme</span><span>=</span><span>'dark'</span><span>]</span><span> {</span></div></div><div><div><div>43</div></div><div><span> </span><span>.</span><span>copy-btn</span><span> {</span></div></div><div><div><div>44</div></div><div><span> </span><span>color</span><span>:</span><span> </span><span>#</span><span>c4c6c9</span><span>;</span></div></div><div><div><div>45</div></div><div><span> </span><span>transition</span><span>:</span><span> color </span><span>0.2</span><span>s</span><span> ease-in-out</span><span>;</span></div></div><div><div><div>46</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>47</div></div><div><span>}</span></div></div><div><div><div>48</div></div><div> </div></div><div><div><div>49</div></div><div><span>[</span><span>data-user-color-scheme</span><span>=</span><span>'dark'</span><span>]</span><span> {</span></div></div><div><div><div>50</div></div><div><span> </span><span>.</span><span>markdown-body</span><span> </span><span>.</span><span>highlight</span><span>,</span></div></div><div><div><div>51</div></div><div><span> </span><span>.</span><span>markdown-body</span><span> </span><span>.</span><span>code-wrapper</span><span> {</span></div></div><div><div><div>52</div></div><div><span> </span><span>background-color</span><span>:</span><span> </span><span>#</span><span>696969</span><span>;</span></div></div><div><div><div>53</div></div><div><span> </span><span>transition</span><span>:</span><span> background-color </span><span>0.2</span><span>s</span><span> ease-in-out</span><span>;</span></div></div><div><div><div>54</div></div><div> </div></div><div><div><div>55</div></div><div><span> </span><span>&gt;</span><span> </span><span>i</span><span> {</span></div></div><div><div><div>56</div></div><div><span> </span><span>color</span><span>:</span><span> </span><span>#</span><span>c4c6c9</span><span>;</span></div></div><div><div><div>57</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>58</div></div><div> </div></div><div><div><div>59</div></div><div><span> </span><span>&gt;</span><span> </span><span>span</span><span> {</span></div></div><div><div><div>60</div></div><div><span> </span><span>color</span><span>:</span><span> </span><span>#</span><span>c4c6c9</span><span>;</span></div></div><div><div><div>61</div></div><div><span> </span><span>transition</span><span>:</span><span> color </span><span>0.2</span><span>s</span><span> ease-in-out</span><span>;</span></div></div><div><div><div>62</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>63</div></div><div><span><span> </span></span><span>}</span></div></div><div><div><div>64</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>在 <code>_config.fluid.yml</code> 中的 <code>custom_css</code> 配置项中添加：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_css</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>custom/css/code-pretty</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <h2>浏览器恶搞标签<a href="#浏览器恶搞标签">#</a></h2> <p>在 <code>source</code> 目录下新建 <code>custom/js</code> 目录，再在其中新建 <code>label-page.js</code> 文件，内容为：</p> <div><figure><figcaption><span>custom/js/label-page.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>// 浏览器搞笑标题</span></div></div><div><div><div>2</div></div><div><span>var</span><span> OriginTitle </span><span>=</span><span> document</span><span>.</span><span>title</span><span>;</span></div></div><div><div><div>3</div></div><div><span>var</span><span> titleTime</span><span>;</span></div></div><div><div><div>4</div></div><div><span>document</span><span>.</span><span>addEventListener</span><span>(</span><span>'visibilitychange'</span><span>,</span><span> </span><span>function</span><span> </span><span>()</span><span> </span><span>{</span></div></div><div><div><div>5</div></div><div><span> </span><span>if</span><span> (document</span><span>.</span><span>hidden) </span><span>{</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>document</span><span>.</span><span>title </span><span>=</span><span> </span><span>'(´;ω;｀) 你不要我了吗 - '</span><span> </span><span>+</span><span> OriginTitle</span><span>;</span></div></div><div><div><div>7</div></div><div><span> </span><span>clearTimeout</span><span>(titleTime)</span><span>;</span></div></div><div><div><div>8</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span><span> </span></span><span>document</span><span>.</span><span>title </span><span>=</span><span> OriginTitle</span><span>;</span></div></div><div><div><div>10</div></div><div><span><span> </span></span><span>titleTime </span><span>=</span><span> </span><span>setTimeout</span><span>(</span><span>function</span><span> </span><span>()</span><span> </span><span>{</span></div></div><div><div><div>11</div></div><div><span><span> </span></span><span>document</span><span>.</span><span>title </span><span>=</span><span> OriginTitle</span><span>;</span></div></div><div><div><div>12</div></div><div><span> </span><span>},</span><span> </span><span>2000</span><span>)</span><span>;</span></div></div><div><div><div>13</div></div><div><span> </span><span>}</span></div></div><div><div><div>14</div></div><div><span>}</span><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>随后在 <code>_config.fluid.yml</code> 中的 <code>custom_js</code> 配置项中添加：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_js</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>/custom/js/label-page.js</span><span> </span><span># 浏览器恶搞标题</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <h2>背景动态线条<a href="#背景动态线条">#</a></h2> <h3>简单版<a href="#简单版">#</a></h3> <p>添加<a href="https://github.com/hustcc/canvas-nest.js">背景动态线条</a>只需要在 <code>_config.fluid.yml</code> 中新增 <code>custom_html</code> 配置项并添加如下内容：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_html</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>&lt;script type="text/javascript" color="255,255,255" opacity="1.0" zIndex="-1" count="110" src="https://cdn.jsdelivr.net/npm/canvas-nest.js@1.0.1/dist/canvas-nest.js"&gt;&lt;/script&gt;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <h3>修改版<a href="#修改版">#</a></h3> <p>由于 <code>canvas-nest.js</code> 的 <code>2.0.0</code> 以后所有版本都与 Fluid 主题有冲突，而 <code>1.0.1</code> 版本不能修改点的颜色，只能修改线条颜色，因此还可以选择将 <code>1.0.1</code> 版本的 <code>js</code> 文件下载到本地进行修改。</p> <p>下载<a href="https://cdn.jsdelivr.net/npm/canvas-nest.js@1.0.1/dist/canvas-nest.js">源文件</a>到本地 <code>source/custom/js</code> 目录下，分别修改以下内容：</p> <ul> <li>在 <code>c: get_attribute(script, "color", "0,0,0"),</code> 后新增一行</li> </ul> <div><figure><figcaption><span>source/custom/js/canvas-nest.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span><span><span> </span></span><span>p</span></span><span>:</span><span> </span><span>get_attribute</span><span>(script</span><span>,</span><span> </span><span>"pointColor"</span><span>,</span><span> </span><span>"0,0,0"</span><span>)</span><span>,</span><span> </span><span>//pointColor</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <ul> <li>在<code>context.strokeStyle = "rgba(" + config.c + "," + (d + 0.2) + ")"</code> 后新增一行</li> </ul> <div><figure><figcaption><span>source/custom/js/canvas-nest.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>context</span><span>.</span><span>fillStyle </span><span>=</span><span> </span><span>"rgba("</span><span> </span><span>+</span><span> config</span><span>.</span><span>p </span><span>+</span><span> </span><span>")"</span><span>,</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>然后在 <code>_config.fluid.yml</code> 中新增 <code>custom_html</code> 配置项并添加如下内容：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_html</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>&lt;script type="text/javascript" color="255,255,255" pointColor="252,228,236" opacity="1.0" zIndex="-1" count="110" src="/custom/js/canvas-nest.js"&gt;&lt;/script&gt;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <h2>顶部阅读进度条<a href="#顶部阅读进度条">#</a></h2> <p>在 <code>source/custom/js</code> 目录下新建 <code>read-progress-bar.js</code> 文件：</p> <div><figure><figcaption><span>source/custom/js/read-progress-bar.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>document</span><span>.</span><span>addEventListener</span><span>(</span><span>'DOMContentLoaded'</span><span>,</span><span> </span><span>function</span><span> </span><span>()</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>var</span><span> winHeight </span><span>=</span><span> window</span><span>.</span><span>innerHeight</span><span>,</span></div></div><div><div><div>3</div></div><div><span><span> </span></span><span>docHeight </span><span>=</span><span> document</span><span>.</span><span>documentElement</span><span>.</span><span>scrollHeight</span><span>,</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>progressBar </span><span>=</span><span> document</span><span>.</span><span>querySelector</span><span>(</span><span>'#content_progress'</span><span>)</span><span>;</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>progressBar</span><span>.</span><span>max </span><span>=</span><span> docHeight </span><span>-</span><span> winHeight</span><span>;</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>progressBar</span><span>.</span><span>value </span><span>=</span><span> window</span><span>.</span><span>scrollY</span><span>;</span></div></div><div><div><div>7</div></div><div> </div></div><div><div><div>8</div></div><div><span><span> </span></span><span>document</span><span>.</span><span>addEventListener</span><span>(</span><span>'scroll'</span><span>,</span><span> </span><span>function</span><span> </span><span>()</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span><span> </span></span><span>progressBar</span><span>.</span><span>max </span><span>=</span><span> document</span><span>.</span><span>documentElement</span><span>.</span><span>scrollHeight </span><span>-</span><span> window</span><span>.</span><span>innerHeight</span><span>;</span></div></div><div><div><div>10</div></div><div><span><span> </span></span><span>progressBar</span><span>.</span><span>value </span><span>=</span><span> window</span><span>.</span><span>scrollY</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>12</div></div><div><span>}</span><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>再在 <code>source/custom/css</code> 目录下新建 <code>read-progress-bar.css</code> 文件：</p> <div><figure><figcaption><span>source/custom/css/read-progress-bar.css</span></figcaption><pre><code><div><div><div>1</div></div><div><span>#</span><span>content_progress</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>/* Positioning */</span></div></div><div><div><div>3</div></div><div><span> </span><span>position</span><span>:</span><span> fixed</span><span>;</span></div></div><div><div><div>4</div></div><div><span> </span><span>left</span><span>:</span><span> </span><span>0</span><span>;</span></div></div><div><div><div>5</div></div><div><span> </span><span>top</span><span>:</span><span> </span><span>0</span><span>;</span></div></div><div><div><div>6</div></div><div><span> </span><span>z-index</span><span>:</span><span> </span><span>32766</span><span>;</span></div></div><div><div><div>7</div></div><div><span> </span><span>width</span><span>:</span><span> </span><span>100%</span><span>;</span></div></div><div><div><div>8</div></div><div><span> </span><span>height</span><span>:</span><span> </span><span>6</span><span>px</span><span>;</span></div></div><div><div><div>9</div></div><div><span> </span><span>-webkit-appearance</span><span>:</span><span> none</span><span>;</span></div></div><div><div><div>10</div></div><div><span> </span><span>-moz-appearance</span><span>:</span><span> none</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span>appearance</span><span>:</span><span> none</span><span>;</span></div></div><div><div><div>12</div></div><div><span> </span><span>border</span><span>:</span><span> none</span><span>;</span></div></div><div><div><div>13</div></div><div><span> </span><span>background-color</span><span>:</span><span> transparent</span><span>;</span></div></div><div><div><div>14</div></div><div><span> </span><span>color</span><span>:</span><span> </span><span>#</span><span>ffffff80</span><span>;</span><span> </span><span>/* 使用半透明白色，适配夜间模式 */</span></div></div><div><div><div>15</div></div><div><span>}</span></div></div><div><div><div>16</div></div><div> </div></div><div><div><div>17</div></div><div><span>#</span><span>content_progress</span><span>::</span><span>-webkit-progress-bar</span><span> </span><span>{</span></div></div><div><div><div>18</div></div><div><span> </span><span>background-color</span><span>:</span><span> transparent</span><span>;</span></div></div><div><div><div>19</div></div><div><span>}</span></div></div><div><div><div>20</div></div><div> </div></div><div><div><div>21</div></div><div><span>#</span><span>content_progress</span><span>::</span><span>-webkit-progress-value</span><span> </span><span>{</span></div></div><div><div><div>22</div></div><div><span> </span><span>background-color</span><span>:</span><span> </span><span>#</span><span>ffffff80</span><span>;</span></div></div><div><div><div>23</div></div><div><span>}</span></div></div><div><div><div>24</div></div><div> </div></div><div><div><div>25</div></div><div><span>#</span><span>content_progress</span><span>::</span><span>-moz-progress-bar</span><span> </span><span>{</span></div></div><div><div><div>26</div></div><div><span> </span><span>background-color</span><span>:</span><span> </span><span>#</span><span>ffffff80</span><span>;</span></div></div><div><div><div>27</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接着在 <code>scripts</code> 目录下新建 <code>injector.js</code> 文件：</p> <div><figure><figcaption><span>scripts/injector.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>// 注入阅读进度条</span></div></div><div><div><div>2</div></div><div><span>hexo</span><span>.</span><span>extend</span><span>.</span><span>injector</span><span>.</span><span>register</span><span>(</span></div></div><div><div><div>3</div></div><div><span> </span><span>'head_begin'</span><span>,</span></div></div><div><div><div>4</div></div><div><span> </span><span>'&lt;progress id="content_progress" value="0"&gt;&lt;/progress&gt;'</span><span>,</span></div></div><div><div><div>5</div></div><div><span> </span><span>'post'</span></div></div><div><div><div>6</div></div><div><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>最后在 <code>_config.fluid.yml</code> 中的 <code>custom_js</code> 和 <code>custom_css</code> 配置项中添加：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_js</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>custom/js/read-progress-bar.js</span></div></div><div><div><div>3</div></div><div><span>custom_css</span><span>:</span></div></div><div><div><div>4</div></div><div><span> </span><span>-</span><span> </span><span>custom/css/read-progress-bar.css</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <h2>建站时间<a href="#建站时间">#</a></h2> <p>在 <code>source/custom/js</code> 目录下新建 <code>create-time.js</code> 文件：</p> <div><figure><figcaption><span>source/custom/js/create-time.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>var</span><span> now </span><span>=</span><span> </span><span>new</span><span> </span><span>Date</span><span>()</span><span>;</span></div></div><div><div><div>2</div></div><div><span>function</span><span> </span><span>createtime</span><span>()</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>var</span><span> grt </span><span>=</span><span> </span><span>new</span><span> </span><span>Date</span><span>(</span><span>'08/19/2024 12:00:00'</span><span>)</span><span>;</span><span> </span><span>//在此处修改你的建站时间，格式：月/日/年 时:分:秒</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>now</span><span>.</span><span>setTime</span><span>(now</span><span>.</span><span>getTime</span><span>() </span><span>+</span><span> </span><span>250</span><span>)</span><span>;</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>days </span><span>=</span><span> (now </span><span>-</span><span> grt) </span><span>/</span><span> </span><span>1000</span><span> </span><span>/</span><span> </span><span>60</span><span> </span><span>/</span><span> </span><span>60</span><span> </span><span>/</span><span> </span><span>24</span><span>;</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>dnum </span><span>=</span><span> Math</span><span>.</span><span>floor</span><span>(days)</span><span>;</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>hours </span><span>=</span><span> (now </span><span>-</span><span> grt) </span><span>/</span><span> </span><span>1000</span><span> </span><span>/</span><span> </span><span>60</span><span> </span><span>/</span><span> </span><span>60</span><span> </span><span>-</span><span> </span><span>24</span><span> </span><span>*</span><span> dnum</span><span>;</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>hnum </span><span>=</span><span> Math</span><span>.</span><span>floor</span><span>(hours)</span><span>;</span></div></div><div><div><div>9</div></div><div><span> </span><span>if</span><span> (</span><span>String</span><span>(hnum)</span><span>.</span><span>length </span><span>==</span><span> </span><span>1</span><span>) </span><span>{</span></div></div><div><div><div>10</div></div><div><span><span> </span></span><span>hnum </span><span>=</span><span> </span><span>'0'</span><span> </span><span>+</span><span> hnum</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span>}</span></div></div><div><div><div>12</div></div><div><span><span> </span></span><span>minutes </span><span>=</span><span> (now </span><span>-</span><span> grt) </span><span>/</span><span> </span><span>1000</span><span> </span><span>/</span><span> </span><span>60</span><span> </span><span>-</span><span> </span><span>24</span><span> </span><span>*</span><span> </span><span>60</span><span> </span><span>*</span><span> dnum </span><span>-</span><span> </span><span>60</span><span> </span><span>*</span><span> hnum</span><span>;</span></div></div><div><div><div>13</div></div><div><span><span> </span></span><span>mnum </span><span>=</span><span> Math</span><span>.</span><span>floor</span><span>(minutes)</span><span>;</span></div></div><div><div><div>14</div></div><div><span> </span><span>if</span><span> (</span><span>String</span><span>(mnum)</span><span>.</span><span>length </span><span>==</span><span> </span><span>1</span><span>) </span><span>{</span></div></div><div><div><div>15</div></div><div><span><span> </span></span><span>mnum </span><span>=</span><span> </span><span>'0'</span><span> </span><span>+</span><span> mnum</span><span>;</span></div></div><div><div><div>16</div></div><div><span> </span><span>}</span></div></div><div><div><div>17</div></div><div><span><span> </span></span><span>seconds </span><span>=</span><span> (now </span><span>-</span><span> grt) </span><span>/</span><span> </span><span>1000</span><span> </span><span>-</span><span> </span><span>24</span><span> </span><span>*</span><span> </span><span>60</span><span> </span><span>*</span><span> </span><span>60</span><span> </span><span>*</span><span> dnum </span><span>-</span><span> </span><span>60</span><span> </span><span>*</span><span> </span><span>60</span><span> </span><span>*</span><span> hnum </span><span>-</span><span> </span><span>60</span><span> </span><span>*</span><span> mnum</span><span>;</span></div></div><div><div><div>18</div></div><div><span><span> </span></span><span>snum </span><span>=</span><span> Math</span><span>.</span><span>round</span><span>(seconds)</span><span>;</span></div></div><div><div><div>19</div></div><div><span> </span><span>if</span><span> (</span><span>String</span><span>(snum)</span><span>.</span><span>length </span><span>==</span><span> </span><span>1</span><span>) </span><span>{</span></div></div><div><div><div>20</div></div><div><span><span> </span></span><span>snum </span><span>=</span><span> </span><span>'0'</span><span> </span><span>+</span><span> snum</span><span>;</span></div></div><div><div><div>21</div></div><div><span> </span><span>}</span></div></div><div><div><div>22</div></div><div><span><span> </span></span><span>document</span><span>.</span><span>getElementById</span><span>(</span><span>'timeDate'</span><span>)</span><span>.</span><span>innerHTML </span><span>=</span><span> </span><span>'本站已创建 '</span><span> </span><span>+</span><span> dnum </span><span>+</span><span> </span><span>' 天 '</span><span>;</span></div></div><div><div><div>23</div></div><div><span><span> </span></span><span>document</span><span>.</span><span>getElementById</span><span>(</span><span>'times'</span><span>)</span><span>.</span><span>innerHTML </span><span>=</span><span> hnum </span><span>+</span><span> </span><span>' 小时 '</span><span> </span><span>+</span><span> mnum </span><span>+</span><span> </span><span>' 分 '</span><span> </span><span>+</span><span> snum </span><span>+</span><span> </span><span>' 秒'</span><span>;</span></div></div><div><div><div>24</div></div><div><span>}</span></div></div><div><div><div>25</div></div><div><span>setInterval</span><span>(</span><span>'createtime()'</span><span>,</span><span> </span><span>250</span><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>在 <code>_config.fluid.yml</code> 中的 <code>custom_js</code> 配置项中添加：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_js</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>custom/js/create-time.js</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>最后在 <code>_config.fluid.yml</code> 中修改 <code>footer/content</code> 配置项，新增一行</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>&lt;</span><span>br</span><span> </span><span>/&gt;&lt;</span><span>span</span><span> </span><span>id</span><span>=</span><span>"timeDate"</span><span>&gt;</span><span>天数载入中</span><span>&lt;/</span><span>span</span><span>&gt;&lt;</span><span>span</span><span> </span><span>id</span><span>=</span><span>"times"</span><span>&gt;</span><span>...</span><span>&lt;/</span><span>span</span><span>&gt;&lt;</span><span>br</span><span> </span><span>/&gt;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>即将 <code>footer/content</code> 配置项修改为如下形式：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>footer</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>content</span><span>:</span><span> </span><span>'</span></div></div><div><div><div>3</div></div><div><span><span> </span></span><span>&lt;a href="https://hexo.io" target="_blank" rel="nofollow noopener"&gt;&lt;span&gt;Hexo&lt;/span&gt;&lt;/a&gt;</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>&lt;i class="iconfont icon-love"&gt;&lt;/i&gt;</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>&lt;a href="https://github.com/fluid-dev/hexo-theme-fluid" target="_blank" rel="nofollow noopener"&gt;&lt;span&gt;Fluid&lt;/span&gt;&lt;/a&gt;</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>&lt;br&gt;&lt;span id="timeDate"&gt;天数载入中&lt;/span&gt;&lt;span id="times"&gt;...&lt;/span&gt;&lt;br&gt;</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>'</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <h2>随机文章跳转<a href="#随机文章跳转">#</a></h2> <p>该方法需要先生成 sitemap，可以参考<a href="/posts/how-to-build-blog-with-hexo/">我的另一篇文章</a>。</p> <p>先在 <code>source/custom/js</code> 目录下新建 <code>random-post.js</code> 文件：</p> <div><figure><figcaption><span>source/custom/js/random-post.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>function</span><span> </span><span>randomPost</span><span>()</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>fetch</span><span>(</span><span>'/sitemap.xml'</span><span>)</span></div></div><div><div><div>3</div></div><div><span> </span><span>.</span><span>then</span><span>(</span><span>(</span><span>res</span><span>)</span><span> </span><span>=&gt;</span><span> res</span><span>.</span><span>text</span><span>())</span></div></div><div><div><div>4</div></div><div><span> </span><span>.</span><span>then</span><span>(</span><span>(</span><span>str</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>new</span><span> window</span><span>.</span><span>DOMParser</span><span>()</span><span>.</span><span>parseFromString</span><span>(str</span><span>,</span><span> </span><span>'text/xml'</span><span>))</span></div></div><div><div><div>5</div></div><div><span> </span><span>.</span><span>then</span><span>(</span><span>(</span><span>data</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>6</div></div><div><span> </span><span>let</span><span> ls </span><span>=</span><span> data</span><span>.</span><span>querySelectorAll</span><span>(</span><span>'url loc'</span><span>)</span><span>;</span></div></div><div><div><div>7</div></div><div><span> </span><span>let</span><span> locationHref</span><span>,</span><span> locSplit</span><span>;</span></div></div><div><div><div>8</div></div><div><span> </span><span>do</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span><span> </span></span><span>locationHref </span><span>=</span><span> ls[Math</span><span>.</span><span>floor</span><span>(Math</span><span>.</span><span>random</span><span>() </span><span>*</span><span> ls</span><span>.</span><span>length)]</span><span>.</span><span>innerHTML</span><span>;</span></div></div><div><div><div>10</div></div><div><span><span> </span></span><span>locSplit </span><span>=</span><span> locationHref</span><span>.</span><span>split</span><span>(</span><span>'/'</span><span>)[</span><span>3</span><span>] </span><span>||</span><span> </span><span>''</span><span>;</span></div></div><div><div><div>11</div></div><div><span> </span><span>// } while (locSplit == '' || locSplit == 'tags');</span></div></div><div><div><div>12</div></div><div><span> </span><span>//若所有文章都如 https://…….com/posts/2022/07/…… 格式，主域名后字符是 posts，则循环条件改为：</span></div></div><div><div><div>13</div></div><div><span> </span><span>}</span><span> </span><span>while</span><span> (locSplit </span><span>!==</span><span> </span><span>'posts'</span><span>)</span><span>;</span></div></div><div><div><div>14</div></div><div><span><span> </span></span><span>location</span><span>.</span><span>href </span><span>=</span><span> locationHref</span><span>;</span></div></div><div><div><div>15</div></div><div><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>16</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>在 <code>_config.fluid.yml</code> 中的 <code>custom_js</code> 配置项中添加：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_js</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>custom/js/random-post.js</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>随后在喜欢的位置放上 <code>javascript:randomPost();</code> 的跳转链接，例如在导航栏：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>menu</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>key</span><span>:</span><span> </span><span>'random'</span><span>,</span></div></div><div><div><div>4</div></div><div><span> </span><span>name</span><span>:</span><span> </span><span>'随机文章'</span><span>,</span></div></div><div><div><div>5</div></div><div><span> </span><span>link</span><span>:</span><span> </span><span>'javascript:randomPost();'</span><span>,</span></div></div><div><div><div>6</div></div><div><span> </span><span>icon</span><span>:</span><span> </span><span>'iconfont icon-random'</span><span>,</span></div></div><div><div><div>7</div></div><div><span> </span><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>使用 <code>hexo cl</code> + <code>hexo d -g</code> 重新生成并部署即可。</p> <blockquote> <div><span>tip</span></div> <div> <p>以上代码中 <code>icon: "iconfont icon-random"</code> 使用了我自己的 Iconfont 图标库而非<a href="https://hexo.fluid-dev.com/docs/icon/">主题内置 Iconfont 图标库</a>，有需要请自行到 <a href="https://www.iconfont.cn/">Iconfont</a> 创建自己的图标库。</p> </div> </blockquote> <h2>新增标签语法<a href="#新增标签语法">#</a></h2> <p>参看<a href="/posts/a0486011">另一篇文章</a></p> <h2>参考资料<a href="#参考资料">#</a></h2> <p>本篇文章内容参考了类似的大量文章内容，特此感谢（排名不分先后）</p> <ul> <li><a href="https://zeyulong.com/posts/3edad46f">Hexo博客美化 - 龙泽雨的博客</a></li> <li><a href="https://wakutsu0223.top/2023/02/24/Hexo-Fluid%E6%90%AD%E5%BB%BA%E4%B8%8E%E9%AD%94%E6%94%B9%E7%BA%AA%E5%BD%95">Hexo-Fluid搭建与魔改纪录 - 弥冬のBlog</a></li> <li><a href="https://www.eurekady.com/article/Fluid/e3b7f02954e5">Hexo-3-Fluid主题魔改 - 遥望</a></li> <li><a href="https://blog.kevinchu.top/2023/07/17/hexo-theme-fluid-modify">Hexo博客Fluid主题魔改记录 - KEVIN’S BLOG</a></li> <li><a href="https://www.cnblogs.com/qq597585136/p/7019755.html">网页动态背景——随鼠标变换的动态线条 - 孤独的飞行者 - 博客园</a></li> <li><a href="https://github.com/fluid-dev/hexo-theme-fluid/issues/1051">建议添加“文章时效性”提示 · Issue #1051 · fluid-dev/hexo-theme-fluid</a></li> <li><a href="https://kiyanyang.github.io/posts/f92be1eb/">Hexo-Fluid 博客美化和修改 | Kiyan’s Blog</a></li> <li><a href="https://kiyanyang.github.io/posts/c4dd4019/">使用 Hexo 过滤器实现 Fluid 主题的代码折叠 | Kiyan’s Blog</a></li> <li><a href="https://immmmm.com/randompost-by-sitemap/">利用 SiteMap 随机访问站内页面：：木木木木木</a></li> </ul> </article> https://blog.hpcesia.com/posts/kmp-algorithm-notes/https://blog.hpcesia.com/posts/kmp-algorithm-notes/考研复习数据结构的 KMP 算法的笔记。Thu, 22 Aug 2024 04:02:34 GMT<article> <blockquote> <div><span>note</span></div> <div> <p>本文基于考研 408 的 KMP 算法编写。</p> </div> </blockquote> <p>KMP 算法核心思想：<strong>主字符串指针只进不退</strong></p> <h2>KMP 匹配算法<a href="#kmp-匹配算法">#</a></h2> <p>这个比较简单，基于 <code>next</code> 数组进行计算即可。</p> <p>匹配使用双指针进行，主字符串的指针只进不退，当模式串指针指向的字符与主字符串指针指向的字符匹配时，两个指针一起 +1；当模式串的某个字符不匹配时，则根据 <code>next</code> 数组中的对应值，将模式串指针移动到相应的地方。直接看代码更简单：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>std</span><span>::</span><span>optional</span><span>&lt;</span><span>size_t</span><span>&gt;</span><span> </span><span>kmpMatch</span><span>(</span><span>const</span><span> </span><span>std</span><span>::</span><span>string</span><span>&amp;</span><span> </span><span>str</span><span>,</span><span> </span><span>const</span><span> </span><span>std</span><span>::</span><span>string</span><span>&amp;</span><span> </span><span>pattern</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>if</span><span> </span><span>(</span><span>pattern</span><span>.</span><span>empty</span><span>())</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>return</span><span> </span><span>0</span><span>;</span></div></div><div><div><div>4</div></div><div><span> </span><span>}</span></div></div><div><div><div>5</div></div><div><span> </span><span>std</span><span>::</span><span>vector</span><span>&lt;</span><span>size_t</span><span>&gt;</span><span> next </span><span>=</span><span> </span><span>generateNext</span><span>(</span><span>pattern</span><span>);</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>// pattern无符号，需要额外+1来处理首字符不匹配的情况</span></div></div><div><div><div>7</div></div><div><span> </span><span>size_t</span><span> str_ptr </span><span>=</span><span> </span><span>0</span><span>,</span><span> pattern_ptr </span><span>=</span><span> </span><span>1</span><span>;</span></div></div><div><div><div>8</div></div><div><span> </span><span>while</span><span> </span><span>(</span><span>str_ptr </span><span>&lt;</span><span> str</span><span>.</span><span>size</span><span>()</span><span> </span><span>&amp;&amp;</span><span> pattern_ptr </span><span>&lt;=</span><span> pattern</span><span>.</span><span>size</span><span>())</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span> </span><span>if</span><span> </span><span>(</span><span>pattern_ptr </span><span>==</span><span> </span><span>0</span><span> </span><span>||</span><span> str</span><span>[</span><span>str_ptr</span><span>]</span><span> </span><span>==</span><span> pattern</span><span>[</span><span>pattern_ptr </span><span>-</span><span> </span><span>1</span><span>])</span><span> </span><span>{</span></div></div><div><div><div>10</div></div><div><span><span> </span></span><span>// 匹配时，指针都后移</span></div></div><div><div><div>11</div></div><div><span><span> </span></span><span>str_ptr</span><span>++</span><span>;</span></div></div><div><div><div>12</div></div><div><span><span> </span></span><span>pattern_ptr</span><span>++</span><span>;</span></div></div><div><div><div>13</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>14</div></div><div><span><span> </span></span><span>// 不匹配时，模式串指针回到next数组中对应位置</span></div></div><div><div><div>15</div></div><div><span><span> </span></span><span>pattern_ptr </span><span>=</span><span> next</span><span>[</span><span>pattern_ptr </span><span>-</span><span> </span><span>1</span><span>];</span></div></div><div><div><div>16</div></div><div><span> </span><span>}</span></div></div><div><div><div>17</div></div><div><span> </span><span>}</span></div></div><div><div><div>18</div></div><div><span> </span><span>if</span><span> </span><span>(</span><span>pattern_ptr </span><span>&gt;</span><span> pattern</span><span>.</span><span>size</span><span>())</span><span> </span><span>{</span></div></div><div><div><div>19</div></div><div><span><span> </span></span><span>// 匹配成功，返回匹配的首个字符位置</span></div></div><div><div><div>20</div></div><div><span> </span><span>return</span><span> str_ptr </span><span>-</span><span> </span><span>(</span><span>pattern_ptr </span><span>-</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>21</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>22</div></div><div><span><span> </span></span><span>// 匹配失败，返回空</span></div></div><div><div><div>23</div></div><div><span> </span><span>return</span><span> </span><span>{};</span></div></div><div><div><div>24</div></div><div><span> </span><span>}</span></div></div><div><div><div>25</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h2>KMP next 数组生成算法<a href="#kmp-next-数组生成算法">#</a></h2> <p>这个才是重中之重。先上算法代码：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>std</span><span>::</span><span>vector</span><span>&lt;</span><span>size_t</span><span>&gt;</span><span> </span><span>generateNext</span><span>(</span><span>const</span><span> </span><span>std</span><span>::</span><span>string</span><span>&amp;</span><span> </span><span>pattern</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>std</span><span>::</span><span>vector</span><span>&lt;</span><span>size_t</span><span>&gt;</span><span> </span><span>next</span><span>(</span><span>pattern</span><span>.</span><span>size</span><span>(),</span><span> </span><span>0</span><span>);</span></div></div><div><div><div>3</div></div><div><span> </span><span>for</span><span> </span><span>(</span><span>size_t</span><span> i </span><span>=</span><span> </span><span>0</span><span>,</span><span> j </span><span>=</span><span> </span><span>0</span><span>;</span><span> i </span><span>&lt;</span><span> next</span><span>.</span><span>size</span><span>()</span><span> </span><span>-</span><span> </span><span>1</span><span>;)</span><span> </span><span>{</span></div></div><div><div><div>4</div></div><div><span> </span><span>if</span><span> </span><span>(</span><span>j </span><span>==</span><span> </span><span>0</span><span> </span><span>||</span><span> pattern</span><span>[</span><span>i</span><span>]</span><span> </span><span>==</span><span> pattern</span><span>[</span><span>j </span><span>-</span><span> </span><span>1</span><span>])</span><span> </span><span>{</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>next</span><span>[</span><span>i </span><span>+</span><span> </span><span>1</span><span>]</span><span> </span><span>=</span><span> </span><span>++</span><span>j</span><span>;</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>i</span><span>++</span><span>;</span></div></div><div><div><div>7</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>j </span><span>=</span><span> next</span><span>[</span><span>j </span><span>-</span><span> </span><span>1</span><span>];</span></div></div><div><div><div>9</div></div><div><span> </span><span>}</span></div></div><div><div><div>10</div></div><div><span> </span><span>}</span></div></div><div><div><div>11</div></div><div><span> </span><span>return</span><span> next</span><span>;</span></div></div><div><div><div>12</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>以下为叙述方便起见，采用类似 MATLAB 的 <code>str[a:b]</code> 的形式来表示 <code>str.substr(a, b - a)</code> 这一子串。</p> <p>算法的输出 <code>next</code> 数组中，<code>next[i]</code> 对应的是 <code>pattern[0:i - 1]</code> 的最长公共前后缀长度 +1。算法的循环可以看作两个部分，一个部分是递增 <code>i</code>，而另一个循环则是移动 <code>j</code> 来找到 <code>pattern[0:i]</code> 的最长公共前后缀长度，所以每次 <code>i++</code> 后，<code>j</code> 都表示 <code>pattern[0:i - 1]</code> 的最长公共前后缀长度 +1(因为 <code>j</code> 也跟着递增了)。</p> <p>着重考虑第二个循环，即 <code>i++</code> 后移动 <code>j</code> 的部分。循环开始时，比较 <code>pattern[0:i]</code> 后缀的最后一个字符，即 <code>pattern[i]</code> ，与 <code>pattern[0:i - 1]</code> 的最长公共前后缀所对应前缀的下一个字符，即 <code>pattern[j - 1]</code> 是否相等。</p> <p>如果相等，就说明 <code>pattern[0:i]</code> 的最长公共前后缀为 <code>pattern[0:j - 1]</code> 和 <code>pattern[i - j:i]</code>，因为 <code>pattern[0:i - 1]</code> 的最长公共前后缀恰为 <code>pattern[0:j - 2]</code> 和 <code>pattern[i - j:i - 1]</code>。</p> <p>如果不相等，则回退 <code>j</code>。这是因为 <code>pattern[0:j - 2] == pattern[i - j:i - 1]</code>，而 <code>next[j - 1]</code> 就是 <code>pattern[0:j - 2]</code> 的最大公共前后缀长度 +1，也是 <code>pattern[i - j:i - 1]</code> 的最大公共前后缀长度 +1，所以要把 <code>j</code> 回退到 <code>next[j - 1]</code>。</p> <p>换句话来说，第二个循环就是利用已经计算好的公共前后缀长度与前后缀相同的性质，按顺序不断尝试寻找最长的公共前后缀，如果发现前后缀不匹配，就回退到次长公共前后缀继续尝试寻找，直到 <code>j</code> 回退到 <code>pattern[0]</code>，也就是找不到任何公共前后缀时循环结束，递增 <code>i</code>。</p> <h2>KMP nextval 数组<a href="#kmp-nextval-数组">#</a></h2> <p>在 KMP 的匹配算法中，如果 <code>pattern[i]</code> 失配，则模式串指针回退到 <code>next[i] - 1</code> 处。但如果 <code>pattern[i] = pattern[next[i] - 1]</code>，那回退后进行的下一次匹配一定是失配的，还要继续回退，相当于进行了一次无用的匹配。</p> <p><code>nextval</code> 就是用来解决这个问题的，在计算出 <code>next</code> 数组后，再遍历 <code>next</code> 数组做一次修改，如果 <code>pattern[i] = pattern[next[i] - 1]</code>，就让 <code>next[i] = next[next[i] - 1]</code>，省去一次无用的跳转。</p> <p>算法代码如下：</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>void</span><span> </span><span>generateNextval</span><span>(</span><span>const</span><span> </span><span>std</span><span>::</span><span>string</span><span>&amp;</span><span> </span><span>pattern</span><span>,</span><span> </span><span>std</span><span>::</span><span>vector</span><span>&lt;</span><span>size_t</span><span>&gt;</span><span>&amp;</span><span> </span><span>next</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>if</span><span> </span><span>(</span><span>next</span><span>.</span><span>size</span><span>()</span><span> </span><span>==</span><span> </span><span>0</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>return</span><span>;</span></div></div><div><div><div>4</div></div><div><span> </span><span>}</span></div></div><div><div><div>5</div></div><div><span> </span><span>for</span><span> </span><span>(</span><span>size_t</span><span> i </span><span>=</span><span> </span><span>1</span><span>;</span><span> i </span><span>&lt;</span><span> pattern</span><span>.</span><span>size</span><span>();</span><span> </span><span>++</span><span>i</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>6</div></div><div><span> </span><span>if</span><span> </span><span>(</span><span>pattern</span><span>[</span><span>i</span><span>]</span><span> </span><span>==</span><span> pattern</span><span>[</span><span>next</span><span>[</span><span>i</span><span>]</span><span> </span><span>-</span><span> </span><span>1</span><span>])</span><span> </span><span>{</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>next</span><span>[</span><span>i</span><span>]</span><span> </span><span>=</span><span> next</span><span>[</span><span>next</span><span>[</span><span>i</span><span>]</span><span> </span><span>-</span><span> </span><span>1</span><span>];</span></div></div><div><div><div>8</div></div><div><span> </span><span>}</span></div></div><div><div><div>9</div></div><div><span> </span><span>}</span></div></div><div><div><div>10</div></div><div><span> </span><span>return</span><span>;</span></div></div><div><div><div>11</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> </article> https://blog.hpcesia.com/posts/how-to-build-blog-with-hexo/https://blog.hpcesia.com/posts/how-to-build-blog-with-hexo/简单记录了自己使用 Hexo 搭建博客的经验。Wed, 21 Aug 2024 08:23:00 GMT<article> <div><div>更新日志</div><div><ul> <li>2024-11-14 <ul> <li>更新了 gulp 压缩使用的脚本。</li> </ul> </li> <li>2024-10-28 <ul> <li>新增「域名」相关内容。</li> </ul> </li> <li>2024-09-03 <ul> <li>迁移「添加网站到搜索引擎」部分到<a href="/posts/hexo-blog-search-engine-indexing/">另一篇文章</a>。</li> <li>规范了更新日志格式。</li> </ul> </li> <li>2024-08-30 <ul> <li>更新了「数学公式渲染」、「搜索引擎」、「评论系统」的部分内容。</li> </ul> </li> <li>2024-08-28 <ul> <li>更新了「数学公式渲染」相关内容。</li> </ul> </li> <li>2024-08-27 <ul> <li>新增「优化博客性能」相关内容。</li> </ul> </li> <li>2024-08-26 <ul> <li>新增「添加 RSS 订阅」相关内容。</li> </ul> </li> <li>2024-08-25 <ul> <li>新增「添加网站到搜索引擎」相关内容。</li> </ul> </li> <li>2024-08-24 <ul> <li>新增「字体修改」与「启用评论数学公式」相关内容。</li> </ul> </li> <li>2024-08-21 <ul> <li>发布文章。</li> </ul> </li> </ul></div></div> <blockquote> <div><span>note</span></div> <div> <p>为了方便自己以后更换电脑后重新配置这个博客，以及日常调试，在此将自己的建站经验记录下来。</p> <p>本文仅适用于 Windows 平台。</p> </div> </blockquote> <h2>环境搭建<a href="#环境搭建">#</a></h2> <h3>前置环境<a href="#前置环境">#</a></h3> <h4>Node.js &amp; npm<a href="#nodejs--npm">#</a></h4> <p>在终端中执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>node</span><span> </span><span>-v</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>检查当前环境是否安装 Node.js 以及当前的版本号，若未安装，需要在<a href="https://nodejs.cn/en/download">官网</a>上下载并安装。Node.js 默认配置了 npm，因此不需要额外下载。</p> <p>此外，中国大陆地区使用 npm 需要配置淘宝的镜像源：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>config</span><span> </span><span>set</span><span> </span><span>registry</span><span> </span><span>https://registry.npmmirror.com</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h4>Git<a href="#git">#</a></h4> <p>在<a href="https://git-scm.com/download/win">官网</a>上下载 Windows 版本的 Git 安装包并安装。</p> <h3>Hexo<a href="#hexo">#</a></h3> <h4>安装<a href="#安装">#</a></h4> <p>在终端中执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>hexo-cli</span><span> </span><span>-g</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>进行 Hexo 的安装操作，在终端中执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>hexo</span><span> </span><span>-version</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>出现版本号即说明安装成功。</p> <h2>本地建站<a href="#本地建站">#</a></h2> <h3>初始化<a href="#初始化">#</a></h3> <p>新建一个用于存储博客数据的目录(如<code>D:\Blog</code>)并确保该目录为空，随后在终端中执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>cd</span><span> </span><span>D:</span><span>\B</span><span>log</span></div></div><div><div><div>2</div></div><div><span>hexo</span><span> </span><span>init</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>等待一段时间，即可成功初始化。此时可使用</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>hexo</span><span> </span><span>s</span><span> </span><span>-g</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>来本地预览初始化成功的博客。</p> <h3>GitHub 部署<a href="#github-部署">#</a></h3> <p>注册 <a href="https://github.com/">GitHub</a> 账号部分不进行叙述，请参考网上教程。</p> <p>首先打开根目录下站点配置文件 <code>_config.yml</code>，配置有关 <code>deploy</code> 的部分：</p> <div><figure><figcaption><span>_config.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>## Deployment</span></div></div><div><div><div>2</div></div><div><span>### Docs: https://hexo.io/docs/one-command-deployment</span></div></div><div><div><div>3</div></div><div><span>deploy</span><span>:</span></div></div><div><div><div>4</div></div><div><span> </span><span>type</span><span>:</span><span> </span><span>'git'</span></div></div><div><div><div>5</div></div><div><span> </span><span>repo</span><span>:</span><span> </span><span>git@github.com:用户名/用户名.github.io.git</span></div></div><div><div><div>6</div></div><div><span> </span><span>branch</span><span>:</span><span> </span><span>master</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>同时在博客根目录下终端执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>$</span><span> </span><span>npm</span><span> </span><span>install</span><span> </span><span>hexo-deployer-git</span><span> </span><span>--save</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>安装部署插件。然后终端执行</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>hexo</span><span> </span><span>d</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>即可部署到 GitHub 上。打开上面输入的对应的 <code>用户名.github.io</code> 网站，如果能看到和 <code>hexo s</code> 一样的网站界面，就说明部署成功。</p> <h2>更多配置<a href="#更多配置">#</a></h2> <p>这部分是我自己的博客配置，仅供参考。</p> <h3>短永久链接<a href="#短永久链接">#</a></h3> <p>Hexo 默认的永久地址格式是 <code>YYYY/MM/DD/title</code>，如果标题为中文，那就是灾难性的链接长度，因此需要更换更短的永久链接。</p> <p>本站使用了 <a href="https://github.com/ohroy/hexo-abbrlink"><code>hexo-abbrlink</code></a> 插件固定博文的地址。附上我自己在 <code>_config.yml</code> 中的配置，仅供参考。</p> <div><figure><figcaption><span>_config.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>## abbrlink config</span></div></div><div><div><div>2</div></div><div><span>abbrlink</span><span>:</span></div></div><div><div><div>3</div></div><div><span> </span><span>alg</span><span>:</span><span> </span><span>crc32</span><span> </span><span>#support crc16(default) and crc32</span></div></div><div><div><div>4</div></div><div><span> </span><span>rep</span><span>:</span><span> </span><span>hex</span><span> </span><span>#support dec(default) and hex</span></div></div><div><div><div>5</div></div><div><span> </span><span>drafts</span><span>:</span><span> </span><span>false</span><span> </span><span>#(true)Process draft,(false)Do not process draft. false(default)</span></div></div><div><div><div>6</div></div><div><span> </span><span># Generate categories from directory-tree</span></div></div><div><div><div>7</div></div><div><span> </span><span># depth: the max_depth of directory-tree you want to generate, should &gt; 0</span></div></div><div><div><div>8</div></div><div><span> </span><span>auto_category</span><span>:</span></div></div><div><div><div>9</div></div><div><span> </span><span>enable</span><span>:</span><span> </span><span>true</span><span> </span><span>#true(default)</span></div></div><div><div><div>10</div></div><div><span> </span><span>depth</span><span>:</span><span> </span><span>3</span><span> </span><span>#3(default)</span></div></div><div><div><div>11</div></div><div><span> </span><span>over_write</span><span>:</span><span> </span><span>false</span></div></div><div><div><div>12</div></div><div><span> </span><span>auto_title</span><span>:</span><span> </span><span>false</span><span> </span><span>#enable auto title, it can auto fill the title by path</span></div></div><div><div><div>13</div></div><div><span> </span><span>auto_date</span><span>:</span><span> </span><span>false</span><span> </span><span>#enable auto date, it can auto fill the date by time today</span></div></div><div><div><div>14</div></div><div><span> </span><span>force</span><span>:</span><span> </span><span>false</span><span> </span><span>#enable force mode,in this mode, the plugin will ignore the cache, and calc the abbrlink for every post even it already had abbrlink. This only updates abbrlink rather than other front variables.</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <h3>主题<a href="#主题">#</a></h3> <p>可以在 Hexo 官网的<a href="https://hexo.io/themes/">主题列表</a>里选择心仪的主题进行更换，并参考主题的配置说明进行配置。</p> <blockquote> <div><span>caution</span></div> <div> <p>本博客已更换至 <a href="https://solitude.js.org/zh/">Solitude</a> 主题 <a href="https://github.com/HPCesia/astral-halo">astral-halo</a> 主题，以下 Fluid 主题相关内容仅供参考。</p> </div> </blockquote> <p>本博客使用 <a href="https://hexo.fluid-dev.com/">Fluid</a> 主题。</p> <h4>站名与图标<a href="#站名与图标">#</a></h4> <p>按照 <a href="https://hexo.fluid-dev.com/docs/start/">Fluid 官方配置文档</a>安装 Fluid 主题后，先在 <code>_config.yml</code> 中修改主站名、描述和网站语言</p> <div><figure><figcaption><span>_config.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>## Site</span></div></div><div><div><div>2</div></div><div><span>title</span><span>:</span><span> </span><span>HPCesia 的摆烂小屋</span></div></div><div><div><div>3</div></div><div><span>subtitle</span><span>:</span><span> </span><span>''</span></div></div><div><div><div>4</div></div><div><span>description</span><span>:</span><span> </span><span>'记录自己的摆烂日常与学习记录'</span></div></div><div><div><div>5</div></div><div><span>keywords</span><span>:</span></div></div><div><div><div>6</div></div><div><span>author</span><span>:</span><span> </span><span>HPCesia</span></div></div><div><div><div>7</div></div><div><span>language</span><span>:</span></div></div><div><div><div>8</div></div><div><span> </span><span>-</span><span> </span><span>zh-CN</span></div></div><div><div><div>9</div></div><div><span> </span><span>-</span><span> </span><span>zh-TW</span></div></div><div><div><div>10</div></div><div><span>timezone</span><span>:</span><span> </span><span>'Asia/Shanghai'</span><span> </span><span># 这个默认是主机时区，不用管</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>然后可以顺便在 <code>_config.fluid.yml</code> 中修改一下网站图标。</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>## 用于浏览器标签的图标</span></div></div><div><div><div>2</div></div><div><span>## Icon for browser tab</span></div></div><div><div><div>3</div></div><div><span>favicon</span><span>:</span><span> </span><span>/img/fluid.png</span></div></div><div><div><div>4</div></div><div> </div></div><div><div><div>5</div></div><div><span>## 用于苹果设备的图标</span></div></div><div><div><div>6</div></div><div><span>## Icon for Apple touch</span></div></div><div><div><div>7</div></div><div><span>apple_touch_icon</span><span>:</span><span> </span><span>/img/fluid.png</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>这里建议将新图标放在 <code>./source</code> 文件夹中，在生成过程中会与主题自带的文件进行合并。</p> <h4>字体<a href="#字体">#</a></h4> <p>本博客使用<a href="https://github.com/lxgw/LxgwWenKai">霞鹜文楷</a>字体，如需配置其他字体，请参考<a href="https://hexo.fluid-dev.com/docs/guide/#%E5%85%A8%E5%B1%80%E5%AD%97%E4%BD%93">主题配置指南</a></p> <p>在 <code>_config.fluid.yml</code> 中搜索 <code>font_family</code> 即可找到字体配置</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>font</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>font_size</span><span>:</span><span> </span><span>16px</span></div></div><div><div><div>3</div></div><div><span> </span><span>font_family</span><span>:</span></div></div><div><div><div>4</div></div><div><span> </span><span>letter_spacing</span><span>:</span><span> </span><span>0.02em</span></div></div><div><div><div>5</div></div><div><span> </span><span>code_font_size</span><span>:</span><span> </span><span>85%</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>在 <code>font_family</code> 后面添加 <code>"LXGW WenKai Screen"</code>，并在 <code>_config.fluid.yml</code> 中的 <code>custom_css</code> 下添加<a href="https://github.com/CMBill/lxgw-wenkai-screen-web">霞鹜文楷屏幕阅读版网络字体仓库</a>中给出的链接：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_css</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>https://cdn.jsdelivr.net/npm/lxgw-wenkai-screen-web/style.css</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>再使用 <code>hexo clean</code> + <code>hexo g</code>，即可更换字体。</p> <h4>头图<a href="#头图">#</a></h4> <p>在 <code>_config.fluid.yml</code> 中搜索 <code>banner_img</code> 即可找到各页面的头图配置。由于大陆访问 GitHub 的速度相当便秘，头图应该使用 <code>.webp</code> 格式进行高度压缩，以在质量不太拉胯的前提下加快加载速度。</p> <h4>数学公式<a href="#数学公式">#</a></h4> <p>本博客使用 mathjax 进行数学公式渲染，参考<a href="https://hexo.fluid-dev.com/docs/guide/#latex-%E6%95%B0%E5%AD%A6%E5%85%AC%E5%BC%8F">主题配置指南</a>进行了相应配置。</p> <div><div>如果你想用 KaTeX</div><div><p>KaTeX 使用的 <code>hexo-markdown-it</code> 渲染引擎会与 <code>tocbot</code> 冲突，导致侧边栏一级目录跳转失效，经排查发现是一级标题对应的 <code>&lt;h1&gt;</code> 没有 <code>id</code> 导致的</p><p><strong>解决方案</strong>：在 <code>scripts</code> 目录下新建 <code>hexo-markdown-it-bugfix.js</code> 文件：</p><div><figure><figcaption><span>scripts/hexo-markdown-it-bugfix.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>hexo</span><span>.</span><span>extend</span><span>.</span><span>filter</span><span>.</span><span>register</span><span>(</span><span>'after_post_render'</span><span>,</span><span> </span><span>(</span><span>post</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>if</span><span> (post</span><span>.</span><span>content) </span><span>{</span></div></div><div><div><div>3</div></div><div><span> </span><span>const</span><span> uniqueIdStore </span><span>=</span><span> </span><span>{};</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>post</span><span>.</span><span>content </span><span>=</span><span> post</span><span>.</span><span>content</span><span>.</span><span>replace</span><span>(</span><span>/</span><span>&lt;h1&gt;(</span><span>.</span><span>*?</span><span>)&lt;</span><span>\/</span><span>h1&gt;</span><span>/</span><span>g</span><span>,</span><span> </span><span>function</span><span> </span><span>(</span><span>match</span><span>,</span><span> </span><span>p1</span><span>)</span><span> </span><span>{</span></div></div><div><div><div>5</div></div><div><span> </span><span>const</span><span> cleanId </span><span>=</span><span> p1</span><span>.</span><span>trim</span><span>()</span><span>.</span><span>toLowerCase</span><span>()</span><span>.</span><span>replace</span><span>(</span><span>/\s</span><span>+</span><span>/</span><span>g</span><span>,</span><span> </span><span>'-'</span><span>)</span><span>.</span><span>replace</span><span>(</span><span>/</span><span>[</span><span>?#&amp;</span><span>]</span><span>/</span><span>g</span><span>,</span><span> </span><span>''</span><span>)</span><span>;</span></div></div><div><div><div>6</div></div><div><span> </span><span>let</span><span> uniqueId </span><span>=</span><span> cleanId</span><span>;</span></div></div><div><div><div>7</div></div><div><span> </span><span>if</span><span> (cleanId </span><span>===</span><span> </span><span>''</span><span>) </span><span>{</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>uniqueId </span><span>=</span><span> </span><span>'default'</span><span>;</span></div></div><div><div><div>9</div></div><div><span> </span><span>}</span></div></div><div><div><div>10</div></div><div><span> </span><span>if</span><span> (uniqueIdStore[cleanId]) </span><span>{</span></div></div><div><div><div>11</div></div><div><span><span> </span></span><span>uniqueId </span><span>=</span><span> </span><span>`</span><span>${</span><span>cleanId</span><span>}</span><span>-</span><span>${</span><span>uniqueIdStore</span><span>[</span><span>cleanId</span><span>]</span><span>}</span><span>`</span><span>;</span></div></div><div><div><div>12</div></div><div><span><span> </span></span><span>uniqueIdStore[cleanId] </span><span>+=</span><span> </span><span>1</span><span>;</span></div></div><div><div><div>13</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>14</div></div><div><span><span> </span></span><span>uniqueIdStore[cleanId] </span><span>=</span><span> </span><span>1</span><span>;</span></div></div><div><div><div>15</div></div><div><span> </span><span>}</span></div></div><div><div><div>16</div></div><div><span> </span><span>if</span><span> (</span><span>!</span><span>/</span><span>&lt;h1 id="</span><span>.</span><span>*?</span><span>"&gt;</span><span>/</span><span>.</span><span>test</span><span>(match)) </span><span>{</span></div></div><div><div><div>17</div></div><div><span> </span><span>return</span><span> </span><span>`&lt;h1 id="</span><span>${</span><span>uniqueId</span><span>}</span><span>"&gt;</span><span>${</span><span>p1</span><span>}</span><span>&lt;/h1&gt;`</span><span>;</span></div></div><div><div><div>18</div></div><div><span> </span><span>}</span></div></div><div><div><div>19</div></div><div><span> </span><span>return</span><span> match</span><span>;</span></div></div><div><div><div>20</div></div><div><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>21</div></div><div><span> </span><span>}</span></div></div><div><div><div>22</div></div><div><span>}</span><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>效果是为没有添加 <code>id</code> 的 <code>&lt;h1&gt;</code> 添加正确的 <code>id</code>。</p></div></div> <h4>评论<a href="#评论">#</a></h4> <p>本博客使用 <a href="https://twikoo.js.org/">Twikoo</a> 评论系统，请参考<a href="https://twikoo.js.org/quick-start.html">配置指南</a>进行配置。</p> <p>本博客使用的配置方法为配置指南中的 <a href="https://www.mongodb.com/">MongoDB Atlas</a> + <a href="https://huggingface.co">Hugging Face</a>.</p> <p>主题需要增加自定义 <code>.js</code> 文件来让 Twikoo 评论也能渲染公式。在 <code>_config.fluid.yml</code> 中的 <code>custom_js</code> 下添加</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_js</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.js</span></div></div><div><div><div>3</div></div><div><span> </span><span>-</span><span> </span><span>https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/contrib/auto-render.min.js</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>如果使用的是 mathjax 进行文章数学公式渲染，则还需要在 <code>custom_css</code> 下添加</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>custom_css</span><span>:</span></div></div><div><div><div>2</div></div><div><span> </span><span>-</span><span> </span><span>https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.css</span><span> </span><span># Twikoo Katex 数学公式渲染</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>再重新 <code>hexo clean</code> + <code>hexo g</code>，即可在评论区激活数学公式渲染。</p> <blockquote> <div><span>note</span></div> <div> <p>如果发现评论头像无法加载，请参考<a href="https://twikoo.js.org/frontend.html#%E6%9B%B4%E6%8D%A2-cdn-%E9%95%9C%E5%83%8F">Twikoo 前端部署</a>更换 <code>_config.fluid.yml</code> 的 <code>static_prefix</code> 配置项中关于 Twikoo 的静态资源链接。</p> </div> </blockquote> <h4>添加 RSS 订阅<a href="#添加-rss-订阅">#</a></h4> <p>安装 <a href="https://github.com/hexojs/hexo-generator-feed"><code>hexo-generator-feed</code></a> 插件:</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>hexo-generator-feed</span><span> </span><span>--save</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>在 <code>_config.fluid.yml</code> 中追加配置项：</p> <div><figure><figcaption><span>_config.fluid.yml</span></figcaption><pre><code><div><div><div>1</div></div><div><span>## hexo-generator-feed</span></div></div><div><div><div>2</div></div><div><span>plugins</span><span>:</span><span> </span><span>hexo-generator-feed</span></div></div><div><div><div>3</div></div><div><span>feed</span><span>:</span></div></div><div><div><div>4</div></div><div><span> </span><span>enable</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>5</div></div><div><span> </span><span>type</span><span>:</span><span> </span><span>rss2</span><span> </span><span># 类型 atom | rss2</span></div></div><div><div><div>6</div></div><div><span> </span><span>path</span><span>:</span><span> </span><span>rss2.xml</span><span> </span><span># 文件路径, 默认是 atom.xml | rss2.xml</span></div></div><div><div><div>7</div></div><div><span> </span><span>limit</span><span>:</span><span> </span><span>5</span><span> </span><span># 展示文章的数量, 使用0或则false代表展示全部</span></div></div><div><div><div>8</div></div><div><span> </span><span>hub</span><span>:</span><span> </span><span>#</span></div></div><div><div><div>9</div></div><div><span> </span><span>content</span><span>:</span><span> </span><span># 在RSS文件中是否包含内容, true | false, 默认不填为 false</span></div></div><div><div><div>10</div></div><div><span> </span><span>content_limit</span><span>:</span><span> </span><span>140</span><span> </span><span># 指定内容的长度作为摘要,仅仅在上面content设置为false和没有自定义的描述出现</span></div></div><div><div><div>11</div></div><div><span> </span><span>content_limit_delim</span><span>:</span><span> </span><span>' '</span><span> </span><span># 截取描述的分隔符, 以指定分隔符作为截取结束的标志.</span></div></div><div><div><div>12</div></div><div><span> </span><span>order_by</span><span>:</span><span> </span><span>-date</span></div></div><div><div><div>13</div></div><div><span> </span><span>autodiscovery</span><span>:</span><span> </span><span>true</span></div></div><div><div><div>14</div></div><div><span> </span><span>template</span><span>:</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>然后随便找个位置，增加 <code>&lt;a href="/rss2.xml" target="_blank" rel="nofollow noopener"&gt;&lt;i class="iconfont icon-rss"&gt;&lt;/i&gt;RSS&lt;/a&gt;</code> 进行展示就行，我是放在页脚。</p> <h4>更多主题修改<a href="#更多主题修改">#</a></h4> <p>参看我的</p> <h3>域名<a href="#域名">#</a></h3> <h4>如何挑选<a href="#如何挑选">#</a></h4> <p>首先确定一个喜欢的域名，先去找个域名注册网站查一下该域名是否可注册，然后在<a href="https://www.nazhumi.com/">哪煮米</a>上找到满足自身要求的便宜且靠谱的域名服务商。</p> <p>有国内备案需求最好选择国内的域名服务商，比如阿里云、腾讯云、华为云等；反之不需要备案，对个人隐私有需求，则选择能免费隐藏 whois 信息的国外域名服务商。</p> <h4>切换域名<a href="#切换域名">#</a></h4> <p>在域名服务商处增加一条 DNS 解析，将主域名或者某个子域名用 CNAME 解析到部署的 GitHub page 域名，然后在 <code>source</code> 目录下新建 <code>CNAME</code> 文件，文件内容是你刚刚添加解析的域名，比如在域名服务商那里添加了 <code>blog CNAME username.github.io</code>，就应该在 <code>CNAME</code> 文件中写上</p> <div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>blog.your.domain</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>接着修改一下 <code>.config.yml</code> 与 <code>.config.主题.yml</code> 中关于博客域名相关配置，最后</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>hexo</span><span> </span><span>clean</span><span> </span><span>&amp;&amp;</span><span> </span><span>hexo</span><span> </span><span>generate</span><span> </span><span>&amp;&amp;</span><span> </span><span>hexo</span><span> </span><span>deploy</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>素质三连即可。</p> <h4>域名邮箱<a href="#域名邮箱">#</a></h4> <p>有自己的域名了，自然也要有自己的域名邮箱。域名邮箱的可选项并不多，不介意实名可以直接使用阿里云的<a href="https://common-buy.aliyun.com/?userCode=r3yteowb?spm=a2c6h.12873639.article-detail.8.85464bf1CFEevS&amp;commodityCode=alimail&amp;specCode=lx_18482&amp;request=%7B%22ord_time%22:%223:Year%22,%22account_num%22:%225%22%7D#/buy">免费企业邮箱</a>。反之则可以考虑域名服务商提供的邮件服务，或者 <a href="https://www.zoho.com/">Zoho</a>（可免费注册域名邮箱，但是免费的只有网页版，没有 IMAP/SMTP/POP3）上注册一个。当然偶尔也会有公司会提供免费收发的域名邮箱注册，但一般是小公司且有时效性，可以将评论系统的回复提醒邮箱放在上面，但主力邮箱不建议放在上面，或者设置转发到稳定的邮箱，并且邮件容易进垃圾箱。</p> <p>或者你还可以使用 Resend + CloudFlare 来制作丐版域名邮箱。首先你要在 CloudFlare 上托管你的域名，然后就可以利用 CloudFlare 的电子邮件路由功能将邮件转发到自己的已有邮箱中。随后在 Resend 中绑定你的域名，再申请个 API，就可以利用 Resend 来发邮件了。</p> <h3>将网站添加到搜索引擎<a href="#将网站添加到搜索引擎">#</a></h3> <p>本节内容已整体迁移至<a href="/posts/hexo-blog-search-engine-indexing/">另一篇文章</a>。</p> <h3>优化博客性能<a href="#优化博客性能">#</a></h3> <h4>使用图床<a href="#使用图床">#</a></h4> <p>使用图床来放置博客中的图片，能够减少博客部署的本体所占用的空间，并且当图床部署了 CDN 时，网站的加载速度也会极大提升。</p> <p>使用图床，首先应该下载 <a href="https://picgo.github.io/PicGo-Doc/zh/">PicGo</a>。这是一个开源的图床上传软件，可以聚合多个图床，预览图片，结合插件还可以做到上传时压缩图片。</p> <h5>非自建图床<a href="#非自建图床">#</a></h5> <p>这部分没什么好说的，找一个信得过的图床，检查一下是否有 PicGo 插件支持该图床，用就完事了。个人推荐杜老师的<a href="https://7bu.top/">去不图床</a>，这也是我目前在使用的图床。免费的可以考虑老牌免费图床 <a href="https://sm.ms/">sm.ms</a>。</p> <h5>GitHub + jsDelivr CDN 图床<a href="#github--jsdelivr-cdn-图床">#</a></h5> <blockquote> <div><span>warning</span></div> <div> <p>该方法属于滥用 GitHub 仓库，既不道德，又有概率会封掉仓库，有条件用其他图床就不建议使用。</p> </div> </blockquote> <p>新建一个公开仓库，然后在 PicGo 中选择 GitHub 图床进行配置：</p> <p><a></a></p> <p>其中 Token 需要访问 <a href="https://github.com/settings/tokens">Personal Access Tokens (Classic)</a> 生成，注意 token 只有生成的时候能看到，之后就不能再次打开了，因此需要注意妥善保存。</p> <p>自定义域名部分则是选用了 jsDelivr CDN 进行，可以加快国内大陆地区的访问速度。</p> <h5>CloudFlare R2 存储自建图床<a href="#cloudflare-r2-存储自建图床">#</a></h5> <blockquote> <div><span>note</span></div> <div> <p>这种方式需要用到绑定了银行卡的 PayPal 账户。仅给出参考链接。</p> </div> </blockquote> <ul> <li><a href="https://sspai.com/post/90170">从零开始搭建你的免费图床系统 （Cloudflare R2 + WebP Cloud + PicGo） - 少数派</a></li> </ul> <h4>使用 gulp 压缩网站内容<a href="#使用-gulp-压缩网站内容">#</a></h4> <p>此段内容参考<a href="https://blog.inkuang.com/2021/405/">使用 gulp 压缩 Hexo 博客文件（兼容 ES6 标准） | Ming’s Blog</a>编写。</p> <h5>安装插件<a href="#安装插件">#</a></h5> <p>在博客根目录下打开终端，输入：</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>--global</span><span> </span><span>gulp-cli</span><span> </span><span>#全局安装 gulp 指令集</span></div></div><div><div><div>2</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>gulp</span><span> </span><span>--save</span><span> </span><span>#安装 gulp 插件</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>安装 gulp 插件。随后输入</p> <div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>gulp-clean-css</span><span> </span><span>gulp-terser</span><span> </span><span>gulp-html-minifier-terser</span><span> </span><span>--save-dev</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>安装附属插件。</p> <h5>配置 gulp<a href="#配置-gulp">#</a></h5> <p>在博客根目录下新建 <code>gulpfile.js</code>：</p> <div><figure><figcaption><span>gulpfile.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>const</span><span> gulp </span><span>=</span><span> </span><span>require</span><span>(</span><span>'gulp'</span><span>)</span><span>;</span></div></div><div><div><div>2</div></div><div><span>const</span><span> cleancss </span><span>=</span><span> </span><span>require</span><span>(</span><span>'gulp-clean-css'</span><span>)</span><span>;</span></div></div><div><div><div>3</div></div><div><span>var</span><span> terser </span><span>=</span><span> </span><span>require</span><span>(</span><span>'gulp-terser'</span><span>)</span><span>;</span></div></div><div><div><div>4</div></div><div><span>const</span><span> htmlmin </span><span>=</span><span> </span><span>require</span><span>(</span><span>'gulp-html-minifier-terser'</span><span>)</span><span>;</span></div></div><div><div><div>5</div></div><div> </div></div><div><div><div>6</div></div><div><span>// 压缩 public 目录下的 css 文件</span></div></div><div><div><div>7</div></div><div><span>// 可接受参数的文档：https://github.com/jakubpawlowicz/clean-css#constructor-options</span></div></div><div><div><div>8</div></div><div><span>gulp</span><span>.</span><span>task</span><span>(</span><span>'minify-css'</span><span>,</span><span> </span><span>()</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>9</div></div><div><span> </span><span>return</span><span> gulp</span></div></div><div><div><div>10</div></div><div><span> </span><span>.</span><span>src</span><span>(</span><span>'./public/**/*.css'</span><span>) </span><span>// 处理public目录下所有的css文件，下同</span></div></div><div><div><div>11</div></div><div><span> </span><span>.</span><span>pipe</span><span>(</span><span>cleancss</span><span>())</span></div></div><div><div><div>12</div></div><div><span> </span><span>.</span><span>pipe</span><span>(gulp</span><span>.</span><span>dest</span><span>(</span><span>'./public'</span><span>))</span><span>;</span></div></div><div><div><div>13</div></div><div><span>}</span><span>)</span><span>;</span></div></div><div><div><div>14</div></div><div> </div></div><div><div><div>15</div></div><div><span>// 压缩public目录下的js文件</span></div></div><div><div><div>16</div></div><div><span>// 可接受参数的文档：https://github.com/terser/terser?tab=readme-ov-file#minify-options-structure</span></div></div><div><div><div>17</div></div><div><span>gulp</span><span>.</span><span>task</span><span>(</span><span>'minify-js'</span><span>,</span><span> </span><span>()</span><span> </span><span>=&gt;</span></div></div><div><div><div>18</div></div><div><span><span> </span></span><span>gulp</span></div></div><div><div><div>19</div></div><div><span> </span><span>.</span><span>src</span><span>([</span><span>'./public/**/*.js'</span><span>,</span><span> </span><span>'!./public/**/*.min.js'</span><span>])</span></div></div><div><div><div>20</div></div><div><span> </span><span>.</span><span>pipe</span><span>(</span></div></div><div><div><div>21</div></div><div><span> </span><span>terser</span><span>(</span><span>{</span></div></div><div><div><div>22</div></div><div><span><span> </span></span><span>format</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>23</div></div><div><span><span> </span></span><span>semicolons</span><span>:</span><span> </span><span>false</span><span>,</span><span> </span><span>// 使用换行而非分号压缩 JS 脚本，对浏览器压缩性能无影响，但是方便调试</span></div></div><div><div><div>24</div></div><div><span> </span><span>},</span></div></div><div><div><div>25</div></div><div><span> </span><span>}</span><span>)</span></div></div><div><div><div>26</div></div><div><span><span> </span></span><span>)</span></div></div><div><div><div>27</div></div><div><span> </span><span>.</span><span>pipe</span><span>(gulp</span><span>.</span><span>dest</span><span>(</span><span>'./public'</span><span>))</span></div></div><div><div><div>28</div></div><div><span>)</span><span>;</span></div></div><div><div><div>29</div></div><div> </div></div><div><div><div>30</div></div><div><span>// 压缩public目录下的html文件</span></div></div><div><div><div>31</div></div><div><span>// 可接受参数的文档：https://github.com/terser/html-minifier-terser#options-quick-reference</span></div></div><div><div><div>32</div></div><div><span>gulp</span><span>.</span><span>task</span><span>(</span><span>'minify-html'</span><span>,</span><span> </span><span>()</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>33</div></div><div><span> </span><span>return</span><span> gulp</span></div></div><div><div><div>34</div></div><div><span> </span><span>.</span><span>src</span><span>(</span><span>'./public/**/*.html'</span><span>)</span></div></div><div><div><div>35</div></div><div><span> </span><span>.</span><span>pipe</span><span>(</span></div></div><div><div><div>36</div></div><div><span> </span><span>htmlmin</span><span>(</span><span>{</span></div></div><div><div><div>37</div></div><div><span><span> </span></span><span>removeComments</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 移除注释</span></div></div><div><div><div>38</div></div><div><span><span> </span></span><span>caseSensitive</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 以区分大小写的方式处理属性</span></div></div><div><div><div>39</div></div><div><span><span> </span></span><span>removeEmptyAttributes</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 移除值为空的参数</span></div></div><div><div><div>40</div></div><div><span><span> </span></span><span>removeRedundantAttributes</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 移除值跟默认值匹配的属性</span></div></div><div><div><div>41</div></div><div><span><span> </span></span><span>collapseBooleanAttributes</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 省略布尔属性的值</span></div></div><div><div><div>42</div></div><div><span><span> </span></span><span>preventAttributesEscaping</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 避免属性被转义</span></div></div><div><div><div>43</div></div><div><span><span> </span></span><span>collapseWhitespace</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 移除空格和空行</span></div></div><div><div><div>44</div></div><div><span><span> </span></span><span>conservativeCollapse</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 始终折叠为 1 个空格（永远不要完全移除它）。必须与 collapseWhitespace=true 一起使用。</span></div></div><div><div><div>45</div></div><div><span><span> </span></span><span>noNewlinesBeforeTagClose</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 从一个元素闭合标签前永远不要添加换行</span></div></div><div><div><div>46</div></div><div><span><span> </span></span><span>minifyCSS</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 压缩 HTML 中的 CSS</span></div></div><div><div><div>47</div></div><div><span><span> </span></span><span>minifyJS</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>48</div></div><div><span> </span><span>// 调用 terser 压缩 HTML 中的 JS，配置同 terser</span></div></div><div><div><div>49</div></div><div><span><span> </span></span><span>format</span><span>:</span><span> </span><span>{</span></div></div><div><div><div>50</div></div><div><span><span> </span></span><span>semicolons</span><span>:</span><span> </span><span>false</span><span>,</span></div></div><div><div><div>51</div></div><div><span><span> </span></span><span>quote_style</span><span>:</span><span> </span><span>1</span><span>,</span><span> </span><span>// 始终使用单引号包裹字符串，可以避免类似 `onclick="foo('bar')"` 这类属性出现 bug</span></div></div><div><div><div>52</div></div><div><span> </span><span>},</span></div></div><div><div><div>53</div></div><div><span> </span><span>},</span></div></div><div><div><div>54</div></div><div><span><span> </span></span><span>minifyURLs</span><span>:</span><span> </span><span>true</span><span>,</span><span> </span><span>// 压缩 HTML 中的链接</span></div></div><div><div><div>55</div></div><div><span> </span><span>}</span><span>)</span></div></div><div><div><div>56</div></div><div><span><span> </span></span><span>)</span></div></div><div><div><div>57</div></div><div><span> </span><span>.</span><span>pipe</span><span>(gulp</span><span>.</span><span>dest</span><span>(</span><span>'./public'</span><span>))</span><span>;</span></div></div><div><div><div>58</div></div><div><span>}</span><span>)</span><span>;</span></div></div><div><div><div>59</div></div><div> </div></div><div><div><div>60</div></div><div><span>// 默认任务，不带任务名运行gulp时执行的任务</span></div></div><div><div><div>61</div></div><div><span>gulp</span><span>.</span><span>task</span><span>(</span><span>'default'</span><span>,</span><span> gulp</span><span>.</span><span>parallel</span><span>(</span><span>'minify-css'</span><span>,</span><span> </span><span>'minify-js'</span><span>,</span><span> </span><span>'minify-html'</span><span>))</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>此时在运行 <code>hexo g</code> 后手动运行 <code>gulp</code> 即可压缩文件。</p> <h5>自动化配置<a href="#自动化配置">#</a></h5> <p>在博客根目录下找到 <code>package.json</code>，在 <code>scripts</code> 键下添加新脚本：</p> <div><figure><figcaption><span>package.json</span></figcaption><pre><code><div><div><div>1</div></div><div><span>"scripts"</span><span>: </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>"</span><span>postbuild</span><span>"</span><span>:</span><span> </span><span>"gulp"</span></div></div><div><div><div>3</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>随后在 <code>scripts</code> 目录下新建 <code>generator.js</code>，添加以下内容：</p> <div><figure><figcaption><span>scripts/generator.js</span></figcaption><pre><code><div><div><div>1</div></div><div><span>hexo</span><span>.</span><span>extend</span><span>.</span><span>generator</span><span>.</span><span>register</span><span>(</span><span>'postbuild'</span><span>,</span><span> </span><span>function</span><span> </span><span>()</span><span> </span><span>{</span></div></div><div><div><div>2</div></div><div><span> </span><span>const</span><span> </span><span>{</span><span> exec </span><span>}</span><span> </span><span>=</span><span> </span><span>require</span><span>(</span><span>'child_process'</span><span>)</span><span>;</span></div></div><div><div><div>3</div></div><div><span> </span><span>exec</span><span>(</span><span>'npm run postbuild'</span><span>,</span><span> </span><span>(</span><span>err</span><span>,</span><span> </span><span>stdout</span><span>,</span><span> </span><span>stderr</span><span>)</span><span> </span><span>=&gt;</span><span> </span><span>{</span></div></div><div><div><div>4</div></div><div><span> </span><span>if</span><span> (err) </span><span>{</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>console</span><span>.</span><span>error</span><span>(</span><span>`Error: </span><span>${</span><span>stderr</span><span>}</span><span>`</span><span>)</span><span>;</span></div></div><div><div><div>6</div></div><div><span> </span><span>}</span><span> </span><span>else</span><span> </span><span>{</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>console</span><span>.</span><span>log</span><span>(</span><span>`Output: </span><span>${</span><span>stdout</span><span>}</span><span>`</span><span>)</span><span>;</span></div></div><div><div><div>8</div></div><div><span> </span><span>}</span></div></div><div><div><div>9</div></div><div><span> </span><span>}</span><span>)</span><span>;</span></div></div><div><div><div>10</div></div><div><span>}</span><span>)</span><span>;</span></div></div></code></pre><div><div></div><div></div></div></figure></div> <p>这样在运行 <code>hexo g</code> 后就会自动运行 <code>gulp</code> 对博客进行压缩。</p> </article> https://blog.hpcesia.com/posts/derivations-of-some-finite-difference-methods/https://blog.hpcesia.com/posts/derivations-of-some-finite-difference-methods/对向前欧拉、向后欧拉、跃点(Leap frog)、梯形四种有限差分格式的准确性、稳定性进行数学推导，并给出数值计算结果。Mon, 19 Aug 2024 12:55:30 GMT<article> <blockquote> <div><span>note</span></div> <div> <p>本文由以前的课程论文使用 <a href="https://pandoc.org/">pandoc</a> 转换到 markdown 博客，原文为本人厦门大学数学系课程《微分方程数值解》的课程论文，参考时请注意。</p> </div> </blockquote> <h2>简介<a href="#简介">#</a></h2> <p>本文默认读者对有限差分方法有一定了解，因此不做过多的前置知识介绍。</p> <p>考虑如下初值问题:</p> <p>将 划分为 个等距区间，，我们有以下几种有限差分格式用于求其数值解:</p> <ul> <li>向前欧拉格式</li> </ul> <ul> <li>向后欧拉格式</li> </ul> <ul> <li>跃点(Leap frog)格式</li> </ul> <ul> <li>梯形格式</li> </ul> <p>接下来，对以上四种有限差分格式，我们将进行其准确性(Accuracy)与稳定性(Stability)的数学推导。</p> <h2>准确性推导<a href="#准确性推导">#</a></h2> <p>首先定义局部截断误差(Local Truncation Error) ，其定义为： 其他点处的精确解在 处按照差分格式计算得到的结果与 处的精确解的差值。</p> <blockquote> <div><span>warning</span></div> <div> <p>上述局部截断误差与通常定义的局部截断误差相差一个 ，参考时请注意。</p> </div> </blockquote> <h3>向前欧拉格式<a href="#向前欧拉格式">#</a></h3> <p>向前欧拉格式的局部截断误差 可表示为如下等式</p> <p>对 进行 Taylor 展开有</p> <p>于是有</p> <p>误差 可表示为如下形式：</p> <p>令 ，对误差 有如下估计：</p> <h3>向后欧拉格式<a href="#向后欧拉格式">#</a></h3> <p>向后欧拉格式的局部截断误差 可表示为如下等式</p> <p>对 进行 Taylor 展开有</p> <p>于是有</p> <p>误差 可表示为如下形式：</p> <p>令 ，假定 ，对误差 有如下估计：</p> <h3>跃点格式<a href="#跃点格式">#</a></h3> <p>跃点格式的局部截断误差 可表示为如下等式</p> <p>对 和 进行 Taylor 展开有</p> <p>于是有</p> <p>误差 可表示为如下形式：</p> <p>令 ，对误差 有如下估计：</p> <p>令 ，，则 ，且 . 于是上式可改写为如下形式：</p> <p>不妨假定上式中的 是由向前欧拉格式得到的，注意到 时 ，于是有</p> <h3>梯形格式<a href="#梯形格式">#</a></h3> <p>跃点格式的局部截断误差 可表示为如下等式</p> <p>对 和 进行 Taylor 展开有</p> <p>于是有</p> <p>误差 可表示为如下形式：</p> <p>令 ，假定 ，对误差 有如下估计：</p> <h2>稳定性推导<a href="#稳定性推导">#</a></h2> <p>考虑模型问题</p> <p>其中 为常数。定义 为舍入误差，. 我们称差分格式的绝对稳定区域(Absolute Stability Region)为复平面上所有使差分格式的解稳定的 的集合。</p> <h3>向前欧拉格式<a href="#向前欧拉格式-1">#</a></h3> <p>将格式代入模型问题可得</p> <p>考虑到舍入误差，我们有 而非 ：</p> <p>误差 满足</p> <p>假设 ，若 ，则有</p> <p>其中 为常数，所以本格式的绝对稳定区域为 .</p> <h3>向后欧拉格式<a href="#向后欧拉格式-1">#</a></h3> <p>将格式代入模型问题可得</p> <p>考虑到舍入误差，我们有 而非 ：</p> <p>误差 满足</p> <p>假设 ，若 ，则有</p> <p>其中 为常数，所以本格式的绝对稳定区域为 .</p> <h3>跃点格式<a href="#跃点格式-1">#</a></h3> <p>将格式代入模型问题可得</p> <p>考虑到舍入误差，我们有 而非 ：</p> <p>误差 满足</p> <p>其中 ，多值函数 取将正数映射到正数的解析分支。随后我们有</p> <p>假设 ，若 ，则有</p> <p>上式同时出现 与 ，所以仅 时跃点格式稳定。令 有</p> <p>其中</p> <p>注意到仅 且 时上式成立，所以跃点格式的绝对稳定区域为 .</p> <h3>梯形格式<a href="#梯形格式-1">#</a></h3> <p>将格式代入模型问题可得</p> <p>考虑到舍入误差，我们有 而非 ：</p> <p>误差 满足</p> <p>假设 ，令 ，若 ，则有</p> <p>其中 为常数，所以本格式的绝对稳定区域为 .</p> <h2>数值试验<a href="#数值试验">#</a></h2> <div><div>四种有限差分格式的MATLAB代码</div><div><p>向前欧拉格式：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>function</span><span> </span><span>[</span><span>x</span><span>, </span><span>result</span><span>]</span><span> = </span><span>forward_euler</span><span>(</span><span>T</span><span>, </span><span>step</span><span>, </span><span>u0</span><span>, </span><span>f</span><span>)</span></div></div><div><div><div>2</div></div><div><span><span> </span></span><span>x = linspace(</span><span>0</span><span>, T, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>3</div></div><div><span><span> </span></span><span>h = T </span><span>/</span><span> step;</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>result = zeros(</span><span>1</span><span>, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>result(</span><span>1</span><span>) = u0;</span></div></div><div><div><div>6</div></div><div><span> </span><span>for</span><span> k = </span><span>2</span><span>:step </span><span>+</span><span> </span><span>1</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>result(k) = result(k </span><span>-</span><span> </span><span>1</span><span>) </span><span>+</span><span> h </span><span>*</span><span> f(x(k </span><span>-</span><span> </span><span>1</span><span>), result(k </span><span>-</span><span> </span><span>1</span><span>));</span></div></div><div><div><div>8</div></div><div><span> </span><span>end</span></div></div><div><div><div>9</div></div><div><span>end</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>向后欧拉格式：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>function</span><span> </span><span>[</span><span>x</span><span>, </span><span>result</span><span>]</span><span> = </span><span>backward_euler</span><span>(</span><span>T</span><span>, </span><span>step</span><span>, </span><span>u0</span><span>, </span><span>f</span><span>)</span></div></div><div><div><div>2</div></div><div><span><span> </span></span><span>x = linspace(</span><span>0</span><span>, T, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>3</div></div><div><span><span> </span></span><span>h = T </span><span>/</span><span> step;</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>result = zeros(</span><span>1</span><span>, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>result(</span><span>1</span><span>) = u0;</span></div></div><div><div><div>6</div></div><div><span> </span><span>for</span><span> k = </span><span>2</span><span>:step </span><span>+</span><span> </span><span>1</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>temp_func = @(uk) result(k </span><span>-</span><span> </span><span>1</span><span>) </span><span>+</span><span> h </span><span>*</span><span> f(x(k), uk) </span><span>-</span><span> uk;</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>result(k) = fzero(temp_func, result(k </span><span>-</span><span> </span><span>1</span><span>));</span></div></div><div><div><div>9</div></div><div><span> </span><span>end</span></div></div><div><div><div>10</div></div><div><span>end</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>跃点格式：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>function</span><span> </span><span>[</span><span>x</span><span>, </span><span>result</span><span>]</span><span> = </span><span>leap_frog</span><span>(</span><span>T</span><span>, </span><span>step</span><span>, </span><span>u0</span><span>, </span><span>u1</span><span>, </span><span>f</span><span>)</span></div></div><div><div><div>2</div></div><div><span><span> </span></span><span>x = linspace(</span><span>0</span><span>, T, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>3</div></div><div><span><span> </span></span><span>h = T </span><span>/</span><span> step;</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>result = zeros(</span><span>1</span><span>, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>result(</span><span>1</span><span>) = u0;</span></div></div><div><div><div>6</div></div><div><span><span> </span></span><span>result(</span><span>2</span><span>) = u1;</span></div></div><div><div><div>7</div></div><div><span> </span><span>for</span><span> k = </span><span>3</span><span>:step </span><span>+</span><span> </span><span>1</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>result(k) = result(k </span><span>-</span><span> </span><span>2</span><span>) </span><span>+</span><span> </span><span>2</span><span> </span><span>*</span><span> h </span><span>*</span><span> f(x(k </span><span>-</span><span> </span><span>1</span><span>), result(k </span><span>-</span><span> </span><span>1</span><span>));</span></div></div><div><div><div>9</div></div><div><span> </span><span>end</span></div></div><div><div><div>10</div></div><div><span>end</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>梯形格式：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>function</span><span> </span><span>[</span><span>x</span><span>, </span><span>result</span><span>]</span><span> = </span><span>trapezoidal</span><span>(</span><span>T</span><span>, </span><span>step</span><span>, </span><span>u0</span><span>, </span><span>f</span><span>)</span></div></div><div><div><div>2</div></div><div><span><span> </span></span><span>x = linspace(</span><span>0</span><span>, T, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>3</div></div><div><span><span> </span></span><span>h = T </span><span>/</span><span> step;</span></div></div><div><div><div>4</div></div><div><span><span> </span></span><span>result = zeros(</span><span>1</span><span>, step </span><span>+</span><span> </span><span>1</span><span>);</span></div></div><div><div><div>5</div></div><div><span><span> </span></span><span>result(</span><span>1</span><span>) = u0;</span></div></div><div><div><div>6</div></div><div><span> </span><span>for</span><span> k = </span><span>2</span><span>:step </span><span>+</span><span> </span><span>1</span></div></div><div><div><div>7</div></div><div><span><span> </span></span><span>temp_func = @(uk) result(k </span><span>-</span><span> </span><span>1</span><span>) </span><span>-</span><span> uk </span><span>+</span><span> </span><span>...</span></div></div><div><div><div>8</div></div><div><span><span> </span></span><span>h </span><span>*</span><span> (f(x(k), uk) </span><span>+</span><span> f(x(k </span><span>-</span><span> </span><span>1</span><span>), result(k </span><span>-</span><span> </span><span>1</span><span>))) </span><span>/</span><span> </span><span>2</span><span>;</span></div></div><div><div><div>9</div></div><div><span><span> </span></span><span>result(k) = fzero(temp_func, result(k </span><span>-</span><span> </span><span>1</span><span>));</span></div></div><div><div><div>10</div></div><div><span> </span><span>end</span></div></div><div><div><div>11</div></div><div><span>end</span></div></div></code></pre><div><div></div><div></div></div></figure></div></div></div> <p>考虑如下初值问题：</p> <p>其解析解为：</p> <p>使用上述代码进行有限差分求解，得到数值结果如下：</p> <p><a></a></p> </article>