﻿<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <author>
    <name>cookiesky</name>
  </author>
  <generator uri="https://hexo.io/">Hexo</generator>
  <id>https://cookiesky.cn/</id>
  <link href="https://cookiesky.cn/" rel="alternate"/>
  <link href="https://cookiesky.cn/atom.xml" rel="self"/>
  <rights>All rights reserved 2026, cookiesky</rights>
  <subtitle>
    <![CDATA[<div class="brinks">这是一个萌新的网站，欢迎访问！</div>]]>
  </subtitle>
  <title>奇妙的天空小屋</title>
  <updated>2026-11-22T17:12:15.687Z</updated>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a></li></ul><p>本篇从第 61 个魔改开始，先写列表页文章少时，公告、欢迎来访、倒计时和那年今日自动下移到文章下方、整页全宽展开；后续 62 起继续补在这一篇。适用 <code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code>。</p></div><div class="note info modern"><p>阅读约定：每个代码块上方都标了 <strong>文件</strong> 与 <strong>改法</strong>。<code>[Blogroot]</code> 指博客根目录；「新建」是建好文件后整段写入，「追加」是放到文件末尾，「在已有文件的某函数内补全」是在已有脚本里改对应位置，不要另建一份。</p></div><details class="folding-tag" blue><summary> 这一节改哪里 </summary>              <div class='content'>              <ul><li>61：列表页文章不足时，侧栏内容卡下移全宽展开，文章变多后逐张收回</li></ul><p>需要的基础：第 52 节已经做过「欢迎来访」「倒计时」，第 53 节已经做过网站信息卡下移。这两节没有做的话，脚本仍能运行，但只会搬动页面上实际存在的卡片。</p>              </div>            </details><h1 id="61-列表页文章少时，网站信息与侧栏卡下移全宽展开"><a href="#61-列表页文章少时，网站信息与侧栏卡下移全宽展开" class="headerlink" title="61. 列表页文章少时，网站信息与侧栏卡下移全宽展开"></a>61. 列表页文章少时，网站信息与侧栏卡下移全宽展开</h1><h2 id="效果"><a href="#效果" class="headerlink" title="效果"></a>效果</h2><p>分类页、标签页或最后一页文章很少时，主列表只有两三张卡片，右侧却还挂着一整列侧栏，页面下半截会出现一块很大的空白。原来的第 53 节只把「网站信息」搬到主列底部，主列仍然只占 74% 宽，右边那一截还是空的。</p><p>这一节把「网站信息」也从主列请出来，和公告、欢迎来访、倒计时、那年今日一起排进 <code>#content-inner</code> 的整页全宽网格：</p><ul><li>桌面端（<code>≥ 900px</code>）先量主列表和侧栏的真实内容高度。</li><li>网站信息放第一行，公告第二行，欢迎来访占 7/12、倒计时占 5/12，那年今日收尾；页面上缺哪张就跳过哪张。</li><li>每搬一张重新量一次，侧栏高度回到主列表附近就停，不会一次全部搬空。</li><li>新增文章把空间占掉后，下一次同步会先全部放回原位，再按新的剩余空间重新分配，所以只收回不需要的那几张。</li><li>手机端不搬，网站信息和侧栏卡全部放回，保持整页纵向滚动。</li></ul><p>本站 1440px 下实测：第 4 页（3 篇）展开网站信息、公告、欢迎与倒计时；4 ~ 6 篇只展开网站信息、欢迎与倒计时；8 篇只展开网站信息与欢迎；10 篇以上不再展开。这个数量不是写死的，由高度计算得出。</p><h2 id="为什么不能直接-appendChild-了事"><a href="#为什么不能直接-appendChild-了事" class="headerlink" title="为什么不能直接 appendChild 了事"></a>为什么不能直接 <code>appendChild</code> 了事</h2><p>只在需要的时候移动卡片，必须解决三件事：</p><ol><li><strong>原位怎么记</strong>：卡片原来在 <code>#aside-content</code> 里，有的在 <code>.sticky_layout</code> 里，有的直接挂在侧栏下。只记父节点不够，还要记它在兄弟节点中的位置，否则恢复后顺序会乱。</li><li><strong>高度怎么量</strong>：主列表和侧栏都是 flex 子项，侧栏会被拉伸到和主列表一样高。直接读 <code>aside.offsetHeight</code> 永远量不出「侧栏内容其实更矮」，要取它直接子元素的最底部。</li><li><strong>pjax 怎么活</strong>：pjax 只替换 <code>#body-wrap</code>，脚本本身还在。必须监听 pjax 完成事件重新同步，同时避免重复创建容器。</li><li><strong>网站信息不在侧栏</strong>：第 53 节先把 <code>.card-webinfo</code> 搬进了 <code>#recent-posts</code>，它的位置由 <code>list-webinfo.js</code> 管。展开脚本要先找到这张卡，再和侧栏卡一起处理；只查 <code>#aside-content</code> 是找不到的。</li></ol><p>本站的做法是：搬走之前在原位插一个注释节点 <code>&lt;!--hg-side-fill-slot--&gt;</code> 当占位，回来时插到注释前面，再把注释删掉。网站信息和侧栏卡都按这个办法记位置，注释不可见、不占布局，顺序却可以精确保留。</p><h2 id="文件清单"><a href="#文件清单" class="headerlink" title="文件清单"></a>文件清单</h2><div class="table-container"><table><thead><tr><th>文件</th><th>改法</th><th>作用</th></tr></thead><tbody><tr><td><code>[Blogroot]/source/js/list-side-fill.js</code></td><td>新建</td><td>测量、搬运网站信息与侧栏卡、恢复、pjax 同步</td></tr><tr><td><code>[Blogroot]/source/css/custom.css</code></td><td>追加</td><td>全宽容器、十二列网格、网站信息条和紧凑那年今日</td></tr><tr><td><code>[Blogroot]/_config.butterfly.yml</code></td><td>在 <code>inject.bottom</code> 里加一行</td><td>加载脚本</td></tr><tr><td><code>[Blogroot]/source/js/fomal/welcome-card.js</code></td><td>在 <code>refresh()</code> 里补一行</td><td>欢迎卡重建后重新同步</td></tr></tbody></table></div><h2 id="第一步：新建同步脚本"><a href="#第一步：新建同步脚本" class="headerlink" title="第一步：新建同步脚本"></a>第一步：新建同步脚本</h2><p><strong>文件</strong>：<code>[Blogroot]/source/js/list-side-fill.js</code> ｜ <strong>改法</strong>：新建文件，整段写入。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br><span class="line">84</span><br><span class="line">85</span><br><span class="line">86</span><br><span class="line">87</span><br><span class="line">88</span><br><span class="line">89</span><br><span class="line">90</span><br><span class="line">91</span><br><span class="line">92</span><br><span class="line">93</span><br><span class="line">94</span><br><span class="line">95</span><br><span class="line">96</span><br><span class="line">97</span><br><span class="line">98</span><br><span class="line">99</span><br><span class="line">100</span><br><span class="line">101</span><br><span class="line">102</span><br><span class="line">103</span><br><span class="line">104</span><br><span class="line">105</span><br><span class="line">106</span><br><span class="line">107</span><br><span class="line">108</span><br><span class="line">109</span><br><span class="line">110</span><br><span class="line">111</span><br><span class="line">112</span><br><span class="line">113</span><br><span class="line">114</span><br><span class="line">115</span><br><span class="line">116</span><br><span class="line">117</span><br><span class="line">118</span><br><span class="line">119</span><br><span class="line">120</span><br><span class="line">121</span><br><span class="line">122</span><br><span class="line">123</span><br><span class="line">124</span><br><span class="line">125</span><br><span class="line">126</span><br><span class="line">127</span><br><span class="line">128</span><br><span class="line">129</span><br><span class="line">130</span><br><span class="line">131</span><br><span class="line">132</span><br><span class="line">133</span><br><span class="line">134</span><br><span class="line">135</span><br><span class="line">136</span><br><span class="line">137</span><br><span class="line">138</span><br><span class="line">139</span><br><span class="line">140</span><br><span class="line">141</span><br><span class="line">142</span><br><span class="line">143</span><br><span class="line">144</span><br><span class="line">145</span><br><span class="line">146</span><br><span class="line">147</span><br><span class="line">148</span><br><span class="line">149</span><br><span class="line">150</span><br><span class="line">151</span><br><span class="line">152</span><br><span class="line">153</span><br><span class="line">154</span><br><span class="line">155</span><br><span class="line">156</span><br><span class="line">157</span><br><span class="line">158</span><br><span class="line">159</span><br><span class="line">160</span><br><span class="line">161</span><br><span class="line">162</span><br><span class="line">163</span><br><span class="line">164</span><br><span class="line">165</span><br><span class="line">166</span><br><span class="line">167</span><br><span class="line">168</span><br><span class="line">169</span><br><span class="line">170</span><br><span class="line">171</span><br><span class="line">172</span><br><span class="line">173</span><br><span class="line">174</span><br><span class="line">175</span><br><span class="line">176</span><br><span class="line">177</span><br><span class="line">178</span><br><span class="line">179</span><br><span class="line">180</span><br><span class="line">181</span><br><span class="line">182</span><br><span class="line">183</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* 桌面短列表：文章不够铺满时，把侧栏内容卡移到列表下方全宽展开 */</span></span><br><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">MAIN_IDS</span> = [<span class="string">&#x27;recent-posts&#x27;</span>, <span class="string">&#x27;category&#x27;</span>, <span class="string">&#x27;tag&#x27;</span>];</span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">CARD_SELECTORS</span> = [</span><br><span class="line">    <span class="string">&#x27;.hg-webinfo-inline&#x27;</span>,</span><br><span class="line">    <span class="string">&#x27;.hg-welcome-card&#x27;</span>,</span><br><span class="line">    <span class="string">&#x27;.hg-countdown-card&#x27;</span>,</span><br><span class="line">    <span class="string">&#x27;.card-announcement&#x27;</span>,</span><br><span class="line">    <span class="string">&#x27;.card-history&#x27;</span></span><br><span class="line">  ];</span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">HOST_ID</span> = <span class="string">&#x27;hg-side-fill&#x27;</span>;</span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">SLOT_MARK</span> = <span class="string">&#x27;hg-side-fill-slot&#x27;</span>;</span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">GAP_MIN</span> = <span class="number">220</span>;</span><br><span class="line">  <span class="keyword">var</span> mq = <span class="variable language_">window</span>.<span class="title function_">matchMedia</span>(<span class="string">&#x27;(min-width: 900px)&#x27;</span>);</span><br><span class="line">  <span class="keyword">var</span> pending = <span class="number">0</span>;</span><br><span class="line">  <span class="keyword">var</span> filled = <span class="literal">false</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">getMain</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; <span class="variable constant_">MAIN_IDS</span>.<span class="property">length</span>; i += <span class="number">1</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> el = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="variable constant_">MAIN_IDS</span>[i]);</span><br><span class="line">      <span class="keyword">if</span> (el) <span class="keyword">return</span> el;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="literal">null</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">getAside</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;aside-content&#x27;</span>);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">getLayout</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;content-inner&#x27;</span>);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">postCount</span>(<span class="params">main</span>) &#123;</span><br><span class="line">    <span class="keyword">return</span> main.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;.recent-post-items &gt; .recent-post-item&#x27;</span>).<span class="property">length</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">findCard</span>(<span class="params">aside, selector</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> card = aside.<span class="title function_">querySelector</span>(selector);</span><br><span class="line">    <span class="keyword">if</span> (card) <span class="keyword">return</span> card;</span><br><span class="line">    <span class="keyword">if</span> (selector === <span class="string">&#x27;.hg-webinfo-inline&#x27;</span>) <span class="keyword">return</span> <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(selector);</span><br><span class="line">    <span class="keyword">return</span> <span class="literal">null</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">contentHeight</span>(<span class="params">el</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> rect = el.<span class="title function_">getBoundingClientRect</span>();</span><br><span class="line">    <span class="keyword">var</span> bottom = rect.<span class="property">top</span>;</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; el.<span class="property">children</span>.<span class="property">length</span>; i += <span class="number">1</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> child = el.<span class="property">children</span>[i].<span class="title function_">getBoundingClientRect</span>();</span><br><span class="line">      <span class="keyword">if</span> (child.<span class="property">height</span> &gt; <span class="number">0</span> &amp;&amp; child.<span class="property">bottom</span> &gt; bottom) bottom = child.<span class="property">bottom</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="title class_">Math</span>.<span class="title function_">max</span>(<span class="number">0</span>, bottom - rect.<span class="property">top</span>);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">ensureHost</span>(<span class="params">layout</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> host = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="variable constant_">HOST_ID</span>);</span><br><span class="line">    <span class="keyword">if</span> (!host) &#123;</span><br><span class="line">      host = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">      host.<span class="property">id</span> = <span class="variable constant_">HOST_ID</span>;</span><br><span class="line">      host.<span class="property">className</span> = <span class="string">&#x27;hg-side-fill&#x27;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">if</span> (host.<span class="property">parentElement</span> !== layout) layout.<span class="title function_">appendChild</span>(host);</span><br><span class="line">    layout.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;hg-side-fill-on&#x27;</span>);</span><br><span class="line">    <span class="keyword">return</span> host;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">cleanSlots</span>(<span class="params">aside</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!aside) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> walker = <span class="variable language_">document</span>.<span class="title function_">createTreeWalker</span>(aside, <span class="title class_">NodeFilter</span>.<span class="property">SHOW_COMMENT</span>, <span class="literal">null</span>);</span><br><span class="line">    <span class="keyword">var</span> slots = [];</span><br><span class="line">    <span class="keyword">while</span> (walker.<span class="title function_">nextNode</span>()) &#123;</span><br><span class="line">      <span class="keyword">if</span> (walker.<span class="property">currentNode</span>.<span class="property">nodeValue</span> === <span class="variable constant_">SLOT_MARK</span>) slots.<span class="title function_">push</span>(walker.<span class="property">currentNode</span>);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; slots.<span class="property">length</span>; i += <span class="number">1</span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (slots[i].<span class="property">parentNode</span>) slots[i].<span class="property">parentNode</span>.<span class="title function_">removeChild</span>(slots[i]);</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">restore</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> host = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="variable constant_">HOST_ID</span>);</span><br><span class="line">    <span class="keyword">var</span> aside = <span class="title function_">getAside</span>();</span><br><span class="line">    <span class="keyword">var</span> layout = <span class="title function_">getLayout</span>();</span><br><span class="line">    <span class="keyword">if</span> (host) &#123;</span><br><span class="line">      <span class="keyword">var</span> cards = <span class="title class_">Array</span>.<span class="property"><span class="keyword">prototype</span></span>.<span class="property">slice</span>.<span class="title function_">call</span>(host.<span class="property">children</span>);</span><br><span class="line">      <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; cards.<span class="property">length</span>; i += <span class="number">1</span>) &#123;</span><br><span class="line">        <span class="keyword">var</span> card = cards[i];</span><br><span class="line">        <span class="keyword">var</span> slot = card.<span class="property">__hgFillSlot</span>;</span><br><span class="line">        <span class="keyword">if</span> (slot &amp;&amp; slot.<span class="property">parentNode</span>) &#123;</span><br><span class="line">          slot.<span class="property">parentNode</span>.<span class="title function_">insertBefore</span>(card, slot);</span><br><span class="line">          slot.<span class="property">parentNode</span>.<span class="title function_">removeChild</span>(slot);</span><br><span class="line">        &#125; <span class="keyword">else</span> <span class="keyword">if</span> (aside) &#123;</span><br><span class="line">          aside.<span class="title function_">appendChild</span>(card);</span><br><span class="line">        &#125;</span><br><span class="line">        card.<span class="property">__hgFillSlot</span> = <span class="literal">null</span>;</span><br><span class="line">      &#125;</span><br><span class="line">      <span class="keyword">if</span> (!host.<span class="property">children</span>.<span class="property">length</span> &amp;&amp; host.<span class="property">parentElement</span>) host.<span class="property">parentElement</span>.<span class="title function_">removeChild</span>(host);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="title function_">cleanSlots</span>(aside);</span><br><span class="line">    <span class="title function_">cleanSlots</span>(<span class="title function_">getMain</span>());</span><br><span class="line">    <span class="keyword">if</span> (layout) layout.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;hg-side-fill-on&#x27;</span>);</span><br><span class="line">    filled = <span class="literal">false</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">moveToHost</span>(<span class="params">card, host</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (card.<span class="property">parentElement</span> !== host) &#123;</span><br><span class="line">      <span class="keyword">if</span> (!card.<span class="property">__hgFillSlot</span> || !card.<span class="property">__hgFillSlot</span>.<span class="property">parentNode</span>) &#123;</span><br><span class="line">        <span class="keyword">var</span> slot = <span class="variable language_">document</span>.<span class="title function_">createComment</span>(<span class="variable constant_">SLOT_MARK</span>);</span><br><span class="line">        card.<span class="property">parentNode</span>.<span class="title function_">insertBefore</span>(slot, card);</span><br><span class="line">        card.<span class="property">__hgFillSlot</span> = slot;</span><br><span class="line">      &#125;</span><br><span class="line">      host.<span class="title function_">appendChild</span>(card);</span><br><span class="line">    &#125;</span><br><span class="line">    card.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;wow&#x27;</span>);</span><br><span class="line">    card.<span class="property">style</span>.<span class="property">visibility</span> = <span class="string">&#x27;visible&#x27;</span>;</span><br><span class="line">    card.<span class="property">style</span>.<span class="property">animationName</span> = <span class="string">&#x27;none&#x27;</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">run</span>(<span class="params"></span>) &#123;</span><br><span class="line">    pending = <span class="number">0</span>;</span><br><span class="line">    <span class="keyword">var</span> main = <span class="title function_">getMain</span>();</span><br><span class="line">    <span class="keyword">var</span> aside = <span class="title function_">getAside</span>();</span><br><span class="line">    <span class="keyword">var</span> layout = <span class="title function_">getLayout</span>();</span><br><span class="line">    <span class="keyword">var</span> hadFill = filled;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">if</span> (!aside || !layout) <span class="keyword">return</span>;</span><br><span class="line">    <span class="title function_">restore</span>();</span><br><span class="line"></span><br><span class="line">    <span class="keyword">if</span> (!main || !mq.<span class="property">matches</span> || <span class="title function_">postCount</span>(main) === <span class="number">0</span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (hadFill) <span class="variable language_">window</span>.<span class="title function_">dispatchEvent</span>(<span class="keyword">new</span> <span class="title class_">Event</span>(<span class="string">&#x27;resize&#x27;</span>));</span><br><span class="line">      <span class="keyword">return</span>;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">var</span> mainH = <span class="title function_">contentHeight</span>(main);</span><br><span class="line">    <span class="keyword">var</span> asideH = <span class="title function_">contentHeight</span>(aside);</span><br><span class="line">    <span class="keyword">if</span> (asideH - mainH &lt; <span class="variable constant_">GAP_MIN</span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (hadFill) <span class="variable language_">window</span>.<span class="title function_">dispatchEvent</span>(<span class="keyword">new</span> <span class="title class_">Event</span>(<span class="string">&#x27;resize&#x27;</span>));</span><br><span class="line">      <span class="keyword">return</span>;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">var</span> host = <span class="title function_">ensureHost</span>(layout);</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; <span class="variable constant_">CARD_SELECTORS</span>.<span class="property">length</span>; i += <span class="number">1</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> card = <span class="title function_">findCard</span>(aside, <span class="variable constant_">CARD_SELECTORS</span>[i]);</span><br><span class="line">      <span class="keyword">if</span> (!card) <span class="keyword">continue</span>;</span><br><span class="line">      <span class="title function_">moveToHost</span>(card, host);</span><br><span class="line">      asideH = <span class="title function_">contentHeight</span>(aside);</span><br><span class="line">      <span class="keyword">if</span> (asideH &lt;= mainH + <span class="number">12</span>) <span class="keyword">break</span>;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">if</span> (!host.<span class="property">children</span>.<span class="property">length</span>) &#123;</span><br><span class="line">      <span class="title function_">restore</span>();</span><br><span class="line">      <span class="keyword">if</span> (hadFill) <span class="variable language_">window</span>.<span class="title function_">dispatchEvent</span>(<span class="keyword">new</span> <span class="title class_">Event</span>(<span class="string">&#x27;resize&#x27;</span>));</span><br><span class="line">      <span class="keyword">return</span>;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    host.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hg-fill-has-welcome&#x27;</span>, !!host.<span class="title function_">querySelector</span>(<span class="string">&#x27;.hg-welcome-card&#x27;</span>));</span><br><span class="line">    host.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hg-fill-has-countdown&#x27;</span>, !!host.<span class="title function_">querySelector</span>(<span class="string">&#x27;.hg-countdown-card&#x27;</span>));</span><br><span class="line">    filled = <span class="literal">true</span>;</span><br><span class="line">    <span class="variable language_">window</span>.<span class="title function_">dispatchEvent</span>(<span class="keyword">new</span> <span class="title class_">Event</span>(<span class="string">&#x27;resize&#x27;</span>));</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">sync</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (pending) <span class="keyword">return</span>;</span><br><span class="line">    pending = <span class="variable language_">window</span>.<span class="title function_">requestAnimationFrame</span>(run);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">syncSoon</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="title function_">sync</span>();</span><br><span class="line">    <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(sync, <span class="number">180</span>);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">window</span>.<span class="property">hgSideFillSync</span> = syncSoon;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">readyState</span> === <span class="string">&#x27;loading&#x27;</span>) &#123;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;DOMContentLoaded&#x27;</span>, syncSoon);</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    <span class="title function_">syncSoon</span>();</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  mq.<span class="title function_">addEventListener</span>(<span class="string">&#x27;change&#x27;</span>, syncSoon);</span><br><span class="line">  [<span class="string">&#x27;pjax:complete&#x27;</span>, <span class="string">&#x27;pjax:success&#x27;</span>, <span class="string">&#x27;pjax:end&#x27;</span>].<span class="title function_">forEach</span>(<span class="keyword">function</span> (<span class="params">ev</span>) &#123;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(ev, syncSoon);</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p>几个关键点：</p><ul><li><code>CARD_SELECTORS</code> 的第一项是 <code>.hg-webinfo-inline</code>，保证网站信息一定跟着展开；顺序只是搬运顺序，最终视觉顺序由 CSS 的 <code>order</code> 决定。</li><li><code>findCard()</code> 先在侧栏找，找不到网站信息时再查整个文档；网站信息在主列里，只查侧栏会漏掉。</li><li><code>GAP_MIN = 220</code> 是「侧栏比主列表高出多少才值得搬」的阈值。差得太少时不折腾，避免页面在临界点反复切换。</li><li><code>contentHeight()</code> 只看直接子元素的最底部，不读元素自身高度，绕开 flex 拉伸造成的假高度。</li><li><code>run()</code> 每次先 <code>restore()</code> 再重新判断，保证无论上次搬到哪一步，这一轮都从完整布局开始算，不会越搬越偏。</li><li><code>restore()</code> 把网站信息放回主列、侧栏卡放回原处，然后同时清理主列和侧栏里的旧占位注释。</li><li><code>moveToHost()</code> 会去掉 <code>wow</code>，并把 <code>visibility</code> 和 <code>animationName</code> 写成内联值。不处理的话，卡片在首屏之外会一直停在入场动画的透明状态。</li><li>最后给容器加上 <code>hg-fill-has-welcome</code> / <code>hg-fill-has-countdown</code>，CSS 靠这两个类决定欢迎卡和倒计时是并排还是单独铺满。</li><li>每次搬完派发一次 <code>resize</code>，让目录、距离估算等依赖尺寸的模块重新计算。</li></ul><p>DOM 里看到 <code>&lt;!--hg-side-fill-slot--&gt;</code> 是正常的，它正在替卡片占着原来的位置；卡片全部放回后脚本会清掉这些注释。</p><h2 id="第二步：让卡片在新容器里保持原样"><a href="#第二步：让卡片在新容器里保持原样" class="headerlink" title="第二步：让卡片在新容器里保持原样"></a>第二步：让卡片在新容器里保持原样</h2><p>卡片搬到 <code>#hg-side-fill</code> 后，已经不在 <code>#aside-content</code> 下面了。原来只写给侧栏的底色、夜间模式和欢迎卡内部样式都会失配，需要把新容器加进选择器。</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：在你已有的规则上改选择器，不要另写一份覆盖。</p><p>如果已有卡片底色规则：</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* 原来只有侧栏 */</span></span><br><span class="line"><span class="selector-id">#aside-content</span> <span class="selector-class">.card-widget</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--trans-light);</span><br><span class="line">  backdrop-<span class="attribute">filter</span>: <span class="built_in">var</span>(--backdrop-filter);</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">18px</span>;</span><br><span class="line">  <span class="attribute">border</span>: <span class="built_in">var</span>(--border-style);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 改成侧栏和展开容器共用 */</span></span><br><span class="line"><span class="selector-id">#aside-content</span> <span class="selector-class">.card-widget</span>,</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-widget</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--trans-light);</span><br><span class="line">  backdrop-<span class="attribute">filter</span>: <span class="built_in">var</span>(--backdrop-filter);</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">18px</span>;</span><br><span class="line">  <span class="attribute">border</span>: <span class="built_in">var</span>(--border-style);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>夜间模式和性能模式的规则同样处理，在对应选择器列表里补 <code>.hg-side-fill &gt; .card-widget</code>：</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#aside-content</span> <span class="selector-class">.card-widget</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-widget</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--trans-dark);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>第 52 节里写给欢迎卡、倒计时的选择器，也要从 <code>#aside-content</code> 扩成 <code>:is(#aside-content, .hg-side-fill)</code>。例如：</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-pseudo">:is</span>(<span class="selector-id">#aside-content</span>, <span class="selector-class">.hg-side-fill</span>) <span class="selector-class">.hg-welcome-card</span> <span class="selector-class">.hg-welcome-greet</span> &#123;</span><br><span class="line">  <span class="comment">/* 原有样式不动 */</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-pseudo">:is</span>(<span class="selector-id">#aside-content</span>, <span class="selector-class">.hg-side-fill</span>) <span class="selector-class">.hg-countdown-card</span> <span class="selector-class">.hg-cd-row</span> &#123;</span><br><span class="line">  <span class="comment">/* 原有样式不动 */</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>把所有 <code>#aside-content .hg-welcome-card</code>、<code>#aside-content .hg-countdown-card</code> 按这个写法替换一遍即可，不需要复制整套样式。公告卡和那年今日的样式本来就是全局类名，不用改。</p><p>网站信息卡原本挂在主列，搬进容器后 <code>#recent-posts &gt; .hg-webinfo-inline</code> 的底色和阴影不再命中；第三步的容器样式会统一补内边距、去掉顶部边框，并让它继承卡片底色。</p><p>还有一个容易漏掉的点：侧栏卡片的 <code>20px 24px</code> 内边距写在 <code>#aside-content</code> 作用域里，卡片搬出去后这段规则也失效，标题会直接贴到卡片边缘。第三步会给欢迎、倒计时、公告、那年今日统一补 <code>20px 24px</code>，网站信息用 <code>20px 26px</code>，和原侧栏保持一致。</p><h2 id="第三步：全宽容器与美化"><a href="#第三步：全宽容器与美化" class="headerlink" title="第三步：全宽容器与美化"></a>第三步：全宽容器与美化</h2><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br><span class="line">84</span><br><span class="line">85</span><br><span class="line">86</span><br><span class="line">87</span><br><span class="line">88</span><br><span class="line">89</span><br><span class="line">90</span><br><span class="line">91</span><br><span class="line">92</span><br><span class="line">93</span><br><span class="line">94</span><br><span class="line">95</span><br><span class="line">96</span><br><span class="line">97</span><br><span class="line">98</span><br><span class="line">99</span><br><span class="line">100</span><br><span class="line">101</span><br><span class="line">102</span><br><span class="line">103</span><br><span class="line">104</span><br><span class="line">105</span><br><span class="line">106</span><br><span class="line">107</span><br><span class="line">108</span><br><span class="line">109</span><br><span class="line">110</span><br><span class="line">111</span><br><span class="line">112</span><br><span class="line">113</span><br><span class="line">114</span><br><span class="line">115</span><br><span class="line">116</span><br><span class="line">117</span><br><span class="line">118</span><br><span class="line">119</span><br><span class="line">120</span><br><span class="line">121</span><br><span class="line">122</span><br><span class="line">123</span><br><span class="line">124</span><br><span class="line">125</span><br><span class="line">126</span><br><span class="line">127</span><br><span class="line">128</span><br><span class="line">129</span><br><span class="line">130</span><br><span class="line">131</span><br><span class="line">132</span><br><span class="line">133</span><br><span class="line">134</span><br><span class="line">135</span><br><span class="line">136</span><br><span class="line">137</span><br><span class="line">138</span><br><span class="line">139</span><br><span class="line">140</span><br><span class="line">141</span><br><span class="line">142</span><br><span class="line">143</span><br><span class="line">144</span><br><span class="line">145</span><br><span class="line">146</span><br><span class="line">147</span><br><span class="line">148</span><br><span class="line">149</span><br><span class="line">150</span><br><span class="line">151</span><br><span class="line">152</span><br><span class="line">153</span><br><span class="line">154</span><br><span class="line">155</span><br><span class="line">156</span><br><span class="line">157</span><br><span class="line">158</span><br><span class="line">159</span><br><span class="line">160</span><br><span class="line">161</span><br><span class="line">162</span><br><span class="line">163</span><br><span class="line">164</span><br><span class="line">165</span><br><span class="line">166</span><br><span class="line">167</span><br><span class="line">168</span><br><span class="line">169</span><br><span class="line">170</span><br><span class="line">171</span><br><span class="line">172</span><br><span class="line">173</span><br><span class="line">174</span><br><span class="line">175</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* ===== 列表页托底：文章不足一行时，网站信息与侧栏卡下移全宽展开 ===== */</span></span><br><span class="line"><span class="selector-id">#content-inner</span><span class="selector-class">.hg-side-fill-on</span> &#123;</span><br><span class="line">  <span class="attribute">flex-wrap</span>: wrap;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#content-inner</span><span class="selector-class">.hg-side-fill-on</span> &gt; <span class="selector-class">.hg-side-fill</span> &#123;</span><br><span class="line">  <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: grid;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">12</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">18px</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">22px</span> <span class="number">0</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:empty</span> &#123; <span class="attribute">display</span>: none; &#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-widget</span> &#123;</span><br><span class="line">  <span class="attribute">position</span>: relative;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">flex-direction</span>: column;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">18px</span>;</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">  <span class="attribute">transition</span>: transform .<span class="number">22s</span> ease, box-shadow .<span class="number">22s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-widget</span> &gt; <span class="selector-class">.card-content</span> &#123;</span><br><span class="line">  <span class="attribute">flex</span>: <span class="number">1</span> <span class="number">1</span> auto;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-widget</span><span class="selector-pseudo">::before</span> &#123;</span><br><span class="line">  <span class="attribute">content</span>: <span class="string">&quot;&quot;</span>;</span><br><span class="line">  <span class="attribute">position</span>: absolute;</span><br><span class="line">  inset: <span class="number">0</span> <span class="number">0</span> auto;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">3px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">linear-gradient</span>(<span class="number">90deg</span>, <span class="built_in">var</span>(--theme-color), <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--theme-color) <span class="number">16%</span>, transparent));</span><br><span class="line">  <span class="attribute">opacity</span>: .<span class="number">55</span>;</span><br><span class="line">  <span class="attribute">pointer-events</span>: none;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-widget</span><span class="selector-pseudo">:hover</span> &#123;</span><br><span class="line">  <span class="attribute">transform</span>: <span class="built_in">translateY</span>(-<span class="number">2px</span>);</span><br><span class="line">  <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">10px</span> <span class="number">26px</span> <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--theme-color) <span class="number">16%</span>, transparent);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-webinfo-inline</span>,</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-announcement</span>,</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> &#123;</span><br><span class="line">  <span class="attribute">grid-column</span>: <span class="number">1</span> / -<span class="number">1</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-welcome-card</span> &#123; <span class="attribute">grid-column</span>: span <span class="number">7</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-countdown-card</span> &#123; <span class="attribute">grid-column</span>: span <span class="number">5</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-widget</span><span class="selector-pseudo">:only-child</span> &#123; <span class="attribute">grid-column</span>: <span class="number">1</span> / -<span class="number">1</span>; &#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:not</span>(<span class="selector-class">.hg-fill-has-countdown</span>) &gt; <span class="selector-class">.hg-welcome-card</span>,</span><br><span class="line"><span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:not</span>(<span class="selector-class">.hg-fill-has-welcome</span>) &gt; <span class="selector-class">.hg-countdown-card</span> &#123;</span><br><span class="line">  <span class="attribute">grid-column</span>: <span class="number">1</span> / -<span class="number">1</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-webinfo-inline</span> &#123; <span class="attribute">order</span>: <span class="number">0</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-announcement</span> &#123; <span class="attribute">order</span>: <span class="number">1</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-welcome-card</span> &#123; <span class="attribute">order</span>: <span class="number">2</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-countdown-card</span> &#123; <span class="attribute">order</span>: <span class="number">3</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> &#123; <span class="attribute">order</span>: <span class="number">4</span>; &#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-welcome-card</span>,</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-countdown-card</span>,</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-announcement</span>,</span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> &#123;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">20px</span> <span class="number">24px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-webinfo-inline</span> &#123;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">20px</span> <span class="number">26px</span>;</span><br><span class="line">  <span class="attribute">border-top</span>: <span class="number">0</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-webinfo-inline</span> &gt; <span class="selector-class">.webinfo</span> &#123;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">4</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">10px</span> <span class="number">32px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-announcement</span> <span class="selector-class">.hg-announce__items</span> &#123;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">2</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">10px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-welcome-card</span> <span class="selector-class">.card-content</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">flex-direction</span>: column;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">100%</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-welcome-card</span> <span class="selector-class">.hg-welcome-poem</span> &#123;</span><br><span class="line">  <span class="attribute">margin-top</span>: auto;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-countdown-card</span> <span class="selector-class">.card-content</span> &#123;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">100%</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:not</span>(<span class="selector-class">.hg-fill-has-countdown</span>) &gt; <span class="selector-class">.hg-welcome-card</span> <span class="selector-class">.card-content</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: grid;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr) <span class="built_in">minmax</span>(<span class="number">220px</span>, <span class="number">340px</span>);</span><br><span class="line">  <span class="attribute">column-gap</span>: <span class="number">28px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:not</span>(<span class="selector-class">.hg-fill-has-countdown</span>) &gt; <span class="selector-class">.hg-welcome-card</span> <span class="selector-class">.item-headline</span> &#123;</span><br><span class="line">  <span class="attribute">grid-column</span>: <span class="number">1</span> / -<span class="number">1</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:not</span>(<span class="selector-class">.hg-fill-has-countdown</span>) &gt; <span class="selector-class">.hg-welcome-card</span> <span class="selector-class">.hg-welcome-poem</span> &#123;</span><br><span class="line">  <span class="attribute">grid-column</span>: <span class="number">2</span>;</span><br><span class="line">  <span class="attribute">grid-row</span>: <span class="number">2</span> / span <span class="number">3</span>;</span><br><span class="line">  <span class="attribute">align-self</span>: center;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">text-align</span>: right;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> <span class="selector-class">.card-content</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">30px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> <span class="selector-class">.item-headline</span> &#123;</span><br><span class="line">  <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> auto;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">0</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> <span class="selector-id">#history-baidu</span> &#123;</span><br><span class="line">  <span class="attribute">flex</span>: <span class="number">1</span> <span class="number">1</span> auto;</span><br><span class="line">  <span class="attribute">min-width</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">width</span>: auto;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">100px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> <span class="selector-class">.history_slide</span> &#123;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">justify-content</span>: center;</span><br><span class="line">  <span class="attribute">text-align</span>: center;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-history</span> <span class="selector-class">.history_slide_link</span> &#123;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">1.02em</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">max-width</span>: <span class="number">1099px</span>) &#123;</span><br><span class="line">  <span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-webinfo-inline</span> &gt; <span class="selector-class">.webinfo</span> &#123;</span><br><span class="line">    <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">3</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-welcome-card</span>,</span><br><span class="line">  <span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.hg-countdown-card</span> &#123;</span><br><span class="line">    <span class="attribute">grid-column</span>: span <span class="number">6</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:not</span>(<span class="selector-class">.hg-fill-has-countdown</span>) &gt; <span class="selector-class">.hg-welcome-card</span>,</span><br><span class="line">  <span class="selector-class">.hg-side-fill</span><span class="selector-pseudo">:not</span>(<span class="selector-class">.hg-fill-has-welcome</span>) &gt; <span class="selector-class">.hg-countdown-card</span> &#123;</span><br><span class="line">    <span class="attribute">grid-column</span>: <span class="number">1</span> / -<span class="number">1</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">min-width</span>: <span class="number">1200px</span>) &#123;</span><br><span class="line">  <span class="selector-class">.hg-side-fill</span> &gt; <span class="selector-class">.card-announcement</span> <span class="selector-class">.hg-announce__items</span> &#123;</span><br><span class="line">    <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">4</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>布局逻辑：</p><ul><li><code>#content-inner.hg-side-fill-on</code> 打开 <code>flex-wrap</code>，让下面的全宽容器能换到新一行。</li><li><code>#hg-side-fill</code> 占满整行，内部是 12 列网格：网站信息、公告、那年今日各占一整行，欢迎来访占 7 列、倒计时占 5 列。</li><li>屏幕宽度小于 <code>1100px</code> 时，欢迎和倒计时改成 6 / 6 平分，避免倒计时进度条被挤得太窄。</li><li>用 <code>order</code> 固定视觉顺序：网站信息 → 公告 → 欢迎来访 → 倒计时 → 那年今日。DOM 的搬运顺序和视觉顺序可以不同，pjax 往返后也不会乱。</li><li>容器带 <code>hg-fill-has-countdown</code> 时才并排；没有倒计时，欢迎卡自动铺满整行，并改成左右分栏、诗句在右，避免一整条横卡只有左边一小段字。</li><li>网站信息在容器里固定 4 列（窄屏 3 列），每个统计项两侧对齐；那年今日改成横向紧凑条，标题在左、日期和事件居中，不再是一整条空卡。</li><li>搬出来的卡片会丢失侧栏内边距，所以欢迎、倒计时、公告、那年今日统一补 <code>20px 24px</code>，网站信息补 <code>20px 26px</code>；不补的话标题和链接会贴边。</li><li>屏幕宽度到 <code>1200px</code> 以上时，公告里的入口从两列变四列。</li></ul><h2 id="第四步：接入加载顺序与欢迎卡刷新"><a href="#第四步：接入加载顺序与欢迎卡刷新" class="headerlink" title="第四步：接入加载顺序与欢迎卡刷新"></a>第四步：接入加载顺序与欢迎卡刷新</h2><p>在主题配置的底部注入里加脚本，放在 <code>list-webinfo.js</code> 后面：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：找到 <code>inject.bottom</code>，在 <code>list-webinfo.js</code> 那一行后面补一行。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/list-webinfo.js?v=20261122b&quot;&gt;&lt;/script&gt;</span> <span class="comment">#列表页：网站信息卡移到文章底部</span></span><br><span class="line"><span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/list-side-fill.js?v=20261123g&quot;&gt;&lt;/script&gt;</span> <span class="comment">#列表页：文章不足时网站信息与侧栏卡下移展开</span></span><br></pre></td></tr></table></figure><p>改过脚本后，<code>?v=</code> 参数要升一次，配合 Service Worker 时 <code>sw.js</code> 的 <code>VERSION</code> 也要一起升。</p><p>「欢迎来访」和「倒计时」有自己的重建函数。刷新或 pjax 之后，旧卡片被删、新卡片重新挂回侧栏，如果不再同步一次，展开区里可能还留着旧卡片，新卡片却挤在侧栏。所以在 <code>refresh()</code> 的 <code>mount()</code> 后面补一行：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/welcome-card.js</code> ｜ <strong>改法</strong>：在已有 <code>refresh()</code> 函数内补一行。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">refresh</span> () &#123;</span><br><span class="line">  <span class="title function_">unmount</span>()</span><br><span class="line">  geoLoaded = <span class="literal">false</span></span><br><span class="line">  <span class="keyword">var</span> old = d.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;.hg-welcome-card, .hg-countdown-card&#x27;</span>)</span><br><span class="line">  <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; old.<span class="property">length</span>; i++) &#123;</span><br><span class="line">    <span class="keyword">if</span> (old[i].<span class="property">parentNode</span>) old[i].<span class="property">parentNode</span>.<span class="title function_">removeChild</span>(old[i])</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="title function_">mount</span>()</span><br><span class="line">  <span class="keyword">if</span> (w.<span class="property">hgSideFillSync</span>) w.<span class="title function_">hgSideFillSync</span>()</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>hgSideFillSync</code> 是 <code>list-side-fill.js</code> 暴露到 <code>window</code> 的入口。没有这个函数时判断一下再调用，脚本顺序变了也不会报错。</p><h2 id="调参与边界"><a href="#调参与边界" class="headerlink" title="调参与边界"></a>调参与边界</h2><ul><li><strong>什么时候不启用</strong>：窗口小于 <code>900px</code>、页面没有文章、找不到 <code>#aside-content</code> 或 <code>#content-inner</code> 时直接返回，不做任何移动。</li><li><strong>只处理列表页</strong>：主容器按 <code>recent-posts</code>、<code>category</code>、<code>tag</code> 依次查找，文章页和独立页面不参与。</li><li><strong>搬哪些卡</strong>：选择器顺序是 <code>.hg-webinfo-inline</code>、<code>.hg-welcome-card</code>、<code>.hg-countdown-card</code>、<code>.card-announcement</code>、<code>.card-history</code>。想少搬一张，从数组里删掉对应项；想改变视觉顺序，改 CSS 的 <code>order</code>，不要改 JS 的搬运顺序。</li><li><strong>阈值不合适</strong>：文章卡片特别高或特别矮时，把 <code>GAP_MIN</code> 调大，侧栏要高出更多才展开；调小则更容易展开。本站用 <code>220</code>。</li><li><strong>单卡不好看</strong>：只剩欢迎卡时，CSS 的 <code>:not(.hg-fill-has-countdown)</code> 规则会把它改成左右分栏；如果主题结构不同，把这段删掉，只保留单列也能用。</li></ul><h2 id="改完怎么验证"><a href="#改完怎么验证" class="headerlink" title="改完怎么验证"></a>改完怎么验证</h2><ol><li><strong>生成</strong>：在博客根目录执行 <code>./node_modules/.bin/hexo generate</code>，确认最后一行是 <code>Generated</code>。</li><li><strong>短列表</strong>：找文章最少的一页（本站是第 4 页，3 篇），桌面宽度下检查：<ul><li>文章下方出现一条横跨主栏和侧栏的展开区；</li><li>网站信息第一行铺满，统计项按四列排开；</li><li>公告铺满一行，欢迎来访和倒计时按 7 / 5 并排；</li><li>右栏保留作者卡或那年今日，没有被搬空；</li><li>标题、公告入口和倒计时与卡片边缘之间保留内边距，没有贴边；</li><li>页面没有横向滚动条。</li></ul></li><li><strong>动态回收</strong>：临时复制文章卡片，分别凑到 4、6、8、12 篇，每次调用一次 <code>window.hgSideFillSync()</code>。数量应逐级减少，12 篇时容器消失、全部卡片回到侧栏，顺序和原来一致。</li><li><strong>手机端</strong>：把宽度缩到 <code>390px</code>，确认展开容器被移除、网站信息回到侧栏、所有卡片归位，页面可以整页向下滑，不出现内部滚动条。</li><li><strong>pjax</strong>：从首页点到第 4 页，再返回首页，确认 <code>#hg-side-fill</code> 只有一个，没有重复容器，也没有卡片丢失。</li><li><strong>硬刷新</strong>：改过 CSS / JS 后按 <code>Ctrl + F5</code>；启用了 Service Worker 的话，到 DevTools → Application → Service Workers 点一次 <code>Update</code>。</li></ol><div class="note info modern"><p>本篇先收录第 61 个魔改。后面新增的桌面布局与列表页细节会按顺序补进（六），不再拆新篇，保证「每 10 个魔改左右一章」的节奏。</p></div>]]>
    </content>
    <id>https://cookiesky.cn/2026/11/23/hexo-magic6/</id>
    <link href="https://cookiesky.cn/2026/11/23/hexo-magic6/"/>
    <published>2026-11-22T17:10:00.000Z</published>
    <summary>hexo魔改教程（六）</summary>
    <title>hexo魔改教程（六）</title>
    <updated>2026-11-22T17:12:15.687Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a><br>本篇是第 51 ~ 60 个魔改，主要讲首页多栏、侧栏卡片、画廊、旧时光、公告入口、Cookie 同意与缓存资源，适用 <code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code>。友人帐、关于页、RSS、归档页和评论区已经在（四）里写过，这里不重复。</li></ul></div><div class="note info modern"><p>阅读约定：每个代码块上方都标了 <strong>文件</strong> 和 <strong>改法</strong>。<code>[Blogroot]</code> 指博客根目录；「新建」是建文件后整段写入，「追加」是放到文件末尾，「替换 / 放在某函数里」是在已有文件里改对应位置。标「关键段」的代码是拆解说明，完整文件按同目录的实际文件对照补齐。</p></div><details class="folding-tag" blue><summary> 这十节分别改哪里 </summary>              <div class='content'>              <ul><li>51：首页多栏卡片，三栏 / 双栏与五边形封面</li><li>52：侧栏「欢迎来访」与「倒计时」</li><li>53：网站信息卡移到列表底部横排</li><li>54：画廊分类大厅与瀑布流</li><li>55：旧时光按年份分类与跳转</li><li>56：公告卡改造与手机侧边菜单入口</li><li>57：Cookie 同意与第三方服务门控</li><li>58：Service Worker 静态资源缓存</li><li>59：图片、字体与前端资源的瘦身</li><li>60：订阅源 BOM 与 <code>custom.css</code> 截断修复</li></ul><p>路径统一用 <code>[Blogroot]</code> 表示博客根目录。自定义样式放在 <code>[Blogroot]/source/css/</code>，脚本放在 <code>[Blogroot]/source/js/</code>，构建脚本放在 <code>[Blogroot]/scripts/</code>，不改主题源码。</p>              </div>            </details><h1 id="51-首页多栏：三栏卡片与五边形封面"><a href="#51-首页多栏：三栏卡片与五边形封面" class="headerlink" title="51. 首页多栏：三栏卡片与五边形封面"></a>51. 首页多栏：三栏卡片与五边形封面</h1><p><code>Butterfly 5.x</code> 的首页列表多了一层 <code>.recent-post-items</code> 包裹，旧版直接写 <code>#recent-posts &gt; .recent-post-item</code> 的双栏样式会全部失配。重写时干脆换个思路：把多栏做成开关，只有 <code>&lt;html&gt;</code> 带 <code>hg-article-multi</code> 时才生效。</p><p>先在 <code>_config.yml</code> 里加一个站点级开关：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code> ｜ <strong>改法</strong>：在文件末尾追加这两行；如果已有同名配置，直接改原值。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment"># 首页文章多栏：true 时默认三栏，中屏自动两栏</span></span><br><span class="line"><span class="attr">butterfly_article_double_row:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br></pre></td></tr></table></figure><p>构建期给 <code>&lt;html&gt;</code> 加类，并记住默认值，供美化设置里的「恢复默认」使用：</p><p><strong>文件</strong>：<code>[Blogroot]/scripts/article-layout.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；<code>scripts</code> 目录不存在就自己在博客根目录建一个。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\scripts\article-layout.js */</span></span><br><span class="line"><span class="meta">&#x27;use strict&#x27;</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">const</span> on = (<span class="function">() =&gt;</span> &#123;</span><br><span class="line">  <span class="keyword">const</span> cfg = hexo.<span class="property">config</span>.<span class="property">butterfly_article_double_row</span> || &#123;&#125;;</span><br><span class="line">  <span class="keyword">return</span> cfg.<span class="property">enable</span> === <span class="literal">true</span> || cfg.<span class="property">enable</span> === <span class="string">&#x27;true&#x27;</span> || cfg.<span class="property">enable</span> === <span class="number">1</span>;</span><br><span class="line">&#125;)();</span><br><span class="line"></span><br><span class="line">hexo.<span class="property">extend</span>.<span class="property">filter</span>.<span class="title function_">register</span>(<span class="string">&#x27;after_render:html&#x27;</span>, <span class="keyword">function</span> (<span class="params">html</span>) &#123;</span><br><span class="line">  <span class="keyword">return</span> html.<span class="title function_">replace</span>(<span class="regexp">/&lt;html\b([^&gt;]*)&gt;/</span>, <span class="function">(<span class="params">match, attrs</span>) =&gt;</span> &#123;</span><br><span class="line">    <span class="keyword">const</span> flag = <span class="string">&#x27; data-article-default=&quot;&#x27;</span> + (on ? <span class="string">&#x27;1&#x27;</span> : <span class="string">&#x27;0&#x27;</span>) + <span class="string">&#x27;&quot;&#x27;</span>;</span><br><span class="line">    <span class="keyword">if</span> (!on) <span class="keyword">return</span> <span class="string">&#x27;&lt;html&#x27;</span> + attrs + flag + <span class="string">&#x27;&gt;&#x27;</span>;</span><br><span class="line">    <span class="keyword">if</span> (<span class="regexp">/class=([&quot;&#x27;])/</span>.<span class="title function_">test</span>(attrs)) &#123;</span><br><span class="line">      attrs = attrs.<span class="title function_">replace</span>(<span class="regexp">/class=([&quot;&#x27;])(.*?)\1/</span>, <span class="function">(<span class="params">m, q, list</span>) =&gt;</span> <span class="string">&#x27;class=&quot;&#x27;</span> + list + <span class="string">&#x27; hg-article-multi&quot;&#x27;</span>);</span><br><span class="line">      <span class="keyword">return</span> <span class="string">&#x27;&lt;html&#x27;</span> + attrs + flag + <span class="string">&#x27;&gt;&#x27;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="string">&#x27;&lt;html&#x27;</span> + attrs + <span class="string">&#x27; class=&quot;hg-article-multi&quot;&#x27;</span> + flag + <span class="string">&#x27;&gt;&#x27;</span>;</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p>为什么用构建期加类，而不是直接在模板里写死？因为美化设置面板要能实时切换多栏，类挂在 <code>&lt;html&gt;</code> 上最方便；而 <code>data-article-default</code> 保存构建默认值，用户点「恢复默认」时能回到配置里的状态，不会和面板的临时选择打架。</p><p>CSS 的核心是容器改 Flex，卡片固定「封面 200px + 信息 150px」：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">flex-wrap</span>: wrap;</span><br><span class="line">  <span class="attribute">align-content</span>: flex-start;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">0</span> <span class="number">5px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &#123;</span><br><span class="line">  <span class="attribute">position</span>: relative;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">flex-direction</span>: column;</span><br><span class="line">  <span class="attribute">height</span>: auto <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">max-height</span>: <span class="number">350px</span>;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">20px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">15px</span>;</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>五边形封面靠 <code>clip-path</code>，底部留一个尖角：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：紧接上一段样式追加，仍放在多栏样式区域内。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.post_cover</span> &#123;</span><br><span class="line">  <span class="attribute">order</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">200px</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">200px</span>;</span><br><span class="line">  <span class="attribute">clip-path</span>: <span class="built_in">polygon</span>(<span class="number">0</span> <span class="number">130px</span>, <span class="number">0</span> <span class="number">0</span>, <span class="number">100%</span> <span class="number">0</span>, <span class="number">100%</span> <span class="number">130px</span>, <span class="number">50%</span> <span class="number">100%</span>);</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>摘要不是挂在信息区下面，而是绝对定位压回封面上，形成一层半透明遮罩：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：紧接上一段样式追加。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.recent-post-info</span> &gt; <span class="selector-class">.content</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">justify-content</span>: center;</span><br><span class="line">  <span class="attribute">position</span>: absolute;</span><br><span class="line">  <span class="attribute">top</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">left</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">200px</span>;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">25</span>, <span class="number">25</span>, <span class="number">25</span>, .<span class="number">4</span>);</span><br><span class="line">  <span class="attribute">clip-path</span>: <span class="built_in">polygon</span>(<span class="number">0</span> <span class="number">130px</span>, <span class="number">0</span> <span class="number">0</span>, <span class="number">100%</span> <span class="number">0</span>, <span class="number">100%</span> <span class="number">130px</span>, <span class="number">50%</span> <span class="number">100%</span>);</span><br><span class="line">  <span class="attribute">pointer-events</span>: none;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.recent-post-info</span> &gt; <span class="selector-class">.content</span> &gt; <span class="selector-class">.content-text</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: -webkit-box;</span><br><span class="line">  -webkit-box-orient: vertical;</span><br><span class="line">  -webkit-line-clamp: <span class="number">3</span>;</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span> <span class="number">25px</span> <span class="number">30px</span>;</span><br><span class="line">  <span class="attribute">color</span>: <span class="number">#fff</span>;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">16px</span>;</span><br><span class="line">  <span class="attribute">line-height</span>: <span class="number">1.6</span>;</span><br><span class="line">  <span class="attribute">text-align</span>: center;</span><br><span class="line">  <span class="attribute">text-shadow</span>: <span class="number">1px</span> <span class="number">2px</span> <span class="number">3px</span> <span class="number">#000</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>这里有个容易翻车的点：<strong>截断必须放在内层 <code>.content-text</code> 上</strong>。摘要外层是绝对定位元素，Chrome 会把它块级化为 <code>flow-root</code>，<code>-webkit-box</code> 的截断随之失效；把 <code>-webkit-line-clamp</code> 放到真正包文字的内层才有效。</p><p>宽度和分页器：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到多栏样式末尾，分页器规则不要漏。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">min-width</span>: <span class="number">1069px</span>) &#123;</span><br><span class="line">  <span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-class">.recent-post-item</span> &#123;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">32.3%</span>;</span><br><span class="line">    <span class="attribute">margin</span>: <span class="number">0</span> <span class="number">1%</span> <span class="number">20px</span> <span class="number">0</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">min-width</span>: <span class="number">573px</span>) <span class="keyword">and</span> (<span class="attribute">max-width</span>: <span class="number">1068px</span>) &#123;</span><br><span class="line">  <span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-class">.recent-post-item</span> &#123;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">47%</span>;</span><br><span class="line">    <span class="attribute">margin</span>: <span class="number">0</span> <span class="number">3%</span> <span class="number">20px</span> <span class="number">0</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 分页器必须独占整行，否则会被塞进卡片缝隙 */</span></span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.pagination</span>,</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-id">#pagination</span>,</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-article-multi</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-tag">nav</span> &#123;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">100%</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>三栏时每页文章数最好取 3 的倍数，本站用 <code>12</code> 篇，正好铺满四行。注意手机宽度下不加多栏，保持主题原来的单列，否则摘要叠层会把小屏挤爆。</p><h1 id="52-侧栏：欢迎来访与倒计时"><a href="#52-侧栏：欢迎来访与倒计时" class="headerlink" title="52. 侧栏：欢迎来访与倒计时"></a>52. 侧栏：欢迎来访与倒计时</h1><p>这两张卡只在首页出现，挂在侧栏 <code>.sticky_layout</code> 里、个人信息卡后面。脚本先判断首页标志 <code>#recent-posts</code>，避免在文章页和独立页面误插：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/welcome-card.js</code> ｜ <strong>改法</strong>：新建文件；完整源码可打开本站 <code>/js/fomal/welcome-card.js</code> 对照，下面先拆 <code>mount()</code> 关键段。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\source\js\fomal\welcome-card.js 节选 */</span></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">mount</span> () &#123;</span><br><span class="line">  <span class="keyword">if</span> (!d.<span class="title function_">getElementById</span>(<span class="string">&#x27;recent-posts&#x27;</span>)) <span class="keyword">return</span></span><br><span class="line">  <span class="keyword">var</span> sticky = d.<span class="title function_">querySelector</span>(<span class="string">&#x27;#aside-content .sticky_layout&#x27;</span>)</span><br><span class="line">  <span class="keyword">if</span> (!sticky) <span class="keyword">return</span></span><br><span class="line">  <span class="keyword">if</span> (d.<span class="title function_">getElementById</span>(<span class="string">&#x27;hg-welcome-greet&#x27;</span>)) <span class="keyword">return</span></span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> info = sticky.<span class="title function_">querySelector</span>(<span class="string">&#x27;.card-info&#x27;</span>)</span><br><span class="line">  <span class="keyword">if</span> (info) info.<span class="title function_">insertAdjacentHTML</span>(<span class="string">&#x27;afterend&#x27;</span>, <span class="title function_">welcomeHTML</span>() + <span class="title function_">countdownHTML</span>())</span><br><span class="line">  <span class="keyword">else</span> sticky.<span class="title function_">insertAdjacentHTML</span>(<span class="string">&#x27;afterbegin&#x27;</span>, <span class="title function_">welcomeHTML</span>() + <span class="title function_">countdownHTML</span>())</span><br><span class="line"></span><br><span class="line">  <span class="title function_">setPoem</span>()</span><br><span class="line">  <span class="title function_">loadGeo</span>()</span><br><span class="line">  <span class="title function_">tick</span>()</span><br><span class="line">  <span class="keyword">if</span> (timer) w.<span class="built_in">clearInterval</span>(timer)</span><br><span class="line">  timer = w.<span class="built_in">setInterval</span>(tick, <span class="number">60000</span>)</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>问候语按小时切换，诗句从本地数组随机抽，避免连续两次抽到同一句：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/welcome-card.js</code> ｜ <strong>改法</strong>：放在 <code>randomPoem()</code> 函数里，替换同名逻辑。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> lastPoem = -<span class="number">1</span></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">randomPoem</span> () &#123;</span><br><span class="line">  <span class="keyword">var</span> i = <span class="title class_">Math</span>.<span class="title function_">floor</span>(<span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="variable constant_">POEMS</span>.<span class="property">length</span>)</span><br><span class="line">  <span class="keyword">if</span> (i === lastPoem &amp;&amp; <span class="variable constant_">POEMS</span>.<span class="property">length</span> &gt; <span class="number">1</span>) i = (i + <span class="number">1</span>) % <span class="variable constant_">POEMS</span>.<span class="property">length</span></span><br><span class="line">  lastPoem = i</span><br><span class="line">  <span class="keyword">return</span> <span class="variable constant_">POEMS</span>[i]</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>倒计时全部用本地时间算，不发请求。今日、本周、本月、本年四条进度各自算百分比和剩余量：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/welcome-card.js</code> ｜ <strong>改法</strong>：放在 <code>pctRows()</code> 函数里；今日、本周、本月、本年的计算都在这一个函数。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">pctRows</span> (now) &#123;</span><br><span class="line">  <span class="keyword">var</span> day = (now.<span class="title function_">getHours</span>() * <span class="number">3600</span> + now.<span class="title function_">getMinutes</span>() * <span class="number">60</span> + now.<span class="title function_">getSeconds</span>()) / <span class="number">86400</span></span><br><span class="line">  <span class="keyword">var</span> weekDay = (now.<span class="title function_">getDay</span>() + <span class="number">6</span>) % <span class="number">7</span></span><br><span class="line">  <span class="keyword">var</span> week = (weekDay + day) / <span class="number">7</span></span><br><span class="line">  <span class="keyword">var</span> daysInMonth = <span class="keyword">new</span> <span class="title class_">Date</span>(now.<span class="title function_">getFullYear</span>(), now.<span class="title function_">getMonth</span>() + <span class="number">1</span>, <span class="number">0</span>).<span class="title function_">getDate</span>()</span><br><span class="line">  <span class="keyword">var</span> month = (now.<span class="title function_">getDate</span>() - <span class="number">1</span> + day) / daysInMonth</span><br><span class="line">  <span class="keyword">var</span> daysInYear = ((now.<span class="title function_">getFullYear</span>() % <span class="number">4</span> === <span class="number">0</span> &amp;&amp; now.<span class="title function_">getFullYear</span>() % <span class="number">100</span> !== <span class="number">0</span>) || now.<span class="title function_">getFullYear</span>() % <span class="number">400</span> === <span class="number">0</span>) ? <span class="number">366</span> : <span class="number">365</span></span><br><span class="line">  <span class="keyword">var</span> year = (<span class="title function_">dayOfYear</span>(now) - <span class="number">1</span> + day) / daysInYear</span><br><span class="line">  <span class="keyword">return</span> [</span><br><span class="line">    &#123; <span class="attr">pct</span>: day, <span class="attr">left</span>: <span class="string">&#x27;剩 &#x27;</span> + <span class="title class_">Math</span>.<span class="title function_">ceil</span>(<span class="number">24</span> - now.<span class="title function_">getHours</span>() - now.<span class="title function_">getMinutes</span>() / <span class="number">60</span>) + <span class="string">&#x27; 小时&#x27;</span> &#125;,</span><br><span class="line">    &#123; <span class="attr">pct</span>: week, <span class="attr">left</span>: <span class="string">&#x27;剩 &#x27;</span> + (<span class="number">7</span> - weekDay) + <span class="string">&#x27; 天&#x27;</span> &#125;,</span><br><span class="line">    &#123; <span class="attr">pct</span>: month, <span class="attr">left</span>: <span class="string">&#x27;剩 &#x27;</span> + (daysInMonth - now.<span class="title function_">getDate</span>() + <span class="number">1</span>) + <span class="string">&#x27; 天&#x27;</span> &#125;,</span><br><span class="line">    &#123; <span class="attr">pct</span>: year, <span class="attr">left</span>: <span class="string">&#x27;剩 &#x27;</span> + (daysInYear - <span class="title function_">dayOfYear</span>(now) + <span class="number">1</span>) + <span class="string">&#x27; 天&#x27;</span> &#125;</span><br><span class="line">  ]</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>来访地区属于第三方请求，必须受 Cookie 同意门控。没同意时只显示「地区显示未开启」，点一下还能打开 Cookie 设置：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/welcome-card.js</code> ｜ <strong>改法</strong>：替换 <code>loadGeo()</code> 前半段；后面的接口请求与缓存保持原样。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">loadGeo</span> () &#123;</span><br><span class="line">  <span class="keyword">if</span> (geoLoaded) <span class="keyword">return</span></span><br><span class="line">  <span class="keyword">var</span> allowed = w.<span class="property">hgConsent</span> &amp;&amp; w.<span class="property">hgConsent</span>.<span class="property">granted</span> ? w.<span class="property">hgConsent</span>.<span class="title function_">granted</span>(<span class="string">&#x27;analytics&#x27;</span>) : <span class="literal">false</span></span><br><span class="line">  <span class="keyword">if</span> (!allowed) &#123;</span><br><span class="line">    <span class="title function_">setRegion</span>(<span class="string">&#x27;地区显示未开启&#x27;</span>, <span class="string">&#x27;距离信息未开启&#x27;</span>)</span><br><span class="line">    <span class="keyword">var</span> hint = $(<span class="string">&#x27;hg-welcome-region&#x27;</span>)</span><br><span class="line">    <span class="keyword">if</span> (hint) &#123;</span><br><span class="line">      hint.<span class="property">title</span> = <span class="string">&#x27;在 Cookie 设置中允许访问统计后显示&#x27;</span></span><br><span class="line">      hint.<span class="property">style</span>.<span class="property">cursor</span> = <span class="string">&#x27;pointer&#x27;</span></span><br><span class="line">      hint.<span class="property">onclick</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">if</span> (w.<span class="property">hgOpenConsent</span>) w.<span class="title function_">hgOpenConsent</span>() &#125;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span></span><br><span class="line">  &#125;</span><br><span class="line">  <span class="comment">// 主接口 api.ipapi.is，失败回退 ipwho.is；结果在 sessionStorage 缓存 6 小时</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>距离用 Haversine 公式按本站坐标估算。本站坐标是桂林，改代码时记得换成自己的经纬度：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/welcome-card.js</code> ｜ <strong>改法</strong>：改文件顶部的 <code>HOME</code> 常量，换成你所在城市的经纬度。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">HOME</span> = &#123; <span class="attr">lat</span>: <span class="number">25.2802</span>, <span class="attr">lng</span>: <span class="number">110.2964</span>, <span class="attr">name</span>: <span class="string">&#x27;桂林&#x27;</span> &#125;</span><br></pre></td></tr></table></figure><p>最后是 pjax 生命周期。pjax 往返会换掉整个侧栏，所以要清定时器、删旧卡片、重建：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/welcome-card.js</code> ｜ <strong>改法</strong>：用这两段替换文件末尾的 <code>unmount()</code> / <code>refresh()</code>，并保留 <code>hg-consent-change</code> 监听。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">unmount</span> () &#123;</span><br><span class="line">  <span class="keyword">if</span> (timer) &#123; w.<span class="built_in">clearInterval</span>(timer); timer = <span class="literal">null</span> &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">refresh</span> () &#123;</span><br><span class="line">  <span class="title function_">unmount</span>()</span><br><span class="line">  geoLoaded = <span class="literal">false</span></span><br><span class="line">  <span class="keyword">var</span> old = d.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;.hg-welcome-card, .hg-countdown-card&#x27;</span>)</span><br><span class="line">  <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; old.<span class="property">length</span>; i++) &#123;</span><br><span class="line">    <span class="keyword">if</span> (old[i].<span class="property">parentNode</span>) old[i].<span class="property">parentNode</span>.<span class="title function_">removeChild</span>(old[i])</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="title function_">mount</span>()</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;hg-consent-change&#x27;</span>, <span class="keyword">function</span> (<span class="params">event</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> state = event.<span class="property">detail</span> || &#123;&#125;</span><br><span class="line">  geoLoaded = <span class="literal">false</span></span><br><span class="line">  <span class="keyword">if</span> (state.<span class="property">analytics</span>) <span class="title function_">loadGeo</span>()</span><br><span class="line">  <span class="keyword">else</span> <span class="title function_">setRegion</span>(<span class="string">&#x27;地区显示未开启&#x27;</span>, <span class="string">&#x27;距离信息未开启&#x27;</span>)</span><br><span class="line">&#125;)</span><br></pre></td></tr></table></figure><p>卡片统一用 <code>wowjs</code> 的 <code>animate__zoomIn</code> 入场，样式全部走 <code>var(--card-bg)</code>、<code>var(--theme-color)</code> 这些变量，美化面板换色时两张卡会一起变。</p><h1 id="53-网站信息卡移到列表底部"><a href="#53-网站信息卡移到列表底部" class="headerlink" title="53. 网站信息卡移到列表底部"></a>53. 网站信息卡移到列表底部</h1><p>分类页、标签页文章少的时候，侧栏会被一张「网站信息」卡拉得很长，列表底部反而空一大片。处理办法是：桌面端把 <code>.card-webinfo</code> 从侧栏搬到列表容器末尾，横向铺开；手机端再搬回去。</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/list-webinfo.js</code> ｜ <strong>改法</strong>：新建文件；完整源码可打开本站 <code>/js/list-webinfo.js</code> 对照，整段写入即可。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\source\js\list-webinfo.js */</span></span><br><span class="line"><span class="keyword">var</span> <span class="variable constant_">MAIN_IDS</span> = [<span class="string">&#x27;recent-posts&#x27;</span>, <span class="string">&#x27;category&#x27;</span>, <span class="string">&#x27;tag&#x27;</span>];</span><br><span class="line"><span class="keyword">var</span> mq = <span class="variable language_">window</span>.<span class="title function_">matchMedia</span>(<span class="string">&#x27;(min-width: 900px)&#x27;</span>);</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">place</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> webinfo = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;.card-webinfo&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!webinfo) <span class="keyword">return</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (!mq.<span class="property">matches</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (webinfo.<span class="property">classList</span>.<span class="title function_">contains</span>(<span class="string">&#x27;hg-webinfo-inline&#x27;</span>)) <span class="title function_">restore</span>(webinfo);</span><br><span class="line">    <span class="keyword">return</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> main = <span class="title function_">getMain</span>();</span><br><span class="line">  <span class="keyword">if</span> (!main || webinfo.<span class="property">parentElement</span> === main) <span class="keyword">return</span>;</span><br><span class="line"></span><br><span class="line">  main.<span class="title function_">appendChild</span>(webinfo);</span><br><span class="line">  webinfo.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;hg-webinfo-inline&#x27;</span>);</span><br><span class="line">  webinfo.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;wow&#x27;</span>, <span class="string">&#x27;animate__zoomIn&#x27;</span>);</span><br><span class="line">  webinfo.<span class="property">style</span>.<span class="property">visibility</span> = <span class="string">&#x27;visible&#x27;</span>;</span><br><span class="line">  webinfo.<span class="property">style</span>.<span class="property">animationName</span> = <span class="string">&#x27;none&#x27;</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>搬过去之后要挪掉 <code>wow</code> 类和动画，不然卡片会一直停在入场前的透明状态。CSS 用四列网格，随宽度降成三列、两列、一列：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.hg-webinfo-inline</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: block;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">20px</span> <span class="number">0</span> <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">18px</span> <span class="number">24px</span> <span class="number">4px</span>;</span><br><span class="line">  <span class="attribute">border-top</span>: <span class="number">1px</span> solid <span class="built_in">var</span>(--border-color, <span class="built_in">rgba</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, .<span class="number">08</span>));</span><br><span class="line">  <span class="attribute">background</span>: transparent;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.hg-webinfo-inline</span> &#123;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">18px</span> <span class="number">24px</span> <span class="number">20px</span>;</span><br><span class="line">  <span class="attribute">border-top</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--card-bg);</span><br><span class="line">  <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">2px</span> <span class="number">12px</span> <span class="built_in">rgba</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, .<span class="number">08</span>);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-webinfo-inline</span> &gt; <span class="selector-class">.webinfo</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: grid;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">4</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">8px</span> <span class="number">28px</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>移动端 <code>restore()</code> 把卡片放回 <code>#aside-content &gt; .sticky_layout</code>，并去掉 <code>hg-webinfo-inline</code>。最后监听 <code>matchMedia</code> 的 <code>change</code> 和 pjax 的完成事件，来回切页面、缩放窗口都不会丢位置。</p><h1 id="54-画廊：分类大厅与瀑布流"><a href="#54-画廊：分类大厅与瀑布流" class="headerlink" title="54. 画廊：分类大厅与瀑布流"></a>54. 画廊：分类大厅与瀑布流</h1><p>画廊不是外部插件，就是普通页面加几段 HTML 和 CSS。大厅是四张分类卡：</p><p><strong>文件</strong>：<code>[Blogroot]/source/gallery/index.md</code> ｜ <strong>改法</strong>：在正文里新建大厅容器；四个 <code>&lt;figure&gt;</code> 按分类各写一份。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-gallery-hall&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">figure</span> <span class="attr">class</span>=<span class="string">&quot;hg-gallery-group&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">img</span> <span class="attr">src</span>=<span class="string">&quot;/img/gallery/anime/cover.webp&quot;</span> <span class="attr">alt</span>=<span class="string">&quot;二次元&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">figcaption</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-gallery-group-name&quot;</span>&gt;</span>二次元<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">p</span>&gt;</span>把喜欢的画面留在这里<span class="tag">&lt;/<span class="name">p</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">a</span> <span class="attr">href</span>=<span class="string">&quot;/gallery/anime/&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">a</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;/<span class="name">figcaption</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">figure</span>&gt;</span></span><br><span class="line">  <span class="comment">&lt;!-- 风景 / 萌宠 / 手机 同理 --&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br></pre></td></tr></table></figure><p>分类页用 CSS 多列实现瀑布流，不需要 JS 计算高度：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾，和画廊页面样式放在一起。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.hg-gallery-grid</span> &#123;</span><br><span class="line">  <span class="attribute">column-count</span>: <span class="number">3</span>;</span><br><span class="line">  <span class="attribute">column-gap</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">0</span> <span class="number">2px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-gallery-grid</span> <span class="selector-class">.hg-gallery-item</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: block;</span><br><span class="line">  <span class="attribute">break-inside</span>: avoid;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">10px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--card-bg);</span><br><span class="line">  <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">2px</span> <span class="number">10px</span> <span class="built_in">rgba</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, .<span class="number">12</span>);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-gallery-grid</span> <span class="selector-class">.hg-gallery-item</span> <span class="selector-tag">img</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: block;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">height</span>: auto;</span><br><span class="line">  aspect-ratio: <span class="number">16</span> / <span class="number">10</span>;</span><br><span class="line">  <span class="attribute">object-fit</span>: cover;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">transition</span>: transform .<span class="number">45s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 按位置错开比例，瀑布流才不是一排等高的格子 */</span></span><br><span class="line"><span class="selector-class">.hg-gallery-grid</span> <span class="selector-class">.hg-gallery-item</span><span class="selector-pseudo">:nth-child</span>(<span class="number">4</span>n + <span class="number">2</span>) <span class="selector-tag">img</span> &#123; aspect-ratio: <span class="number">4</span> / <span class="number">3</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-gallery-grid</span> <span class="selector-class">.hg-gallery-item</span><span class="selector-pseudo">:nth-child</span>(<span class="number">4</span>n + <span class="number">3</span>) <span class="selector-tag">img</span> &#123; aspect-ratio: <span class="number">3</span> / <span class="number">4</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-gallery-grid</span> <span class="selector-class">.hg-gallery-item</span><span class="selector-pseudo">:nth-child</span>(<span class="number">4</span>n + <span class="number">4</span>) <span class="selector-tag">img</span> &#123; aspect-ratio: <span class="number">1</span> / <span class="number">1</span>; &#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">min-width</span>: <span class="number">1600px</span>) &#123;</span><br><span class="line">  <span class="selector-class">.hg-gallery-grid</span> &#123; <span class="attribute">column-count</span>: <span class="number">4</span>; &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">max-width</span>: <span class="number">991px</span>) &#123;</span><br><span class="line">  <span class="selector-class">.hg-gallery-grid</span> &#123; <span class="attribute">column-count</span>: <span class="number">2</span>; &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>手机分类单独加 <code>hg-gallery-grid--mobile</code>，强制竖图比例，避免横图在小屏上只剩一条：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：紧接上一段追加，只对带 <code>--mobile</code> 的分类页生效。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.hg-gallery-grid--mobile</span> <span class="selector-class">.hg-gallery-item</span><span class="selector-pseudo">:nth-child</span>(<span class="number">4</span>n + <span class="number">1</span>) <span class="selector-tag">img</span> &#123; aspect-ratio: <span class="number">9</span> / <span class="number">16</span>; &#125;</span><br><span class="line"><span class="selector-class">.hg-gallery-grid--mobile</span> <span class="selector-class">.hg-gallery-item</span><span class="selector-pseudo">:nth-child</span>(<span class="number">4</span>n + <span class="number">2</span>) <span class="selector-tag">img</span> &#123; aspect-ratio: <span class="number">3</span> / <span class="number">4</span>; &#125;</span><br></pre></td></tr></table></figure><p>点击原图交给主题自带的 fancybox，缩略图外面套一层带 <code>data-fancybox</code> 的链接即可：</p><p><strong>文件</strong>：<code>[Blogroot]/source/gallery/&lt;分类&gt;/index.md</code> ｜ <strong>改法</strong>：每个缩略图按这个结构写；<code>data-fancybox</code> 同组用同一个名字。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">a</span> <span class="attr">class</span>=<span class="string">&quot;hg-gallery-item&quot;</span> <span class="attr">href</span>=<span class="string">&quot;/img/gallery/anime/01.webp&quot;</span> <span class="attr">data-fancybox</span>=<span class="string">&quot;gallery-anime&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">img</span> <span class="attr">src</span>=<span class="string">&quot;/img/gallery/anime/01.webp&quot;</span> <span class="attr">alt</span>=<span class="string">&quot;&quot;</span> <span class="attr">loading</span>=<span class="string">&quot;lazy&quot;</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">a</span>&gt;</span></span><br></pre></td></tr></table></figure><p>两个注意点：</p><ol><li><code>column-count</code> 是纵向填充：每列从上往下排，不是从左到右一行行排。图片顺序会变成「先第一列从上到下，再第二列」，对画廊来说可以接受。</li><li>不用给图片写固定高度，统一用 <code>aspect-ratio</code>。这样图片还没加载时占位比例已经确定，不会因为懒加载回流出瀑布错位。</li></ol><h1 id="55-旧时光：年份分类与跳转"><a href="#55-旧时光：年份分类与跳转" class="headerlink" title="55. 旧时光：年份分类与跳转"></a>55. 旧时光：年份分类与跳转</h1><p>旧时光页的 Markdown 只用主题的 <code>timeline</code> 标签写，脚本一个字都不改正文，只读渲染后的 DOM 做增强：</p><p><strong>文件</strong>：<code>[Blogroot]/source/time/index.md</code> ｜ <strong>改法</strong>：页面正文按原时间轴格式追加；日期写在 <code>&lt;!-- timeline YYYY-MM-DD --&gt;</code> 里。</p><figure class="highlight markdown"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">&#123;% timeline 旧时光,blue %&#125;</span><br><span class="line">&lt;!-- timeline 2026-11-22 --&gt;</span><br><span class="line"><span class="bullet">1.</span> 第一条记录</span><br><span class="line"><span class="bullet">2.</span> 第二条记录</span><br><span class="line">&lt;!-- endtimeline --&gt;</span><br><span class="line">&#123;% endtimeline %&#125;</span><br></pre></td></tr></table></figure><p>脚本从每个 <code>.timeline-item</code> 的标题里解析 <code>YYYY-MM-DD</code>，拆成「年 + 月日」，再按年份插入分隔节点、年份胶囊和统计：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/time-timeline.js</code> ｜ <strong>改法</strong>：新建文件；完整源码可打开本站 <code>/js/time-timeline.js</code> 对照，下面拆日期解析。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">parseDate</span>(<span class="params">text</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> matched = <span class="regexp">/(\d&#123;4&#125;)-(\d&#123;1,2&#125;)-(\d&#123;1,2&#125;)/</span>.<span class="title function_">exec</span>(<span class="title class_">String</span>(text || <span class="string">&#x27;&#x27;</span>));</span><br><span class="line">  <span class="keyword">if</span> (!matched) <span class="keyword">return</span> <span class="literal">null</span>;</span><br><span class="line">  <span class="keyword">return</span> &#123;</span><br><span class="line">    <span class="attr">year</span>: matched[<span class="number">1</span>],</span><br><span class="line">    <span class="attr">md</span>: <span class="title function_">pad</span>(matched[<span class="number">2</span>]) + <span class="string">&#x27;-&#x27;</span> + <span class="title function_">pad</span>(matched[<span class="number">3</span>]),</span><br><span class="line">    <span class="attr">date</span>: matched[<span class="number">1</span>] + <span class="string">&#x27;-&#x27;</span> + <span class="title function_">pad</span>(matched[<span class="number">2</span>]) + <span class="string">&#x27;-&#x27;</span> + <span class="title function_">pad</span>(matched[<span class="number">3</span>])</span><br><span class="line">  &#125;;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>增强前先设两道保险，避免把别的页面搞坏：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/time-timeline.js</code> ｜ <strong>改法</strong>：放在 <code>init()</code> 里，位于创建年份节点之前；两道守卫缺一不可。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> timeline = <span class="title function_">findTimeline</span>(container);</span><br><span class="line"><span class="keyword">if</span> (!timeline || timeline.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-hg-tl&#x27;</span>)) <span class="keyword">return</span>;</span><br><span class="line"></span><br><span class="line"><span class="comment">// 任意一条日期解析失败，或年份不足 2 个，整块不生效</span></span><br><span class="line"><span class="keyword">if</span> (!info) <span class="keyword">return</span>;</span><br><span class="line"><span class="keyword">if</span> (years.<span class="property">length</span> &lt; <span class="number">2</span>) <span class="keyword">return</span>;</span><br></pre></td></tr></table></figure><p><code>data-hg-tl</code> 是幂等标记，pjax 往返重复执行时直接返回。年份跳转用 <code>scrollTo</code> 而不是直接改 <code>location.hash</code>，因为要减去固定导航的高度：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/time-timeline.js</code> ｜ <strong>改法</strong>：放在年份胶囊的点击监听里，替换原来的跳转逻辑。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">CHIP_OFFSET</span> = <span class="number">88</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">var</span> top = target.<span class="title function_">getBoundingClientRect</span>().<span class="property">top</span> +</span><br><span class="line">  (<span class="variable language_">window</span>.<span class="property">pageYOffset</span> || <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">scrollTop</span> || <span class="number">0</span>) - <span class="variable constant_">CHIP_OFFSET</span>;</span><br><span class="line"><span class="variable language_">window</span>.<span class="title function_">scrollTo</span>(&#123; <span class="attr">top</span>: top, <span class="attr">behavior</span>: reduce ? <span class="string">&#x27;auto&#x27;</span> : <span class="string">&#x27;smooth&#x27;</span> &#125;);</span><br><span class="line">history.<span class="title function_">replaceState</span>(<span class="literal">null</span>, <span class="string">&#x27;&#x27;</span>, <span class="string">&#x27;#&#x27;</span> + id);</span><br></pre></td></tr></table></figure><p>每个年份分隔器还会统计「多少天 · 多少条记录」，顶部则汇总起止日期、历时天数、更新天数与总条数。统计条目时只数内容区直属的 <code>ol &gt; li</code>，避免把嵌套列表重复算进去：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/time-timeline.js</code> ｜ <strong>改法</strong>：新增 <code>countEntries()</code> 函数，供年份统计调用。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">countEntries</span>(<span class="params">item</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> content = item.<span class="title function_">querySelector</span>(<span class="string">&#x27;.timeline-item-content&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!content) <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">  <span class="keyword">var</span> items = content.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;:scope &gt; ol &gt; li, :scope &gt; ul &gt; li&#x27;</span>);</span><br><span class="line">  <span class="keyword">return</span> items.<span class="property">length</span> || content.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;li&#x27;</span>).<span class="property">length</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>样式侧只加 <code>.timeline.hg-tl</code> 前缀，主题原版时间轴完全不受影响；暗色模式单独覆盖背景和分隔线。</p><h1 id="56-公告卡与手机侧边菜单入口"><a href="#56-公告卡与手机侧边菜单入口" class="headerlink" title="56. 公告卡与手机侧边菜单入口"></a>56. 公告卡与手机侧边菜单入口</h1><p>公告卡的内容直接写在 <code>_config.butterfly.yml</code> 的 <code>aside.card_announcement.content</code> 里，用自己的一套 <code>hg-announce</code> 类，不依赖主题卡片原来的排版：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：找到 <code>aside.card_announcement.content</code>，整段替换成下面的 HTML；缩进保持两格。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">card_announcement:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">content:</span> <span class="string">&gt;-</span></span><br><span class="line"><span class="string">    &lt;div class=&quot;hg-announce&quot;&gt;</span></span><br><span class="line"><span class="string">      &lt;p class=&quot;hg-announce__title&quot;&gt;&lt;i class=&quot;fas fa-server&quot;&gt;&lt;/i&gt;网站换到服务器上啦！！&lt;/p&gt;</span></span><br><span class="line"><span class="string">      &lt;div class=&quot;hg-announce__items&quot;&gt;</span></span><br><span class="line"><span class="string">        &lt;a class=&quot;hg-announce__item hg-announce__item--domain&quot; href=&quot;https://cookiesky.cn&quot;&gt;主域名&lt;/a&gt;</span></span><br><span class="line"><span class="string">        &lt;a class=&quot;hg-announce__item&quot; href=&quot;mailto:2451517087@qq.com&quot;&gt;联系邮箱&lt;/a&gt;</span></span><br><span class="line"><span class="string">        &lt;a class=&quot;hg-announce__item hg-announce__item--travel&quot; href=&quot;https://travel.moe/go?travel=on&quot; target=&quot;_blank&quot; rel=&quot;noopener nofollow&quot;&gt;异次元之旅&lt;/a&gt;</span></span><br><span class="line"><span class="string">        &lt;a class=&quot;hg-announce__item hg-announce__item--travellings&quot; href=&quot;https://www.travellings.cn/go.html&quot; target=&quot;_blank&quot; rel=&quot;noopener&quot;&gt;开往&lt;/a&gt;</span></span><br><span class="line"><span class="string">      &lt;/div&gt;</span></span><br><span class="line"><span class="string">    &lt;/div&gt;</span></span><br></pre></td></tr></table></figure><p>四条入口用同一套卡片样式，只靠 <code>--domain</code>、<code>--travel</code>、<code>--travellings</code> 修饰符换图标底色：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.hg-announce</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">flex-direction</span>: column;</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">2px</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-announce__item</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">10px</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">9px</span> <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--theme-color) <span class="number">22%</span>, transparent);</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">10px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--theme-color) <span class="number">8%</span>, transparent);</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">var</span>(--font-color) <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">transition</span>: transform .<span class="number">2s</span> ease, background .<span class="number">2s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.hg-announce__item</span><span class="selector-pseudo">:hover</span> &#123;</span><br><span class="line">  <span class="attribute">transform</span>: <span class="built_in">translateY</span>(-<span class="number">2px</span>);</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--theme-color) <span class="number">14%</span>, transparent);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>手机侧边菜单和桌面导航共用主题的 <code>menu</code> 配置，但这两个外部入口只想出现在手机菜单里。于是用一个小脚本，只往 <code>#sidebar-menus .menus_items</code> 追加节点，桌面 <code>#nav</code> 完全不碰：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/mobile-menu-links.js</code> ｜ <strong>改法</strong>：新建文件；完整源码可打开本站 <code>/js/mobile-menu-links.js</code> 对照，整段写入。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\source\js\mobile-menu-links.js */</span></span><br><span class="line"><span class="keyword">const</span> links = [</span><br><span class="line">  &#123; <span class="attr">href</span>: <span class="string">&#x27;https://travel.moe/go?travel=on&#x27;</span>, <span class="attr">icon</span>: <span class="string">&#x27;fa-rocket&#x27;</span>, <span class="attr">text</span>: <span class="string">&#x27;异次元之旅&#x27;</span>, <span class="attr">rel</span>: <span class="string">&#x27;noopener nofollow&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">href</span>: <span class="string">&#x27;https://www.travellings.cn/go.html&#x27;</span>, <span class="attr">icon</span>: <span class="string">&#x27;fa-train&#x27;</span>, <span class="attr">text</span>: <span class="string">&#x27;开往&#x27;</span>, <span class="attr">rel</span>: <span class="string">&#x27;noopener&#x27;</span> &#125;</span><br><span class="line">];</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">inject</span> () &#123;</span><br><span class="line">  <span class="keyword">const</span> menu = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;#sidebar-menus .menus_items&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!menu || menu.<span class="title function_">querySelector</span>(<span class="string">&#x27;.hg-sidebar-extra&#x27;</span>)) <span class="keyword">return</span>;</span><br><span class="line"></span><br><span class="line">  links.<span class="title function_">forEach</span>(<span class="function"><span class="params">item</span> =&gt;</span> &#123;</span><br><span class="line">    <span class="keyword">const</span> wrap = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">    wrap.<span class="property">className</span> = <span class="string">&#x27;menus_item hg-sidebar-extra&#x27;</span>;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">const</span> a = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;a&#x27;</span>);</span><br><span class="line">    a.<span class="property">className</span> = <span class="string">&#x27;site-page&#x27;</span>;</span><br><span class="line">    a.<span class="property">href</span> = item.<span class="property">href</span>;</span><br><span class="line">    a.<span class="property">target</span> = <span class="string">&#x27;_blank&#x27;</span>;</span><br><span class="line">    a.<span class="property">rel</span> = item.<span class="property">rel</span>;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">const</span> icon = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;i&#x27;</span>);</span><br><span class="line">    icon.<span class="property">className</span> = <span class="string">&#x27;fas &#x27;</span> + item.<span class="property">icon</span> + <span class="string">&#x27; fa-fw&#x27;</span>;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">const</span> text = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;span&#x27;</span>);</span><br><span class="line">    text.<span class="property">textContent</span> = <span class="string">&#x27; &#x27;</span> + item.<span class="property">text</span>;</span><br><span class="line"></span><br><span class="line">    a.<span class="title function_">append</span>(icon, text);</span><br><span class="line">    wrap.<span class="title function_">append</span>(a);</span><br><span class="line">    menu.<span class="title function_">append</span>(wrap);</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>.hg-sidebar-extra</code> 既是样式钩子，也是防止 pjax 重复注入的标记。脚本要在 <code>DOMContentLoaded</code> 和 <code>pjax:complete</code> 各跑一次。</p><h1 id="57-Cookie-同意与第三方服务门控"><a href="#57-Cookie-同意与第三方服务门控" class="headerlink" title="57. Cookie 同意与第三方服务门控"></a>57. Cookie 同意与第三方服务门控</h1><p>统计和评论都是第三方服务，默认不该在用户做选择前加载。本站的做法分两层：</p><p><strong>第一层，构建期剥离统计脚本。</strong> 主题会把 busuanzi 的 <code>&lt;script&gt;</code> 写死在页面里，用 <code>after_render:html</code> 过滤器统一删掉：</p><p><strong>文件</strong>：<code>[Blogroot]/scripts/consent-gate.js</code> ｜ <strong>改法</strong>：新建文件，整段写入。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\scripts\consent-gate.js */</span></span><br><span class="line">hexo.<span class="property">extend</span>.<span class="property">filter</span>.<span class="title function_">register</span>(<span class="string">&#x27;after_render:html&#x27;</span>, <span class="keyword">function</span> (<span class="params">html</span>) &#123;</span><br><span class="line">  <span class="keyword">return</span> html.<span class="title function_">replace</span>(<span class="regexp">/&lt;script\b[^&gt;]*\bbusuanzi\b[^&gt;]*&gt;\s*&lt;\/script&gt;/gi</span>, <span class="string">&#x27;&#x27;</span>);</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p><strong>第二层，运行期按选择加载。</strong> 选择存在 <code>localStorage</code> 的 <code>hgConsent</code> 里，只有 <code>v: 1</code> 才认：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/consent.js</code> ｜ <strong>改法</strong>：新建文件；完整源码可打开本站 <code>/js/consent.js</code> 对照，下面拆读取与门控逻辑。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">KEY</span> = <span class="string">&#x27;hgConsent&#x27;</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">read</span> () &#123;</span><br><span class="line">  <span class="keyword">try</span> &#123;</span><br><span class="line">    <span class="keyword">var</span> raw = w.<span class="property">localStorage</span>.<span class="title function_">getItem</span>(<span class="variable constant_">KEY</span>);</span><br><span class="line">    <span class="keyword">if</span> (!raw) <span class="keyword">return</span> <span class="literal">null</span>;</span><br><span class="line">    <span class="keyword">var</span> v = <span class="title class_">JSON</span>.<span class="title function_">parse</span>(raw);</span><br><span class="line">    <span class="keyword">if</span> (!v || v.<span class="property">v</span> !== <span class="number">1</span>) <span class="keyword">return</span> <span class="literal">null</span>;</span><br><span class="line">    <span class="keyword">return</span> &#123; <span class="attr">analytics</span>: v.<span class="property">analytics</span> === <span class="literal">true</span>, <span class="attr">comments</span>: v.<span class="property">comments</span> === <span class="literal">true</span> &#125;;</span><br><span class="line">  &#125; <span class="keyword">catch</span> (e) &#123; <span class="keyword">return</span> <span class="literal">null</span>; &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>统计同意后才动态插入脚本：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/consent.js</code> ｜ <strong>改法</strong>：替换 <code>loadBusuanzi()</code> 函数；统计脚本地址按你用的版本改。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">loadBusuanzi</span> () &#123;</span><br><span class="line">  <span class="keyword">if</span> (w.<span class="property">__hgBszLoaded</span>) <span class="keyword">return</span>;</span><br><span class="line">  w.<span class="property">__hgBszLoaded</span> = <span class="literal">true</span>;</span><br><span class="line">  <span class="keyword">var</span> s = d.<span class="title function_">createElement</span>(<span class="string">&#x27;script&#x27;</span>);</span><br><span class="line">  s.<span class="property">async</span> = <span class="literal">true</span>;</span><br><span class="line">  s.<span class="property">src</span> = <span class="string">&#x27;https://cdn.busuanzi.cc/busuanzi/3.6.9/busuanzi.min.js&#x27;</span>;</span><br><span class="line">  (d.<span class="property">body</span> || d.<span class="property">head</span>).<span class="title function_">appendChild</span>(s);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>评论拒绝时直接把评论区 DOM 移除；之后改成允许，需要刷新一次页面才能重新初始化 Twikoo：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/consent.js</code> ｜ <strong>改法</strong>：替换 <code>stripComments()</code> 函数；评论容器 ID 以你的主题为准。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">stripComments</span> () &#123;</span><br><span class="line">  <span class="keyword">var</span> ids = [<span class="string">&#x27;post-comment&#x27;</span>, <span class="string">&#x27;to_comment&#x27;</span>, <span class="string">&#x27;newest-comments&#x27;</span>];</span><br><span class="line">  <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; ids.<span class="property">length</span>; i++) &#123;</span><br><span class="line">    <span class="keyword">var</span> node = d.<span class="title function_">getElementById</span>(ids[i]);</span><br><span class="line">    <span class="keyword">if</span> (node &amp;&amp; node.<span class="property">parentNode</span>) node.<span class="property">parentNode</span>.<span class="title function_">removeChild</span>(node);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>三个选择：全部接受、接受部分（统计 / 评论分别勾选）、不接受。关闭弹窗或按 Esc 视为同意全部，这一点要在弹窗文案里写清楚。选择变化时派发自定义事件，侧栏地区卡片等模块监听后立即响应：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/consent.js</code> ｜ <strong>改法</strong>：放在 <code>decide()</code> 里，保存选择并关闭弹窗之后派发。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">d.<span class="title function_">dispatchEvent</span>(<span class="keyword">new</span> w.<span class="title class_">CustomEvent</span>(<span class="string">&#x27;hg-consent-change&#x27;</span>, &#123; <span class="attr">detail</span>: state &#125;));</span><br></pre></td></tr></table></figure><p>弹窗样式全部走 <code>var(--card-bg)</code>、<code>var(--theme-color)</code>、<code>var(--on-theme)</code>，暗色模式和美化面板换色都能自动适配。入口要留一个：美化设置 → 布局与部件 → Cookie 与隐私，调用 <code>window.hgOpenConsent()</code> 重新打开。</p><h1 id="58-Service-Worker-静态资源缓存"><a href="#58-Service-Worker-静态资源缓存" class="headerlink" title="58. Service Worker 静态资源缓存"></a>58. Service Worker 静态资源缓存</h1><p>HTML 必须网络优先，否则文章更新后用户看到的还是旧页面；带版本号的 CSS / JS / 图片可以缓存优先，后台再更新。两个缓存分开存：</p><p><strong>文件</strong>：<code>[Blogroot]/source/sw.js</code> ｜ <strong>改法</strong>：新建文件；完整源码可打开本站 <code>/sw.js</code> 对照，先写缓存名和匹配规则。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\source\sw.js 节选 */</span></span><br><span class="line"><span class="keyword">const</span> <span class="variable constant_">VERSION</span> = <span class="string">&#x27;20261122a&#x27;</span></span><br><span class="line"><span class="keyword">const</span> <span class="variable constant_">STATIC_CACHE</span> = <span class="string">&#x27;hg-static-&#x27;</span> + <span class="variable constant_">VERSION</span></span><br><span class="line"><span class="keyword">const</span> <span class="variable constant_">PAGE_CACHE</span> = <span class="string">&#x27;hg-page-&#x27;</span> + <span class="variable constant_">VERSION</span></span><br><span class="line"><span class="keyword">const</span> <span class="variable constant_">STATIC_PATH</span> = <span class="regexp">/^\/(?:css|js|fonts?|img|lib)\//</span></span><br><span class="line"><span class="keyword">const</span> <span class="variable constant_">ASSET_EXT</span> = <span class="regexp">/\.(?:css|js|mjs|woff2?|ttf|otf|webp|avif|png|jpe?g|gif|svg|ico)$/i</span></span><br></pre></td></tr></table></figure><p>页面请求：</p><p><strong>文件</strong>：<code>[Blogroot]/source/sw.js</code> ｜ <strong>改法</strong>：放在 <code>fetch</code> 事件里，先处理页面导航请求。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> (request.<span class="property">mode</span> === <span class="string">&#x27;navigate&#x27;</span>) &#123;</span><br><span class="line">  event.<span class="title function_">respondWith</span>(</span><br><span class="line">    <span class="title function_">fetch</span>(request).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">response</span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (response &amp;&amp; response.<span class="property">ok</span>) &#123;</span><br><span class="line">        <span class="keyword">const</span> copy = response.<span class="title function_">clone</span>()</span><br><span class="line">        caches.<span class="title function_">open</span>(<span class="variable constant_">PAGE_CACHE</span>).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">cache</span>) &#123; cache.<span class="title function_">put</span>(request, copy) &#125;)</span><br><span class="line">      &#125;</span><br><span class="line">      <span class="keyword">return</span> response</span><br><span class="line">    &#125;).<span class="title function_">catch</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="keyword">return</span> caches.<span class="title function_">match</span>(request).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">hit</span>) &#123;</span><br><span class="line">        <span class="keyword">return</span> hit || caches.<span class="title function_">match</span>(<span class="string">&#x27;/&#x27;</span>)</span><br><span class="line">      &#125;)</span><br><span class="line">    &#125;)</span><br><span class="line">  )</span><br><span class="line">  <span class="keyword">return</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>静态资源：</p><p><strong>文件</strong>：<code>[Blogroot]/source/sw.js</code> ｜ <strong>改法</strong>：紧接页面分支之后，处理同源静态资源。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line">event.<span class="title function_">respondWith</span>(</span><br><span class="line">  caches.<span class="title function_">open</span>(<span class="variable constant_">STATIC_CACHE</span>).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">cache</span>) &#123;</span><br><span class="line">    <span class="keyword">return</span> cache.<span class="title function_">match</span>(request).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">hit</span>) &#123;</span><br><span class="line">      <span class="keyword">const</span> network = <span class="title function_">fetch</span>(request).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">response</span>) &#123;</span><br><span class="line">        <span class="keyword">if</span> (response &amp;&amp; response.<span class="property">ok</span>) cache.<span class="title function_">put</span>(request, response.<span class="title function_">clone</span>())</span><br><span class="line">        <span class="keyword">return</span> response</span><br><span class="line">      &#125;).<span class="title function_">catch</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">return</span> hit &#125;)</span><br><span class="line">      <span class="keyword">return</span> hit || network</span><br><span class="line">    &#125;)</span><br><span class="line">  &#125;)</span><br><span class="line">)</span><br></pre></td></tr></table></figure><p>几个关键约束：</p><ul><li>跨域请求直接放行，不接管统计、评论、地区接口。</li><li><code>request.method !== &#39;GET&#39;</code> 和带 <code>Range</code> 的请求（音视频拖动）不缓存。</li><li><code>install</code> 里 <code>skipWaiting()</code>，<code>activate</code> 里清掉旧版本缓存并 <code>clients.claim()</code>。</li><li><strong>每次改 CSS / JS，记得同时改 <code>custom.css?v=...</code> 和 <code>sw.js</code> 的 <code>VERSION</code></strong>。只改文件不改版本号，缓存优先会继续吐旧文件，这是最容易出现的「我明明改了怎么没生效」。</li></ul><p>注册放在页面加载完成之后，不抢首屏带宽：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/sw-register.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；再把它加进 <code>inject.bottom</code>。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\source\js\sw-register.js */</span></span><br><span class="line">w.<span class="title function_">addEventListener</span>(<span class="string">&#x27;load&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  navigator.<span class="property">serviceWorker</span>.<span class="title function_">register</span>(<span class="string">&#x27;/sw.js&#x27;</span>, &#123; <span class="attr">updateViaCache</span>: <span class="string">&#x27;none&#x27;</span> &#125;).<span class="title function_">catch</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;&#125;)</span><br><span class="line">&#125;)</span><br></pre></td></tr></table></figure><p>调试时用 DevTools → Application → Service Workers 勾选 <code>Update on reload</code>，或者直接 <code>Unregister</code> 再刷新。</p><h1 id="59-图片、字体与前端资源的瘦身"><a href="#59-图片、字体与前端资源的瘦身" class="headerlink" title="59. 图片、字体与前端资源的瘦身"></a>59. 图片、字体与前端资源的瘦身</h1><p>首页封面是最大的一块。原图 <code>bg1.png</code> 约 <code>6.6MB</code>，转成 <code>bg1.webp</code> 后只有 <code>97KB</code>；另一张背景 <code>bg.png</code> 从 <code>3.55MB</code> 降到 <code>136KB</code>，移动端单独出 <code>bg-mobile.webp</code>。转换命令（安装 <code>cwebp</code> 后）：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：把原图转成 WebP，输出文件放在同目录。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">cwebp -q 82 bg1.png -o bg1.webp</span><br></pre></td></tr></table></figure><p>字体是第二块。霞鹜文楷全量字体太大，按站内实际用字加 <code>GB2312</code> 常用字做子集，重建后的子集覆盖 <code>7,820</code> 个字形，繁体与生僻字不再回退系统字体。生成后放 <code>[Blogroot]/source/font/</code>，并在 <code>@font-face</code> 里指过去：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加字体声明；字体文件先放进 <code>source/font/</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@font-face</span> &#123;</span><br><span class="line">  <span class="attribute">font-family</span>: <span class="string">&#x27;myfont&#x27;</span>;</span><br><span class="line">  <span class="attribute">src</span>: <span class="built_in">url</span>(<span class="string">&#x27;/font/霞鹜文楷.full.woff2&#x27;</span>) <span class="built_in">format</span>(<span class="string">&#x27;woff2&#x27;</span>);</span><br><span class="line">  <span class="attribute">font-display</span>: swap;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>子集文件虽然还是 MB 级，但比全量小得多，配合首屏预加载，正文不会出现明显的字体闪烁：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：加到 <code>inject.head</code> 的列表里，和其它 <code>&lt;link&gt;</code> 并列。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;preload&quot;</span> <span class="string">as=&quot;font&quot;</span> <span class="string">type=&quot;font/woff2&quot;</span> <span class="string">href=&quot;/font/%E9%9C%9E%E9%B9%9C%E6%96%87%E6%A5%B7.full.woff2&quot;</span> <span class="string">crossorigin&gt;</span></span><br></pre></td></tr></table></figure><p>其它几项：</p><ol><li><code>wowjs</code> 的 CSS 和 JS 全部放本地，去掉第三方 CDN 请求，离线也能正常入场。</li><li>主题 <code>index.css</code> 开启 Stylus 压缩：<code>stylus.compress: true</code>。</li><li>过大的第三方弹窗（比如节日弹窗用的 <code>sweetalert2</code>）改成按需加载，没触发节日就不下载。</li><li>头像、友链截图、画廊缩略图统一转 WebP，并加 <code>loading=&quot;lazy&quot;</code>。</li><li>检查首屏：DevTools → Network 按体积排序，超过 <code>200KB</code> 的图片和字体优先处理。</li></ol><p>体积优化不要一次改十几项，改一项、清一次缓存、对比一次加载瀑布图，才知道是哪一项真正有效。</p><h1 id="60-订阅源-BOM-与-custom-css-截断修复"><a href="#60-订阅源-BOM-与-custom-css-截断修复" class="headerlink" title="60. 订阅源 BOM 与 custom.css 截断修复"></a>60. 订阅源 BOM 与 custom.css 截断修复</h1><p><strong>订阅源中文乱码。</strong> Edge 和部分阅读器在响应头没有 <code>charset</code> 时，会把 <code>atom.xml</code> 当 GBK 解码，XML 声明里的 <code>encoding=&quot;utf-8&quot;</code> 兜不住。解决办法是构建完成后给订阅源补 UTF-8 BOM：</p><p><strong>文件</strong>：<code>[Blogroot]/scripts/feed-bom.js</code> ｜ <strong>改法</strong>：新建文件，整段写入。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* [Blogroot]\scripts\feed-bom.js */</span></span><br><span class="line"><span class="meta">&#x27;use strict&#x27;</span>;</span><br><span class="line"></span><br><span class="line">hexo.<span class="property">extend</span>.<span class="property">filter</span>.<span class="title function_">register</span>(<span class="string">&#x27;after_generate&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">const</span> feed = hexo.<span class="property">config</span>.<span class="property">feed</span>;</span><br><span class="line">  <span class="keyword">if</span> (!feed || !feed.<span class="property">path</span>) <span class="keyword">return</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">const</span> route = hexo.<span class="property">route</span>;</span><br><span class="line">  <span class="keyword">const</span> feedPath = route.<span class="title function_">format</span>(feed.<span class="property">path</span>);</span><br><span class="line">  <span class="keyword">const</span> data = route.<span class="title function_">get</span>(feedPath);</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (<span class="keyword">typeof</span> data === <span class="string">&#x27;string&#x27;</span> &amp;&amp; data.<span class="title function_">charCodeAt</span>(<span class="number">0</span>) !== <span class="number">0xfeff</span>) &#123;</span><br><span class="line">    route.<span class="title function_">set</span>(feedPath, <span class="string">&#x27;\uFEFF&#x27;</span> + data);</span><br><span class="line">  &#125; <span class="keyword">else</span> <span class="keyword">if</span> (<span class="title class_">Buffer</span>.<span class="title function_">isBuffer</span>(data) &amp;&amp; !(data[<span class="number">0</span>] === <span class="number">0xef</span> &amp;&amp; data[<span class="number">1</span>] === <span class="number">0xbb</span> &amp;&amp; data[<span class="number">2</span>] === <span class="number">0xbf</span>)) &#123;</span><br><span class="line">    route.<span class="title function_">set</span>(feedPath, <span class="title class_">Buffer</span>.<span class="title function_">concat</span>([<span class="title class_">Buffer</span>.<span class="title function_">from</span>([<span class="number">0xef</span>, <span class="number">0xbb</span>, <span class="number">0xbf</span>]), data]));</span><br><span class="line">  &#125;</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p>字符串和 Buffer 两种返回类型都要处理，且要判断 BOM 是否已经存在，避免重复添加。</p><p><strong><code>custom.css</code> 截断。</strong> 这次遇到一个很隐蔽的问题：文件里有一段 <code>@-webkit-keyframes</code> 没有闭合，浏览器解析到那里之后，把后面所有规则整段丢弃。表现是「前面几节样式正常，后面突然全失效」，很容易误判成选择器写错。修复前后的生效规则数是 <code>202 → 601</code>。</p><p>排查和预防：</p><ol><li>用 DevTools → Sources 打开 <code>custom.css</code>，看最后一条被识别的规则停在哪一行，问题通常就在它附近。</li><li>大段注释里不要嵌套 <code>/* */</code>，一个多余的 <code>*/</code> 就会让解析器提前结束注释。</li><li>改完 CSS 用 <code>npx stylelint</code> 或任意 CSS 校验器过一遍括号配对。</li><li>给 <code>custom.css</code> 的引用加版本参数，改一次升一次；配合 Service Worker 时，<code>sw.js</code> 的 <code>VERSION</code> 也要一起升。</li></ol><h1 id="改完怎么验证与部署"><a href="#改完怎么验证与部署" class="headerlink" title="改完怎么验证与部署"></a>改完怎么验证与部署</h1><p>十节都改完后，不要直接上传，先在本地走一遍：</p><ol><li><strong>生成</strong>：在博客根目录执行 <code>./node_modules/.bin/hexo generate</code>（Windows 下也可用 <code>hexo generate</code>）。看最后一行是不是 <code>Generated</code>，有报错先解决再继续。</li><li><strong>本地预览</strong>：执行 <code>hexo server</code>，打开 <code>http://localhost:4000</code>，重点检查首页多栏、侧栏两张卡、画廊、旧时光、公告卡和手机菜单。</li><li><strong>硬刷新</strong>：改过 CSS / JS 后按 <code>Ctrl + F5</code>。如果启用了 Service Worker，再到 DevTools → Application → Service Workers 点一次 <code>Update</code>，否则看到的可能还是缓存里的旧文件。</li><li><strong>检查控制台</strong>：F12 看 Console 有没有 404 或 <code>Uncaught</code>，Network 里确认 <code>custom.css</code>、本节新增的 JS 文件、<code>sw.js</code> 的版本参数已经更新。</li><li><strong>部署</strong>：把生成的 <code>public/</code> 目录按你原来的方式上传（Nginx 静态托管、GitHub Pages、Vercel 或 <code>hexo deploy</code> 都行）。上传后关掉浏览器缓存再访问一次，确认线上和本地一致。</li></ol><p>上线前再核对三件事：</p><ul><li><code>_config.yml</code> 和 <code>_config.butterfly.yml</code> 的缩进没有错位，YAML 对空格数量很敏感。</li><li>新增的 <code>scripts/*.js</code> 在博客根目录的 <code>scripts</code> 文件夹里，不是在主题目录里；这样升级主题不会丢。</li><li>改过 <code>custom.css</code> 或任何 JS 后，<code>_config.butterfly.yml</code> 里的 <code>?v=</code> 版本号和 <code>sw.js</code> 的 <code>VERSION</code> 是否一起改了。</li></ul><div class="note info modern"><p>这篇把第 51 ~ 60 个魔改写完了。首页多栏、侧栏卡片、画廊、旧时光、公告入口、Cookie、缓存与资源瘦身都已经落地。第 61 个魔改已经接着写：<a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）：侧栏内容卡全宽展开</a>。</p></div>]]>
    </content>
    <id>https://cookiesky.cn/2026/11/22/hexo-magic5/</id>
    <link href="https://cookiesky.cn/2026/11/22/hexo-magic5/"/>
    <published>2026-11-22T15:40:00.000Z</published>
    <summary>hexo魔改教程（五）</summary>
    <title>hexo魔改教程（五）</title>
    <updated>2026-11-22T17:12:15.685Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a><br>本篇是第 41 ~ 50 个魔改，主要围绕友人帐、关于页、归档页和评论区，适用 <code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code>。</li></ul></div><details class="folding-tag" blue><summary> 这十节分别改哪里 </summary>              <div class='content'>              <ul><li>41 ~ 42：友人帐（<code>/link/</code>）的三格式分栏与一键复制申请区</li><li>43 ~ 44：关于页（<code>/about/</code>）的名片卡、社交卡片与本站信息面板</li><li>45：RSS / Atom 订阅源与浏览器自动发现</li><li>46 ~ 47：归档页（<code>/archives/</code>）的卡片栅格、年份吸顶与折叠</li><li>48 ~ 49：Twikoo 评论区的主题色皮肤与操作图标间距</li><li>50：把上面这些新模块统一挂到「美化设置」的主题色变量上</li></ul><p>路径统一用 <code>[Blogroot]</code> 表示博客根目录。所有自定义样式都放在 <code>[Blogroot]\source\css\</code>，脚本放在 <code>[Blogroot]\source\js\</code>，不改主题源码；这样升级 Butterfly 时不会丢。</p>              </div>            </details><h1 id="友人帐：同一份友链信息，三种格式"><a href="#友人帐：同一份友链信息，三种格式" class="headerlink" title="友人帐：同一份友链信息，三种格式"></a>友人帐：同一份友链信息，三种格式</h1><p>不同主题的友链格式不一样：Butterfly 系吃 YAML，Volantis 系吃 JSON，还有站点只认表格。与其让别人自己猜，不如在友链页顶部做一个分栏，把三种格式都摆出来。</p><p>Butterfly 自带 <code>tabs</code> 标签，不需要额外插件。在 <code>[Blogroot]\source\link\index.md</code> 里写：</p><p><strong>文件</strong>：<code>[Blogroot]/source/link/index.md</code> ｜ <strong>改法</strong>：替换正文里已有的 <code>&#123;% tabs link-format %&#125;</code> 整段（没有就插在页面标题下面）；三个标签页里的「站点名称 / yourdomain.com」换成本站信息，标签文字可改。</p><figure class="highlight markdown"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br></pre></td><td class="code"><pre><span class="line">&#123;% tabs link-format %&#125;</span><br><span class="line">&lt;!-- tab butterfly-candy --&gt;</span><br><span class="line"><span class="code">```yml</span></span><br><span class="line"><span class="code">- name: 站点名称</span></span><br><span class="line"><span class="code">  link: https://yourdomain.com/</span></span><br><span class="line"><span class="code">  avatar: https://yourdomain.com/img/avatar.jpg</span></span><br><span class="line"><span class="code">  descr: 一句话介绍</span></span><br><span class="line"><span class="code">  siteshot: https://image.thum.io/get/allowJPG/wait/20/width/600/crop/950/https://yourdomain.com/</span></span><br><span class="line"><span class="code">```</span></span><br><span class="line">&lt;!-- endtab --&gt;</span><br><span class="line">&lt;!-- tab Volantis --&gt;</span><br><span class="line"><span class="code">```json</span></span><br><span class="line"><span class="code">&#123;</span></span><br><span class="line"><span class="code">  &quot;title&quot;: &quot;站点名称&quot;,</span></span><br><span class="line"><span class="code">  &quot;screenshot&quot;: &quot;https://image.thum.io/get/allowJPG/wait/20/width/600/crop/950/https://yourdomain.com/&quot;,</span></span><br><span class="line"><span class="code">  &quot;url&quot;: &quot;https://yourdomain.com/&quot;,</span></span><br><span class="line"><span class="code">  &quot;avatar&quot;: &quot;https://yourdomain.com/img/avatar.jpg&quot;,</span></span><br><span class="line"><span class="code">  &quot;description&quot;: &quot;一句话介绍&quot;</span></span><br><span class="line"><span class="code">&#125;</span></span><br><span class="line"><span class="code">```</span></span><br><span class="line">&lt;!-- endtab --&gt;</span><br><span class="line">&lt;!-- tab General --&gt;</span><br><span class="line">| 名称 | 数值 |</span><br><span class="line">| --- | --- |</span><br><span class="line">| 站点名称 | 站点名称 |</span><br><span class="line">| 站点链接 | https://yourdomain.com/ |</span><br><span class="line">&lt;!-- endtab --&gt;</span><br><span class="line">&#123;% endtabs %&#125;</span><br></pre></td></tr></table></figure><p>几个容易踩的点：</p><ul><li><code>{% tabs 分组名 %}</code> 里的分组名只是标识，不能重复；<code>&lt;!-- tab 标签文字 --&gt;</code> 与 <code>&lt;!-- endtab --&gt;</code> 必须成对。</li><li>用三个反引号围起来的代码块里，标签会原样显示，不会被 Hexo 执行；正文里要原样显示标签时，才需要用 raw 包裹。</li><li>表格那一栏别用太长的链接，手机端会横向溢出。截图地址这种长串，直接单独放一行代码块更稳。</li></ul><p>分栏标题另外加一点留白，不要让分栏贴着页面顶部：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾；文件里已有友人帐样式段（<code>h2.hg-link-title</code>），能找到就替换同名规则，别写两份。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-link</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-link-title</span> &#123;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">1.6rem</span> <span class="number">0</span> .<span class="number">4rem</span>;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">1.25rem</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-link</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-link-sub</span> &#123;</span><br><span class="line">  <span class="attribute">margin-bottom</span>: <span class="number">1rem</span>;</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--font-color) <span class="number">55%</span>, transparent);</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">13px</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h1 id="友人帐：一键复制友链模板"><a href="#友人帐：一键复制友链模板" class="headerlink" title="友人帐：一键复制友链模板"></a>友人帐：一键复制友链模板</h1><p>分栏解决的是「本站长什么样」，申请区解决的是「别人怎么把信息给你」。与其让人对着示例手打，不如给两个按钮：一个复制 YAML 模板，一个复制截图地址。</p><p>HTML 放在友链页申请区的位置：</p><p><strong>文件</strong>：<code>[Blogroot]/source/link/index.md</code> ｜ <strong>改法</strong>：放在「加入本站友链方式」那段之后、正文末尾；已有 <code>.hg-link-apply</code> 块就整段替换，<code>&lt;script&gt;</code> 的 <code>?v=</code> 跟着升。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-link-apply&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">button</span> <span class="attr">type</span>=<span class="string">&quot;button&quot;</span> <span class="attr">data-copy</span>=<span class="string">&quot;yaml&quot;</span>&gt;</span><span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fa-solid fa-circle-plus&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span>复制友链格式<span class="tag">&lt;/<span class="name">button</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">button</span> <span class="attr">type</span>=<span class="string">&quot;button&quot;</span> <span class="attr">data-copy</span>=<span class="string">&quot;shot&quot;</span>&gt;</span><span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fa-solid fa-circle-plus&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span>复制截图地址<span class="tag">&lt;/<span class="name">button</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;<span class="name">script</span> <span class="attr">src</span>=<span class="string">&quot;/js/link-apply.js?v=1&quot;</span> <span class="attr">data-pjax</span>&gt;</span><span class="tag">&lt;/<span class="name">script</span>&gt;</span></span><br></pre></td></tr></table></figure><p><code>[Blogroot]\source\js\link-apply.js</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/link-apply.js</code> ｜ <strong>改法</strong>：已有同名文件，整段替换文件内容；按钮绑定在 <code>init()</code>、剪贴板回落逻辑在 <code>copyText()</code> / <code>legacyCopy()</code>，别拆到别处。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="string">&#x27;use strict&#x27;</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">TEMPLATES</span> = &#123;</span><br><span class="line">    <span class="attr">yaml</span>: <span class="string">&#x27;- name: #站点名称\n  link: #站点链接\n  avatar: #站长头像\n  descr: #站点描述\n  siteshot: #站点截图&#x27;</span>,</span><br><span class="line">    <span class="attr">shot</span>: <span class="string">&#x27;https://image.thum.io/get/allowJPG/wait/20/width/600/crop/950/https://&lt;你的域名&gt;/&#x27;</span></span><br><span class="line">  &#125;;</span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">TIPS</span> = &#123; <span class="attr">yaml</span>: <span class="string">&#x27;友链格式已复制&#x27;</span>, <span class="attr">shot</span>: <span class="string">&#x27;截图地址已复制&#x27;</span> &#125;;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">tell</span>(<span class="params">msg</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">fomalNotify</span> === <span class="string">&#x27;function&#x27;</span>) &#123;</span><br><span class="line">      <span class="variable language_">window</span>.<span class="title function_">fomalNotify</span>(&#123; <span class="attr">type</span>: <span class="string">&#x27;success&#x27;</span>, <span class="attr">message</span>: msg, <span class="attr">duration</span>: <span class="number">2500</span> &#125;);</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">legacyCopy</span>(<span class="params">text, done</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> ta = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;textarea&#x27;</span>);</span><br><span class="line">    ta.<span class="property">value</span> = text;</span><br><span class="line">    ta.<span class="property">style</span>.<span class="property">cssText</span> = <span class="string">&#x27;position:fixed;top:-1000px;left:0;opacity:0&#x27;</span>;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(ta);</span><br><span class="line">    ta.<span class="title function_">select</span>();</span><br><span class="line">    <span class="keyword">try</span> &#123; <span class="variable language_">document</span>.<span class="title function_">execCommand</span>(<span class="string">&#x27;copy&#x27;</span>); <span class="title function_">done</span>(); &#125; <span class="keyword">catch</span> (e) &#123; <span class="comment">/* 保持原样 */</span> &#125;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">removeChild</span>(ta);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">copyText</span>(<span class="params">text, done</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (navigator.<span class="property">clipboard</span> &amp;&amp; navigator.<span class="property">clipboard</span>.<span class="property">writeText</span>) &#123;</span><br><span class="line">      navigator.<span class="property">clipboard</span>.<span class="title function_">writeText</span>(text).<span class="title function_">then</span>(done, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">legacyCopy</span>(text, done); &#125;);</span><br><span class="line">    &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">      <span class="title function_">legacyCopy</span>(text, done);</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">init</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> box = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;.hg-link-apply&#x27;</span>);</span><br><span class="line">    <span class="keyword">if</span> (!box || box.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-bound&#x27;</span>) === <span class="string">&#x27;1&#x27;</span>) <span class="keyword">return</span>;</span><br><span class="line">    box.<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-bound&#x27;</span>, <span class="string">&#x27;1&#x27;</span>);</span><br><span class="line">    box.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, <span class="keyword">function</span> (<span class="params">ev</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> btn = ev.<span class="property">target</span>.<span class="title function_">closest</span>(<span class="string">&#x27;[data-copy]&#x27;</span>);</span><br><span class="line">      <span class="keyword">if</span> (!btn) <span class="keyword">return</span>;</span><br><span class="line">      <span class="keyword">var</span> text = <span class="variable constant_">TEMPLATES</span>[btn.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-copy&#x27;</span>)];</span><br><span class="line">      <span class="keyword">if</span> (!text) <span class="keyword">return</span>;</span><br><span class="line">      <span class="title function_">copyText</span>(text, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">tell</span>(<span class="variable constant_">TIPS</span>[btn.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-copy&#x27;</span>)] || <span class="string">&#x27;已复制&#x27;</span>); &#125;);</span><br><span class="line">    &#125;);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">readyState</span> === <span class="string">&#x27;loading&#x27;</span>) <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;DOMContentLoaded&#x27;</span>, init);</span><br><span class="line">  <span class="keyword">else</span> <span class="title function_">init</span>();</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p>说明：</p><ul><li><code>navigator.clipboard.writeText</code> 需要在安全上下文（HTTPS 或 localhost）里才可用，HTTP 情况下会自动退回 <code>execCommand(&#39;copy&#39;)</code>。</li><li>提示框复用站内 <code>fomalNotify</code>；如果没有这个函数，复制本身仍然正常，只是不弹提示。</li><li>加 <code>data-bound</code> 守卫是为了 pjax 往返时不重复绑定点击事件。</li><li>用户站点地址、头像这些模板内容只是「示例文本」，不要把它写成某个真实站点的信息；模板里用占位符，让人自己替换。</li></ul><h1 id="关于页：名片卡与社交卡片"><a href="#关于页：名片卡与社交卡片" class="headerlink" title="关于页：名片卡与社交卡片"></a>关于页：名片卡与社交卡片</h1><p>关于页第一屏决定别人愿不愿意往下看。做成「头像 + 名字 + 一句话 + 标签」的名片卡，再加一排社交账号卡片，比纯文字友好很多。</p><p>名片卡：</p><p><strong>文件</strong>：<code>[Blogroot]/source/about/index.md</code> ｜ <strong>改法</strong>：替换正文开头的 <code>.hg-about-hero</code> 整块；头像路径、名字、徽标文字、三个标签按自己情况改。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-hero&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">img</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-avatar&quot;</span> <span class="attr">src</span>=<span class="string">&quot;/img/avatar.jpg&quot;</span> <span class="attr">alt</span>=<span class="string">&quot;站长头像&quot;</span> <span class="attr">loading</span>=<span class="string">&quot;lazy&quot;</span> <span class="attr">decoding</span>=<span class="string">&quot;async&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-hero-main&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-name&quot;</span>&gt;</span>你的名字<span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-badge&quot;</span>&gt;</span>博主<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">p</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-bio&quot;</span>&gt;</span>一句话介绍自己<span class="tag">&lt;/<span class="name">p</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-tags&quot;</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">span</span>&gt;</span>学生<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">span</span>&gt;</span>AI 入门<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">span</span>&gt;</span>折腾记录<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br></pre></td></tr></table></figure><p>社交卡片统一用一个网格，颜色用各自品牌的色值，图标直接用 FontAwesome：</p><p><strong>文件</strong>：<code>[Blogroot]/source/about/index.md</code> ｜ <strong>改法</strong>：紧跟名片卡之后插入；每个 <code>&lt;a&gt;</code> 是一条社交账号，增删时保持 <code>is-xxx</code> 类名，CSS 里才有对应的品牌色。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-social&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">a</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-sns is-bilibili&quot;</span> <span class="attr">href</span>=<span class="string">&quot;https://space.bilibili.com/你的UID&quot;</span> <span class="attr">target</span>=<span class="string">&quot;_blank&quot;</span> <span class="attr">rel</span>=<span class="string">&quot;noopener&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fab fa-bilibili&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-sns-name&quot;</span>&gt;</span>Bilibili<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-sns-id&quot;</span>&gt;</span>你的UID<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">a</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">a</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-sns is-github&quot;</span> <span class="attr">href</span>=<span class="string">&quot;https://github.com/你的用户名&quot;</span> <span class="attr">target</span>=<span class="string">&quot;_blank&quot;</span> <span class="attr">rel</span>=<span class="string">&quot;noopener&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fab fa-github&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-sns-name&quot;</span>&gt;</span>GitHub<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-sns-id&quot;</span>&gt;</span>你的用户名<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">a</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br></pre></td></tr></table></figure><p>对应 CSS 的关键部分：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾；文件里已有 <code>#body-wrap.type-about</code> 的 <code>.hg-about-hero</code> / <code>.hg-about-social</code> / <code>.hg-about-sns</code> 段，能找到就替换。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-hero</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">18px</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">22px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">16px</span>;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--font-color) <span class="number">8%</span>, transparent);</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">linear-gradient</span>(<span class="number">135deg</span>,</span><br><span class="line">    <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--theme-color, <span class="number">#49b1f5</span>) <span class="number">10%</span>, transparent), transparent <span class="number">70%</span>);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-social</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: grid;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">4</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">10px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-sns</span> &#123;</span><br><span class="line">  <span class="attr">--sns</span>: <span class="built_in">var</span>(--theme-color, <span class="number">#49b1f5</span>);</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">8px</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">10px</span> <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--sns) <span class="number">22%</span>, transparent);</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--sns) <span class="number">6%</span>, transparent);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-sns</span><span class="selector-class">.is-bilibili</span> &#123; <span class="attr">--sns</span>: <span class="number">#fb7299</span>; &#125;</span><br><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-sns</span><span class="selector-class">.is-github</span> &#123; <span class="attr">--sns</span>: <span class="number">#6e5494</span>; &#125;</span><br></pre></td></tr></table></figure><p>手机端四列会挤成一团。把社交区改成两列，并让每张卡片内部变成「图标 + 名称 / 图标 + ID」的 2×2 小网格，ID 才有地方放：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：紧接上一段追加，放在同一个关于页样式区内；媒体查询不要插进别的 <code>@media</code> 里。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">max-width</span>: <span class="number">768px</span>) &#123;</span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-hero</span> &#123;</span><br><span class="line">    <span class="attribute">flex-direction</span>: column;</span><br><span class="line">    <span class="attribute">text-align</span>: center;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-social</span> &#123;</span><br><span class="line">    <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">2</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-sns</span> &#123;</span><br><span class="line">    <span class="attribute">display</span>: grid;</span><br><span class="line">    <span class="attribute">grid-template-columns</span>: <span class="number">34px</span> <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr);</span><br><span class="line">    <span class="attribute">grid-template-rows</span>: auto auto;</span><br><span class="line">    <span class="attribute">column-gap</span>: <span class="number">10px</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-sns</span> <span class="selector-tag">i</span> &#123;</span><br><span class="line">    <span class="attribute">grid-column</span>: <span class="number">1</span>;</span><br><span class="line">    <span class="attribute">grid-row</span>: <span class="number">1</span> / span <span class="number">2</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-sns-name</span> &#123;</span><br><span class="line">    <span class="attribute">grid-column</span>: <span class="number">2</span>;</span><br><span class="line">    <span class="attribute">grid-row</span>: <span class="number">1</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-about-sns-id</span> &#123;</span><br><span class="line">    <span class="attribute">grid-column</span>: <span class="number">2</span>;</span><br><span class="line">    <span class="attribute">grid-row</span>: <span class="number">2</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>品牌色用 <code>--sns</code> 局部变量覆盖，后面所有派生色都从它算，想加 Gitee、知乎、邮箱时只需要再写一行 <code>--sns</code> 色值。</p><h1 id="关于页：本站信息与线路检测"><a href="#关于页：本站信息与线路检测" class="headerlink" title="关于页：本站信息与线路检测"></a>关于页：本站信息与线路检测</h1><p>这一块就是关于页底部那张卡：前面显示访客数、运行天数，中间检测本站三个入口的连通性，右边列技术栈，底部读本机参数。</p><p>先写结构。注意所有动态值都留一个 <code>—</code> 占位，脚本没跑起来时页面也不难看：</p><p><strong>文件</strong>：<code>[Blogroot]/source/about/index.md</code> ｜ <strong>改法</strong>：放在关于页正文底部，替换已有的 <code>#hg-about-check</code> 整块（连同上面那行 <code>&lt;h2 class=&quot;hg-about-check-title&quot;&gt;</code>）；技术栈里的版本号按自己站点改。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">h2</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-check-title&quot;</span>&gt;</span><span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fas fa-satellite-dish&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span> 本站信息与线路检测<span class="tag">&lt;/<span class="name">h2</span>&gt;</span></span><br><span class="line"></span><br><span class="line"><span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-about-check&quot;</span> <span class="attr">id</span>=<span class="string">&quot;hg-about-check&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-live&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-dot is-checking&quot;</span> <span class="attr">data-hg-dot</span>&gt;</span><span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-text&quot;</span> <span class="attr">data-hg-text</span>&gt;</span>正在连接本站…<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-ms&quot;</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-ms</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;<span class="name">i</span>&gt;</span>ms<span class="tag">&lt;/<span class="name">i</span>&gt;</span><span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">button</span> <span class="attr">type</span>=<span class="string">&quot;button&quot;</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-retry&quot;</span> <span class="attr">data-hg-retry</span>&gt;</span><span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fas fa-rotate&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span> 重新检测<span class="tag">&lt;/<span class="name">button</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line"></span><br><span class="line">  <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-metrics&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">id</span>=<span class="string">&quot;busuanzi_site_uv&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>本站访客数<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">id</span>=<span class="string">&quot;busuanzi_site_pv&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>总访问量<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">id</span>=<span class="string">&quot;busuanzi_today_uv&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>今日访客<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-days</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>已运行天数<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line"></span><br><span class="line">  <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-blocks&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">section</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-block&quot;</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-block-title&quot;</span>&gt;</span><span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fas fa-route&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span> 线路检测<span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-list&quot;</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-row&quot;</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-name&quot;</span>&gt;</span>主站首页<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-meta&quot;</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-dot is-checking&quot;</span> <span class="attr">data-hg-line-dot</span>=<span class="string">&quot;site&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-line-text</span>=<span class="string">&quot;site&quot;</span>&gt;</span>检测中<span class="tag">&lt;/<span class="name">b</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">em</span> <span class="attr">data-hg-line-ms</span>=<span class="string">&quot;site&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">em</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-row&quot;</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-name&quot;</span>&gt;</span>评论服务<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-meta&quot;</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-dot is-checking&quot;</span> <span class="attr">data-hg-line-dot</span>=<span class="string">&quot;comment&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-line-text</span>=<span class="string">&quot;comment&quot;</span>&gt;</span>检测中<span class="tag">&lt;/<span class="name">b</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">em</span> <span class="attr">data-hg-line-ms</span>=<span class="string">&quot;comment&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">em</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-row&quot;</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-name&quot;</span>&gt;</span>RSS 订阅<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;<span class="name">span</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-meta&quot;</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-dot is-checking&quot;</span> <span class="attr">data-hg-line-dot</span>=<span class="string">&quot;rss&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-line-text</span>=<span class="string">&quot;rss&quot;</span>&gt;</span>检测中<span class="tag">&lt;/<span class="name">b</span>&gt;</span></span><br><span class="line">            <span class="tag">&lt;<span class="name">em</span> <span class="attr">data-hg-line-ms</span>=<span class="string">&quot;rss&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">em</span>&gt;</span></span><br><span class="line">          <span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-line-net&quot;</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">span</span>&gt;</span>接入网络 <span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-net</span>=<span class="string">&quot;type&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">span</span>&gt;</span>估算带宽 <span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-net</span>=<span class="string">&quot;down&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">span</span>&gt;</span>网络 RTT <span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-net</span>=<span class="string">&quot;rtt&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;/<span class="name">section</span>&gt;</span></span><br><span class="line"></span><br><span class="line">    <span class="tag">&lt;<span class="name">section</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-block&quot;</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-block-title&quot;</span>&gt;</span><span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fas fa-layer-group&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span> 技术栈<span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-stack&quot;</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">span</span>&gt;</span>Hexo <span class="tag">&lt;<span class="name">b</span>&gt;</span>8.1.2<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">span</span>&gt;</span>Butterfly <span class="tag">&lt;<span class="name">b</span>&gt;</span>5.7.2<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">span</span>&gt;</span>Twikoo<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">        <span class="tag">&lt;<span class="name">span</span>&gt;</span>Nginx<span class="tag">&lt;/<span class="name">span</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;/<span class="name">section</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line"></span><br><span class="line">  <span class="tag">&lt;<span class="name">section</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-block hg-check-local&quot;</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-check-block-title&quot;</span>&gt;</span><span class="tag">&lt;<span class="name">i</span> <span class="attr">class</span>=<span class="string">&quot;fas fa-microchip&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">i</span>&gt;</span> 本机实测参数<span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;hg-local-grid&quot;</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>浏览器<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;browser&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>系统<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;os&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>屏幕<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;screen&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>视口<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;viewport&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>CPU / 内存<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;cpu&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>语言 / 时区<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;lang&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>本页加载<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;load&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">      <span class="tag">&lt;<span class="name">div</span>&gt;</span><span class="tag">&lt;<span class="name">span</span>&gt;</span>资源请求<span class="tag">&lt;/<span class="name">span</span>&gt;</span><span class="tag">&lt;<span class="name">b</span> <span class="attr">data-hg-local</span>=<span class="string">&quot;res&quot;</span>&gt;</span>—<span class="tag">&lt;/<span class="name">b</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">section</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br></pre></td></tr></table></figure><p>脚本分三块：线路探测、网络信息、本机参数。</p><p>线路探测只用同源地址。<code>mode: &#39;no-cors&#39;</code> 下浏览器不允许读取状态码，所以这里判断的是「请求有没有在超时前结束」，拿到的耗时也足够说明线路通不通：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/about-page.js</code> ｜ <strong>改法</strong>：已有同名文件，替换文件顶部的 <code>SITE</code> / <code>SITE_ORIGIN</code> / <code>TIMEOUT</code> 常量和 <code>probe()</code> 函数；<code>SITE</code> 改成你自己的域名，必须带结尾斜杠。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">SITE</span> = <span class="string">&#x27;https://yourdomain.com/&#x27;</span>;</span><br><span class="line"><span class="keyword">var</span> <span class="variable constant_">SITE_ORIGIN</span> = <span class="variable constant_">SITE</span>.<span class="title function_">replace</span>(<span class="regexp">/\/$/</span>, <span class="string">&#x27;&#x27;</span>);</span><br><span class="line"><span class="keyword">var</span> <span class="variable constant_">TIMEOUT</span> = <span class="number">8000</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">probe</span>(<span class="params">url, method</span>) &#123;</span><br><span class="line">  <span class="keyword">return</span> <span class="keyword">new</span> <span class="title class_">Promise</span>(<span class="keyword">function</span> (<span class="params">resolve</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> ctrl = <span class="keyword">typeof</span> <span class="title class_">AbortController</span> === <span class="string">&#x27;function&#x27;</span> ? <span class="keyword">new</span> <span class="title class_">AbortController</span>() : <span class="literal">null</span>;</span><br><span class="line">    <span class="keyword">var</span> timer = ctrl ? <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; ctrl.<span class="title function_">abort</span>(); &#125;, <span class="variable constant_">TIMEOUT</span>) : <span class="literal">null</span>;</span><br><span class="line">    <span class="keyword">var</span> started = performance.<span class="title function_">now</span>();</span><br><span class="line">    <span class="title function_">fetch</span>(url, &#123;</span><br><span class="line">      <span class="attr">method</span>: method || <span class="string">&#x27;GET&#x27;</span>,</span><br><span class="line">      <span class="attr">mode</span>: <span class="string">&#x27;no-cors&#x27;</span>,</span><br><span class="line">      <span class="attr">cache</span>: <span class="string">&#x27;no-store&#x27;</span>,</span><br><span class="line">      <span class="attr">signal</span>: ctrl ? ctrl.<span class="property">signal</span> : <span class="literal">undefined</span></span><br><span class="line">    &#125;).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="title function_">resolve</span>(&#123; <span class="attr">ok</span>: <span class="literal">true</span>, <span class="attr">ms</span>: <span class="title class_">Math</span>.<span class="title function_">round</span>(performance.<span class="title function_">now</span>() - started) &#125;);</span><br><span class="line">    &#125;).<span class="title function_">catch</span>(<span class="keyword">function</span> (<span class="params">err</span>) &#123;</span><br><span class="line">      <span class="title function_">resolve</span>(&#123; <span class="attr">ok</span>: <span class="literal">false</span>, <span class="attr">ms</span>: <span class="literal">null</span>, <span class="attr">timeout</span>: !!(err &amp;&amp; err.<span class="property">name</span> === <span class="string">&#x27;AbortError&#x27;</span>) &#125;);</span><br><span class="line">    &#125;).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (timer) <span class="built_in">clearTimeout</span>(timer);</span><br><span class="line">    &#125;);</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>三个探测地址分别是首页、评论服务路径和 <code>atom.xml</code>。第三个用 <code>HEAD</code>，不下载正文：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/about-page.js</code> ｜ <strong>改法</strong>：放在 <code>runChecks()</code> 里，替换三路并发探测那一段；评论服务路径 <code>/twikoo/</code> 按你实际的接口前缀改。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> stamp = <span class="string">&#x27;?hgcheck=&#x27;</span> + <span class="title class_">Date</span>.<span class="title function_">now</span>();</span><br><span class="line"><span class="title class_">Promise</span>.<span class="title function_">all</span>([</span><br><span class="line">  <span class="title function_">probe</span>(<span class="variable constant_">SITE</span> + stamp, <span class="string">&#x27;GET&#x27;</span>),</span><br><span class="line">  <span class="title function_">probe</span>(<span class="variable constant_">SITE_ORIGIN</span> + <span class="string">&#x27;/twikoo/&#x27;</span> + stamp, <span class="string">&#x27;GET&#x27;</span>),</span><br><span class="line">  <span class="title function_">probe</span>(<span class="variable constant_">SITE_ORIGIN</span> + <span class="string">&#x27;/atom.xml&#x27;</span> + stamp, <span class="string">&#x27;HEAD&#x27;</span>)</span><br><span class="line">]).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">res</span>) &#123;</span><br><span class="line">  <span class="comment">// res[0] / res[1] / res[2] 分别是 &#123; ok, ms, timeout &#125;</span></span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p><code>?hgcheck=时间戳</code> 是为了绕过缓存，避免测到 CDN 或浏览器缓存里的旧结果。超过 2500ms 显示「较慢」，失败和超时分开提示。</p><p>网络信息读 Network Information API，读不到就显示「浏览器不支持」，不要报错：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/about-page.js</code> ｜ <strong>改法</strong>：整段替换已有的 <code>fillNet()</code> 函数；<code>setText()</code> 是文件里已有的辅助函数，直接复用。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">fillNet</span>(<span class="params">box</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> c = navigator.<span class="property">connection</span> || navigator.<span class="property">mozConnection</span> || navigator.<span class="property">webkitConnection</span>;</span><br><span class="line">  <span class="keyword">if</span> (!c) &#123;</span><br><span class="line">    <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-net=&quot;type&quot;]&#x27;</span>, <span class="string">&#x27;浏览器不支持&#x27;</span>);</span><br><span class="line">    <span class="keyword">return</span>;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">var</span> map = &#123; <span class="attr">wifi</span>: <span class="string">&#x27;Wi-Fi&#x27;</span>, <span class="attr">cellular</span>: <span class="string">&#x27;蜂窝&#x27;</span>, <span class="attr">ethernet</span>: <span class="string">&#x27;有线&#x27;</span>, <span class="attr">none</span>: <span class="string">&#x27;离线&#x27;</span>, <span class="attr">unknown</span>: <span class="string">&#x27;未知&#x27;</span> &#125;;</span><br><span class="line">  <span class="keyword">var</span> parts = [];</span><br><span class="line">  <span class="keyword">if</span> (map[c.<span class="property">type</span>]) parts.<span class="title function_">push</span>(map[c.<span class="property">type</span>]);</span><br><span class="line">  <span class="keyword">if</span> (c.<span class="property">effectiveType</span>) parts.<span class="title function_">push</span>(<span class="title class_">String</span>(c.<span class="property">effectiveType</span>).<span class="title function_">toUpperCase</span>());</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-net=&quot;type&quot;]&#x27;</span>, parts.<span class="title function_">join</span>(<span class="string">&#x27; · &#x27;</span>) || <span class="string">&#x27;未知&#x27;</span>);</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-net=&quot;down&quot;]&#x27;</span>, <span class="keyword">typeof</span> c.<span class="property">downlink</span> === <span class="string">&#x27;number&#x27;</span> ? c.<span class="property">downlink</span> + <span class="string">&#x27; Mbps&#x27;</span> : <span class="string">&#x27;—&#x27;</span>);</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-net=&quot;rtt&quot;]&#x27;</span>, <span class="keyword">typeof</span> c.<span class="property">rtt</span> === <span class="string">&#x27;number&#x27;</span> ? c.<span class="property">rtt</span> + <span class="string">&#x27; ms&#x27;</span> : <span class="string">&#x27;—&#x27;</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>本机参数全部来自浏览器本地接口，只写进 DOM，不发请求：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/about-page.js</code> ｜ <strong>改法</strong>：整段替换已有的 <code>fillLocal()</code> 函数；它调用的 <code>browserOf()</code> / <code>osOf()</code> 就写在同一文件里，不必另建文件。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">fillLocal</span>(<span class="params">box</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> ua = navigator.<span class="property">userAgent</span> || <span class="string">&#x27;&#x27;</span>;</span><br><span class="line">  <span class="keyword">var</span> cores = navigator.<span class="property">hardwareConcurrency</span>;</span><br><span class="line">  <span class="keyword">var</span> mem = navigator.<span class="property">deviceMemory</span>;</span><br><span class="line">  <span class="keyword">var</span> tz = <span class="string">&#x27;&#x27;</span>;</span><br><span class="line">  <span class="keyword">try</span> &#123; tz = <span class="title class_">Intl</span>.<span class="title class_">DateTimeFormat</span>().<span class="title function_">resolvedOptions</span>().<span class="property">timeZone</span> || <span class="string">&#x27;&#x27;</span>; &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> load = <span class="string">&#x27;—&#x27;</span>;</span><br><span class="line">  <span class="keyword">try</span> &#123;</span><br><span class="line">    <span class="keyword">var</span> nav = performance.<span class="title function_">getEntriesByType</span>(<span class="string">&#x27;navigation&#x27;</span>)[<span class="number">0</span>];</span><br><span class="line">    <span class="keyword">if</span> (nav) &#123;</span><br><span class="line">      <span class="keyword">var</span> end = nav.<span class="property">loadEventEnd</span> || nav.<span class="property">domContentLoadedEventEnd</span> || performance.<span class="title function_">now</span>();</span><br><span class="line">      load = <span class="title class_">Math</span>.<span class="title function_">max</span>(<span class="number">0</span>, <span class="title class_">Math</span>.<span class="title function_">round</span>(end - nav.<span class="property">startTime</span>)) + <span class="string">&#x27; ms&#x27;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">  &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-local=&quot;browser&quot;]&#x27;</span>, <span class="title function_">browserOf</span>(ua));</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-local=&quot;os&quot;]&#x27;</span>, <span class="title function_">osOf</span>(ua));</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-local=&quot;screen&quot;]&#x27;</span>, screen.<span class="property">width</span> + <span class="string">&#x27;×&#x27;</span> + screen.<span class="property">height</span>);</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-local=&quot;viewport&quot;]&#x27;</span>, innerWidth + <span class="string">&#x27;×&#x27;</span> + innerHeight);</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-local=&quot;cpu&quot;]&#x27;</span>, (cores ? cores + <span class="string">&#x27; 核&#x27;</span> : <span class="string">&#x27;—&#x27;</span>) + <span class="string">&#x27; / &#x27;</span> + (mem ? mem + <span class="string">&#x27; GB&#x27;</span> : <span class="string">&#x27;—&#x27;</span>));</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-local=&quot;lang&quot;]&#x27;</span>, (navigator.<span class="property">language</span> || <span class="string">&#x27;—&#x27;</span>) + (tz ? <span class="string">&#x27; / &#x27;</span> + tz : <span class="string">&#x27;&#x27;</span>));</span><br><span class="line">  <span class="title function_">setText</span>(box, <span class="string">&#x27;[data-hg-local=&quot;load&quot;]&#x27;</span>, load);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>browserOf</code> / <code>osOf</code> 就是几段 UA 正则，按 Edge、Opera、Firefox、Chrome、Safari 的顺序匹配（顺序不能反，Chrome 的 UA 里也带 Safari）。<code>devicePixelRatio</code>、资源请求数同理，能读到就显示，读不到就保持 <code>—</code>。</p><p>运行天数按建站日期算，不用请求接口：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/about-page.js</code> ｜ <strong>改法</strong>：改文件顶部的 <code>SITE_BIRTH</code> 常量，换成自己的建站时间（带时区偏移的 ISO 字符串最稳）。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">SITE_BIRTH</span> = <span class="keyword">new</span> <span class="title class_">Date</span>(<span class="string">&#x27;2024-05-20T14:11:00+08:00&#x27;</span>).<span class="title function_">getTime</span>();</span><br><span class="line"><span class="keyword">var</span> days = <span class="title class_">Math</span>.<span class="title function_">floor</span>((<span class="title class_">Date</span>.<span class="title function_">now</span>() - <span class="variable constant_">SITE_BIRTH</span>) / <span class="number">86400000</span>);</span><br></pre></td></tr></table></figure><p>最后是初始化和 pjax 守卫：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/about-page.js</code> ｜ <strong>改法</strong>：替换文件末尾的 <code>init()</code> 和启动段（<code>document.readyState</code> 判断），保留已有的 <code>pjax:complete</code> 监听。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">init</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> box = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;hg-about-check&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!box || box.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-bound&#x27;</span>) === <span class="string">&#x27;1&#x27;</span>) <span class="keyword">return</span>;</span><br><span class="line">  box.<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-bound&#x27;</span>, <span class="string">&#x27;1&#x27;</span>);</span><br><span class="line"></span><br><span class="line">  box.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, <span class="keyword">function</span> (<span class="params">ev</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (ev.<span class="property">target</span>.<span class="title function_">closest</span>(<span class="string">&#x27;[data-hg-retry]&#x27;</span>)) <span class="title function_">runChecks</span>(box);</span><br><span class="line">  &#125;);</span><br><span class="line"></span><br><span class="line">  <span class="title function_">fillLocal</span>(box);</span><br><span class="line">  <span class="title function_">runChecks</span>(box);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;pjax:complete&#x27;</span>, init);</span><br><span class="line"><span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">readyState</span> === <span class="string">&#x27;loading&#x27;</span>) <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;DOMContentLoaded&#x27;</span>, init);</span><br><span class="line"><span class="keyword">else</span> <span class="title function_">init</span>();</span><br></pre></td></tr></table></figure><p>样式上，整张卡沿用关于页的圆角卡片语言，线路状态用三个小圆点表示：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾；已有 <code>.hg-check-blocks</code> / <code>.hg-check-block</code> / <code>.hg-local-grid</code> 段就替换，手机端那条媒体查询一并放进关于页样式区。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-check-blocks</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: grid;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">2</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">margin-top</span>: <span class="number">14px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-check-block</span> &#123;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">12px</span> <span class="number">14px</span>;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--font-color) <span class="number">8%</span>, transparent);</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--font-color) <span class="number">3.5%</span>, transparent);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-local-grid</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: grid;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(auto-fit, <span class="built_in">minmax</span>(<span class="number">150px</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">8px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">max-width</span>: <span class="number">768px</span>) &#123;</span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-check-blocks</span> &#123;</span><br><span class="line">    <span class="attribute">grid-template-columns</span>: <span class="number">1</span>fr;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#body-wrap</span><span class="selector-class">.type-about</span> <span class="selector-id">#article-container</span> <span class="selector-class">.hg-local-grid</span> &#123;</span><br><span class="line">    <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(<span class="number">2</span>, <span class="built_in">minmax</span>(<span class="number">0</span>, <span class="number">1</span>fr));</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><div class="note warning flat"><p>这个面板会发起对本站的请求，也会读取浏览器本机参数。上线前记得同步改隐私政策：写清楚只探测本站自己的入口、不向第三方发送数据；本机参数只在浏览器里计算和展示，不上传、不存储。别人访问你的站点时，这些探测请求也会进入服务器访问日志，隐私政策里的日志条款需要涵盖。</p></div><h1 id="RSS-Atom-订阅源与自动发现"><a href="#RSS-Atom-订阅源与自动发现" class="headerlink" title="RSS / Atom 订阅源与自动发现"></a>RSS / Atom 订阅源与自动发现</h1><p>Butterfly 不自带订阅源，需要 <code>hexo-generator-feed</code>：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：安装订阅源生成插件 <code>hexo-generator-feed</code>，装完才会有 <code>atom.xml</code>；<code>package.json</code> 里已列出该依赖的话可跳过。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-generator-feed --save</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.yml</code> 里加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code> ｜ <strong>改法</strong>：作为顶层键 <code>feed:</code> 追加到文件末尾（放在 <code>#魔改</code> 区之前更清楚）；全文只能有一个 <code>feed:</code>，已有同名键就只核对子项，不要重复写第二份。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">feed:</span></span><br><span class="line">  <span class="attr">type:</span> <span class="string">atom</span></span><br><span class="line">  <span class="attr">path:</span> <span class="string">atom.xml</span></span><br><span class="line">  <span class="attr">limit:</span> <span class="number">20</span></span><br><span class="line">  <span class="attr">content:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">content_limit:</span> <span class="number">140</span></span><br><span class="line">  <span class="attr">content_limit_delim:</span> <span class="string">&#x27; &#x27;</span></span><br><span class="line">  <span class="attr">order_by:</span> <span class="string">-date</span></span><br></pre></td></tr></table></figure><ul><li><code>limit: 20</code> 只输出最近 20 篇，避免文件随文章数量无限变大。</li><li><code>content: true</code> 会把正文塞进订阅源，阅读器里能直接看全文，但 <code>atom.xml</code> 体积会明显变大；只想给摘要就改成 <code>false</code>。</li><li>生成后访问 <code>/atom.xml</code>，能打开且是合法 XML 就说明成功。</li></ul><p>再让浏览器和阅读器自动发现订阅源。<code>_config.butterfly.yml</code> 的 <code>inject.head</code> 加一行：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：放在 <code>inject.head</code> 列表里作为一项，缩进与其它 <code>&lt;link&gt;</code> 对齐（四空格 <code>-</code>）；<code>title</code> 换成你的站点名，别加到 <code>inject.bottom</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;alternate&quot;</span> <span class="string">type=&quot;application/atom+xml&quot;</span> <span class="string">title=&quot;你的站点名&quot;</span> <span class="string">href=&quot;/atom.xml&quot;&gt;</span></span><br></pre></td></tr></table></figure><p>最后在关于页或页脚放一个复制按钮，方便别人订阅：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/about-page.js</code> ｜ <strong>改法</strong>：<code>copyText()</code> 和 <code>legacyCopy()</code> 文件里已有，不用重写；只需在 <code>init()</code> 的点击监听里补一句 <code>copyText(SITE_ORIGIN + &#39;/atom.xml&#39;, ...)</code>，按钮写成 <code>&lt;button type=&quot;button&quot; data-hg-copy-rss&gt;复制订阅地址&lt;/button&gt;</code>，放进关于页正文即可。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">copyText</span>(<span class="params">text, done</span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (navigator.<span class="property">clipboard</span> &amp;&amp; navigator.<span class="property">clipboard</span>.<span class="property">writeText</span>) &#123;</span><br><span class="line">    navigator.<span class="property">clipboard</span>.<span class="title function_">writeText</span>(text).<span class="title function_">then</span>(done, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">legacyCopy</span>(text, done); &#125;);</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    <span class="title function_">legacyCopy</span>(text, done);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="title function_">copyText</span>(location.<span class="property">origin</span> + <span class="string">&#x27;/atom.xml&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">tell</span>(<span class="string">&#x27;RSS 订阅地址已复制&#x27;</span>); &#125;);</span><br></pre></td></tr></table></figure><h1 id="文章加密：hexo-blog-encrypt"><a href="#文章加密：hexo-blog-encrypt" class="headerlink" title="文章加密：hexo-blog-encrypt"></a>文章加密：hexo-blog-encrypt</h1><p>站内有一篇笔记用 front matter 的 <code>password:</code> 加密，靠 <code>hexo-blog-encrypt</code> 输出密码框。不装插件时 <code>password</code> 会被忽略，正文直接明文输出。</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：安装文章加密插件；已经按基础教程的插件清单装过就跳过。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-blog-encrypt --save</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code> ｜ <strong>改法</strong>：在文件末尾新增顶层 <code>encrypt:</code> 段；<code>tags</code> 用于按标签批量加密，单篇加密直接在文章 front matter 写 <code>password:</code>，同一篇不要两种方式同时用。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">encrypt:</span></span><br><span class="line">  <span class="attr">abstract:</span> <span class="string">有东西被加密了,</span> <span class="string">请输入密码查看.</span></span><br><span class="line">  <span class="attr">message:</span> <span class="string">您好,</span> <span class="string">这里需要密码.</span></span><br><span class="line">  <span class="attr">tags:</span></span><br><span class="line">    <span class="bullet">-</span> &#123;<span class="attr">name:</span> <span class="string">加密</span>, <span class="attr">password:</span> <span class="string">你的密码</span>&#125;</span><br><span class="line">  <span class="attr">theme:</span> <span class="string">blink</span></span><br><span class="line">  <span class="attr">wrong_pass_message:</span> <span class="string">抱歉,</span> <span class="string">这个密码看着不太对,</span> <span class="string">请再试试.</span></span><br><span class="line">  <span class="attr">wrong_hash_message:</span> <span class="string">抱歉,</span> <span class="string">这个文章不能被校验,</span> <span class="string">不过您还是能看看解密后的内容.</span></span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/_posts/你的文章.md</code> ｜ <strong>改法</strong>：在 front matter 的 <code>---</code> 之间加一行 <code>password:</code>，值是明文密码；只想按标签加密时给文章加 <code>tags: [加密]</code>，不写 <code>password</code>。</p><figure class="highlight yaml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">---</span></span><br><span class="line"><span class="attr">title:</span> <span class="string">我的笔记</span></span><br><span class="line"><span class="attr">date:</span> <span class="number">2026-11-23 10:00:00</span></span><br><span class="line"><span class="attr">password:</span> <span class="string">你的密码</span></span><br><span class="line"><span class="meta">---</span></span><br></pre></td></tr></table></figure><h1 id="归档页：时间轴改卡片栅格"><a href="#归档页：时间轴改卡片栅格" class="headerlink" title="归档页：时间轴改卡片栅格"></a>归档页：时间轴改卡片栅格</h1><p>主题默认的归档是「一条竖线 + 一串圆点」，文章一多就像卷轴。改造思路是：<strong>不动主题模板，只在浏览器里把已经渲染好的 DOM 重新排</strong>，所以不需要改 Pug，也不会影响分类页和标签页。</p><p>脚本先做两个守卫，任何一个不成立就直接退出，页面保持原生样子：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/archive-page.js</code> ｜ <strong>改法</strong>：已有同名文件，对应文件里 <code>init()</code> 开头的两道守卫，按这段替换；归档脚本就是这一个文件，由 <code>_config.butterfly.yml</code> 的 <code>inject.bottom</code> 引入。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">init</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> root = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;archive&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!root) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">if</span> (root.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;.article-sort&#x27;</span>).<span class="property">length</span> !== <span class="number">1</span>) <span class="keyword">return</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> list = root.<span class="title function_">querySelector</span>(<span class="string">&#x27;.article-sort&#x27;</span>);</span><br><span class="line">  <span class="keyword">var</span> items = [].<span class="property">slice</span>.<span class="title function_">call</span>(list.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;.article-sort-item&#x27;</span>));</span><br><span class="line">  <span class="keyword">var</span> cards = items.<span class="title function_">filter</span>(<span class="keyword">function</span> (<span class="params">n</span>) &#123; <span class="keyword">return</span> n.<span class="property">className</span>.<span class="title function_">indexOf</span>(<span class="string">&#x27;year&#x27;</span>) === -<span class="number">1</span>; &#125;);</span><br><span class="line">  <span class="keyword">if</span> (!cards.<span class="property">length</span>) <span class="keyword">return</span>;</span><br><span class="line"></span><br><span class="line">  root.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;ar-ready&#x27;</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><ul><li>只认 <code>#archive</code>：归档页、按年归档、按月归档都是这个根，分类页 / 标签页不是。</li><li><code>items</code> 里混着主题生成的年份标题，过滤掉 <code>year</code> 类名剩下的才是文章卡片。</li><li><code>#archive</code> 加上 <code>ar-ready</code> 之后，自定义 CSS 才生效；这就是「渐进增强」，脚本没加载时页面不会坏。</li></ul><p>然后把卡片按年份分组，每组生成一个 <code>section.ar-year</code>，里面放一个标题条和一张卡片网格：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/archive-page.js</code> ｜ <strong>改法</strong>：放在同一个 <code>init()</code> 里，替换按年份分组的循环；建节点建议改用文件里已有的 <code>el(tag, cls, text)</code> 辅助函数。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> grouped = &#123;&#125;;</span><br><span class="line">cards.<span class="title function_">forEach</span>(<span class="keyword">function</span> (<span class="params">node</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> y = node.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-year&#x27;</span>) || <span class="string">&#x27;其他&#x27;</span>;</span><br><span class="line">  (grouped[y] = grouped[y] || []).<span class="title function_">push</span>(node);</span><br><span class="line">&#125;);</span><br><span class="line"></span><br><span class="line"><span class="title class_">Object</span>.<span class="title function_">keys</span>(grouped).<span class="title function_">sort</span>(<span class="keyword">function</span> (<span class="params">a, b</span>) &#123; <span class="keyword">return</span> b - a; &#125;).<span class="title function_">forEach</span>(<span class="keyword">function</span> (<span class="params">year</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> nodes = grouped[year];</span><br><span class="line">  <span class="keyword">var</span> sec = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;section&#x27;</span>);</span><br><span class="line">  sec.<span class="property">className</span> = <span class="string">&#x27;ar-year&#x27;</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> label = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">  label.<span class="property">className</span> = <span class="string">&#x27;ar-year-label&#x27;</span>;</span><br><span class="line">  label.<span class="property">innerHTML</span> = <span class="string">&#x27;&lt;span class=&quot;ar-year-num&quot;&gt;&#x27;</span> + year + <span class="string">&#x27;&lt;/span&gt;&#x27;</span> +</span><br><span class="line">                    <span class="string">&#x27;&lt;span class=&quot;ar-year-count&quot;&gt;&#x27;</span> + nodes.<span class="property">length</span> + <span class="string">&#x27; 篇&lt;/span&gt;&#x27;</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> grid = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">  grid.<span class="property">className</span> = <span class="string">&#x27;ar-cards&#x27;</span>;</span><br><span class="line">  nodes.<span class="title function_">forEach</span>(<span class="keyword">function</span> (<span class="params">n</span>) &#123; grid.<span class="title function_">appendChild</span>(n); &#125;);</span><br><span class="line"></span><br><span class="line">  sec.<span class="title function_">appendChild</span>(label);</span><br><span class="line">  sec.<span class="title function_">appendChild</span>(grid);</span><br><span class="line">  list.<span class="title function_">appendChild</span>(sec);</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p>卡片网格的样式：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/archive-page.css</code> ｜ <strong>改法</strong>：追加到文件末尾；已有 <code>.ar-cards</code> 段就替换。归档样式单独放在这个文件里（由 <code>inject.head</code> 引入），不要写到 <code>custom.css</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-cards</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: grid;</span><br><span class="line">  <span class="attribute">grid-template-columns</span>: <span class="built_in">repeat</span>(auto-fill, <span class="built_in">minmax</span>(<span class="number">240px</span>, <span class="number">1</span>fr));</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">14px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-card</span> &#123;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--font-color) <span class="number">10%</span>, transparent);</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">14px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--card-bg) <span class="number">76%</span>, transparent);</span><br><span class="line">  <span class="attribute">transition</span>: transform .<span class="number">2s</span> ease, box-shadow .<span class="number">2s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-card</span><span class="selector-pseudo">:hover</span> &#123;</span><br><span class="line">  <span class="attribute">transform</span>: <span class="built_in">translateY</span>(-<span class="number">2px</span>);</span><br><span class="line">  <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">10px</span> <span class="number">24px</span> -<span class="number">12px</span> <span class="built_in">rgba</span>(<span class="number">7</span>, <span class="number">17</span>, <span class="number">27</span>, .<span class="number">28</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>主题原来的竖线和圆点要关掉，否则会和新卡片叠在一起：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/archive-page.css</code> ｜ <strong>改法</strong>：紧接上一段追加，放在归档样式区内；这段是关掉主题原生竖线和圆点，不能漏。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.article-sort</span> &#123;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">border-left</span>: <span class="number">0</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.article-sort-item</span><span class="selector-pseudo">::before</span> &#123;</span><br><span class="line">  <span class="attribute">content</span>: none;</span><br><span class="line">  <span class="attribute">display</span>: none;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>如果想在卡片上显示分类和阅读时长，可以在构建期用一个小脚本把文章的元数据写成 JSON 塞进页面（本站是 <code>scripts/archive-index.js</code> 生成 <code>#ar-index</code>）。脚本里读不到这份数据也能正常排版，只是卡片少两个标签，属于可降级项。</p><h1 id="归档页：年份吸顶与折叠"><a href="#归档页：年份吸顶与折叠" class="headerlink" title="归档页：年份吸顶与折叠"></a>归档页：年份吸顶与折叠</h1><p>卡片铺开以后，滚动时很容易不知道自己在哪一年。给每个年份标题做吸顶，再加一个顶部年份导航，长列表就好翻了。</p><p>吸顶本身只需要 <code>position: sticky</code>，难点在偏移量：主题导航栏滚过一定距离后会变成 <code>fixed</code>，高度也会变。所以偏移量不要写死，用 CSS 变量：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/archive-page.css</code> ｜ <strong>改法</strong>：追加到文件末尾；吸顶、年份导航、折叠三组规则集中在这个文件，别分散到 <code>custom.css</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> &#123;</span><br><span class="line">  <span class="attr">--ar-nav-h</span>: <span class="number">0px</span>;</span><br><span class="line">  <span class="attr">--ar-bar-h</span>: <span class="number">0px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-year-label</span> &#123;</span><br><span class="line">  <span class="attribute">position</span>: sticky;</span><br><span class="line">  <span class="attribute">top</span>: <span class="built_in">calc</span>(<span class="built_in">var</span>(--ar-nav-h) + <span class="built_in">var</span>(--ar-bar-h) + <span class="number">8px</span>);</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">3</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">8px</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-year-label</span><span class="selector-class">.is-stuck</span> &#123;</span><br><span class="line">  <span class="attribute">border-bottom</span>: <span class="number">1px</span> solid <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--theme-color, <span class="number">#49b1f5</span>) <span class="number">35%</span>, transparent);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>--ar-nav-h</code> 由 JS 实测导航栏高度写进去，<code>--ar-bar-h</code> 是顶部年份导航条的高度。滚动时用 <code>IntersectionObserver</code> 或滚动位置判断当前年份，给对应的标题加 <code>.is-stuck</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/archive-page.js</code> ｜ <strong>改法</strong>：整段替换已有的 <code>setActive()</code> 函数；<code>sections</code> 是 <code>&#123; year, label, sec &#125;</code> 数组，由上面的年份分组生成。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">setActive</span>(<span class="params">year</span>) &#123;</span><br><span class="line">  sections.<span class="title function_">forEach</span>(<span class="keyword">function</span> (<span class="params">ref</span>) &#123;</span><br><span class="line">    ref.<span class="property">label</span>.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;is-stuck&#x27;</span>, ref.<span class="property">year</span> === year);</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>折叠按钮放在年份标题右侧，点击给 <code>section</code> 加 <code>collapsed</code>，CSS 负责收起：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/archive-page.css</code> ｜ <strong>改法</strong>：紧跟上面的吸顶规则追加；<code>.collapsed</code> 由 <code>openSection()</code> 里的折叠按钮切换。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-year</span><span class="selector-class">.collapsed</span> <span class="selector-class">.ar-cards</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: none;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-year-toggle</span> svg &#123;</span><br><span class="line">  <span class="attribute">transition</span>: transform .<span class="number">2s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-year</span><span class="selector-class">.collapsed</span> <span class="selector-class">.ar-year-toggle</span> svg &#123;</span><br><span class="line">  <span class="attribute">transform</span>: <span class="built_in">rotate</span>(-<span class="number">90deg</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>如果希望刷新后记住哪些年份是收起的，把状态写进 <code>localStorage</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/archive-page.js</code> ｜ <strong>改法</strong>：替换已有的 <code>readCollapsed()</code> / <code>writeCollapsed()</code> 两个函数（同一处 <code>localStorage</code> 读写），键名 <code>ar-collapsed</code> 保持全文一致。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">readCollapsed</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">try</span> &#123; <span class="keyword">return</span> <span class="title class_">JSON</span>.<span class="title function_">parse</span>(<span class="variable language_">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&#x27;ar-collapsed&#x27;</span>)) || []; &#125; <span class="keyword">catch</span> (e) &#123; <span class="keyword">return</span> []; &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">writeCollapsed</span>(<span class="params">arr</span>) &#123;</span><br><span class="line">  <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;ar-collapsed&#x27;</span>, <span class="title class_">JSON</span>.<span class="title function_">stringify</span>(arr));</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>顶部年份导航条用 <code>position: sticky</code> 挂在年份标题上方，点击跳转时记得留出导航高度的 <code>scroll-margin-top</code>，否则标题会被导航盖住：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/archive-page.css</code> ｜ <strong>改法</strong>：追加到吸顶规则附近（同属 <code>.ar-year</code> 定位），不要放进媒体查询里。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-year</span> &#123;</span><br><span class="line">  <span class="attribute">scroll-margin-top</span>: <span class="built_in">calc</span>(<span class="built_in">var</span>(--ar-nav-h) + <span class="built_in">var</span>(--ar-bar-h) + <span class="number">16px</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>手机端把年份导航的横向滚动条隐藏掉，只留可滑动的手感：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/archive-page.css</code> ｜ <strong>改法</strong>：追加到文件末尾；这条只隐藏滚动条，滑动手感不变。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-nav-track</span> &#123;</span><br><span class="line">  <span class="attribute">overflow-x</span>: auto;</span><br><span class="line">  <span class="attribute">scrollbar-width</span>: none;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#archive</span><span class="selector-class">.ar-ready</span> <span class="selector-class">.ar-nav-track</span>::-webkit-scrollbar &#123;</span><br><span class="line">  <span class="attribute">display</span>: none;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h1 id="Twikoo-评论区：跟随主题色的皮肤"><a href="#Twikoo-评论区：跟随主题色的皮肤" class="headerlink" title="Twikoo 评论区：跟随主题色的皮肤"></a>Twikoo 评论区：跟随主题色的皮肤</h1><p>Twikoo 的默认样式是灰色系，和站点主题色脱节。做法是准备一份 <code>twikoo.css</code>，所有颜色从 <code>--theme-color</code> 派生，这样在「美化设置」里换主题色，评论区会跟着变，不用重新生成。</p><p>变量层：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/twikoo.css</code> ｜ <strong>改法</strong>：替换文件开头 <code>#twikoo &#123; ... &#125;</code> 的变量层（第 13 行附近）；后面的 <code>--tk-accent-faint</code> / <code>--tk-accent-wash</code> / 阴影变量保留，别一起删掉。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#twikoo</span> &#123;</span><br><span class="line">  <span class="attr">--tk-accent</span>: <span class="built_in">var</span>(--theme-color, <span class="number">#49b1f5</span>);</span><br><span class="line">  <span class="attr">--tk-accent-strong</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--tk-accent) <span class="number">62%</span>, <span class="number">#000</span>);</span><br><span class="line">  <span class="attr">--tk-accent-deep</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--tk-accent) <span class="number">78%</span>, <span class="number">#000</span>);</span><br><span class="line">  <span class="attr">--tk-accent-soft</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--tk-accent) <span class="number">10%</span>, transparent);</span><br><span class="line">  <span class="attr">--tk-accent-line</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--tk-accent) <span class="number">30%</span>, transparent);</span><br><span class="line">  <span class="attr">--tk-radius-card</span>: <span class="number">14px</span>;</span><br><span class="line">  <span class="attr">--tk-radius-field</span>: <span class="number">10px</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><ul><li><code>--tk-accent-strong</code> 是「主题色压深」后的文字色。满饱和的主题色放在白底上对比度通常不够，直接用会又亮又糊；压深到 62% 后大约能到 5:1。</li><li><code>--tk-accent-deep</code> 给博主回复的气泡用，比普通回复再深一档。</li><li>所有透明底都用 <code>color-mix(..., transparent)</code>，亮色和暗色模式共用同一套变量。</li></ul><p>按钮和计数：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/twikoo.css</code> ｜ <strong>改法</strong>：追加到变量层之后（按钮与计数规则放一起）；这些变量只在本文件定义，别在 <code>custom.css</code> 里重复定义。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#twikoo</span> <span class="selector-class">.tk-comments-count</span> &#123;</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">var</span>(--tk-accent-strong);</span><br><span class="line">  <span class="attribute">font-variant-numeric</span>: tabular-nums;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#twikoo</span> <span class="selector-class">.tk-submit</span> <span class="selector-class">.tk-btn</span> &#123;</span><br><span class="line">  <span class="attribute">border-color</span>: <span class="built_in">var</span>(--tk-accent);</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--tk-accent);</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="built_in">var</span>(--tk-radius-field);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#twikoo</span> <span class="selector-class">.tk-submit</span> <span class="selector-class">.tk-btn</span><span class="selector-pseudo">:hover</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--tk-accent-deep);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>博主回复和普通回复要能一眼分开：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/twikoo.css</code> ｜ <strong>改法</strong>：追加到文件末尾（博主回复样式区）；<code>tk-master</code> 是 Twikoo 自己加的类，不需要在页面里手写。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#twikoo</span> <span class="selector-class">.tk-comment</span><span class="selector-class">.tk-master</span> <span class="selector-class">.tk-content</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--tk-accent-soft);</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="built_in">var</span>(--tk-accent-line);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#twikoo</span> <span class="selector-class">.tk-comment</span><span class="selector-class">.tk-master</span> <span class="selector-class">.tk-avatar</span> &#123;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">2px</span> solid <span class="built_in">var</span>(--tk-accent);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>暗色模式单独处理一遍文字和图标，避免在深底上继续用压深色：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/twikoo.css</code> ｜ <strong>改法</strong>：追加到文件末尾；暗色覆盖统一放最后，靠 <code>[data-theme=&quot;dark&quot;]</code> 提权，别塞进 <code>@media (prefers-color-scheme)</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#twikoo</span> <span class="selector-class">.tk-comments-count</span> &#123;</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--tk-accent) <span class="number">55%</span>, <span class="number">#fff</span>);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#twikoo</span> <span class="selector-class">.tk-comments-actions</span> <span class="selector-class">.tk-icon</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#twikoo</span> <span class="selector-class">.tk-comments-actions</span> <span class="selector-class">.tk-icon</span> svg &#123;</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--tk-accent) <span class="number">55%</span>, <span class="number">#fff</span>);</span><br><span class="line">  stroke: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--tk-accent) <span class="number">55%</span>, <span class="number">#fff</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>最后在 <code>_config.butterfly.yml</code> 的 <code>inject.head</code> 引入：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：加到 <code>inject.head</code> 列表里作为一项（与其它 <code>&lt;link&gt;</code> 同级缩进）；已有 <code>/css/twikoo.css</code> 这行就只升 <code>?v=</code> 版本号，不要添加第二行。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;stylesheet&quot;</span> <span class="string">href=&quot;/css/twikoo.css?v=1&quot;&gt;</span></span><br></pre></td></tr></table></figure><p>选择器统一用 <code>#twikoo</code> 提权，因为 Twikoo 运行时会向页面注入自己的样式，同权重时谁后加载谁生效，加一个 id 最稳。</p><h1 id="评论区标题与操作图标的间距"><a href="#评论区标题与操作图标的间距" class="headerlink" title="评论区标题与操作图标的间距"></a>评论区标题与操作图标的间距</h1><p>Twikoo 的评论表单下面紧跟「评论总数 + 搜索 / 刷新 / 齿轮」这一排，默认两者之间没有间距，三个图标几乎贴着输入框。这是纯视觉问题，加一条上边距就行：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/twikoo.css</code> ｜ <strong>改法</strong>：替换已有的 <code>#twikoo .tk-comments-title</code> 规则（第 45 行附近）；只想改间距就只动 <code>margin-top</code>，字号那两行可以不写。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#twikoo</span> <span class="selector-class">.tk-comments-title</span> &#123;</span><br><span class="line">  <span class="attribute">margin-top</span>: <span class="number">26px</span>;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">1.15rem</span>;</span><br><span class="line">  <span class="attribute">letter-spacing</span>: <span class="number">0.01em</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>26px 是实测值：桌面端和手机端都能拉开，又不会把评论区切得太散。顺手把标题字号从默认值提到 <code>1.15rem</code>，和文章小标题的层级对齐。</p><p>如果只想让间距生效、不想动字号，单独留 <code>margin-top</code> 即可。改完记得升 <code>twikoo.css</code> 的 <code>?v=</code> 版本号，否则浏览器会继续用旧缓存。</p><h1 id="让新模块跟着「美化设置」换色"><a href="#让新模块跟着「美化设置」换色" class="headerlink" title="让新模块跟着「美化设置」换色"></a>让新模块跟着「美化设置」换色</h1><p>前面几节的样式之所以能跟着主题色变，是因为遵守了同一条约定：<strong>颜色只从 CSS 变量派生，不写死十六进制</strong>。</p><p>基础色来自美化面板写入的 <code>--theme-color</code>，所有模块都用它做兜底：</p><p><strong>说明</strong>：示意内容，不需要单独建文件。这是约定示例：实际使用时把它写在对应模块自己的选择器里（比如 <code>#twikoo &#123; --accent: ... &#125;</code>、<code>#archive.ar-ready &#123; --ar-... &#125;</code>），不要裸放在 CSS 顶层。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">--accent</span>: <span class="built_in">var</span>(--theme-color, <span class="number">#49b1f5</span>);</span><br></pre></td></tr></table></figure><p>浅底、边框、阴影这类派生色统一用 <code>color-mix()</code> 算，不另外维护一份色板：</p><p><strong>说明</strong>：示意内容，不需要修改。演示派生色怎么算，落地时把它们写进 <code>custom.css</code> / <code>twikoo.css</code> / <code>archive-page.css</code> 里对应模块的选择器中。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">--accent-soft</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--accent) <span class="number">10%</span>, transparent);</span><br><span class="line"><span class="attr">--accent-line</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--accent) <span class="number">30%</span>, transparent);</span><br><span class="line"><span class="attr">--accent-strong</span>: <span class="built_in">color-mix</span>(in srgb, <span class="built_in">var</span>(--accent) <span class="number">62%</span>, <span class="number">#000</span>);</span><br></pre></td></tr></table></figure><p>需要注意三件事：</p><ol><li><strong>文字对比度</strong>：主题色只用于图标、边框、强调数字。正文和标题不要直接用满饱和的主题色，压深或用主题自带的 <code>--font-color</code>。</li><li><strong>暗色模式</strong>：<code>[data-theme=&quot;dark&quot;]</code> 下要把压深色换成提亮色（主题色混白），否则深底上会看不清。</li><li><strong><code>color-mix</code> 兼容性</strong>：现代浏览器都支持；如果站点要兼容很老的浏览器，给每个变量先写一个普通色值兜底，再写 <code>color-mix</code> 覆盖。</li></ol><p>新模块挂进来之前，先检查它有没有写死颜色。比如归档卡片的背景用的是 <code>color-mix(in srgb, var(--card-bg) 76%, transparent)</code>，所以美化面板调整卡片透明度时，归档卡片会一起变；如果写成 <code>#fff</code>，就永远是白色。</p><h1 id="改完怎么验证与部署"><a href="#改完怎么验证与部署" class="headerlink" title="改完怎么验证与部署"></a>改完怎么验证与部署</h1><p>十节的改动分别落在 <code>source/link/</code>、<code>source/about/</code> 两个页面，<code>source/css/</code> 下的 <code>custom.css</code>、<code>twikoo.css</code>、<code>archive-page.css</code>，<code>source/js/</code> 下的几个脚本，以及 <code>_config.yml</code> / <code>_config.butterfly.yml</code>。按下面五步走一遍再上传：</p><ol><li><strong>生成</strong>：在博客根目录执行 <code>hexo generate</code>（也可以 <code>npm run build</code>）。最后一行是 <code>Generated</code> 才算通过；改过 <code>scripts/</code> 下的构建脚本必须重新生成，否则构建期过滤器不生效。</li><li><strong>本地预览</strong>：执行 <code>hexo server</code>，打开 <code>http://localhost:4000</code>。重点看 <code>/link/</code> 的三个格式标签页与两个复制按钮、<code>/about/</code> 的名片卡与线路检测面板、<code>/archives/</code> 的年份网格与吸顶、文章页评论区配色。</li><li><strong>强制刷新或清缓存</strong>：<code>Ctrl + F5</code> 硬刷新；如果开过 Service Worker，再到 F12 → Application → Service Workers 点 <code>Update</code> 或 <code>Unregister</code>，否则 <code>custom.css</code>、<code>twikoo.css</code>、<code>archive-page.css</code> 仍是缓存里的旧文件。改过 CSS 记得同步升 <code>_config.butterfly.yml</code> 里的 <code>?v=</code> 版本号。</li><li><strong>F12 检查 404</strong>：Console 不能有 404 或 <code>Uncaught</code>；Network 里确认 <code>link-apply.js</code>、<code>about-page.js</code>、<code>archive-page.js</code>、<code>atom.xml</code> 都是 200。打开 <code>/atom.xml</code> 能显示且是合法 XML，说明订阅源和 BOM 都正常。</li><li><strong>部署</strong>：把 <code>public/</code> 按原来的托管方式上线——Nginx 覆盖站点根目录、GitHub Pages 推 <code>gh-pages</code> 分支、Vercel 重新部署，或 <code>hexo deploy</code>（<code>_config.yml</code> 里配了 <code>deploy</code> 才可用）。上线后关掉浏览器缓存再访问一次，确认线上和本地一致。</li></ol><div class="note info modern"><p>这篇把第 41 ~ 50 个魔改写完了。下一篇继续按「每 10 ~ 20 个魔改一篇」的节奏，新内容会单独开《hexo魔改教程（五）》，本篇不再追加。</p></div>]]>
    </content>
    <id>https://cookiesky.cn/2026/11/22/hexo-magic4/</id>
    <link href="https://cookiesky.cn/2026/11/22/hexo-magic4/"/>
    <published>2026-11-22T13:30:00.000Z</published>
    <summary>hexo魔改教程（四）</summary>
    <title>hexo魔改教程（四）</title>
    <updated>2026-11-22T17:12:15.683Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a></li></ul><p>这一篇单独讲「综合美化模块」：把主题色、卡片透明度、字体、壁纸、布局和特效收进一个弹窗面板，改完即时生效，刷新后保持。适用 <code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code>。</p></div><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：面板结构、<code>CSS</code> 变量、持久化与动画降级按本站实现重写，不是原样搬运。</p></blockquote><div class="note info modern"><p>阅读约定：每个代码块上方都标了 <strong>文件</strong> 与 <strong>改法</strong>。<code>[Blogroot]</code> 指博客根目录；「新建」是建好文件后整段写入，「追加」是放到文件末尾，「在已有文件的某函数内补全」是在本站已有的同名脚本里改对应位置，不要另建一份。面板外观类样式放 <code>source/css/beauty-panel.css</code>，卡片底色、字号、圆角这类全局魔改放 <code>source/css/custom.css</code>，两者不要混。</p></div><h1 id="综合美化模块到底做了什么"><a href="#综合美化模块到底做了什么" class="headerlink" title="综合美化模块到底做了什么"></a>综合美化模块到底做了什么</h1><p>一般的主题换肤，要么改 <code>_config</code> 重新生成，要么在浏览器里用开发者工具临时改两下。综合美化模块把这两件事合在一起：</p><ul><li><strong>入口固定</strong>：导航栏一个调色盘按钮，右键菜单里也能打开同一个面板。</li><li><strong>即时预览</strong>：拖滑块、点色点、换字体，页面立刻变化，不刷新。</li><li><strong>持久保存</strong>：偏好写进 <code>localStorage</code>，下次打开还是你调好的样子。</li><li><strong>互不打架</strong>：所有外观都收口到一组 CSS 变量和 <code>&lt;html&gt;</code> 上的类名，主题源码一行不用改。</li></ul><p>它不是一个单独的插件，而是「一个首屏脚本 + 一份样式 + 一个面板脚本 + 几组特效脚本」拼起来的模块。下面按这个顺序讲，每一步都写明改哪个文件。</p><h1 id="开始之前：文件与加载顺序"><a href="#开始之前：文件与加载顺序" class="headerlink" title="开始之前：文件与加载顺序"></a>开始之前：文件与加载顺序</h1><details class="folding-tag" blue><summary> 文件清单 </summary>              <div class='content'>              <p>整套模块按职责拆成这些文件，路径都在博客根目录 <code>[Blogroot]</code> 下：</p><div class="table-container"><table><thead><tr><th>文件</th><th>职责</th></tr></thead><tbody><tr><td><code>source/js/fomal/boot.js</code></td><td>首屏同步脚本，读 <code>localStorage</code> 并写 CSS 变量，防止刷新闪烁</td></tr><tr><td><code>source/js/fomal/winbox.min.js</code></td><td>弹窗组件 WinBox，提供可拖动、可最小化的面板外壳</td></tr><tr><td><code>source/js/fomal/notify.js</code></td><td>轻提示，面板操作后的「已切换」小弹窗</td></tr><tr><td><code>source/js/fomal/fonts.js</code></td><td>字体选择、字体加载检测</td></tr><tr><td><code>source/js/fomal/backgrounds.js</code></td><td>壁纸、纯色、自定义链接三种背景</td></tr><tr><td><code>source/js/fomal/snow.js</code></td><td>落雪（Canvas）</td></tr><tr><td><code>source/js/fomal/fireflies.js</code></td><td>萤火虫微光（纯 CSS 动画）</td></tr><tr><td><code>source/js/fomal/ripple.js</code></td><td>点击涟漪</td></tr><tr><td><code>source/js/fomal/panel.js</code></td><td>面板本体：HTML、分组、交互、恢复默认</td></tr><tr><td><code>source/css/beauty-panel.css</code></td><td>面板皮肤 + 外观开关 + 变量落点</td></tr><tr><td><code>source/css/custom.css</code></td><td>主题色变量、卡片底色、圆角、字体基准等全局规则</td></tr></tbody></table></div><p>加载顺序很重要，先记住一句话：<strong>首屏脚本同步放 <code>head</code>，其余依赖放 <code>bottom</code> 且保持「底层能力 → 面板」的先后</strong>。</p>              </div>            </details><h1 id="一、设计思路：首屏同步-CSS-变量-单一数据源"><a href="#一、设计思路：首屏同步-CSS-变量-单一数据源" class="headerlink" title="一、设计思路：首屏同步 + CSS 变量 + 单一数据源"></a>一、设计思路：首屏同步 + CSS 变量 + 单一数据源</h1><details class="folding-tag" blue><summary> 三层结构 </summary>              <div class='content'>              <p>综合美化模块分成三层，各管一件事：</p><ol><li><strong>数据层</strong>：<code>localStorage</code>。所有偏好只存一份，键名统一在 <code>boot.js</code> 里声明。</li><li><strong>应用层</strong>：<code>boot.js</code> 在 <code>&lt;head&gt;</code> 里同步执行，把偏好翻译成 CSS 变量和 <code>&lt;html&gt;</code> 类名。</li><li><strong>交互层</strong>：<code>panel.js</code> 只负责面板渲染和事件，改完值后同时「立即改样式 + 写回 <code>localStorage</code>」。</li></ol><p><code>boot.js</code> 必须是同步脚本，<strong>不能加 <code>defer</code></strong>。它要在浏览器绘制第一帧之前就把变量写好，否则会先闪一下默认蓝色、默认字体，再跳成你的配置。</p><p>先看键名和默认值的写法：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/boot.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>DEFAULTS</code> 和 <code>KEYS</code> 两个对象里补全，新增一项要两处同时加；从零接入时先新建该文件，再整段写入。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">DEFAULTS</span> = &#123;</span><br><span class="line">  <span class="attr">theme</span>: <span class="string">&#x27;#49b1f5&#x27;</span>,</span><br><span class="line">  <span class="attr">opacity</span>: <span class="number">88</span>,</span><br><span class="line">  <span class="attr">filterOn</span>: <span class="string">&#x27;1&#x27;</span>,</span><br><span class="line">  <span class="attr">filter</span>: <span class="string">&#x27;blur(0px) saturate(100%) contrast(100%)&#x27;</span>,</span><br><span class="line">  <span class="attr">textFont</span>: <span class="string">&#x27;myfont&#x27;</span>,</span><br><span class="line">  <span class="attr">codeFont</span>: <span class="string">&#x27;Consolas&#x27;</span>,</span><br><span class="line">  <span class="attr">snow</span>: <span class="string">&#x27;1&#x27;</span>,</span><br><span class="line">  <span class="attr">fireflies</span>: <span class="string">&#x27;0&#x27;</span>,</span><br><span class="line">  <span class="attr">ripple</span>: <span class="string">&#x27;1&#x27;</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">var</span> <span class="variable constant_">KEYS</span> = &#123;</span><br><span class="line">  <span class="attr">theme</span>: <span class="string">&#x27;hgTheme&#x27;</span>,</span><br><span class="line">  <span class="attr">opacity</span>: <span class="string">&#x27;hgCardOpacity&#x27;</span>,</span><br><span class="line">  <span class="attr">filterOn</span>: <span class="string">&#x27;hgBgFilterOn&#x27;</span>,</span><br><span class="line">  <span class="attr">filter</span>: <span class="string">&#x27;hgBgFilter&#x27;</span>,</span><br><span class="line">  <span class="attr">textFont</span>: <span class="string">&#x27;hgTextFont&#x27;</span>,</span><br><span class="line">  <span class="attr">codeFont</span>: <span class="string">&#x27;hgCodeFont&#x27;</span>,</span><br><span class="line">  <span class="attr">snow</span>: <span class="string">&#x27;hgSnowOn&#x27;</span>,</span><br><span class="line">  <span class="attr">fireflies</span>: <span class="string">&#x27;hgFirefliesOn&#x27;</span>,</span><br><span class="line">  <span class="attr">ripple</span>: <span class="string">&#x27;hgRippleOn&#x27;</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>键名集中管理的好处是：<code>boot.js</code>、<code>panel.js</code>、特效脚本都引用同一张表，以后改名只改一处。</p><p>然后一次性把变量写进 <code>&lt;html&gt;</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/boot.js</code> ｜ <strong>改法</strong>：在已有文件 IIFE 末尾的「应用偏好」段补全（<code>var d = w.document.documentElement</code> 之后），位置必须在 <code>HGBeauty.read()</code> 之后。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> d = <span class="variable language_">document</span>.<span class="property">documentElement</span></span><br><span class="line"><span class="keyword">var</span> s = <span class="title class_">HGBeauty</span>.<span class="title function_">read</span>()</span><br><span class="line"></span><br><span class="line">d.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--theme-color&#x27;</span>, s.<span class="property">theme</span>)</span><br><span class="line">d.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--trans-light&#x27;</span>, <span class="string">&#x27;rgba(255,255,255,&#x27;</span> + s.<span class="property">opacity</span> / <span class="number">100</span> + <span class="string">&#x27;)&#x27;</span>)</span><br><span class="line">d.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--trans-dark&#x27;</span>, <span class="string">&#x27;rgba(25,25,25,&#x27;</span> + s.<span class="property">opacity</span> / <span class="number">100</span> + <span class="string">&#x27;)&#x27;</span>)</span><br><span class="line">d.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-font&#x27;</span>, s.<span class="property">fontScale</span> === <span class="string">&#x27;large&#x27;</span> ? <span class="string">&#x27;1.15&#x27;</span> : <span class="string">&#x27;1&#x27;</span>)</span><br><span class="line">d.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-radius&#x27;</span>, s.<span class="property">radius</span> === <span class="string">&#x27;small&#x27;</span> ? <span class="string">&#x27;6px&#x27;</span> : (s.<span class="property">radius</span> === <span class="string">&#x27;large&#x27;</span> ? <span class="string">&#x27;18px&#x27;</span> : <span class="string">&#x27;12px&#x27;</span>))</span><br><span class="line">d.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hide-aside&#x27;</span>, !s.<span class="property">aside</span>)</span><br><span class="line">d.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hg-aside-left&#x27;</span>, s.<span class="property">asidePos</span> === <span class="string">&#x27;left&#x27;</span>)</span><br></pre></td></tr></table></figure><p>这里有两个原则：</p><ul><li><strong>能用变量就不用类名</strong>：颜色、透明度、字号、圆角都是变量，改一个值全站生效。</li><li><strong>只有「整块显隐 / 布局反转」才用类名</strong>：例如侧栏隐藏、侧栏换边、顶栏常驻。</li></ul><p><code>read()</code> 里所有数值都要做一次范围校验，避免用户手动改 <code>localStorage</code> 后把页面搞坏：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/boot.js</code> ｜ <strong>改法</strong>：在已有文件 <code>HGBeauty.read()</code> 返回的对象里替换 <code>opacity</code>、<code>theme</code> 两行，其余键照同样写法补范围校验。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">opacity</span>: <span class="title function_">num</span>(<span class="title function_">get</span>(<span class="variable constant_">KEYS</span>.<span class="property">opacity</span>, <span class="variable constant_">DEFAULTS</span>.<span class="property">opacity</span>), <span class="variable constant_">DEFAULTS</span>.<span class="property">opacity</span>, <span class="number">0</span>, <span class="number">100</span>),</span><br><span class="line"><span class="attr">theme</span>: <span class="regexp">/^#[0-9a-f]&#123;6&#125;$/i</span>.<span class="title function_">test</span>(theme) ? theme : <span class="variable constant_">DEFAULTS</span>.<span class="property">theme</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="二、弹窗骨架：把面板装进-WinBox"><a href="#二、弹窗骨架：把面板装进-WinBox" class="headerlink" title="二、弹窗骨架：把面板装进 WinBox"></a>二、弹窗骨架：把面板装进 WinBox</h1><details class="folding-tag" blue><summary> 创建面板 </summary>              <div class='content'>              <p>WinBox 是一个无依赖的浮动窗口库，自带拖动、最大化、最小化和关闭。面板的创建代码放在 <code>panel.js</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>toggleWinbox()</code> 函数内补全「创建面板」分支。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br></pre></td><td class="code"><pre><span class="line">winbox = <span class="variable language_">window</span>.<span class="title class_">WinBox</span>(&#123;</span><br><span class="line">  <span class="attr">id</span>: <span class="string">&#x27;meihuaBox&#x27;</span>,</span><br><span class="line">  <span class="attr">title</span>: <span class="string">&#x27;美化设置&#x27;</span>,</span><br><span class="line">  <span class="attr">x</span>: <span class="string">&#x27;center&#x27;</span>,</span><br><span class="line">  <span class="attr">y</span>: <span class="string">&#x27;center&#x27;</span>,</span><br><span class="line">  <span class="attr">width</span>: size[<span class="number">0</span>],</span><br><span class="line">  <span class="attr">height</span>: size[<span class="number">1</span>],</span><br><span class="line">  <span class="attr">minwidth</span>: <span class="number">300</span>,</span><br><span class="line">  <span class="attr">minheight</span>: <span class="number">360</span>,</span><br><span class="line">  <span class="attr">background</span>: <span class="string">&#x27;var(--theme-color)&#x27;</span>,</span><br><span class="line">  <span class="attr">class</span>: <span class="string">&#x27;hg-winbox&#x27;</span>,</span><br><span class="line">  <span class="attr">onclose</span>: <span class="keyword">function</span> (<span class="params"></span>) &#123; winbox = <span class="literal">null</span> &#125;,</span><br><span class="line">  <span class="attr">onminimize</span>: <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> box = <span class="variable language_">this</span></span><br><span class="line">    <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">centerMinimized</span>(box) &#125;, <span class="number">0</span>)</span><br><span class="line">  &#125;</span><br><span class="line">&#125;)</span><br><span class="line">winbox.<span class="property">body</span>.<span class="property">innerHTML</span> = <span class="title function_">panelHTML</span>()</span><br></pre></td></tr></table></figure><p>几个细节值得单独说：</p><ul><li><code>background: &#39;var(--theme-color)&#39;</code> 让标题栏跟随主题色，换色后不用重建窗口。</li><li>尺寸先用 <code>panelSize()</code> 根据视口算，再夹在安全范围里，手机上面板不会超出屏幕。</li><li>WinBox 原生的最小化是「贴到屏幕左下角」。这里在 <code>onminimize</code> 里再挪一次，让它在水平和垂直方向都居中：</li></ul><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>centerMinimized()</code> 函数内补全，位置紧跟在 <code>toggleWinbox()</code> 之后。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">centerMinimized</span> (box) &#123;</span><br><span class="line">  <span class="keyword">var</span> el = box &amp;&amp; box.<span class="property">g</span></span><br><span class="line">  <span class="keyword">if</span> (!el || !box.<span class="property">min</span>) <span class="keyword">return</span></span><br><span class="line">  el.<span class="property">style</span>.<span class="property">left</span> = <span class="title class_">Math</span>.<span class="title function_">max</span>(<span class="number">10</span>, <span class="title class_">Math</span>.<span class="title function_">round</span>((innerWidth - el.<span class="property">offsetWidth</span>) / <span class="number">2</span>)) + <span class="string">&#x27;px&#x27;</span></span><br><span class="line">  el.<span class="property">style</span>.<span class="property">top</span> = <span class="title class_">Math</span>.<span class="title function_">max</span>(<span class="number">10</span>, <span class="title class_">Math</span>.<span class="title function_">round</span>((innerHeight - el.<span class="property">offsetHeight</span>) / <span class="number">2</span>)) + <span class="string">&#x27;px&#x27;</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>最小化后窗口高度只剩标题栏（约 35px），所以直接用 <code>offsetHeight</code> 算垂直居中即可。<code>setTimeout(..., 0)</code> 是为了等 WinBox 把 <code>min</code> 类和高度都应用完再量尺寸。窗口大小变化时，如果仍处于最小化状态，也要重新居中：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>resize()</code> 函数内补全，紧接 <code>centerMinimized()</code> 定义之后。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">resize</span> () &#123;</span><br><span class="line">  <span class="keyword">if</span> (!winbox) <span class="keyword">return</span></span><br><span class="line">  <span class="keyword">if</span> (winbox.<span class="property">min</span>) &#123;</span><br><span class="line">    <span class="title function_">centerMinimized</span>(winbox)</span><br><span class="line">    <span class="keyword">return</span></span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">var</span> size = <span class="title function_">panelSize</span>()</span><br><span class="line">  winbox.<span class="title function_">resize</span>(size[<span class="number">0</span>], size[<span class="number">1</span>])</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>最后把入口挂到 <code>window</code> 上，Pug 模板里就能直接写 <code>onclick=&quot;toggleWinbox()&quot;</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：追加到已有文件末尾的导出段（和 <code>w.HG_PANEL</code> 等导出写在一起），只加这一行。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="variable language_">window</span>.<span class="property">toggleWinbox</span> = toggleWinbox</span><br></pre></td></tr></table></figure>              </div>            </details><details class="folding-tag" blue><summary> 两个入口按钮 </summary>              <div class='content'>              <p>导航栏按钮改 <code>[Blogroot]\themes\butterfly\layout\includes\header\nav.pug</code>，加在菜单和昼夜按钮之间：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/header/nav.pug</code> ｜ <strong>改法</strong>：在已有文件的菜单项与昼夜切换按钮之间插入（和相邻 <code>a</code> 同级缩进两格）；这是主题源码，升级主题会被覆盖，改完记得备份。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">//- 美化设置</span><br><span class="line">a.meihua.faa-parent.animated-hover(onclick=&quot;toggleWinbox()&quot; title=&quot;美化设置-自定义你的风格&quot; id=&quot;meihua-button&quot;)</span><br><span class="line">  i.fas.fa-palette</span><br></pre></td></tr></table></figure><p>图标可以换成任意 Font Awesome 图标，也可以内联 SVG。导航栏的悬停效果沿用站点自己的 <code>.faa-tada</code> 动效即可，不必再写一套。</p><p>右键菜单改 <code>[Blogroot]\themes\butterfly\layout\includes\rightmenu.pug</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/rightmenu.pug</code> ｜ <strong>改法</strong>：在已有文件的右键菜单项列表里插入一条，缩进和相邻 <code>a.rightMenu-item</code> 一致。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">a.rightMenu-item(href=&quot;javascript:toggleWinbox();&quot;)</span><br><span class="line">  i.fas.fa-cog</span><br><span class="line">  span=&#x27;美化设置&#x27;</span><br></pre></td></tr></table></figure><p>同一个 <code>toggleWinbox()</code> 会处理三种情况：没开就创建，已开就关闭，最小化状态先恢复。</p>              </div>            </details><details class="folding-tag" blue><summary> 面板分组 </summary>              <div class='content'>              <p>面板内容由 <code>panelHTML()</code> 一次性拼好，再塞进 <code>winbox.body</code>。目前分这几组：</p><ul><li><strong>显示偏好</strong>：卡片不透明度、背景滤镜开关、模糊 / 饱和度 / 对比度。</li><li><strong>氛围特效</strong>：星空、霓虹、雪花、萤火虫、昼夜过场档位。</li><li><strong>互动挂件</strong>：猫咪、听话鼠标、帧率监测、点击涟漪、性能模式。</li><li><strong>布局与部件</strong>：右侧部件、顶栏常驻、侧栏显示、右侧图标颜色、侧栏位置。</li><li><strong>主题色</strong>：11 个预设色点 + 自定义取色器。</li><li><strong>字体</strong>：正文 / 代码字体、整站字号、卡片圆角。</li><li><strong>背景</strong>：壁纸、纯色、自定义 HTTPS 链接。</li></ul><p>每个开关都是「标签 + 说明小字 + 胶囊开关」的固定结构，统一由 <code>toggleRow()</code> 生成，减少重复 HTML：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>toggleRow()</code> 函数内补全（面板 HTML 拼装区）。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">toggleRow</span> (id, title, note, checked, handler) &#123;</span><br><span class="line">  <span class="keyword">return</span> <span class="string">&#x27;&lt;label class=&quot;feature-opt&quot;&gt;&lt;span&gt;&#x27;</span> + title +</span><br><span class="line">    <span class="string">&#x27;&lt;small id=&quot;&#x27;</span> + id + <span class="string">&#x27;Hint&quot;&gt;&#x27;</span> + note + <span class="string">&#x27;&lt;/small&gt;&lt;/span&gt;&#x27;</span> +</span><br><span class="line">    <span class="string">&#x27;&lt;input id=&quot;&#x27;</span> + id + <span class="string">&#x27;&quot; type=&quot;checkbox&quot;&#x27;</span> + (checked ? <span class="string">&#x27; checked&#x27;</span> : <span class="string">&#x27;&#x27;</span>) +</span><br><span class="line">    <span class="string">&#x27; onchange=&quot;&#x27;</span> + handler + <span class="string">&#x27;(this.checked)&quot;&gt;&lt;/label&gt;&#x27;</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="三、主题色：一次改一组变量"><a href="#三、主题色：一次改一组变量" class="headerlink" title="三、主题色：一次改一组变量"></a>三、主题色：一次改一组变量</h1><details class="folding-tag" blue><summary> 预设色与派生色 </summary>              <div class='content'>              <p>主题色不是只改一个 <code>--theme-color</code>。主题里链接悬停、按钮、分页、滚动条、选中背景都引用了不同变量，所以 <code>applyTheme()</code> 要一次写全：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>applyTheme()</code> 函数内补全写变量的部分，<code>--on-theme</code> 用 <code>B.ink(rgb)</code> 取值。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">applyTheme</span> (hex) &#123;</span><br><span class="line">  <span class="keyword">var</span> rgb = <span class="title function_">hexToRgb</span>(hex)</span><br><span class="line">  <span class="keyword">var</span> channels = rgb.<span class="title function_">join</span>(<span class="string">&#x27;,&#x27;</span>)</span><br><span class="line">  <span class="keyword">var</span> root = <span class="variable language_">document</span>.<span class="property">documentElement</span></span><br><span class="line"></span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--theme-color&#x27;</span>, hex)</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--btn-bg&#x27;</span>, hex)</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--btn-hover-color&#x27;</span>, <span class="title function_">mix</span>(hex, <span class="string">&#x27;#ffffff&#x27;</span>, <span class="number">0.22</span>))</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--text-bg-hover&#x27;</span>, <span class="string">&#x27;rgba(&#x27;</span> + channels + <span class="string">&#x27;, 0.85)&#x27;</span>)</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--scrollbar-color&#x27;</span>, hex)</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--default-bg-color&#x27;</span>, hex)</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--waline-theme-color&#x27;</span>, hex)</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--on-theme&#x27;</span>, <span class="title function_">ink</span>(rgb))</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>mix()</code> 把主题色和白色按比例混合，得到按钮悬停色；<code>ink()</code> 根据亮度决定「实底上的文字」用黑还是白：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/boot.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>ink()</code> 函数内补全，并确认它已挂到 <code>HGBeauty.ink</code>；<code>panel.js</code> 只调用，不要另写一份。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">ink</span> (rgb) &#123;</span><br><span class="line">  <span class="keyword">var</span> lin = <span class="keyword">function</span> (<span class="params">v</span>) &#123;</span><br><span class="line">    v /= <span class="number">255</span></span><br><span class="line">    <span class="keyword">return</span> v &lt;= <span class="number">0.04045</span> ? v / <span class="number">12.92</span> : <span class="title class_">Math</span>.<span class="title function_">pow</span>((v + <span class="number">0.055</span>) / <span class="number">1.055</span>, <span class="number">2.4</span>)</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">var</span> L = <span class="number">0.2126</span> * <span class="title function_">lin</span>(rgb[<span class="number">0</span>]) + <span class="number">0.7152</span> * <span class="title function_">lin</span>(rgb[<span class="number">1</span>]) + <span class="number">0.0722</span> * <span class="title function_">lin</span>(rgb[<span class="number">2</span>])</span><br><span class="line">  <span class="keyword">return</span> L &gt; <span class="number">0.19</span> ? <span class="string">&#x27;#141a1c&#x27;</span> : <span class="string">&#x27;#ffffff&#x27;</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>这样选浅黄、浅粉主题色时，按钮文字自动变深，不会白字糊成一片。</p><p>预设色定义在 <code>panel.js</code> 顶部，想加自己的颜色只需要多写一行：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件顶部的 <code>PRESETS</code> 数组里追加一项，<code>id</code> 不要和已有色点重复。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">PRESETS</span> = [</span><br><span class="line">  &#123; <span class="attr">id</span>: <span class="string">&#x27;red&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;珊瑚红&#x27;</span>, <span class="attr">hex</span>: <span class="string">&#x27;#ef5a5a&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">id</span>: <span class="string">&#x27;matcha&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;抹茶绿&#x27;</span>, <span class="attr">hex</span>: <span class="string">&#x27;#66b34d&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">id</span>: <span class="string">&#x27;blue&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;晴空蓝&#x27;</span>, <span class="attr">hex</span>: <span class="string">&#x27;#49b1f5&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">id</span>: <span class="string">&#x27;pink&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;樱花粉&#x27;</span>, <span class="attr">hex</span>: <span class="string">&#x27;#ff8fa3&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">id</span>: <span class="string">&#x27;mint&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;薄荷青&#x27;</span>, <span class="attr">hex</span>: <span class="string">&#x27;#5ec8a0&#x27;</span> &#125;</span><br><span class="line">]</span><br></pre></td></tr></table></figure>              </div>            </details><details class="folding-tag" blue><summary> 主题里写死的颜色怎么办 </summary>              <div class='content'>              <p>主题有些地方把颜色写死了，变量覆盖不到，需要在 <code>[Blogroot]\source\css\beauty-panel.css</code> 里单独接一次。典型的是文章目录高亮（主题默认固定为青色）和作者卡的「前往小家」按钮：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾；主题色相关的面板样式统一放这里，不要写进 <code>custom.css</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* 目录高亮跟随主题色 */</span></span><br><span class="line"><span class="selector-id">#aside-content</span> <span class="selector-id">#card-toc</span> <span class="selector-class">.toc-content</span> <span class="selector-class">.toc-link</span><span class="selector-class">.active</span>,</span><br><span class="line"><span class="selector-id">#aside-content</span> <span class="selector-id">#card-toc</span> <span class="selector-class">.toc-content</span> <span class="selector-class">.toc-link</span><span class="selector-class">.active</span><span class="selector-pseudo">:hover</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--theme-color) <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">var</span>(--on-theme) <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-id">#aside-content</span> <span class="selector-id">#card-toc</span> <span class="selector-class">.toc-content</span> <span class="selector-class">.toc-link</span><span class="selector-pseudo">:hover</span> &#123;</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">var</span>(--theme-color);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 实底按钮上的文字用对比色 */</span></span><br><span class="line"><span class="selector-id">#aside-content</span> &gt; <span class="selector-class">.card-widget</span><span class="selector-class">.card-info</span> &gt; <span class="selector-id">#card-info-btn</span> &#123;</span><br><span class="line">  <span class="attribute">background-color</span>: <span class="built_in">var</span>(--theme-color);</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">var</span>(--on-theme);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>判断标准很简单：<strong>背景用 <code>--theme-color</code>，实底上的文字用 <code>--on-theme</code></strong>。不要再写死 <code>#fff</code>，否则换浅色主题时会看不清。</p>              </div>            </details><h1 id="四、卡片不透明度与背景滤镜"><a href="#四、卡片不透明度与背景滤镜" class="headerlink" title="四、卡片不透明度与背景滤镜"></a>四、卡片不透明度与背景滤镜</h1><details class="folding-tag" blue><summary> 不透明度 </summary>              <div class='content'>              <p>滑块和数字框绑定同一个值，范围 <code>0–100</code>，默认 <code>88</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>setOpacity()</code> 函数内补全。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">setOpacity</span> (value, persist) &#123;</span><br><span class="line">  <span class="keyword">var</span> n = <span class="title function_">clamp</span>(value, <span class="number">0</span>, <span class="number">100</span>)</span><br><span class="line">  <span class="keyword">var</span> root = <span class="variable language_">document</span>.<span class="property">documentElement</span></span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--trans-light&#x27;</span>, <span class="string">&#x27;rgba(255,255,255,&#x27;</span> + n / <span class="number">100</span> + <span class="string">&#x27;)&#x27;</span>)</span><br><span class="line">  root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--trans-dark&#x27;</span>, <span class="string">&#x27;rgba(25,25,25,&#x27;</span> + n / <span class="number">100</span> + <span class="string">&#x27;)&#x27;</span>)</span><br><span class="line">  <span class="keyword">if</span> (persist) <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;hgCardOpacity&#x27;</span>, <span class="title class_">String</span>(n))</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>真正让滑块生效的是 CSS 里所有卡片都引用这两个变量。<strong>Butterfly 5.x 的首页在 <code>#recent-posts</code> 和文章卡之间多了一层 <code>.recent-post-items</code></strong>，旧选择器只写直接子元素会漏掉首页卡片：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾；卡片底色属于通用魔改，放 <code>custom.css</code> 而不是 <code>beauty-panel.css</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-item</span>,</span><br><span class="line"><span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span>,</span><br><span class="line"><span class="selector-id">#aside-content</span> <span class="selector-class">.card-widget</span>,</span><br><span class="line"><span class="selector-tag">div</span><span class="selector-id">#post</span>,</span><br><span class="line"><span class="selector-tag">div</span><span class="selector-id">#page</span>,</span><br><span class="line"><span class="selector-tag">div</span><span class="selector-id">#archive</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--trans-light);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#aside-content</span> <span class="selector-class">.card-widget</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-tag">div</span><span class="selector-id">#post</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--trans-dark);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>分页那一排也吃同一个变量。注意主题的 <code>.pagination &gt; *:not(.space)</code> 把省略号排除在卡片底之外，不补的话「…」是一块透明的空白：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：紧接上一段卡片底色规则追加，继续留在 <code>custom.css</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#pagination</span> <span class="selector-class">.pagination</span> <span class="selector-class">.page-number</span>,</span><br><span class="line"><span class="selector-id">#pagination</span> <span class="selector-class">.pagination</span> <span class="selector-class">.extend</span>,</span><br><span class="line"><span class="selector-id">#pagination</span> <span class="selector-class">.pagination</span> <span class="selector-class">.space</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--trans-light);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#pagination</span> <span class="selector-class">.pagination</span> <span class="selector-class">.page-number</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#pagination</span> <span class="selector-class">.pagination</span> <span class="selector-class">.extend</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#pagination</span> <span class="selector-class">.pagination</span> <span class="selector-class">.space</span> &#123;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--trans-dark);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>滑块调到 100% 是纯实底，调到 0% 完全透明。如果觉得毛玻璃太重，可以把 <code>backdrop-filter</code> 一并做成变量，或交给低性能模式统一降级。</p>              </div>            </details><details class="folding-tag" blue><summary> 背景滤镜 </summary>              <div class='content'>              <p>滤镜只作用在背景层 <code>#web_bg</code>，不影响正文卡片：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>paintFilter()</code> 函数内补全，替换其中写变量、加类名的几行。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line">root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-bg-filter&#x27;</span>,</span><br><span class="line">  <span class="string">&#x27;blur(&#x27;</span> + f.<span class="property">blur</span> + <span class="string">&#x27;px) saturate(&#x27;</span> + f.<span class="property">saturation</span> + <span class="string">&#x27;%) contrast(&#x27;</span> + f.<span class="property">contrast</span> + <span class="string">&#x27;%)&#x27;</span>)</span><br><span class="line">root.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hg-bg-filtered&#x27;</span>, on)</span><br><span class="line">root.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hg-bg-blurred&#x27;</span>, on &amp;&amp; f.<span class="property">blur</span> &gt; <span class="number">0</span>)</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾的背景图规则区（<code>html.hg-has-bg #web_bg</code> 附近）。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#web_bg</span> &#123;</span><br><span class="line">  <span class="attribute">filter</span>: <span class="built_in">var</span>(--hg-bg-filter, none) <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">transition</span>: filter .<span class="number">25s</span> ease, transform .<span class="number">25s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 只有真的模糊了才放大一圈，遮住模糊后的边缘 */</span></span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-bg-blurred</span> <span class="selector-id">#web_bg</span> &#123;</span><br><span class="line">  <span class="attribute">transform</span>: <span class="built_in">scale</span>(<span class="number">1.03</span>);</span><br><span class="line">  <span class="attribute">transform-origin</span>: center center;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>这里踩过一个坑：一开始只要开启滤镜就 <code>scale(1.03)</code>，于是「模糊值调到 0」时背景图仍被放大，看起来像莫名其妙裁掉了一圈。正确做法是把「是否模糊」和「是否开启滤镜」拆成两个类名，<code>blur &gt; 0</code> 才加 <code>hg-bg-blurred</code>。</p>              </div>            </details><h1 id="五、字体、字号与圆角"><a href="#五、字体、字号与圆角" class="headerlink" title="五、字体、字号与圆角"></a>五、字体、字号与圆角</h1><details class="folding-tag" blue><summary> 字体选择 </summary>              <div class='content'>              <p>正文和代码字体分成两组。正文按用途再分「阅读」和「装饰」，面板里用小标题隔开：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/fonts.js</code> ｜ <strong>改法</strong>：在已有文件顶部的 <code>TEXT_FONTS</code> / <code>CODE_FONTS</code> 两个数组里补全，<code>group</code> 决定它落在「阅读」还是「装饰」小标题下。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">TEXT_FONTS</span> = [</span><br><span class="line">  &#123; <span class="attr">key</span>: <span class="string">&#x27;myfont&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;霞鹜文楷&#x27;</span>, <span class="attr">note</span>: <span class="string">&#x27;温润文楷 · 默认&#x27;</span>, <span class="attr">group</span>: <span class="string">&#x27;reading&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">key</span>: <span class="string">&#x27;LXGWNeoXiHei&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;霞鹜新晰黑&#x27;</span>, <span class="attr">note</span>: <span class="string">&#x27;清晰黑体 · 技术文章&#x27;</span>, <span class="attr">group</span>: <span class="string">&#x27;reading&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">key</span>: <span class="string">&#x27;SourceHanSerif&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;思源宋体&#x27;</span>, <span class="attr">note</span>: <span class="string">&#x27;书卷气 · 长文阅读&#x27;</span>, <span class="attr">group</span>: <span class="string">&#x27;reading&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">key</span>: <span class="string">&#x27;default&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;系统默认&#x27;</span>, <span class="attr">note</span>: <span class="string">&#x27;无需下载 · 跟随设备&#x27;</span>, <span class="attr">group</span>: <span class="string">&#x27;reading&#x27;</span> &#125;</span><br><span class="line">]</span><br><span class="line"></span><br><span class="line"><span class="keyword">var</span> <span class="variable constant_">CODE_FONTS</span> = [</span><br><span class="line">  &#123; <span class="attr">key</span>: <span class="string">&#x27;Consolas&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;Consolas&#x27;</span>, <span class="attr">note</span>: <span class="string">&#x27;清晰紧凑 · 默认&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">key</span>: <span class="string">&#x27;SourceCodePro&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;Source Code Pro&#x27;</span>, <span class="attr">note</span>: <span class="string">&#x27;经典等宽&#x27;</span> &#125;,</span><br><span class="line">  &#123; <span class="attr">key</span>: <span class="string">&#x27;MapleMono&#x27;</span>, <span class="attr">name</span>: <span class="string">&#x27;Maple Mono&#x27;</span>, <span class="attr">note</span>: <span class="string">&#x27;柔和圆润 · 等宽&#x27;</span> &#125;</span><br><span class="line">]</span><br></pre></td></tr></table></figure><p>选中后只改一个变量，CSS 负责落到具体元素：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/fonts.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>apply()</code> 函数内补全（先设变量，再写 <code>localStorage</code>）。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-text-font&#x27;</span>, <span class="title function_">textStack</span>(key))</span><br><span class="line"><span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-code-font&#x27;</span>, <span class="title function_">codeStack</span>(key))</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾的字体区，和顶部 <code>@font-face</code> 放在同一段。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">body</span> &#123;</span><br><span class="line">  <span class="attribute">font-family</span>: <span class="built_in">var</span>(--hg-text-font, myfont, -apple-system, <span class="string">&#x27;PingFang SC&#x27;</span>, sans-serif) <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-id">#article-container</span> pre,</span><br><span class="line"><span class="selector-id">#article-container</span> <span class="selector-tag">code</span>,</span><br><span class="line"><span class="selector-class">.highlight</span>,</span><br><span class="line"><span class="selector-class">.code-tools</span>,</span><br><span class="line">pre<span class="selector-attr">[class*=<span class="string">&#x27;language-&#x27;</span>]</span> &#123;</span><br><span class="line">  <span class="attribute">font-family</span>: <span class="built_in">var</span>(--hg-code-font, Consolas, monospace) <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>本地字体在 <code>beauty-panel.css</code> 顶部用 <code>@font-face</code> 引入，<code>font-display: swap</code> 保证字体没加载完时先用回退字体显示，不出现空白。</p>              </div>            </details><details class="folding-tag" blue><summary> 字体加载检测的两个坑 </summary>              <div class='content'>              <p>面板需要判断「这个字体到底有没有加载成功」，但 <code>document.fonts.load()</code> 对系统字体经常返回空结果。这里做了两件事：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/fonts.js</code> ｜ <strong>改法</strong>：<code>SYSTEM</code> 白名单放在已有文件顶部的常量区，<code>load()</code> 在已有文件里替换同名函数。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* Consolas、Monaco 和系统默认字体不检测，直接算可用 */</span></span><br><span class="line"><span class="keyword">var</span> <span class="variable constant_">SYSTEM</span> = &#123; <span class="attr">default</span>: <span class="number">1</span>, <span class="title class_">Monaco</span>: <span class="number">1</span>, <span class="title class_">Consolas</span>: <span class="number">1</span> &#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">load</span> (key) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable constant_">SYSTEM</span>[key] || !<span class="variable language_">document</span>.<span class="property">fonts</span>) <span class="keyword">return</span> <span class="title class_">Promise</span>.<span class="title function_">resolve</span>(<span class="literal">true</span>)</span><br><span class="line">  <span class="keyword">return</span> <span class="title class_">Promise</span>.<span class="title function_">race</span>([</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">fonts</span>.<span class="title function_">load</span>(<span class="string">&#x27;16px &quot;&#x27;</span> + key + <span class="string">&#x27;&quot;&#x27;</span>).<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params">faces</span>) &#123;</span><br><span class="line">      <span class="keyword">return</span> faces &amp;&amp; faces.<span class="property">length</span> &gt; <span class="number">0</span></span><br><span class="line">    &#125;).<span class="title function_">catch</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">return</span> <span class="literal">false</span> &#125;),</span><br><span class="line">    <span class="keyword">new</span> <span class="title class_">Promise</span>(<span class="keyword">function</span> (<span class="params">resolve</span>) &#123;</span><br><span class="line">      <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">resolve</span>(<span class="literal">false</span>) &#125;, <span class="number">9000</span>)</span><br><span class="line">    &#125;)</span><br><span class="line">  ])</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><ul><li><strong>系统字体白名单</strong>：<code>Consolas</code> 在本机明明能用，但 <code>fonts.load</code> 可能返回空数组，误报「加载失败」。直接跳过检测最稳。</li><li><strong>超时兜底</strong>：网络慢时不能无限转圈，9 秒判失败并保留原字体。</li></ul><p>如果字体文件路径写错，控制台会报 404，这种才是真的加载失败。</p>              </div>            </details><details class="folding-tag" blue><summary> 字号与圆角 </summary>              <div class='content'>              <p>「标准 / 大」两档对应 <code>1</code> 和 <code>1.15</code> 两个倍数。注意主题把基准字号写在 <code>body</code> 上，<strong>只改 <code>&lt;html&gt;</code> 的 <code>font-size</code> 不会生效</strong>，要直接缩放 <code>body</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾；字号基准属于通用魔改，放 <code>custom.css</code>，不要写进 <code>beauty-panel.css</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-pseudo">:root</span> &#123;</span><br><span class="line">  <span class="attr">--hg-font</span>: <span class="number">1</span>;</span><br><span class="line">  <span class="attr">--hg-radius</span>: <span class="number">12px</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-tag">body</span> &#123;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="built_in">calc</span>(<span class="built_in">var</span>(--global-font-size, <span class="number">16px</span>) * <span class="built_in">var</span>(--hg-font, <span class="number">1</span>));</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>这样正文、评论、目录里所有用 <code>em</code> 的子元素会一起缩放，比逐个选择器改字号稳。</p><p>圆角三档对应 <code>6px / 12px / 18px</code>，落在卡片、分页、版权框和代码块上。分页里的省略号 <code>.space</code> 也要带上，否则它是个直角白块：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：紧接上一段字号规则追加，圆角和字号放在同一处。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.card-widget</span>,</span><br><span class="line"><span class="selector-class">.recent-post-item</span>,</span><br><span class="line"><span class="selector-id">#pagination</span> <span class="selector-class">.page-number</span>,</span><br><span class="line"><span class="selector-id">#pagination</span> <span class="selector-class">.space</span>,</span><br><span class="line"><span class="selector-class">.post-copyright</span>,</span><br><span class="line"><span class="selector-id">#post</span> <span class="selector-class">.highlight</span> &#123;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="built_in">var</span>(--hg-radius) <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="六、背景设置：壁纸、纯色、自定义链接"><a href="#六、背景设置：壁纸、纯色、自定义链接" class="headerlink" title="六、背景设置：壁纸、纯色、自定义链接"></a>六、背景设置：壁纸、纯色、自定义链接</h1><details class="folding-tag" blue><summary> 三种背景 </summary>              <div class='content'>              <p>背景面板分三个页签：</p><ul><li><strong>壁纸</strong>：二次元、风景、萌宠、手机四个分类，点击缩略图切换。</li><li><strong>颜色</strong>：预设纯色 + 自定义取色器。</li><li><strong>自定义</strong>：粘贴一个 HTTPS 图片链接，先预览验证，再应用到全站。</li></ul><p>所有远程图片都<strong>先探测再应用</strong>，加载失败就保留当前背景，不会把页面搞成一片空白：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/backgrounds.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>probe()</code> 函数内补全，替换图片探测的 <code>onload</code> / <code>onerror</code> 回调。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> image = <span class="keyword">new</span> <span class="title class_">Image</span>()</span><br><span class="line">image.<span class="property">referrerPolicy</span> = <span class="string">&#x27;no-referrer&#x27;</span></span><br><span class="line">image.<span class="property">onload</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">resolve</span>(image.<span class="property">naturalWidth</span> &gt; <span class="number">0</span>) &#125;</span><br><span class="line">image.<span class="property">onerror</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">resolve</span>(<span class="literal">false</span>) &#125;</span><br><span class="line">image.<span class="property">src</span> = url</span><br></pre></td></tr></table></figure><p>应用时只做两件事：写变量、加类名。</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/backgrounds.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>apply()</code> 函数内补全，写变量和加类名都在这一处。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">apply</span> (value) &#123;</span><br><span class="line">  <span class="keyword">var</span> parsed = <span class="title function_">parse</span>(value)</span><br><span class="line">  <span class="keyword">if</span> (!parsed) <span class="keyword">return</span> <span class="literal">false</span></span><br><span class="line">  <span class="keyword">var</span> root = <span class="variable language_">document</span>.<span class="property">documentElement</span></span><br><span class="line">  <span class="keyword">if</span> (parsed.<span class="property">kind</span> === <span class="string">&#x27;default&#x27;</span>) &#123;</span><br><span class="line">    root.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;hg-has-bg&#x27;</span>)</span><br><span class="line">    root.<span class="property">style</span>.<span class="title function_">removeProperty</span>(<span class="string">&#x27;--hg-bg-image&#x27;</span>)</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    root.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-bg-image&#x27;</span>, <span class="title function_">bgToCss</span>(parsed.<span class="property">css</span>))</span><br><span class="line">    root.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;hg-has-bg&#x27;</span>)</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">return</span> <span class="literal">true</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾的背景图规则区。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-has-bg</span> <span class="selector-id">#web_bg</span> &#123;</span><br><span class="line">  <span class="attribute">background-image</span>: <span class="built_in">var</span>(--hg-bg-image) <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">background-size</span>: cover <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">background-position</span>: center center <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">background-repeat</span>: no-repeat <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">filter</span>: <span class="built_in">var</span>(--hg-bg-filter, none) <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>这里必须用 <code>!important</code>：主题会给 <code>#web_bg</code> 写内联 <code>background-image</code>，手机端还有一条带 <code>!important</code> 的规则，普通选择器压不过去。</p><p>教程里的示例图用了公共占位图服务，正式使用时换成自己的图片，建议压缩成 WebP 并放在本地 <code>source/img</code> 下，既快又不依赖第三方。</p>              </div>            </details><details class="folding-tag" blue><summary> 自定义链接与配置格式 </summary>              <div class='content'>              <p>「自定义」页签只接受 <code>https://</code> 开头的图片链接，取色器也只接受十六进制颜色。校验放在应用前，而不是等 CSS 渲染失败：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/boot.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>bgToCss()</code> 函数内补全，并确认已导出到 <code>HGBeauty.bgToCss</code>；<code>backgrounds.js</code> 里只调用，不重复实现。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">bgToCss</span> (value) &#123;</span><br><span class="line">  value = value.<span class="title function_">trim</span>()</span><br><span class="line">  <span class="keyword">if</span> (!value || value === <span class="string">&#x27;default&#x27;</span>) <span class="keyword">return</span> <span class="string">&#x27;&#x27;</span></span><br><span class="line">  <span class="keyword">if</span> (<span class="regexp">/^#[0-9a-f]&#123;3,8&#125;$/i</span>.<span class="title function_">test</span>(value)) &#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="string">&#x27;linear-gradient(&#x27;</span> + value + <span class="string">&#x27;, &#x27;</span> + value + <span class="string">&#x27;)&#x27;</span></span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">if</span> (<span class="regexp">/^https:\/\/[^&quot;&#x27;()\s]+$/</span>.<span class="title function_">test</span>(value)) &#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="string">&#x27;url(&quot;&#x27;</span> + value + <span class="string">&#x27;&quot;)&#x27;</span></span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">return</span> <span class="string">&#x27;&#x27;</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>如果你同时把壁纸写进主题配置，注意 <strong>Butterfly 5.x 的 <code>background</code> 只填纯路径或颜色</strong>，例如 <code>background: /img/bg.webp</code>。5.x 会自动包一层 <code>url()</code>，你再手写 <code>url(...)</code> 就会变成双层 <code>url()</code>，最终背景 404、首页空白。综合美化模块内部存的是 <code>url(...)</code>，所以它自己负责用 <code>bgToCss()</code> 转换，两套逻辑不要混用。</p>              </div>            </details><h1 id="七、布局与部件"><a href="#七、布局与部件" class="headerlink" title="七、布局与部件"></a>七、布局与部件</h1><details class="folding-tag" blue><summary> 侧栏换边、顶栏常驻、右侧部件 </summary>              <div class='content'>              <p>这三项都是「加一个类名，让 CSS 换一种布局」，不动主题的 Pug 结构。</p><p>侧栏从右换到左，本质是把同一行 flex 反向排列：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾的布局开关区，<code>hg-aside-left</code> 系列规则放一起。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-aside-left</span> <span class="selector-id">#content-inner</span><span class="selector-class">.layout</span> &#123;</span><br><span class="line">  <span class="attribute">flex-direction</span>: row-reverse;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">@media</span> (<span class="attribute">max-width</span>: <span class="number">900px</span>) &#123;</span><br><span class="line">  <span class="selector-tag">html</span><span class="selector-class">.hg-aside-left</span> <span class="selector-id">#content-inner</span><span class="selector-class">.layout</span> &#123;</span><br><span class="line">    <span class="attribute">flex-direction</span>: column;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>但主题只给「侧栏在右」留了 <code>padding-left: 15px</code>。反排到左侧后，这段空白跑到最外边，侧栏和文章就贴在一起了。所以要把内边距换到另一边：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：紧接上一段 <code>hg-aside-left</code> 规则追加，媒体查询里的内边距修正要和它连着写。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@media</span> (<span class="attribute">min-width</span>: <span class="number">900px</span>) &#123;</span><br><span class="line">  <span class="selector-tag">html</span><span class="selector-class">.hg-aside-left</span> <span class="selector-id">#aside-content</span> &#123;</span><br><span class="line">    <span class="attribute">padding-left</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attribute">padding-right</span>: <span class="number">15px</span> <span class="meta">!important</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>顶栏常驻则是把主题滚动时的 <code>top: -60px</code> 和上滑位移一起取消：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾，<code>hg-nav-always</code> 单独一组。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-nav-always</span> <span class="selector-id">#page-header</span><span class="selector-class">.nav-fixed</span> <span class="selector-id">#nav</span> &#123;</span><br><span class="line">  <span class="attribute">top</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">transform</span>: none <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>右侧部件隐藏最简单，直接不显示：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾，紧跟 <code>hg-nav-always</code> 那组。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-rightside-off</span> <span class="selector-id">#rightside</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: none <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>              </div>            </details><details class="folding-tag" blue><summary> 右侧图标颜色与一个全局覆盖的坑 </summary>              <div class='content'>              <p>右侧「回到顶部 / 目录」等按钮默认是白色。为了让颜色可配置，用了一个专用变量：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾；这条右侧图标颜色规则实际写在 <code>custom.css</code>，不在 <code>beauty-panel.css</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#rightside</span> &gt; <span class="selector-tag">div</span> &gt; <span class="selector-tag">button</span>,</span><br><span class="line"><span class="selector-id">#rightside</span> &gt; <span class="selector-tag">div</span> &gt; <span class="selector-tag">a</span> &#123;</span><br><span class="line">  <span class="attribute">color</span>: <span class="built_in">var</span>(--hg-rightside-color, <span class="number">#ffffff</span>) <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>setRightsideColor()</code> 函数内补全。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">setRightsideColor</span> (value, persist) &#123;</span><br><span class="line">  <span class="keyword">var</span> hex = <span class="regexp">/^#[0-9a-f]&#123;6&#125;$/i</span>.<span class="title function_">test</span>(value) ? value : <span class="string">&#x27;#ffffff&#x27;</span></span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-rightside-color&#x27;</span>, hex)</span><br><span class="line">  <span class="keyword">if</span> (persist) <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;hgRightsideColor&#x27;</span>, hex)</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><strong>这里有个很容易犯的错</strong>：不要为了「让按钮跟随主题色」去写全局的 <code>--btn-color: var(--on-theme) !important</code>。主题的 <code>--btn-color</code> 被大量按钮共用，一改就会把右侧图标、播放器按钮、各种圆形按钮全部变深，看起来像图标「变黑」了。正确做法是只给目标区域一个专用变量，默认值保持白色。</p>              </div>            </details><h1 id="八、特效开关：默认值、互斥与降级"><a href="#八、特效开关：默认值、互斥与降级" class="headerlink" title="八、特效开关：默认值、互斥与降级"></a>八、特效开关：默认值、互斥与降级</h1><details class="folding-tag" blue><summary> 雪花 </summary>              <div class='content'>              <p>雪花用 Canvas 绘制，核心是「预渲染雪片 + 时间驱动 + 有限高度积雪」：</p><ul><li>雪片不是每帧重新画路径，而是预先渲染两种尺寸的六臂雪片贴图，帧里只做 <code>drawImage</code>。</li><li>位置按时间差推进，切后台再回来不会瞬移。</li><li>落地后在底部累积一层薄雪，并给新雪片留出空间。</li><li><strong>只在浅色、桌面端（宽度 &gt; 768px）且系统没有要求减少动态效果时运行</strong>。</li><li>页面隐藏、<code>pagehide</code>、系统开启 <code>prefers-reduced-motion</code> 时自动停掉绘制循环。</li></ul><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/snow.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>frame()</code> 函数内补全，落地积雪与重置雪片写在绘制之后。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">frame</span> (time) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">hidden</span> || away || (reduced &amp;&amp; reduced.<span class="property">matches</span>)) &#123;</span><br><span class="line">    <span class="title function_">stop</span>()</span><br><span class="line">    <span class="keyword">return</span></span><br><span class="line">  &#125;</span><br><span class="line">  <span class="comment">// ...推进雪片、绘制、落地积雪...</span></span><br><span class="line">  <span class="keyword">if</span> (f.<span class="property">y</span> + f.<span class="property">size</span> &gt;= height - <span class="title function_">depthAt</span>(f.<span class="property">x</span>)) &#123;</span><br><span class="line">    <span class="title function_">deposit</span>(f.<span class="property">x</span>, f.<span class="property">size</span>)</span><br><span class="line">    flakes[i] = <span class="title function_">flake</span>(-<span class="number">8</span> - <span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="number">40</span>)</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>默认开启，但只在白天桌面生效；夜间、手机和「减少动态效果」偏好下会自动隐藏，不需要用户额外操作。</p>              </div>            </details><details class="folding-tag" blue><summary> 萤火虫、涟漪与互斥 </summary>              <div class='content'>              <p><strong>萤火虫</strong>是纯 CSS 动画，没有 Canvas、没有 <code>requestAnimationFrame</code>、没有常驻定时器：</p><ul><li>桌面 14 个、窄屏 8 个光点，随机分布在下半屏。</li><li>每个光点独立设置漂移时长、呼吸时长、延迟和颜色，靠 CSS 变量驱动。</li><li>页面隐藏时给容器加 <code>hidden</code>，动画暂停。</li></ul><p><strong>雪花和萤火虫互斥</strong>：两者都在背景层，同时开会糊成一片。开启萤火虫时自动关掉雪花，开启雪花时自动关掉萤火虫：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>setSnow()</code> 函数里补全这段互斥；反向的「开萤火虫时关雪花」在 <code>[Blogroot]/source/js/fomal/fireflies.js</code> 的启用逻辑里（<code>snowOn()</code> 成立时调 <code>disableSnow()</code>），两处都要有。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">// 雪花开启时</span></span><br><span class="line"><span class="keyword">if</span> (on === <span class="literal">true</span> &amp;&amp; <span class="variable language_">window</span>.<span class="property">FOMAL_FIREFLIES</span>) &#123;</span><br><span class="line">  <span class="variable language_">window</span>.<span class="property">FOMAL_FIREFLIES</span>.<span class="title function_">setEnabled</span>(<span class="literal">false</span>)</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><strong>点击涟漪</strong>默认开启，按下位置泛开两圈水纹，700ms 后自动移除。最多同时保留 6 组，关闭时连 <code>pointerdown</code> 监听都不挂：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/ripple.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>spawn()</code> 函数内补全。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">spawn</span> (x, y) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="title function_">quiet</span>()) <span class="keyword">return</span></span><br><span class="line">  <span class="keyword">var</span> host = <span class="title function_">ensureLayer</span>()</span><br><span class="line">  <span class="comment">// 两条 ring 用 CSS 动画扩散，结束后由 timeout 删除</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>prefers-reduced-motion</code> 打开时，涟漪和萤火虫都会暂停，而不是直接报错或继续播放。</p>              </div>            </details><details class="folding-tag" blue><summary> 星空、霓虹与挂件 </summary>              <div class='content'>              <p><strong>星空</strong>和<strong>霓虹</strong>沿用主题已有的 Canvas 和动画，面板只负责显示 / 隐藏：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/beauty-panel.css</code> ｜ <strong>改法</strong>：追加到文件末尾，星空与霓虹两个开关放同一组。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-universe-off</span> <span class="selector-id">#universe</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: none <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-neon-off</span><span class="selector-attr">[data-theme=<span class="string">&#x27;dark&#x27;</span>]</span> <span class="selector-id">#site-name</span>,</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-neon-off</span><span class="selector-attr">[data-theme=<span class="string">&#x27;dark&#x27;</span>]</span> <span class="selector-id">#site-title</span>,</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.hg-neon-off</span><span class="selector-attr">[data-theme=<span class="string">&#x27;dark&#x27;</span>]</span> <span class="selector-id">#post-info</span> &#123;</span><br><span class="line">  <span class="attribute">animation</span>: none <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">text-shadow</span>: none <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>主题的星空脚本每帧都会检查 Canvas 是否可见，<code>display: none</code> 后绘制循环会自己停掉，不需要改它的源码。</p><p><strong>猫咪挂件、听话鼠标、帧率监测、性能模式</strong>由已有脚本提供开关函数，面板只调用：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：分别补在已有文件的 <code>setNeko()</code>、<code>setCursor()</code>、<code>setFps()</code>、<code>setPerf()</code> 四个函数里，每个函数只留对应那一行。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">setNekoEnabled</span> === <span class="string">&#x27;function&#x27;</span>) <span class="variable language_">window</span>.<span class="title function_">setNekoEnabled</span>(<span class="literal">true</span>)</span><br><span class="line"><span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">CURSOR</span> &amp;&amp; <span class="variable language_">window</span>.<span class="property">CURSOR</span>.<span class="property">setEnabled</span>) <span class="variable language_">window</span>.<span class="property">CURSOR</span>.<span class="title function_">setEnabled</span>(<span class="literal">true</span>)</span><br><span class="line"><span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">fpsSwitch</span> === <span class="string">&#x27;function&#x27;</span>) <span class="variable language_">window</span>.<span class="title function_">fpsSwitch</span>(<span class="literal">true</span>)</span><br><span class="line"><span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">perfLite</span> === <span class="string">&#x27;function&#x27;</span>) <span class="variable language_">window</span>.<span class="title function_">perfLite</span>(<span class="literal">false</span>)</span><br></pre></td></tr></table></figure><p>这体现了一个原则：<strong>面板不重复实现能力，只做开关和持久化</strong>。以后新增特效，只要对方暴露一个 <code>setEnabled()</code>，面板加一行调用即可。</p>              </div>            </details><h1 id="九、恢复默认与刷新后的状态"><a href="#九、恢复默认与刷新后的状态" class="headerlink" title="九、恢复默认与刷新后的状态"></a>九、恢复默认与刷新后的状态</h1><details class="folding-tag" blue><summary> 一键恢复 </summary>              <div class='content'>              <p>「恢复默认设置」不是逐个手写重置，而是遍历默认值表：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：在已有文件的 <code>resetAll()</code> 函数内补全，新增配置项后这里不用改。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">resetAll</span> () &#123;</span><br><span class="line">  <span class="keyword">var</span> keys = <span class="title class_">Object</span>.<span class="title function_">keys</span>(<span class="variable constant_">KEYS</span>)</span><br><span class="line">  <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; keys.<span class="property">length</span>; i++) &#123;</span><br><span class="line">    <span class="keyword">var</span> name = keys[i]</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable constant_">KEYS</span>[name] &amp;&amp; <span class="variable constant_">DEFAULTS</span>[name] !== <span class="literal">undefined</span>) &#123;</span><br><span class="line">      <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="variable constant_">KEYS</span>[name], <span class="title class_">String</span>(<span class="variable constant_">DEFAULTS</span>[name]))</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">classList</span>.<span class="title function_">remove</span>(</span><br><span class="line">    <span class="string">&#x27;hg-rightside-off&#x27;</span>, <span class="string">&#x27;hide-aside&#x27;</span>, <span class="string">&#x27;hg-aside-left&#x27;</span>,</span><br><span class="line">    <span class="string">&#x27;hg-nav-always&#x27;</span>, <span class="string">&#x27;hg-universe-off&#x27;</span>, <span class="string">&#x27;hg-neon-off&#x27;</span></span><br><span class="line">  )</span><br><span class="line"></span><br><span class="line">  <span class="title function_">applyTheme</span>(<span class="variable constant_">DEFAULTS</span>.<span class="property">theme</span>)</span><br><span class="line">  <span class="title function_">setOpacity</span>(<span class="variable constant_">DEFAULTS</span>.<span class="property">opacity</span>, <span class="literal">false</span>)</span><br><span class="line">  <span class="title function_">setFontScale</span>(<span class="variable constant_">DEFAULTS</span>.<span class="property">fontScale</span>, <span class="literal">false</span>)</span><br><span class="line">  <span class="title function_">setRadius</span>(<span class="variable constant_">DEFAULTS</span>.<span class="property">radius</span>, <span class="literal">false</span>)</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">FOMAL_SNOW</span>) <span class="variable language_">window</span>.<span class="property">FOMAL_SNOW</span>.<span class="title function_">setEnabled</span>(<span class="variable constant_">DEFAULTS</span>.<span class="property">snow</span> === <span class="string">&#x27;1&#x27;</span>)</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">FOMAL_FIREFLIES</span>) <span class="variable language_">window</span>.<span class="property">FOMAL_FIREFLIES</span>.<span class="title function_">setEnabled</span>(<span class="literal">false</span>)</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">FOMAL_RIPPLE</span>) <span class="variable language_">window</span>.<span class="property">FOMAL_RIPPLE</span>.<span class="title function_">setEnabled</span>(<span class="variable constant_">DEFAULTS</span>.<span class="property">ripple</span> === <span class="string">&#x27;1&#x27;</span>)</span><br><span class="line"></span><br><span class="line">  <span class="title function_">syncAll</span>()</span><br><span class="line">  <span class="title function_">toast</span>(<span class="string">&#x27;已恢复默认设置&#x27;</span>, <span class="string">&#x27;success&#x27;</span>)</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>好处是新增配置项时，只要往 <code>DEFAULTS</code> 和 <code>KEYS</code> 里各加一行，重置逻辑自动覆盖，不会漏项。</p><p>刷新后的状态由 <code>boot.js</code> 负责恢复。由于所有脚本是整站注入、不是每次切换页面都重新执行，Pjax 跳转后变量和 <code>&lt;html&gt;</code> 类名仍然在，面板打开时的控件状态则由 <code>syncAll()</code> 从 <code>localStorage</code> 重新读取。</p>              </div>            </details><h1 id="十、接入步骤与避坑清单"><a href="#十、接入步骤与避坑清单" class="headerlink" title="十、接入步骤与避坑清单"></a>十、接入步骤与避坑清单</h1><details class="folding-tag" blue><summary> 五步接入 </summary>              <div class='content'>              <ol><li><strong>放文件</strong>：把 <code>boot.js</code>、<code>panel.js</code>、<code>fonts.js</code>、<code>backgrounds.js</code>、<code>snow.js</code>、<code>fireflies.js</code>、<code>ripple.js</code>、<code>winbox.min.js</code> 放进 <code>[Blogroot]\source\js\fomal\</code>；把 <code>beauty-panel.css</code> 放进 <code>[Blogroot]\source\css\</code>。</li><li><strong>注入资源</strong>：改 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject</code>，注意 <code>boot.js</code> 同步放 <code>head</code>，其余按依赖顺序放 <code>bottom</code>。</li><li><strong>加入口</strong>：改 <code>nav.pug</code> 和 <code>rightmenu.pug</code>，两处都调用 <code>toggleWinbox()</code>。</li><li><strong>补全局样式</strong>：在 <code>custom.css</code> 里补 <code>--hg-font</code>、<code>--hg-radius</code> 和卡片底色规则；主题色、目录高亮、右侧图标等写死颜色的地方按前面的方式接到变量上。</li><li><strong>本地验证</strong>：<code>npx hexo generate</code> 后打开页面，逐项拖动滑块、切换字体和壁纸，再刷新确认状态保持。</li></ol><p>配置参考（版本号和你的实际文件保持一致即可）：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：并进已有的 <code>inject</code> 配置，<code>boot.js</code> 放在 <code>inject.head</code> 列表里且不加 <code>defer</code>，其余按顺序放进 <code>inject.bottom</code> 列表；已有同名资源就改原行，不要重复添加。</p><figure class="highlight yaml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">src=&quot;/js/fomal/boot.js?v=20261122d&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;stylesheet&quot;</span> <span class="string">href=&quot;/css/custom.css?v=20261122e&quot;</span> <span class="string">media=&quot;defer&quot;</span> <span class="string">onload=&quot;this.media=&#x27;all&#x27;&quot;&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;stylesheet&quot;</span> <span class="string">href=&quot;/css/beauty-panel.css?v=20261122e&quot;&gt;</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/winbox.min.js?v=20261121ze&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/notify.js?v=20261121ze&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/fonts.js?v=20261122b&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/backgrounds.js?v=20261122&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/snow.js?v=20261122c&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/fireflies.js?v=20261122c&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/ripple.js?v=20261122c&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/panel.js?v=20261122g&quot;&gt;&lt;/script&gt;</span></span><br></pre></td></tr></table></figure><p>为什么顺序不能乱：<code>panel.js</code> 在创建面板时要读取 <code>HGBeauty</code>、<code>HG_FONTS</code>、<code>HG_BACKGROUNDS</code>，还要给雪花、萤火虫、涟漪挂开关；这些都必须在它之前加载。WinBox 也必须比 <code>panel.js</code> 先到，否则面板创建时会提示「弹窗组件没加载成功」。</p>              </div>            </details><details class="folding-tag" blue><summary> 避坑清单 </summary>              <div class='content'>              <ul><li><strong><code>boot.js</code> 不要加 <code>defer</code></strong>：它必须在首帧前执行，否则刷新会闪默认样式。</li><li><strong>Butterfly 5.x 首页多了一层 <code>.recent-post-items</code></strong>：卡片透明度、双排布局等选择器都要同时匹配两层。</li><li><strong>不要全局覆盖 <code>--btn-color</code></strong>：会让右侧图标和大量圆形按钮一起变深，应使用 <code>--hg-rightside-color</code> 这类专用变量。</li><li><strong>模糊值 0 不要放大背景</strong>：<code>hg-bg-filtered</code> 和 <code>hg-bg-blurred</code> 分开判断，只有 <code>blur &gt; 0</code> 才执行 <code>scale</code>。</li><li><strong>系统字体直接放行</strong>：<code>Consolas</code>、<code>Monaco</code>、系统默认字体不要交给 <code>document.fonts.load()</code> 判断，避免误报加载失败。</li><li><strong>字号改 <code>body</code>，不要改 <code>html</code></strong>：主题把基准字号写在 <code>body</code> 上，改 <code>&lt;html&gt;</code> 没有效果。</li><li><strong>主题配置里的背景只写路径</strong>：Butterfly 5.x 会自动包 <code>url()</code>，手写 <code>url(...)</code> 会变成双层。</li><li><strong>键名集中管理</strong>：<code>boot.js</code>、<code>panel.js</code> 和特效脚本共用同一张键名表，改名要一起改。</li><li><strong>最小化居中要等一帧</strong>：WinBox 先在回调里贴左下，<code>setTimeout(..., 0)</code> 后再按实际标题栏高度计算居中位置。</li><li><strong>改完配置文件强刷</strong>：<code>?v=</code> 参数用来打破缓存；如果预览没变化，重启 <code>hexo server</code> 再强制刷新一次。</li></ul><p>最后提醒一句：<strong>面板的价值在于「收口」</strong>。新增任何外观项，都先问自己能不能变成一个 CSS 变量或一个 <code>&lt;html&gt;</code> 类名；能的话，面板只需要加一个控件和一次 <code>setProperty()</code>，不要再写一套独立逻辑。</p>              </div>            </details><h1 id="小结"><a href="#小结" class="headerlink" title="小结"></a>小结</h1><p>综合美化模块的核心只有三句话：<strong>首屏同步应用偏好，所有外观走 CSS 变量和类名，面板只负责交互与持久化</strong>。按这篇文章的顺序接入，你可以得到一个即时生效、刷新保持、移动端也不会挤爆的美化面板。</p><p>下一步，打开面板把主题色调成你喜欢的颜色，再切换一次正文字体——这两项最能立刻看出模块是否接对了。</p><h1 id="延伸：列表页短内容的展开卡片"><a href="#延伸：列表页短内容的展开卡片" class="headerlink" title="延伸：列表页短内容的展开卡片"></a>延伸：列表页短内容的展开卡片</h1><p>列表页文章不足时，网站信息、公告、欢迎来访、倒计时和那年今日会进入 <code>#hg-side-fill</code> 的整页全宽网格。这部分没有新增面板控件，颜色、圆角和卡片底色继续吃美化面板的 CSS 变量；容器上的 <code>hg-fill-has-welcome</code>、<code>hg-fill-has-countdown</code> 只负责布局分栏，不是新的持久化偏好。</p><p>卡片搬出侧栏后要把 <code>20px 24px</code> 内边距一起补上，否则标题会贴边；这类规则和颜色变量一样都落在 <code>custom.css</code>。完整测量、搬运、逐张回收和 pjax 恢复逻辑在 <a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a>，本节不重复代码。</p><h1 id="改完怎么验证与部署"><a href="#改完怎么验证与部署" class="headerlink" title="改完怎么验证与部署"></a>改完怎么验证与部署</h1><p>文件放好、<code>inject</code> 顺序也对齐之后，不要直接上传，先按这个顺序走一遍：</p><ol><li><strong>生成</strong>：在博客根目录执行 <code>hexo generate</code>，命令行出现 <code>Generated</code> 再往下走。这一步报错，九成是 <code>_config.butterfly.yml</code> 的 <code>inject</code> 列表缩进或路径写错，先修配置再看别的。</li><li><strong>本地预览</strong>：执行 <code>hexo server</code>，打开 <code>http://localhost:4000</code>。打开面板依次试主题色、卡片不透明度、正文字体、壁纸和各特效，然后刷新一次，确认 <code>boot.js</code> 把偏好恢复回来、首帧不闪默认蓝色（闪一下说明它被加了 <code>defer</code> 或没放 <code>head</code>）。</li><li><strong>强刷或清缓存</strong>：改过 <code>custom.css</code>、<code>beauty-panel.css</code> 或 <code>fomal</code> 下的脚本后按 <code>Ctrl + F5</code>；<code>_config.butterfly.yml</code> 里对应的 <code>?v=</code> 版本号也要升一次，没升就改完重启 <code>hexo server</code>。启用了 Service Worker 时，再到 DevTools → Application → Service Workers 点 <code>Update</code> 或 <code>Unregister</code>。</li><li><strong>F12 查 404</strong>：Console 不应出现 <code>boot.js</code>、<code>panel.js</code>、<code>beauty-panel.css</code>、<code>winbox.min.js</code> 之类 404；Network 里筛 <code>fomal</code> 和 <code>beauty-panel</code>，确认请求全部 200 且版本号是刚改的。面板弹出「弹窗组件没加载成功」，说明 <code>winbox.min.js</code> 没排在 <code>panel.js</code> 之前。</li><li><strong>上传 <code>public/</code></strong>：生成目录就是 <code>public/</code>，按原来的托管方式传上去——Nginx 直接把 <code>public/</code> 覆盖到站点根目录，GitHub Pages 推送到发布分支或用 GitHub Actions，Vercel 连仓库自动构建，本地脚本托管则 <code>hexo deploy</code>。上线后关掉缓存再访问一次，确认线上与本地一致。</li></ol><p>如果线上和本地不一致，先怀疑缓存而不是代码：<code>?v=</code> 参数、Service Worker 缓存、CDN 缓存三层里任意一层没更新，看起来都像「改了没生效」。</p>]]>
    </content>
    <id>https://cookiesky.cn/2026/11/22/hexo-beauty/</id>
    <link href="https://cookiesky.cn/2026/11/22/hexo-beauty/"/>
    <published>2026-11-22T07:30:00.000Z</published>
    <summary>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p>
<ul>
<li><a]]>
    </summary>
    <title>综合美化模块教程：一个面板管完整站外观</title>
    <updated>2026-11-22T17:12:15.688Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a><br>本篇是第 21 ~ 41 个魔改，适用 <code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code>，末节是升级配置清单。</li></ul></div><div class="note info modern"><p>阅读约定：每个代码块上方都标了 <strong>文件</strong> 和 <strong>改法</strong>（终端命令标 <strong>执行位置</strong> 和 <strong>作用</strong>，目录树 / 报错 / 示意内容标 <strong>说明</strong>）。<code>[Blogroot]</code> 指博客根目录；「新建」是建文件后整段写入，「追加」是放到文件末尾，「替换 / 在 xxx 后插入」是在已有文件里改对应位置。改 <code>themes/</code> 下的模板和脚本前先备份，主题一升级就会被覆盖。</p></div><details class="folding-tag" blue><summary> 开始之前：一次装齐依赖 </summary>              <div class='content'>              <p>本教程里到处在用的折叠块、提示框，以及后面几节用到的插件，一行装齐：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：一次装齐本篇反复用到的插件（折叠块、页脚徽标、磁贴、历史日历、轮播、双栏、wowjs），装完 <code>package.json</code> 的依赖里会多出这些包。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-butterfly-tag-plugins-plus hexo-butterfly-footer-beautify hexo-electric-clock \</span><br><span class="line">            hexo-magnet hexo-history-calendar hexo-swiper-bar \</span><br><span class="line">            hexo-butterfly-article-double-row hexo-butterfly-wowjs --save</span><br></pre></td></tr></table></figure><ul><li><code>hexo-butterfly-tag-plugins-plus</code>：<code>{% folding %}</code>、<code>{% note %}</code> 这些标签由它提供，<strong>不装的话整篇文章的折叠块会变成纯文本</strong>。</li><li>其余插件是按节按需的，只做某一节就只装那一节（每节开头都单独写了命令）。</li><li>教程里的 <code>cp</code> 是 Linux / macOS 写法，Windows 用 <code>copy</code>，或者直接资源管理器里复制粘贴——效果一样。</li><li>下面所有路径都以 <code>[Blogroot]</code>（博客根目录）开头。</li></ul>              </div>            </details><h1 id="炫彩流光文字"><a href="#炫彩流光文字" class="headerlink" title="炫彩流光文字"></a>炫彩流光文字</h1><details class="folding-tag" blue><summary> 炫彩字 </summary>              <div class='content'>              <p>新建 <code>[Blogroot]\source\css\brinks.css</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/brinks.css</code> ｜ <strong>改法</strong>：新建文件，整段写入。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.brinks</span> &#123;</span><br><span class="line">    <span class="attribute">display</span>:flex;</span><br><span class="line">    <span class="attribute">z-index</span>:<span class="number">1</span>;</span><br><span class="line">    <span class="attribute">position</span>: relative;</span><br><span class="line">    <span class="attribute">justify-content</span>:center;</span><br><span class="line">    <span class="attribute">font-weight</span>: bold;</span><br><span class="line">    <span class="attribute">background-image</span>: <span class="built_in">linear-gradient</span>( to left, orangered, orange, gold, lightgreen, cyan, dodgerblue, mediumpurple, hotpink, orangered);</span><br><span class="line">    <span class="attribute">background-size</span>: <span class="number">100vw</span> <span class="number">100%</span>;</span><br><span class="line">    <span class="attribute">background-repeat</span>: repeat;</span><br><span class="line">    -webkit-<span class="attribute">background-clip</span>: text;</span><br><span class="line">    <span class="attribute">background-clip</span>: text;</span><br><span class="line">    <span class="attribute">color</span>: transparent;</span><br><span class="line">    -webkit-<span class="attribute">animation</span>: rainbowan <span class="number">60s</span> linear infinite;</span><br><span class="line">    <span class="attribute">animation</span>: rainbowan <span class="number">60s</span> linear infinite;</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">@-webkit-keyframes</span> rainbowan &#123;</span><br><span class="line">    <span class="selector-tag">to</span> &#123; <span class="attribute">background-position</span>: -<span class="number">2000vw</span>; &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">@keyframes</span> rainbowan &#123;</span><br><span class="line">    <span class="selector-tag">to</span> &#123; <span class="attribute">background-position</span>: -<span class="number">2000vw</span>; &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>background-size</code> 用 <code>100vw</code>、位移用 <code>-2000vw</code>，两者是整数倍关系（20 个周期），循环时颜色能接上，不会跳。<br>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.head</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在顶层 <code>inject:</code> 下的 <code>head:</code> 列表末尾追加这一条 <code>&lt;link&gt;</code>；缩进保持两格，和其它 <code>-</code> 项对齐。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;stylesheet&quot;</span> <span class="string">href=&quot;/css/brinks.css&quot;&gt;</span> <span class="comment">#炫彩字</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 使用：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：找到顶层 <code>footer:</code>，在它下面加 <code>custom_text:</code>（缩进两格）；已有 <code>custom_text</code> 就整行替换。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">footer:</span></span><br><span class="line">  <span class="attr">custom_text:</span> <span class="string">&lt;div</span> <span class="string">class=&quot;brinks&quot;&gt;I</span> <span class="string">wish</span> <span class="string">you</span> <span class="string">to</span> <span class="string">become</span> <span class="string">your</span> <span class="string">own</span> <span class="string">sun,</span> <span class="literal">no</span> <span class="string">need</span> <span class="string">to</span> <span class="string">rely</span> <span class="string">on</span> <span class="string">who&#x27;s</span> <span class="string">light.&lt;/div&gt;</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="全站自定义字体"><a href="#全站自定义字体" class="headerlink" title="全站自定义字体"></a>全站自定义字体</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）的字体本地化思路；字体本身来自 <code>LXGW WenKai</code>（OFL）。本站改动：按需做字体子集，只保留站内实际用到的字形并转成本地 <code>woff2</code>。</p></blockquote><details class="folding-tag" blue><summary> 霞鹜文楷 </summary>              <div class='content'>              <p>字体是开源免费的（OFL 协议），从 LXGW WenKai 官方仓库取，转成 woff2 再用：</p><p><strong>执行位置</strong>：本机终端（不必在博客根目录）｜ <strong>作用</strong>：装字体子集工具，把 <code>LXGWWenKai-Regular.ttf</code> 转成 woff2 并输出到 <code>source/font/</code>；<code>--output-file</code> 要写你自己博客的绝对路径。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment"># 1) 一次性装好字体转换工具</span></span><br><span class="line">pip install fonttools brotli</span><br><span class="line"></span><br><span class="line"><span class="comment"># 2) 到 https://github.com/lxgw/LxgwWenKai/releases 下载 LXGWWenKai-Regular.ttf</span></span><br><span class="line"><span class="comment">#    （GitHub 慢就用镜像站，或者按发布时间翻一下最新 Release）</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># 3) 转 woff2（体积约为 ttf 的 1/3），输出到博客 font 目录</span></span><br><span class="line">pyftsubset LXGWWenKai-Regular.ttf --flavor=woff2 --layout-features=<span class="string">&#x27;*&#x27;</span> \</span><br><span class="line">  --output-file=<span class="string">&quot;[Blogroot]\source\font\霞鹜文楷.woff2&quot;</span></span><br></pre></td></tr></table></figure><p>把字体文件放到 <code>[Blogroot]\source\font\霞鹜文楷.woff2</code> 之后，继续往下配。<br>在 <code>[Blogroot]\source\css\custom.css</code> 末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@font-face</span> &#123;</span><br><span class="line">  <span class="attribute">font-family</span>: <span class="string">&#x27;myfont&#x27;</span>;</span><br><span class="line">  <span class="attribute">src</span>: <span class="built_in">url</span>(<span class="string">/font/霞鹜文楷.woff2</span>) <span class="built_in">format</span>(<span class="string">&#x27;woff2&#x27;</span>);</span><br><span class="line">  <span class="attribute">font-weight</span>: normal;</span><br><span class="line">  <span class="attribute">font-style</span>: normal;</span><br><span class="line">  <span class="attribute">font-display</span>: swap;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：顶层 <code>font:</code>、<code>blog_title_font:</code>、<code>beautify:</code> 三个键下的对应项按此改写；<code>myfont</code> 必须和上一步 <code>@font-face</code> 里的 <code>font-family</code> 同名。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">font:</span></span><br><span class="line">  <span class="attr">global_font_size:</span> <span class="string">&#x27;16px&#x27;</span></span><br><span class="line">  <span class="attr">code_font_size:</span> <span class="string">&#x27;14px&#x27;</span></span><br><span class="line">  <span class="attr">font_family:</span> <span class="string">myfont,</span> <span class="string">-apple-system,</span> <span class="string">&#x27;Quicksand&#x27;</span><span class="string">,</span> <span class="string">&#x27;PingFang SC&#x27;</span><span class="string">,</span> <span class="string">&#x27;Microsoft Yahei&#x27;</span><span class="string">,</span> <span class="string">sans-serif;</span></span><br><span class="line">  <span class="attr">code_font_family:</span> <span class="string">Consolas,</span> <span class="string">myfont,</span> <span class="string">&quot;Microsoft YaHei&quot;</span><span class="string">,</span> <span class="string">Menlo,</span> <span class="string">monospace</span></span><br><span class="line"></span><br><span class="line"><span class="attr">blog_title_font:</span></span><br><span class="line">  <span class="attr">font_link:</span></span><br><span class="line">  <span class="attr">font_family:</span> <span class="string">myfont,</span> <span class="string">-apple-system,</span> <span class="string">BlinkMacSystemFont,</span> <span class="string">&quot;Segoe UI&quot;</span><span class="string">,</span> <span class="string">sans-serif</span></span><br><span class="line"></span><br><span class="line"><span class="attr">beautify:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">field:</span> <span class="string">post</span></span><br><span class="line">  <span class="attr">title_prefix_icon:</span> <span class="string">&#x27;\f863&#x27;</span></span><br><span class="line">  <span class="attr">title_prefix_icon_color:</span> <span class="string">&quot;#F47466&quot;</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.head</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：追加到 <code>inject.head</code> 列表末尾；<code>href</code> 里的中文文件名要用 URL 编码（<code>%E9%9C%9E...</code>）才稳。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;preload&quot;</span> <span class="string">as=&quot;font&quot;</span> <span class="string">type=&quot;font/woff2&quot;</span> <span class="string">href=&quot;/font/%E9%9C%9E%E9%B9%9C%E6%96%87%E6%A5%B7.woff2&quot;</span> <span class="string">crossorigin&gt;</span> <span class="comment">#正文字体预加载</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="FontAwesome-图标本地化"><a href="#FontAwesome-图标本地化" class="headerlink" title="FontAwesome 图标本地化"></a>FontAwesome 图标本地化</h1><details class="folding-tag" blue><summary> 图标本地化 </summary>              <div class='content'>              <p>不用手动去找 CSS 和字体，装官方 npm 包再拷出来即可：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：装 FontAwesome Free 6.5.1，并把 <code>fontawesome.min.css</code> 和三个 woff2 拷进 <code>source/css</code>、<code>source/webfonts</code>。Windows 下 <code>mkdir -p</code> / <code>cp</code> 换成手工建目录、复制粘贴即可。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line">npm install @fortawesome/fontawesome-free@6.5.1 --save-dev</span><br><span class="line"></span><br><span class="line"><span class="built_in">mkdir</span> -p <span class="built_in">source</span>/css <span class="built_in">source</span>/webfonts</span><br><span class="line"><span class="built_in">cp</span> node_modules/@fortawesome/fontawesome-free/css/fontawesome.min.css <span class="built_in">source</span>/css/</span><br><span class="line"><span class="built_in">cp</span> node_modules/@fortawesome/fontawesome-free/webfonts/fa-solid-900.woff2   <span class="built_in">source</span>/webfonts/</span><br><span class="line"><span class="built_in">cp</span> node_modules/@fortawesome/fontawesome-free/webfonts/fa-regular-400.woff2 <span class="built_in">source</span>/webfonts/</span><br><span class="line"><span class="built_in">cp</span> node_modules/@fortawesome/fontawesome-free/webfonts/fa-brands-400.woff2  <span class="built_in">source</span>/webfonts/</span><br></pre></td></tr></table></figure><p>拷完是这样（版本号跟着 npm 包里的一致，6.5.1 就是下面这些文件）：</p><p>把 Font Awesome Free 6.5.1 的三个字体文件放到 <code>[Blogroot]\source\webfonts\</code>：</p><p><strong>说明</strong>：示意内容，不需要修改——这是上一步拷完后的文件位置清单，用来核对有没有少拷。</p><figure class="highlight text"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">source/webfonts/fa-solid-900.woff2</span><br><span class="line">source/webfonts/fa-regular-400.woff2</span><br><span class="line">source/webfonts/fa-brands-400.woff2</span><br></pre></td></tr></table></figure><p>把官方 <code>fontawesome.min.css</code> 放到 <code>[Blogroot]\source\css\fontawesome.min.css</code>，其中三个 <code>@font-face</code> 的 <code>src</code> 改成：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/fontawesome.min.css</code> ｜ <strong>改法</strong>：这是官方 CSS 里三条 <code>@font-face</code> 的片段，只把三条 <code>src</code> 的 <code>url(...)</code> 换成 <code>/webfonts/...</code> 本地路径，其余规则原样保留。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@font-face</span>&#123;<span class="attribute">font-family</span>:<span class="string">&quot;Font Awesome 6 Free&quot;</span>;<span class="attribute">font-weight</span>:<span class="number">900</span>;<span class="attribute">src</span>:<span class="built_in">url</span>(<span class="string">/webfonts/fa-solid-900.woff2</span>) <span class="built_in">format</span>(<span class="string">&quot;woff2&quot;</span>)&#125;</span><br><span class="line"><span class="keyword">@font-face</span>&#123;<span class="attribute">font-family</span>:<span class="string">&quot;Font Awesome 6 Free&quot;</span>;<span class="attribute">font-weight</span>:<span class="number">400</span>;<span class="attribute">src</span>:<span class="built_in">url</span>(<span class="string">/webfonts/fa-regular-400.woff2</span>) <span class="built_in">format</span>(<span class="string">&quot;woff2&quot;</span>)&#125;</span><br><span class="line"><span class="keyword">@font-face</span>&#123;<span class="attribute">font-family</span>:<span class="string">&quot;Font Awesome 6 Brands&quot;</span>;<span class="attribute">font-weight</span>:<span class="number">400</span>;<span class="attribute">src</span>:<span class="built_in">url</span>(<span class="string">/webfonts/fa-brands-400.woff2</span>) <span class="built_in">format</span>(<span class="string">&quot;woff2&quot;</span>)&#125;</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：顶层 <code>CDN:</code> 下的 <code>option:</code> 里，把 <code>fontawesome:</code> 的值改成 <code>/css/fontawesome.min.css</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">CDN:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line">    <span class="attr">fontawesome:</span> <span class="string">/css/fontawesome.min.css</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.head</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：两条一起追加到 <code>inject.head</code> 列表末尾。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;preconnect&quot;</span> <span class="string">href=&quot;https://cdn.jsdelivr.net&quot;</span> <span class="string">crossorigin&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;dns-prefetch&quot;</span> <span class="string">href=&quot;https://cdn.jsdelivr.net&quot;&gt;</span></span><br></pre></td></tr></table></figure><p>菜单图标用 FA6 正式类名：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：顶层 <code>menu:</code> 列表里按需追加或替换对应项；<code>||</code> 前后分别是「图标 + 链接」和「悬停图标」，两处图标名要一致。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">menu:</span></span><br><span class="line">  <span class="string">隐私政策||fas</span> <span class="attr">fa-shield-halved:</span> <span class="string">/privacy/</span> <span class="string">||</span> <span class="string">fas</span> <span class="string">fa-shield-halved</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="一图流背景与遮罩"><a href="#一图流背景与遮罩" class="headerlink" title="一图流背景与遮罩"></a>一图流背景与遮罩</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：背景图换成本站 <code>WebP</code>，遮罩透明度单独用变量控制。</p></blockquote><details class="folding-tag" blue><summary> 一图流 </summary>              <div class='content'>              <p>把背景图放到 <code>[Blogroot]\source\img\bg.webp</code>。<br>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：顶层逐项改值——<code>background</code> 换成你的背景图路径，<code>index_img</code> / <code>default_top_img</code> 留空（一图流不需要单独封面），<code>footer_img: false</code>，<code>mask:</code> 下两个开关按需改。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">background:</span> <span class="string">/img/bg.webp</span></span><br><span class="line"><span class="attr">index_img:</span></span><br><span class="line"><span class="attr">default_top_img:</span></span><br><span class="line"><span class="attr">footer_img:</span> <span class="literal">false</span></span><br><span class="line"><span class="attr">mask:</span></span><br><span class="line">  <span class="attr">header:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">footer:</span> <span class="literal">true</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\source\css\custom.css</code> 末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;light&quot;</span>]</span> <span class="selector-id">#footer</span><span class="selector-pseudo">::before</span> &#123; <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">255</span>,<span class="number">255</span>,<span class="number">255</span>,.<span class="number">5</span>); &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span>  <span class="selector-id">#footer</span><span class="selector-pseudo">::before</span> &#123; <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">0</span>,<span class="number">0</span>,<span class="number">0</span>,.<span class="number">5</span>); &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;light&quot;</span>]</span> <span class="selector-id">#page-header</span><span class="selector-pseudo">::before</span> &#123; <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">255</span>,<span class="number">255</span>,<span class="number">255</span>,.<span class="number">3</span>); &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span>  <span class="selector-id">#page-header</span><span class="selector-pseudo">::before</span> &#123; <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">0</span>,<span class="number">0</span>,<span class="number">0</span>,.<span class="number">3</span>); &#125;</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.head</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：追加到 <code>inject.head</code> 列表末尾。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;preload&quot;</span> <span class="string">as=&quot;image&quot;</span> <span class="string">href=&quot;/img/bg.webp&quot;</span> <span class="string">fetchpriority=&quot;high&quot;&gt;</span> <span class="comment">#首屏背景预加载</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="页脚计时器与框架徽标"><a href="#页脚计时器与框架徽标" class="headerlink" title="页脚计时器与框架徽标"></a>页脚计时器与框架徽标</h1><blockquote><p>借鉴：店长（Fomalhaut 整理）。本站改动：插件静态资源改为本地托管，计时起点与徽标列表换成本站配置。</p></blockquote><details class="folding-tag" blue><summary> 页脚徽标 </summary>              <div class='content'>              <p>插件和它要用的静态文件，一条命令装好：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：装页脚徽标与计时插件，并把插件自带的 <code>runtime.js</code>、<code>runtime.css</code>、<code>swiperbdage_init.min.js</code> 与 swiper 本体拷进 <code>source/js</code>、<code>source/css</code>。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-butterfly-footer-beautify hexo-electric-clock --save</span><br><span class="line"></span><br><span class="line"><span class="built_in">mkdir</span> -p <span class="built_in">source</span>/js <span class="built_in">source</span>/css</span><br><span class="line"><span class="built_in">cp</span> node_modules/hexo-butterfly-footer-beautify/lib/runtime.js              <span class="built_in">source</span>/js/</span><br><span class="line"><span class="built_in">cp</span> node_modules/hexo-butterfly-footer-beautify/lib/runtime.css             <span class="built_in">source</span>/css/</span><br><span class="line"><span class="built_in">cp</span> node_modules/hexo-butterfly-footer-beautify/lib/swiperbdage_init.min.js <span class="built_in">source</span>/js/</span><br><span class="line"></span><br><span class="line"><span class="comment"># 徽标轮播要 swiper，插件本身不带，自己装一份</span></span><br><span class="line">npm install swiper@8 --save-dev</span><br><span class="line"><span class="built_in">cp</span> node_modules/swiper/swiper-bundle.min.js  <span class="built_in">source</span>/js/swiper.min.js</span><br><span class="line"><span class="built_in">cp</span> node_modules/swiper/swiper-bundle.min.css <span class="built_in">source</span>/css/swiper.min.css</span><br></pre></td></tr></table></figure><p>装完这些文件应该在对应路径：</p><p><strong>说明</strong>：示意内容，不需要修改——核对上面命令拷出来的文件是否都在对应路径。</p><figure class="highlight text"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">source/js/runtime.js</span><br><span class="line">source/css/runtime.css</span><br><span class="line">source/css/swiper.min.css</span><br><span class="line">source/js/swiper.min.js</span><br><span class="line">source/js/swiperbdage_init.min.js</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\themes\butterfly\layout\includes\layout.pug</code> 的 <code>footer#footer</code> 内补一层容器：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/layout.pug</code> ｜ <strong>改法</strong>：找到 <code>footer#footer(...)</code>，确认它下面用 <code>#footer-wrap</code> 包住了 <code>!=partial(&#39;includes/footer&#39;, ...)</code>；Butterfly 5.7.2 已自带这两行，缺了才补（缩进两层）。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">footer#footer(style=footer_bg)</span><br><span class="line">  #footer-wrap</span><br><span class="line">    !=partial(&#x27;includes/footer&#x27;, &#123;&#125;, &#123;cache: true&#125;)</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\source\css\custom.css</code> 末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#footer</span> <span class="selector-id">#footer-wrap</span> &gt; * &#123; <span class="attribute">position</span>: relative; <span class="attribute">color</span>: <span class="built_in">var</span>(--light-grey); &#125;</span><br><span class="line"><span class="selector-id">#footer-wrap</span> <span class="selector-class">.footer-other</span>,</span><br><span class="line"><span class="selector-id">#footer-wrap</span> <span class="selector-class">.beian-row</span>,</span><br><span class="line"><span class="selector-id">#footer-wrap</span> <span class="selector-id">#workboard</span>,</span><br><span class="line"><span class="selector-id">#footer-wrap</span> <span class="selector-id">#ghbdages</span> &#123; <span class="attribute">text-align</span>: center; &#125;</span><br><span class="line"><span class="selector-id">#footer</span> <span class="selector-id">#footer-wrap</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">flex-wrap</span>: wrap;</span><br><span class="line">  <span class="attribute">justify-content</span>: center;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">column-gap</span>: <span class="number">5px</span>;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-id">#footer-wrap</span> &gt; <span class="selector-class">.footer-other</span> &#123; <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">100%</span>; <span class="attribute">order</span>: <span class="number">0</span>; &#125;</span><br><span class="line"><span class="selector-id">#footer-wrap</span> &gt; <span class="selector-id">#workboard</span> &#123; <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">100%</span>; <span class="attribute">order</span>: <span class="number">1</span>; &#125;</span><br><span class="line"><span class="selector-id">#footer-wrap</span> &gt; <span class="selector-class">.beian-row</span>,</span><br><span class="line"><span class="selector-id">#footer-wrap</span> &gt; <span class="selector-id">#ghbdages</span> &#123; <span class="attribute">order</span>: <span class="number">2</span>; <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> auto; <span class="attribute">max-width</span>: <span class="number">100%</span>; <span class="attribute">margin-top</span>: <span class="number">8px</span>; &#125;</span><br><span class="line"><span class="selector-id">#footer-wrap</span> &gt; <span class="selector-id">#ghbdages</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: inline-flex;</span><br><span class="line">  <span class="attribute">flex-wrap</span>: wrap;</span><br><span class="line">  <span class="attribute">justify-content</span>: center;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">8px</span> <span class="number">0</span> <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">line-height</span>: <span class="number">1</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在文件末尾新增顶层 <code>footer_beautify:</code> 段（插件只认顶层键，别缩进到别的键下面）。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">footer_beautify:</span></span><br><span class="line">  <span class="attr">enable:</span></span><br><span class="line">    <span class="attr">timer:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">bdage:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">priority:</span> <span class="number">5</span></span><br><span class="line">  <span class="attr">enable_page:</span> <span class="string">all</span></span><br><span class="line">  <span class="attr">layout:</span></span><br><span class="line">    <span class="attr">type:</span> <span class="string">id</span></span><br><span class="line">    <span class="attr">name:</span> <span class="string">footer-wrap</span></span><br><span class="line">    <span class="attr">index:</span> <span class="number">0</span></span><br><span class="line">  <span class="attr">runtime_js:</span> <span class="string">/js/runtime.js</span></span><br><span class="line">  <span class="attr">runtime_css:</span> <span class="string">/css/runtime.css</span></span><br><span class="line">  <span class="attr">bdageitem:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">link:</span> <span class="string">https://hexo.io/</span></span><br><span class="line">      <span class="attr">shields:</span> <span class="string">https://img.shields.io/badge/Frame-Hexo-blue?style=flat&amp;logo=hexo</span></span><br><span class="line">      <span class="attr">message:</span> <span class="string">博客框架为Hexo_v8.1.2</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">link:</span> <span class="string">https://butterfly.js.org/</span></span><br><span class="line">      <span class="attr">shields:</span> <span class="string">https://img.shields.io/badge/Theme-Butterfly-6513df?style=flat&amp;logo=bitdefender</span></span><br><span class="line">      <span class="attr">message:</span> <span class="string">主题版本Butterfly_v5.7.2</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">link:</span> <span class="string">https://&lt;你的服务商&gt;/</span></span><br><span class="line">      <span class="attr">shields:</span> <span class="string">https://img.shields.io/badge/Host-&lt;你的服务商&gt;-0052D9?style=flat</span></span><br><span class="line">      <span class="attr">message:</span> <span class="string">站点托管信息</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">link:</span> <span class="string">http://creativecommons.org/licenses/by-nc-sa/4.0/</span></span><br><span class="line">      <span class="attr">shields:</span> <span class="string">https://img.shields.io/badge/Copyright-BY--NC--SA%204.0-d42328?style=flat</span></span><br><span class="line">      <span class="attr">message:</span> <span class="string">本站采用知识共享署名-非商业性使用-相同方式共享4.0国际许可协议进行许可</span></span><br><span class="line">  <span class="attr">swiper_css:</span> <span class="string">/css/swiper.min.css</span></span><br><span class="line">  <span class="attr">swiper_js:</span> <span class="string">/js/swiper.min.js</span></span><br><span class="line">  <span class="attr">swiperbdage_init_js:</span> <span class="string">/js/swiperbdage_init.min.js</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="小冰分类磁贴"><a href="#小冰分类磁贴" class="headerlink" title="小冰分类磁贴"></a>小冰分类磁贴</h1><blockquote><p>借鉴：小冰（Fomalhaut 整理）。本站改动：分类名称、图标与分栏按本站栏目重排。</p></blockquote><details class="folding-tag" blue><summary> 分类磁贴 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\_config.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code> ｜ <strong>改法</strong>：在文件末尾新增顶层 <code>magnet:</code> 段；<code>display</code> 里的 <code>name</code> 必须和你的真实分类名完全一致，否则那格是空的。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">magnet:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">priority:</span> <span class="number">1</span></span><br><span class="line">  <span class="attr">enable_page:</span> <span class="string">/</span></span><br><span class="line">  <span class="attr">type:</span> <span class="string">categories</span></span><br><span class="line">  <span class="attr">devide:</span> <span class="number">2</span></span><br><span class="line">  <span class="attr">display:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">name:</span> <span class="string">校园生活</span></span><br><span class="line">      <span class="attr">display_name:</span> <span class="string">校园生活</span></span><br><span class="line">      <span class="attr">icon:</span> <span class="string">📚</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">name:</span> <span class="string">编程语言</span></span><br><span class="line">      <span class="attr">display_name:</span> <span class="string">乱写代码</span></span><br><span class="line">      <span class="attr">icon:</span> <span class="string">🎮</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">name:</span> <span class="string">music</span></span><br><span class="line">      <span class="attr">display_name:</span> <span class="string">音乐</span></span><br><span class="line">      <span class="attr">icon:</span> <span class="string">🎧</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">name:</span> <span class="string">AI</span></span><br><span class="line">      <span class="attr">display_name:</span> <span class="string">AI</span> <span class="string">探索</span></span><br><span class="line">      <span class="attr">icon:</span> <span class="string">👩‍💻</span></span><br><span class="line">  <span class="attr">color_setting:</span></span><br><span class="line">    <span class="attr">text_color:</span> <span class="string">black</span></span><br><span class="line">    <span class="attr">text_hover_color:</span> <span class="string">white</span></span><br><span class="line">    <span class="attr">background_color:</span> <span class="string">&quot;#f2f2f2&quot;</span></span><br><span class="line">    <span class="attr">background_hover_color:</span> <span class="string">&quot;#b30070&quot;</span></span><br><span class="line">  <span class="attr">layout:</span></span><br><span class="line">    <span class="attr">type:</span> <span class="string">id</span></span><br><span class="line">    <span class="attr">name:</span> <span class="string">recent-posts</span></span><br><span class="line">    <span class="attr">index:</span> <span class="number">0</span></span><br><span class="line">  <span class="attr">temple_html:</span> <span class="string">&#x27;&lt;div class=&quot;recent-post-item&quot; style=&quot;width:100%;height: auto&quot;&gt;&lt;div id=&quot;catalog_magnet&quot;&gt;$&#123;temple_html_item&#125;&lt;/div&gt;&lt;/div&gt;&#x27;</span></span><br><span class="line">  <span class="attr">plus_style:</span> <span class="string">&quot;&quot;</span></span><br></pre></td></tr></table></figure><p>装插件：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：安装分类磁贴插件。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-magnet --save</span><br></pre></td></tr></table></figure><p>装完重启 <code>hexo s</code>，磁贴才会被注入。依赖 <code>[Blogroot]\package.json</code> 里的 <code>hexo-magnet</code>。</p>              </div>            </details><h1 id="历史上的今天"><a href="#历史上的今天" class="headerlink" title="历史上的今天"></a>历史上的今天</h1><blockquote><p>借鉴：小冰（Zfour）。本站改动：只保留接入配置，卡片样式与本站侧栏宽度对齐。</p></blockquote><details class="folding-tag" blue><summary> 历史上的今天 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\_config.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code> ｜ <strong>改法</strong>：在文件末尾新增顶层 <code>history_calendar:</code>、<code>electric_clock:</code> 两段；<code>layout.name</code> 指向侧栏容器 <code>sticky_layout</code>，不要改成 <code>recent-posts</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">history_calendar:</span></span><br><span class="line">  <span class="attr">priority:</span> <span class="number">4</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">enable_page:</span> <span class="string">all</span></span><br><span class="line">  <span class="attr">layout:</span></span><br><span class="line">    <span class="attr">type:</span> <span class="string">class</span></span><br><span class="line">    <span class="attr">name:</span> <span class="string">sticky_layout</span></span><br><span class="line">    <span class="attr">index:</span> <span class="number">0</span></span><br><span class="line">  <span class="attr">temple_html:</span> <span class="string">&#x27;&lt;div class=&quot;card-widget card-history&quot;&gt;&lt;div class=&quot;card-content&quot;&gt;&lt;div class=&quot;item-headline&quot;&gt;&lt;i class=&quot;fas fa-clock fa-spin&quot;&gt;&lt;/i&gt;&lt;span&gt;那年今日&lt;/span&gt;&lt;/div&gt;&lt;div id=&quot;history-baidu&quot; style=&quot;height: 100px;overflow: hidden&quot;&gt;&lt;div class=&quot;history_swiper-container&quot; id=&quot;history-container&quot; style=&quot;width: 100%;height: 100%&quot;&gt;&lt;div class=&quot;swiper-wrapper&quot; id=&quot;history_container_wrapper&quot; style=&quot;height:20px&quot;&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&#x27;</span></span><br><span class="line"></span><br><span class="line"><span class="attr">electric_clock:</span></span><br><span class="line">  <span class="attr">priority:</span> <span class="number">5</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">enable_page:</span> <span class="string">all</span></span><br><span class="line">  <span class="attr">layout:</span></span><br><span class="line">    <span class="attr">type:</span> <span class="string">class</span></span><br><span class="line">    <span class="attr">name:</span> <span class="string">sticky_layout</span></span><br><span class="line">    <span class="attr">index:</span> <span class="number">0</span></span><br></pre></td></tr></table></figure><p>装插件：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：安装历史日历与电子钟插件（电子钟默认 <code>enable: false</code>，想用再开）。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-history-calendar hexo-electric-clock --save</span><br></pre></td></tr></table></figure><p>「历史上的今天」的模板里用到了 swiper 容器，所以要在「页脚计时器与框架徽标」那节把 <code>swiper.min.js</code> / <code>swiper.min.css</code> 也放到 <code>source/js</code>、<code>source/css</code> 下（那一节有完整命令）。<br>依赖 <code>[Blogroot]\package.json</code> 里的 <code>hexo-history-calendar</code>、<code>hexo-electric-clock</code>。</p>              </div>            </details><h1 id="首页置顶轮播与文章双栏"><a href="#首页置顶轮播与文章双栏" class="headerlink" title="首页置顶轮播与文章双栏"></a>首页置顶轮播与文章双栏</h1><blockquote><p>借鉴：店长 / 小冰（Fomalhaut 整理）。本站改动：轮播与双栏配置按本站首页结构重排，静态资源改为本地加载。</p></blockquote><details class="folding-tag" blue><summary> 轮播与双栏 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\_config.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code> ｜ <strong>改法</strong>：在文件末尾新增顶层 <code>swiper:</code>、<code>butterfly_article_double_row:</code> 两段；<code>stylus:</code> 是主题自带的压缩开关，已有就只核对值，别重复写。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">swiper:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">priority:</span> <span class="number">2</span></span><br><span class="line">  <span class="attr">enable_page:</span> <span class="string">/</span></span><br><span class="line">  <span class="attr">layout:</span></span><br><span class="line">    <span class="attr">type:</span> <span class="string">id</span></span><br><span class="line">    <span class="attr">name:</span> <span class="string">recent-posts</span></span><br><span class="line">    <span class="attr">index:</span> <span class="number">0</span></span><br><span class="line">  <span class="attr">temple_html:</span> <span class="string">&#x27;&lt;div class=&quot;recent-post-item&quot; style=&quot;height: auto;width: 100%&quot;&gt;&lt;div class=&quot;blog-slider swiper-container-fade swiper-container-horizontal&quot; id=&quot;swiper_container&quot;&gt;$&#123;temple_html_item&#125;&lt;/div&gt;&lt;/div&gt;&#x27;</span></span><br><span class="line">  <span class="attr">plus_style:</span> <span class="string">&quot;&quot;</span></span><br><span class="line"></span><br><span class="line"><span class="attr">butterfly_article_double_row:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="attr">stylus:</span></span><br><span class="line">  <span class="attr">compress:</span> <span class="literal">true</span></span><br></pre></td></tr></table></figure><p>这一步要两个插件：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：安装置顶轮播与首页双栏插件；swiper 本体复用上一节拷进 <code>source/js</code>、<code>source/css</code> 的本地文件。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-swiper-bar hexo-butterfly-article-double-row --save</span><br><span class="line"><span class="comment"># 轮播依赖 swiper 本体，同样复用「页脚计时器与框架徽标」那节拷过来的</span></span><br><span class="line"><span class="comment"># source/js/swiper.min.js 与 source/css/swiper.min.css</span></span><br></pre></td></tr></table></figure><p>在文章 front matter 里写 <code>top: 1</code>。<br>在 <code>[Blogroot]\source\css\custom.css</code> 末尾添加 5.x 双排适配：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾（末尾那段 <code>.low-perf</code> 降级规则一并加上）。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">min-width</span>: <span class="number">769px</span>) &#123;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &#123;</span><br><span class="line">    <span class="attribute">display</span>: flex;</span><br><span class="line">    <span class="attribute">flex-wrap</span>: wrap;</span><br><span class="line">    <span class="attribute">justify-content</span>: space-between;</span><br><span class="line">    <span class="attribute">align-content</span>: flex-start;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &#123;</span><br><span class="line">    <span class="attribute">display</span>: flex;</span><br><span class="line">    <span class="attribute">flex-direction</span>: column;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">49%</span>;</span><br><span class="line">    <span class="attribute">height</span>: auto <span class="meta">!important</span>;</span><br><span class="line">    <span class="attribute">margin-top</span>: <span class="number">1rem</span>;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.post_cover</span> &#123;</span><br><span class="line">    <span class="attribute">order</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">100%</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attribute">height</span>: <span class="number">200px</span>;</span><br><span class="line">    <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">200px</span>;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.recent-post-info</span> &#123;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">100%</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attribute">padding</span>: <span class="number">0</span> <span class="number">40px</span>;</span><br><span class="line">    <span class="attribute">margin-top</span>: <span class="number">1em</span>;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.recent-post-info</span> &gt; <span class="selector-class">.content</span> &#123;</span><br><span class="line">    <span class="attribute">display</span>: none;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.recent-post-info</span> &gt; <span class="selector-class">.article-title</span> &#123;</span><br><span class="line">    -webkit-line-clamp: <span class="number">1</span>;</span><br><span class="line">    <span class="attribute">margin-top</span>: .<span class="number">3rem</span>;</span><br><span class="line">    <span class="attribute">margin-bottom</span>: .<span class="number">3rem</span>;</span><br><span class="line">    <span class="attribute">font-size</span>: <span class="number">1.2em</span>;</span><br><span class="line">    <span class="attribute">line-height</span>: <span class="number">1.4</span>;</span><br><span class="line">    <span class="attribute">color</span>: <span class="built_in">var</span>(--text-highlight-color);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &gt; <span class="selector-class">.recent-post-info</span> &gt; <span class="selector-class">.article-meta-wrap</span> &#123;</span><br><span class="line">    <span class="attribute">margin-bottom</span>: <span class="number">1rem</span>;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.pagination</span>,</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-id">#pagination</span>,</span><br><span class="line">  <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-tag">nav</span> &#123;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">    <span class="attribute">flex</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">100%</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.low-perf</span> <span class="selector-id">#recent-posts</span> &gt; <span class="selector-class">.recent-post-items</span> &gt; <span class="selector-class">.recent-post-item</span> &#123;</span><br><span class="line">  <span class="attribute">content-visibility</span>: auto;</span><br><span class="line">  <span class="attribute">contain</span>-intrinsic-size: auto <span class="number">320px</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="页脚备案三连（ICP-公安-萌ICP）"><a href="#页脚备案三连（ICP-公安-萌ICP）" class="headerlink" title="页脚备案三连（ICP / 公安 / 萌ICP）"></a>页脚备案三连（ICP / 公安 / 萌ICP）</h1><details class="folding-tag" blue><summary> 备案三连 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\_config.butterfly.yml</code> 新增顶层 <code>beian</code> 段：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：新增顶层 <code>beian:</code> 段（放文件末尾即可）；三个编号换成你自己的，还没下号就保持 <code>pending: true</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">beian:</span></span><br><span class="line">  <span class="attr">icp:</span></span><br><span class="line">    <span class="attr">number:</span> <span class="string">ICP备&lt;你的备案号&gt;号-1</span></span><br><span class="line">    <span class="attr">label:</span> <span class="string">ICP备</span></span><br><span class="line">    <span class="attr">link:</span> <span class="string">https://beian.miit.gov.cn/</span></span><br><span class="line">    <span class="attr">pending:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">police:</span></span><br><span class="line">    <span class="attr">number:</span> <span class="string">公网安备&lt;你的备案号&gt;号</span></span><br><span class="line">    <span class="attr">label:</span> <span class="string">公网安备</span></span><br><span class="line">    <span class="attr">code:</span> <span class="string">&#x27;&#x27;</span></span><br><span class="line">    <span class="attr">icon:</span> <span class="string">/img/beian.png</span></span><br><span class="line">    <span class="attr">link:</span> <span class="string">&#x27;https://beian.mps.gov.cn/#/query/webSearch&#x27;</span></span><br><span class="line">    <span class="attr">pending:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">moe:</span></span><br><span class="line">    <span class="attr">number:</span> <span class="string">萌ICP备&lt;你的编号&gt;号</span></span><br><span class="line">    <span class="attr">label:</span> <span class="string">萌ICP备</span></span><br><span class="line">    <span class="attr">link:</span> <span class="string">https://icp.gov.moe/</span></span><br><span class="line">    <span class="attr">pending:</span> <span class="literal">false</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\themes\butterfly\layout\includes\footer.pug</code> 末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/footer.pug</code> ｜ <strong>改法</strong>：追加到文件末尾，缩进为 0（和已有的 <code>if theme.footer.custom_text</code> 同级）。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br></pre></td><td class="code"><pre><span class="line">//- 备案信息三连</span><br><span class="line">if theme.beian</span><br><span class="line">  .beian-row</span><br><span class="line">    - const icp = theme.beian.icp</span><br><span class="line">    if icp</span><br><span class="line">      if icp.pending</span><br><span class="line">        span.beian-item.beian-item--pending(title=&#x27;工信部 ICP 备案办理中，下号后显示备案号&#x27;)</span><br><span class="line">          span.beian-item__key= icp.label || &#x27;ICP备&#x27;</span><br><span class="line">          span.beian-item__val 办理中</span><br><span class="line">      else</span><br><span class="line">        a.beian-item.beian-item--icp(href=icp.link target=&#x27;_blank&#x27; rel=&#x27;noopener noreferrer&#x27; title=icp.number)</span><br><span class="line">          span.beian-item__key= icp.label || &#x27;ICP备&#x27;</span><br><span class="line">          span.beian-item__val= icp.number.replace(icp.label || &#x27;&#x27;, &#x27;&#x27;)</span><br><span class="line">    - const police = theme.beian.police</span><br><span class="line">    if police</span><br><span class="line">      if police.pending</span><br><span class="line">        span.beian-item.beian-item--pending(title=&#x27;公安联网备案办理中，下号后显示备案号&#x27;)</span><br><span class="line">          span.beian-item__key= police.label || &#x27;公网安备&#x27;</span><br><span class="line">          span.beian-item__val 办理中</span><br><span class="line">      else</span><br><span class="line">        a.beian-item.beian-item--icp(href=`$&#123;police.link&#125;?code=$&#123;police.code&#125;` target=&#x27;_blank&#x27; rel=&#x27;noopener noreferrer&#x27; title=police.number)</span><br><span class="line">          if police.icon</span><br><span class="line">            img.beian-police-icon(src=url_for(police.icon) alt=&#x27;公安备案&#x27;)</span><br><span class="line">          span.beian-item__key= police.label || &#x27;公网安备&#x27;</span><br><span class="line">          span.beian-item__val= police.number.replace(police.label || &#x27;&#x27;, &#x27;&#x27;)</span><br><span class="line">    - const moe = theme.beian.moe</span><br><span class="line">    if moe</span><br><span class="line">      a.beian-item.beian-item--moe(href=moe.link target=&#x27;_blank&#x27; rel=&#x27;noopener noreferrer&#x27; title=&#x27;萌国 ICP 备案（非官方趣味标识，非工信部备案）&#x27;)</span><br><span class="line">        span.beian-item__key= moe.label || &#x27;萌ICP备&#x27;</span><br><span class="line">        span.beian-item__val= moe.number.replace(moe.label || &#x27;&#x27;, &#x27;&#x27;)</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\source\css\custom.css</code> 末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#footer-wrap</span> <span class="selector-class">.beian-row</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: flex;</span><br><span class="line">  <span class="attribute">flex-wrap</span>: wrap;</span><br><span class="line">  <span class="attribute">justify-content</span>: center;</span><br><span class="line">  <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">gap</span>: <span class="number">5px</span>;</span><br><span class="line">  <span class="attribute">margin-top</span>: <span class="number">8px</span>;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-class">.beian-item</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: inline-flex;</span><br><span class="line">  <span class="attribute">align-items</span>: stretch;</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">20px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">3px</span>;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">11px</span>;</span><br><span class="line">  <span class="attribute">line-height</span>: <span class="number">20px</span>;</span><br><span class="line">  <span class="attribute">white-space</span>: nowrap;</span><br><span class="line">  <span class="attribute">text-decoration</span>: none <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">transition</span>: transform .<span class="number">25s</span> ease, box-shadow .<span class="number">25s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-class">.beian-item__key</span>,</span><br><span class="line"><span class="selector-class">.beian-item__val</span> &#123; <span class="attribute">display</span>: inline-flex; <span class="attribute">align-items</span>: center; <span class="attribute">color</span>: <span class="number">#fff</span>; &#125;</span><br><span class="line"><span class="selector-class">.beian-item__key</span> &#123; <span class="attribute">padding</span>: <span class="number">0</span> <span class="number">5px</span>; <span class="attribute">background</span>: <span class="number">#5a6b7b</span>; &#125;</span><br><span class="line"><span class="selector-class">.beian-item__val</span> &#123; <span class="attribute">padding</span>: <span class="number">0</span> <span class="number">6px</span>; <span class="attribute">background</span>: <span class="number">#5ea6e5</span>; &#125;</span><br><span class="line"><span class="selector-class">.beian-item--pending</span> &#123; <span class="attribute">cursor</span>: default; &#125;</span><br><span class="line"><span class="selector-class">.beian-item--pending</span> <span class="selector-class">.beian-item__key</span> &#123; <span class="attribute">background</span>: <span class="number">#6b7684</span>; &#125;</span><br><span class="line"><span class="selector-class">.beian-item--pending</span> <span class="selector-class">.beian-item__val</span> &#123; <span class="attribute">background</span>: <span class="number">#9aa7b4</span>; &#125;</span><br><span class="line"><span class="selector-class">.beian-item--moe</span> <span class="selector-class">.beian-item__key</span> &#123; <span class="attribute">background</span>: <span class="number">#7a3a63</span>; &#125;</span><br><span class="line"><span class="selector-class">.beian-item--moe</span> <span class="selector-class">.beian-item__val</span> &#123; <span class="attribute">background</span>: <span class="number">#f838b2</span>; &#125;</span><br><span class="line"><span class="selector-tag">a</span><span class="selector-class">.beian-item</span><span class="selector-pseudo">:hover</span> &#123; <span class="attribute">transform</span>: <span class="built_in">translateY</span>(-<span class="number">2px</span>); <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">3px</span> <span class="number">10px</span> <span class="built_in">rgba</span>(<span class="number">0</span>,<span class="number">0</span>,<span class="number">0</span>,.<span class="number">18</span>); &#125;</span><br><span class="line"><span class="selector-class">.beian-police-icon</span> &#123; <span class="attribute">width</span>: <span class="number">12px</span>; <span class="attribute">height</span>: <span class="number">12px</span>; <span class="attribute">object-fit</span>: contain; <span class="attribute">margin-right</span>: <span class="number">4px</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.beian-item--pending</span> <span class="selector-class">.beian-item__val</span> &#123; <span class="attribute">background</span>: <span class="number">#6f7b88</span>; &#125;</span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">max-width</span>: <span class="number">768px</span>) &#123;</span><br><span class="line">  <span class="selector-id">#footer-wrap</span> <span class="selector-class">.beian-row</span> &#123; <span class="attribute">gap</span>: <span class="number">4px</span>; &#125;</span><br><span class="line">  <span class="selector-class">.beian-item</span> &#123; <span class="attribute">font-size</span>: <span class="number">10px</span>; <span class="attribute">height</span>: <span class="number">18px</span>; <span class="attribute">line-height</span>: <span class="number">18px</span>; &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>pending: true</code> 显示「办理中」不生成链接；下号后填 <code>number</code> / <code>code</code> 并把 <code>pending</code> 改成 <code>false</code>。</p>              </div>            </details><h1 id="昼夜更替（山河日月版）"><a href="#昼夜更替（山河日月版）" class="headerlink" title="昼夜更替（山河日月版）"></a>昼夜更替（山河日月版）</h1><blockquote><p>借鉴：店长（Fomalhaut 整理）。本站改动：过场脚本重写为自包含实现，动画时长与降级策略按本站性能模式调整。</p></blockquote><details class="folding-tag" blue><summary> 黄昏落幕过场 </summary>              <div class='content'>              <p>效果：点右上角的月亮/太阳，整屏不是直接换色，而是走一段「黄昏落幕」——太阳从左上方往右下沉、月亮从左下方往右上爬，星星一颗颗亮起来，远山剪影与地平线余光跟着压暗；切回白天时完全反向（月亮落、太阳升、星星退场）。最后 350ms 从<strong>点击处</strong>做一个圆形揭幕，把新主题「揭」出来。</p><p>核心是一个自包含脚本：DOM、渐变、关键帧全部由 JS 现场创建，不依赖任何外部 CSS，所以换主题皮肤也不会互相打架。</p><p>新建 <code>[Blogroot]\source\js\fomal\night.js</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/night.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；本站 <code>source/js/fomal/night.js</code> 已经是这份实现，改动时对照补齐即可，不要另建第二份。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br><span class="line">84</span><br><span class="line">85</span><br><span class="line">86</span><br><span class="line">87</span><br><span class="line">88</span><br><span class="line">89</span><br><span class="line">90</span><br><span class="line">91</span><br><span class="line">92</span><br><span class="line">93</span><br><span class="line">94</span><br><span class="line">95</span><br><span class="line">96</span><br><span class="line">97</span><br><span class="line">98</span><br><span class="line">99</span><br><span class="line">100</span><br><span class="line">101</span><br><span class="line">102</span><br><span class="line">103</span><br><span class="line">104</span><br><span class="line">105</span><br><span class="line">106</span><br><span class="line">107</span><br><span class="line">108</span><br><span class="line">109</span><br><span class="line">110</span><br><span class="line">111</span><br><span class="line">112</span><br><span class="line">113</span><br><span class="line">114</span><br><span class="line">115</span><br><span class="line">116</span><br><span class="line">117</span><br><span class="line">118</span><br><span class="line">119</span><br><span class="line">120</span><br><span class="line">121</span><br><span class="line">122</span><br><span class="line">123</span><br><span class="line">124</span><br><span class="line">125</span><br><span class="line">126</span><br><span class="line">127</span><br><span class="line">128</span><br><span class="line">129</span><br><span class="line">130</span><br><span class="line">131</span><br><span class="line">132</span><br><span class="line">133</span><br><span class="line">134</span><br><span class="line">135</span><br><span class="line">136</span><br><span class="line">137</span><br><span class="line">138</span><br><span class="line">139</span><br><span class="line">140</span><br><span class="line">141</span><br><span class="line">142</span><br><span class="line">143</span><br><span class="line">144</span><br><span class="line">145</span><br><span class="line">146</span><br><span class="line">147</span><br><span class="line">148</span><br><span class="line">149</span><br><span class="line">150</span><br><span class="line">151</span><br><span class="line">152</span><br><span class="line">153</span><br><span class="line">154</span><br><span class="line">155</span><br><span class="line">156</span><br><span class="line">157</span><br><span class="line">158</span><br><span class="line">159</span><br><span class="line">160</span><br><span class="line">161</span><br><span class="line">162</span><br><span class="line">163</span><br><span class="line">164</span><br><span class="line">165</span><br><span class="line">166</span><br><span class="line">167</span><br><span class="line">168</span><br><span class="line">169</span><br><span class="line">170</span><br><span class="line">171</span><br><span class="line">172</span><br><span class="line">173</span><br><span class="line">174</span><br><span class="line">175</span><br><span class="line">176</span><br><span class="line">177</span><br><span class="line">178</span><br><span class="line">179</span><br><span class="line">180</span><br><span class="line">181</span><br><span class="line">182</span><br><span class="line">183</span><br><span class="line">184</span><br><span class="line">185</span><br><span class="line">186</span><br><span class="line">187</span><br><span class="line">188</span><br><span class="line">189</span><br><span class="line">190</span><br><span class="line">191</span><br><span class="line">192</span><br><span class="line">193</span><br><span class="line">194</span><br><span class="line">195</span><br><span class="line">196</span><br><span class="line">197</span><br><span class="line">198</span><br><span class="line">199</span><br><span class="line">200</span><br><span class="line">201</span><br><span class="line">202</span><br><span class="line">203</span><br><span class="line">204</span><br><span class="line">205</span><br><span class="line">206</span><br><span class="line">207</span><br><span class="line">208</span><br><span class="line">209</span><br><span class="line">210</span><br><span class="line">211</span><br><span class="line">212</span><br><span class="line">213</span><br><span class="line">214</span><br><span class="line">215</span><br><span class="line">216</span><br><span class="line">217</span><br><span class="line">218</span><br><span class="line">219</span><br><span class="line">220</span><br><span class="line">221</span><br><span class="line">222</span><br><span class="line">223</span><br><span class="line">224</span><br><span class="line">225</span><br><span class="line">226</span><br><span class="line">227</span><br><span class="line">228</span><br><span class="line">229</span><br><span class="line">230</span><br><span class="line">231</span><br><span class="line">232</span><br><span class="line">233</span><br><span class="line">234</span><br><span class="line">235</span><br><span class="line">236</span><br><span class="line">237</span><br><span class="line">238</span><br><span class="line">239</span><br><span class="line">240</span><br><span class="line">241</span><br><span class="line">242</span><br><span class="line">243</span><br><span class="line">244</span><br><span class="line">245</span><br><span class="line">246</span><br><span class="line">247</span><br><span class="line">248</span><br><span class="line">249</span><br><span class="line">250</span><br><span class="line">251</span><br><span class="line">252</span><br><span class="line">253</span><br><span class="line">254</span><br><span class="line">255</span><br><span class="line">256</span><br><span class="line">257</span><br><span class="line">258</span><br><span class="line">259</span><br><span class="line">260</span><br><span class="line">261</span><br><span class="line">262</span><br><span class="line">263</span><br><span class="line">264</span><br><span class="line">265</span><br><span class="line">266</span><br><span class="line">267</span><br><span class="line">268</span><br><span class="line">269</span><br><span class="line">270</span><br><span class="line">271</span><br><span class="line">272</span><br><span class="line">273</span><br><span class="line">274</span><br><span class="line">275</span><br><span class="line">276</span><br><span class="line">277</span><br><span class="line">278</span><br><span class="line">279</span><br><span class="line">280</span><br><span class="line">281</span><br><span class="line">282</span><br><span class="line">283</span><br><span class="line">284</span><br><span class="line">285</span><br><span class="line">286</span><br><span class="line">287</span><br><span class="line">288</span><br><span class="line">289</span><br><span class="line">290</span><br><span class="line">291</span><br><span class="line">292</span><br><span class="line">293</span><br><span class="line">294</span><br><span class="line">295</span><br><span class="line">296</span><br><span class="line">297</span><br><span class="line">298</span><br><span class="line">299</span><br><span class="line">300</span><br><span class="line">301</span><br><span class="line">302</span><br><span class="line">303</span><br><span class="line">304</span><br><span class="line">305</span><br><span class="line">306</span><br><span class="line">307</span><br><span class="line">308</span><br><span class="line">309</span><br><span class="line">310</span><br><span class="line">311</span><br><span class="line">312</span><br><span class="line">313</span><br><span class="line">314</span><br><span class="line">315</span><br><span class="line">316</span><br><span class="line">317</span><br><span class="line">318</span><br><span class="line">319</span><br><span class="line">320</span><br><span class="line">321</span><br><span class="line">322</span><br><span class="line">323</span><br><span class="line">324</span><br><span class="line">325</span><br><span class="line">326</span><br><span class="line">327</span><br><span class="line">328</span><br><span class="line">329</span><br><span class="line">330</span><br><span class="line">331</span><br><span class="line">332</span><br><span class="line">333</span><br><span class="line">334</span><br><span class="line">335</span><br><span class="line">336</span><br><span class="line">337</span><br><span class="line">338</span><br><span class="line">339</span><br><span class="line">340</span><br><span class="line">341</span><br><span class="line">342</span><br><span class="line">343</span><br><span class="line">344</span><br><span class="line">345</span><br><span class="line">346</span><br><span class="line">347</span><br><span class="line">348</span><br><span class="line">349</span><br><span class="line">350</span><br><span class="line">351</span><br><span class="line">352</span><br><span class="line">353</span><br><span class="line">354</span><br><span class="line">355</span><br><span class="line">356</span><br><span class="line">357</span><br><span class="line">358</span><br><span class="line">359</span><br><span class="line">360</span><br><span class="line">361</span><br><span class="line">362</span><br><span class="line">363</span><br><span class="line">364</span><br><span class="line">365</span><br><span class="line">366</span><br><span class="line">367</span><br><span class="line">368</span><br><span class="line">369</span><br><span class="line">370</span><br><span class="line">371</span><br><span class="line">372</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/*!</span></span><br><span class="line"><span class="comment"> * 昼夜切换 2.0「黄昏落幕」——自包含实现（不依赖任何外部 CSS）</span></span><br><span class="line"><span class="comment"> * 日月沿同一条圆弧升/降，落点为画面正上方同一位置；共 1500ms，末段从点击处圆形揭幕。</span></span><br><span class="line"><span class="comment"> * 档位 localStorage.darkTransition：off / light / standard / flourish（默认 standard）</span></span><br><span class="line"><span class="comment"> * 减弱动态效果（prefers-reduced-motion: reduce）保留过场但压到约 45% 时长。</span></span><br><span class="line"><span class="comment"> */</span></span><br><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="string">&#x27;use strict&#x27;</span></span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">TOTAL</span> = <span class="number">1500</span></span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">REVEAL_AT</span> = <span class="number">1150</span></span><br><span class="line">  <span class="keyword">var</span> <span class="variable constant_">REVEAL</span> = <span class="number">350</span></span><br><span class="line">  <span class="keyword">var</span> running = <span class="literal">false</span></span><br><span class="line">  <span class="keyword">var</span> overlay = <span class="literal">null</span></span><br><span class="line">  <span class="keyword">var</span> revealTimer = <span class="number">0</span></span><br><span class="line">  <span class="keyword">var</span> finishTimer = <span class="number">0</span></span><br><span class="line">  <span class="keyword">var</span> cleanupTimer = <span class="number">0</span></span><br><span class="line">  <span class="keyword">var</span> overlayGuard = <span class="number">0</span></span><br><span class="line">  <span class="keyword">var</span> revealRAF = <span class="number">0</span></span><br><span class="line">  <span class="keyword">var</span> runGen = <span class="number">0</span></span><br><span class="line">  <span class="keyword">var</span> pending = <span class="literal">false</span></span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">root</span> () &#123; <span class="keyword">return</span> <span class="variable language_">document</span>.<span class="property">documentElement</span> &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">isDark</span> () &#123; <span class="keyword">return</span> <span class="title function_">root</span>().<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-theme&#x27;</span>) === <span class="string">&#x27;dark&#x27;</span> &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">reduced</span> () &#123;</span><br><span class="line">    <span class="keyword">try</span> &#123; <span class="keyword">return</span> <span class="variable language_">window</span>.<span class="property">matchMedia</span> &amp;&amp; <span class="variable language_">window</span>.<span class="title function_">matchMedia</span>(<span class="string">&#x27;(prefers-reduced-motion: reduce)&#x27;</span>).<span class="property">matches</span> &#125; <span class="keyword">catch</span> (e) &#123; <span class="keyword">return</span> <span class="literal">false</span> &#125;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">tier</span> () &#123;</span><br><span class="line">    <span class="keyword">var</span> t = <span class="string">&#x27;standard&#x27;</span></span><br><span class="line">    <span class="keyword">try</span> &#123; t = <span class="variable language_">window</span>.<span class="property">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&#x27;darkTransition&#x27;</span>) || <span class="string">&#x27;standard&#x27;</span> &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">    <span class="keyword">return</span> [<span class="string">&#x27;off&#x27;</span>, <span class="string">&#x27;light&#x27;</span>, <span class="string">&#x27;standard&#x27;</span>, <span class="string">&#x27;flourish&#x27;</span>].<span class="title function_">indexOf</span>(t) &gt;= <span class="number">0</span> ? t : <span class="string">&#x27;standard&#x27;</span></span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">applyTheme</span> (toDark) &#123;</span><br><span class="line">    <span class="keyword">var</span> btf = <span class="variable language_">window</span>.<span class="property">btf</span> || &#123;&#125;</span><br><span class="line">    <span class="keyword">var</span> mode = toDark ? <span class="string">&#x27;dark&#x27;</span> : <span class="string">&#x27;light&#x27;</span></span><br><span class="line">    <span class="keyword">var</span> activate = toDark ? (btf.<span class="property">activateDarkMode</span> || <span class="variable language_">window</span>.<span class="property">activateDarkMode</span>)</span><br><span class="line">      : (btf.<span class="property">activateLightMode</span> || <span class="variable language_">window</span>.<span class="property">activateLightMode</span>)</span><br><span class="line">    <span class="keyword">if</span> (<span class="keyword">typeof</span> activate === <span class="string">&#x27;function&#x27;</span>) &#123;</span><br><span class="line">      <span class="keyword">try</span> &#123; <span class="title function_">activate</span>() &#125; <span class="keyword">catch</span> (e) &#123; <span class="title function_">root</span>().<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-theme&#x27;</span>, mode) &#125;</span><br><span class="line">    &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">      <span class="title function_">root</span>().<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-theme&#x27;</span>, mode)</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">var</span> save = btf.<span class="property">saveToLocal</span> || <span class="variable language_">window</span>.<span class="property">saveToLocal</span></span><br><span class="line">    <span class="keyword">if</span> (save &amp;&amp; <span class="keyword">typeof</span> save.<span class="property">set</span> === <span class="string">&#x27;function&#x27;</span>) &#123;</span><br><span class="line">      <span class="keyword">try</span> &#123; save.<span class="title function_">set</span>(<span class="string">&#x27;theme&#x27;</span>, mode, <span class="number">2</span>) &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">    &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">      <span class="keyword">try</span> &#123; <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;theme&#x27;</span>, <span class="title class_">JSON</span>.<span class="title function_">stringify</span>(&#123; <span class="attr">value</span>: mode, <span class="attr">expiry</span>: <span class="title class_">Date</span>.<span class="title function_">now</span>() + <span class="number">2</span> * <span class="number">86400000</span> &#125;)) &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">try</span> &#123;</span><br><span class="line">      <span class="variable language_">document</span>.<span class="property">body</span>.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;DarkMode&#x27;</span>, !!toDark)</span><br><span class="line">      <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;isDark&#x27;</span>, toDark ? <span class="string">&#x27;true&#x27;</span> : <span class="string">&#x27;false&#x27;</span>)</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">globalFn</span> &amp;&amp; <span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">globalFn</span>.<span class="property">themeChange</span> === <span class="string">&#x27;function&#x27;</span>) <span class="variable language_">window</span>.<span class="property">globalFn</span>.<span class="title function_">themeChange</span>()</span><br><span class="line">    &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">    <span class="keyword">var</span> icons = <span class="variable language_">document</span>.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;#modeicon, use#modeicon&#x27;</span>)</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; icons.<span class="property">length</span>; i++) &#123;</span><br><span class="line">      <span class="keyword">try</span> &#123; icons[i].<span class="title function_">setAttribute</span>(<span class="string">&#x27;xlink:href&#x27;</span>, toDark ? <span class="string">&#x27;#icon-sun&#x27;</span> : <span class="string">&#x27;#icon-moon&#x27;</span>) &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">      <span class="keyword">try</span> &#123; icons[i].<span class="title function_">setAttribute</span>(<span class="string">&#x27;href&#x27;</span>, toDark ? <span class="string">&#x27;#icon-sun&#x27;</span> : <span class="string">&#x27;#icon-moon&#x27;</span>) &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">el</span> (css, parent) &#123;</span><br><span class="line">    <span class="keyword">var</span> d = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>)</span><br><span class="line">    d.<span class="title function_">setAttribute</span>(<span class="string">&#x27;style&#x27;</span>, css)</span><br><span class="line">    <span class="keyword">if</span> (parent) parent.<span class="title function_">appendChild</span>(d)</span><br><span class="line">    <span class="keyword">return</span> d</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">anim</span> (node, frames, opts) &#123;</span><br><span class="line">    <span class="keyword">try</span> &#123;</span><br><span class="line">      <span class="keyword">if</span> (node &amp;&amp; node.<span class="property">animate</span>) <span class="keyword">return</span> node.<span class="title function_">animate</span>(frames, opts)</span><br><span class="line">    &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="literal">null</span></span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">cleanup</span> () &#123;</span><br><span class="line">    <span class="keyword">var</span> hadPending = pending</span><br><span class="line">    pending = <span class="literal">false</span></span><br><span class="line">    <span class="variable language_">window</span>.<span class="built_in">clearTimeout</span>(revealTimer)</span><br><span class="line">    <span class="variable language_">window</span>.<span class="built_in">clearTimeout</span>(finishTimer)</span><br><span class="line">    <span class="variable language_">window</span>.<span class="built_in">clearTimeout</span>(cleanupTimer)</span><br><span class="line">    <span class="variable language_">window</span>.<span class="built_in">clearTimeout</span>(overlayGuard)</span><br><span class="line">    <span class="keyword">if</span> (revealRAF) &#123; <span class="keyword">try</span> &#123; <span class="title function_">cancelAnimationFrame</span>(revealRAF) &#125; <span class="keyword">catch</span> (e) &#123;&#125; revealRAF = <span class="number">0</span> &#125;</span><br><span class="line">    <span class="keyword">if</span> (overlay &amp;&amp; overlay.<span class="property">parentNode</span>) overlay.<span class="property">parentNode</span>.<span class="title function_">removeChild</span>(overlay)</span><br><span class="line">    overlay = <span class="literal">null</span></span><br><span class="line">    running = <span class="literal">false</span></span><br><span class="line">    <span class="keyword">if</span> (hadPending) &#123;</span><br><span class="line">      <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; pending = <span class="literal">false</span>; <span class="title function_">run</span>() &#125;, <span class="number">40</span>)</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="comment">// 结束揭幕：无论 rAF 是否被节流（切标签页/后台），都由这里兜底收尾</span></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">finishReveal</span> (gen) &#123;</span><br><span class="line">    <span class="keyword">if</span> (gen !== <span class="literal">undefined</span> &amp;&amp; gen !== runGen) <span class="keyword">return</span></span><br><span class="line">    <span class="keyword">if</span> (!overlay) <span class="keyword">return</span></span><br><span class="line">    <span class="keyword">var</span> mask = <span class="string">&#x27;radial-gradient(circle 160vmax at 50% 50%, transparent 99%, #000 100%)&#x27;</span></span><br><span class="line">    overlay.<span class="property">style</span>.<span class="property">webkitMaskImage</span> = mask</span><br><span class="line">    overlay.<span class="property">style</span>.<span class="property">maskImage</span> = mask</span><br><span class="line">    overlay.<span class="property">style</span>.<span class="property">visibility</span> = <span class="string">&#x27;hidden&#x27;</span></span><br><span class="line">    running = <span class="literal">false</span></span><br><span class="line">    <span class="variable language_">window</span>.<span class="built_in">clearTimeout</span>(revealTimer)</span><br><span class="line">    <span class="variable language_">window</span>.<span class="built_in">clearTimeout</span>(finishTimer)</span><br><span class="line">    <span class="keyword">var</span> g = runGen</span><br><span class="line">    cleanupTimer = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">if</span> (g === runGen) <span class="title function_">cleanup</span>() &#125;, <span class="number">80</span>)</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">run</span> () &#123;</span><br><span class="line">    <span class="keyword">if</span> (running) &#123;</span><br><span class="line">      <span class="comment">// 动画进行中再点：记一个待办，等这一轮收尾后立刻补一次，避免“点了没反应”</span></span><br><span class="line">      <span class="keyword">if</span> (overlay) &#123; pending = <span class="literal">true</span>; <span class="keyword">return</span> &#125;</span><br><span class="line">      running = <span class="literal">false</span></span><br><span class="line">    &#125;</span><br><span class="line">    running = <span class="literal">true</span></span><br><span class="line">    <span class="comment">// 任何异常（浏览器兼容/第三方脚本干扰）都不能把 running 卡死，否则之后所有点击都“没反应”</span></span><br><span class="line">    <span class="keyword">try</span> &#123; <span class="title function_">startRun</span>() &#125; <span class="keyword">catch</span> (e) &#123; <span class="title function_">cleanup</span>() &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">startRun</span> () &#123;</span><br><span class="line">    <span class="keyword">var</span> my = ++runGen</span><br><span class="line">    <span class="keyword">var</span> toDark = !<span class="title function_">isDark</span>()</span><br><span class="line">    <span class="keyword">var</span> t = <span class="title function_">tier</span>()</span><br><span class="line"></span><br><span class="line">    <span class="title function_">cleanup</span>()</span><br><span class="line">    running = <span class="literal">true</span></span><br><span class="line"></span><br><span class="line">    <span class="keyword">if</span> (t === <span class="string">&#x27;off&#x27;</span>) &#123; <span class="title function_">applyTheme</span>(toDark); running = <span class="literal">false</span>; <span class="keyword">return</span> &#125;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">var</span> pt = <span class="variable language_">window</span>.<span class="property">__dmPoint</span> || &#123; <span class="attr">x</span>: <span class="title class_">Math</span>.<span class="title function_">round</span>(<span class="variable language_">window</span>.<span class="property">innerWidth</span> / <span class="number">2</span>), <span class="attr">y</span>: <span class="title class_">Math</span>.<span class="title function_">round</span>(<span class="variable language_">window</span>.<span class="property">innerHeight</span> * <span class="number">0.42</span>) &#125;</span><br><span class="line">    <span class="keyword">var</span> k = (<span class="title function_">reduced</span>() ? <span class="number">0.45</span> : <span class="number">1</span>) * (t === <span class="string">&#x27;light&#x27;</span> ? <span class="number">0.75</span> : <span class="number">1</span>)</span><br><span class="line">    <span class="keyword">var</span> total = <span class="variable constant_">TOTAL</span> * k</span><br><span class="line">    <span class="keyword">var</span> revealAt = <span class="variable constant_">REVEAL_AT</span> * k</span><br><span class="line">    <span class="keyword">var</span> reveal = <span class="variable constant_">REVEAL</span> * k</span><br><span class="line">    <span class="keyword">var</span> starCount = (t === <span class="string">&#x27;flourish&#x27;</span> ? <span class="number">44</span> : t === <span class="string">&#x27;standard&#x27;</span> ? <span class="number">30</span> : <span class="number">14</span>)</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">innerWidth</span> &lt;= <span class="number">600</span>) starCount = <span class="title class_">Math</span>.<span class="title function_">round</span>(starCount / <span class="number">2</span>)</span><br><span class="line">    <span class="keyword">var</span> flourish = t === <span class="string">&#x27;flourish&#x27;</span></span><br><span class="line"></span><br><span class="line">    <span class="comment">// 全屏幕布（不透明底，避免网页内容透出）</span></span><br><span class="line">    overlay = <span class="title function_">el</span>(<span class="string">&#x27;position:fixed;inset:0;z-index:88888890;overflow:hidden;pointer-events:none;background:#241f45;&#x27;</span>, <span class="literal">null</span>)</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(overlay)</span><br><span class="line"></span><br><span class="line">    <span class="comment">// ① 黄昏底色</span></span><br><span class="line">    <span class="keyword">var</span> dawn = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;inset:0;background:&#x27;</span></span><br><span class="line">      + <span class="string">&#x27;linear-gradient(to top,#ffb26b 0%,#ef7d67 20%,#c06a83 42%,#7b5480 62%,#4b3a72 82%,#2b2450 100%);&#x27;</span>, overlay)</span><br><span class="line"></span><br><span class="line">    <span class="comment">// ② 夜空层</span></span><br><span class="line">    <span class="keyword">var</span> night = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;inset:0;background:&#x27;</span></span><br><span class="line">      + <span class="string">&#x27;linear-gradient(to top,#070d26 0%,#101a3e 30%,#1d2a52 58%,#2f2c58 80%,#3b3163 100%);&#x27;</span>, overlay)</span><br><span class="line"></span><br><span class="line">    <span class="comment">// ③ 地平线余光</span></span><br><span class="line">    <span class="keyword">var</span> horizon = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;left:0;right:0;bottom:0;height:56%;opacity:0;background:radial-gradient(75% 100% at 50% 100%, rgba(255,196,120,.85) 0%, rgba(244,132,120,.55) 30%, rgba(120,70,140,.25) 58%, rgba(20,20,50,0) 82%);&#x27;</span>, overlay)</span><br><span class="line"></span><br><span class="line">    <span class="comment">// ④ 星星</span></span><br><span class="line">    <span class="keyword">var</span> stars = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;inset:0;&#x27;</span>, overlay)</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; starCount; i++) &#123;</span><br><span class="line">      <span class="keyword">var</span> sx = (<span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="number">100</span>).<span class="title function_">toFixed</span>(<span class="number">2</span>) + <span class="string">&#x27;%&#x27;</span></span><br><span class="line">      <span class="keyword">var</span> sy = (<span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="number">66</span>).<span class="title function_">toFixed</span>(<span class="number">2</span>) + <span class="string">&#x27;%&#x27;</span></span><br><span class="line">      <span class="keyword">var</span> ss = (<span class="number">1</span> + <span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="number">1.8</span>).<span class="title function_">toFixed</span>(<span class="number">2</span>) + <span class="string">&#x27;px&#x27;</span></span><br><span class="line">      <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;left:&#x27;</span> + sx + <span class="string">&#x27;;top:&#x27;</span> + sy + <span class="string">&#x27;;width:&#x27;</span> + ss + <span class="string">&#x27;;height:&#x27;</span> + ss + <span class="string">&#x27;;border-radius:50%;background:#fff;opacity:0;&#x27;</span></span><br><span class="line">        + <span class="string">&#x27;box-shadow:0 0 6px rgba(255,255,255,.8),0 0 14px rgba(160,200,255,.35);&#x27;</span>, stars)</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="comment">// ⑤ 太阳 / 月亮：容器放在左上角，用 translate 走弧形轨迹（统一从左往右）</span></span><br><span class="line">    <span class="keyword">var</span> W = <span class="variable language_">window</span>.<span class="property">innerWidth</span></span><br><span class="line">    <span class="keyword">var</span> H = <span class="variable language_">window</span>.<span class="property">innerHeight</span></span><br><span class="line">    <span class="keyword">var</span> D = <span class="keyword">function</span> (<span class="params">x, y</span>) &#123; <span class="keyword">return</span> <span class="string">&#x27;translate(&#x27;</span> + <span class="title class_">Math</span>.<span class="title function_">round</span>(x * W) + <span class="string">&#x27;px,&#x27;</span> + <span class="title class_">Math</span>.<span class="title function_">round</span>(y * H) + <span class="string">&#x27;px)&#x27;</span> &#125;</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 落下：左上 → 右下（从左往右，逐渐沉入地平线）</span></span><br><span class="line">    <span class="keyword">var</span> <span class="variable constant_">SET_PATH</span> = [<span class="title function_">D</span>(<span class="number">0.24</span>, <span class="number">0.26</span>), <span class="title function_">D</span>(<span class="number">0.44</span>, <span class="number">0.32</span>), <span class="title function_">D</span>(<span class="number">0.68</span>, <span class="number">0.56</span>), <span class="title function_">D</span>(<span class="number">0.88</span>, <span class="number">0.84</span>)]</span><br><span class="line">    <span class="comment">// 升起：左下 → 右上（从左往右，逐渐升到天空）</span></span><br><span class="line">    <span class="keyword">var</span> <span class="variable constant_">RISE_PATH</span> = [<span class="title function_">D</span>(<span class="number">0.10</span>, <span class="number">0.86</span>), <span class="title function_">D</span>(<span class="number">0.28</span>, <span class="number">0.68</span>), <span class="title function_">D</span>(<span class="number">0.54</span>, <span class="number">0.44</span>), <span class="title function_">D</span>(<span class="number">0.76</span>, <span class="number">0.28</span>)]</span><br><span class="line"></span><br><span class="line">    <span class="keyword">function</span> <span class="title function_">celestial</span> (size, style, haloSize, haloStyle) &#123;</span><br><span class="line">      <span class="keyword">var</span> wrap = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;left:0;top:0;width:0;height:0;will-change:transform;&#x27;</span>, overlay)</span><br><span class="line">      <span class="keyword">var</span> halo = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;left:&#x27;</span> + (-haloSize / <span class="number">2</span>) + <span class="string">&#x27;px;top:&#x27;</span> + (-haloSize / <span class="number">2</span>) + <span class="string">&#x27;px;width:&#x27;</span> + haloSize + <span class="string">&#x27;px;height:&#x27;</span> + haloSize + <span class="string">&#x27;px;border-radius:50%;opacity:0;&#x27;</span> + haloStyle, wrap)</span><br><span class="line">      <span class="keyword">var</span> disc = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;left:&#x27;</span> + (-size / <span class="number">2</span>) + <span class="string">&#x27;px;top:&#x27;</span> + (-size / <span class="number">2</span>) + <span class="string">&#x27;px;width:&#x27;</span> + size + <span class="string">&#x27;px;height:&#x27;</span> + size + <span class="string">&#x27;px;border-radius:50%;&#x27;</span> + style, wrap)</span><br><span class="line">      <span class="keyword">return</span> &#123; <span class="attr">wrap</span>: wrap, <span class="attr">halo</span>: halo, <span class="attr">disc</span>: disc &#125;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">var</span> sunSet = <span class="title function_">celestial</span>(<span class="number">92</span>,</span><br><span class="line">      <span class="string">&#x27;background:radial-gradient(circle at 38% 34%,#fff8d6 0 14%,#ffe483 42%,#ffb43d 74%,#f0851a 100%);&#x27;</span></span><br><span class="line">      + <span class="string">&#x27;box-shadow:0 0 46px 14px rgba(255,190,90,.5),0 0 120px 40px rgba(255,150,60,.18);&#x27;</span>,</span><br><span class="line">      <span class="number">360</span>,</span><br><span class="line">      <span class="string">&#x27;background:radial-gradient(circle,rgba(255,205,120,.55) 0%,rgba(255,170,90,.22) 42%,rgba(255,150,60,0) 72%);&#x27;</span>)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">var</span> moonSet = <span class="title function_">celestial</span>(<span class="number">84</span>,</span><br><span class="line">      <span class="string">&#x27;background:radial-gradient(circle at 34% 30%,#fff 0 34%,#e8eefc 64%,#c2ccdf 100%);&#x27;</span></span><br><span class="line">      + <span class="string">&#x27;box-shadow:0 0 34px 10px rgba(190,210,255,.3),inset -6px -8px 18px rgba(120,140,190,.35);&#x27;</span>,</span><br><span class="line">      <span class="number">240</span>,</span><br><span class="line">      <span class="string">&#x27;background:radial-gradient(circle,rgba(200,220,255,.35) 0%,rgba(160,190,255,.12) 45%,rgba(120,150,255,0) 72%);&#x27;</span>)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">var</span> sun = sunSet.<span class="property">disc</span></span><br><span class="line">    <span class="keyword">var</span> sunHalo = sunSet.<span class="property">halo</span></span><br><span class="line">    <span class="keyword">var</span> sunWrap = sunSet.<span class="property">wrap</span></span><br><span class="line">    <span class="keyword">var</span> moon = moonSet.<span class="property">disc</span></span><br><span class="line">    <span class="keyword">var</span> moonHalo = moonSet.<span class="property">halo</span></span><br><span class="line">    <span class="keyword">var</span> moonWrap = moonSet.<span class="property">wrap</span></span><br><span class="line"></span><br><span class="line">    <span class="comment">// ⑥ 远山剪影</span></span><br><span class="line">    <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;left:0;right:0;bottom:0;height:32%;opacity:.94;background-repeat:no-repeat;background-position:bottom center;background-size:100% 100%;&#x27;</span></span><br><span class="line">      + <span class="string">&#x27;background-image:url(&quot;data:image/svg+xml;utf8,&lt;svg xmlns=\&#x27;http://www.w3.org/2000/svg\&#x27; viewBox=\&#x27;0 0 1440 200\&#x27; preserveAspectRatio=\&#x27;none\&#x27;&gt;&lt;path fill=\&#x27;%230b1022\&#x27; d=\&#x27;M0 200V152l126-24 132 30 138-44 148 36 140-30 152 34 158-26 150 32 152-20 144 24V200Z\&#x27;/&gt;&lt;path fill=\&#x27;%23222a4e\&#x27; d=\&#x27;M0 200V116l150-34 132 44 156-62 138 48 152-66 152 56 160-38 142 46 158-28 100 22V200Z\&#x27;/&gt;&lt;/svg&gt;&quot;);&#x27;</span>, overlay)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">var</span> ease = <span class="string">&#x27;cubic-bezier(.42,.05,.28,1)&#x27;</span></span><br><span class="line"></span><br><span class="line">    <span class="comment">// 先落一帧再切主题</span></span><br><span class="line">    <span class="keyword">void</span> overlay.<span class="property">offsetWidth</span></span><br><span class="line">    <span class="title function_">requestAnimationFrame</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="title function_">requestAnimationFrame</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">play</span>() &#125;)</span><br><span class="line">    &#125;)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">function</span> <span class="title function_">play</span> () &#123;</span><br><span class="line">      <span class="keyword">if</span> (!overlay) <span class="keyword">return</span></span><br><span class="line">      <span class="title function_">applyTheme</span>(toDark)</span><br><span class="line"></span><br><span class="line">      <span class="keyword">var</span> starEls = stars.<span class="property">children</span></span><br><span class="line">      <span class="keyword">var</span> pathFrames = <span class="keyword">function</span> (<span class="params">path</span>) &#123;</span><br><span class="line">        <span class="keyword">return</span> [</span><br><span class="line">          &#123; <span class="attr">transform</span>: path[<span class="number">0</span>], <span class="attr">offset</span>: <span class="number">0</span> &#125;,</span><br><span class="line">          &#123; <span class="attr">transform</span>: path[<span class="number">1</span>], <span class="attr">offset</span>: <span class="number">0.36</span> &#125;,</span><br><span class="line">          &#123; <span class="attr">transform</span>: path[<span class="number">2</span>], <span class="attr">offset</span>: <span class="number">0.70</span> &#125;,</span><br><span class="line">          &#123; <span class="attr">transform</span>: path[<span class="number">3</span>], <span class="attr">offset</span>: <span class="number">1</span> &#125;</span><br><span class="line">        ]</span><br><span class="line">      &#125;</span><br><span class="line">      <span class="keyword">var</span> travel = <span class="keyword">function</span> (<span class="params">node, path, dur, delay</span>) &#123;</span><br><span class="line">        <span class="keyword">return</span> <span class="title function_">anim</span>(node, <span class="title function_">pathFrames</span>(path), &#123; <span class="attr">duration</span>: dur, <span class="attr">delay</span>: delay || <span class="number">0</span>, <span class="attr">easing</span>: <span class="string">&#x27;linear&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">      &#125;</span><br><span class="line"></span><br><span class="line">      <span class="keyword">if</span> (toDark) &#123;</span><br><span class="line">        <span class="comment">// 入夜：太阳从左往右落下；月亮从左往右升起</span></span><br><span class="line">        dawn.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;1&#x27;</span></span><br><span class="line">        night.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">        horizon.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">        sun.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;1&#x27;</span></span><br><span class="line">        sunHalo.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;1&#x27;</span></span><br><span class="line">        sunWrap.<span class="property">style</span>.<span class="property">transform</span> = <span class="variable constant_">SET_PATH</span>[<span class="number">0</span>]</span><br><span class="line">        moonWrap.<span class="property">style</span>.<span class="property">transform</span> = <span class="variable constant_">RISE_PATH</span>[<span class="number">0</span>]</span><br><span class="line"></span><br><span class="line">        <span class="title function_">travel</span>(sunWrap, <span class="variable constant_">SET_PATH</span>, <span class="number">640</span> * k, <span class="number">0</span>)</span><br><span class="line">        <span class="title function_">travel</span>(moonWrap, <span class="variable constant_">RISE_PATH</span>, <span class="number">560</span> * k, <span class="number">620</span> * k)</span><br><span class="line">        <span class="title function_">anim</span>(sun, [&#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span>, <span class="attr">offset</span>: <span class="number">.5</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">660</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(sunHalo, [&#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">.9</span>, <span class="attr">offset</span>: <span class="number">.4</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">660</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(moon, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">220</span> * k, <span class="attr">delay</span>: <span class="number">640</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(moonHalo, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">260</span> * k, <span class="attr">delay</span>: <span class="number">640</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(night, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;], &#123; <span class="attr">duration</span>: <span class="number">1200</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(dawn, [&#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">.9</span>, <span class="attr">offset</span>: <span class="number">.38</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;], &#123; <span class="attr">duration</span>: <span class="number">1200</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(horizon, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span>, <span class="attr">offset</span>: <span class="number">.35</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;], &#123; <span class="attr">duration</span>: <span class="number">1100</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="keyword">for</span> (<span class="keyword">var</span> s2 = <span class="number">0</span>; s2 &lt; starEls.<span class="property">length</span>; s2++) &#123;</span><br><span class="line">          <span class="title function_">anim</span>(starEls[s2], [&#123; <span class="attr">opacity</span>: <span class="number">0</span>, <span class="attr">transform</span>: <span class="string">&#x27;scale(.6)&#x27;</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0.5</span> + <span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="number">0.5</span>, <span class="attr">transform</span>: <span class="string">&#x27;scale(1)&#x27;</span> &#125;],</span><br><span class="line">            &#123; <span class="attr">duration</span>: <span class="number">760</span> * k, <span class="attr">delay</span>: (<span class="number">360</span> + s2 * <span class="number">11</span>) * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        &#125;</span><br><span class="line">      &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">        <span class="comment">// 破晓：月亮从左往右落下；太阳从左往右升起</span></span><br><span class="line">        dawn.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">        night.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;1&#x27;</span></span><br><span class="line">        horizon.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">        sunWrap.<span class="property">style</span>.<span class="property">transform</span> = <span class="variable constant_">RISE_PATH</span>[<span class="number">0</span>]</span><br><span class="line">        moonWrap.<span class="property">style</span>.<span class="property">transform</span> = <span class="variable constant_">SET_PATH</span>[<span class="number">0</span>]</span><br><span class="line">        sun.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">        sunHalo.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">        moon.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;1&#x27;</span></span><br><span class="line">        moonHalo.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;1&#x27;</span></span><br><span class="line"></span><br><span class="line">        <span class="title function_">travel</span>(moonWrap, <span class="variable constant_">SET_PATH</span>, <span class="number">640</span> * k, <span class="number">0</span>)</span><br><span class="line">        <span class="title function_">travel</span>(sunWrap, <span class="variable constant_">RISE_PATH</span>, <span class="number">560</span> * k, <span class="number">620</span> * k)</span><br><span class="line">        <span class="title function_">anim</span>(moon, [&#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span>, <span class="attr">offset</span>: <span class="number">.5</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">660</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(moonHalo, [&#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">.9</span>, <span class="attr">offset</span>: <span class="number">.4</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">660</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(sun, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">220</span> * k, <span class="attr">delay</span>: <span class="number">640</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(sunHalo, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">.95</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">260</span> * k, <span class="attr">delay</span>: <span class="number">640</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(horizon, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">.95</span>, <span class="attr">offset</span>: <span class="number">.45</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">.55</span> &#125;],</span><br><span class="line">          &#123; <span class="attr">duration</span>: <span class="number">1200</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(dawn, [&#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;], &#123; <span class="attr">duration</span>: <span class="number">1100</span> * k, <span class="attr">delay</span>: <span class="number">200</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="title function_">anim</span>(night, [&#123; <span class="attr">opacity</span>: <span class="number">1</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;], &#123; <span class="attr">duration</span>: <span class="number">1150</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        <span class="keyword">for</span> (<span class="keyword">var</span> q = <span class="number">0</span>; q &lt; starEls.<span class="property">length</span>; q++) &#123;</span><br><span class="line">          starEls[q].<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0.85&#x27;</span></span><br><span class="line">          <span class="title function_">anim</span>(starEls[q], [&#123; <span class="attr">opacity</span>: <span class="number">0.85</span> &#125;, &#123; <span class="attr">opacity</span>: <span class="number">0</span> &#125;], &#123; <span class="attr">duration</span>: <span class="number">520</span> * k, <span class="attr">delay</span>: q * <span class="number">6</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-in&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">        &#125;</span><br><span class="line">      &#125;</span><br><span class="line"></span><br><span class="line">      <span class="keyword">if</span> (flourish) &#123;</span><br><span class="line">        <span class="keyword">var</span> meteor = <span class="title function_">el</span>(<span class="string">&#x27;position:absolute;left:0;top:0;width:2px;height:2px;border-radius:50%;background:#fff;opacity:0;box-shadow:0 0 10px 2px rgba(255,255,255,.7);&#x27;</span>, overlay)</span><br><span class="line">        <span class="title function_">anim</span>(meteor, [</span><br><span class="line">          &#123; <span class="attr">opacity</span>: <span class="number">0</span>, <span class="attr">transform</span>: <span class="string">&#x27;translate(18vw,6vh)&#x27;</span> &#125;,</span><br><span class="line">          &#123; <span class="attr">opacity</span>: <span class="number">1</span>, <span class="attr">offset</span>: <span class="number">.25</span> &#125;,</span><br><span class="line">          &#123; <span class="attr">opacity</span>: <span class="number">0</span>, <span class="attr">transform</span>: <span class="string">&#x27;translate(56vw,34vh)&#x27;</span> &#125;</span><br><span class="line">        ], &#123; <span class="attr">duration</span>: <span class="number">700</span> * k, <span class="attr">delay</span>: <span class="number">620</span> * k, <span class="attr">easing</span>: <span class="string">&#x27;ease-out&#x27;</span>, <span class="attr">fill</span>: <span class="string">&#x27;forwards&#x27;</span> &#125;)</span><br><span class="line">      &#125;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 揭幕：从点击点向外扩张的圆形遮罩</span></span><br><span class="line">    revealTimer = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (my !== runGen || !overlay) <span class="keyword">return</span></span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">hidden</span>) &#123; <span class="title function_">finishReveal</span>(); <span class="keyword">return</span> &#125;</span><br><span class="line">      <span class="keyword">var</span> x = pt.<span class="property">x</span>, y = pt.<span class="property">y</span></span><br><span class="line">      <span class="keyword">var</span> maxR = <span class="title class_">Math</span>.<span class="title function_">round</span>(<span class="title class_">Math</span>.<span class="title function_">sqrt</span>(<span class="variable language_">window</span>.<span class="property">innerWidth</span> * <span class="variable language_">window</span>.<span class="property">innerWidth</span> + <span class="variable language_">window</span>.<span class="property">innerHeight</span> * <span class="variable language_">window</span>.<span class="property">innerHeight</span>))</span><br><span class="line">      <span class="keyword">var</span> start = <span class="number">0</span></span><br><span class="line">      <span class="keyword">function</span> <span class="title function_">frame</span> (now) &#123;</span><br><span class="line">        <span class="keyword">if</span> (my !== runGen || !overlay) <span class="keyword">return</span></span><br><span class="line">        <span class="keyword">if</span> (!start) start = now</span><br><span class="line">        <span class="keyword">var</span> p = <span class="title class_">Math</span>.<span class="title function_">min</span>(<span class="number">1</span>, (now - start) / <span class="title class_">Math</span>.<span class="title function_">max</span>(<span class="number">1</span>, reveal))</span><br><span class="line">        <span class="keyword">var</span> e = <span class="number">1</span> - <span class="title class_">Math</span>.<span class="title function_">pow</span>(<span class="number">1</span> - p, <span class="number">3</span>)</span><br><span class="line">        <span class="keyword">var</span> r = <span class="title class_">Math</span>.<span class="title function_">round</span>(e * maxR)</span><br><span class="line">        <span class="keyword">var</span> mask = <span class="string">&#x27;radial-gradient(circle &#x27;</span> + r + <span class="string">&#x27;px at &#x27;</span> + x + <span class="string">&#x27;px &#x27;</span> + y + <span class="string">&#x27;px, transparent 97%, #000 100%)&#x27;</span></span><br><span class="line">        overlay.<span class="property">style</span>.<span class="property">webkitMaskImage</span> = mask</span><br><span class="line">        overlay.<span class="property">style</span>.<span class="property">maskImage</span> = mask</span><br><span class="line">        <span class="keyword">if</span> (p &lt; <span class="number">1</span>) revealRAF = <span class="title function_">requestAnimationFrame</span>(frame)</span><br><span class="line">        <span class="keyword">else</span> <span class="title function_">finishReveal</span>(my)</span><br><span class="line">      &#125;</span><br><span class="line">      revealRAF = <span class="title function_">requestAnimationFrame</span>(frame)</span><br><span class="line">    &#125;, <span class="title class_">Math</span>.<span class="title function_">round</span>(revealAt))</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 兜底：rAF 被节流（切标签页/后台/低电量）时也要收尾，避免遮罩停在半路</span></span><br><span class="line">    finishTimer = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">finishReveal</span>(my) &#125;, <span class="title class_">Math</span>.<span class="title function_">round</span>(revealAt + reveal + <span class="number">260</span>))</span><br><span class="line">    <span class="comment">// 最外层保险（必须可被 cleanup 取消，否则上一轮的定时器会掐断下一轮动画）</span></span><br><span class="line">    overlayGuard = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">if</span> (my === runGen &amp;&amp; overlay) <span class="title function_">finishReveal</span>(my) &#125;, <span class="title class_">Math</span>.<span class="title function_">round</span>(total) + <span class="number">1200</span>)</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">bind</span> () &#123;</span><br><span class="line">    <span class="keyword">var</span> nodes = <span class="variable language_">document</span>.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;#nightmode-button, .sun_moon, .icon-V&#x27;</span>)</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; nodes.<span class="property">length</span>; i++) &#123;</span><br><span class="line">      <span class="keyword">var</span> n = nodes[i]</span><br><span class="line">      <span class="keyword">if</span> (n.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-dm-bound&#x27;</span>) === <span class="string">&#x27;1&#x27;</span>) <span class="keyword">continue</span></span><br><span class="line">      <span class="keyword">if</span> (n.<span class="title function_">hasAttribute</span>(<span class="string">&#x27;onclick&#x27;</span>) &amp;&amp; n.<span class="property">parentNode</span>) &#123;</span><br><span class="line">        <span class="comment">// 克隆替换：把主题写死的内联 onclick 彻底丢掉，杜绝双触发</span></span><br><span class="line">        <span class="keyword">var</span> c = n.<span class="title function_">cloneNode</span>(<span class="literal">true</span>)</span><br><span class="line">        c.<span class="title function_">removeAttribute</span>(<span class="string">&#x27;onclick&#x27;</span>)</span><br><span class="line">        n.<span class="property">parentNode</span>.<span class="title function_">replaceChild</span>(c, n)</span><br><span class="line">        n = c</span><br><span class="line">      &#125;</span><br><span class="line">      n.<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-dm-bound&#x27;</span>, <span class="string">&#x27;1&#x27;</span>)</span><br><span class="line">      n.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">        e.<span class="title function_">preventDefault</span>()</span><br><span class="line">        e.<span class="title function_">stopPropagation</span>()</span><br><span class="line">        e.<span class="title function_">stopImmediatePropagation</span>()</span><br><span class="line">        <span class="title function_">run</span>()</span><br><span class="line">        <span class="keyword">return</span> <span class="literal">false</span></span><br><span class="line">      &#125;, <span class="literal">true</span>)</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;pointerdown&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">    <span class="variable language_">window</span>.<span class="property">__dmPoint</span> = &#123; <span class="attr">x</span>: <span class="title class_">Math</span>.<span class="title function_">round</span>(e.<span class="property">clientX</span>), <span class="attr">y</span>: <span class="title class_">Math</span>.<span class="title function_">round</span>(e.<span class="property">clientY</span>) &#125;</span><br><span class="line">  &#125;, <span class="literal">true</span>)</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;visibilitychange&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">hidden</span> &amp;&amp; overlay) <span class="title function_">finishReveal</span>(runGen)</span><br><span class="line">  &#125;)</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;pagehide&#x27;</span>, cleanup)</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;pjax:complete&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">cleanup</span>(); <span class="title function_">bind</span>() &#125;)</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">readyState</span> === <span class="string">&#x27;loading&#x27;</span>) <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;DOMContentLoaded&#x27;</span>, bind)</span><br><span class="line">  <span class="keyword">else</span> <span class="title function_">bind</span>()</span><br><span class="line"></span><br><span class="line">  <span class="comment">// 占住全局函数：主题的 sun_moon.js（async 加载）会重新声明 switchNightMode，</span></span><br><span class="line">  <span class="comment">// 用访问器把赋值吞掉，保证任何调用（导航按钮/右键菜单/侧边栏/美化面板）都走这里</span></span><br><span class="line">  <span class="keyword">try</span> &#123;</span><br><span class="line">    <span class="title class_">Object</span>.<span class="title function_">defineProperty</span>(<span class="variable language_">window</span>, <span class="string">&#x27;switchNightMode&#x27;</span>, &#123;</span><br><span class="line">      <span class="attr">configurable</span>: <span class="literal">true</span>,</span><br><span class="line">      <span class="attr">get</span>: <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">return</span> run &#125;,</span><br><span class="line">      <span class="attr">set</span>: <span class="keyword">function</span> (<span class="params"></span>) &#123;&#125;</span><br><span class="line">    &#125;)</span><br><span class="line">  &#125; <span class="keyword">catch</span> (e) &#123;</span><br><span class="line">    <span class="variable language_">window</span>.<span class="property">switchNightMode</span> = run</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">try</span> &#123; <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">switchNightMode</span> !== run) <span class="variable language_">window</span>.<span class="property">switchNightMode</span> = run &#125; <span class="keyword">catch</span> (e) &#123;&#125; &#125;, <span class="number">400</span>)</span><br><span class="line">  <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">try</span> &#123; <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">switchNightMode</span> !== run) <span class="variable language_">window</span>.<span class="property">switchNightMode</span> = run &#125; <span class="keyword">catch</span> (e) &#123;&#125; &#125;, <span class="number">1500</span>)</span><br><span class="line">&#125;)()</span><br></pre></td></tr></table></figure><p><code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.bottom</code> 加一行：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：追加到 <code>inject.bottom</code> 列表末尾；<code>defer</code> 要保留，提前执行会拿不到 DOM。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/night.js?v=1&quot;&gt;&lt;/script&gt;</span> <span class="comment">#昼夜切换 2.0</span></span><br></pre></td></tr></table></figure><p>按钮用主题自带的那个就行（<code>[Blogroot]\themes\butterfly\layout\includes\header\nav.pug</code>）：</p><p><strong>说明</strong>：主题自带按钮的片段，一般不需要修改——要是昼夜切换按钮丢了，就照这段在 <code>themes/butterfly/layout/includes/header/nav.pug</code>（第 34 行附近）恢复。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">a.sun_moon.faa-parent.animated-hover(onclick=&#x27;switchNightMode()&#x27;, title=_p(&#x27;rightside.night_mode_title&#x27;) id=&quot;nightmode-button&quot;)</span><br><span class="line">  svg.faa-tada(style=&quot;height:25px;width:25px;fill:currentColor;position:relative;top:7px&quot;, viewBox=&#x27;0 0 1024 1024&#x27;)</span><br><span class="line">    use#modeicon(xlink:href=&#x27;#icon-moon&#x27;)</span><br></pre></td></tr></table></figure><p>三个坑，踩过就记住：</p><ul><li><strong>主题自带的 <code>sun_moon.js</code> 会定义同名的全局 <code>switchNightMode</code></strong>，两份一起跑就是「动画播一半被另一份掐断」。脚本里用 <code>Object.defineProperty(window, &#39;switchNightMode&#39;, ...)</code> 占住这个全局名，并且加载后 400ms / 1500ms 再赋一次值，防止被异步脚本后覆盖。</li><li><strong>连点</strong>：动画中再点不再被静默丢弃，记一个 <code>pending</code>，本轮收尾后自动补播一次；每次运行带 <code>runGen</code> 代次，旧一轮的定时器 / rAF 一律作废，不会出现「上一轮把这一轮掐了」。</li><li><strong>遮罩闪烁</strong>：<code>mask</code> 从 <code>circle 0</code> 直接跳到 <code>160vmax</code> 再叠一层 <code>opacity:0</code>，第一帧会整块消失。改成 <code>requestAnimationFrame</code> 逐帧写半径，<code>overlay</code> 全程 <code>opacity:1</code>，结束后才 <code>visibility:hidden</code>。</li></ul><p>档位（<code>localStorage.darkTransition</code>）：<code>off</code> 直接切换／<code>light</code> 800ms 简化／<code>standard</code> 1500ms 默认／<code>flourish</code> 多一颗流星。系统开了「减少动态效果」时保留过场但压到 45% 时长，不做成直接消失。</p>              </div>            </details><details class="folding-tag" blue><summary> 切换样式：山河日月 / 图形（旧版） </summary>              <div class='content'>              <p>上面那套「黄昏落幕」是后来写的版本，但不少人（包括我自己）还是惦记主题原配那套：整屏青绿→橙黄的渐变圆盘转一圈、日月在同一点叠着做透明度互换。与其二选一删掉一个，不如做成开关。</p><p><strong>键</strong>：<code>localStorage.hgNightStyle</code>，<code>scene</code>（默认，山河日月）/ <code>cuteen</code>（图形，旧版转盘）。</p><p><strong>分工</strong>：新版的 DOM、渐变、关键帧全在 <code>night.js</code> 里自建；旧版反过来——只负责插 DOM，动画交给主题自带的 <code>themes/butterfly/source/css/_layout/sun_moon.styl</code>（<code>.Cuteen_DarkSky</code> / <code>.Cuteen_DarkPlanet</code> / <code>#sun</code> / <code>#moon</code>），这些样式本来就编译进主题 CSS，不用补。</p><h3 id="1-night-js：读样式-分流"><a href="#1-night-js：读样式-分流" class="headerlink" title="1. night.js：读样式 + 分流"></a>1. night.js：读样式 + 分流</h3><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/night.js</code> ｜ <strong>改法</strong>：三处追加，不要新建第二个文件。</p><p>(a) 状态区（<code>var pending = false</code> 后面）加：</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">STYLE_KEY</span> = <span class="string">&#x27;hgNightStyle&#x27;</span></span><br><span class="line"></span><br><span class="line"><span class="comment">// 过场样式：scene=山河日月（默认） / cuteen=图形（旧版转盘）</span></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">style</span> () &#123;</span><br><span class="line">  <span class="keyword">var</span> v = <span class="string">&#x27;scene&#x27;</span></span><br><span class="line">  <span class="keyword">try</span> &#123; v = <span class="variable language_">window</span>.<span class="property">localStorage</span>.<span class="title function_">getItem</span>(<span class="variable constant_">STYLE_KEY</span>) || <span class="string">&#x27;scene&#x27;</span> &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">  <span class="keyword">return</span> v === <span class="string">&#x27;cuteen&#x27;</span> ? <span class="string">&#x27;cuteen&#x27;</span> : <span class="string">&#x27;scene&#x27;</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>(b) <code>startRun()</code> 里，紧跟「关档直接切主题」那行之后：</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> (t === <span class="string">&#x27;off&#x27;</span>) &#123; <span class="title function_">applyTheme</span>(toDark); running = <span class="literal">false</span>; <span class="keyword">return</span> &#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">// 图形（旧版 Cuteen 转盘）：插入旧版 DOM，走主题自带的 Cuteen 动画</span></span><br><span class="line"><span class="keyword">if</span> (<span class="title function_">style</span>() === <span class="string">&#x27;cuteen&#x27;</span>) &#123; <span class="title function_">runCuteen</span>(my, toDark, t); <span class="keyword">return</span> &#125;</span><br></pre></td></tr></table></figure><p>(c) 在 <code>bind()</code> 之前插入旧版播放器：</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/**</span></span><br><span class="line"><span class="comment"> * 图形切换（旧版）：插入 .Cuteen_DarkSky / .Cuteen_DarkPlanet，</span></span><br><span class="line"><span class="comment"> * 转盘动画与日月由主题的 _layout/sun_moon.styl 提供；</span></span><br><span class="line"><span class="comment"> * 500ms 时日月透明度互换，1000ms 后整块淡出移除。</span></span><br><span class="line"><span class="comment"> */</span></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">runCuteen</span> (my, toDark, t) &#123;</span><br><span class="line">  <span class="keyword">var</span> k = (<span class="title function_">reduced</span>() ? <span class="number">0.45</span> : <span class="number">1</span>) * (t === <span class="string">&#x27;light&#x27;</span> ? <span class="number">0.75</span> : <span class="number">1</span>)</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> sky = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>)</span><br><span class="line">  sky.<span class="property">className</span> = <span class="string">&#x27;Cuteen_DarkSky&#x27;</span></span><br><span class="line">  <span class="keyword">var</span> planet = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>)</span><br><span class="line">  planet.<span class="property">className</span> = <span class="string">&#x27;Cuteen_DarkPlanet&#x27;</span></span><br><span class="line">  <span class="comment">// 转盘一圈时长由自定义属性驱动（custom.css 里 !important 的动画也会读它）</span></span><br><span class="line">  sky.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;--hg-cut-dur&#x27;</span>, (<span class="number">1000</span> * k) + <span class="string">&#x27;ms&#x27;</span>)</span><br><span class="line">  <span class="keyword">var</span> sun = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>)</span><br><span class="line">  sun.<span class="property">id</span> = <span class="string">&#x27;sun&#x27;</span></span><br><span class="line">  sun.<span class="property">style</span>.<span class="property">transition</span> = <span class="string">&#x27;opacity .45s ease&#x27;</span></span><br><span class="line">  sun.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;1&#x27;</span> : <span class="string">&#x27;0&#x27;</span></span><br><span class="line">  <span class="keyword">var</span> moon = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>)</span><br><span class="line">  moon.<span class="property">id</span> = <span class="string">&#x27;moon&#x27;</span></span><br><span class="line">  moon.<span class="property">style</span>.<span class="property">transition</span> = <span class="string">&#x27;opacity .45s ease&#x27;</span></span><br><span class="line">  moon.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;0&#x27;</span> : <span class="string">&#x27;1&#x27;</span></span><br><span class="line">  planet.<span class="title function_">appendChild</span>(sun)</span><br><span class="line">  planet.<span class="title function_">appendChild</span>(moon)</span><br><span class="line">  sky.<span class="title function_">appendChild</span>(planet)</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(sky)</span><br><span class="line">  overlay = sky</span><br><span class="line"></span><br><span class="line">  <span class="comment">// 先落一帧，让 :before 的 2s 过渡从「浅色」起步</span></span><br><span class="line">  <span class="keyword">void</span> sky.<span class="property">offsetWidth</span></span><br><span class="line">  <span class="title function_">applyTheme</span>(toDark)</span><br><span class="line">  <span class="title function_">nightToast</span>(toDark)</span><br><span class="line"></span><br><span class="line">  <span class="comment">// 500ms：日月互换（复用 cleanup 会清的定时器槽位）</span></span><br><span class="line">  revealTimer = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (my !== runGen) <span class="keyword">return</span></span><br><span class="line">    sun.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;0&#x27;</span> : <span class="string">&#x27;1&#x27;</span></span><br><span class="line">    moon.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;1&#x27;</span> : <span class="string">&#x27;0&#x27;</span></span><br><span class="line">  &#125;, <span class="title class_">Math</span>.<span class="title function_">round</span>(<span class="number">500</span> * k))</span><br><span class="line"></span><br><span class="line">  <span class="comment">// 半圈后：整块淡出</span></span><br><span class="line">  finishTimer = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (my !== runGen) <span class="keyword">return</span></span><br><span class="line">    sky.<span class="property">style</span>.<span class="property">transition</span> = <span class="string">&#x27;opacity .5s ease&#x27;</span></span><br><span class="line">    sky.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">  &#125;, <span class="title class_">Math</span>.<span class="title function_">round</span>(<span class="number">1000</span> * k))</span><br><span class="line"></span><br><span class="line">  <span class="comment">// 收尾移除</span></span><br><span class="line">  cleanupTimer = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (my !== runGen) <span class="keyword">return</span></span><br><span class="line">    <span class="title function_">cleanup</span>()</span><br><span class="line">  &#125;, <span class="title class_">Math</span>.<span class="title function_">round</span>(<span class="number">1000</span> * k) + <span class="number">620</span>)</span><br><span class="line"></span><br><span class="line">  <span class="comment">// 保险：动画被节流/中间出错时也要复位</span></span><br><span class="line">  overlayGuard = <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (my === runGen &amp;&amp; overlay) <span class="title function_">cleanup</span>()</span><br><span class="line">  &#125;, <span class="title class_">Math</span>.<span class="title function_">round</span>(<span class="number">1000</span> * k) + <span class="number">2200</span>)</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="2-转盘时长必须走-CSS-变量（本节最坑的一处）"><a href="#2-转盘时长必须走-CSS-变量（本节最坑的一处）" class="headerlink" title="2. 转盘时长必须走 CSS 变量（本节最坑的一处）"></a>2. 转盘时长必须走 CSS 变量（本节最坑的一处）</h3><p>旧版动画在 <code>custom.css</code> 里带了 <code>!important</code>，你就算在 JS 里写 <code>planet.style.animationDuration = &#39;3s&#39;</code> 也<strong>完全无效</strong>（内联样式优先级低于 <code>!important</code>）。唯一能干过它的是自定义属性：把时长替换成 <code>var(--hg-cut-dur, 1s)</code>，再由 JS 写到 <code>.Cuteen_DarkSky</code> 上，让子元素继承。</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：把旧版那段的动画声明替换掉：</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.Cuteen_DarkPlanet</span> &#123;</span><br><span class="line">  -webkit-<span class="attribute">animation</span>: CuteenPlanetMove <span class="built_in">var</span>(--hg-cut-dur, <span class="number">1s</span>) <span class="built_in">cubic-bezier</span>(<span class="number">0.7</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>) <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">animation</span>: CuteenPlanetMove <span class="built_in">var</span>(--hg-cut-dur, <span class="number">1s</span>) <span class="built_in">cubic-bezier</span>(<span class="number">0.7</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>) <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>（<code>.Cuteen_DarkSky{transition:opacity .75s}</code>、<code>#sun/#moon{transition:opacity .4s}</code> 这些保持原样即可。）</p><h3 id="3-面板里加一行开关"><a href="#3-面板里加一行开关" class="headerlink" title="3. 面板里加一行开关"></a>3. 面板里加一行开关</h3><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/panel.js</code> ｜ <strong>改法</strong>：函数区、HTML 片段、导出与 <code>syncAll()</code> 各加一处。</p><p>函数（放在 <code>setTier</code> 之前）：</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* ── 昼夜切换样式：山河日月 / 图形（旧版 Cuteen 转盘） ────────────────── */</span></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">nightStyle</span> () &#123; <span class="keyword">return</span> <span class="title function_">sget</span>(K.<span class="property">nightStyle</span>, <span class="string">&#x27;scene&#x27;</span>) === <span class="string">&#x27;cuteen&#x27;</span> ? <span class="string">&#x27;cuteen&#x27;</span> : <span class="string">&#x27;scene&#x27;</span> &#125;</span><br><span class="line"><span class="keyword">function</span> <span class="title function_">syncNightStyle</span> () &#123;</span><br><span class="line">  <span class="keyword">var</span> current = <span class="title function_">nightStyle</span>()</span><br><span class="line">  <span class="keyword">var</span> buttons = d.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;.settings .dm-seg button[data-ns]&#x27;</span>)</span><br><span class="line">  <span class="keyword">for</span> (<span class="keyword">var</span> i = <span class="number">0</span>; i &lt; buttons.<span class="property">length</span>; i++) &#123;</span><br><span class="line">    buttons[i].<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;is-on&#x27;</span>, buttons[i].<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-ns&#x27;</span>) === current)</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">var</span> note = $(<span class="string">&#x27;nightStyleNote&#x27;</span>)</span><br><span class="line">  <span class="keyword">if</span> (note) &#123;</span><br><span class="line">    note.<span class="property">textContent</span> = current === <span class="string">&#x27;cuteen&#x27;</span></span><br><span class="line">      ? <span class="string">&#x27;图形：旧版圆盘转动 + 日月互换&#x27;</span></span><br><span class="line">      : <span class="string">&#x27;山河日月：太阳沉落 / 月亮升起 + 星星&#x27;</span></span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">setNightStyle</span> (value) &#123;</span><br><span class="line">  <span class="keyword">if</span> ([<span class="string">&#x27;scene&#x27;</span>, <span class="string">&#x27;cuteen&#x27;</span>].<span class="title function_">indexOf</span>(value) &lt; <span class="number">0</span>) <span class="keyword">return</span></span><br><span class="line">  <span class="title function_">sset</span>(K.<span class="property">nightStyle</span>, value)</span><br><span class="line">  <span class="title function_">syncNightStyle</span>()</span><br><span class="line">  <span class="title function_">toast</span>(<span class="string">&#x27;切换样式：&#x27;</span> + (value === <span class="string">&#x27;cuteen&#x27;</span> ? <span class="string">&#x27;图形（旧版）&#x27;</span> : <span class="string">&#x27;山河日月&#x27;</span>), <span class="string">&#x27;info&#x27;</span>)</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>HTML：接在「昼夜切换」那行 <code>&lt;/div&gt;&lt;/div&gt;</code> 之后、<code>互动挂件</code> 标题之前：</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="string">&#x27;&lt;div class=&quot;feature-opt dm-wide&quot;&gt;&lt;span&gt;切换样式&lt;small id=&quot;nightStyleNote&quot;&gt;点击日月的过场效果&lt;/small&gt;&lt;/span&gt;&#x27;</span> +</span><br><span class="line">  <span class="string">&#x27;&lt;div class=&quot;dm-seg&quot; role=&quot;group&quot; aria-label=&quot;昼夜切换样式&quot;&gt;&#x27;</span> +</span><br><span class="line">    <span class="string">&#x27;&lt;button type=&quot;button&quot; data-ns=&quot;scene&quot; onclick=&quot;hgSetNightStyle(\&#x27;scene\&#x27;)&quot;&gt;山河日月&lt;/button&gt;&#x27;</span> +</span><br><span class="line">    <span class="string">&#x27;&lt;button type=&quot;button&quot; data-ns=&quot;cuteen&quot; onclick=&quot;hgSetNightStyle(\&#x27;cuteen\&#x27;)&quot;&gt;图形（旧版）&lt;/button&gt;&#x27;</span> +</span><br><span class="line">  <span class="string">&#x27;&lt;/div&gt;&#x27;</span> +</span><br><span class="line"><span class="string">&#x27;&lt;/div&gt;&#x27;</span> +</span><br></pre></td></tr></table></figure><p>导出（跟 <code>w.hgSetTier = setTier</code> 放一起）：</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">w.<span class="property">hgSetNightStyle</span> = setNightStyle</span><br></pre></td></tr></table></figure><p><code>syncAll()</code> 末尾补一行 <code>syncNightStyle()</code>（和 <code>syncTier()</code> 并列），否则重开面板时按钮状态是旧的。</p><p>如果面板脚本是从 <code>boot.js</code> 的 <code>KEYS</code> 里取键名，记得补 <code>nightStyle: &#39;hgNightStyle&#39;,</code>；没有 boot.js 就在 <code>panel.js</code> 里直接用字符串 <code>&#39;hgNightStyle&#39;</code> 当键，两处必须一致。</p><h3 id="4-验证"><a href="#4-验证" class="headerlink" title="4. 验证"></a>4. 验证</h3><p>点右上角日月两次，各看一遍：</p><ul><li>面板选「图形（旧版）」：能截到的中间画面是整屏 <strong>青绿→橙黄</strong> 渐变盘 + 左侧大太阳；入夜则变成 <strong>紫→青</strong> 的深色渐变淡入，1000ms 后整块消失。</li><li>面板选「山河日月」：回到太阳沉落、月亮升起、星星渐显，末尾圆形揭幕。</li></ul><p>Console 里 <code>localStorage.hgNightStyle</code> 应该是 <code>scene</code> 或 <code>cuteen</code>；切完主题还能看到 <code>document.querySelector(&#39;.Cuteen_DarkSky&#39;)</code> 为 <code>null</code>（说明清理干净了）。档位选「关闭」时两种样式都不播动画，只切主题——这是预期行为。</p><h3 id="5-还有一个-hexo-的坑"><a href="#5-还有一个-hexo-的坑" class="headerlink" title="5. 还有一个 hexo 的坑"></a>5. 还有一个 hexo 的坑</h3><p>改了 <code>public/</code> 下的文件（哪怕只是临时 sed 调试），它的修改时间会比 <code>source/</code> 新，<strong><code>hexo generate</code> 会跳过复制</strong>，于是你以为改好了、其实线上还是旧的。遇到「源码明明改了但页面没变」，先删掉对应 <code>public/js/...</code> 再 generate，最省事。</p>              </div>            </details><h1 id="评论区（Twikoo-私有部署）"><a href="#评论区（Twikoo-私有部署）" class="headerlink" title="评论区（Twikoo 私有部署）"></a>评论区（Twikoo 私有部署）</h1><blockquote><p>借鉴：衍方（Twikoo 作者）的部署思路。本站改动：改为私有部署 + 同源反代，配置与安全项按本站服务器环境重写。</p></blockquote><details class="folding-tag" blue><summary> 自建评论服务 </summary>              <div class='content'>              <p>国外那几家评论服务在国内加载慢、还可能被墙，备案后又要「可管可控」，干脆自己起一个 Twikoo：数据在自己服务器，前端只请求自己的域名（同源反代），不用额外证书。</p><p>服务器上 <code>docker-compose.yml</code>：</p><p><strong>文件</strong>：<strong>服务器上</strong>的 <code>docker-compose.yml</code>（例如 <code>/root/twikoo/docker-compose.yml</code>，目录自己建）｜ <strong>改法</strong>：新建文件，整段写入后把 <code>&lt;本地端口&gt;</code> 换成实际端口。注意这个文件不在博客目录里。</p><figure class="highlight yaml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">services:</span></span><br><span class="line">  <span class="attr">twikoo:</span></span><br><span class="line">    <span class="attr">image:</span> <span class="string">imaegoo/twikoo:latest</span></span><br><span class="line">    <span class="attr">container_name:</span> <span class="string">twikoo</span></span><br><span class="line">    <span class="attr">restart:</span> <span class="string">always</span></span><br><span class="line">    <span class="attr">ports:</span></span><br><span class="line">      <span class="bullet">-</span> <span class="string">&quot;127.0.0.1:&lt;本地端口&gt;:8080&quot;</span></span><br><span class="line">    <span class="attr">volumes:</span></span><br><span class="line">      <span class="bullet">-</span> <span class="string">./data:/app/data</span></span><br></pre></td></tr></table></figure><p><code>&lt;本地端口&gt;</code> 自己挑一个<strong>没被占用</strong>的端口（比如 6xxx～9xxx 里随便选），把这一行替换掉。</p><p>两条铁律：</p><ul><li><strong>只绑 <code>127.0.0.1</code></strong>：前面带 <code>127.0.0.1:</code> 就意味着只有本机能连，公网扫不到这个端口。</li><li><strong>不要写进公开的教程 / 截图里</strong>：端口只是内网细节，写出来等于告诉别人从哪儿找入口；外网访问一律走下面的 Nginx 反代（对外只有 443 + <code>/twikoo/</code> 路径）。</li></ul><p>保存后启动：</p><p><strong>执行位置</strong>：服务器上存放 <code>docker-compose.yml</code> 的目录 ｜ <strong>作用</strong>：后台拉起 Twikoo 容器，<code>ps</code> 里 STATUS 显示 <code>Up</code> 就正常。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">docker compose up -d</span><br><span class="line">docker compose ps     <span class="comment"># STATUS 显示 Up 就正常</span></span><br></pre></td></tr></table></figure><p>第一次启动会自动拉 <code>imaegoo/twikoo</code> 镜像；拉不动就给 Docker 配国内镜像加速。</p><p>Nginx 站点配置里加一段（放在 <code>#REWRITE-START</code> 之前）：</p><p><strong>文件</strong>：服务器 Nginx 的站点配置文件（宝塔面板里是「站点 → 配置文件」）｜ <strong>改法</strong>：在 <code>#REWRITE-START</code> 之前插入这一段，<code>&lt;本地端口&gt;</code> 与 compose 里保持一致。</p><figure class="highlight nginx"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="section">location</span><span class="regexp"> ^~</span> /twikoo/ &#123;</span><br><span class="line">    <span class="attribute">proxy_pass</span> http://127.0.0.1:&lt;本地端口&gt;/;</span><br><span class="line">    <span class="attribute">proxy_http_version</span> <span class="number">1</span>.<span class="number">1</span>;</span><br><span class="line">    <span class="attribute">proxy_set_header</span> Host <span class="variable">$host</span>;</span><br><span class="line">    <span class="attribute">proxy_set_header</span> X-Real-IP <span class="variable">$remote_addr</span>;</span><br><span class="line">    <span class="attribute">proxy_set_header</span> X-Forwarded-For <span class="variable">$proxy_add_x_forwarded_for</span>;</span><br><span class="line">    <span class="attribute">proxy_set_header</span> X-Forwarded-Proto <span class="variable">$scheme</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>nginx -t</code> 通过后 <code>nginx -s reload</code>。验证：</p><p><strong>执行位置</strong>：任意终端（本机或服务器都行）｜ <strong>作用</strong>：POST 一次 <code>GET_FUNC_VERSION</code>，返回 <code>{&quot;code&quot;:0,...}</code> 说明反代和容器都通了。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">curl -i -X POST https://你的域名/twikoo/ -H <span class="string">&quot;Content-Type: application/json&quot;</span> -d <span class="string">&#x27;&#123;&quot;event&quot;:&quot;GET_FUNC_VERSION&quot;&#125;&#x27;</span></span><br></pre></td></tr></table></figure><p>返回 <code>{&quot;code&quot;:0,...}</code> 就通了。</p><p><code>[Blogroot]\_config.butterfly.yml</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：顶层 <code>comments:</code> 把 <code>use</code> 改成 <code>Twikoo</code>，再新增顶层 <code>twikoo:</code> 段；<code>envId</code> 结尾的斜杠不能省。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">comments:</span></span><br><span class="line">  <span class="attr">use:</span> <span class="string">Twikoo</span></span><br><span class="line">  <span class="attr">text:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">lazyload:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="attr">twikoo:</span></span><br><span class="line">  <span class="attr">envId:</span> <span class="string">https://你的域名/twikoo/</span>   <span class="comment"># 结尾的斜杠必须留，否则 location ^~ /twikoo/ 匹配不上</span></span><br><span class="line">  <span class="attr">region:</span></span><br><span class="line">  <span class="attr">visitor:</span> <span class="literal">true</span></span><br></pre></td></tr></table></figure><p>管理员面板没有独立网址：<strong>评论框右下角那个小齿轮</strong>就是入口，第一次点开直接让你设密码（私有部署默认没有 <code>TWIKOO_ADMIN</code> 之类环境变量）。</p><p>忘记密码：改容器里的 <code>/app/data/db.json</code>，删掉 <code>config.ADMIN_PASS</code> 这一段，再回面板重设。数据全在 <code>./data</code> 目录，记得纳入备份；想连评论数一起用，<code>visitor: true</code> 再把 <code>comments.count</code> 打开。</p>              </div>            </details><h1 id="FPS-帧率监测（fomal-药丸版）"><a href="#FPS-帧率监测（fomal-药丸版）" class="headerlink" title="FPS 帧率监测（fomal 药丸版）"></a>FPS 帧率监测（fomal 药丸版）</h1><blockquote><p>借鉴：LYX（Fomalhaut 整理）。本站改动：显示改成右下角药丸，六档状态与低性能模式阈值按本站实现调整。</p></blockquote><details class="folding-tag" blue><summary> 右下角 FPS 药丸 </summary>              <div class='content'>              <p>用 <code>requestAnimationFrame</code> 数帧，每秒算一次，显示成右下角的小药丸：<code>FPS 240 · 流畅</code>，六档（极低/卡顿/偏低/一般/顺畅/流畅）。顺便驱动「低性能模式」：连续两次低于 35 帧就给 <code>html</code> 加 <code>.low-perf</code>，连续五次 50 帧以上再摘掉，方便在 <code>custom.css</code> 里给毛玻璃、动画、画布做降级。</p><p>新建 <code>[Blogroot]\source\js\fps.js</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fps.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；本站已有同名文件，改逻辑时在它的 <code>stateOf()</code> / <code>loop()</code> 里补全即可。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br><span class="line">84</span><br><span class="line">85</span><br><span class="line">86</span><br><span class="line">87</span><br><span class="line">88</span><br><span class="line">89</span><br><span class="line">90</span><br><span class="line">91</span><br><span class="line">92</span><br><span class="line">93</span><br><span class="line">94</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* 帧率检测（fomal 样式 + 本站低性能模式）</span></span><br><span class="line"><span class="comment">   显示结构：&lt;span class=&quot;fps-label&quot;&gt;FPS&lt;/span&gt;&lt;span class=&quot;fps-value&quot;&gt;240&lt;/span&gt;&lt;span class=&quot;fps-state&quot; data-state=&quot;good&quot;&gt;流畅&lt;/span&gt;</span></span><br><span class="line"><span class="comment">   fpson=&#x27;1&#x27; 开启、&#x27;0&#x27; 关闭；面板里的「帧率监测」调 window.fpsSwitch(on)。 */</span></span><br><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> rAF = <span class="variable language_">window</span>.<span class="property">requestAnimationFrame</span> || <span class="variable language_">window</span>.<span class="property">webkitRequestAnimationFrame</span> || <span class="keyword">function</span> (<span class="params">cb</span>) &#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="variable language_">window</span>.<span class="built_in">setTimeout</span>(cb, <span class="number">1000</span> / <span class="number">60</span>);</span><br><span class="line">  &#125;;</span><br><span class="line">  <span class="keyword">var</span> node = <span class="literal">null</span>;</span><br><span class="line">  <span class="keyword">var</span> frame = <span class="number">0</span>;</span><br><span class="line">  <span class="keyword">var</span> lastTime = performance.<span class="title function_">now</span>();</span><br><span class="line">  <span class="keyword">var</span> warmupUntil = lastTime + <span class="number">2000</span>; <span class="comment">// 首屏解析/解码天然掉帧，前 2 秒不计</span></span><br><span class="line">  <span class="keyword">var</span> lowCount = <span class="number">0</span>;</span><br><span class="line">  <span class="keyword">var</span> goodCount = <span class="number">0</span>;</span><br><span class="line">  <span class="keyword">var</span> lowPerf = <span class="literal">false</span>;</span><br><span class="line">  <span class="keyword">var</span> lastFp = -<span class="number">1</span>;</span><br><span class="line">  <span class="keyword">var</span> lastState = <span class="string">&#x27;&#x27;</span>;</span><br><span class="line">  <span class="keyword">var</span> running = <span class="literal">false</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">setLowPerf</span> (on) &#123;</span><br><span class="line">    <span class="keyword">if</span> (lowPerf === on) <span class="keyword">return</span>;</span><br><span class="line">    lowPerf = on;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;low-perf&#x27;</span>, on);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="comment">// fomal 的六档：极低/卡顿/偏低/一般/顺畅/流畅</span></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">stateOf</span> (fps) &#123;</span><br><span class="line">    <span class="keyword">if</span> (fps &lt;= <span class="number">5</span>) <span class="keyword">return</span> [<span class="string">&#x27;极低&#x27;</span>, <span class="string">&#x27;low&#x27;</span>];</span><br><span class="line">    <span class="keyword">if</span> (fps &lt;= <span class="number">15</span>) <span class="keyword">return</span> [<span class="string">&#x27;卡顿&#x27;</span>, <span class="string">&#x27;low&#x27;</span>];</span><br><span class="line">    <span class="keyword">if</span> (fps &lt;= <span class="number">25</span>) <span class="keyword">return</span> [<span class="string">&#x27;偏低&#x27;</span>, <span class="string">&#x27;warn&#x27;</span>];</span><br><span class="line">    <span class="keyword">if</span> (fps &lt; <span class="number">35</span>) <span class="keyword">return</span> [<span class="string">&#x27;一般&#x27;</span>, <span class="string">&#x27;warn&#x27;</span>];</span><br><span class="line">    <span class="keyword">if</span> (fps &lt;= <span class="number">45</span>) <span class="keyword">return</span> [<span class="string">&#x27;顺畅&#x27;</span>, <span class="string">&#x27;good&#x27;</span>];</span><br><span class="line">    <span class="keyword">return</span> [<span class="string">&#x27;流畅&#x27;</span>, <span class="string">&#x27;good&#x27;</span>];</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">write</span> (fps, status, state) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!node) node = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;fps&#x27;</span>);</span><br><span class="line">    <span class="keyword">if</span> (!node) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> key = fps + <span class="string">&#x27;|&#x27;</span> + state;</span><br><span class="line">    <span class="keyword">if</span> (key === lastState) <span class="keyword">return</span>;</span><br><span class="line">    lastState = key;</span><br><span class="line">    node.<span class="property">innerHTML</span> = <span class="string">&#x27;&lt;span class=&quot;fps-label&quot;&gt;FPS&lt;/span&gt;&lt;span class=&quot;fps-value&quot;&gt;&#x27;</span> + fps +</span><br><span class="line">      <span class="string">&#x27;&lt;/span&gt;&lt;span class=&quot;fps-state&quot; data-state=&quot;&#x27;</span> + state + <span class="string">&#x27;&quot;&gt;&#x27;</span> + status + <span class="string">&#x27;&lt;/span&gt;&#x27;</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">loop</span> (now) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!running) <span class="keyword">return</span>;</span><br><span class="line">    now = now || performance.<span class="title function_">now</span>();</span><br><span class="line">    frame++;</span><br><span class="line">    <span class="keyword">var</span> elapsed = now - lastTime;</span><br><span class="line">    <span class="keyword">if</span> (elapsed &gt;= <span class="number">1000</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> fps = <span class="title class_">Math</span>.<span class="title function_">round</span>((frame * <span class="number">1000</span>) / elapsed);</span><br><span class="line">      frame = <span class="number">0</span>;</span><br><span class="line">      lastTime = now;</span><br><span class="line">      <span class="keyword">if</span> (now &gt;= warmupUntil) &#123;</span><br><span class="line">        <span class="keyword">var</span> st = <span class="title function_">stateOf</span>(fps);</span><br><span class="line">        <span class="title function_">write</span>(fps, st[<span class="number">0</span>], st[<span class="number">1</span>]);</span><br><span class="line">        <span class="keyword">if</span> (fps &lt; <span class="number">35</span>) &#123; lowCount++; goodCount = <span class="number">0</span>; &#125; <span class="keyword">else</span> <span class="keyword">if</span> (fps &gt;= <span class="number">50</span>) &#123; goodCount++; lowCount = <span class="number">0</span>; &#125; <span class="keyword">else</span> &#123; lowCount = <span class="number">0</span>; goodCount = <span class="number">0</span>; &#125;</span><br><span class="line">        <span class="keyword">if</span> (lowCount &gt;= <span class="number">2</span>) <span class="title function_">setLowPerf</span>(<span class="literal">true</span>);</span><br><span class="line">        <span class="keyword">if</span> (goodCount &gt;= <span class="number">5</span>) <span class="title function_">setLowPerf</span>(<span class="literal">false</span>);</span><br><span class="line">      &#125;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="title function_">rAF</span>(loop);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">start</span> () &#123;</span><br><span class="line">    <span class="keyword">if</span> (running) <span class="keyword">return</span>;</span><br><span class="line">    running = <span class="literal">true</span>;</span><br><span class="line">    frame = <span class="number">0</span>;</span><br><span class="line">    lastTime = performance.<span class="title function_">now</span>();</span><br><span class="line">    warmupUntil = lastTime + <span class="number">1200</span>;</span><br><span class="line">    lastState = <span class="string">&#x27;&#x27;</span>;</span><br><span class="line">    <span class="keyword">if</span> (node) node.<span class="property">style</span>.<span class="property">display</span> = <span class="string">&#x27;&#x27;</span>;</span><br><span class="line">    <span class="title function_">rAF</span>(loop);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">stop</span> () &#123;</span><br><span class="line">    running = <span class="literal">false</span>;</span><br><span class="line">    lastState = <span class="string">&#x27;&#x27;</span>;</span><br><span class="line">    <span class="title function_">setLowPerf</span>(<span class="literal">false</span>);</span><br><span class="line">    <span class="keyword">if</span> (node) &#123;</span><br><span class="line">      node.<span class="property">innerHTML</span> = <span class="string">&#x27;&#x27;</span>;</span><br><span class="line">      node.<span class="property">style</span>.<span class="property">display</span> = <span class="string">&#x27;none&#x27;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">window</span>.<span class="property">fpsSwitch</span> = <span class="keyword">function</span> (<span class="params">on</span>) &#123;</span><br><span class="line">    <span class="variable language_">window</span>.<span class="property">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;fpson&#x27;</span>, on ? <span class="string">&#x27;1&#x27;</span> : <span class="string">&#x27;0&#x27;</span>);</span><br><span class="line">    <span class="keyword">if</span> (on) <span class="title function_">start</span>(); <span class="keyword">else</span> <span class="title function_">stop</span>();</span><br><span class="line">  &#125;;</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;visibilitychange&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">hidden</span>) running = <span class="literal">false</span>; <span class="keyword">else</span> <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&#x27;fpson&#x27;</span>) !== <span class="string">&#x27;0&#x27;</span>) <span class="title function_">start</span>(); &#125;);</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&#x27;fpson&#x27;</span>) !== <span class="string">&#x27;0&#x27;</span>) <span class="title function_">start</span>();</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p><code>[Blogroot]\source\css\custom.css</code> 追加药丸样式：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-tag">html</span> <span class="selector-id">#fps</span>, <span class="selector-tag">html</span><span class="selector-attr">[data-theme]</span> <span class="selector-id">#fps</span> &#123;</span><br><span class="line">  <span class="attr">--fps-bg</span>: <span class="built_in">rgba</span>(<span class="number">232</span>,<span class="number">242</span>,<span class="number">246</span>,.<span class="number">88</span>); <span class="attr">--fps-fg</span>: <span class="number">#283c45</span>; <span class="attr">--fps-muted</span>: <span class="number">#65757b</span>;</span><br><span class="line">  <span class="attr">--fps-border</span>: <span class="built_in">rgba</span>(<span class="number">61</span>,<span class="number">91</span>,<span class="number">104</span>,.<span class="number">18</span>); <span class="attr">--fps-good</span>: <span class="number">#267d72</span>; <span class="attr">--fps-warn</span>: <span class="number">#a0740d</span>; <span class="attr">--fps-low</span>: <span class="number">#df2039</span>;</span><br><span class="line">  <span class="attribute">box-sizing</span>: border-box; <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">right</span>: <span class="number">10px</span>; <span class="attribute">bottom</span>: <span class="number">6px</span>; <span class="attribute">left</span>: auto;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">1919810</span>; <span class="attribute">height</span>: <span class="number">30px</span>; <span class="attribute">padding</span>: <span class="number">0</span> <span class="number">9px</span>; <span class="attribute">width</span>: max-content;</span><br><span class="line">  <span class="attribute">display</span>: flex; <span class="attribute">align-items</span>: center;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="built_in">var</span>(--fps-border); <span class="attribute">border-radius</span>: <span class="number">9px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">var</span>(--fps-bg); <span class="attribute">color</span>: <span class="built_in">var</span>(--fps-fg);</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">13px</span>; <span class="attribute">line-height</span>: <span class="number">1</span>; <span class="attribute">font-weight</span>: <span class="number">500</span>; <span class="attribute">white-space</span>: nowrap;</span><br><span class="line">  <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">2px</span> <span class="number">8px</span> <span class="built_in">rgba</span>(<span class="number">15</span>,<span class="number">35</span>,<span class="number">45</span>,.<span class="number">06</span>); <span class="attribute">pointer-events</span>: none; user-select: none;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#fps</span> &#123;</span><br><span class="line">  <span class="attr">--fps-bg</span>: <span class="built_in">rgba</span>(<span class="number">18</span>,<span class="number">29</span>,<span class="number">35</span>,.<span class="number">88</span>); <span class="attr">--fps-fg</span>: <span class="number">#dce9ef</span>; <span class="attr">--fps-muted</span>: <span class="number">#9aacb6</span>;</span><br><span class="line">  <span class="attr">--fps-border</span>: <span class="built_in">rgba</span>(<span class="number">192</span>,<span class="number">219</span>,<span class="number">232</span>,.<span class="number">16</span>); <span class="attr">--fps-good</span>: <span class="number">#75d2c5</span>; <span class="attr">--fps-warn</span>: <span class="number">#f0cb68</span>; <span class="attr">--fps-low</span>: <span class="number">#ff8a95</span>;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-id">#fps</span><span class="selector-pseudo">:empty</span> &#123; <span class="attribute">visibility</span>: hidden; &#125;</span><br><span class="line"><span class="selector-id">#fps</span> <span class="selector-class">.fps-label</span> &#123; <span class="attribute">font-size</span>: <span class="number">10px</span>; <span class="attribute">letter-spacing</span>: .<span class="number">6px</span>; <span class="attribute">color</span>: <span class="built_in">var</span>(--fps-muted); &#125;</span><br><span class="line"><span class="selector-id">#fps</span> <span class="selector-class">.fps-value</span> &#123; <span class="attribute">min-width</span>: <span class="number">3ch</span>; <span class="attribute">margin</span>: <span class="number">0</span> <span class="number">6px</span>; <span class="attribute">font-family</span>: ui-monospace, SFMono-Regular, Consolas, monospace; <span class="attribute">font-variant-numeric</span>: tabular-nums; <span class="attribute">font-weight</span>: <span class="number">600</span>; <span class="attribute">text-align</span>: right; &#125;</span><br><span class="line"><span class="selector-id">#fps</span> <span class="selector-class">.fps-state</span> &#123; <span class="attribute">min-width</span>: <span class="number">2.6em</span>; <span class="attribute">font-size</span>: <span class="number">12px</span>; &#125;</span><br><span class="line"><span class="selector-id">#fps</span> <span class="selector-class">.fps-state</span><span class="selector-pseudo">::before</span> &#123; <span class="attribute">content</span>: <span class="string">&quot;·&quot;</span>; <span class="attribute">margin-right</span>: <span class="number">5px</span>; <span class="attribute">color</span>: <span class="built_in">var</span>(--fps-muted); &#125;</span><br><span class="line"><span class="selector-id">#fps</span> <span class="selector-class">.fps-state</span><span class="selector-attr">[data-state=<span class="string">&quot;good&quot;</span>]</span> &#123; <span class="attribute">color</span>: <span class="built_in">var</span>(--fps-good); &#125;</span><br><span class="line"><span class="selector-id">#fps</span> <span class="selector-class">.fps-state</span><span class="selector-attr">[data-state=<span class="string">&quot;warn&quot;</span>]</span> &#123; <span class="attribute">color</span>: <span class="built_in">var</span>(--fps-warn); &#125;</span><br><span class="line"><span class="selector-id">#fps</span> <span class="selector-class">.fps-state</span><span class="selector-attr">[data-state=<span class="string">&quot;low&quot;</span>]</span>  &#123; <span class="attribute">color</span>: <span class="built_in">var</span>(--fps-low); &#125;</span><br><span class="line"><span class="keyword">@media</span> (<span class="attribute">max-width</span>: <span class="number">600px</span>) &#123;</span><br><span class="line">  <span class="selector-tag">html</span> <span class="selector-id">#fps</span>, <span class="selector-tag">html</span><span class="selector-attr">[data-theme]</span> <span class="selector-id">#fps</span> &#123; <span class="attribute">height</span>: <span class="number">28px</span>; <span class="attribute">padding</span>: <span class="number">0</span> <span class="number">8px</span>; <span class="attribute">border-radius</span>: <span class="number">8px</span>; &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：<code>inject.head</code> 加 <code>&lt;span id=&quot;fps&quot;&gt;&lt;/span&gt;</code> 容器、<code>inject.bottom</code> 加脚本，两句分别放进对应列表。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;span</span> <span class="string">id=&quot;fps&quot;&gt;&lt;/span&gt;</span> <span class="comment"># FPS 容器</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">src=&quot;/js/fps.js?v=1&quot;&gt;&lt;/script&gt;</span> <span class="comment"># FPS</span></span><br></pre></td></tr></table></figure><p>想随时开关：控制台执行 <code>fpsSwitch(false)</code> 关、<code>fpsSwitch(true)</code> 开，状态存在 <code>localStorage.fpson</code>；也可以接到美化设置面板里做一个开关行。</p>              </div>            </details><h1 id="wowjs-进场动画"><a href="#wowjs-进场动画" class="headerlink" title="wowjs 进场动画"></a>wowjs 进场动画</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：插件与 <code>CDN</code> 资源改为本地加载，动画时长与 <code>PJAX</code> 重载按本站流程调整。</p></blockquote><details class="folding-tag" blue><summary> 滚动入场动画 </summary>              <div class='content'>              <p>主题自带 wowjs 支持，用的是 <code>animate.css</code> + <code>wow.js</code>，给指定 class 的元素加滚动入场动画。</p><p>先装插件（它把配置项注册进 Butterfly）：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：安装 wowjs 插件（<code>wowjs:</code> 配置由它读取并注入页面）。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-butterfly-wowjs --save</span><br></pre></td></tr></table></figure><p><code>[Blogroot]\_config.butterfly.yml</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：新增顶层 <code>wowjs:</code> 段；<code>animateitem.class</code> 填元素自身的 class（不带点），想加多个就继续往列表里加 <code>- class/style</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">wowjs:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span>      <span class="comment"># 总开关</span></span><br><span class="line">  <span class="attr">priority:</span> <span class="number">10</span>      <span class="comment"># 过滤器优先级</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span>     <span class="comment"># 移动端是否启用（移动端本来就容易掉帧，建议关）</span></span><br><span class="line">  <span class="attr">animateitem:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">class:</span> <span class="string">recent-post-item</span>   <span class="comment"># 必填：要加动画的元素的 class</span></span><br><span class="line">      <span class="attr">style:</span> <span class="string">animate__zoomIn</span>    <span class="comment"># 必填：animate.css 的动画名</span></span><br><span class="line">      <span class="attr">duration:</span> <span class="string">1s</span>              <span class="comment"># 可选</span></span><br><span class="line">      <span class="attr">delay:</span> <span class="string">0ms</span>                <span class="comment"># 可选</span></span><br><span class="line">      <span class="attr">offset:</span> <span class="string">200px</span>             <span class="comment"># 可选：离视口多远开始播放</span></span><br><span class="line">      <span class="attr">iteration:</span> <span class="number">1</span>              <span class="comment"># 可选：播放次数</span></span><br><span class="line">  <span class="attr">animate_css:</span> <span class="string">https://npm.elemecdn.com/hexo-butterfly-wowjs/lib/animate.min.css</span></span><br><span class="line">  <span class="attr">wow_js:</span> <span class="string">https://npm.elemecdn.com/hexo-butterfly-wowjs/lib/wow.min.js</span></span><br><span class="line">  <span class="attr">wow_init_js:</span> <span class="string">https://npm.elemecdn.com/hexo-butterfly-wowjs/lib/wow_init.js</span></span><br></pre></td></tr></table></figure><p>几个注意点：</p><ul><li><code>animateitem</code> 的 <code>class</code> 填的是<strong>元素自身的 class</strong>，不用带点；首页卡片就是 <code>recent-post-item</code>。</li><li>开了 PJAX 的博客，切页后新内容不会自动重新 <code>new WOW().init()</code>。要么在 <code>pjax:complete</code> 里手动执行一次，要么只对首页这类会整页重载的页面开动画。</li><li>三条 CDN 都是 <code>npm.elemecdn.com</code>（国内可直连）。如果哪天访问慢，把三个文件下到 <code>source/css</code>、<code>source/js</code>，再改成本地路径即可——和「FontAwesome 图标本地化」那一节是同一套思路。</li></ul>              </div>            </details><h1 id="右键菜单（fomal-版）"><a href="#右键菜单（fomal-版）" class="headerlink" title="右键菜单（fomal 版）"></a>右键菜单（fomal 版）</h1><blockquote><p>原文作者：Fomalhaut（猕猴桃）　链接：<a href="https://www.fomal.cc/posts/d739261b.html">https://www.fomal.cc/posts/d739261b.html</a></p></blockquote><details class="folding-tag" blue><summary> 自定义右键菜单 </summary>              <div class='content'>              <p>默认右键菜单样式比较素，而且手机上长按会误触。换成 fomal 那套：圆形毛玻璃面板、图标 + 文字、滑入动画，顺带把「选择文字后复制/搜索」「粘贴」「回到顶部」「切换昼夜」「阅读模式」「打印」都收进来。</p><p>完整实现约 30KB，右键菜单 + 听话鼠标 + 下拉猫猫<strong>三合一放在同一个文件里</strong>，代码原样贴在下面（收在折叠块里，不需要时不用展开）。</p><p>先管放置和注入，代码在后面的代码块里。</p><p>把它放到 <code>[Blogroot]\source\js\fomal\cursor.js</code>，然后在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.bottom</code> 里<strong>排在 jQuery 之后</strong>：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject.bottom</code> 里把 <code>cursor.js</code> 排在 <code>jquery.min.js</code> 之后；同时把旧的 <code>rightmenu.js</code>、<code>cat.js</code> 两行注释掉，否则两套菜单会叠。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/jquery.min.js?v=1&quot;&gt;&lt;/script&gt;</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/fomal/cursor.js?v=1&quot;&gt;&lt;/script&gt;</span> <span class="comment">#右键菜单/鼠标特效</span></span><br></pre></td></tr></table></figure><p>原来的 <code>source\js\rightmenu.js</code>、<code>source\js\cat.js</code> 两个注入要注释掉，否则两套菜单叠在一起。</p><p>完整 <code>cursor.js</code>（新建 <code>[Blogroot]\source\js\fomal\cursor.js</code>，整段复制进去）：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/cursor.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；本站 <code>source/js/fomal/cursor.js</code> 已是这份三合一实现，跟着改时用已有文件对照，别新建第二份。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br><span class="line">84</span><br><span class="line">85</span><br><span class="line">86</span><br><span class="line">87</span><br><span class="line">88</span><br><span class="line">89</span><br><span class="line">90</span><br><span class="line">91</span><br><span class="line">92</span><br><span class="line">93</span><br><span class="line">94</span><br><span class="line">95</span><br><span class="line">96</span><br><span class="line">97</span><br><span class="line">98</span><br><span class="line">99</span><br><span class="line">100</span><br><span class="line">101</span><br><span class="line">102</span><br><span class="line">103</span><br><span class="line">104</span><br><span class="line">105</span><br><span class="line">106</span><br><span class="line">107</span><br><span class="line">108</span><br><span class="line">109</span><br><span class="line">110</span><br><span class="line">111</span><br><span class="line">112</span><br><span class="line">113</span><br><span class="line">114</span><br><span class="line">115</span><br><span class="line">116</span><br><span class="line">117</span><br><span class="line">118</span><br><span class="line">119</span><br><span class="line">120</span><br><span class="line">121</span><br><span class="line">122</span><br><span class="line">123</span><br><span class="line">124</span><br><span class="line">125</span><br><span class="line">126</span><br><span class="line">127</span><br><span class="line">128</span><br><span class="line">129</span><br><span class="line">130</span><br><span class="line">131</span><br><span class="line">132</span><br><span class="line">133</span><br><span class="line">134</span><br><span class="line">135</span><br><span class="line">136</span><br><span class="line">137</span><br><span class="line">138</span><br><span class="line">139</span><br><span class="line">140</span><br><span class="line">141</span><br><span class="line">142</span><br><span class="line">143</span><br><span class="line">144</span><br><span class="line">145</span><br><span class="line">146</span><br><span class="line">147</span><br><span class="line">148</span><br><span class="line">149</span><br><span class="line">150</span><br><span class="line">151</span><br><span class="line">152</span><br><span class="line">153</span><br><span class="line">154</span><br><span class="line">155</span><br><span class="line">156</span><br><span class="line">157</span><br><span class="line">158</span><br><span class="line">159</span><br><span class="line">160</span><br><span class="line">161</span><br><span class="line">162</span><br><span class="line">163</span><br><span class="line">164</span><br><span class="line">165</span><br><span class="line">166</span><br><span class="line">167</span><br><span class="line">168</span><br><span class="line">169</span><br><span class="line">170</span><br><span class="line">171</span><br><span class="line">172</span><br><span class="line">173</span><br><span class="line">174</span><br><span class="line">175</span><br><span class="line">176</span><br><span class="line">177</span><br><span class="line">178</span><br><span class="line">179</span><br><span class="line">180</span><br><span class="line">181</span><br><span class="line">182</span><br><span class="line">183</span><br><span class="line">184</span><br><span class="line">185</span><br><span class="line">186</span><br><span class="line">187</span><br><span class="line">188</span><br><span class="line">189</span><br><span class="line">190</span><br><span class="line">191</span><br><span class="line">192</span><br><span class="line">193</span><br><span class="line">194</span><br><span class="line">195</span><br><span class="line">196</span><br><span class="line">197</span><br><span class="line">198</span><br><span class="line">199</span><br><span class="line">200</span><br><span class="line">201</span><br><span class="line">202</span><br><span class="line">203</span><br><span class="line">204</span><br><span class="line">205</span><br><span class="line">206</span><br><span class="line">207</span><br><span class="line">208</span><br><span class="line">209</span><br><span class="line">210</span><br><span class="line">211</span><br><span class="line">212</span><br><span class="line">213</span><br><span class="line">214</span><br><span class="line">215</span><br><span class="line">216</span><br><span class="line">217</span><br><span class="line">218</span><br><span class="line">219</span><br><span class="line">220</span><br><span class="line">221</span><br><span class="line">222</span><br><span class="line">223</span><br><span class="line">224</span><br><span class="line">225</span><br><span class="line">226</span><br><span class="line">227</span><br><span class="line">228</span><br><span class="line">229</span><br><span class="line">230</span><br><span class="line">231</span><br><span class="line">232</span><br><span class="line">233</span><br><span class="line">234</span><br><span class="line">235</span><br><span class="line">236</span><br><span class="line">237</span><br><span class="line">238</span><br><span class="line">239</span><br><span class="line">240</span><br><span class="line">241</span><br><span class="line">242</span><br><span class="line">243</span><br><span class="line">244</span><br><span class="line">245</span><br><span class="line">246</span><br><span class="line">247</span><br><span class="line">248</span><br><span class="line">249</span><br><span class="line">250</span><br><span class="line">251</span><br><span class="line">252</span><br><span class="line">253</span><br><span class="line">254</span><br><span class="line">255</span><br><span class="line">256</span><br><span class="line">257</span><br><span class="line">258</span><br><span class="line">259</span><br><span class="line">260</span><br><span class="line">261</span><br><span class="line">262</span><br><span class="line">263</span><br><span class="line">264</span><br><span class="line">265</span><br><span class="line">266</span><br><span class="line">267</span><br><span class="line">268</span><br><span class="line">269</span><br><span class="line">270</span><br><span class="line">271</span><br><span class="line">272</span><br><span class="line">273</span><br><span class="line">274</span><br><span class="line">275</span><br><span class="line">276</span><br><span class="line">277</span><br><span class="line">278</span><br><span class="line">279</span><br><span class="line">280</span><br><span class="line">281</span><br><span class="line">282</span><br><span class="line">283</span><br><span class="line">284</span><br><span class="line">285</span><br><span class="line">286</span><br><span class="line">287</span><br><span class="line">288</span><br><span class="line">289</span><br><span class="line">290</span><br><span class="line">291</span><br><span class="line">292</span><br><span class="line">293</span><br><span class="line">294</span><br><span class="line">295</span><br><span class="line">296</span><br><span class="line">297</span><br><span class="line">298</span><br><span class="line">299</span><br><span class="line">300</span><br><span class="line">301</span><br><span class="line">302</span><br><span class="line">303</span><br><span class="line">304</span><br><span class="line">305</span><br><span class="line">306</span><br><span class="line">307</span><br><span class="line">308</span><br><span class="line">309</span><br><span class="line">310</span><br><span class="line">311</span><br><span class="line">312</span><br><span class="line">313</span><br><span class="line">314</span><br><span class="line">315</span><br><span class="line">316</span><br><span class="line">317</span><br><span class="line">318</span><br><span class="line">319</span><br><span class="line">320</span><br><span class="line">321</span><br><span class="line">322</span><br><span class="line">323</span><br><span class="line">324</span><br><span class="line">325</span><br><span class="line">326</span><br><span class="line">327</span><br><span class="line">328</span><br><span class="line">329</span><br><span class="line">330</span><br><span class="line">331</span><br><span class="line">332</span><br><span class="line">333</span><br><span class="line">334</span><br><span class="line">335</span><br><span class="line">336</span><br><span class="line">337</span><br><span class="line">338</span><br><span class="line">339</span><br><span class="line">340</span><br><span class="line">341</span><br><span class="line">342</span><br><span class="line">343</span><br><span class="line">344</span><br><span class="line">345</span><br><span class="line">346</span><br><span class="line">347</span><br><span class="line">348</span><br><span class="line">349</span><br><span class="line">350</span><br><span class="line">351</span><br><span class="line">352</span><br><span class="line">353</span><br><span class="line">354</span><br><span class="line">355</span><br><span class="line">356</span><br><span class="line">357</span><br><span class="line">358</span><br><span class="line">359</span><br><span class="line">360</span><br><span class="line">361</span><br><span class="line">362</span><br><span class="line">363</span><br><span class="line">364</span><br><span class="line">365</span><br><span class="line">366</span><br><span class="line">367</span><br><span class="line">368</span><br><span class="line">369</span><br><span class="line">370</span><br><span class="line">371</span><br><span class="line">372</span><br><span class="line">373</span><br><span class="line">374</span><br><span class="line">375</span><br><span class="line">376</span><br><span class="line">377</span><br><span class="line">378</span><br><span class="line">379</span><br><span class="line">380</span><br><span class="line">381</span><br><span class="line">382</span><br><span class="line">383</span><br><span class="line">384</span><br><span class="line">385</span><br><span class="line">386</span><br><span class="line">387</span><br><span class="line">388</span><br><span class="line">389</span><br><span class="line">390</span><br><span class="line">391</span><br><span class="line">392</span><br><span class="line">393</span><br><span class="line">394</span><br><span class="line">395</span><br><span class="line">396</span><br><span class="line">397</span><br><span class="line">398</span><br><span class="line">399</span><br><span class="line">400</span><br><span class="line">401</span><br><span class="line">402</span><br><span class="line">403</span><br><span class="line">404</span><br><span class="line">405</span><br><span class="line">406</span><br><span class="line">407</span><br><span class="line">408</span><br><span class="line">409</span><br><span class="line">410</span><br><span class="line">411</span><br><span class="line">412</span><br><span class="line">413</span><br><span class="line">414</span><br><span class="line">415</span><br><span class="line">416</span><br><span class="line">417</span><br><span class="line">418</span><br><span class="line">419</span><br><span class="line">420</span><br><span class="line">421</span><br><span class="line">422</span><br><span class="line">423</span><br><span class="line">424</span><br><span class="line">425</span><br><span class="line">426</span><br><span class="line">427</span><br><span class="line">428</span><br><span class="line">429</span><br><span class="line">430</span><br><span class="line">431</span><br><span class="line">432</span><br><span class="line">433</span><br><span class="line">434</span><br><span class="line">435</span><br><span class="line">436</span><br><span class="line">437</span><br><span class="line">438</span><br><span class="line">439</span><br><span class="line">440</span><br><span class="line">441</span><br><span class="line">442</span><br><span class="line">443</span><br><span class="line">444</span><br><span class="line">445</span><br><span class="line">446</span><br><span class="line">447</span><br><span class="line">448</span><br><span class="line">449</span><br><span class="line">450</span><br><span class="line">451</span><br><span class="line">452</span><br><span class="line">453</span><br><span class="line">454</span><br><span class="line">455</span><br><span class="line">456</span><br><span class="line">457</span><br><span class="line">458</span><br><span class="line">459</span><br><span class="line">460</span><br><span class="line">461</span><br><span class="line">462</span><br><span class="line">463</span><br><span class="line">464</span><br><span class="line">465</span><br><span class="line">466</span><br><span class="line">467</span><br><span class="line">468</span><br><span class="line">469</span><br><span class="line">470</span><br><span class="line">471</span><br><span class="line">472</span><br><span class="line">473</span><br><span class="line">474</span><br><span class="line">475</span><br><span class="line">476</span><br><span class="line">477</span><br><span class="line">478</span><br><span class="line">479</span><br><span class="line">480</span><br><span class="line">481</span><br><span class="line">482</span><br><span class="line">483</span><br><span class="line">484</span><br><span class="line">485</span><br><span class="line">486</span><br><span class="line">487</span><br><span class="line">488</span><br><span class="line">489</span><br><span class="line">490</span><br><span class="line">491</span><br><span class="line">492</span><br><span class="line">493</span><br><span class="line">494</span><br><span class="line">495</span><br><span class="line">496</span><br><span class="line">497</span><br><span class="line">498</span><br><span class="line">499</span><br><span class="line">500</span><br><span class="line">501</span><br><span class="line">502</span><br><span class="line">503</span><br><span class="line">504</span><br><span class="line">505</span><br><span class="line">506</span><br><span class="line">507</span><br><span class="line">508</span><br><span class="line">509</span><br><span class="line">510</span><br><span class="line">511</span><br><span class="line">512</span><br><span class="line">513</span><br><span class="line">514</span><br><span class="line">515</span><br><span class="line">516</span><br><span class="line">517</span><br><span class="line">518</span><br><span class="line">519</span><br><span class="line">520</span><br><span class="line">521</span><br><span class="line">522</span><br><span class="line">523</span><br><span class="line">524</span><br><span class="line">525</span><br><span class="line">526</span><br><span class="line">527</span><br><span class="line">528</span><br><span class="line">529</span><br><span class="line">530</span><br><span class="line">531</span><br><span class="line">532</span><br><span class="line">533</span><br><span class="line">534</span><br><span class="line">535</span><br><span class="line">536</span><br><span class="line">537</span><br><span class="line">538</span><br><span class="line">539</span><br><span class="line">540</span><br><span class="line">541</span><br><span class="line">542</span><br><span class="line">543</span><br><span class="line">544</span><br><span class="line">545</span><br><span class="line">546</span><br><span class="line">547</span><br><span class="line">548</span><br><span class="line">549</span><br><span class="line">550</span><br><span class="line">551</span><br><span class="line">552</span><br><span class="line">553</span><br><span class="line">554</span><br><span class="line">555</span><br><span class="line">556</span><br><span class="line">557</span><br><span class="line">558</span><br><span class="line">559</span><br><span class="line">560</span><br><span class="line">561</span><br><span class="line">562</span><br><span class="line">563</span><br><span class="line">564</span><br><span class="line">565</span><br><span class="line">566</span><br><span class="line">567</span><br><span class="line">568</span><br><span class="line">569</span><br><span class="line">570</span><br><span class="line">571</span><br><span class="line">572</span><br><span class="line">573</span><br><span class="line">574</span><br><span class="line">575</span><br><span class="line">576</span><br><span class="line">577</span><br><span class="line">578</span><br><span class="line">579</span><br><span class="line">580</span><br><span class="line">581</span><br><span class="line">582</span><br><span class="line">583</span><br><span class="line">584</span><br><span class="line">585</span><br><span class="line">586</span><br><span class="line">587</span><br><span class="line">588</span><br><span class="line">589</span><br><span class="line">590</span><br><span class="line">591</span><br><span class="line">592</span><br><span class="line">593</span><br><span class="line">594</span><br><span class="line">595</span><br><span class="line">596</span><br><span class="line">597</span><br><span class="line">598</span><br><span class="line">599</span><br><span class="line">600</span><br><span class="line">601</span><br><span class="line">602</span><br><span class="line">603</span><br><span class="line">604</span><br><span class="line">605</span><br><span class="line">606</span><br><span class="line">607</span><br><span class="line">608</span><br><span class="line">609</span><br><span class="line">610</span><br><span class="line">611</span><br><span class="line">612</span><br><span class="line">613</span><br><span class="line">614</span><br><span class="line">615</span><br><span class="line">616</span><br><span class="line">617</span><br><span class="line">618</span><br><span class="line">619</span><br><span class="line">620</span><br><span class="line">621</span><br><span class="line">622</span><br><span class="line">623</span><br><span class="line">624</span><br><span class="line">625</span><br><span class="line">626</span><br><span class="line">627</span><br><span class="line">628</span><br><span class="line">629</span><br><span class="line">630</span><br><span class="line">631</span><br><span class="line">632</span><br><span class="line">633</span><br><span class="line">634</span><br><span class="line">635</span><br><span class="line">636</span><br><span class="line">637</span><br><span class="line">638</span><br><span class="line">639</span><br><span class="line">640</span><br><span class="line">641</span><br><span class="line">642</span><br><span class="line">643</span><br><span class="line">644</span><br><span class="line">645</span><br><span class="line">646</span><br><span class="line">647</span><br><span class="line">648</span><br><span class="line">649</span><br><span class="line">650</span><br><span class="line">651</span><br><span class="line">652</span><br><span class="line">653</span><br><span class="line">654</span><br><span class="line">655</span><br><span class="line">656</span><br><span class="line">657</span><br><span class="line">658</span><br><span class="line">659</span><br><span class="line">660</span><br><span class="line">661</span><br><span class="line">662</span><br><span class="line">663</span><br><span class="line">664</span><br><span class="line">665</span><br><span class="line">666</span><br><span class="line">667</span><br><span class="line">668</span><br><span class="line">669</span><br><span class="line">670</span><br><span class="line">671</span><br><span class="line">672</span><br><span class="line">673</span><br><span class="line">674</span><br><span class="line">675</span><br><span class="line">676</span><br><span class="line">677</span><br><span class="line">678</span><br><span class="line">679</span><br><span class="line">680</span><br><span class="line">681</span><br><span class="line">682</span><br><span class="line">683</span><br><span class="line">684</span><br><span class="line">685</span><br><span class="line">686</span><br><span class="line">687</span><br><span class="line">688</span><br><span class="line">689</span><br><span class="line">690</span><br><span class="line">691</span><br><span class="line">692</span><br><span class="line">693</span><br><span class="line">694</span><br><span class="line">695</span><br><span class="line">696</span><br><span class="line">697</span><br><span class="line">698</span><br><span class="line">699</span><br><span class="line">700</span><br><span class="line">701</span><br><span class="line">702</span><br><span class="line">703</span><br><span class="line">704</span><br><span class="line">705</span><br><span class="line">706</span><br><span class="line">707</span><br><span class="line">708</span><br><span class="line">709</span><br><span class="line">710</span><br><span class="line">711</span><br><span class="line">712</span><br><span class="line">713</span><br><span class="line">714</span><br><span class="line">715</span><br><span class="line">716</span><br><span class="line">717</span><br><span class="line">718</span><br><span class="line">719</span><br><span class="line">720</span><br><span class="line">721</span><br><span class="line">722</span><br><span class="line">723</span><br><span class="line">724</span><br><span class="line">725</span><br><span class="line">726</span><br><span class="line">727</span><br><span class="line">728</span><br><span class="line">729</span><br><span class="line">730</span><br><span class="line">731</span><br><span class="line">732</span><br><span class="line">733</span><br><span class="line">734</span><br><span class="line">735</span><br><span class="line">736</span><br><span class="line">737</span><br><span class="line">738</span><br><span class="line">739</span><br><span class="line">740</span><br><span class="line">741</span><br><span class="line">742</span><br><span class="line">743</span><br><span class="line">744</span><br><span class="line">745</span><br><span class="line">746</span><br><span class="line">747</span><br><span class="line">748</span><br><span class="line">749</span><br><span class="line">750</span><br><span class="line">751</span><br><span class="line">752</span><br><span class="line">753</span><br><span class="line">754</span><br><span class="line">755</span><br><span class="line">756</span><br><span class="line">757</span><br><span class="line">758</span><br><span class="line">759</span><br><span class="line">760</span><br><span class="line">761</span><br><span class="line">762</span><br><span class="line">763</span><br><span class="line">764</span><br><span class="line">765</span><br><span class="line">766</span><br><span class="line">767</span><br><span class="line">768</span><br><span class="line">769</span><br><span class="line">770</span><br><span class="line">771</span><br><span class="line">772</span><br><span class="line">773</span><br><span class="line">774</span><br><span class="line">775</span><br><span class="line">776</span><br><span class="line">777</span><br><span class="line">778</span><br><span class="line">779</span><br><span class="line">780</span><br><span class="line">781</span><br><span class="line">782</span><br><span class="line">783</span><br><span class="line">784</span><br><span class="line">785</span><br><span class="line">786</span><br><span class="line">787</span><br><span class="line">788</span><br><span class="line">789</span><br><span class="line">790</span><br><span class="line">791</span><br><span class="line">792</span><br><span class="line">793</span><br><span class="line">794</span><br><span class="line">795</span><br><span class="line">796</span><br><span class="line">797</span><br><span class="line">798</span><br><span class="line">799</span><br><span class="line">800</span><br><span class="line">801</span><br><span class="line">802</span><br><span class="line">803</span><br><span class="line">804</span><br><span class="line">805</span><br><span class="line">806</span><br><span class="line">807</span><br><span class="line">808</span><br><span class="line">809</span><br><span class="line">810</span><br><span class="line">811</span><br><span class="line">812</span><br><span class="line">813</span><br><span class="line">814</span><br><span class="line">815</span><br><span class="line">816</span><br><span class="line">817</span><br><span class="line">818</span><br><span class="line">819</span><br><span class="line">820</span><br><span class="line">821</span><br><span class="line">822</span><br><span class="line">823</span><br><span class="line">824</span><br><span class="line">825</span><br><span class="line">826</span><br><span class="line">827</span><br><span class="line">828</span><br><span class="line">829</span><br><span class="line">830</span><br><span class="line">831</span><br><span class="line">832</span><br><span class="line">833</span><br><span class="line">834</span><br><span class="line">835</span><br><span class="line">836</span><br><span class="line">837</span><br><span class="line">838</span><br><span class="line">839</span><br><span class="line">840</span><br><span class="line">841</span><br><span class="line">842</span><br><span class="line">843</span><br><span class="line">844</span><br><span class="line">845</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* ============================================================================</span></span><br><span class="line"><span class="comment"> * modules/cursor.js —— 鼠标相关：右键菜单 / 小猫咪 / 听话鼠标</span></span><br><span class="line"><span class="comment"> * ----------------------------------------------------------------------------</span></span><br><span class="line"><span class="comment"> * 本文件由 source/js/fomal.js 拆出（2026-10-03 屎山重构）。</span></span><br><span class="line"><span class="comment"> * 【重要】这里故意不套 IIFE：主题 pug 模板里有大量内联 onclick=&quot;xxx()&quot;，</span></span><br><span class="line"><span class="comment"> *        以及别的脚本会直接调全局函数，所以本文件里的声明必须留在全局作用域。</span></span><br><span class="line"><span class="comment"> * ----------------------------------------------------------------------------</span></span><br><span class="line"><span class="comment"> * 包含的模块（括号内为拆分前在 fomal.js 里的行号）：</span></span><br><span class="line"><span class="comment"> *   · 小猫咪（529-752）—— 页面右下角跟着鼠标走的小猫 + 整点报时气泡（.neko）</span></span><br><span class="line"><span class="comment"> *   · 右键菜单（756-1063）—— 自定义右键菜单（rmf 对象是菜单项表，popupMenu 负责拼 HTML）</span></span><br><span class="line"><span class="comment"> *   · 听话鼠标（1337-1436）—— class Cursor：鼠标指针带缓动拖尾、hover 可点元素时变形</span></span><br><span class="line"><span class="comment"> * ----------------------------------------------------------------------------</span></span><br><span class="line"><span class="comment"> * 三个都跟&quot;指针&quot;有关，所以放一起；其实互相独立，可以单独删。</span></span><br><span class="line"><span class="comment"> * 加载方式：_config.fomalhaut.yml 的 inject.bottom 列表里以 &lt;script defer&gt; 引用。</span></span><br><span class="line"><span class="comment"> * ----------------------------------------------------------------------------</span></span><br><span class="line"><span class="comment"> * 【本文件目录】共 12 个顶层声明（行号可能随后续编辑漂移，找不到就 Ctrl+F 搜函数名）</span></span><br><span class="line"><span class="comment"> *    263  setMask()</span></span><br><span class="line"><span class="comment"> *    282  insertAtCursor(myField, myValue)</span></span><br><span class="line"><span class="comment"> *    314  rmf</span></span><br><span class="line"><span class="comment"> *    368  popupMenu()</span></span><br><span class="line"><span class="comment"> *    500  box</span></span><br><span class="line"><span class="comment"> *    502  addLongtabListener(target, callback)</span></span><br><span class="line"><span class="comment"> *    537  mouseMode</span></span><br><span class="line"><span class="comment"> *    538  changeMouseMode()</span></span><br><span class="line"><span class="comment"> *    574  CURSOR</span></span><br><span class="line"><span class="comment"> *    578  getStyle2</span></span><br><span class="line"><span class="comment"> *    588  map</span></span><br><span class="line"><span class="comment"> *    602  Cursor</span></span><br><span class="line"><span class="comment"> * ========================================================================== */</span></span><br><span class="line"></span><br><span class="line"><span class="comment">/* ------------------------------ 小猫咪 ------------------------------ */</span></span><br><span class="line"><span class="comment">// 独立于右键菜单 mouse 偏好；缺失的新设置默认开启，不重置旧设置。</span></span><br><span class="line"><span class="keyword">var</span> nekoEnabled = <span class="variable language_">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&#x27;nekoOn&#x27;</span>) !== <span class="string">&#x27;0&#x27;</span>;</span><br><span class="line"><span class="keyword">function</span> <span class="title function_">setNekoEnabled</span>(<span class="params">enabled</span>) &#123;</span><br><span class="line">  nekoEnabled = !!enabled;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;beauty-neko-off&#x27;</span>, !nekoEnabled);</span><br><span class="line">  <span class="keyword">if</span> (<span class="keyword">typeof</span> nekoState === <span class="string">&#x27;undefined&#x27;</span> || !nekoState) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">if</span> (!nekoEnabled) &#123;</span><br><span class="line">    <span class="keyword">if</span> (nekoState.<span class="property">raf</span> !== <span class="literal">null</span>) <span class="title function_">cancelAnimationFrame</span>(nekoState.<span class="property">raf</span>);</span><br><span class="line">    nekoState.<span class="property">raf</span> = <span class="literal">null</span>;</span><br><span class="line">    <span class="built_in">clearInterval</span>(<span class="variable language_">window</span>.<span class="property">__nekoClockTimer</span>);</span><br><span class="line">    <span class="variable language_">window</span>.<span class="property">__nekoClockTimer</span> = <span class="literal">null</span>;</span><br><span class="line">    nekoState.<span class="property">pointer</span> = <span class="literal">null</span>;</span><br><span class="line">    nekoState.<span class="property">rect</span> = <span class="literal">null</span>;</span><br><span class="line">    <span class="keyword">var</span> cat = <span class="title function_">nekoElement</span>();</span><br><span class="line">    <span class="title function_">nekoStyle</span>(cat, <span class="string">&#x27;display&#x27;</span>, <span class="string">&#x27;none&#x27;</span>);</span><br><span class="line">    <span class="title function_">nekoClass</span>(cat, <span class="string">&#x27;hoverOn&#x27;</span>, <span class="literal">false</span>);</span><br><span class="line">    <span class="title function_">nekoClass</span>(cat, <span class="string">&#x27;showMsg&#x27;</span>, <span class="literal">false</span>);</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">window</span>.<span class="property">__nekoClockTimer</span>) <span class="variable language_">window</span>.<span class="property">__nekoClockTimer</span> = <span class="built_in">setInterval</span>(nekoClockTick, <span class="number">1000</span>);</span><br><span class="line">    <span class="title function_">nekoClockTick</span>();</span><br><span class="line">    <span class="title function_">nekoQueue</span>(<span class="literal">true</span>, <span class="literal">true</span>);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="comment">/* 高频输入只记录最新值；统一在下一帧先读几何、再增量写入。 */</span></span><br><span class="line"><span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">body</span>.<span class="property">clientWidth</span> &gt; <span class="number">992</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> nekoState = &#123; <span class="attr">raf</span>: <span class="literal">null</span>, <span class="attr">geometryDirty</span>: <span class="literal">true</span>, <span class="attr">rectDirty</span>: <span class="literal">true</span>, <span class="attr">pointer</span>: <span class="literal">null</span>,</span><br><span class="line">    <span class="attr">cat</span>: <span class="literal">null</span>, <span class="attr">rope</span>: <span class="literal">null</span>, <span class="attr">rect</span>: <span class="literal">null</span>, <span class="attr">info</span>: <span class="literal">null</span>, <span class="attr">top</span>: <span class="literal">null</span>, <span class="attr">setting</span>: <span class="literal">null</span>, <span class="attr">styles</span>: <span class="keyword">new</span> <span class="title class_">WeakMap</span>() &#125;;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">getBasicInfo</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> <span class="title class_">ViewH</span> = $(<span class="variable language_">window</span>).<span class="title function_">height</span>();</span><br><span class="line">    <span class="keyword">var</span> <span class="title class_">DocH</span> = <span class="variable language_">document</span>.<span class="property">body</span>.<span class="property">scrollHeight</span>;</span><br><span class="line">    <span class="keyword">var</span> <span class="title class_">ScrollTop</span> = $(<span class="variable language_">window</span>).<span class="title function_">scrollTop</span>();</span><br><span class="line">    <span class="keyword">var</span> <span class="variable constant_">S_V</span> = <span class="title class_">Math</span>.<span class="title function_">max</span>(<span class="number">0</span>, <span class="title class_">DocH</span> - <span class="title class_">ViewH</span>);</span><br><span class="line">    <span class="keyword">return</span> &#123; <span class="title class_">ViewH</span>: <span class="title class_">ViewH</span>, <span class="title class_">DocH</span>: <span class="title class_">DocH</span>, <span class="title class_">ScrollTop</span>: <span class="title class_">ScrollTop</span>, <span class="attr">S_V</span>: <span class="variable constant_">S_V</span>,</span><br><span class="line">      <span class="title class_">Band</span><span class="attr">_H</span>: <span class="variable constant_">S_V</span> &gt; <span class="number">0</span> ? <span class="title class_">Math</span>.<span class="title function_">max</span>(<span class="number">0</span>, <span class="title class_">Math</span>.<span class="title function_">min</span>(<span class="number">100</span>, <span class="title class_">ScrollTop</span> / <span class="variable constant_">S_V</span> * <span class="number">100</span>)) : <span class="number">0</span> &#125;;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoElement</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!nekoState.<span class="property">cat</span> || !nekoState.<span class="property">cat</span>.<span class="property">isConnected</span>) &#123;</span><br><span class="line">      nekoState.<span class="property">cat</span> = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;.neko&#x27;</span>);</span><br><span class="line">      nekoState.<span class="property">rect</span> = <span class="literal">null</span>;</span><br><span class="line">      nekoState.<span class="property">rectDirty</span> = <span class="literal">true</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> nekoState.<span class="property">cat</span>;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoStyle</span>(<span class="params">el, name, value</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!el) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> values = nekoState.<span class="property">styles</span>.<span class="title function_">get</span>(el);</span><br><span class="line">    <span class="keyword">if</span> (!values) &#123; values = <span class="title class_">Object</span>.<span class="title function_">create</span>(<span class="literal">null</span>); nekoState.<span class="property">styles</span>.<span class="title function_">set</span>(el, values); &#125;</span><br><span class="line">    <span class="comment">// CSSOM 会规范化小数和单位，缓存目标值而不是反复比较序列化后的 style。</span></span><br><span class="line">    <span class="keyword">if</span> (values[name] === value) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">if</span> (el.<span class="property">style</span>[name] !== value) el.<span class="property">style</span>[name] = value;</span><br><span class="line">    values[name] = value;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoClass</span>(<span class="params">el, name, enabled</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (el &amp;&amp; el.<span class="property">classList</span>.<span class="title function_">contains</span>(name) !== enabled) el.<span class="property">classList</span>.<span class="title function_">toggle</span>(name, enabled);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">show</span>(<span class="params">basicInfo</span>) &#123;</span><br><span class="line">    <span class="title function_">nekoStyle</span>(<span class="title function_">nekoElement</span>(), <span class="string">&#x27;display&#x27;</span>, basicInfo.<span class="property">ScrollTop</span> &gt; <span class="number">0.001</span> ? <span class="string">&#x27;block&#x27;</span> : <span class="string">&#x27;none&#x27;</span>);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoTimeMsg</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> d = <span class="keyword">new</span> <span class="title class_">Date</span>();</span><br><span class="line">    <span class="keyword">var</span> pad = <span class="keyword">function</span> (<span class="params">n</span>) &#123; <span class="keyword">return</span> (n &lt; <span class="number">10</span> ? <span class="string">&#x27;0&#x27;</span> : <span class="string">&#x27;&#x27;</span>) + n; &#125;;</span><br><span class="line">    <span class="keyword">return</span> <span class="title function_">pad</span>(d.<span class="title function_">getHours</span>()) + <span class="string">&#x27;:&#x27;</span> + <span class="title function_">pad</span>(d.<span class="title function_">getMinutes</span>()) + <span class="string">&#x27;:&#x27;</span> + <span class="title function_">pad</span>(d.<span class="title function_">getSeconds</span>());</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoClockTick</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!nekoEnabled || <span class="variable language_">document</span>.<span class="property">hidden</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> cat = <span class="title function_">nekoElement</span>(), msg = <span class="title function_">nekoTimeMsg</span>();</span><br><span class="line">    <span class="keyword">if</span> (cat &amp;&amp; cat.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-msg&#x27;</span>) !== msg) cat.<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-msg&#x27;</span>, msg);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoQueue</span>(<span class="params">geometry, rect</span>) &#123;</span><br><span class="line">    nekoState.<span class="property">geometryDirty</span> = nekoState.<span class="property">geometryDirty</span> || !!geometry;</span><br><span class="line">    nekoState.<span class="property">rectDirty</span> = nekoState.<span class="property">rectDirty</span> || !!rect;</span><br><span class="line">    <span class="keyword">if</span> (!nekoEnabled || nekoState.<span class="property">raf</span> !== <span class="literal">null</span> || <span class="variable language_">document</span>.<span class="property">hidden</span>) <span class="keyword">return</span>;</span><br><span class="line">    nekoState.<span class="property">raf</span> = <span class="title function_">requestAnimationFrame</span>(nekoFlush);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoHoverTick</span>(<span class="params">clientX, clientY</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!nekoEnabled) <span class="keyword">return</span>;</span><br><span class="line">    nekoState.<span class="property">pointer</span> = &#123; <span class="attr">x</span>: clientX, <span class="attr">y</span>: clientY &#125;;</span><br><span class="line">    <span class="title function_">nekoQueue</span>(<span class="literal">false</span>, <span class="literal">false</span>);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoFlush</span>(<span class="params"></span>) &#123;</span><br><span class="line">    nekoState.<span class="property">raf</span> = <span class="literal">null</span>;</span><br><span class="line">    <span class="keyword">if</span> (!nekoEnabled || <span class="variable language_">document</span>.<span class="property">hidden</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> cat = <span class="title function_">nekoElement</span>(), setting = nekoState.<span class="property">setting</span>;</span><br><span class="line">    <span class="keyword">if</span> (!cat || !setting) <span class="keyword">return</span>;</span><br><span class="line">    <span class="comment">// 读阶段：mousemove 不重读 scrollHeight，也不每次重读猫咪矩形。</span></span><br><span class="line">    <span class="keyword">var</span> info = nekoState.<span class="property">geometryDirty</span> || !nekoState.<span class="property">info</span> ? <span class="title function_">getBasicInfo</span>() : nekoState.<span class="property">info</span>;</span><br><span class="line">    <span class="keyword">var</span> rect = nekoState.<span class="property">rect</span>;</span><br><span class="line">    <span class="keyword">if</span> (nekoState.<span class="property">rectDirty</span> &amp;&amp; cat.<span class="property">style</span>.<span class="property">display</span> === <span class="string">&#x27;block&#x27;</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> measured = cat.<span class="title function_">getBoundingClientRect</span>();</span><br><span class="line">      rect = &#123; <span class="attr">left</span>: measured.<span class="property">left</span>, <span class="attr">right</span>: measured.<span class="property">right</span>, <span class="attr">top</span>: measured.<span class="property">top</span>, <span class="attr">bottom</span>: measured.<span class="property">bottom</span> &#125;;</span><br><span class="line">      nekoState.<span class="property">rectDirty</span> = <span class="literal">false</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">var</span> height = info.<span class="property">Band_H</span> * setting.<span class="property">zoom</span> * info.<span class="property">ViewH</span> * <span class="number">0.01</span>;</span><br><span class="line">    <span class="keyword">var</span> top = height - <span class="number">50</span>;</span><br><span class="line">    <span class="keyword">if</span> (rect &amp;&amp; nekoState.<span class="property">top</span> !== <span class="literal">null</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> delta = top - nekoState.<span class="property">top</span>;</span><br><span class="line">      rect = &#123; <span class="attr">left</span>: rect.<span class="property">left</span>, <span class="attr">right</span>: rect.<span class="property">right</span>, <span class="attr">top</span>: rect.<span class="property">top</span> + delta, <span class="attr">bottom</span>: rect.<span class="property">bottom</span> + delta &#125;;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">var</span> visible = info.<span class="property">ScrollTop</span> &gt; <span class="number">0.001</span>;</span><br><span class="line">    <span class="keyword">var</span> p = nekoState.<span class="property">pointer</span>;</span><br><span class="line">    <span class="keyword">var</span> hover = !!(visible &amp;&amp; rect &amp;&amp; p &amp;&amp; p.<span class="property">x</span> &gt;= rect.<span class="property">left</span> &amp;&amp; p.<span class="property">x</span> &lt;= rect.<span class="property">right</span> &amp;&amp; p.<span class="property">y</span> &gt;= rect.<span class="property">top</span> &amp;&amp; p.<span class="property">y</span> &lt;= rect.<span class="property">bottom</span>);</span><br><span class="line">    <span class="comment">// 写阶段：静态样式只在插件初始化时写，滚动仅更新高度、位置和状态。</span></span><br><span class="line">    <span class="title function_">nekoStyle</span>(nekoState.<span class="property">rope</span>, <span class="string">&#x27;height&#x27;</span>, height + <span class="string">&#x27;px&#x27;</span>);</span><br><span class="line">    <span class="title function_">nekoStyle</span>(cat, <span class="string">&#x27;top&#x27;</span>, top + <span class="string">&#x27;px&#x27;</span>);</span><br><span class="line">    <span class="title function_">show</span>(info);</span><br><span class="line">    <span class="title function_">nekoClass</span>(cat, <span class="string">&#x27;showMsg&#x27;</span>, visible &amp;&amp; info.<span class="property">S_V</span> &gt; <span class="number">0</span> &amp;&amp; info.<span class="property">ScrollTop</span> &gt;= info.<span class="property">S_V</span> - <span class="number">1</span>);</span><br><span class="line">    <span class="title function_">nekoClass</span>(cat, <span class="string">&#x27;hoverOn&#x27;</span>, hover);</span><br><span class="line">    <span class="keyword">if</span> (hover) <span class="title function_">nekoClockTick</span>();</span><br><span class="line">    nekoState.<span class="property">info</span> = info;</span><br><span class="line">    nekoState.<span class="property">top</span> = top;</span><br><span class="line">    nekoState.<span class="property">rect</span> = visible ? rect : <span class="literal">null</span>;</span><br><span class="line">    nekoState.<span class="property">geometryDirty</span> = <span class="literal">false</span>;</span><br><span class="line">    <span class="comment">// 从 display:none 恢复后的真实 CSS 矩形在下一帧读，避免强制同步布局。</span></span><br><span class="line">    <span class="keyword">if</span> (visible &amp;&amp; !rect) <span class="title function_">nekoQueue</span>(<span class="literal">false</span>, <span class="literal">true</span>);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="title function_">setNekoEnabled</span>(nekoEnabled);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mousemove&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123; <span class="title function_">nekoHoverTick</span>(e.<span class="property">clientX</span>, e.<span class="property">clientY</span>); &#125;);</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;scroll&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">nekoQueue</span>(<span class="literal">true</span>, <span class="literal">false</span>); &#125;, &#123; <span class="attr">passive</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;resize&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">nekoQueue</span>(<span class="literal">true</span>, <span class="literal">true</span>); &#125;, &#123; <span class="attr">passive</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseout&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!e.<span class="property">relatedTarget</span>) &#123; nekoState.<span class="property">pointer</span> = <span class="literal">null</span>; <span class="title function_">nekoQueue</span>(<span class="literal">false</span>, <span class="literal">false</span>); &#125;</span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;visibilitychange&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">hidden</span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (nekoState.<span class="property">raf</span> !== <span class="literal">null</span>) <span class="title function_">cancelAnimationFrame</span>(nekoState.<span class="property">raf</span>);</span><br><span class="line">      nekoState.<span class="property">raf</span> = <span class="literal">null</span>;</span><br><span class="line">    &#125; <span class="keyword">else</span> &#123; <span class="title function_">nekoClockTick</span>(); <span class="title function_">nekoQueue</span>(<span class="literal">true</span>, <span class="literal">true</span>); &#125;</span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="title class_">ResizeObserver</span> !== <span class="string">&#x27;undefined&#x27;</span>) &#123;</span><br><span class="line">    nekoState.<span class="property">observer</span> = <span class="keyword">new</span> <span class="title class_">ResizeObserver</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">nekoQueue</span>(<span class="literal">true</span>, <span class="literal">true</span>); &#125;);</span><br><span class="line">    nekoState.<span class="property">observer</span>.<span class="title function_">observe</span>(<span class="variable language_">document</span>.<span class="property">body</span>);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="comment">// 猫咪不挡下方按钮；点击只有在下方没有控件时才回顶部。</span></span><br><span class="line">  <span class="keyword">var</span> nekoHitSelector = <span class="string">&quot;a, button, input, select, textarea, label, summary, [onclick], [role=&#x27;button&#x27;], [role=&#x27;link&#x27;], #rightside, .search-mask, .search-dialog, #local-search, .neko, #myscoll&quot;</span>;</span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">nekoToTop</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!nekoEnabled) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">btf</span> &amp;&amp; <span class="keyword">typeof</span> btf.<span class="property">scrollToDest</span> === <span class="string">&#x27;function&#x27;</span>) btf.<span class="title function_">scrollToDest</span>(<span class="number">0</span>, <span class="number">500</span>);</span><br><span class="line">    <span class="keyword">else</span> $(<span class="string">&#x27;html, body&#x27;</span>).<span class="title function_">animate</span>(&#123; <span class="attr">scrollTop</span>: <span class="number">0</span> &#125;, <span class="number">500</span>);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> cat = <span class="title function_">nekoElement</span>();</span><br><span class="line">    <span class="keyword">if</span> (!nekoEnabled || !cat || cat.<span class="property">style</span>.<span class="property">display</span> !== <span class="string">&#x27;block&#x27;</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> r = cat.<span class="title function_">getBoundingClientRect</span>();</span><br><span class="line">    <span class="keyword">if</span> (e.<span class="property">clientX</span> &lt; r.<span class="property">left</span> || e.<span class="property">clientX</span> &gt; r.<span class="property">right</span> || e.<span class="property">clientY</span> &lt; r.<span class="property">top</span> || e.<span class="property">clientY</span> &gt; r.<span class="property">bottom</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> hit = <span class="variable language_">document</span>.<span class="title function_">elementFromPoint</span>(e.<span class="property">clientX</span>, e.<span class="property">clientY</span>);</span><br><span class="line">    <span class="keyword">if</span> (hit &amp;&amp; $(hit).<span class="title function_">closest</span>(nekoHitSelector).<span class="property">length</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="title function_">nekoToTop</span>();</span><br><span class="line">  &#125;);</span><br><span class="line">  (<span class="keyword">function</span> (<span class="params">$</span>) &#123;</span><br><span class="line">    $.fn.<span class="property">nekoScroll</span> = <span class="keyword">function</span> (<span class="params">option</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> setting = $.<span class="title function_">extend</span>(&#123; <span class="attr">top</span>: <span class="string">&#x27;0&#x27;</span>, <span class="attr">scroWidth</span>: <span class="string">&#x27;6px&#x27;</span>, <span class="attr">z_index</span>: <span class="number">9999</span>, <span class="attr">zoom</span>: <span class="number">0.9</span>,</span><br><span class="line">        <span class="attr">borderRadius</span>: <span class="string">&#x27;5px&#x27;</span>, <span class="attr">right</span>: <span class="string">&#x27;55.6px&#x27;</span>,</span><br><span class="line">        <span class="attr">nekoImg</span>: <span class="string">&#x27;/img/neko.png&#x27;</span> &#125;, option);</span><br><span class="line">      <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">length</span>) <span class="keyword">return</span> <span class="variable language_">this</span>;</span><br><span class="line">      <span class="keyword">var</span> cat = <span class="title function_">nekoElement</span>();</span><br><span class="line">      <span class="keyword">if</span> (!cat) &#123;</span><br><span class="line">        cat = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">        cat.<span class="property">className</span> = <span class="string">&#x27;neko&#x27;</span>;</span><br><span class="line">        <span class="keyword">if</span> (setting.<span class="property">nekoname</span>) cat.<span class="property">id</span> = setting.<span class="property">nekoname</span>;</span><br><span class="line">        cat.<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-msg&#x27;</span>, <span class="title function_">nekoTimeMsg</span>());</span><br><span class="line">        <span class="variable language_">this</span>.<span class="title function_">after</span>(cat);</span><br><span class="line">      &#125;</span><br><span class="line">      nekoState.<span class="property">cat</span> = cat;</span><br><span class="line">      nekoState.<span class="property">rope</span> = <span class="variable language_">this</span>[<span class="number">0</span>];</span><br><span class="line">      nekoState.<span class="property">setting</span> = setting;</span><br><span class="line">      nekoState.<span class="property">styles</span> = <span class="keyword">new</span> <span class="title class_">WeakMap</span>();</span><br><span class="line">      nekoState.<span class="property">top</span> = <span class="title class_">Number</span>.<span class="built_in">isFinite</span>(<span class="built_in">parseFloat</span>(cat.<span class="property">style</span>.<span class="property">top</span>)) ? <span class="built_in">parseFloat</span>(cat.<span class="property">style</span>.<span class="property">top</span>) : <span class="literal">null</span>;</span><br><span class="line">      nekoState.<span class="property">rect</span> = <span class="literal">null</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">css</span>(&#123; <span class="attr">position</span>: <span class="string">&#x27;fixed&#x27;</span>, <span class="attr">width</span>: setting.<span class="property">scroWidth</span>, <span class="attr">top</span>: setting.<span class="property">top</span>,</span><br><span class="line">        <span class="string">&#x27;z-index&#x27;</span>: setting.<span class="property">z_index</span>, <span class="string">&#x27;background-color&#x27;</span>: setting.<span class="property">bgcolor</span>,</span><br><span class="line">        <span class="string">&#x27;border-radius&#x27;</span>: setting.<span class="property">borderRadius</span>, <span class="attr">right</span>: setting.<span class="property">right</span>,</span><br><span class="line">        <span class="string">&#x27;background-image&#x27;</span>: <span class="string">&#x27;-webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.1) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.1) 50%, rgba(255, 255, 255, 0.1) 75%, transparent 75%, transparent)&#x27;</span>,</span><br><span class="line">        <span class="string">&#x27;background-size&#x27;</span>: <span class="string">&#x27;contain&#x27;</span> &#125;);</span><br><span class="line">      $(cat).<span class="title function_">css</span>(&#123; <span class="attr">position</span>: <span class="string">&#x27;fixed&#x27;</span>, <span class="string">&#x27;z-index&#x27;</span>: setting.<span class="property">z_index</span> * <span class="number">10</span>,</span><br><span class="line">        <span class="attr">right</span>: setting.<span class="property">right</span>, <span class="string">&#x27;background-image&#x27;</span>: <span class="string">&#x27;url(&#x27;</span> + setting.<span class="property">nekoImg</span> + <span class="string">&#x27;)&#x27;</span> &#125;);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">off</span>(<span class="string">&#x27;click.nekoScroll&#x27;</span>).<span class="title function_">on</span>(<span class="string">&#x27;click.nekoScroll&#x27;</span>, nekoToTop);</span><br><span class="line">      $(cat).<span class="title function_">off</span>(<span class="string">&#x27;click.nekoScroll&#x27;</span>).<span class="title function_">on</span>(<span class="string">&#x27;click.nekoScroll&#x27;</span>, nekoToTop);</span><br><span class="line">      <span class="keyword">if</span> (!nekoEnabled) <span class="title function_">nekoStyle</span>(cat, <span class="string">&#x27;display&#x27;</span>, <span class="string">&#x27;none&#x27;</span>);</span><br><span class="line">      <span class="title function_">nekoQueue</span>(<span class="literal">true</span>, <span class="literal">true</span>);</span><br><span class="line">      <span class="keyword">return</span> <span class="variable language_">this</span>;</span><br><span class="line">    &#125;;</span><br><span class="line">  &#125;)(jQuery);</span><br><span class="line">  $(<span class="variable language_">document</span>).<span class="title function_">ready</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    $(<span class="string">&#x27;#myscoll&#x27;</span>).<span class="title function_">nekoScroll</span>(&#123; <span class="attr">bgcolor</span>: <span class="string">&#x27;rgb(0 0 0 / .5)&#x27;</span>, <span class="attr">borderRadius</span>: <span class="string">&#x27;2em&#x27;</span>, <span class="attr">zoom</span>: <span class="number">0.9</span> &#125;);</span><br><span class="line">    <span class="title function_">nekoClockTick</span>();</span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;pjax:complete&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    $(<span class="string">&#x27;#myscoll&#x27;</span>).<span class="title function_">nekoScroll</span>(nekoState.<span class="property">setting</span> || &#123;&#125;);</span><br><span class="line">    <span class="title function_">nekoClockTick</span>();</span><br><span class="line">    <span class="title function_">nekoQueue</span>(<span class="literal">true</span>, <span class="literal">true</span>);</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 小猫咪 end */</span></span><br><span class="line"></span><br><span class="line"><span class="comment">/* ------------------------------ 右键菜单 ------------------------------ */</span></span><br><span class="line"><span class="comment">/* 原 fomal.js 756-1063 行，原样搬运，未改逻辑 */</span></span><br><span class="line"><span class="comment">/* 右键菜单 start */</span></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">setMask</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="comment">//设置遮罩</span></span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="title function_">getElementsByClassName</span>(<span class="string">&quot;rmMask&quot;</span>)[<span class="number">0</span>] != <span class="literal">undefined</span>)</span><br><span class="line">    <span class="keyword">return</span> <span class="variable language_">document</span>.<span class="title function_">getElementsByClassName</span>(<span class="string">&quot;rmMask&quot;</span>)[<span class="number">0</span>];</span><br><span class="line">  mask = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">  mask.<span class="property">className</span> = <span class="string">&quot;rmMask&quot;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">width</span> = <span class="variable language_">window</span>.<span class="property">innerWidth</span> + <span class="string">&#x27;px&#x27;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">height</span> = <span class="variable language_">window</span>.<span class="property">innerHeight</span> + <span class="string">&#x27;px&#x27;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">background</span> = <span class="string">&#x27;#fff&#x27;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;.0&#x27;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">position</span> = <span class="string">&#x27;fixed&#x27;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">top</span> = <span class="string">&#x27;0&#x27;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">left</span> = <span class="string">&#x27;0&#x27;</span>;</span><br><span class="line">  mask.<span class="property">style</span>.<span class="property">zIndex</span> = <span class="number">998</span>;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(mask);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&quot;rightMenu&quot;</span>).<span class="property">style</span>.<span class="property">zIndex</span> = <span class="number">19198</span>;</span><br><span class="line">  <span class="keyword">return</span> mask;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">insertAtCursor</span>(<span class="params">myField, myValue</span>) &#123;</span><br><span class="line"></span><br><span class="line">  <span class="comment">//IE 浏览器</span></span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">selection</span>) &#123;</span><br><span class="line">    myField.<span class="title function_">focus</span>();</span><br><span class="line">    sel = <span class="variable language_">document</span>.<span class="property">selection</span>.<span class="title function_">createRange</span>();</span><br><span class="line">    sel.<span class="property">text</span> = myValue;</span><br><span class="line">    sel.<span class="title function_">select</span>();</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="comment">//FireFox、Chrome等</span></span><br><span class="line">  <span class="keyword">else</span> <span class="keyword">if</span> (myField.<span class="property">selectionStart</span> || myField.<span class="property">selectionStart</span> == <span class="string">&#x27;0&#x27;</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> startPos = myField.<span class="property">selectionStart</span>;</span><br><span class="line">    <span class="keyword">var</span> endPos = myField.<span class="property">selectionEnd</span>;</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 保存滚动条</span></span><br><span class="line">    <span class="keyword">var</span> restoreTop = myField.<span class="property">scrollTop</span>;</span><br><span class="line">    myField.<span class="property">value</span> = myField.<span class="property">value</span>.<span class="title function_">substring</span>(<span class="number">0</span>, startPos) + myValue + myField.<span class="property">value</span>.<span class="title function_">substring</span>(endPos, myField.<span class="property">value</span>.<span class="property">length</span>);</span><br><span class="line"></span><br><span class="line">    <span class="keyword">if</span> (restoreTop &gt; <span class="number">0</span>) &#123;</span><br><span class="line">      myField.<span class="property">scrollTop</span> = restoreTop;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    myField.<span class="title function_">focus</span>();</span><br><span class="line">    myField.<span class="property">selectionStart</span> = startPos + myValue.<span class="property">length</span>;</span><br><span class="line">    myField.<span class="property">selectionEnd</span> = startPos + myValue.<span class="property">length</span>;</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    myField.<span class="property">value</span> += myValue;</span><br><span class="line">    myField.<span class="title function_">focus</span>();</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">let</span> rmf = &#123;&#125;;</span><br><span class="line">rmf.<span class="property">showRightMenu</span> = <span class="keyword">function</span> (<span class="params">isTrue, x = <span class="number">0</span>, y = <span class="number">0</span></span>) &#123;</span><br><span class="line">  <span class="keyword">let</span> $rightMenu = $(<span class="string">&#x27;#rightMenu&#x27;</span>);</span><br><span class="line">  $rightMenu.<span class="title function_">css</span>(<span class="string">&#x27;top&#x27;</span>, x + <span class="string">&#x27;px&#x27;</span>).<span class="title function_">css</span>(<span class="string">&#x27;left&#x27;</span>, y + <span class="string">&#x27;px&#x27;</span>);</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (isTrue) &#123;</span><br><span class="line">    $rightMenu.<span class="title function_">show</span>();</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    $rightMenu.<span class="title function_">hide</span>();</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">rmf.<span class="property">copyWordsLink</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">let</span> url = <span class="variable language_">window</span>.<span class="property">location</span>.<span class="property">href</span></span><br><span class="line">  <span class="keyword">let</span> txa = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&quot;textarea&quot;</span>);</span><br><span class="line">  txa.<span class="property">value</span> = url;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(txa)</span><br><span class="line">  txa.<span class="title function_">select</span>();</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">execCommand</span>(<span class="string">&quot;Copy&quot;</span>);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">removeChild</span>(txa);</span><br><span class="line">&#125;</span><br><span class="line">rmf.<span class="property">switchReadMode</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">const</span> $body = <span class="variable language_">document</span>.<span class="property">body</span></span><br><span class="line">  $body.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;read-mode&#x27;</span>)</span><br><span class="line">  <span class="keyword">const</span> newEle = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;button&#x27;</span>)</span><br><span class="line">  newEle.<span class="property">type</span> = <span class="string">&#x27;button&#x27;</span></span><br><span class="line">  newEle.<span class="property">className</span> = <span class="string">&#x27;fas fa-sign-out-alt exit-readmode&#x27;</span></span><br><span class="line">  $body.<span class="title function_">appendChild</span>(newEle)</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">clickFn</span>(<span class="params"></span>) &#123;</span><br><span class="line">    $body.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;read-mode&#x27;</span>)</span><br><span class="line">    newEle.<span class="title function_">remove</span>()</span><br><span class="line">    newEle.<span class="title function_">removeEventListener</span>(<span class="string">&#x27;click&#x27;</span>, clickFn)</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  newEle.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, clickFn)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">//复制选中文字</span></span><br><span class="line">rmf.<span class="property">copySelect</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">execCommand</span>(<span class="string">&#x27;Copy&#x27;</span>, <span class="literal">false</span>, <span class="literal">null</span>);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">//回到顶部</span></span><br><span class="line">rmf.<span class="property">scrollToTop</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> menus = <span class="variable language_">document</span>.<span class="title function_">getElementsByClassName</span>(<span class="string">&quot;menus_items&quot;</span>);</span><br><span class="line">  <span class="keyword">if</span> (menus &amp;&amp; menus[<span class="number">1</span>]) menus[<span class="number">1</span>].<span class="title function_">setAttribute</span>(<span class="string">&quot;style&quot;</span>, <span class="string">&quot;&quot;</span>);</span><br><span class="line">  <span class="keyword">var</span> nameBox = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&quot;name-container&quot;</span>);</span><br><span class="line">  <span class="keyword">if</span> (nameBox) nameBox.<span class="title function_">setAttribute</span>(<span class="string">&quot;style&quot;</span>, <span class="string">&quot;display:none&quot;</span>);</span><br><span class="line">  <span class="keyword">var</span> mobileMask = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&quot;mobile-menu-mask&quot;</span>);</span><br><span class="line">  <span class="keyword">if</span> (mobileMask) mobileMask.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&quot;open&quot;</span>);</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">btf</span> &amp;&amp; <span class="keyword">typeof</span> btf.<span class="property">scrollToDest</span> === <span class="string">&quot;function&quot;</span>) &#123;</span><br><span class="line">    btf.<span class="title function_">scrollToDest</span>(<span class="number">0</span>, <span class="number">500</span>);</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    <span class="variable language_">window</span>.<span class="title function_">scrollTo</span>(&#123; <span class="attr">top</span>: <span class="number">0</span>, <span class="attr">behavior</span>: <span class="string">&quot;smooth&quot;</span> &#125;);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;touchmove&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line"></span><br><span class="line">&#125;, &#123; <span class="attr">passive</span>: <span class="literal">false</span> &#125;);</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">popupMenu</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="variable language_">window</span>.<span class="property">oncontextmenu</span> = <span class="keyword">function</span> (<span class="params">event</span>) &#123;</span><br><span class="line">    <span class="comment">// if (event.ctrlKey) return true;</span></span><br><span class="line"></span><br><span class="line">    <span class="comment">// 当关掉自定义右键时候直接返回</span></span><br><span class="line">    <span class="keyword">if</span> (mouseMode == <span class="string">&quot;off&quot;</span>) <span class="keyword">return</span> <span class="literal">true</span>;</span><br><span class="line"></span><br><span class="line">    $(<span class="string">&#x27;.rightMenu-group.hide&#x27;</span>).<span class="title function_">hide</span>();</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="title function_">getSelection</span>().<span class="title function_">toString</span>()) &#123;</span><br><span class="line">      $(<span class="string">&#x27;#menu-text&#x27;</span>).<span class="title function_">show</span>();</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;post&#x27;</span>)) &#123;</span><br><span class="line">      $(<span class="string">&#x27;#menu-post&#x27;</span>).<span class="title function_">show</span>();</span><br><span class="line">    &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;page&#x27;</span>)) &#123;</span><br><span class="line">        $(<span class="string">&#x27;#menu-post&#x27;</span>).<span class="title function_">show</span>();</span><br><span class="line">      &#125;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">var</span> el = <span class="variable language_">window</span>.<span class="property">document</span>.<span class="property">body</span>;</span><br><span class="line">    el = event.<span class="property">target</span>;</span><br><span class="line">    <span class="keyword">var</span> a = <span class="regexp">/^(?:http(s)?:\/\/)?[\w.-]+(?:\.[\w\.-]+)+[\w\-\._~:/?#[\]@!\$&amp;&#x27;\*\+,;=.]+$/</span></span><br><span class="line">    <span class="keyword">if</span> (a.<span class="title function_">test</span>(<span class="variable language_">window</span>.<span class="title function_">getSelection</span>().<span class="title function_">toString</span>()) &amp;&amp; el.<span class="property">tagName</span> != <span class="string">&quot;A&quot;</span>) &#123;</span><br><span class="line">      $(<span class="string">&#x27;#menu-too&#x27;</span>).<span class="title function_">show</span>()</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">if</span> (el.<span class="property">tagName</span> == <span class="string">&#x27;A&#x27;</span>) &#123;</span><br><span class="line">      $(<span class="string">&#x27;#menu-to&#x27;</span>).<span class="title function_">show</span>()</span><br><span class="line">      rmf.<span class="property">open</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        <span class="keyword">if</span> (el.<span class="property">href</span>.<span class="title function_">indexOf</span>(<span class="string">&quot;http://&quot;</span>) == -<span class="number">1</span> &amp;&amp; el.<span class="property">href</span>.<span class="title function_">indexOf</span>(<span class="string">&quot;https://&quot;</span>) == -<span class="number">1</span> || el.<span class="property">href</span>.<span class="title function_">indexOf</span>(<span class="string">&quot;yisous.xyz&quot;</span>) != -<span class="number">1</span>) &#123;</span><br><span class="line">          pjax.<span class="title function_">loadUrl</span>(el.<span class="property">href</span>)</span><br><span class="line">        &#125;</span><br><span class="line">        <span class="keyword">else</span> &#123;</span><br><span class="line">          location.<span class="property">href</span> = el.<span class="property">href</span></span><br><span class="line">        &#125;</span><br><span class="line">      &#125;</span><br><span class="line">      rmf.<span class="property">openWithNewTab</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        <span class="variable language_">window</span>.<span class="title function_">open</span>(el.<span class="property">href</span>);</span><br><span class="line">        <span class="comment">// window.location.reload();</span></span><br><span class="line">      &#125;</span><br><span class="line">      rmf.<span class="property">copyLink</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        <span class="keyword">let</span> url = el.<span class="property">href</span></span><br><span class="line">        <span class="keyword">let</span> txa = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&quot;textarea&quot;</span>);</span><br><span class="line">        txa.<span class="property">value</span> = url;</span><br><span class="line">        <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(txa)</span><br><span class="line">        txa.<span class="title function_">select</span>();</span><br><span class="line">        <span class="variable language_">document</span>.<span class="title function_">execCommand</span>(<span class="string">&quot;Copy&quot;</span>);</span><br><span class="line">        <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">removeChild</span>(txa);</span><br><span class="line">      &#125;</span><br><span class="line">    &#125; <span class="keyword">else</span> <span class="keyword">if</span> (el.<span class="property">tagName</span> == <span class="string">&#x27;IMG&#x27;</span>) &#123;</span><br><span class="line">      $(<span class="string">&#x27;#menu-img&#x27;</span>).<span class="title function_">show</span>()</span><br><span class="line">      rmf.<span class="property">openWithNewTab</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        <span class="variable language_">window</span>.<span class="title function_">open</span>(el.<span class="property">src</span>);</span><br><span class="line">        <span class="comment">// window.location.reload();</span></span><br><span class="line">      &#125;</span><br><span class="line">      rmf.<span class="property">click</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        el.<span class="title function_">click</span>()</span><br><span class="line">      &#125;</span><br><span class="line">      rmf.<span class="property">copyLink</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        <span class="keyword">let</span> url = el.<span class="property">src</span></span><br><span class="line">        <span class="keyword">let</span> txa = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&quot;textarea&quot;</span>);</span><br><span class="line">        txa.<span class="property">value</span> = url;</span><br><span class="line">        <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(txa)</span><br><span class="line">        txa.<span class="title function_">select</span>();</span><br><span class="line">        <span class="variable language_">document</span>.<span class="title function_">execCommand</span>(<span class="string">&quot;Copy&quot;</span>);</span><br><span class="line">        <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">removeChild</span>(txa);</span><br><span class="line">      &#125;</span><br><span class="line">      rmf.<span class="property">saveAs</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        <span class="keyword">var</span> a = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;a&#x27;</span>);</span><br><span class="line">        <span class="keyword">var</span> url = el.<span class="property">src</span>;</span><br><span class="line">        <span class="keyword">var</span> filename = url.<span class="title function_">split</span>(<span class="string">&quot;/&quot;</span>)[-<span class="number">1</span>];</span><br><span class="line">        a.<span class="property">href</span> = url;</span><br><span class="line">        a.<span class="property">download</span> = filename;</span><br><span class="line">        a.<span class="title function_">click</span>();</span><br><span class="line">        <span class="variable language_">window</span>.<span class="property">URL</span>.<span class="title function_">revokeObjectURL</span>(url);</span><br><span class="line">      &#125;</span><br><span class="line">    &#125; <span class="keyword">else</span> <span class="keyword">if</span> (el.<span class="property">tagName</span> == <span class="string">&quot;TEXTAREA&quot;</span> || el.<span class="property">tagName</span> == <span class="string">&quot;INPUT&quot;</span>) &#123;</span><br><span class="line">      $(<span class="string">&#x27;#menu-paste&#x27;</span>).<span class="title function_">show</span>();</span><br><span class="line">      rmf.<span class="property">paste</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        navigator.<span class="property">permissions</span></span><br><span class="line">          .<span class="title function_">query</span>(&#123;</span><br><span class="line">            <span class="attr">name</span>: <span class="string">&#x27;clipboard-read&#x27;</span></span><br><span class="line">          &#125;)</span><br><span class="line">          .<span class="title function_">then</span>(<span class="function"><span class="params">result</span> =&gt;</span> &#123;</span><br><span class="line">            <span class="keyword">if</span> (result.<span class="property">state</span> == <span class="string">&#x27;granted&#x27;</span> || result.<span class="property">state</span> == <span class="string">&#x27;prompt&#x27;</span>) &#123;</span><br><span class="line">              <span class="comment">//读取剪贴板</span></span><br><span class="line">              navigator.<span class="property">clipboard</span>.<span class="title function_">readText</span>().<span class="title function_">then</span>(<span class="function"><span class="params">text</span> =&gt;</span> &#123;</span><br><span class="line">                <span class="comment">// console.log(text)</span></span><br><span class="line">                <span class="title function_">insertAtCursor</span>(el, text)</span><br><span class="line">              &#125;)</span><br><span class="line">            &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">              <span class="title class_">Snackbar</span>.<span class="title function_">show</span>(&#123;</span><br><span class="line">                <span class="attr">text</span>: <span class="string">&#x27;请允许读取剪贴板！&#x27;</span>,</span><br><span class="line">                <span class="attr">pos</span>: <span class="string">&#x27;top-center&#x27;</span>,</span><br><span class="line">                <span class="attr">showAction</span>: <span class="literal">false</span>,</span><br><span class="line">              &#125;)</span><br><span class="line">            &#125;</span><br><span class="line">          &#125;)</span><br><span class="line">      &#125;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">let</span> pageX = event.<span class="property">clientX</span> + <span class="number">10</span>;</span><br><span class="line">    <span class="keyword">let</span> pageY = event.<span class="property">clientY</span>;</span><br><span class="line">    <span class="keyword">let</span> rmWidth = $(<span class="string">&#x27;#rightMenu&#x27;</span>).<span class="title function_">width</span>();</span><br><span class="line">    <span class="keyword">let</span> rmHeight = $(<span class="string">&#x27;#rightMenu&#x27;</span>).<span class="title function_">height</span>();</span><br><span class="line">    <span class="keyword">if</span> (pageX + rmWidth &gt; <span class="variable language_">window</span>.<span class="property">innerWidth</span>) &#123;</span><br><span class="line">      pageX -= rmWidth + <span class="number">10</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">if</span> (pageY + rmHeight &gt; <span class="variable language_">window</span>.<span class="property">innerHeight</span>) &#123;</span><br><span class="line">      pageY -= pageY + rmHeight - <span class="variable language_">window</span>.<span class="property">innerHeight</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    mask = <span class="title function_">setMask</span>();</span><br><span class="line">    <span class="comment">// 滚动消失的代码和阅读进度有冲突，因此放到readPercent.js里面了</span></span><br><span class="line">    $(<span class="string">&quot;.rightMenu-item&quot;</span>).<span class="title function_">click</span>(<span class="function">() =&gt;</span> &#123;</span><br><span class="line">      $(<span class="string">&#x27;.rmMask&#x27;</span>).<span class="title function_">attr</span>(<span class="string">&#x27;style&#x27;</span>, <span class="string">&#x27;display: none&#x27;</span>);</span><br><span class="line">    &#125;)</span><br><span class="line">    $(<span class="variable language_">window</span>).<span class="title function_">resize</span>(<span class="function">() =&gt;</span> &#123;</span><br><span class="line">      rmf.<span class="title function_">showRightMenu</span>(<span class="literal">false</span>);</span><br><span class="line">      $(<span class="string">&#x27;.rmMask&#x27;</span>).<span class="title function_">attr</span>(<span class="string">&#x27;style&#x27;</span>, <span class="string">&#x27;display: none&#x27;</span>);</span><br><span class="line">    &#125;)</span><br><span class="line">    mask.<span class="property">onclick</span> = <span class="function">() =&gt;</span> &#123;</span><br><span class="line">      $(<span class="string">&#x27;.rmMask&#x27;</span>).<span class="title function_">attr</span>(<span class="string">&#x27;style&#x27;</span>, <span class="string">&#x27;display: none&#x27;</span>);</span><br><span class="line">    &#125;</span><br><span class="line">    rmf.<span class="title function_">showRightMenu</span>(<span class="literal">true</span>, pageY, pageX);</span><br><span class="line">    $(<span class="string">&#x27;.rmMask&#x27;</span>).<span class="title function_">attr</span>(<span class="string">&#x27;style&#x27;</span>, <span class="string">&#x27;display: flex&#x27;</span>);</span><br><span class="line">    <span class="keyword">return</span> <span class="literal">false</span>;</span><br><span class="line">  &#125;;</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    rmf.<span class="title function_">showRightMenu</span>(<span class="literal">false</span>);</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">if</span> (!(navigator.<span class="property">userAgent</span>.<span class="title function_">match</span>(<span class="regexp">/(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone)/i</span>))) &#123;</span><br><span class="line">  <span class="title function_">popupMenu</span>()</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">const</span> box = <span class="variable language_">document</span>.<span class="property">documentElement</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">addLongtabListener</span>(<span class="params">target, callback</span>) &#123;</span><br><span class="line">  <span class="keyword">let</span> timer = <span class="number">0</span> <span class="comment">// 初始化timer</span></span><br><span class="line"></span><br><span class="line">  target.<span class="property">ontouchstart</span> = <span class="function">() =&gt;</span> &#123;</span><br><span class="line">    timer = <span class="number">0</span> <span class="comment">// 重置timer</span></span><br><span class="line">    timer = <span class="built_in">setTimeout</span>(<span class="function">() =&gt;</span> &#123;</span><br><span class="line">      <span class="title function_">callback</span>();</span><br><span class="line">      timer = <span class="number">0</span></span><br><span class="line">    &#125;, <span class="number">380</span>) <span class="comment">// 超时器能成功执行，说明是长按</span></span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  target.<span class="property">ontouchmove</span> = <span class="function">() =&gt;</span> &#123;</span><br><span class="line">    <span class="built_in">clearTimeout</span>(timer) <span class="comment">// 如果来到这里，说明是滑动</span></span><br><span class="line">    timer = <span class="number">0</span></span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  target.<span class="property">ontouchend</span> = <span class="function">() =&gt;</span> &#123; <span class="comment">// 到这里如果timer有值，说明此触摸时间不足380ms，是点击</span></span><br><span class="line">    <span class="keyword">if</span> (timer) &#123;</span><br><span class="line">      <span class="built_in">clearTimeout</span>(timer)</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="title function_">addLongtabListener</span>(box, popupMenu)</span><br><span class="line"></span><br><span class="line"><span class="comment">// 全屏</span></span><br><span class="line">rmf.<span class="property">fullScreen</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">fullscreenElement</span>) <span class="variable language_">document</span>.<span class="title function_">exitFullscreen</span>();</span><br><span class="line">  <span class="keyword">else</span> <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="title function_">requestFullscreen</span>();</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">// 右键开关</span></span><br><span class="line"><span class="keyword">if</span> (<span class="variable language_">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&quot;mouse&quot;</span>) == <span class="literal">undefined</span>) &#123;</span><br><span class="line">  <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&quot;mouse&quot;</span>, <span class="string">&quot;on&quot;</span>);</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">var</span> mouseMode = <span class="variable language_">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&quot;mouse&quot;</span>);</span><br><span class="line"><span class="keyword">function</span> <span class="title function_">changeMouseMode</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&quot;mouse&quot;</span>) == <span class="string">&quot;on&quot;</span>) &#123;</span><br><span class="line">    mouseMode = <span class="string">&quot;off&quot;</span>;</span><br><span class="line">    <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&quot;mouse&quot;</span>, <span class="string">&quot;off&quot;</span>);</span><br><span class="line">    <span class="title function_">debounce</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="title function_">fomalNotify</span>(&#123;</span><br><span class="line">            <span class="attr">title</span>: <span class="string">&quot;切换右键模式成功🍔&quot;</span>,</span><br><span class="line">            <span class="attr">message</span>: <span class="string">&quot;当前鼠标右键已恢复为系统默认！&quot;</span>,</span><br><span class="line">            <span class="attr">position</span>: <span class="string">&#x27;top-left&#x27;</span>,</span><br><span class="line">            <span class="attr">offset</span>: <span class="number">50</span>,</span><br><span class="line">            <span class="attr">showClose</span>: <span class="literal">true</span>,</span><br><span class="line">            <span class="attr">type</span>: <span class="string">&quot;success&quot;</span>,</span><br><span class="line">            <span class="attr">duration</span>: <span class="number">5000</span></span><br><span class="line">          &#125;)</span><br><span class="line">    &#125;, <span class="number">300</span>);</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    mouseMode = <span class="string">&quot;on&quot;</span>;</span><br><span class="line">    <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&quot;mouse&quot;</span>, <span class="string">&quot;on&quot;</span>);</span><br><span class="line">    <span class="title function_">debounce</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="title function_">fomalNotify</span>(&#123;</span><br><span class="line">            <span class="attr">title</span>: <span class="string">&quot;切换右键模式成功🍔&quot;</span>,</span><br><span class="line">            <span class="attr">message</span>: <span class="string">&quot;当前鼠标右键已更换为网站指定样式！&quot;</span>,</span><br><span class="line">            <span class="attr">position</span>: <span class="string">&#x27;top-left&#x27;</span>,</span><br><span class="line">            <span class="attr">offset</span>: <span class="number">50</span>,</span><br><span class="line">            <span class="attr">showClose</span>: <span class="literal">true</span>,</span><br><span class="line">            <span class="attr">type</span>: <span class="string">&quot;success&quot;</span>,</span><br><span class="line">            <span class="attr">duration</span>: <span class="number">5000</span></span><br><span class="line">          &#125;)</span><br><span class="line">    &#125;, <span class="number">300</span>);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="comment">/* 右键菜单 end */</span></span><br><span class="line"></span><br><span class="line"><span class="comment">/* ------------------------------ 听话鼠标 ------------------------------ */</span></span><br><span class="line"><span class="comment">/* 原 fomal.js 1337-1436 行；位移分层、目标按需识别、空闲停帧。 */</span></span><br><span class="line"><span class="comment">/* 听话鼠标 start */</span></span><br><span class="line"><span class="keyword">var</span> <span class="variable constant_">CURSOR</span>;</span><br><span class="line"></span><br><span class="line"><span class="title class_">Math</span>.<span class="property">lerp</span> = <span class="function">(<span class="params">a, b, n</span>) =&gt;</span> (<span class="number">1</span> - n) * a + n * b;</span><br><span class="line"></span><br><span class="line"><span class="keyword">const</span> <span class="title function_">getStyle2</span> = (<span class="params">el, attr</span>) =&gt; &#123;</span><br><span class="line">  <span class="keyword">try</span> &#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="variable language_">window</span>.<span class="property">getComputedStyle</span></span><br><span class="line">      ? <span class="variable language_">window</span>.<span class="title function_">getComputedStyle</span>(el)[attr]</span><br><span class="line">      : el.<span class="property">currentStyle</span>[attr];</span><br><span class="line">  &#125; <span class="keyword">catch</span> (e) &#123; &#125;</span><br><span class="line">  <span class="keyword">return</span> <span class="string">&quot;&quot;</span>;</span><br><span class="line">&#125;;</span><br><span class="line"></span><br><span class="line"><span class="comment">// 为了屏蔽异步加载导致无法读取颜色值，这里统一用哈希表预处理</span></span><br><span class="line"><span class="keyword">const</span> map = <span class="keyword">new</span> <span class="title class_">Map</span>();</span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;red&#x27;</span>, <span class="string">&quot;rgb(239, 90, 90)&quot;</span>); <span class="comment">// 珊瑚红 #EF5A5A</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;orange&#x27;</span>, <span class="string">&quot;rgb(215, 146, 77)&quot;</span>); <span class="comment">// 暖杏橙 #D7924D</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;yellow&#x27;</span>, <span class="string">&quot;rgb(196, 166, 74)&quot;</span>); <span class="comment">// 蜂蜜金 #C4A64A</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;green&#x27;</span>, <span class="string">&quot;rgb(57, 197, 187)&quot;</span>); <span class="comment">// 青绿 #39C5BB</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;puregreen&#x27;</span>, <span class="string">&quot;rgb(77, 175, 135)&quot;</span>); <span class="comment">// 玉石绿 #4DAF87</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;blue&#x27;</span>, <span class="string">&quot;rgb(74, 156, 199)&quot;</span>); <span class="comment">// 晴空蓝 #4A9CC7</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;heoblue&#x27;</span>, <span class="string">&quot;rgb(97, 106, 209)&quot;</span>); <span class="comment">// 柔靛蓝 #616AD1（2026-10-14：色相 224°→235°，与晴空蓝拉开）</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;matcha&#x27;</span>, <span class="string">&quot;rgb(102, 179, 77)&quot;</span>); <span class="comment">// 抹茶绿 #66B34D（2026-10-14 新增：补 80°–150° 黄绿档，色相 105°）</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;darkblue&#x27;</span>, <span class="string">&quot;rgb(113, 133, 156)&quot;</span>); <span class="comment">// 雾蓝灰 #71859C</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;purepurple&#x27;</span>, <span class="string">&quot;rgb(147, 90, 205)&quot;</span>); <span class="comment">// 紫罗兰 #935ACD</span></span><br><span class="line">map.<span class="title function_">set</span>(<span class="string">&#x27;pink&#x27;</span>, <span class="string">&quot;rgb(237, 112, 155)&quot;</span>); <span class="comment">// 樱花粉 #ED709B</span></span><br><span class="line"><span class="comment">// 下架的预设保留存储键迁移；首屏、鼠标与设置面板采用同一规则。</span></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">normalizeThemePreset</span>(<span class="params">c</span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (c === <span class="string">&#x27;purple&#x27;</span>) <span class="keyword">return</span> <span class="string">&#x27;purepurple&#x27;</span>;</span><br><span class="line">  <span class="keyword">if</span> (c === <span class="string">&#x27;gray&#x27;</span> || c === <span class="string">&#x27;black&#x27;</span>) <span class="keyword">return</span> <span class="string">&#x27;darkblue&#x27;</span>;</span><br><span class="line">  <span class="keyword">return</span> c;</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">class</span> <span class="title class_">Cursor</span> &#123;</span><br><span class="line">  <span class="title function_">constructor</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">enabled</span> = <span class="variable language_">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&#x27;cursorOn&#x27;</span>) !== <span class="string">&#x27;0&#x27;</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">pos</span> = &#123; <span class="attr">curr</span>: <span class="literal">null</span>, <span class="attr">prev</span>: <span class="literal">null</span> &#125;;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">pointerCache</span> = <span class="keyword">new</span> <span class="title class_">WeakMap</span>();</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">controlCache</span> = <span class="keyword">new</span> <span class="title class_">WeakMap</span>();</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">ancestorPointerCache</span> = <span class="keyword">new</span> <span class="title class_">WeakMap</span>();</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__raf</span> = <span class="literal">null</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__hoverDirty</span> = <span class="literal">false</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">create</span>();</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">init</span>();</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">move</span>(<span class="params">left, top</span>) &#123;</span><br><span class="line">    <span class="keyword">const</span> value = <span class="string">&#x27;translate3d(&#x27;</span> + left + <span class="string">&#x27;px, &#x27;</span> + top + <span class="string">&#x27;px, 0)&#x27;</span>;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">__transform</span> !== value) &#123;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">layer</span>.<span class="property">style</span>.<span class="property">transform</span> = value;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__transform</span> = value;</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">create</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">cursor</span>) &#123;</span><br><span class="line">      <span class="comment">// 位移与 #cursor.hover/active 的 scale 分层：保留原来的 16px 尺寸与 0.2s 缩放。</span></span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">layer</span> = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">layer</span>.<span class="property">id</span> = <span class="string">&#x27;cursor-position&#x27;</span>;</span><br><span class="line">      <span class="title class_">Object</span>.<span class="title function_">assign</span>(<span class="variable language_">this</span>.<span class="property">layer</span>.<span class="property">style</span>, &#123; <span class="attr">position</span>: <span class="string">&#x27;fixed&#x27;</span>, <span class="attr">left</span>: <span class="string">&#x27;0px&#x27;</span>, <span class="attr">top</span>: <span class="string">&#x27;0px&#x27;</span>,</span><br><span class="line">        <span class="attr">width</span>: <span class="string">&#x27;16px&#x27;</span>, <span class="attr">height</span>: <span class="string">&#x27;16px&#x27;</span>, <span class="attr">pointerEvents</span>: <span class="string">&#x27;none&#x27;</span>, <span class="attr">zIndex</span>: <span class="string">&#x27;10086&#x27;</span> &#125;);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">cursor</span> = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">cursor</span>.<span class="property">id</span> = <span class="string">&#x27;cursor&#x27;</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">cursor</span>.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;hidden&#x27;</span>);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">cursor</span>.<span class="property">style</span>.<span class="property">left</span> = <span class="string">&#x27;0px&#x27;</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">cursor</span>.<span class="property">style</span>.<span class="property">top</span> = <span class="string">&#x27;0px&#x27;</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">layer</span>.<span class="title function_">appendChild</span>(<span class="variable language_">this</span>.<span class="property">cursor</span>);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">layer</span>.<span class="property">isConnected</span>) <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(<span class="variable language_">this</span>.<span class="property">layer</span>);</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">scr</span>) <span class="variable language_">this</span>.<span class="property">scr</span> = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;style&#x27;</span>);</span><br><span class="line">    <span class="keyword">const</span> display = <span class="variable language_">this</span>.<span class="property">enabled</span> ? <span class="string">&#x27;&#x27;</span> : <span class="string">&#x27;none&#x27;</span>;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">layer</span>.<span class="property">style</span>.<span class="property">display</span> !== display) <span class="variable language_">this</span>.<span class="property">layer</span>.<span class="property">style</span>.<span class="property">display</span> = display;</span><br><span class="line">    <span class="comment">// 原地改样式，不移除；任何时候都不能露出文字区域的系统 I 形光标。</span></span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">scr</span>.<span class="property">isConnected</span>) <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(<span class="variable language_">this</span>.<span class="property">scr</span>);</span><br><span class="line">    <span class="keyword">const</span> color = map.<span class="title function_">get</span>(<span class="title function_">normalizeThemePreset</span>(<span class="variable language_">localStorage</span>.<span class="title function_">getItem</span>(<span class="string">&#x27;themeColor&#x27;</span>))) || map.<span class="title function_">get</span>(<span class="string">&#x27;green&#x27;</span>);</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">color</span> !== color) &#123;</span><br><span class="line">      <span class="keyword">const</span> svg = <span class="string">&#x27;&lt;svg xmlns=&quot;http://www.w3.org/2000/svg&quot; viewBox=&quot;0 0 8 8&quot; width=&quot;8px&quot; height=&quot;8px&quot;&gt;&lt;circle cx=&quot;4&quot; cy=&quot;4&quot; r=&quot;4&quot; fill=&quot;&#x27;</span> + color + <span class="string">&#x27;&quot;/&gt;&lt;/svg&gt;&#x27;</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">scr</span>.<span class="property">textContent</span> = <span class="string">&#x27;* &#123;cursor: url(&quot;data:image/svg+xml,&#x27;</span> + <span class="built_in">encodeURIComponent</span>(svg) + <span class="string">&#x27;&quot;) 4 4, auto&#125;&#x27;</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">color</span> = color;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="comment">// 插入/替换 CSS 文本会重新创建 CSSStyleSheet；必须最后设置 disabled。</span></span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">scr</span>.<span class="property">disabled</span> = !<span class="variable language_">this</span>.<span class="property">enabled</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">setClass</span>(<span class="params">name, enabled</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">cursor</span>.<span class="property">classList</span>.<span class="title function_">contains</span>(name) !== enabled) <span class="variable language_">this</span>.<span class="property">cursor</span>.<span class="property">classList</span>.<span class="title function_">toggle</span>(name, enabled);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">isPointer</span>(<span class="params">target</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (target &amp;&amp; target.<span class="property">nodeType</span> !== <span class="number">1</span>) target = target.<span class="property">parentElement</span>;</span><br><span class="line">    <span class="keyword">if</span> (!target || !target.<span class="property">isConnected</span>) <span class="keyword">return</span> <span class="literal">false</span>;</span><br><span class="line">    <span class="comment">// 控件身份与 CSS 结果分开缓存：子元素往返不再重复 closest / 祖先样式查询。</span></span><br><span class="line">    <span class="keyword">let</span> control = <span class="variable language_">this</span>.<span class="property">controlCache</span>.<span class="title function_">get</span>(target);</span><br><span class="line">    <span class="keyword">if</span> (control === <span class="literal">undefined</span>) &#123;</span><br><span class="line">      control = target.<span class="title function_">closest</span>(<span class="string">&#x27;a[href], button, summary, label, input[type=&quot;button&quot;], input[type=&quot;submit&quot;], input[type=&quot;reset&quot;], [onclick], [role=&quot;button&quot;], [role=&quot;link&quot;], .wb-control &gt; span&#x27;</span>);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">controlCache</span>.<span class="title function_">set</span>(target, control);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="comment">// WinBox 的标题栏按钮本来就是 cursor:pointer；标题和缩放边缘不走此快路径。</span></span><br><span class="line">    <span class="comment">// disabled 读当前值，不能把已禁用按钮的旧结果复用。</span></span><br><span class="line">    <span class="keyword">if</span> (control) <span class="keyword">return</span> !control.<span class="property">disabled</span>;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">pointerCache</span>.<span class="title function_">has</span>(target)) <span class="keyword">return</span> <span class="variable language_">this</span>.<span class="property">pointerCache</span>.<span class="title function_">get</span>(target);</span><br><span class="line">    <span class="keyword">let</span> pointer = <span class="literal">false</span>;</span><br><span class="line">    <span class="keyword">const</span> path = [];</span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">let</span> el = target; el; el = el.<span class="property">parentElement</span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">ancestorPointerCache</span>.<span class="title function_">has</span>(el)) &#123;</span><br><span class="line">        pointer = <span class="variable language_">this</span>.<span class="property">ancestorPointerCache</span>.<span class="title function_">get</span>(el);</span><br><span class="line">        <span class="keyword">break</span>;</span><br><span class="line">      &#125;</span><br><span class="line">      path.<span class="title function_">push</span>(el);</span><br><span class="line">      <span class="keyword">if</span> (<span class="title function_">getStyle2</span>(el, <span class="string">&#x27;cursor&#x27;</span>) === <span class="string">&#x27;pointer&#x27;</span>) &#123; pointer = <span class="literal">true</span>; <span class="keyword">break</span>; &#125;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="comment">// 保留原来的“任意祖先 pointer”语义；只在同一 hover / 样式版本共享祖先链。</span></span><br><span class="line">    <span class="keyword">for</span> (<span class="keyword">const</span> el <span class="keyword">of</span> path) <span class="variable language_">this</span>.<span class="property">ancestorPointerCache</span>.<span class="title function_">set</span>(el, pointer);</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">pointerCache</span>.<span class="title function_">set</span>(target, pointer);</span><br><span class="line">    <span class="keyword">return</span> pointer;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">invalidatePointer</span>(<span class="params">hitTest, clearCache = <span class="literal">true</span></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="comment">// 观察器可能在一帧内多次投递：这里只标脏，统一在 render 重建一次。</span></span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__pointerInvalid</span> = <span class="variable language_">this</span>.<span class="property">__pointerInvalid</span> || clearCache;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__hoverDirty</span> = <span class="literal">true</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__hitTest</span> = <span class="variable language_">this</span>.<span class="property">__hitTest</span> || !!hitTest;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span>) <span class="variable language_">this</span>.<span class="title function_">start</span>();</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">fpsOutputNode</span>(<span class="params">node</span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (node.<span class="property">nodeType</span> === <span class="number">3</span>) <span class="keyword">return</span> <span class="literal">true</span>;</span><br><span class="line">    <span class="keyword">if</span> (node.<span class="property">nodeType</span> !== <span class="number">1</span> || node.<span class="property">tagName</span> !== <span class="string">&#x27;SPAN&#x27;</span> || !node.<span class="property">getAttributeNames</span>) <span class="keyword">return</span> <span class="literal">false</span>;</span><br><span class="line">    <span class="keyword">if</span> (![...node.<span class="property">childNodes</span>].<span class="title function_">every</span>(<span class="function"><span class="params">child</span> =&gt;</span> child.<span class="property">nodeType</span> === <span class="number">3</span>)) <span class="keyword">return</span> <span class="literal">false</span>;</span><br><span class="line">    <span class="keyword">const</span> name = node.<span class="title function_">getAttribute</span>(<span class="string">&#x27;class&#x27;</span>);</span><br><span class="line">    <span class="keyword">const</span> attrs = node.<span class="title function_">getAttributeNames</span>().<span class="title function_">sort</span>().<span class="title function_">join</span>(<span class="string">&#x27;,&#x27;</span>);</span><br><span class="line">    <span class="keyword">if</span> (name === <span class="string">&#x27;fps-label&#x27;</span> || name === <span class="string">&#x27;fps-value&#x27;</span>) <span class="keyword">return</span> attrs === <span class="string">&#x27;class&#x27;</span>;</span><br><span class="line">    <span class="keyword">if</span> (name !== <span class="string">&#x27;fps-state&#x27;</span>) <span class="keyword">return</span> <span class="literal">false</span>;</span><br><span class="line">    <span class="keyword">if</span> (attrs === <span class="string">&#x27;class,data-state&#x27;</span>) <span class="keyword">return</span> <span class="regexp">/^(?:good|warn|low)$/</span>.<span class="title function_">test</span>(node.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-state&#x27;</span>) || <span class="string">&#x27;&#x27;</span>);</span><br><span class="line">    <span class="comment">// 兼容仍可能被缓存的旧版 reading.js：它给状态 span 内联写 color。</span></span><br><span class="line">    <span class="keyword">return</span> attrs === <span class="string">&#x27;class,style&#x27;</span> &amp;&amp;</span><br><span class="line">      <span class="regexp">/^\s*color\s*:\s*(?:#bd0000|red|orange|#9338e6|#08b7e4|#39c5bb)\s*;?\s*$/i</span>.<span class="title function_">test</span>(node.<span class="title function_">getAttribute</span>(<span class="string">&#x27;style&#x27;</span>));</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">pointerMutation</span>(<span class="params">record</span>) &#123;</span><br><span class="line">    <span class="keyword">const</span> target = record.<span class="property">target</span>;</span><br><span class="line">    <span class="keyword">if</span> (target === <span class="variable language_">this</span>.<span class="property">scr</span> || <span class="variable language_">this</span>.<span class="property">scr</span>.<span class="title function_">contains</span>(target) ||</span><br><span class="line">      target === <span class="variable language_">this</span>.<span class="property">layer</span> || <span class="variable language_">this</span>.<span class="property">layer</span>.<span class="title function_">contains</span>(target)) <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">    <span class="comment">// 精确排除已知纯装饰数据；不能泛化为忽略所有 class / style / 文本变化。</span></span><br><span class="line">    <span class="keyword">if</span> (record.<span class="property">type</span> === <span class="string">&#x27;attributes&#x27;</span> &amp;&amp; record.<span class="property">attributeName</span> === <span class="string">&#x27;data-msg&#x27;</span> &amp;&amp;</span><br><span class="line">      target.<span class="property">nodeType</span> === <span class="number">1</span> &amp;&amp; target.<span class="property">classList</span>.<span class="title function_">contains</span>(<span class="string">&#x27;neko&#x27;</span>)) <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">    <span class="keyword">const</span> element = target.<span class="property">nodeType</span> === <span class="number">1</span> ? target : target.<span class="property">parentElement</span>;</span><br><span class="line">    <span class="keyword">const</span> fps = element &amp;&amp; element.<span class="title function_">closest</span>(<span class="string">&#x27;#fps&#x27;</span>);</span><br><span class="line">    <span class="keyword">if</span> (fps) &#123;</span><br><span class="line">      <span class="keyword">if</span> (record.<span class="property">type</span> === <span class="string">&#x27;attributes&#x27;</span> &amp;&amp; record.<span class="property">attributeName</span> === <span class="string">&#x27;title&#x27;</span> &amp;&amp; target === fps) <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">      <span class="comment">// 只豁免计数器已知的纯文字 / 着色 span 输出，未知控件或重排仍全失效。</span></span><br><span class="line">      <span class="comment">// 输出宽度变化可能改变命中元素，因此仍需重查位置。</span></span><br><span class="line">      <span class="keyword">if</span> (record.<span class="property">type</span> === <span class="string">&#x27;childList&#x27;</span> &amp;&amp; target === fps &amp;&amp; record.<span class="property">addedNodes</span> &amp;&amp; record.<span class="property">removedNodes</span> &amp;&amp;</span><br><span class="line">        [...record.<span class="property">addedNodes</span>, ...record.<span class="property">removedNodes</span>].<span class="title function_">every</span>(<span class="function"><span class="params">node</span> =&gt;</span> <span class="variable language_">this</span>.<span class="title function_">fpsOutputNode</span>(node))) <span class="keyword">return</span> <span class="number">1</span>;</span><br><span class="line">      <span class="keyword">if</span> (record.<span class="property">type</span> === <span class="string">&#x27;characterData&#x27;</span> &amp;&amp; (element === fps ||</span><br><span class="line">        (element.<span class="property">parentElement</span> === fps &amp;&amp; <span class="variable language_">this</span>.<span class="title function_">fpsOutputNode</span>(element)))) <span class="keyword">return</span> <span class="number">1</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">2</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">refresh</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">create</span>();</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;active&#x27;</span>, <span class="literal">false</span>);</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">invalidatePointer</span>(<span class="literal">true</span>);</span><br><span class="line">    <span class="comment">// 不重绑事件、不重置位置、不创建第二条动画链；样式节点始终留在 DOM。</span></span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">setEnabled</span>(<span class="params">enabled</span>) &#123;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">enabled</span> = !!enabled;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">create</span>();</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span>) &#123;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">pause</span>();</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span> = <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span> = <span class="literal">null</span>;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">observer</span>) <span class="variable language_">this</span>.<span class="property">observer</span>.<span class="title function_">disconnect</span>();</span><br><span class="line">    &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">refresh</span>();</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">observe</span>();</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">observe</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">enabled</span> &amp;&amp; <span class="variable language_">this</span>.<span class="property">observer</span>) &#123;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">observer</span>.<span class="title function_">observe</span>(<span class="variable language_">document</span>.<span class="property">documentElement</span>, &#123; <span class="attr">subtree</span>: <span class="literal">true</span>, <span class="attr">childList</span>: <span class="literal">true</span>, <span class="attr">attributes</span>: <span class="literal">true</span>, <span class="attr">characterData</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">init</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">__bound</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__bound</span> = <span class="literal">true</span>;</span><br><span class="line">    <span class="keyword">const</span> <span class="title function_">trackTarget</span> = e =&gt; &#123;</span><br><span class="line">      <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span>) <span class="keyword">return</span>;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">target</span> !== e.<span class="property">target</span>) &#123;</span><br><span class="line">        <span class="variable language_">this</span>.<span class="property">target</span> = e.<span class="property">target</span>;</span><br><span class="line">        <span class="variable language_">this</span>.<span class="property">__styleInvalid</span> = <span class="literal">true</span>;</span><br><span class="line">        <span class="variable language_">this</span>.<span class="property">__hoverDirty</span> = <span class="literal">true</span>;</span><br><span class="line">      &#125;</span><br><span class="line">    &#125;;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mousemove&#x27;</span>, <span class="function"><span class="params">e</span> =&gt;</span> &#123;</span><br><span class="line">      <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span>) <span class="keyword">return</span>;</span><br><span class="line">      <span class="title function_">trackTarget</span>(e);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span> = &#123; <span class="attr">x</span>: e.<span class="property">clientX</span> - <span class="number">8</span>, <span class="attr">y</span>: e.<span class="property">clientY</span> - <span class="number">8</span> &#125;;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;hidden&#x27;</span>, <span class="literal">false</span>);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">start</span>();</span><br><span class="line">    &#125;, &#123; <span class="attr">passive</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseover&#x27;</span>, <span class="function"><span class="params">e</span> =&gt;</span> &#123;</span><br><span class="line">      <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span>) <span class="keyword">return</span>;</span><br><span class="line">      <span class="title function_">trackTarget</span>(e);</span><br><span class="line">      <span class="comment">// :hover / 兄弟选择器可能改变非语义区域的 cursor，下一帧更新 CSS 版本；</span></span><br><span class="line">      <span class="comment">// 控件身份缓存不受纯 hover 切换影响。</span></span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__styleInvalid</span> = <span class="literal">true</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__hoverDirty</span> = <span class="literal">true</span>;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span>) <span class="variable language_">this</span>.<span class="title function_">start</span>();</span><br><span class="line">    &#125;, &#123; <span class="attr">passive</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseout&#x27;</span>, <span class="function"><span class="params">e</span> =&gt;</span> &#123;</span><br><span class="line">      <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span>) <span class="keyword">return</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">target</span> = e.<span class="property">relatedTarget</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__styleInvalid</span> = <span class="literal">true</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__hoverDirty</span> = <span class="literal">true</span>;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span>) <span class="variable language_">this</span>.<span class="title function_">start</span>();</span><br><span class="line">    &#125;, &#123; <span class="attr">passive</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseenter&#x27;</span>, <span class="function">() =&gt;</span> &#123; <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">enabled</span> &amp;&amp; <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span>) <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;hidden&#x27;</span>, <span class="literal">false</span>); &#125;);</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseleave&#x27;</span>, <span class="function">() =&gt;</span> <span class="variable language_">this</span>.<span class="title function_">pause</span>());</span><br><span class="line">    <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;blur&#x27;</span>, <span class="function">() =&gt;</span> <span class="variable language_">this</span>.<span class="title function_">pause</span>());</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mousedown&#x27;</span>, <span class="function">() =&gt;</span> &#123; <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">enabled</span>) <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;active&#x27;</span>, <span class="literal">true</span>); &#125;);</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseup&#x27;</span>, <span class="function">() =&gt;</span> <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;active&#x27;</span>, <span class="literal">false</span>));</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;visibilitychange&#x27;</span>, <span class="function">() =&gt;</span> &#123; <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">hidden</span>) <span class="variable language_">this</span>.<span class="title function_">pause</span>(); &#125;);</span><br><span class="line">    <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;scroll&#x27;</span>, <span class="function">() =&gt;</span> <span class="variable language_">this</span>.<span class="title function_">invalidatePointer</span>(<span class="literal">true</span>), &#123; <span class="attr">passive</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">    <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;resize&#x27;</span>, <span class="function">() =&gt;</span> <span class="variable language_">this</span>.<span class="title function_">invalidatePointer</span>(<span class="literal">true</span>), &#123; <span class="attr">passive</span>: <span class="literal">true</span> &#125;);</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;pjax:complete&#x27;</span>, <span class="function">() =&gt;</span> <span class="variable language_">this</span>.<span class="title function_">refresh</span>());</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;load&#x27;</span>, <span class="function"><span class="params">e</span> =&gt;</span> &#123;</span><br><span class="line">      <span class="keyword">if</span> (e.<span class="property">target</span> &amp;&amp; e.<span class="property">target</span>.<span class="property">tagName</span> === <span class="string">&#x27;LINK&#x27;</span>) <span class="variable language_">this</span>.<span class="title function_">invalidatePointer</span>(<span class="literal">true</span>);</span><br><span class="line">    &#125;, <span class="literal">true</span>);</span><br><span class="line">    <span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="title class_">MutationObserver</span> !== <span class="string">&#x27;undefined&#x27;</span>) &#123;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">observer</span> = <span class="keyword">new</span> <span class="title class_">MutationObserver</span>(<span class="function"><span class="params">records</span> =&gt;</span> &#123;</span><br><span class="line">        <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span>) <span class="keyword">return</span>;</span><br><span class="line">        <span class="keyword">let</span> change = <span class="number">0</span>;</span><br><span class="line">        <span class="keyword">for</span> (<span class="keyword">const</span> record <span class="keyword">of</span> records) &#123;</span><br><span class="line">          change = <span class="title class_">Math</span>.<span class="title function_">max</span>(change, <span class="variable language_">this</span>.<span class="title function_">pointerMutation</span>(record));</span><br><span class="line">          <span class="keyword">if</span> (change === <span class="number">2</span>) <span class="keyword">break</span>;</span><br><span class="line">        &#125;</span><br><span class="line">        <span class="keyword">if</span> (change) <span class="variable language_">this</span>.<span class="title function_">invalidatePointer</span>(<span class="literal">true</span>, change === <span class="number">2</span>);</span><br><span class="line">      &#125;);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">observe</span>();</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">pause</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">__raf</span> !== <span class="literal">null</span>) <span class="title function_">cancelAnimationFrame</span>(<span class="variable language_">this</span>.<span class="property">__raf</span>);</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__raf</span> = <span class="literal">null</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;hidden&#x27;</span>, <span class="literal">true</span>);</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;active&#x27;</span>, <span class="literal">false</span>);</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;hover&#x27;</span>, <span class="literal">false</span>);</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">target</span> = <span class="literal">null</span>;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">start</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span> || <span class="variable language_">this</span>.<span class="property">__raf</span> !== <span class="literal">null</span> || <span class="variable language_">document</span>.<span class="property">hidden</span> || !<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span> || <span class="variable language_">this</span>.<span class="property">cursor</span>.<span class="property">classList</span>.<span class="title function_">contains</span>(<span class="string">&#x27;hidden&#x27;</span>)) <span class="keyword">return</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">__raf</span> = <span class="title function_">requestAnimationFrame</span>(<span class="function">() =&gt;</span> &#123; <span class="variable language_">this</span>.<span class="property">__raf</span> = <span class="literal">null</span>; <span class="variable language_">this</span>.<span class="title function_">render</span>(); &#125;);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">render</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">const</span> curr = <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">curr</span>;</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">enabled</span> || !curr || <span class="variable language_">document</span>.<span class="property">hidden</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="comment">// 样式读取必须在 transform / class 写入之前完成，且每帧只处理最后一个目标。</span></span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">__hoverDirty</span>) &#123;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">__hitTest</span>) &#123;</span><br><span class="line">        <span class="keyword">const</span> target = <span class="variable language_">document</span>.<span class="title function_">elementFromPoint</span>(curr.<span class="property">x</span> + <span class="number">8</span>, curr.<span class="property">y</span> + <span class="number">8</span>);</span><br><span class="line">        <span class="keyword">if</span> (target !== <span class="variable language_">this</span>.<span class="property">target</span>) <span class="variable language_">this</span>.<span class="property">__styleInvalid</span> = <span class="literal">true</span>;</span><br><span class="line">        <span class="variable language_">this</span>.<span class="property">target</span> = target;</span><br><span class="line">      &#125;</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">__pointerInvalid</span>) <span class="variable language_">this</span>.<span class="property">controlCache</span> = <span class="keyword">new</span> <span class="title class_">WeakMap</span>();</span><br><span class="line">      <span class="keyword">if</span> (<span class="variable language_">this</span>.<span class="property">__pointerInvalid</span> || <span class="variable language_">this</span>.<span class="property">__styleInvalid</span>) &#123;</span><br><span class="line">        <span class="variable language_">this</span>.<span class="property">pointerCache</span> = <span class="keyword">new</span> <span class="title class_">WeakMap</span>();</span><br><span class="line">        <span class="variable language_">this</span>.<span class="property">ancestorPointerCache</span> = <span class="keyword">new</span> <span class="title class_">WeakMap</span>();</span><br><span class="line">      &#125;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__pointerInvalid</span> = <span class="variable language_">this</span>.<span class="property">__styleInvalid</span> = <span class="literal">false</span>;</span><br><span class="line">      <span class="keyword">const</span> hover = <span class="variable language_">this</span>.<span class="title function_">isPointer</span>(<span class="variable language_">this</span>.<span class="property">target</span>);</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__hoverDirty</span> = <span class="literal">false</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="property">__hitTest</span> = <span class="literal">false</span>;</span><br><span class="line">      <span class="variable language_">this</span>.<span class="title function_">setClass</span>(<span class="string">&#x27;hover&#x27;</span>, hover);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">if</span> (!<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>) <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span> = &#123; <span class="attr">x</span>: curr.<span class="property">x</span>, <span class="attr">y</span>: curr.<span class="property">y</span> &#125;;</span><br><span class="line">    <span class="keyword">const</span> dx = curr.<span class="property">x</span> - <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">x</span>, dy = curr.<span class="property">y</span> - <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">y</span>;</span><br><span class="line">    <span class="keyword">const</span> moving = <span class="title class_">Math</span>.<span class="title function_">abs</span>(dx) &gt; <span class="number">0.1</span> || <span class="title class_">Math</span>.<span class="title function_">abs</span>(dy) &gt; <span class="number">0.1</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">x</span> = moving ? <span class="title class_">Math</span>.<span class="title function_">lerp</span>(<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">x</span>, curr.<span class="property">x</span>, <span class="number">0.15</span>) : curr.<span class="property">x</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">y</span> = moving ? <span class="title class_">Math</span>.<span class="title function_">lerp</span>(<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">y</span>, curr.<span class="property">y</span>, <span class="number">0.15</span>) : curr.<span class="property">y</span>;</span><br><span class="line">    <span class="variable language_">this</span>.<span class="title function_">move</span>(<span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">x</span>, <span class="variable language_">this</span>.<span class="property">pos</span>.<span class="property">prev</span>.<span class="property">y</span>);</span><br><span class="line">    <span class="keyword">if</span> (moving) <span class="variable language_">this</span>.<span class="title function_">start</span>();</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">(<span class="function">() =&gt;</span> &#123;</span><br><span class="line">  <span class="variable constant_">CURSOR</span> = <span class="keyword">new</span> <span class="title class_">Cursor</span>();</span><br><span class="line">&#125;)();</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 听话鼠标 end */</span></span><br></pre></td></tr></table></figure><p>菜单项在 <code>cursor.js</code> 的 <code>rightMenuItems</code> 数组里，可以直接改。三项常见修复（都是实际踩过的）：</p><ul><li><strong>回到顶部没反应</strong>：主题里 <code>rmf.scrollToTop</code> 先取 <code>#name-container</code> 再删动画 class，非文章页这个节点是 <code>null</code> 会抛错，后面 <code>btf.scrollToDest</code> 根本执行不到。加空值保护：</li></ul><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/cursor.js</code> ｜ <strong>改法</strong>：在 <code>rmf.scrollToTop()</code> 里用这两行替换原来直接操作 <code>#name-container</code> 的两行（取节点前先判空）。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> (el) el.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;name-container&#x27;</span>);</span><br><span class="line">btf.<span class="title function_">scrollToDest</span>(<span class="number">0</span>, <span class="number">500</span>);</span><br></pre></td></tr></table></figure><ul><li><strong>「美化设置」点了没反应</strong>：<code>[Blogroot]\themes\butterfly\layout\includes\rightmenu.pug</code> 里 <code>i.fas.fa-cog</code> 那两行被 <code>//-</code> 注释掉了，只剩一个空的 <code>&lt;a&gt;</code>。把缩进恢复即可。</li><li><strong>复制选中内容的链接</strong>：菜单里用 <code>rmf.copySelect()</code> 即可，选中为空时提前 <code>return</code>，否则会复制出一个空字符串。</li></ul>              </div>            </details><h1 id="右侧按钮回到顶部进度"><a href="#右侧按钮回到顶部进度" class="headerlink" title="右侧按钮回到顶部进度"></a>右侧按钮回到顶部进度</h1><blockquote><p>借鉴：Leonus（Fomalhaut 整理）。本站改动：在主题 <code>main.js</code> 里改为显示百分比，沿用本站右侧按钮样式。</p></blockquote><details class="folding-tag" blue><summary> 百分比回顶 </summary>              <div class='content'>              <p>点击右下角回到顶部按钮，按钮里显示当前阅读进度百分比（滚到 95% 以上隐藏），滚动时实时更新。</p><p><code>[Blogroot]\themes\butterfly\source\js\main.js</code> 里找到 <code>scrollPercentElement.textContent = scrollPercent</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/source/js/main.js</code> ｜ <strong>改法</strong>：找到 <code>scrollPercentElement.textContent = scrollPercent</code>（本站约在第 441 行），按「改后」整行替换；上面两行只是改前改后对照，不要一起粘进去。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">// 改前</span></span><br><span class="line">scrollPercentElement.<span class="property">textContent</span> = scrollPercent</span><br><span class="line"><span class="comment">// 改后</span></span><br><span class="line">scrollPercentElement.<span class="property">textContent</span> = scrollPercent + <span class="string">&#x27;%&#x27;</span></span><br></pre></td></tr></table></figure><p><code>[Blogroot]\themes\butterfly\layout\includes\rightside.pug</code> 的 <code>#go-up</code> 里已经有 <code>&lt;span class=&quot;scroll-percent&quot;&gt;</code>，不用改结构。</p><p><code>[Blogroot]\source\css\custom.css</code> 追加，让百分比和图标对齐：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#rightside</span> &gt; <span class="selector-tag">div</span> &gt; <span class="selector-tag">button</span> &gt; <span class="selector-tag">i</span>,</span><br><span class="line"><span class="selector-id">#rightside</span> &gt; <span class="selector-tag">div</span> &gt; <span class="selector-tag">a</span> &gt; <span class="selector-tag">i</span> &#123;</span><br><span class="line">  <span class="attribute">vertical-align</span>: middle;</span><br><span class="line">  <span class="attribute">line-height</span>: <span class="number">1</span>;</span><br><span class="line">  <span class="attribute">display</span>: inline-block;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-id">#rightside</span> <span class="selector-id">#go-up</span> <span class="selector-class">.scroll-percent</span> &#123;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">line-height</span>: <span class="number">35px</span>;</span><br><span class="line">  <span class="attribute">letter-spacing</span>: <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>默认 <code>#go-up</code> 是宽高 35px 的方块，<code>line-height: 35px</code> 让百分比纵向居中；数字用 <code>tabular-nums</code> 更稳（不想加也行，跳动不明显）。</p>              </div>            </details><h1 id="猫猫绳（下拉小猫）"><a href="#猫猫绳（下拉小猫）" class="headerlink" title="猫猫绳（下拉小猫）"></a>猫猫绳（下拉小猫）</h1><blockquote><p>借鉴：tzy 大佬（Fomalhaut 整理）。本站改动：与本站右键菜单合并进同一个 <code>cursor.js</code>，滚动阈值与位置重新调整。</p></blockquote><details class="folding-tag" blue><summary> 下拉小猫 </summary>              <div class='content'>              <p>页面往下滚之后，右上角会垂下来一只小猫（就是那根「猫猫绳」），点它会平滑滚回顶部。</p><p>它和右键菜单在<strong>同一个文件</strong>里（<code>[Blogroot]\source\js\fomal\cursor.js</code>），用的是 jQuery 插件的 <code>$.fn.nekoScroll</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/cursor.js</code> ｜ <strong>改法</strong>：替换 <code>$(document).ready(...)</code> 里 <code>$(&#39;#myscoll&#39;).nekoScroll({...})</code> 的参数；锚点 <code>#myscoll</code> 主题已自带（<code>themes/butterfly/layout/includes/head.pug</code> 里那个空 <code>#myscoll</code>，第 79 行），没有就自己在模板里补一个 <code>&lt;div id=&quot;myscoll&quot;&gt;&lt;/div&gt;</code>。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line">$(<span class="string">&#x27;#myscoll&#x27;</span>).<span class="title function_">nekoScroll</span>(&#123;</span><br><span class="line">  <span class="attr">top</span>: <span class="string">&#x27;0px&#x27;</span>,</span><br><span class="line">  <span class="attr">right</span>: <span class="string">&#x27;30px&#x27;</span>,</span><br><span class="line">  <span class="attr">width</span>: <span class="number">70</span>,</span><br><span class="line">  <span class="attr">height</span>: <span class="number">70</span>,</span><br><span class="line">  <span class="attr">nekoImg</span>: <span class="string">&#x27;/img/neko.png&#x27;</span></span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p>要点：</p><ul><li><strong>图片放本地</strong>：把小猫图存到 <code>[Blogroot]\source\img\neko.png</code>，<code>nekoImg</code> 写 <code>/img/neko.png</code>。直接引外链（图床）一旦挂掉，猫就没了。</li><li><strong>挂载点</strong>：需要一个 <code>#myscoll</code> 锚点（随便一个空 <code>div</code>），猫是插在它旁边的；锚点不存在就不显示。</li><li><strong>显示时机</strong>：<code>cursor.js</code> 里判断 <code>#myscoll</code> 在视口外、且 <code>scrollTop &gt; 0.001</code> 时才显示，回到页面顶部自动收起——避免一进首页就挂一只猫在右上角。</li><li>点击动作：<code>rmf.scrollToTop()</code>，和右键菜单里的「回到顶部」是同一个函数，所以上一节那个空值保护对它同样有效。</li></ul>              </div>            </details><h1 id="顶部缝隙：APlayer-标记元素把页面顶下去-10px"><a href="#顶部缝隙：APlayer-标记元素把页面顶下去-10px" class="headerlink" title="顶部缝隙：APlayer 标记元素把页面顶下去 10px"></a>顶部缝隙：APlayer 标记元素把页面顶下去 10px</h1><details class="folding-tag" blue><summary> 那条 10px 亮带 </summary>              <div class='content'>              <p>现象：导航栏上方有一条 10px 左右、比别处更亮的横带，像遮罩没盖到最顶上。换主题色、调遮罩深浅都没用——因为它根本不是遮罩的问题。</p><p>根因：APlayer 初始化时会在 <code>&lt;body&gt;</code> 里塞一个零高度的标记元素：</p><p><strong>说明</strong>：示意内容，不需要修改——这是 APlayer 初始化后 <code>body</code> 里实际出现的 DOM，用来对照现象。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="tag">&lt;<span class="name">div</span> <span class="attr">class</span>=<span class="string">&quot;aplayer aplayer-tag-marker&quot;</span>&gt;</span><span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br></pre></td></tr></table></figure><p>它是 <code>position: relative; height: 0</code>，但它带着 <code>margin-top: 5px; margin-bottom: 5px</code>。高度为 0 也有 margin，于是把后面所有兄弟元素（<code>#body-wrap</code>、<code>#sidebar</code>、<code>#nav</code> 的定位参照）整体往下推了 10px。</p><p><code>#page-header</code> 从 <code>y=10</code> 开始，而它的 <code>::before</code>（<code>--mark-bg</code> 那层遮罩）用的是 <code>height: 100%</code>，只会覆盖 header 自身那块区域，顶部这 10px 里露出来的是 <code>#web_bg</code> 的原图，没有遮罩 → 就是那条亮带。</p><p>验证方法（不用装任何工具）：在本地起服务后，同一个域下建个临时页面，用 iframe 载入首页，读 <code>body.children</code> 的布局：</p><p><strong>执行位置</strong>：浏览器 F12 控制台（在首页执行）｜ <strong>作用</strong>：打印「高度为 0 却带 margin」的元素，确认那条亮带的来源。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">// 简化版：在控制台对首页执行也一样</span></span><br><span class="line">[...<span class="variable language_">document</span>.<span class="property">body</span>.<span class="property">children</span>].<span class="title function_">forEach</span>(<span class="function">(<span class="params">el, i</span>) =&gt;</span> &#123;</span><br><span class="line">  <span class="keyword">const</span> s = <span class="title function_">getComputedStyle</span>(el);</span><br><span class="line">  <span class="keyword">if</span> (s.<span class="property">position</span> === <span class="string">&#x27;relative&#x27;</span> &amp;&amp; <span class="built_in">parseFloat</span>(s.<span class="property">height</span>) === <span class="number">0</span> &amp;&amp; s.<span class="property">marginTop</span> !== <span class="string">&#x27;0px&#x27;</span>) &#123;</span><br><span class="line">    <span class="variable language_">console</span>.<span class="title function_">log</span>(i, el.<span class="property">className</span>, <span class="string">&#x27;mt=&#x27;</span> + s.<span class="property">marginTop</span>, <span class="string">&#x27;h=&#x27;</span> + s.<span class="property">height</span>);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p>会打印出 <code>aplayer aplayer-tag-marker mt=5px h=0px</code>。再看 <code>#page-header</code> 的 <code>getBoundingClientRect().top</code> 是 <code>10</code> 而不是 <code>0</code>，就坐实了。</p><p>修法：把这个标记元素和同源的背景元素全部压成 0，<code>custom.css</code> 加一段</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* APlayer 注入的零高度标记元素带 5px 上下 margin，会把整页顶下 10px，遮罩就盖不到最顶上 */</span></span><br><span class="line"><span class="selector-tag">body</span> &gt; <span class="selector-class">.aplayer</span>,</span><br><span class="line"><span class="selector-tag">body</span> &gt; <span class="selector-class">.aplayer-tag-marker</span>,</span><br><span class="line"><span class="selector-tag">body</span> &gt; <span class="selector-id">#an_music_bg</span> &#123;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">line-height</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>修完之后 <code>#page-header</code> 的 <code>rect.top</code> 是 <code>0</code>，遮罩与 header 等高，亮带消失。</p><p>顺带提醒：判断「遮罩有没有生效」别只看颜色深浅，先量几何——<code>#page-header</code> 的 <code>top</code> 和 <code>::before</code> 的 <code>height</code> 是否一致，比肉眼靠谱。</p>              </div>            </details><h1 id="统一弹窗：一套卡片-最多-5-条"><a href="#统一弹窗：一套卡片-最多-5-条" class="headerlink" title="统一弹窗：一套卡片 + 最多 5 条"></a>统一弹窗：一套卡片 + 最多 5 条</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：把站内三套提示统一到 <code>fomalNotify</code>，最多 5 条并接入美化面板。</p></blockquote><details class="folding-tag" blue><summary> 把所有提示收进 fomalNotify </summary>              <div class='content'>              <p>站上原本有三套提示各说各话：美化面板用 <code>fomalNotify</code>，性能模式用自己的 <code>toast()</code>（位置在右上、样式也不同），昼夜切换走主题的 Vue <code>$notify</code> / snackbar。同一个站点三种弹窗，看着就很乱。</p><p>目标：所有提示都走 <code>[Blogroot]\source\js\fomal\notify.js</code> 里的 <code>fomalNotify()</code>，样式统一、位置统一，并且最多同时在屏幕上留 5 条。</p><p><code>fomalNotify</code> 的调用形式：</p><p><strong>说明</strong>：调用示例（怎么用），不需要改文件——按这个参数在任意脚本里调 <code>fomalNotify({...})</code> 就行。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="title function_">fomalNotify</span>(&#123;</span><br><span class="line">  <span class="attr">title</span>: <span class="string">&#x27;开灯啦🌞&#x27;</span>,</span><br><span class="line">  <span class="attr">message</span>: <span class="string">&#x27;当前已切换至白天模式&#x27;</span>,</span><br><span class="line">  <span class="attr">type</span>: <span class="string">&#x27;success&#x27;</span>,        <span class="comment">// success / info / warning / error</span></span><br><span class="line">  <span class="attr">position</span>: <span class="string">&#x27;top-left&#x27;</span>,   <span class="comment">// 也可以用 top-right</span></span><br><span class="line">  <span class="attr">offset</span>: <span class="number">50</span>,             <span class="comment">// 距视口边缘的像素</span></span><br><span class="line">  <span class="attr">showClose</span>: <span class="literal">true</span>,</span><br><span class="line">  <span class="attr">duration</span>: <span class="number">4000</span>          <span class="comment">// ms，0 表示不自动关</span></span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p><strong>加 5 条上限</strong>：在 <code>notify.js</code> 里维护一个存活列表，创建新卡片前先把超额的关掉。</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/notify.js</code> ｜ <strong>改法</strong>：在文件顶部（<code>fomalNotify</code> 定义之前）新增这两个声明和 <code>evictOldest()</code> 函数；本站这段已在第 92 行附近。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="variable constant_">MAX_LIVE</span> = <span class="number">5</span>;</span><br><span class="line"><span class="keyword">var</span> live = [];</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">evictOldest</span> () &#123;</span><br><span class="line">  <span class="keyword">while</span> (live.<span class="property">length</span> &gt;= <span class="variable constant_">MAX_LIVE</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> old = live.<span class="title function_">shift</span>();</span><br><span class="line">    <span class="keyword">if</span> (old &amp;&amp; old.<span class="property">close</span>) &#123;</span><br><span class="line">      <span class="keyword">try</span> &#123; old.<span class="title function_">close</span>(); &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>在 <code>wrap.appendChild(box)</code> 之前调 <code>evictOldest()</code>；<code>close()</code> 里要把自己从列表移除，否则列表只增不减：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/notify.js</code> ｜ <strong>改法</strong>：在已有的 <code>close()</code>（本站约第 130 行）开头补上「把自己从 <code>live</code> 里移除」这两行，后面的移除动画保持原样。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">close</span> () &#123;</span><br><span class="line">  <span class="keyword">var</span> idx = live.<span class="title function_">indexOf</span>(api);</span><br><span class="line">  <span class="keyword">if</span> (idx !== -<span class="number">1</span>) live.<span class="title function_">splice</span>(idx, <span class="number">1</span>);</span><br><span class="line">  <span class="comment">// ……原有的移除动画</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>最后把返回值和入列补上：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/notify.js</code> ｜ <strong>改法</strong>：在创建卡片的收尾处换成这三行——先在 <code>wrap.appendChild(box)</code> 之前调 <code>evictOldest()</code>，再 <code>live.push(api)</code> 并返回 <code>api</code>。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> api = &#123; <span class="attr">close</span>: close, <span class="attr">box</span>: box &#125;;</span><br><span class="line">live.<span class="title function_">push</span>(api);</span><br><span class="line"><span class="keyword">return</span> api;</span><br></pre></td></tr></table></figure><p><strong>暗色适配</strong>：卡片本身是浅色底，暗色主题下会白得刺眼，补一段</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.fomal-notify</span> &#123; <span class="attribute">background</span>: <span class="number">#252a35</span>; <span class="attribute">border-color</span>: <span class="number">#3a4150</span>; <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">4px</span> <span class="number">18px</span> <span class="number">0</span> <span class="built_in">rgba</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, .<span class="number">5</span>); &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.fomal-notify__title</span> &#123; <span class="attribute">color</span>: <span class="number">#e8ecf3</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.fomal-notify__content</span> &#123; <span class="attribute">color</span>: <span class="number">#b9c2cf</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.fomal-notify__close</span> &#123; <span class="attribute">color</span>: <span class="number">#8b95a5</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.fomal-notify__close</span><span class="selector-pseudo">:hover</span> &#123; <span class="attribute">color</span>: <span class="number">#e8ecf3</span>; &#125;</span><br></pre></td></tr></table></figure><p><strong>把主题自带的昼夜提示也收过来</strong>：<code>themes\butterfly\source\js\sun_moon.js</code> 的 <code>btfNightToast()</code> 最前面加一个优先分支（保留原来的 Vue / snackbar 兜底，主题更新后不至于报错）：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/source/js/sun_moon.js</code> ｜ <strong>改法</strong>：在 <code>btfNightToast()</code>（本站约第 47 行）函数体最前面插入这段优先分支，原来的 Vue / snackbar 兜底留在后面不要删。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">fomalNotify</span> === <span class="string">&#x27;function&#x27;</span>) &#123;</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">fomalNotify</span>(&#123;</span><br><span class="line">    <span class="attr">title</span>: title, <span class="attr">message</span>: message,</span><br><span class="line">    <span class="attr">position</span>: <span class="string">&#x27;top-left&#x27;</span>, <span class="attr">offset</span>: <span class="number">50</span>,</span><br><span class="line">    <span class="attr">showClose</span>: <span class="literal">true</span>, <span class="attr">type</span>: <span class="string">&#x27;success&#x27;</span>, <span class="attr">duration</span>: <span class="number">4000</span></span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="keyword">return</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><strong>统一位置与时长</strong>：把 <code>[Blogroot]\source\js\fomal\perf.js</code> 里的 <code>toast()</code> 从右上角挪到左上角，和面板保持一致</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/fomal/perf.js</code> ｜ <strong>改法</strong>：把 <code>toast()</code> 里 <code>position</code> / <code>offset</code> / <code>duration</code> 三个参数改成下面这行（本站已改成 <code>top-left</code>），上一行只是改前对照。</p><figure class="highlight javascript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">// 改前：position: &#x27;top-right&#x27;, offset: 60, duration: 5200</span></span><br><span class="line"><span class="attr">position</span>: <span class="string">&#x27;top-left&#x27;</span>, <span class="attr">offset</span>: <span class="number">50</span>, <span class="attr">duration</span>: <span class="number">4200</span></span><br></pre></td></tr></table></figure><p>验证：控制台连发 6 条带 <code>duration: 60000</code> 的提示，屏幕上应该只剩 5 条，且最早的两条（第 1、2 条）已被淘汰，剩下的是第 2 ~ 6 条；暗色下卡片是 <code>#252a35</code> 深灰底，不是白块。</p>              </div>            </details><h1 id="夜间霓虹灯字"><a href="#夜间霓虹灯字" class="headerlink" title="夜间霓虹灯字"></a>夜间霓虹灯字</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：配色接本站 <code>CSS</code> 变量，浅色模式强制关闭动画。</p></blockquote><details class="folding-tag" blue><summary> 九色呼吸光晕 </summary>              <div class='content'>              <p>思路：浅色模式完全不加动效；暗色模式下给站点标题、副标题、文章信息分别套一条 <code>text-shadow</code> 关键帧动画，让光晕颜色循环流动。</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">/* 浅色模式不要任何光晕 */</span></span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;light&quot;</span>]</span> <span class="selector-id">#site-name</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;light&quot;</span>]</span> <span class="selector-id">#site-title</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;light&quot;</span>]</span> <span class="selector-id">#site-subtitle</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;light&quot;</span>]</span> <span class="selector-id">#post-info</span> &#123;</span><br><span class="line">  <span class="attribute">animation</span>: none <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">/* 暗色模式：三档光晕半径 */</span></span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#site-name</span>,</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#site-title</span> &#123;</span><br><span class="line">  <span class="attribute">animation</span>: light_15px <span class="number">10s</span> linear infinite;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#site-subtitle</span> &#123;</span><br><span class="line">  <span class="attribute">animation</span>: light_10px <span class="number">10s</span> linear infinite;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#post-info</span> &#123;</span><br><span class="line">  <span class="attribute">animation</span>: light_5px <span class="number">10s</span> linear infinite;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>关键帧长这样，<code>0/12.5/25/37.5/43.75/62.5/75/87.5/100%</code> 各一个颜色：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：紧接上一段追加；<code>light_10px</code> / <code>light_5px</code> 按注释只改半径，颜色顺序保持一致。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@keyframes</span> light_15px &#123;</span><br><span class="line">  <span class="number">0%</span>   &#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#f1ee47</span>; &#125;</span><br><span class="line">  <span class="number">12.5%</span>&#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#11ee5e</span>; &#125;</span><br><span class="line">  <span class="number">25%</span>  &#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#00e4f5</span>; &#125;</span><br><span class="line">  <span class="number">37.5%</span>&#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#0051ff</span>; &#125;</span><br><span class="line">  <span class="number">43.75%</span>&#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#f1ee47</span>; &#125;</span><br><span class="line">  <span class="number">62.5%</span>&#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#b347f1</span>; &#125;</span><br><span class="line">  <span class="number">75%</span>  &#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#ff6a00</span>; &#125;</span><br><span class="line">  <span class="number">87.5%</span>&#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#ff2f92</span>; &#125;</span><br><span class="line">  <span class="number">100%</span> &#123; <span class="attribute">text-shadow</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">15px</span> <span class="number">#f1ee47</span>; &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="comment">/* light_10px / light_5px 只把 15px 换成 10px / 5px，颜色顺序一致 */</span></span><br></pre></td></tr></table></figure><p>两个容易踩的点：</p><ul><li><strong>颜色别重复写在同一个百分比</strong>：网上流传的版本里 <code>#f1ee47</code> 和 <code>#b347f1</code> 都写在 <code>50%</code>，后写的覆盖前写的，黄色实际上永远不出现。要么把黄色挪到 <code>43.75%</code>（本文做法），要么删掉一条。</li><li><strong>小档位的光晕半径要跟着改</strong>：<code>light_5px</code> 里漏改一处 <code>15px</code> 会让光晕在那一瞬间突然膨胀，看着一跳一跳的。</li></ul><p>无障碍兜底：系统开了「减少动效」就别闪了</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：再追加到末尾，放在霓虹灯规则之后。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">@media</span> (<span class="attribute">prefers-reduced-motion</span>: reduce) &#123;</span><br><span class="line">  <span class="selector-id">#site-name</span>, <span class="selector-id">#site-title</span>, <span class="selector-id">#site-subtitle</span>, <span class="selector-id">#post-info</span> &#123; <span class="attribute">animation</span>: none <span class="meta">!important</span>; &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>另外，如果站点开了「性能模式」这类一键降级，<strong>不要</strong>用 <code>html:not(.perf-lite)[data-theme=&quot;dark&quot;]</code> 这种前缀把它排除掉——两个元素的 <code>text-shadow</code> 动画几乎不花性能，但一旦被排除，很多人会开着性能模式却看不到效果，以为是没生效。</p>              </div>            </details><h1 id="Hexo-8-Butterfly-5-7-2-配置清单"><a href="#Hexo-8-Butterfly-5-7-2-配置清单" class="headerlink" title="Hexo 8 / Butterfly 5.7.2 配置清单"></a>Hexo 8 / Butterfly 5.7.2 配置清单</h1><details class="folding-tag" blue><summary> 大版本升级迁移 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\package.json</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/package.json</code> ｜ <strong>改法</strong>：在顶层对象里加 <code>&quot;engines&quot;</code> 键（这是一段对象片段，插进去时注意和前一项之间的逗号）。</p><figure class="highlight json"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">&quot;engines&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span> <span class="attr">&quot;node&quot;</span><span class="punctuation">:</span> <span class="string">&quot;&gt;=20.19.0&quot;</span> <span class="punctuation">&#125;</span></span><br></pre></td></tr></table></figure><p>执行：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：把 Hexo 固定到 8.1.2，然后清缓存重新生成，确认主题在新版本下能编过。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo@8.1.2 --save-exact</span><br><span class="line">hexo clean &amp;&amp; hexo g</span><br></pre></td></tr></table></figure><p><code>[Blogroot]\_config.butterfly.yml</code> 配置键映射：</p><p>| 4.x | 5.x |<br>| —- | —- |<br>| <code>local_search.enable: true</code> | <code>search.use: local_search</code> |<br>| <code>fancybox: true</code> / <code>medium_zoom</code> | <code>lightbox: fancybox</code> |<br>| <code>mathjax.enable: true</code> | <code>math.use: mathjax</code> |<br>| <code>sharejs.enable: true</code> | <code>share.use: sharejs</code> |<br>| <code>highlight_theme</code> 等 6 个键 | <code>code_blocks.theme / macStyle / copy / language / shrink / height_limit / word_wrap / fullpage</code> |<br>| <code>footer_bg</code> | <code>footer_img</code> |<br>| <code>footer.copyright: false</code> | <code>footer.copyright: { enable: false, version: false }</code> |<br>| <code>footer_beautify</code> 徽标文案 | <code>Hexo_v8.1.2</code> / <code>Butterfly_v5.7.2</code> |</p><p>连字符键改成下划线键：</p><p>| 4.x | 5.x |<br>| —- | —- |<br>| <code>font.global-font-size</code> | <code>font.global_font_size</code> |<br>| <code>font.code-font-size</code> | <code>font.code_font_size</code> |<br>| <code>font.font-family</code> | <code>font.font_family</code> |<br>| <code>font.code-font-family</code> | <code>font.code_font_family</code> |<br>| <code>beautify.title-prefix-icon</code> | <code>beautify.title_prefix_icon</code> |<br>| <code>beautify.title-prefix-icon-color</code> | <code>beautify.title_prefix_icon_color</code> |<br>| <code>hr_icon.icon-top</code> | <code>hr_icon.icon_top</code> |</p><p><code>background</code> 只填纯路径：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：顶层 <code>background:</code> 只填纯路径，不要写 <code>url(...)</code>，也不要带引号里的括号。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">background:</span> <span class="string">/img/bg.webp</span></span><br></pre></td></tr></table></figure><p><code>[Blogroot]\themes\butterfly\layout\includes\layout.pug</code> 补 <code>#footer-wrap</code>：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/layout.pug</code> ｜ <strong>改法</strong>：核对 <code>footer#footer</code> 下是否有这两层；5.7.2 已自带，只是确认，不要重复添加。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">footer#footer(style=footer_bg)</span><br><span class="line">  #footer-wrap</span><br><span class="line">    !=partial(&#x27;includes/footer&#x27;, &#123;&#125;, &#123;cache: true&#125;)</span><br></pre></td></tr></table></figure><p><code>[Blogroot]\themes\butterfly\layout\includes\layout.pug</code> 删掉 4.x 手加的 <code>third-party/search/index</code> 那行。<br>模板判断改成：</p><p><strong>文件</strong>：主题模板里 4.x 写成 <code>if page.type === &#39;post&#39;</code> / <code>is_post()</code> 的那类判断（例如 <code>themes/butterfly/layout/includes/header/nav.pug:8</code>）｜ <strong>改法</strong>：把条件换成 <code>if globalPageType === &#39;post&#39;</code>。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">if globalPageType === &#x27;post&#x27;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/page.pug</code>（本站约第 13 行）｜ <strong>改法</strong>：把页面标题的判断换成这两行，只有 <code>top_img === false</code> 的页面才渲染 <code>h1.page-title</code>。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">if top_img === false &amp;&amp; page.type != &#x27;music&#x27; &amp;&amp; page.title</span><br><span class="line">  h1.page-title= page.title</span><br></pre></td></tr></table></figure><p><code>[Blogroot]\themes\butterfly\source\js\sun_moon.js</code> 用 <code>btf.activateDarkMode()</code> / <code>btf.activateLightMode()</code> / <code>btf.saveToLocal.set(&#39;theme&#39;, mode, 2)</code>，代码见第二章第 11 项。<br><code>[Blogroot]\source\css\custom.css</code> 追加 5.x 双排适配，代码见本章第 28 项。<br>保持不动的挂载点：<code>#recent-posts</code>、<code>.sticky_layout</code>、<code>.recent-post-item</code>。<br>生成后检查：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：清缓存重新生成，下一步去 <code>public/</code> 里核对注入结果。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">hexo clean &amp;&amp; hexo g</span><br></pre></td></tr></table></figure><p>在 <code>public/index.html</code> 中确认存在：<code>footer-wrap</code>、<code>beian-row</code>、<code>rightMenu</code>、<code>main-hero-waves-area</code>、<code>loading-image-dot</code>、<code>recent-post-items</code>。</p>              </div>            </details><h1 id="改完怎么验证与部署"><a href="#改完怎么验证与部署" class="headerlink" title="改完怎么验证与部署"></a>改完怎么验证与部署</h1><p>改完不要直接往服务器扔，按顺序走一遍，出错能马上定位在哪一步：</p><ol><li><strong>生成</strong>。博客根目录终端执行 <code>hexo generate</code>。命令跑完没报 <code>FATAL</code> 才算过，<code>public/</code> 里会重新产出整站。</li><li><strong>本地预览</strong>。<code>hexo server</code>（默认 <code>http://localhost:4000</code>，端口被占就 <code>hexo s -p 4001</code>）。逐节点开对应页面：首页看磁贴、轮播、多栏和侧栏卡片，文章页看备案、右键菜单、猫猫绳和 FPS 药丸，评论页发一条测试评论。</li><li><strong>强制刷新 / 清缓存</strong>。改过 <code>source/css/</code>、<code>source/js/</code> 的话，把 <code>_config.butterfly.yml</code> 里 <code>inject</code> 对应行的 <code>?v=xxx</code> 版本号改一版（如 <code>?v=20261111a</code> 换成 <code>?v=20261111b</code>），再 Ctrl+F5 或开无痕窗口看；还不行就删掉 <code>public/</code>、<code>.deletions</code> 和浏览器里该站点的 Service Worker 缓存后重新生成。</li><li><strong>F12 查 404</strong>。Network 面板勾上 <code>404</code> 过滤、刷新一次，重点看 <code>/css/custom.css</code>、<code>/js/fomal/*.js</code>、<code>/css/brinks.css</code>、<code>/font/*.woff2</code>、<code>/webfonts/*</code>、<code>/img/*</code> 有没有红条——这些基本都是路径写错或文件没放进去。再看 Console，<code>fomalNotify</code>、<code>Cursor</code>、<code>fpsSwitch</code> 之类报 <code>undefined</code> 说明脚本没注入或顺序不对（脚本要排在 jQuery 之后）。</li><li><strong>按原托管方式上传</strong>。Nginx / 宝塔：把 <code>public/</code> 整个传上去；GitHub Pages：用 <code>_config.yml</code> 里的 <code>deploy: type: git</code> 再 <code>hexo deploy</code>；Vercel / Netlify：把仓库推上去，构建命令 <code>hexo generate</code>、输出目录 <code>public</code>，让它自动构建。上线后再强刷一次，确认线上版本号就是刚改的那版。</li></ol><div class="note info modern"><p>这篇已经把第 21 ~ 41 个魔改写完了，18544 字、阅读约 89 分钟，再往下堆就不好翻了。<br>后面新的魔改我会单独开一篇《hexo魔改教程（四）》，本篇不再追加——想跟更新的部分，从系列导航里找（四）就行。</p></div>]]>
    </content>
    <id>https://cookiesky.cn/2026/11/11/hexo-magic3/</id>
    <link href="https://cookiesky.cn/2026/11/11/hexo-magic3/"/>
    <published>2026-11-11T09:45:00.000Z</published>
    <summary>hexo魔改教程（三）</summary>
    <title>hexo魔改教程（三）</title>
    <updated>2026-11-22T17:12:15.681Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a><br>本篇是第 11 ~ 20 个魔改，适用 <code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code>。</li></ul></div><div class="note info modern"><p>阅读约定：每个代码块上方都标了 <strong>文件</strong> 和 <strong>改法</strong>。<code>[Blogroot]</code> 指博客根目录；「新建文件」是建好文件后整段写入，「追加到末尾」是放到文件最后，「替换」是在已有文件里改对应位置。配置片段都写清了是站点 <code>_config.yml</code> 还是主题 <code>_config.butterfly.yml</code>，照抄前先确认文件里有没有同名键。</p></div><h1 id="昼夜切换按钮（带日月动画）"><a href="#昼夜切换按钮（带日月动画）" class="headerlink" title="昼夜切换按钮（带日月动画）"></a>昼夜切换按钮（带日月动画）</h1><blockquote><p>借鉴：店长（Fomalhaut 整理）。本站改动：SVG 与切换逻辑并入本站主题注入，按钮样式按导航栏尺寸调整。</p></blockquote><details class="folding-tag" blue><summary> 昼夜切换按钮 </summary>              <div class='content'>              <p>新建 <code>[Blogroot]\themes\butterfly\layout\includes\custom\sun_moon.pug</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/custom/sun_moon.pug</code> ｜ <strong>改法</strong>：新建文件，整段写入；主题里若已有同名文件，用这段内容整体覆盖。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">svg(aria-hidden=&#x27;true&#x27;, style=&#x27;position:absolute; overflow:hidden; width:0; height:0&#x27;)</span><br><span class="line">  symbol#icon-sun(viewBox=&#x27;0 0 1024 1024&#x27;)</span><br><span class="line">    path(d=&#x27;M512 64l128 128h192v192l128 128-128 128v192h-192l-128 128-128-128H192V640L64 512l128-128V192h192zM512 288a224 224 0 1 0 0 448 224 224 0 0 0 0-448z&#x27;, fill=&#x27;#FFD878&#x27;)</span><br><span class="line">  symbol#icon-moon(viewBox=&#x27;0 0 1024 1024&#x27;)</span><br><span class="line">    path(d=&#x27;M611.37 167.08a445.01 445.01 0 0 1-38.4 161.83 477.82 477.82 0 0 1-244.74 244.4 445.14 445.14 0 0 1-161.11 38.06 85.08 85.08 0 0 0-65.07 135.72A462.08 462.08 0 1 0 747.09 102.06a85.08 85.08 0 0 0-135.72 65.02z&#x27;, fill=&#x27;#FFB531&#x27;)</span><br></pre></td></tr></table></figure><p>新建 <code>[Blogroot]\themes\butterfly\source\js\sun_moon.js</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/source/js/sun_moon.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；本主题自带同名文件时整体覆盖，不要两段并存。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br><span class="line">84</span><br><span class="line">85</span><br><span class="line">86</span><br><span class="line">87</span><br><span class="line">88</span><br><span class="line">89</span><br><span class="line">90</span><br><span class="line">91</span><br><span class="line">92</span><br><span class="line">93</span><br><span class="line">94</span><br><span class="line">95</span><br><span class="line">96</span><br><span class="line">97</span><br><span class="line">98</span><br><span class="line">99</span><br><span class="line">100</span><br><span class="line">101</span><br><span class="line">102</span><br><span class="line">103</span><br><span class="line">104</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">btfSwitchTheme</span>(<span class="params">toDark</span>) &#123;</span><br><span class="line">  <span class="keyword">const</span> mode = toDark ? <span class="string">&#x27;dark&#x27;</span> : <span class="string">&#x27;light&#x27;</span></span><br><span class="line">  <span class="keyword">const</span> btf = <span class="variable language_">window</span>.<span class="property">btf</span> || &#123;&#125;</span><br><span class="line">  <span class="keyword">const</span> activate = toDark</span><br><span class="line">    ? (btf.<span class="property">activateDarkMode</span> || <span class="variable language_">window</span>.<span class="property">activateDarkMode</span>)</span><br><span class="line">    : (btf.<span class="property">activateLightMode</span> || <span class="variable language_">window</span>.<span class="property">activateLightMode</span>)</span><br><span class="line"></span><br><span class="line">  <span class="keyword">if</span> (<span class="keyword">typeof</span> activate === <span class="string">&#x27;function&#x27;</span>) <span class="title function_">activate</span>()</span><br><span class="line">  <span class="keyword">else</span> <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="title function_">setAttribute</span>(<span class="string">&#x27;data-theme&#x27;</span>, mode)</span><br><span class="line"></span><br><span class="line">  <span class="keyword">const</span> save = btf.<span class="property">saveToLocal</span> || <span class="variable language_">window</span>.<span class="property">saveToLocal</span></span><br><span class="line">  <span class="keyword">if</span> (save &amp;&amp; <span class="keyword">typeof</span> save.<span class="property">set</span> === <span class="string">&#x27;function&#x27;</span>) save.<span class="title function_">set</span>(<span class="string">&#x27;theme&#x27;</span>, mode, <span class="number">2</span>)</span><br><span class="line">  <span class="keyword">else</span> &#123;</span><br><span class="line">    <span class="keyword">try</span> &#123;</span><br><span class="line">      <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;theme&#x27;</span>, <span class="title class_">JSON</span>.<span class="title function_">stringify</span>(&#123; <span class="attr">value</span>: mode, <span class="attr">expiry</span>: <span class="title class_">Date</span>.<span class="title function_">now</span>() + <span class="number">2</span> * <span class="number">86400000</span> &#125;))</span><br><span class="line">    &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">const</span> themeChange = (<span class="variable language_">window</span>.<span class="property">globalFn</span> || &#123;&#125;).<span class="property">themeChange</span></span><br><span class="line">  <span class="keyword">if</span> (themeChange) &#123;</span><br><span class="line">    <span class="title class_">Object</span>.<span class="title function_">keys</span>(themeChange).<span class="title function_">forEach</span>(<span class="function"><span class="params">key</span> =&gt;</span> &#123;</span><br><span class="line">      <span class="keyword">const</span> fn = themeChange[key]</span><br><span class="line">      <span class="keyword">if</span> (<span class="keyword">typeof</span> fn !== <span class="string">&#x27;function&#x27;</span>) <span class="keyword">return</span></span><br><span class="line">      <span class="keyword">if</span> (key === <span class="string">&#x27;disqus&#x27;</span> || key === <span class="string">&#x27;disqusjs&#x27;</span>) <span class="built_in">setTimeout</span>(<span class="function">() =&gt;</span> <span class="title function_">fn</span>(mode), <span class="number">300</span>)</span><br><span class="line">      <span class="keyword">else</span> <span class="title function_">fn</span>(mode)</span><br><span class="line">    &#125;)</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">btfSetModeIcons</span>(<span class="params">href</span>) &#123;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">querySelectorAll</span>(<span class="string">&#x27;#modeicon&#x27;</span>).<span class="title function_">forEach</span>(<span class="function"><span class="params">icon</span> =&gt;</span> icon.<span class="title function_">setAttribute</span>(<span class="string">&#x27;xlink:href&#x27;</span>, href))</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">btfNightToast</span>(<span class="params">toDark</span>) &#123;</span><br><span class="line">  <span class="keyword">const</span> title = toDark ? <span class="string">&#x27;关灯啦🌙&#x27;</span> : <span class="string">&#x27;开灯啦🌞&#x27;</span></span><br><span class="line">  <span class="keyword">const</span> message = toDark ? <span class="string">&#x27;当前已成功切换至夜间模式！&#x27;</span> : <span class="string">&#x27;当前已成功切换至白天模式！&#x27;</span></span><br><span class="line">  <span class="keyword">if</span> (<span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">Vue</span> === <span class="string">&#x27;function&#x27;</span>) &#123;</span><br><span class="line">    <span class="keyword">try</span> &#123;</span><br><span class="line">      <span class="keyword">new</span> <span class="variable language_">window</span>.<span class="title class_">Vue</span>(&#123;</span><br><span class="line">        <span class="attr">data</span>: <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">          <span class="variable language_">this</span>.$notify(&#123;</span><br><span class="line">            <span class="attr">title</span>: title, <span class="attr">message</span>: message, <span class="attr">position</span>: <span class="string">&#x27;top-left&#x27;</span>,</span><br><span class="line">            <span class="attr">offset</span>: <span class="number">50</span>, <span class="attr">showClose</span>: <span class="literal">true</span>, <span class="attr">type</span>: <span class="string">&#x27;success&#x27;</span>, <span class="attr">duration</span>: <span class="number">5000</span></span><br><span class="line">          &#125;)</span><br><span class="line">        &#125;</span><br><span class="line">      &#125;)</span><br><span class="line">      <span class="keyword">return</span></span><br><span class="line">    &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="keyword">try</span> &#123;</span><br><span class="line">    <span class="keyword">const</span> btf = <span class="variable language_">window</span>.<span class="property">btf</span> || &#123;&#125;</span><br><span class="line">    <span class="keyword">const</span> gcfg = <span class="variable language_">window</span>.<span class="property">GLOBAL_CONFIG</span> || &#123;&#125;</span><br><span class="line">    <span class="keyword">if</span> (<span class="keyword">typeof</span> btf.<span class="property">snackbarShow</span> === <span class="string">&#x27;function&#x27;</span> &amp;&amp; gcfg.<span class="property">Snackbar</span> &amp;&amp; <span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">Snackbar</span> !== <span class="string">&#x27;undefined&#x27;</span>) &#123;</span><br><span class="line">      btf.<span class="title function_">snackbarShow</span>(title + <span class="string">&#x27; &#x27;</span> + message)</span><br><span class="line">    &#125;</span><br><span class="line">  &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">switchNightMode</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">const</span> body = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;body&#x27;</span>)</span><br><span class="line">  <span class="keyword">const</span> toDark = <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-theme&#x27;</span>) !== <span class="string">&#x27;dark&#x27;</span></span><br><span class="line"></span><br><span class="line">  body.<span class="title function_">insertAdjacentHTML</span>(<span class="string">&#x27;beforeend&#x27;</span>, <span class="string">&#x27;&lt;div class=&quot;Cuteen_DarkSky&quot;&gt;&lt;div class=&quot;Cuteen_DarkPlanet&quot;&gt;&lt;div id=&quot;sun&quot;&gt;&lt;/div&gt;&lt;div id=&quot;moon&quot;&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&#x27;</span>)</span><br><span class="line"></span><br><span class="line">  body.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;DarkMode&#x27;</span>, toDark)</span><br><span class="line">  <span class="keyword">try</span> &#123; <span class="variable language_">localStorage</span>.<span class="title function_">setItem</span>(<span class="string">&#x27;isDark&#x27;</span>, toDark ? <span class="string">&#x27;1&#x27;</span> : <span class="string">&#x27;0&#x27;</span>) &#125; <span class="keyword">catch</span> (e) &#123;&#125;</span><br><span class="line">  <span class="title function_">btfSetModeIcons</span>(toDark ? <span class="string">&#x27;#icon-sun&#x27;</span> : <span class="string">&#x27;#icon-moon&#x27;</span>)</span><br><span class="line"></span><br><span class="line">  <span class="keyword">const</span> sun = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;sun&#x27;</span>)</span><br><span class="line">  <span class="keyword">const</span> moon = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;moon&#x27;</span>)</span><br><span class="line">  sun.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;1&#x27;</span> : <span class="string">&#x27;0&#x27;</span></span><br><span class="line">  moon.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;0&#x27;</span> : <span class="string">&#x27;1&#x27;</span></span><br><span class="line">  <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    sun.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;0&#x27;</span> : <span class="string">&#x27;1&#x27;</span></span><br><span class="line">    moon.<span class="property">style</span>.<span class="property">opacity</span> = toDark ? <span class="string">&#x27;1&#x27;</span> : <span class="string">&#x27;0&#x27;</span></span><br><span class="line">  &#125;, <span class="number">1000</span>)</span><br><span class="line"></span><br><span class="line">  <span class="title function_">btfSwitchTheme</span>(toDark)</span><br><span class="line"></span><br><span class="line">  <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">const</span> sky = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;.Cuteen_DarkSky&#x27;</span>)</span><br><span class="line">    <span class="keyword">if</span> (!sky) <span class="keyword">return</span></span><br><span class="line">    sky.<span class="property">style</span>.<span class="property">transition</span> = <span class="string">&#x27;opacity 3s&#x27;</span></span><br><span class="line">    sky.<span class="property">style</span>.<span class="property">opacity</span> = <span class="string">&#x27;0&#x27;</span></span><br><span class="line">    <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; sky.<span class="title function_">remove</span>() &#125;, <span class="number">1000</span>)</span><br><span class="line">  &#125;, <span class="number">2000</span>)</span><br><span class="line"></span><br><span class="line">  <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">btfNightToast</span>(toDark) &#125;, <span class="number">2000</span>)</span><br><span class="line"></span><br><span class="line">  <span class="keyword">typeof</span> utterancesTheme === <span class="string">&#x27;function&#x27;</span> &amp;&amp; <span class="title function_">utterancesTheme</span>()</span><br><span class="line">  <span class="keyword">typeof</span> <span class="variable constant_">FB</span> === <span class="string">&#x27;object&#x27;</span> &amp;&amp; <span class="variable language_">window</span>.<span class="title function_">loadFBComment</span>()</span><br><span class="line">  <span class="variable language_">window</span>.<span class="property">DISQUS</span> &amp;&amp; <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;disqus_thread&#x27;</span>) &amp;&amp; <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;disqus_thread&#x27;</span>).<span class="property">children</span>.<span class="property">length</span> &amp;&amp; <span class="built_in">setTimeout</span>(<span class="function">() =&gt;</span> <span class="variable language_">window</span>.<span class="title function_">disqusReset</span>(), <span class="number">200</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">function</span> <span class="title function_">btfSyncModeIcons</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">const</span> isDark = <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-theme&#x27;</span>) === <span class="string">&#x27;dark&#x27;</span></span><br><span class="line">  <span class="title function_">btfSetModeIcons</span>(isDark ? <span class="string">&#x27;#icon-sun&#x27;</span> : <span class="string">&#x27;#icon-moon&#x27;</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="title function_">btfSyncModeIcons</span>()</span><br><span class="line"><span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;DOMContentLoaded&#x27;</span>, btfSyncModeIcons)</span><br><span class="line"><span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">btf</span> &amp;&amp; <span class="keyword">typeof</span> <span class="variable language_">window</span>.<span class="property">btf</span>.<span class="property">addGlobalFn</span> === <span class="string">&#x27;function&#x27;</span>) &#123;</span><br><span class="line">  <span class="variable language_">window</span>.<span class="property">btf</span>.<span class="title function_">addGlobalFn</span>(<span class="string">&#x27;pjaxComplete&#x27;</span>, btfSyncModeIcons, <span class="string">&#x27;sunMoonIconSync&#x27;</span>)</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>新建 <code>[Blogroot]\themes\butterfly\source\css\_layout\sun_moon.styl</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/source/css/_layout/sun_moon.styl</code> ｜ <strong>改法</strong>：新建文件，整段写入；已有则整体覆盖。必须放在主题 <code>source/css/_layout/</code> 下，才会被主题编译进 <code>index.css</code>。</p><figure class="highlight styl"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.Cuteen_DarkSky</span>,</span><br><span class="line"><span class="selector-class">.Cuteen_DarkSky</span><span class="selector-pseudo">:before</span></span><br><span class="line">  <span class="attribute">content</span> <span class="string">&#x27;&#x27;</span></span><br><span class="line">  <span class="attribute">position</span> fixed</span><br><span class="line">  <span class="attribute">left</span> <span class="number">0</span></span><br><span class="line">  <span class="attribute">right</span> <span class="number">0</span></span><br><span class="line">  <span class="attribute">top</span> <span class="number">0</span></span><br><span class="line">  <span class="attribute">bottom</span> <span class="number">0</span></span><br><span class="line">  <span class="attribute">z-index</span> <span class="number">88888888</span></span><br><span class="line"></span><br><span class="line"><span class="selector-class">.Cuteen_DarkSky</span></span><br><span class="line">  <span class="attribute">background</span> <span class="built_in">linear-gradient</span>(to top, <span class="number">#f8cd71</span> <span class="number">0</span>, <span class="number">#5bfde9</span> <span class="number">80%</span>)</span><br><span class="line">  <span class="selector-pseudo">&amp;:before</span></span><br><span class="line">    <span class="attribute">transition</span> <span class="number">2s</span> ease all</span><br><span class="line">    <span class="attribute">opacity</span> <span class="number">0</span></span><br><span class="line">    <span class="attribute">background</span> <span class="built_in">linear-gradient</span>(to top, <span class="number">#30cfd0</span> <span class="number">0</span>, <span class="number">#330867</span> <span class="number">100%</span>)</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.DarkMode</span></span><br><span class="line">  <span class="selector-class">.Cuteen_DarkSky</span></span><br><span class="line">    <span class="selector-pseudo">&amp;:before</span></span><br><span class="line">      <span class="attribute">opacity</span> <span class="number">1</span></span><br><span class="line"></span><br><span class="line"><span class="selector-class">.Cuteen_DarkPlanet</span></span><br><span class="line">  <span class="attribute">z-index</span> <span class="number">99999999</span></span><br><span class="line">  <span class="attribute">position</span> fixed</span><br><span class="line">  <span class="attribute">left</span> -<span class="number">50%</span></span><br><span class="line">  <span class="attribute">top</span> -<span class="number">50%</span></span><br><span class="line">  <span class="attribute">width</span> <span class="number">200%</span></span><br><span class="line">  <span class="attribute">height</span> <span class="number">200%</span></span><br><span class="line">  <span class="attribute">animation</span> CuteenPlanetMove <span class="number">2s</span> <span class="built_in">cubic-bezier</span>(<span class="number">0.7</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>)</span><br><span class="line">  <span class="attribute">transform-origin</span> center bottom</span><br><span class="line"></span><br><span class="line"><span class="keyword">@keyframes</span> CuteenPlanetMove</span><br><span class="line">  <span class="number">0%</span></span><br><span class="line">    <span class="attribute">transform</span> <span class="built_in">rotate</span>(<span class="number">0</span>)</span><br><span class="line">  to</span><br><span class="line">    <span class="attribute">transform</span> <span class="built_in">rotate</span>(<span class="number">360deg</span>)</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.Cuteen_DarkPlanet</span></span><br><span class="line">  <span class="selector-id">#sun</span></span><br><span class="line">    <span class="attribute">position</span> absolute</span><br><span class="line">    <span class="attribute">border-radius</span> <span class="number">100%</span></span><br><span class="line">    <span class="attribute">left</span> <span class="number">44%</span></span><br><span class="line">    <span class="attribute">top</span> <span class="number">30%</span></span><br><span class="line">    <span class="attribute">height</span> <span class="number">6rem</span></span><br><span class="line">    <span class="attribute">width</span> <span class="number">6rem</span></span><br><span class="line">    <span class="attribute">background</span> <span class="number">#ffee94</span></span><br><span class="line">    <span class="attribute">box-shadow</span> <span class="number">0</span> <span class="number">0</span> <span class="number">40px</span> <span class="number">#ffee94</span></span><br><span class="line">  <span class="selector-id">#moon</span></span><br><span class="line">    <span class="attribute">position</span> absolute</span><br><span class="line">    <span class="attribute">border-radius</span> <span class="number">100%</span></span><br><span class="line">    <span class="attribute">left</span> <span class="number">44%</span></span><br><span class="line">    <span class="attribute">top</span> <span class="number">30%</span></span><br><span class="line">    <span class="attribute">height</span> <span class="number">6rem</span></span><br><span class="line">    <span class="attribute">width</span> <span class="number">6rem</span></span><br><span class="line">    <span class="attribute">box-shadow</span> -<span class="number">1.8em</span> <span class="number">1.8em</span> <span class="number">0</span> <span class="number">0.2em</span> <span class="number">#fff</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\themes\butterfly\layout\includes\head.pug</code> 最末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/head.pug</code> ｜ <strong>改法</strong>：追加到文件末尾；前两行若已存在（主题原文件就有），只补最后一行 <code>include ./custom/sun_moon.pug</code>。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line">!=fragment_cache(&#x27;injectHead&#x27;, function()&#123;return injectHtml(theme.inject.head)&#125;)</span><br><span class="line"></span><br><span class="line">#myscoll</span><br><span class="line">include ./custom/sun_moon.pug</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\themes\butterfly\layout\includes\header\nav.pug</code> 的 <code>#menus</code> 块之后添加（缩进 2 格，与 <code>#menus</code> 同级）：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/header/nav.pug</code> ｜ <strong>改法</strong>：在 <code>#menus</code> 块之后插入，保持 2 格缩进，与 <code>#menus</code> 同级。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line">//- 暗黑模式按钮</span><br><span class="line">a.sun_moon.faa-parent.animated-hover(onclick=&#x27;switchNightMode()&#x27;,  title=_p(&#x27;rightside.night_mode_title&#x27;) id=&quot;nightmode-button&quot;)</span><br><span class="line">  svg.faa-tada(style=&quot;height:25px;width:25px;fill:currentColor;position:relative;top:7px&quot;, viewBox=&#x27;0 0 1024 1024&#x27;)</span><br><span class="line">    use#modeicon(xlink:href=&#x27;#icon-moon&#x27;)</span><br></pre></td></tr></table></figure><p>把 <code>[Blogroot]\themes\butterfly\layout\includes\rightside.pug</code> 的 <code>when &#39;darkmode&#39;</code> 分支改成：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/rightside.pug</code> ｜ <strong>改法</strong>：替换 <code>mixin rightsideItem</code> 里 <code>when &#39;darkmode&#39;</code> 的整个分支（连同下面注释掉的旧按钮）。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">when &#x27;darkmode&#x27;</span><br><span class="line">  if darkmode.enable &amp;&amp; darkmode.button</span><br><span class="line">    a.icon-V.hidden(onclick=&#x27;switchNightMode()&#x27;,  title=_p(&#x27;rightside.night_mode_title&#x27;))</span><br><span class="line">      svg(width=&#x27;25&#x27;, height=&#x27;25&#x27;, viewBox=&#x27;0 0 1024 1024&#x27;)</span><br><span class="line">        use#modeicon(xlink:href=&#x27;#icon-moon&#x27;)</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code>（主题配置，不是站点 <code>_config.yml</code>）｜ <strong>改法</strong>：<code>display_mode</code> 改顶层原值；<code>darkmode</code> 找到同名顶层键后整块替换。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">display_mode:</span> <span class="string">light</span></span><br><span class="line"><span class="attr">darkmode:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">button:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">autoChangeMode:</span> <span class="literal">false</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.bottom</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：只把 <code>&lt;script&gt;</code> 这一行追加到已有 <code>inject: bottom:</code> 列表末尾；<code>inject:</code> / <code>bottom:</code> 键文件里已经有了，照抄会重复键导致 YAML 报错。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">src=&quot;/js/sun_moon.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#昼夜转换</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="导航栏「美化设置」按钮"><a href="#导航栏「美化设置」按钮" class="headerlink" title="导航栏「美化设置」按钮"></a>导航栏「美化设置」按钮</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：图标与按钮位置按本站导航栏重排，面板入口与美化设置联动。</p></blockquote><details class="folding-tag" blue><summary> 美化设置按钮 </summary>              <div class='content'>              <p>把阿里图标库导出的 JS 放到 <code>[Blogroot]\source\js\ali_font.js</code>，其中要有 <code>#icon-tupian1</code> 这个 symbol。<br>在 <code>[Blogroot]\themes\butterfly\layout\includes\header\nav.pug</code> 的 <code>#menus</code> 块之后添加：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/header/nav.pug</code> ｜ <strong>改法</strong>：紧接上一节的昼夜按钮，在 <code>#menus</code> 块之后插入，2 格缩进。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line">//- 美化设置</span><br><span class="line">a.meihua.faa-parent.animated-hover(onclick=&quot;toggleWinbox()&quot; title=&quot;美化设置-自定义你的风格&quot; id=&quot;meihua-button&quot;)</span><br><span class="line">  svg.faa-tada.icon(style=&quot;height:26px;width:26px;fill:currentColor;position:relative;top:8px&quot; aria-hidden=&quot;true&quot;)</span><br><span class="line">    use(xlink:href=&#x27;#icon-tupian1&#x27;)</span><br></pre></td></tr></table></figure><p>新建 <code>[Blogroot]\source\js\meihua.js</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/meihua.js</code> ｜ <strong>改法</strong>：新建文件，整段写入（放站点 <code>source/js/</code>，别放主题目录，升级主题不会丢）。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">toggleWinbox</span>(<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> box = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;meihua-winbox&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (box) &#123; box.<span class="title function_">remove</span>(); <span class="keyword">return</span>; &#125;</span><br><span class="line">  box = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">  box.<span class="property">id</span> = <span class="string">&#x27;meihua-winbox&#x27;</span>;</span><br><span class="line">  box.<span class="property">innerHTML</span> = <span class="string">&#x27;&lt;h3&gt;美化设置&lt;/h3&gt;&#x27;</span> +</span><br><span class="line">    <span class="string">&#x27;&lt;button onclick=&quot;document.documentElement.classList.toggle(\&#x27;low-perf\&#x27;)&quot;&gt;切换性能模式&lt;/button&gt;&#x27;</span> +</span><br><span class="line">    <span class="string">&#x27;&lt;button onclick=&quot;switchNightMode()&quot;&gt;切换昼夜&lt;/button&gt;&#x27;</span> +</span><br><span class="line">    <span class="string">&#x27;&lt;button onclick=&quot;this.parentNode.remove()&quot;&gt;关闭&lt;/button&gt;&#x27;</span>;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(box);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\source\css\custom.css</code> 末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。本站 <code>custom.css</code> 已经由 <code>inject.head</code> 的 <code>&lt;link&gt;</code> 引入，不用再加一行。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#meihua-winbox</span> &#123;</span><br><span class="line">  <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">right</span>: <span class="number">20px</span>;</span><br><span class="line">  <span class="attribute">top</span>: <span class="number">80px</span>;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">10090</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">16px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">255</span>,<span class="number">255</span>,<span class="number">255</span>,.<span class="number">95</span>);</span><br><span class="line">  <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">6px</span> <span class="number">24px</span> <span class="built_in">rgba</span>(<span class="number">0</span>,<span class="number">0</span>,<span class="number">0</span>,.<span class="number">2</span>);</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#meihua-winbox</span> &#123; <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">30</span>,<span class="number">35</span>,<span class="number">45</span>,.<span class="number">95</span>); <span class="attribute">color</span>: <span class="number">#fff</span>; &#125;</span><br><span class="line"><span class="selector-id">#meihua-winbox</span> <span class="selector-tag">button</span> &#123; <span class="attribute">display</span>: block; <span class="attribute">margin</span>: <span class="number">8px</span> <span class="number">0</span>; <span class="attribute">cursor</span>: pointer; &#125;</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在已有的 <code>tag_plugins:</code> 块里给 <code>CDN:</code> 加 <code>iconfont:</code> 一行；本站该行目前是注释状态，要用时取消注释。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">tag_plugins:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">CDN:</span></span><br><span class="line">    <span class="attr">iconfont:</span> <span class="string">/js/ali_font.js</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.bottom</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：只把 <code>&lt;script&gt;</code> 这一行追加到已有 <code>inject: bottom:</code> 列表，别重复写 <code>inject:</code> / <code>bottom:</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/meihua.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#美化设置</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="导航栏挤不下才切三条杠"><a href="#导航栏挤不下才切三条杠" class="headerlink" title="导航栏挤不下才切三条杠"></a>导航栏挤不下才切三条杠</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：宽度测量与断点按本站导航项重新调整。</p></blockquote><details class="folding-tag" blue><summary> 导航栏自适应 </summary>              <div class='content'>              <p>新建 <code>[Blogroot]\source\js\nav-fit.js</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/nav-fit.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；站点已有同名文件就整段覆盖。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> nav, menu, title, search;</span><br><span class="line">  <span class="keyword">var</span> cachedMenuWidth = <span class="number">0</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">measure</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!menu) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> rect = menu.<span class="title function_">getBoundingClientRect</span>();</span><br><span class="line">    <span class="keyword">if</span> (<span class="title function_">getComputedStyle</span>(menu).<span class="property">display</span> !== <span class="string">&#x27;none&#x27;</span> &amp;&amp; rect.<span class="property">width</span> &gt; <span class="number">0</span>) &#123;</span><br><span class="line">      cachedMenuWidth = rect.<span class="property">width</span>;</span><br><span class="line">      <span class="keyword">return</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    menu.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;display&#x27;</span>, <span class="string">&#x27;block&#x27;</span>, <span class="string">&#x27;important&#x27;</span>);</span><br><span class="line">    menu.<span class="property">style</span>.<span class="title function_">setProperty</span>(<span class="string">&#x27;visibility&#x27;</span>, <span class="string">&#x27;hidden&#x27;</span>, <span class="string">&#x27;important&#x27;</span>);</span><br><span class="line">    cachedMenuWidth = menu.<span class="title function_">getBoundingClientRect</span>().<span class="property">width</span>;</span><br><span class="line">    menu.<span class="property">style</span>.<span class="title function_">removeProperty</span>(<span class="string">&#x27;display&#x27;</span>);</span><br><span class="line">    menu.<span class="property">style</span>.<span class="title function_">removeProperty</span>(<span class="string">&#x27;visibility&#x27;</span>);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">fit</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!nav || !menu || !title || !search) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="property">innerWidth</span> &lt;= <span class="number">768</span>) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">if</span> (!cachedMenuWidth) <span class="keyword">return</span>;</span><br><span class="line">    <span class="keyword">var</span> gap = <span class="number">14</span>;</span><br><span class="line">    <span class="keyword">var</span> titleRight = title.<span class="title function_">getBoundingClientRect</span>().<span class="property">right</span>;</span><br><span class="line">    <span class="keyword">var</span> rightReserve = <span class="variable language_">window</span>.<span class="property">innerWidth</span> - search.<span class="title function_">getBoundingClientRect</span>().<span class="property">left</span>;</span><br><span class="line">    <span class="keyword">var</span> needLeft = <span class="number">2</span> * (titleRight + gap) + cachedMenuWidth;</span><br><span class="line">    <span class="keyword">var</span> needRight = cachedMenuWidth + <span class="number">2</span> * (rightReserve + gap);</span><br><span class="line">    <span class="keyword">var</span> threshold = <span class="title class_">Math</span>.<span class="title function_">max</span>(needLeft, needRight);</span><br><span class="line">    nav.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hide-menu&#x27;</span>, <span class="variable language_">window</span>.<span class="property">innerWidth</span> &lt; threshold);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">refresh</span>(<span class="params"></span>) &#123;</span><br><span class="line">    nav = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;nav&#x27;</span>);</span><br><span class="line">    menu = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;#nav .menus_items&#x27;</span>);</span><br><span class="line">    title = <span class="variable language_">document</span>.<span class="title function_">querySelector</span>(<span class="string">&#x27;#blog-info a&#x27;</span>);</span><br><span class="line">    search = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;search-button&#x27;</span>);</span><br><span class="line">    <span class="keyword">if</span> (!nav || !menu || !title || !search) <span class="keyword">return</span>;</span><br><span class="line">    <span class="title function_">measure</span>();</span><br><span class="line">    <span class="title function_">fit</span>();</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">schedule</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="built_in">setTimeout</span>(refresh, <span class="number">0</span>);</span><br><span class="line">    <span class="title function_">requestAnimationFrame</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">requestAnimationFrame</span>(refresh); &#125;);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;DOMContentLoaded&#x27;</span>, schedule);</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">readyState</span> !== <span class="string">&#x27;loading&#x27;</span>) <span class="title function_">schedule</span>();</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;load&#x27;</span>, schedule);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;pjax:complete&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="built_in">setTimeout</span>(schedule, <span class="number">80</span>); &#125;);</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;resize&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="built_in">setTimeout</span>(fit, <span class="number">0</span>); &#125;);</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">fonts</span> &amp;&amp; <span class="variable language_">document</span>.<span class="property">fonts</span>.<span class="property">ready</span>) &#123;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">fonts</span>.<span class="property">ready</span>.<span class="title function_">then</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="built_in">setTimeout</span>(schedule, <span class="number">50</span>); &#125;);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.bottom</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：追加到已有 <code>inject: bottom:</code> 列表末尾。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/nav-fit.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#导航栏挤不下时才切三条杠</span></span><br></pre></td></tr></table></figure><p><code>[Blogroot]\_config.butterfly.yml</code> 的 <code>menu</code> 分组写法：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：替换 <code>menu:</code> 下对应分组的写法；<code>|| hide:</code> 是让桌面导航隐藏子菜单、只在手机菜单里出现。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">menu:</span></span><br><span class="line">  <span class="string">文章||fas</span> <span class="string">fa-book</span> <span class="string">||</span> <span class="attr">hide:</span></span><br><span class="line">    <span class="string">归档:</span> <span class="string">/archives/</span> <span class="string">||</span> <span class="string">fas</span> <span class="string">fa-archive</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="文章页顶部波浪"><a href="#文章页顶部波浪" class="headerlink" title="文章页顶部波浪"></a>文章页顶部波浪</h1><blockquote><p>借鉴：安知鱼（Fomalhaut 整理）。本站改动：Pug 插入位置按 5.7.2 调整，波浪配色接本站背景遮罩。</p></blockquote><details class="folding-tag" blue><summary> 文章页波浪 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\themes\butterfly\layout\includes\header\index.pug</code> 的 <code>include ./post-info.pug</code> 后面插入：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/header/index.pug</code> ｜ <strong>改法</strong>：把 <code>include ./post-info.pug</code> 那一段换成下面这块（缩进保持 4 格），波浪就只在文章页出现。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line">if globalPageType === &#x27;post&#x27;</span><br><span class="line">  include ./post-info.pug</span><br><span class="line">  section.main-hero-waves-area.waves-area</span><br><span class="line">    svg.waves-svg(xmlns=&#x27;http://www.w3.org/2000/svg&#x27;, xlink=&#x27;http://www.w3.org/1999/xlink&#x27;, viewBox=&#x27;0 24 150 28&#x27;, preserveAspectRatio=&#x27;none&#x27;, shape-rendering=&#x27;auto&#x27;)</span><br><span class="line">      defs</span><br><span class="line">        path#gentle-wave(d=&#x27;M -160 44 c 30 0 58 -18 88 -18 s 58 18 88 18 s 58 -18 88 -18 s 58 18 88 18 v 44 h -352 Z&#x27;)</span><br><span class="line">      g.parallax</span><br><span class="line">        use(href=&#x27;#gentle-wave&#x27;, x=&#x27;48&#x27;, y=&#x27;0&#x27;)</span><br><span class="line">        use(href=&#x27;#gentle-wave&#x27;, x=&#x27;48&#x27;, y=&#x27;3&#x27;)</span><br><span class="line">        use(href=&#x27;#gentle-wave&#x27;, x=&#x27;48&#x27;, y=&#x27;5&#x27;)</span><br><span class="line">        use(href=&#x27;#gentle-wave&#x27;, x=&#x27;48&#x27;, y=&#x27;7&#x27;)</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\source\css\custom.css</code> 末尾添加：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.main-hero-waves-area</span> &#123; <span class="attribute">width</span>: <span class="number">100%</span>; <span class="attribute">position</span>: absolute; <span class="attribute">left</span>: <span class="number">0</span>; <span class="attribute">bottom</span>: -<span class="number">11px</span>; <span class="attribute">z-index</span>: <span class="number">5</span>; &#125;</span><br><span class="line"><span class="selector-class">.waves-area</span> <span class="selector-class">.waves-svg</span> &#123; <span class="attribute">width</span>: <span class="number">100%</span>; <span class="attribute">height</span>: <span class="number">5rem</span>; &#125;</span><br><span class="line"><span class="selector-class">.parallax</span> &gt; use &#123; <span class="attribute">animation</span>: move-forever <span class="number">25s</span> <span class="built_in">cubic-bezier</span>(.<span class="number">55</span>,.<span class="number">5</span>,.<span class="number">45</span>,.<span class="number">5</span>) infinite; &#125;</span><br><span class="line"><span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">1</span>) &#123; <span class="attribute">animation-delay</span>: -<span class="number">2s</span>; <span class="attribute">animation-duration</span>: <span class="number">7s</span>; fill: <span class="number">#f7f9febd</span>; &#125;</span><br><span class="line"><span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">2</span>) &#123; <span class="attribute">animation-delay</span>: -<span class="number">3s</span>; <span class="attribute">animation-duration</span>: <span class="number">10s</span>; fill: <span class="number">#f7f9fe82</span>; &#125;</span><br><span class="line"><span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">3</span>) &#123; <span class="attribute">animation-delay</span>: -<span class="number">4s</span>; <span class="attribute">animation-duration</span>: <span class="number">13s</span>; fill: <span class="number">#f7f9fe36</span>; &#125;</span><br><span class="line"><span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">4</span>) &#123; <span class="attribute">animation-delay</span>: -<span class="number">5s</span>; <span class="attribute">animation-duration</span>: <span class="number">20s</span>; fill: <span class="number">#f7f9fe</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">1</span>) &#123; fill: <span class="number">#18171dc8</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">2</span>) &#123; fill: <span class="number">#18171d80</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">3</span>) &#123; fill: <span class="number">#18171d3e</span>; &#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-class">.parallax</span> &gt; use<span class="selector-pseudo">:nth-child</span>(<span class="number">4</span>) &#123; fill: <span class="number">#18171d</span>; &#125;</span><br><span class="line"><span class="keyword">@keyframes</span> move-forever &#123;</span><br><span class="line">  <span class="number">0%</span> &#123; <span class="attribute">transform</span>: <span class="built_in">translate3d</span>(-<span class="number">90px</span>, <span class="number">0</span>, <span class="number">0</span>); &#125;</span><br><span class="line">  <span class="number">100%</span> &#123; <span class="attribute">transform</span>: <span class="built_in">translate3d</span>(<span class="number">85px</span>, <span class="number">0</span>, <span class="number">0</span>); &#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.low-perf</span> <span class="selector-class">.parallax</span> &gt; use &#123; <span class="attribute">animation</span>: none <span class="meta">!important</span>; &#125;</span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="自定义全屏加载动画"><a href="#自定义全屏加载动画" class="headerlink" title="自定义全屏加载动画"></a>自定义全屏加载动画</h1><blockquote><p>借鉴：安知鱼（Fomalhaut 整理）。本站改动：加载模板按 5.7.2 重写，结束逻辑与本站 <code>PJAX</code> 流程对齐。</p></blockquote><details class="folding-tag" blue><summary> 自定义加载动画 </summary>              <div class='content'>              <p>把 <code>[Blogroot]\themes\butterfly\layout\includes\loading\fullpage-loading.pug</code> 整个替换为：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/loading/fullpage-loading.pug</code> ｜ <strong>改法</strong>：整段替换整个文件（主题自带，改前先备份）。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br></pre></td><td class="code"><pre><span class="line">#loading-box(onclick=&#x27;document.getElementById(&quot;loading-box&quot;).classList.add(&quot;loaded&quot;)&#x27;)</span><br><span class="line">  .loading-bg</span><br><span class="line">    div.loading-img</span><br><span class="line">    .loading-image-dot</span><br><span class="line"></span><br><span class="line">script.</span><br><span class="line">  const preloader = &#123;</span><br><span class="line">    endLoading: () =&gt; &#123;</span><br><span class="line">      document.body.style.overflow = &#x27;auto&#x27;;</span><br><span class="line">      document.getElementById(&#x27;loading-box&#x27;).classList.add(&quot;loaded&quot;)</span><br><span class="line">    &#125;,</span><br><span class="line">    initLoading: () =&gt; &#123;</span><br><span class="line">      document.body.style.overflow = &#x27;&#x27;;</span><br><span class="line">      document.getElementById(&#x27;loading-box&#x27;).classList.remove(&quot;loaded&quot;)</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;</span><br><span class="line">  window.addEventListener(&#x27;load&#x27;,()=&gt; &#123; preloader.endLoading() &#125;)</span><br><span class="line"></span><br><span class="line">  if (document.readyState === &#x27;loading&#x27;) &#123;</span><br><span class="line">    document.addEventListener(&#x27;DOMContentLoaded&#x27;, () =&gt; setTimeout(preloader.endLoading, 1200))</span><br><span class="line">  &#125; else &#123;</span><br><span class="line">    setTimeout(preloader.endLoading, 1200)</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  if (!&#123;theme.pjax &amp;&amp; theme.pjax.enable&#125;) &#123;</span><br><span class="line">    document.addEventListener(&#x27;pjax:send&#x27;, () =&gt; &#123; preloader.initLoading() &#125;)</span><br><span class="line">    document.addEventListener(&#x27;pjax:complete&#x27;, () =&gt; &#123; preloader.endLoading() &#125;)</span><br><span class="line">  &#125;</span><br></pre></td></tr></table></figure><p>把 <code>[Blogroot]\themes\butterfly\source\css\_layout\loading.styl</code> 整个替换为：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/source/css/_layout/loading.styl</code> ｜ <strong>改法</strong>：整段替换整个文件（主题自带，改前先备份）。</p><figure class="highlight styl"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> <span class="built_in">hexo-config</span>(<span class="string">&#x27;preloader&#x27;</span>)</span><br><span class="line">  <span class="selector-class">.loading-bg</span></span><br><span class="line">    <span class="attribute">display</span>: flex;</span><br><span class="line">    <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">    <span class="attribute">height</span>: <span class="number">100%</span>;</span><br><span class="line">    <span class="attribute">position</span>: fixed;</span><br><span class="line">    <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">255</span>, <span class="number">255</span>, <span class="number">255</span>, <span class="number">0.8</span>);</span><br><span class="line">    <span class="attribute">z-index</span>: <span class="number">1001</span>;</span><br><span class="line">    <span class="attribute">opacity</span>: <span class="number">1</span>;</span><br><span class="line">    <span class="attribute">transition</span>: .<span class="number">3s</span>;</span><br><span class="line"></span><br><span class="line">  <span class="selector-id">#loading-box</span></span><br><span class="line">    <span class="selector-class">.loading-img</span></span><br><span class="line">      <span class="attribute">width</span>: <span class="number">100px</span>;</span><br><span class="line">      <span class="attribute">height</span>: <span class="number">100px</span>;</span><br><span class="line">      <span class="attribute">border-radius</span>: <span class="number">50%</span>;</span><br><span class="line">      <span class="attribute">margin</span>: auto;</span><br><span class="line">      <span class="attribute">border</span>: <span class="number">4px</span> solid <span class="number">#f0f0f2</span>;</span><br><span class="line">      <span class="attribute">animation-duration</span>: .<span class="number">3s</span>;</span><br><span class="line">      <span class="attribute">animation-name</span>: loadingAction;</span><br><span class="line">      <span class="attribute">animation-iteration-count</span>: infinite;</span><br><span class="line">      <span class="attribute">animation-direction</span>: alternate;</span><br><span class="line">    <span class="selector-class">.loading-image-dot</span></span><br><span class="line">      <span class="attribute">width</span>: <span class="number">30px</span>;</span><br><span class="line">      <span class="attribute">height</span>: <span class="number">30px</span>;</span><br><span class="line">      <span class="attribute">background</span>: <span class="number">#6bdf8f</span>;</span><br><span class="line">      <span class="attribute">position</span>: absolute;</span><br><span class="line">      <span class="attribute">border-radius</span>: <span class="number">50%</span>;</span><br><span class="line">      <span class="attribute">border</span>: <span class="number">6px</span> solid <span class="number">#fff</span>;</span><br><span class="line">      <span class="attribute">top</span>: <span class="number">50%</span>;</span><br><span class="line">      <span class="attribute">left</span>: <span class="number">50%</span>;</span><br><span class="line">      <span class="attribute">transform</span>: <span class="built_in">translate</span>(<span class="number">18px</span>, <span class="number">24px</span>);</span><br><span class="line">    &amp;<span class="selector-class">.loaded</span></span><br><span class="line">      <span class="selector-class">.loading-bg</span></span><br><span class="line">        <span class="attribute">opacity</span>: <span class="number">0</span>;</span><br><span class="line">        <span class="attribute">z-index</span>: -<span class="number">1000</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">@keyframes</span> loadingAction</span><br><span class="line">    <span class="number">0%</span> &#123;</span><br><span class="line">        <span class="attribute">opacity</span>: <span class="number">1</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="number">100%</span> &#123;</span><br><span class="line">        <span class="attribute">opacity</span>: .<span class="number">4</span>;</span><br><span class="line">    &#125;</span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：找到顶层 <code>preloader:</code> 键，改 <code>enable</code> / <code>source</code> / <code>pace_css_url</code> 三个值。<code>source</code> 要和模板对应：<code>1</code> 才是上面替换的整页加载模板，<code>2</code> 是 pace 进度条（本站现在用 <code>2</code>）。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">preloader:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">source:</span> <span class="number">3</span></span><br><span class="line">  <span class="attr">pace_css_url:</span> <span class="string">/css/progress_bar.css</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="打赏按钮投币特效"><a href="#打赏按钮投币特效" class="headerlink" title="打赏按钮投币特效"></a>打赏按钮投币特效</h1><blockquote><p>借鉴：店长（Fomalhaut 整理）。本站改动：模板按 5.7.2 结构重写，打赏图片与文案换成本站配置。</p></blockquote><details class="folding-tag" blue><summary> 打赏投币 </summary>              <div class='content'>              <p>把 <code>[Blogroot]\themes\butterfly\layout\includes\post\reward.pug</code> 整个替换为：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/post/reward.pug</code> ｜ <strong>改法</strong>：整段替换整个文件；模板读的是 <code>theme.CDN.option.coin_css</code>、<code>coin_js</code> 和 <code>theme.reward.QR_code</code>，配置没配就是空链接。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br></pre></td><td class="code"><pre><span class="line">link(rel=&#x27;stylesheet&#x27; href=url_for(theme.CDN.option.coin_css) media=&quot;defer&quot; onload=&quot;this.media=&#x27;all&#x27;&quot;)</span><br><span class="line">.post-reward</span><br><span class="line">  button.tip-button.reward-button</span><br><span class="line">    span.tip-button__text= _p(&#x27;donate&#x27;)</span><br><span class="line">    .coin-wrapper</span><br><span class="line">      .coin</span><br><span class="line">        .coin__middle</span><br><span class="line">        .coin__back</span><br><span class="line">        .coin__front</span><br><span class="line">    .reward-main</span><br><span class="line">      ul.reward-all</span><br><span class="line">        each item in theme.reward.QR_code</span><br><span class="line">          - var clickTo = (item.itemlist||item).link ? (item.itemlist||item).link : (item.itemlist||item).img</span><br><span class="line">          li.reward-item</span><br><span class="line">            a(href=clickTo target=&#x27;_blank&#x27;)</span><br><span class="line">              img.post-qr-code-img(src=url_for((item.itemlist||item).img) alt=(item.itemlist||item).text)</span><br><span class="line">            .post-qr-code-desc=(item.itemlist||item).text</span><br><span class="line">if theme.reward.coinAudio</span><br><span class="line">  - var coinAudio = theme.reward.coinAudio ? url_for(theme.reward.coinAudio) : &#x27;/audio/coin.mp3&#x27;</span><br><span class="line">  audio#coinAudio(src=coinAudio)</span><br><span class="line">script(defer src=url_for(theme.CDN.option.coin_js))</span><br></pre></td></tr></table></figure><p>新建 <code>[Blogroot]\source\css\coin.css</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/coin.css</code> ｜ <strong>改法</strong>：新建文件，整段写入；站点已有同名文件（完整版投币样式）就保留原文件，不要覆盖。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.tip-button</span> &#123; <span class="attribute">position</span>: relative; <span class="attribute">border</span>: <span class="number">0</span>; <span class="attribute">background</span>: none; <span class="attribute">cursor</span>: pointer; &#125;</span><br><span class="line"><span class="selector-class">.coin-wrapper</span> &#123; <span class="attribute">position</span>: absolute; <span class="attribute">left</span>: <span class="number">50%</span>; <span class="attribute">top</span>: -<span class="number">10px</span>; <span class="attribute">width</span>: <span class="number">40px</span>; <span class="attribute">height</span>: <span class="number">40px</span>; &#125;</span><br><span class="line"><span class="selector-class">.coin</span> &#123; <span class="attribute">width</span>: <span class="number">100%</span>; <span class="attribute">height</span>: <span class="number">100%</span>; <span class="attribute">transition</span>: transform .<span class="number">6s</span> ease; <span class="attribute">transform-style</span>: preserve-<span class="number">3</span>d; &#125;</span><br><span class="line"><span class="selector-class">.tip-button</span><span class="selector-pseudo">:hover</span> <span class="selector-class">.coin</span> &#123; <span class="attribute">transform</span>: <span class="built_in">rotateY</span>(<span class="number">180deg</span>) <span class="built_in">translateY</span>(-<span class="number">6px</span>); &#125;</span><br><span class="line"><span class="selector-class">.reward-main</span> &#123; <span class="attribute">display</span>: none; <span class="attribute">position</span>: absolute; <span class="attribute">z-index</span>: <span class="number">10</span>; &#125;</span><br><span class="line"><span class="selector-class">.post-reward</span><span class="selector-pseudo">:hover</span> <span class="selector-class">.reward-main</span>,</span><br><span class="line"><span class="selector-class">.post-reward</span><span class="selector-pseudo">:focus</span>-within <span class="selector-class">.reward-main</span> &#123; <span class="attribute">display</span>: block; &#125;</span><br></pre></td></tr></table></figure><p>新建 <code>[Blogroot]\source\js\coin.js</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/coin.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；本站 <code>source/js/coin.js</code> 已有另一版（<code>.tip-button</code> 点击触发 <code>coinAudio()</code>），已有就保留原版。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> btn = e.<span class="property">target</span>.<span class="title function_">closest</span>(<span class="string">&#x27;.reward-button&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!btn) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">var</span> audio = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;coinAudio&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (audio) &#123; audio.<span class="property">currentTime</span> = <span class="number">0</span>; audio.<span class="title function_">play</span>().<span class="title function_">catch</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;&#125;); &#125;</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p>把收款码图片放到 <code>[Blogroot]\source\img\</code>，音效放到 <code>[Blogroot]\source\audio\coin.mp3</code>。<br>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：<code>coin_js</code> / <code>coin_css</code> 写到已有的 <code>CDN: option:</code> 下；<code>reward:</code> 是顶层键，整块替换（本站 <code>reward.enable</code> 目前是 <code>false</code>，要出按钮得改成 <code>true</code>）。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">CDN:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line">    <span class="attr">coin_js:</span> <span class="string">/js/coin.js</span></span><br><span class="line">    <span class="attr">coin_css:</span> <span class="string">/css/coin.css</span></span><br><span class="line"><span class="attr">reward:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">text:</span> <span class="string">投喂作者</span></span><br><span class="line">  <span class="attr">coinAudio:</span> <span class="string">/audio/coin.mp3</span></span><br><span class="line">  <span class="attr">QR_code:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">img:</span> <span class="string">/img/wechat.png</span></span><br><span class="line">      <span class="attr">link:</span> <span class="string">/img/wechat.png</span></span><br><span class="line">      <span class="attr">text:</span> <span class="string">微信</span></span><br><span class="line">    <span class="bullet">-</span> <span class="attr">img:</span> <span class="string">/img/alipay.png</span></span><br><span class="line">      <span class="attr">link:</span> <span class="string">/img/alipay.png</span></span><br><span class="line">      <span class="attr">text:</span> <span class="string">支付宝</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="右下角「直达底部」与右键模式"><a href="#右下角「直达底部」与右键模式" class="headerlink" title="右下角「直达底部」与右键模式"></a>右下角「直达底部」与右键模式</h1><blockquote><p>借鉴：Leonus、Fomalhaut（猕猴桃）。本站改动：两个按钮按 5.7.2 右侧栏结构合并，图标与配色跟本站右侧按钮统一。</p></blockquote><details class="folding-tag" blue><summary> 右下角按钮 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\themes\butterfly\layout\includes\rightside.pug</code> 的 <code>mixin rightsideItem(array)</code> 里，在 <code>when &#39;comment&#39;</code> 分支后面添加：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/rightside.pug</code> ｜ <strong>改法</strong>：在 <code>mixin rightsideItem</code> 的 <code>when &#39;comment&#39;</code> 分支后插入 <code>when &#39;mouse&#39;</code>；代码块里的 <code>when &#39;comment&#39;</code> 只是定位用，原文件已有，别重复粘贴。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line">when &#x27;comment&#x27;</span><br><span class="line">  if commentsJsLoad</span><br><span class="line">    a#to_comment(href=&quot;#post-comment&quot; title=_p(&quot;rightside.scroll_to_comment&quot;))</span><br><span class="line">      i.fas.fa-comments</span><br><span class="line">when &#x27;mouse&#x27;</span><br><span class="line">  button.share(type=&quot;button&quot; title=&#x27;右键模式&#x27; onclick=&quot;changeMouseMode()&quot;)</span><br><span class="line">    i.fas.fa-mouse</span><br></pre></td></tr></table></figure><p>把同一文件的默认隐藏数组改成：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/rightside.pug</code> ｜ <strong>改法</strong>：替换文件里 <code>- const hideArray = ...</code> 那一行，数组里加上 <code>&#39;mouse&#39;</code>。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">- const hideArray = enable &amp;&amp; hide ? hide.split(&#x27;,&#x27;) : [&#x27;readmode&#x27;,&#x27;translate&#x27;,&#x27;darkmode&#x27;,&#x27;hideAside&#x27;, &#x27;mouse&#x27;]</span><br></pre></td></tr></table></figure><p>在同一文件 <code>button#go-up</code> 后面添加：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/rightside.pug</code> ｜ <strong>改法</strong>：在 <code>button#go-up</code> 后面插入；代码块前半段是已有的 <code>go-up</code>，只加 <code>go-down</code> 那三行，别整段粘。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">button#go-up(type=&quot;button&quot; title=_p(&quot;rightside.back_to_top&quot;))</span><br><span class="line">  span.scroll-percent</span><br><span class="line">  i.fas.fa-arrow-up</span><br><span class="line">button#go-down(type=&quot;button&quot; title=&quot;直达底部&quot; onclick=&quot;btf.scrollToDest(document.body.scrollHeight, 500)&quot;)</span><br><span class="line">  i.fas.fa-arrow-down</span><br></pre></td></tr></table></figure><p>同一文件 <code>when &#39;darkmode&#39;</code> 分支用第 11 项的日月 SVG。<br><code>changeMouseMode()</code> 由第 6 项的 <code>source/js/rightmenu.js</code> 提供。</p>              </div>            </details><h1 id="音乐馆独立页面"><a href="#音乐馆独立页面" class="headerlink" title="音乐馆独立页面"></a>音乐馆独立页面</h1><blockquote><p>借鉴：安知鱼（Fomalhaut 整理）。本站改动：页面分支与标题判断按 5.7.2 重写，音乐页接入本站歌单。</p></blockquote><details class="folding-tag" blue><summary> 音乐馆页面 </summary>              <div class='content'>              <p>在 <code>[Blogroot]\themes\butterfly\layout\page.pug</code> 的 <code>case page.type</code> 里添加分支：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/page.pug</code> ｜ <strong>改法</strong>：在 <code>case page.type</code> 里加 <code>when &#39;music&#39;</code> 分支；<code>when &#39;categories&#39;</code> 那几行是定位用，原文件已有。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">when &#x27;categories&#x27;</span><br><span class="line">  include includes/page/categories.pug</span><br><span class="line">  +commentLoad</span><br><span class="line">when &#x27;music&#x27;</span><br><span class="line">  include includes/page/music.pug</span><br></pre></td></tr></table></figure><p>把同一文件的页面标题判断改成：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/page.pug</code> ｜ <strong>改法</strong>：替换原来那行标题判断，多一个 <code>page.type != &#39;music&#39;</code> 条件，音乐页不显示大标题。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">if top_img === false &amp;&amp; page.type != &#x27;music&#x27; &amp;&amp; page.title</span><br><span class="line">  h1.page-title= page.title</span><br></pre></td></tr></table></figure><p>新建 <code>[Blogroot]\themes\butterfly\layout\includes\page\music.pug</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/page/music.pug</code> ｜ <strong>改法</strong>：新建文件，整段写入；主题已有同名文件就只改 <code>meting-js</code> 的 <code>id</code>（歌单 ID）。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">#anMusic-page</span><br><span class="line">  meting-js(id=&quot;&lt;歌单ID&gt;&quot; server=&quot;netease&quot; type=&quot;playlist&quot; mutex=&quot;true&quot; preload=&quot;auto&quot; theme=&quot;var(--anzhiyu-main)&quot; order=&quot;list&quot;)</span><br></pre></td></tr></table></figure><p>新建 <code>[Blogroot]\source\music\index.md</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/music/index.md</code> ｜ <strong>改法</strong>：新建文件，整段写入；本站已有同名页面（自建音乐网格，front matter 里没有 <code>type: music</code>），要用主题音乐馆模板才补这一行。</p><figure class="highlight markdown"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line">---</span><br><span class="line">title: 音乐馆</span><br><span class="line">date: 2024-10-12 00:45:30</span><br><span class="line">type: music</span><br><span class="line">aside: false</span><br><span class="line"><span class="section">comments: false</span></span><br><span class="line"><span class="section">---</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：顶层 <code>aplayerInject:</code> 键已存在，改 <code>enable</code> / <code>per_page</code> 两个值即可。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">aplayerInject:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">per_page:</span> <span class="literal">true</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.head</code> 和 <code>inject.bottom</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：两行分别追加到已有 <code>inject: head:</code> 和 <code>inject: bottom:</code> 列表，别重复写 <code>inject:</code>；本站这两行现在是注释状态，启用前确认 <code>source/css/music.css</code> 和 <code>source/js/anzhiyu.js</code> 都在。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;stylesheet&quot;</span> <span class="string">href=&quot;/css/music.css&quot;&gt;</span> <span class="comment">#音乐馆</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/anzhiyu.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#音乐馆</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="自定义-404-页面"><a href="#自定义-404-页面" class="headerlink" title="自定义 404 页面"></a>自定义 404 页面</h1><details class="folding-tag" blue><summary> 自定义 404 </summary>              <div class='content'>              <p>新建 <code>[Blogroot]\themes\butterfly\source\404.html</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/source/404.html</code> ｜ <strong>改法</strong>：新建文件，整段写入；主题 <code>source/</code> 下的文件会被原样拷到 <code>public/404.html</code>。</p><figure class="highlight html"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">&lt;!DOCTYPE <span class="keyword">html</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;<span class="name">html</span> <span class="attr">lang</span>=<span class="string">&quot;zh-CN&quot;</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;<span class="name">head</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">meta</span> <span class="attr">charset</span>=<span class="string">&quot;utf-8&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">meta</span> <span class="attr">name</span>=<span class="string">&quot;viewport&quot;</span> <span class="attr">content</span>=<span class="string">&quot;width=device-width, initial-scale=1&quot;</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">title</span>&gt;</span>404 Page Not Found<span class="tag">&lt;/<span class="name">title</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">style</span>&gt;</span><span class="language-css"></span></span><br><span class="line"><span class="language-css">    <span class="selector-tag">body</span> &#123; <span class="attribute">margin</span>: <span class="number">0</span>; <span class="attribute">min-height</span>: <span class="number">100vh</span>; <span class="attribute">display</span>: flex; <span class="attribute">align-items</span>: center;</span></span><br><span class="line"><span class="language-css">      <span class="attribute">justify-content</span>: center; <span class="attribute">background</span>: <span class="number">#1b2838</span>; <span class="attribute">color</span>: <span class="number">#fff</span>;</span></span><br><span class="line"><span class="language-css">      <span class="attribute">font-family</span>: system-ui, sans-serif; <span class="attribute">text-align</span>: center; &#125;</span></span><br><span class="line"><span class="language-css">    <span class="selector-tag">h1</span> &#123; <span class="attribute">font-size</span>: <span class="number">6rem</span>; <span class="attribute">margin</span>: <span class="number">0</span>; <span class="attribute">letter-spacing</span>: .<span class="number">1em</span>; &#125;</span></span><br><span class="line"><span class="language-css">    <span class="selector-tag">p</span> &#123; <span class="attribute">opacity</span>: .<span class="number">7</span>; &#125;</span></span><br><span class="line"><span class="language-css">    <span class="selector-tag">a</span> &#123; <span class="attribute">display</span>: inline-block; <span class="attribute">margin-top</span>: <span class="number">24px</span>; <span class="attribute">padding</span>: <span class="number">10px</span> <span class="number">24px</span>;</span></span><br><span class="line"><span class="language-css">      <span class="attribute">border</span>: <span class="number">1px</span> solid <span class="number">#5ea6e5</span>; <span class="attribute">border-radius</span>: <span class="number">24px</span>; <span class="attribute">color</span>: <span class="number">#5ea6e5</span>;</span></span><br><span class="line"><span class="language-css">      <span class="attribute">text-decoration</span>: none; &#125;</span></span><br><span class="line"><span class="language-css">  </span><span class="tag">&lt;/<span class="name">style</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">head</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;<span class="name">body</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;<span class="name">div</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">h1</span>&gt;</span>404<span class="tag">&lt;/<span class="name">h1</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">p</span>&gt;</span>Page Not Found<span class="tag">&lt;/<span class="name">p</span>&gt;</span></span><br><span class="line">    <span class="tag">&lt;<span class="name">a</span> <span class="attr">href</span>=<span class="string">&quot;/&quot;</span>&gt;</span>返回首页<span class="tag">&lt;/<span class="name">a</span>&gt;</span></span><br><span class="line">  <span class="tag">&lt;/<span class="name">div</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">body</span>&gt;</span></span><br><span class="line"><span class="tag">&lt;/<span class="name">html</span>&gt;</span></span><br></pre></td></tr></table></figure><p>在 <code>[Blogroot]\_config.butterfly.yml</code> 配置：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：替换已有 <code>error_404:</code> 块的值；<code>enable: false</code> 才用上面自己写的静态 <code>404.html</code>，改成 <code>true</code> 会由主题模板生成同路径页面，两个抢同一个文件。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">error_404:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">subtitle:</span> <span class="string">&#x27;Page Not Found&#x27;</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="节日弹窗与农历计算"><a href="#节日弹窗与农历计算" class="headerlink" title="节日弹窗与农历计算"></a>节日弹窗与农历计算</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：弹窗队列与 <code>Sweetalert2</code> 改为本地加载，节日文案按本站配置。</p></blockquote><details class="folding-tag" blue><summary> 节日弹窗 </summary>              <div class='content'>              <p>把 Sweetalert2 官方压缩版放到 <code>[Blogroot]\source\js\sweetalert2.all.js</code>。<br>新建 <code>[Blogroot]\source\js\day.js</code>，写入：</p><p><strong>文件</strong>：<code>[Blogroot]/source/js/day.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；站点已有同名文件就整段覆盖。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> queue = [], loading = <span class="literal">false</span>;</span><br><span class="line">  <span class="variable language_">window</span>.<span class="property">Swal</span> = &#123;</span><br><span class="line">    <span class="attr">fire</span>: <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      queue.<span class="title function_">push</span>(<span class="title class_">Array</span>.<span class="property"><span class="keyword">prototype</span></span>.<span class="property">slice</span>.<span class="title function_">call</span>(<span class="variable language_">arguments</span>));</span><br><span class="line">      <span class="keyword">if</span> (loading) <span class="keyword">return</span>;</span><br><span class="line">      loading = <span class="literal">true</span>;</span><br><span class="line">      <span class="keyword">var</span> s = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;script&#x27;</span>);</span><br><span class="line">      s.<span class="property">src</span> = <span class="string">&#x27;/js/sweetalert2.all.js&#x27;</span>;</span><br><span class="line">      s.<span class="property">onload</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        loading = <span class="literal">false</span>;</span><br><span class="line">        <span class="keyword">var</span> real = <span class="variable language_">window</span>.<span class="property">Swal</span>;</span><br><span class="line">        <span class="keyword">if</span> (!real || !real.<span class="property">fire</span>) <span class="keyword">return</span>;</span><br><span class="line">        queue.<span class="title function_">splice</span>(<span class="number">0</span>).<span class="title function_">forEach</span>(<span class="keyword">function</span> (<span class="params">args</span>) &#123; real.<span class="property">fire</span>.<span class="title function_">apply</span>(real, args); &#125;);</span><br><span class="line">      &#125;;</span><br><span class="line">      s.<span class="property">onerror</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123; loading = <span class="literal">false</span>; queue.<span class="property">length</span> = <span class="number">0</span>; &#125;;</span><br><span class="line">      <span class="variable language_">document</span>.<span class="property">head</span>.<span class="title function_">appendChild</span>(s);</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> table = &#123;</span><br><span class="line">    <span class="string">&#x27;1-1&#x27;</span>: <span class="string">&#x27;元旦快乐&#x27;</span>, <span class="string">&#x27;5-1&#x27;</span>: <span class="string">&#x27;劳动节快乐&#x27;</span>,</span><br><span class="line">    <span class="string">&#x27;10-1&#x27;</span>: <span class="string">&#x27;国庆快乐&#x27;</span>, <span class="string">&#x27;12-25&#x27;</span>: <span class="string">&#x27;圣诞快乐&#x27;</span></span><br><span class="line">  &#125;;</span><br><span class="line">  <span class="keyword">var</span> d = <span class="keyword">new</span> <span class="title class_">Date</span>();</span><br><span class="line">  <span class="keyword">var</span> key = (d.<span class="title function_">getMonth</span>() + <span class="number">1</span>) + <span class="string">&#x27;-&#x27;</span> + d.<span class="title function_">getDate</span>();</span><br><span class="line">  <span class="keyword">if</span> (table[key]) &#123;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;DOMContentLoaded&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="variable language_">window</span>.<span class="property">Swal</span>.<span class="title function_">fire</span>(&#123; <span class="attr">title</span>: table[key], <span class="attr">text</span>: <span class="string">&#x27;今天是个特别的日子&#x27;</span>, <span class="attr">icon</span>: <span class="string">&#x27;info&#x27;</span> &#125;);</span><br><span class="line">    &#125;);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p>农历节日需要时把农历库放到 <code>[Blogroot]\source\js\lunar.js</code>，并在 <code>day.js</code> 之前引入。<br>在 <code>[Blogroot]\_config.butterfly.yml</code> 的 <code>inject.bottom</code> 添加：</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：两行追加到已有 <code>inject: bottom:</code> 列表；<code>lunar.js</code> 必须排在 <code>day.js</code> 前面。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/lunar.js&quot;&gt;&lt;/script&gt;</span> <span class="comment"># 农历计算</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/day.js&quot;&gt;&lt;/script&gt;</span> <span class="comment"># 节日弹窗</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="改完怎么验证与部署"><a href="#改完怎么验证与部署" class="headerlink" title="改完怎么验证与部署"></a>改完怎么验证与部署</h1><p>十节改完先别急着上传，本地按顺序走一遍：</p><ol><li><strong>生成</strong>：在博客根目录执行 <code>hexo generate</code>（或 <code>hexo g</code>）。最后一行出现 <code>Generated</code> 且没有 Pug / Stylus 报错才算过；改过主题模板后报错，多半是缩进或 <code>include</code> 路径写错。</li><li><strong>本地预览</strong>：执行 <code>hexo server</code>（或 <code>hexo s</code>），打开 <code>http://localhost:4000</code>，逐项点到：昼夜切换按钮、美化设置按钮、导航栏宽度、文章页波浪、加载动画、打赏投币、右下角按钮、<code>/music/</code>、随便敲一个不存在的地址看 404、节日弹窗。</li><li><strong>强制刷新或清缓存</strong>：改过 CSS / JS 后按 <code>Ctrl + F5</code>；装了 Service Worker 的再加一步，DevTools → Application → Service Workers 勾 <code>Update on reload</code> 或点 <code>Unregister</code> 后刷新，否则看到的还是旧文件。</li><li><strong>F12 查 404</strong>：Console 里不该有 <code>Uncaught</code>；Network 里 <code>sun_moon.js</code>、<code>meihua.js</code>、<code>nav-fit.js</code>、<code>coin.js</code>、<code>day.js</code> 应是 200。变成 404 基本就是注入路径和文件位置对不上——<code>/js/xxx.js</code> 对应 <code>source/js/xxx.js</code>，<code>/css/xxx.css</code> 对应 <code>source/css/xxx.css</code>。</li><li><strong>上传 <code>public/</code></strong>：按原来的托管方式发布：Nginx 把 <code>public/</code> 同步到站点根目录，GitHub Pages 推 <code>public/</code> 或走 Actions，Vercel 连仓库自动构建，用 <code>hexo deploy</code> 的再跑一次 <code>hexo deploy</code>。上线后换无痕窗口再验一遍，确认线上和本地一致。</li></ol><p>还有一条要记住：<code>themes/butterfly/</code> 里的改动不会跟着主题升级保留，升级前先把自己改过的模板文件备份出来。</p>]]>
    </content>
    <id>https://cookiesky.cn/2026/11/11/hexo-magic2/</id>
    <link href="https://cookiesky.cn/2026/11/11/hexo-magic2/"/>
    <published>2026-11-11T09:40:00.000Z</published>
    <summary>hexo魔改教程（二）</summary>
    <title>hexo魔改教程（二）</title>
    <updated>2026-11-22T17:12:15.678Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="服务器" scheme="https://cookiesky.cn/categories/%E6%9C%8D%E5%8A%A1%E5%99%A8/"/>
    <category term="服务器" scheme="https://cookiesky.cn/tags/%E6%9C%8D%E5%8A%A1%E5%99%A8/"/>
    <content>
      <![CDATA[<h1 id="我的第一台服务器"><a href="#我的第一台服务器" class="headerlink" title="我的第一台服务器"></a>我的第一台服务器</h1><p>今天终于把属于我自己的服务器拿下了，腾讯云2核4G的小小服务器，3年528，虽然配置低低的，但是还是很有成就感的。</p><h2 id="服务器配置"><a href="#服务器配置" class="headerlink" title="服务器配置"></a>服务器配置</h2><ul><li>CPU: 2核</li><li>内存: 4GB</li><li>硬盘: 70GB</li><li>流量: 600GB/月</li></ul><h2 id="服务器用途"><a href="#服务器用途" class="headerlink" title="服务器用途"></a>服务器用途</h2><ul><li>搭建个人博客</li></ul><h2 id="服务器使用"><a href="#服务器使用" class="headerlink" title="服务器使用"></a>服务器使用</h2><p>接下来就是配置服务器啦，这边也记录一下流程，方便以后使用。</p><h3 id="1-安装宝塔面板"><a href="#1-安装宝塔面板" class="headerlink" title="1. 安装宝塔面板"></a>1. 安装宝塔面板</h3><p>宝塔面板是一款服务器管理面板，可以方便的进行服务器管理，安装宝塔面板的命令如下：</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">yum install -y wget &amp;&amp; wget -O install.sh http://download.bt.cn/install/install_6.0.sh &amp;&amp; sh install.sh</span><br></pre></td></tr></table></figure><p>不过我的镜像腾讯云默认安装了宝塔面板，所以不需要再安装了。</p><h3 id="2-安装Nginx等"><a href="#2-安装Nginx等" class="headerlink" title="2. 安装Nginx等"></a>2. 安装Nginx等</h3><p>初次进入宝塔面板，会提示安装Nginx等软件，按照提示安装即可。我时间充足选的完整编译安装<br><img src="/img/posts/my-yun/1.png" alt="安装Nginx"></p>]]>
    </content>
    <id>https://cookiesky.cn/2026/11/10/my-yun/</id>
    <link href="https://cookiesky.cn/2026/11/10/my-yun/"/>
    <published>2026-11-10T08:33:19.000Z</published>
    <summary>今天拿下属于我自己的服务器啦</summary>
    <title>我的第一台服务器</title>
    <updated>2026-11-11T10:19:37.142Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="教育技术学" scheme="https://cookiesky.cn/categories/%E6%95%99%E8%82%B2%E6%8A%80%E6%9C%AF%E5%AD%A6/"/>
    <category term="工具" scheme="https://cookiesky.cn/categories/%E5%B7%A5%E5%85%B7/"/>
    <category term="AI" scheme="https://cookiesky.cn/categories/AI/"/>
    <category term="教育技术学" scheme="https://cookiesky.cn/tags/%E6%95%99%E8%82%B2%E6%8A%80%E6%9C%AF%E5%AD%A6/"/>
    <category term="AI" scheme="https://cookiesky.cn/tags/AI/"/>
    <category term="智能体" scheme="https://cookiesky.cn/tags/%E6%99%BA%E8%83%BD%E4%BD%93/"/>
    <category term="编程教学" scheme="https://cookiesky.cn/tags/%E7%BC%96%E7%A8%8B%E6%95%99%E5%AD%A6/"/>
    <category term="前端" scheme="https://cookiesky.cn/tags/%E5%89%8D%E7%AB%AF/"/>
    <content>
      <![CDATA[<h1 id="初中编程学习小助手"><a href="#初中编程学习小助手" class="headerlink" title="初中编程学习小助手"></a>初中编程学习小助手</h1><p> 扣子搭建智能体后界面太丑了，就给他挂个前端~<a href="https://github.com/HG-dev17/Program-helper">Program-helper</a></p><p><img src="/img/posts/program-helper/welcome.png" alt="初中编程学习小助手"></p><h1 id="一、为什么不是一个“万能答疑机器人”"><a href="#一、为什么不是一个“万能答疑机器人”" class="headerlink" title="一、为什么不是一个“万能答疑机器人”"></a>一、为什么不是一个“万能答疑机器人”</h1><p>初中生学编程，有许多困难：</p><ul><li>有的卡在<strong>概念</strong>——循环、条件、变量到底在干什么；</li><li>有的卡在<strong>报错</strong>——<code>IndentationError</code> 看不懂，代码跑不通就放弃了；</li><li>有的卡在<strong>选题</strong>——想做个小游戏，但不知道从哪下手；</li><li>还有一类不卡技术，只是<strong>没人陪着一起做</strong>。</li></ul><p>一个什么都会的AI，对前三类往往给得太快：直接甩一段能跑的代码，学生抄完就走，什么也没留下。</p><p>所以我把它拆成了四个角色，根据学生的情况会自动路由：</p><div class="table-container"><table><thead><tr><th>角色</th><th>定位</th><th>说话方式</th></tr></thead><tbody><tr><td>讲解员</td><td>讲知识点</td><td>打比方、一步步拆，不直接给答案</td></tr><tr><td>调试伙伴</td><td>陪找 bug</td><td>先问”你觉得哪一行不对”，再引导看报错</td></tr><tr><td>项目教练</td><td>带做小项目</td><td>拆步骤、定里程碑，控制难度</td></tr><tr><td>小码</td><td>同龄学习伙伴</td><td>一起吐槽、一起试错</td></tr></tbody></table></div><h1 id="二、令牌安全"><a href="#二、令牌安全" class="headerlink" title="二、令牌安全"></a>二、令牌安全</h1><p>受到平台的要求和数据的安全，扣子（Coze）的 PAT 不能写在前端 JS 里。</p><p><code>index.js</code> 里写一行 <code>const TOKEN = &quot;pat_xxx&quot;</code>，推到公开仓库，第二天额度就被别人跑光了。所以整个架构应该这样设计：<strong>浏览器永远拿不到令牌</strong>。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">浏览器  ──POST /api/chat（无令牌）──▶  Vercel Edge Function</span><br><span class="line">                                        │ COZE_PAT 存于环境变量</span><br><span class="line">                                        ▼</span><br><span class="line">                                  扣子 v3 Chat API</span><br><span class="line">                                        │</span><br><span class="line">                                        └─ SSE 流式 ─▶ 边收边透传给浏览器</span><br></pre></td></tr></table></figure><p>要点只有三条：</p><ol><li><code>COZE_PAT</code> 只存在平台的 Environment Variables 里，勾成 Secret；</li><li>前端只请求同域的 <code>/api/chat</code>，源码、F12、抓包都搜不到 <code>pat_</code>；</li><li><code>COZE_BOT_ID</code> 在服务端写死，别人没法拿你的代理去调别的智能体。</li></ol><p>仓库里给了三套代理，按部署习惯挑一个：</p><div class="table-container"><table><thead><tr><th>文件</th><th>平台</th><th>说明</th></tr></thead><tbody><tr><td><code>api/chat.js</code></td><td>Vercel Edge</td><td>和页面同域托管，最省事</td></tr><tr><td><code>worker.js</code></td><td>Cloudflare Worker</td><td>国际线路，需要绑自定义域名</td></tr><tr><td><code>deno-proxy.ts</code></td><td>Deno Deploy</td><td>国内访问相对稳</td></tr><tr><td><code>server.js</code></td><td>本地 / VPS</td><td>调试用，强制 IPv4 解析</td></tr></tbody></table></div><h1 id="三、国内网络"><a href="#三、国内网络" class="headerlink" title="三、国内网络"></a>三、国内网络</h1><p>因为vercel国内打不开，只能用自己的域名dns过去，用阿里云加一条 <code>coze-api</code> 的 CNAME。</p><figure class="highlight text"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">类型    主机记录     记录值</span><br><span class="line">CNAME   coze-api    cname.vercel-dns.com（以 Vercel 页面给的为准）</span><br></pre></td></tr></table></figure><h1 id="四、前端页面文件"><a href="#四、前端页面文件" class="headerlink" title="四、前端页面文件"></a>四、前端页面文件</h1><p><code>index.html</code> 是单文件页面（无构建、无框架、无 CDN 依赖），大概 2100 行，做了这些事：</p><ul><li><strong>SSE 流式渲染</strong>：边收边显示，带”思考中 N 秒 / 已生成 N 秒”的计时</li><li><strong>代码块处理</strong>：流式输出时会遇到”代码块还没闭合”的半截状态，需要先当普通文本、闭合后再渲染成代码块，并给每块加复制按钮；</li><li><strong>历史对话</strong>：<code>localStorage</code> 存会话列表，切换时忽略空的助手气泡，恢复后自动滚到底部；</li><li><strong>学号固定身份</strong>：留空自动生成匿名标识，填了学号就固定下来，方便智能体记住”这是同一个人”；</li><li><strong>模式切换</strong>：默认走本站代理；也可以在设置里勾”使用我自己的令牌直连扣子”，消耗自己的额度；</li><li><strong>临时换代理</strong>：不想重新部署时，在网址后面加 <code>?proxy=https://别的代理</code> 就能切。</li></ul><p><strong>主题切换</strong>做了亮/暗两套 CSS 变量。</p><h1 id="五、错误码速查"><a href="#五、错误码速查" class="headerlink" title="五、错误码速查"></a>五、错误码速查</h1><p>调试阶段的几个错误：</p><div class="table-container"><table><thead><tr><th>提示</th><th>原因</th><th>处理</th></tr></thead><tbody><tr><td>错误 4015</td><td>智能体没发布到「Agent as API」</td><td>扣子 → 发布 → 渠道 → Agent as API</td></tr><tr><td>错误 401 / 4100</td><td>令牌无效、过期或无权限</td><td>重新生成 PAT 并更新平台 Secret</td></tr><tr><td>错误 404（代理模式）</td><td><code>proxyBase</code> 没配或路径不对</td><td>先访问 <code>/api/health</code> 自检</td></tr><tr><td>Failed to fetch</td><td>网络不通、校园网 IPv6 拦截、<code>workers.dev</code> 被墙</td><td>换网络 / 用 vercel 或自定义域名</td></tr></tbody></table></div><h1 id="六、上线清单"><a href="#六、上线清单" class="headerlink" title="六、上线清单"></a>六、上线清单</h1><ul><li>[ ] 吊销所有写进过前端的旧令牌，重新生成；</li><li>[ ] 新令牌只进平台 Secret，不进仓库；</li><li>[ ] <code>.gitignore</code> 里排除含明文令牌的演示文件；</li><li>[ ] <code>ALLOW_ORIGIN</code> 限制成自己的页面域名；</li><li>[ ] <code>COZE_BOT_ID</code> 服务端锁定；</li><li>[ ] 给 <code>/api/chat</code> 加每 IP 限流，防止额度被刷。</li></ul><h1 id="七、它现在能做什么"><a href="#七、它现在能做什么" class="headerlink" title="七、它现在能做什么"></a>七、它现在能做什么</h1><ul><li>学生打开网页就能聊，不用注册、不用装 App、不用填任何密钥；</li><li>电脑课、自习课、回家写作业都能用同一套入口；</li><li>老师不用维护服务器（Vercel 免费额度足够一个班用）；</li><li>想改提示词、改角色设定，在扣子后台改，前端不用重新部署。</li></ul><p>代码都在 <a href="https://github.com/HG-dev17/Program-helper">HG-dev17/Program-helper</a>，README 里写了从发布智能体到配 DNS 的完整步骤。</p>]]>
    </content>
    <id>https://cookiesky.cn/2026/10/19/program-helper/</id>
    <link href="https://cookiesky.cn/2026/10/19/program-helper/"/>
    <published>2026-10-19T15:48:00.000Z</published>
    <summary>用扣子多智能体做一个初中编程学习助手</summary>
    <title>初中编程学习小助手</title>
    <updated>2026-11-18T05:28:36.759Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="编程语言" scheme="https://cookiesky.cn/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/"/>
    <category term="工具" scheme="https://cookiesky.cn/categories/%E5%B7%A5%E5%85%B7/"/>
    <category term="GXNU" scheme="https://cookiesky.cn/categories/GXNU/"/>
    <category term="前端" scheme="https://cookiesky.cn/tags/%E5%89%8D%E7%AB%AF/"/>
    <category term="Flask" scheme="https://cookiesky.cn/tags/Flask/"/>
    <category term="JavaScript" scheme="https://cookiesky.cn/tags/JavaScript/"/>
    <category term="校园" scheme="https://cookiesky.cn/tags/%E6%A0%A1%E5%9B%AD/"/>
    <category term="全栈" scheme="https://cookiesky.cn/tags/%E5%85%A8%E6%A0%88/"/>
    <content>
      <![CDATA[<p>三月份去实习帮云衢中学做了一套<strong>学生奖惩公示系统</strong>，跑在教学楼走廊的展示屏上。</p><p>普通的网页都好办，但因为那块屏是<strong>一台 Android 4.4 的老设备</strong>，导致很多新的前端方式都运用不上。</p><p>仓库：<a href="https://github.com/HG-dev17/yunqu">HG-dev17/yunqu</a> · 线上：<a href="https://yunqu.cookiesky.cn">yunqu.cookiesky.cn</a></p><h1 id="一、需求"><a href="#一、需求" class="headerlink" title="一、需求"></a>一、需求</h1><p>现实中要解决的事很简单：</p><ol><li>学校要<strong>公开表彰与批评</strong>，鼓励和警告学生的平时行为；</li><li>数据由德育处、年级处老师录，老师是不碰代码的，只能做后端；</li><li>换学期要能一键切换，历史记录要能查；</li><li>手机、旧平板、走廊那台老盒子，都得能打开。</li></ol><h1 id="二、技术选型"><a href="#二、技术选型" class="headerlink" title="二、技术选型"></a>二、技术选型</h1><p>第一版就定了：<strong>展示端是纯静态页，数据放 CSV。</strong></p><p>理由很实际：</p><ul><li>学校没有服务器，也没有人运维；</li><li>静态托管免费、不会挂；</li><li>CSV 用 Excel 和 WPS 都能打开，老师看得懂；</li><li>改一条记录 = 改一行文本，出问题能直接看出来。</li></ul><p>数据目录长这样：</p><figure class="highlight text"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line">data/</span><br><span class="line">├── semesters.csv          # 学期索引：key,name,start_date,end_date,file</span><br><span class="line">├── 2024-2025-1.csv        # 每学期一个记录文件</span><br><span class="line">├── 2024-2025-2.csv</span><br><span class="line">├── 2025-2026-1.csv</span><br><span class="line">├── 2025-2026-2.csv</span><br><span class="line">├── announcement.csv       # 公告（文本/图片/视频 + 适用年级）</span><br><span class="line">├── countdown.csv          # 倒计时配置</span><br><span class="line">├── img/  video/           # 公告附件</span><br></pre></td></tr></table></figure><p><code>semesters.csv</code> 可以定义新的学期：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">key,name,start_date,end_date,file</span><br><span class="line">current_semester,2025-2026学年第二学期,2026-02-17,2026-07-15,2025-2026-2.csv</span><br><span class="line">last_semester,2025-2026学年第一学期,2025-09-01,2026-01-20,2025-2026-1.csv</span><br></pre></td></tr></table></figure><p>页面按今天的日期落在哪个区间，自动判断“当前学期”，再加载对应文件。这样换学期只需要改一行日期。</p><h1 id="三、Android-4-4-的解决办法"><a href="#三、Android-4-4-的解决办法" class="headerlink" title="三、Android 4.4 的解决办法"></a>三、Android 4.4 的解决办法</h1><p>第一次上机测试就翻了：白屏、滚不动、按钮错位。</p><p>原因是——那台设备的内核老到<strong>没有 <code>fetch</code>，没有 <code>Promise</code>，没有 <code>async/await</code></strong>，连 <code>Array.prototype.forEach</code> 都要靠 polyfill 补。</p><p>于是整个 <code>js/script.js</code> 被改写成 <strong>ES5 + XHR 回调</strong>：</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> (!<span class="title class_">Array</span>.<span class="property"><span class="keyword">prototype</span></span>.<span class="property">forEach</span>) &#123;</span><br><span class="line">    <span class="title class_">Array</span>.<span class="property"><span class="keyword">prototype</span></span>.<span class="property">forEach</span> = <span class="keyword">function</span> (<span class="params">callback, thisArg</span>) &#123;</span><br><span class="line">        <span class="keyword">var</span> T, k;</span><br><span class="line">        <span class="keyword">if</span> (<span class="variable language_">this</span> == <span class="literal">null</span>) <span class="keyword">throw</span> <span class="keyword">new</span> <span class="title class_">TypeError</span>(<span class="string">&#x27;this is null or not defined&#x27;</span>);</span><br><span class="line">        <span class="comment">// ……标准 polyfill</span></span><br><span class="line">    &#125;;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">fetchText</span>(<span class="params">url, cb</span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> xhr = <span class="keyword">new</span> <span class="title class_">XMLHttpRequest</span>();</span><br><span class="line">    xhr.<span class="title function_">open</span>(<span class="string">&#x27;GET&#x27;</span>, url, <span class="literal">true</span>);</span><br><span class="line">    xhr.<span class="property">onreadystatechange</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">        <span class="keyword">if</span> (xhr.<span class="property">readyState</span> === <span class="number">4</span>) &#123;</span><br><span class="line">            <span class="keyword">if</span> (xhr.<span class="property">status</span> &gt;= <span class="number">200</span> &amp;&amp; xhr.<span class="property">status</span> &lt; <span class="number">300</span>) <span class="title function_">cb</span>(<span class="literal">null</span>, xhr.<span class="property">responseText</span>);</span><br><span class="line">            <span class="keyword">else</span> <span class="title function_">cb</span>(<span class="keyword">new</span> <span class="title class_">Error</span>(<span class="string">&#x27;HTTP &#x27;</span> + xhr.<span class="property">status</span>));</span><br><span class="line">        &#125;</span><br><span class="line">    &#125;;</span><br><span class="line">    xhr.<span class="title function_">send</span>();</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>这带来两个连锁问题：</p><ul><li><strong>回调地狱</strong>：学期索引 → 记录文件 → 公告 → 渲染，四层嵌套。解决办法是把每层拆成独立函数 + 一个 <code>cb</code> 参数，用命名函数而不是匿名嵌套；</li><li><strong>没有 <code>AbortController</code></strong>：滚动/切学期时没法取消旧请求，只能在回调里校验“这是不是当前学期”，过期结果直接丢弃。</li></ul><p>还有一个隐蔽的坑：<strong>BOM</strong>。Excel 另存的 CSV 是带 BOM 的 UTF-8，第一个字段会变成 <code>\ufeffkey</code>，对象取值永远 <code>undefined</code>。后来统一用：</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">function</span> <span class="title function_">stripBOM</span>(<span class="params">s</span>) &#123;</span><br><span class="line">    <span class="keyword">return</span> s &amp;&amp; s.<span class="title function_">charCodeAt</span>(<span class="number">0</span>) === <span class="number">0xFEFF</span> ? s.<span class="title function_">slice</span>(<span class="number">1</span>) : s;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>服务器导出时也统一写 <code>encoding=&#39;utf-8-sig&#39;</code>。</p><h1 id="四、展示端"><a href="#四、展示端" class="headerlink" title="四、展示端"></a>四、展示端</h1><p>大屏场景和网页场景完全不同：<strong>没有鼠标、没有触摸、也没人管它</strong>。</p><p>所以做了这些：</p><ul><li><strong>奖惩榜自动滚动</strong>：整块列表匀速上移，到底部无缝回顶；</li><li><strong>公告栏自动轮播</strong>：多条公告按顺序播，可含图片和视频，视频播完自动下一条；</li><li><strong>暂停/重置</strong>：给维护老师留两个按钮，不被学生乱点；</li><li><strong>左右两栏</strong>：左奖惩、右公告，把 16:9 的屏用满（1.0.4.29 版本从上下布局改的）；</li><li><strong>倒计时</strong>：直接读 <code>countdown.csv</code>，中考倒计时按”天”刷新。</li></ul><p>自动滚动的实现没有用 CSS 动画（旧内核的 <code>transform</code> 动画会抖），而是 <strong>JS 定时器 + <code>translateY</code></strong>，速度可调（<code>scrollSpeed = 30</code>）。手动滚动模式后来又单独修了一轮，解决“滚动留白和抽动”——根因是间隙高度算错，回顶时跳了一格。</p><h1 id="五、公告栏"><a href="#五、公告栏" class="headerlink" title="五、公告栏"></a>五、公告栏</h1><p>公告最初只是一段文字，后来老师的需求一条条加上来：</p><div class="table-container"><table><thead><tr><th>版本</th><th>加了什么</th></tr></thead><tbody><tr><td>1.0.2.5</td><td>公告栏 + 公告管理界面</td></tr><tr><td>1.0.5.13</td><td>支持图片、视频；内容允许为空；图片点击放大</td></tr><tr><td>1.0.6.8</td><td>自动滚动、视频自动播放、按年级筛选</td></tr></tbody></table></div><p><code>announcement.csv</code> 就多了几列：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">text,grade,image,video,time</span><br><span class="line">&quot;眼保健操的管理提醒……&quot;,初三,,,2026-03-30</span><br><span class="line">,初二,goodclass.jpg,,2026-03-24</span><br></pre></td></tr></table></figure><p><code>text</code> 允许为空，只展示图片或视频——这一条看起来小，但它把”公告”从<strong>通知</strong>变成了<strong>展示板</strong>，老师可以直接贴流动红旗的照片。</p><h1 id="六、管理端与本地服务"><a href="#六、管理端与本地服务" class="headerlink" title="六、管理端与本地服务"></a>六、管理端与本地服务</h1><p>展示端是静态的，但录入需要一个能改数据的界面。</p><p><code>admin.html</code> 直接读写同一批 CSV（配合本地起服务），<code>all_semesters.html</code> 做跨学期汇总。</p><p>真正做“在线可编辑”时，才加了 <code>server.py</code>：</p><figure class="highlight text"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">Flask + SQLite</span><br><span class="line">├── GET    /api/semesters</span><br><span class="line">├── POST   /api/records</span><br><span class="line">├── PUT    /api/records/&lt;id&gt;</span><br><span class="line">├── DELETE /api/records/&lt;id&gt;</span><br><span class="line">└── GET    /api/export/&lt;semester&gt;   # 导出回 CSV</span><br></pre></td></tr></table></figure><p>因为没有服务器，无法修改静态的网页，设计上选择了：<strong>数据库只做“编辑期的暂存”，最终导出CSV进行替换。</strong></p><p>老师改完点导出 → 写回 <code>data/*.csv</code> → 提交仓库 → 静态站自动更新。</p><p>还加了一个”从 CSV 导入数据库”的逻辑，并且判断”该学期是否已有数据，有就跳过”，避免每次重启把老师的编辑覆盖掉。</p><h1 id="七、版本日志"><a href="#七、版本日志" class="headerlink" title="七、版本日志"></a>七、版本日志</h1><p>我把每次改动都记在 README 里，从 <code>1.0.0.0</code> 到 <code>1.0.6.8</code>，一共三十多次提交。回头看，<strong>真正花时间的地方几乎都不是功能</strong>：</p><ul><li>兼容旧内核（3 次紧急修复）；</li><li>时间格式（<code>2026/3/18</code> 和 <code>2026-03-18</code> 混用导致筛选全空）；</li><li>缓存（旧浏览器必须手动刷新才更新，最后给资源加版本参数解决）；</li><li>删除数据时弹三次确认框（事件重复绑定）。</li></ul>]]>
    </content>
    <id>https://cookiesky.cn/2026/04/23/yunqu/</id>
    <link href="https://cookiesky.cn/2026/04/23/yunqu/"/>
    <published>2026-04-23T03:49:00.000Z</published>
    <summary>从零做一个奖惩公示系统：CSV 单一数据源、兼容 Android 4.4、公告轮播与管理端</summary>
    <title>一块旧安卓屏背后的全栈小工程</title>
    <updated>2026-11-18T05:28:36.773Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="编程语言" scheme="https://cookiesky.cn/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/"/>
    <category term="GXNU" scheme="https://cookiesky.cn/categories/GXNU/"/>
    <category term="比赛" scheme="https://cookiesky.cn/categories/%E6%AF%94%E8%B5%9B/"/>
    <category term="Python" scheme="https://cookiesky.cn/tags/Python/"/>
    <content>
      <![CDATA[<h1 id="赛题介绍"><a href="#赛题介绍" class="headerlink" title="赛题介绍"></a>赛题介绍</h1><h2 id="一、赛事背景"><a href="#一、赛事背景" class="headerlink" title="一、赛事背景"></a>一、赛事背景</h2><p>在全球化的浪潮中，语音技术已成为打破语言壁垒、增进文化交流的关键桥梁，然而，在低资源语言领域，行业内往往难以积累足够的语音数据以供模型训练，使得现有的语种分类系统在这些语言上的表现远不及主流语言。其次，语种分类技术在短语流、高噪声和实时场景的判别准确性仍然是工业界的一个技术难题。</p><p>鉴于此，我们希望通过举办“面向受限场景的低资源多语种分类”竞赛来激发全球研究学者、技术开发者和语音技术爱好者的创新热情，共同研究和开发适用于受限场景的低资源的多语种分类技术。</p><h2 id="二、赛事任务"><a href="#二、赛事任务" class="headerlink" title="二、赛事任务"></a>二、赛事任务</h2><p>本次比赛的任务是开发一个面向受限场景下的低资源语种分类模型，这里受限场景指的是（1）每一位参赛者仅能使用提供音频1s以内的时长信息（含1s）就需要抛出语种分类的结果；（2）测试数据中覆盖了不同的噪声；本次比赛提供的测试集数据中包括了小于1s和大于等于1s的音频，其中针对大于1s的音频，参赛者只能使用前1s的信息（如果发现使用1s以后的音频信息则取消比赛资格）。</p><p>数据参赛者需要利用提供的低资源的开源语音数据集和噪声数据，训练一个高准确率和鲁棒的语种分类模型，并在测试集上进行评估。具体如下：</p><p>（一）数据</p><p>数据集请使用FLEURS开源数据来完成模型训练和验证，本次比赛面向低资源语种，因此请使用FLEURS中低资源语种；我们同时提供了开源噪声数据集MUSAN下载链接；数据集情况说明和下载链接如下：</p><p>数据介绍：<a href="https://huggingface.co/datasets/google/fleurs">https://www.openslr.org/17</a></p><p>MUSAN数据集下载链接：<a href="https://www.openslr.org/17">https://www.openslr.org/17</a></p><p>低资源语种限定范围：斯瓦希里语，阿姆哈拉语，阿萨姆语，约鲁巴语，尼泊尔语，冰岛语，卢森堡语，豪萨语，林加拉语，祖鲁语，信德语，马耳他语，爱沙尼亚语，吉尔吉斯语，旁遮普语，立陶宛语，白俄罗斯语，威尔士语，索马里语</p><p>即标签限定范围：<code>[&#39;swahili&#39; &#39;amharic&#39; &#39;assamese&#39; &#39;yoruba&#39; &#39;nepali&#39; &#39;icelandic&#39; &#39;luxembourgish&#39; &#39;hausa&#39; &#39;lingala&#39; &#39;zulu&#39; &#39;sindhi&#39; &#39;maltese&#39; &#39;estonian&#39; &#39;kyrgyz&#39; &#39;punjabi&#39; &#39;lithuanian&#39; &#39;belarusian&#39; &#39;welsh&#39; &#39;somali&#39;]</code></p><h2 id="三、评审规则"><a href="#三、评审规则" class="headerlink" title="三、评审规则"></a>三、评审规则</h2><ol><li><p>评估指标<br>本题评估指标设置为<code>recall</code>召回率（average设置为macro）。</p></li><li><p>评测及排行<br>1）比赛提供下载数据，选手在本地进行算法调试，在比赛页面提交结果。<br>请注意：测试集仅可用于输出最终的推理结果，不可以任何形式参与训练过程。<br>2）排行按照得分从高到低排序，排行榜将选择团队的历史最优成绩进行排名。</p></li></ol><h2 id="四、作品提交要求"><a href="#四、作品提交要求" class="headerlink" title="四、作品提交要求"></a>四、作品提交要求</h2><ol><li>文件格式：按照txt格式提交，编码为UTF-8，提交格式见样例</li><li>文件大小：无要求</li><li>提交次数限制：每支队伍每天最多3次</li><li>排行榜更新结束后，前三名选手需要提交代码、模型和说明文档</li><li>提交样例：<figure class="highlight txt"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">00001 belarusian</span><br></pre></td></tr></table></figure></li></ol><p>测试音频名+Tab键+语种分类结果</p><h2 id="五、赛程规则"><a href="#五、赛程规则" class="headerlink" title="五、赛程规则"></a>五、赛程规则</h2><ul><li>本赛题实行一轮赛制</li></ul><p>【赛程周期】<br>9月26日-10月30日</p><ol><li>9月26日10:00发布训练集、开发集、测试集（即开启比赛榜单）</li><li>比赛作品提交截止日期为10月30日17:00，公布名次日期为11月中旬</li></ol><h1 id="解决方案及算法"><a href="#解决方案及算法" class="headerlink" title="解决方案及算法"></a>解决方案及算法</h1><h2 id="比赛流程"><a href="#比赛流程" class="headerlink" title="比赛流程"></a>比赛流程</h2><p>看完赛题，首先因为笔记本算力有限、网络有限，因此本团队将<code>开源</code>数据集<a href="https://www.openslr.org/17/">musan</a>和<a href="https://huggingface.co/datasets/google/fleurs">fluers</a>下载至本地来运行（fluers仅下载比赛需要的19种低资源数据集）。<br>随后，我先编写了一个使用卷积模型的训练脚本与对应推理脚本，将比赛提供的测试集推理出来提交，发现recall召回率（average设置为macro，此召回率应该是排行中的得分）得分仅<code>0.05</code>,因此，我们认识到CNN仍主要用于图像，对音频类处理表现并不佳。<br>接着我们尝试分析其音频频谱等特征，转为图片来尝试卷积模型训练，发现其频谱特征可能与语种分类有关，但训练后推理仍仅得分<code>0.20</code>左右，因此我们决定使用<code>开源</code>模型<a href="https://huggingface.co/facebook/mms-lid-256">mms-lid-256</a>进行训练，推理，最终得分<code>0.42</code>左右。<br>注意：mms-lid-256模型是facebook开源的，基于wav2vec2模型，wav2vec2模型是facebook开源的，基于Transformer的音频分类模型，其训练数据为LibriSpeech数据集，符合此赛题FAQ种允许使用的开源模型，因此我们使用该模型进行训练推理。</p><h2 id="数据预处理"><a href="#数据预处理" class="headerlink" title="数据预处理"></a>数据预处理</h2><p>数据预处理方面：我们使用<code>开源</code>数据集<a href="https://www.openslr.org/17/">musan</a>进行数据增强，使用<code>开源</code>数据集<a href="https://huggingface.co/datasets/google/fleurs">fluers</a>进行训练，使用比赛提供的测试集进行推理。<br>首先我随机读取了部分数据，发现如果按照比赛说的低资源要求：仅使用前1s的音频数据来推理，但如果全使用前1s的音频来进行训练，那么部分音频前1s可能是空白，没有人声，训练可能效果不佳，因此我采用的数据预处理方法是将fluers数据集切分为1s的音频片段，将所有的1s音频片段进行训练。（因为推理是1s的素材，因此采用1s的音频片段进行训练效果最好）<br><code>注意：推理仅使用前1s的音频，符合比赛要求，并未使用1s后的音频。比赛提供的测试集并未以任何形式参与训练</code></p><p>针对未满1s的素材，留空（补零）会给模型误导信息，因此，我们采用的方法是，如果素材长度小于1s，则将素材复制，直到素材长度为1s，再进行训练。而大于1s的数据则直接切分为1s的音频，仅使用前1s来推理。</p><p>我们采用了musan数据集进行数据增强，增强模型的鲁棒性</p><h2 id="模型训练"><a href="#模型训练" class="headerlink" title="模型训练"></a>模型训练</h2><p>模型训练方面：我们使用<code>开源</code>模型<a href="https://huggingface.co/facebook/mms-lid-256">mms-lid-256</a>进行训练，训练时，我们采用<code>断点续训</code>的方式，即如果训练过程中断，则从上次训练的epoch继续训练，而不是重新开始训练，这样可以节省时间，同时也可以避免因为训练中断而导致的数据丢失。<br>这样做的好处是：</p><ol><li>作为笔记本电脑，显存有限、内存有限，因此加载全部数据集训练会导致爆显存，因此，我们会每隔一段进度保存一次检查点。这样，如果训练中断，我们可以从上次保存的检查点继续训练，而不是重新开始训练。</li><li>为了确保连续性，除了保存检查进度，还需保存训练进度。</li></ol><p>但是仍有缺陷，例如第二次载入时训练可能会降低模型的训练效果，导致模型训练不佳，因此尽量一次训练完成，或者第二次载入时需要等待到模型loss值稳定以及acc值稳定后才能保证训练效果。</p><h2 id="模型推理"><a href="#模型推理" class="headerlink" title="模型推理"></a>模型推理</h2><p>模型推理方面，也是采用与训练时同样的数据处理方法，但比赛要求推理的测试集仅允许使用前1s的音频数据，因此按此方式进行数据预处理。然后按照流程开始推理，输出<code>submission.txt</code>结果文件来提交。</p><h2 id="优化"><a href="#优化" class="headerlink" title="优化"></a>优化</h2><p>我们记录了详细的训练日志、推理日志、以及采用数据增强、训练方法、训练进度等，还输出了热力图来显示模型的训练效果，以便我们更好地了解模型的训练情况，从而更好地优化模型。</p><h1 id="模型训练复现流程"><a href="#模型训练复现流程" class="headerlink" title="模型训练复现流程"></a>模型训练复现流程</h1><h2 id="项目说明"><a href="#项目说明" class="headerlink" title="项目说明"></a>项目说明</h2><p>本项目主要包含两个脚本：</p><ul><li><code>train.py</code>：基于开源模型的语种分类模型训练（支持断点续训、MUSAN 增强、验证与测试评估）。</li><li><code>g.py</code>：批量推理，将测试集 <code>wav</code> 文件分类为目标语种。</li></ul><p>目标在比赛中使用的运行环境为 Windows11（VScode powershell终端），Python 3.12.3，CPU。</p><p><code>本项目遵守比赛规则以及赛题FAQ</code></p><ol><li>赛事材料基本使用要求<br>本次大赛提供的全部数据、信息等，视为科大讯飞的保密信息。未经允许，任何人不可以任何形式使用、传播、披露、授权他人使用。</li><li>选手参赛基本原则<br>作品必须健康、合法、无任何不良信息及商业宣传行为，不违反任何中华人民共和国有关法律。须保证原创性，不侵犯任何第三方知识产权或其他权利；一经发现或经权利人指出，主办方将直接取消其参赛资格，科大讯飞保留赛事解释权。</li><li>作弊行为界定及处罚<br>一旦发现任何利用平台或规则漏洞进行作弊的行为，以及其他一切使用不良手段影响竞赛公平、公正的行为，赛事组委会有权取消该选手成绩。尤其是同一团队组建多支队伍提交多次结果的刷榜行为，一经发现则取消所有雷同队伍的成绩。赛事组委会保留最终解释权。</li><li>数据集使用基础规范<br>选手按照赛事要求下载官方数据集进行比赛，请注意测试集仅可用于输出最终的推理结果，不可以任何形式参与训练过程。如有违反一经发现，取消其参赛资格。</li><li>是否允许使用除官方数据集之外的其他数据？如果允许，是否有限制，例如数据来源、数据集规模或数据处理方式？<br>允许使用FLEURS数据集之外的其他开源数据。但提交的报告必须明确使用的开源数据集信息。</li><li>是否允许使用预训练模型？如果允许，是否对预训练模型来源有限制，例如官方、开源、第三方训练？<br>可以使用<code>开源预训练模型</code>。</li><li>是否允许使用开源大模型？是否允许使用闭源大模型或API？<br><code>允许使用开源大模型</code>，但不允许使用闭源大模型或API。</li><li>是否允许选手将数据集用于科研或论文发表？<br>可以。</li></ol><h3 id="注意"><a href="#注意" class="headerlink" title="注意"></a>注意</h3><p>本次使用<code>开源</code>数据集<a href="https://www.openslr.org/17/">musan</a>和<a href="https://huggingface.co/datasets/google/fleurs">fluers</a><br>本项目使用的<code>开源</code>模型：<a href="https://huggingface.co/facebook/mms-lid-256">mms-lid-256</a><br>本项目不使用比赛提供的测试集以任何形式参与训练过程</p><hr><h2 id="一、环境准备"><a href="#一、环境准备" class="headerlink" title="一、环境准备"></a>一、环境准备</h2><h3 id="1-安装-Python"><a href="#1-安装-Python" class="headerlink" title="1. 安装 Python"></a>1. 安装 Python</h3><ul><li>推荐 Python 3.12.3。</li><li>在 powershell 运行 <code>python --version</code> 确认。</li></ul><h4 id="创建虚拟环境"><a href="#创建虚拟环境" class="headerlink" title="创建虚拟环境"></a>创建虚拟环境</h4><figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">conda create <span class="literal">-n</span> fluers python=<span class="number">3.12</span>.<span class="number">3</span></span><br></pre></td></tr></table></figure><p>运行上述代码会安装默认的python库以及安装python 3.12.3版本<code>（按y确认安装）</code>,如果不安装虚拟环境，请默认安装以上库</p><p>进入虚拟环境<br><figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">conda activate fluers</span><br></pre></td></tr></table></figure></p><h3 id="2-安装依赖"><a href="#2-安装依赖" class="headerlink" title="2. 安装依赖"></a>2. 安装依赖</h3><p><code>安装依赖以及后续启动请在环境内运行</code><br>默认依赖（CPU 或已安装匹配 CUDA 的 PyTorch）：<br><figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">pip install <span class="literal">-r</span> requirements.txt</span><br></pre></td></tr></table></figure></p><p><code>注意：本次比赛我们团队采用的是cuda 12.6</code><br>训练代码会根据设备选择batch_size,cuda是4,cpu是2,但比赛我们使用的是4的batch_size</p><p>如需安装特定 CUDA 版本的 PyTorch（示例：CUDA 12.6）：</p><figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">pip install torch torchvision <span class="literal">--index-url</span> https://download.pytorch.org/whl/cu126</span><br><span class="line">pip install torchaudio</span><br></pre></td></tr></table></figure><hr><p>如果因为电脑版本问题，导致库的安装出现问题，可以在运行代码时发现no modules xxx，然后根据报错信息，去pip对应的库进行安装</p><p><code>注意，建议使用cuda，这样batch_size与我们团队训练的一致，有更好的复现效果。</code></p><h2 id="二、准备模型与数据"><a href="#二、准备模型与数据" class="headerlink" title="二、准备模型与数据"></a>二、准备模型与数据</h2><p>项目会读取以下目录（相对于项目根目录）：</p><ul><li><p>预训练模型目录（必须）：</p><ul><li><code>user_data/models/mms-lid-256/</code></li><li>内容应包含 <code>config.json</code>、权重（<code>.safetensors</code> 或 <code>.bin/.pt</code>）、<code>preprocessor_config.json</code> 等。</li></ul></li><li><p>HF 数据集缓存（默认是离线运行，因此需要将数据集下载至本地）：</p><ul><li><code>user_data/datasets/</code></li><li><code>train.py</code> 默认设置 <code>TRANSFORMERS_OFFLINE=1</code> 与 <code>HF_DATASETS_OFFLINE=1</code>，需提前缓存 FLEURS 数据集或改为在线模式（见下）。</li></ul></li><li><p>MUSAN 数据集（可选，用于噪声增强）：</p><ul><li><code>user_data/musan/</code>，内部包含 <code>music/</code>、<code>noise/</code>、<code>speech/</code> 各自的 <code>wav</code> 文件。</li></ul></li><li><p>推理测试集（<code>g.py</code> 使用）：</p><ul><li><code>xfdata/testset/</code> 下放置 <code>*.wav</code> 文件，文件名形如 <code>iflytek_123.wav</code> 便于数值排序。</li></ul></li></ul><p>输出目录（自动创建）：</p><ul><li>训练日志与检查点：<code>user_data/tmp_data/</code>、<code>user_data/model_data/</code></li><li>推理结果：<code>prediction_result/result/submission.txt</code></li></ul><hr><h2 id="三、在线-离线模式说明（仅训练）"><a href="#三、在线-离线模式说明（仅训练）" class="headerlink" title="三、在线/离线模式说明（仅训练）"></a>三、在线/离线模式说明（仅训练）</h2><p><code>注意，本次比赛本团队采用离线训练，因此数据集全部保存在本地</code><br><code>train.py</code> 在开头设置了环境变量：</p><ul><li><code>TRANSFORMERS_OFFLINE=1</code>，<code>HF_DATASETS_OFFLINE=1</code></li></ul><p>含义：强制离线。若未提前缓存 FLEURS 数据集，会报错退出。解决方案二选一：</p><ul><li>方案 A（推荐）：提前在同一环境中在线下载并缓存数据集与模型，然后再切回离线。</li><li>方案 B：临时改为在线模式（修改 <code>train.py</code> 中对应环境变量为 <code>&#39;0&#39;</code>），首次运行自动下载并缓存，后续可再切回离线。</li></ul><hr><h2 id="四、运行训练"><a href="#四、运行训练" class="headerlink" title="四、运行训练"></a>四、运行训练</h2><p><code>请在对应环境下运行</code><br>有两种方式开始训练</p><ol><li>方法一：（推荐）进入<code>code/train</code>目录，运行<code>train.py</code>脚本<figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python train.py</span><br></pre></td></tr></table></figure></li><li>或者方法二：进入<code>code</code>目录，运行<code>train.sh</code>脚本,（注：Windows powershell可能无法进入conda环境，因此推荐使用方法一）<figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">./train.sh</span><br></pre></td></tr></table></figure><code>如果使用虚拟环境，请使用方法一</code></li></ol><p>说明：</p><ul><li>首次运行将初始化并开始训练。</li><li>如检测到 <code>mms_latest_checkpoint.pth</code>，会询问是否继续训练。</li><li>训练过程中会在 <code>user_data/model_data/</code> 保存检查点，最佳模型另存为 <code>mms_best_model.pth</code>。</li><li>训练结束会输出训练/验证曲线图 <code>mms_training_history.png</code>，并在测试集上评估。</li><li>（注，此测试集不是比赛赛题的测试集，比赛测试集并未以任何形式参与训练）</li><li>如果Windows加载不了sh脚本，可以采用git bash或者以方法一来开始训练</li></ul><p><code>重要：复现请训练至少1个epoch，中途如果硬件允许请不要中断训练，recall得分应该都在0.4左右</code></p><hr><h2 id="五、运行推理"><a href="#五、运行推理" class="headerlink" title="五、运行推理"></a>五、运行推理</h2><p><code>请在对应环境下运行</code><br>有两种方式开始推理</p><ol><li>方法一：（推荐）进入<code>code/test</code>目录，运行<code>g.py</code>脚本<figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python g.py</span><br></pre></td></tr></table></figure></li><li>或者方法二：进入<code>code</code>目录，运行<code>test.sh</code>脚本（注：Windows powershell可能无法进入conda环境，因此推荐使用方法一）<figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">./test.sh</span><br></pre></td></tr></table></figure><code>如果使用虚拟环境，请使用方法一</code></li></ol><p>说明：</p><ul><li>自动从以下路径按优先级加载模型：<ul><li><code>user_data/model_data/mms_best_model.pth</code></li><li><code>user_data/model_data/mms_latest_checkpoint.pth</code></li><li><code>user_data/model_data/mms_final_checkpoint.pth</code></li><li>若以上缺失，会在当前目录尝试同名文件。</li></ul></li><li>扫描 <code>xfdata/testset/</code> 下所有 <code>wav</code>，批量推理并将结果写入 <code>prediction_result/result/submission.txt</code>。</li><li>如果Windows加载不了sh脚本，可以采用git bash或者以方法一来开始推理</li></ul><hr><h2 id="六、目录结构示例"><a href="#六、目录结构示例" class="headerlink" title="六、目录结构示例"></a>六、目录结构示例</h2><figure class="highlight text"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br></pre></td><td class="code"><pre><span class="line">Project/</span><br><span class="line">  README.md</span><br><span class="line">  requirements.txt</span><br><span class="line">  code/</span><br><span class="line">    train/</span><br><span class="line">      train.py</span><br><span class="line">    test/</span><br><span class="line">      g.py</span><br><span class="line">  user_data/</span><br><span class="line">    models/</span><br><span class="line">      mms-lid-256/</span><br><span class="line">        config.json</span><br><span class="line">        model.safetensors | pytorch_model.bin</span><br><span class="line">        preprocessor_config.json</span><br><span class="line">        ...</span><br><span class="line">    datasets/</span><br><span class="line">    musan/</span><br><span class="line">      music/  noise/  speech/</span><br><span class="line">    tmp_data/</span><br><span class="line">    model_data/</span><br><span class="line">      mms_best_model.pth</span><br><span class="line">      mms_latest_checkpoint.pth</span><br><span class="line">  xfdata/</span><br><span class="line">    testset/</span><br><span class="line">      iflytek_1.wav</span><br><span class="line">      iflytek_2.wav</span><br><span class="line">  prediction_result/</span><br><span class="line">    result/</span><br><span class="line">      submission.txt</span><br></pre></td></tr></table></figure><hr><h2 id="七、故障排查（FAQ）"><a href="#七、故障排查（FAQ）" class="headerlink" title="七、故障排查（FAQ）"></a>七、故障排查（FAQ）</h2><ul><li><p>无法加载 MMS 模型：</p><ul><li>确认 <code>user_data/models/mms-lid-256/</code> 存在且包含必要文件；路径不要含中文或特殊符号；权限可读。</li></ul></li><li><p>数据集离线报错：</p><ul><li>将 <code>train.py</code> 中 <code>TRANSFORMERS_OFFLINE</code> 与 <code>HF_DATASETS_OFFLINE</code> 设为 <code>&#39;0&#39;</code>，联网运行一次以缓存；或预先复制缓存到 <code>user_data/datasets/</code>。</li></ul></li><li><p>GPU 未被识别：</p><ul><li><code>python -c &quot;import torch;print(torch.cuda.is_available())&quot;</code> 检查；</li><li>重装符合显卡驱动与 CUDA 版本的 PyTorch；或先用 CPU 运行验证。</li></ul></li><li><p>内存/显存不足：</p><ul><li>降低 <code>batch_size</code>，或提高 <code>accumulation_steps</code>；</li><li>已启用梯度检查点与定期 <code>cuda.empty_cache()</code>，仍不足时请缩减数据或关闭图像绘制。</li></ul></li><li><p>推理无输出文件：</p><ul><li>检查 <code>xfdata/testset/</code> 是否存在且包含 <code>.wav</code>；</li><li>查看日志输出和异常信息（日志文件位于 <code>user_data/tmp_data/</code>）。</li></ul></li></ul><hr><h2 id="八、许可"><a href="#八、许可" class="headerlink" title="八、许可"></a>八、许可</h2><p>仅供比赛/研究用途。</p>]]>
    </content>
    <id>https://cookiesky.cn/2025/11/01/fluers/</id>
    <link href="https://cookiesky.cn/2025/11/01/fluers/"/>
    <published>2025-10-31T16:07:32.000Z</published>
    <summary>20205人工智能赋能教育大赛教育场景技术算法挑战赛道面向受限场景的低资源多语种分类挑战赛</summary>
    <title>面向受限场景的低资源多语种分类挑战赛</title>
    <updated>2026-10-18T08:16:40.084Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a><br>适用版本：<code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code>。每章 10 个魔改。</li></ul></div><h1 id="新年灯笼"><a href="#新年灯笼" class="headerlink" title="新年灯笼"></a>新年灯笼</h1><blockquote><p>借鉴：tzy 大佬（Fomalhaut 整理）。本站改动：脚本重写成单文件注入，支持 <code>?text=</code> 自定义文字，移动端缩放与位置也做了适配。</p></blockquote><details class="folding-tag" blue><summary> 新年灯笼 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/source/js/denglong.js</code> ｜ <strong>改法</strong>：新建文件，整段写入。灯笼的样式、DOM 和动画都在这一个自执行脚本里，不用再动 CSS。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> src = <span class="variable language_">document</span>.<span class="property">currentScript</span>.<span class="property">src</span>;</span><br><span class="line">  <span class="keyword">var</span> text = <span class="keyword">new</span> <span class="title class_">URLSearchParams</span>(src.<span class="title function_">split</span>(<span class="string">&#x27;?&#x27;</span>)[<span class="number">1</span>] || <span class="string">&#x27;&#x27;</span>).<span class="title function_">get</span>(<span class="string">&#x27;text&#x27;</span>) || <span class="string">&#x27;新年快乐&#x27;</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> css = <span class="string">`</span></span><br><span class="line"><span class="string">    .deng-container&#123;position:relative;top:10px;z-index:9999;pointer-events:none;&#125;</span></span><br><span class="line"><span class="string">    .deng-box&#123;position:fixed;top:15px;&#125;</span></span><br><span class="line"><span class="string">    .deng-box1&#123;left:20px&#125;.deng-box2&#123;left:130px&#125;.deng-box3&#123;right:110px&#125;.deng-box4&#123;right:20px&#125;</span></span><br><span class="line"><span class="string">    .deng&#123;position:relative;width:120px;height:90px;background:rgba(216,0,15,.8);</span></span><br><span class="line"><span class="string">      border-radius:50%;animation:swing 3s infinite ease-in-out;</span></span><br><span class="line"><span class="string">      box-shadow:-5px 5px 50px 4px #fa6c00;&#125;</span></span><br><span class="line"><span class="string">    .deng-a&#123;width:100px;height:90px;margin-left:7px;border:2px solid #dc8f03;</span></span><br><span class="line"><span class="string">      border-radius:50%;display:flex;justify-content:center;&#125;</span></span><br><span class="line"><span class="string">    .deng-b&#123;width:65px;height:83px;border:2px solid #dc8f03;border-radius:60%;&#125;</span></span><br><span class="line"><span class="string">    .xian&#123;position:absolute;top:-20px;left:60px;width:2px;height:20px;background:#dc8f03;&#125;</span></span><br><span class="line"><span class="string">    .deng-t&#123;font-family:&#x27;华文行楷&#x27;,Arial,sans-serif;font-size:3.2rem;color:#dc8f03;</span></span><br><span class="line"><span class="string">      font-weight:700;line-height:85px;text-align:center;&#125;</span></span><br><span class="line"><span class="string">    .shui-a&#123;position:relative;width:5px;height:20px;margin:-5px 0 0 59px;background:orange;</span></span><br><span class="line"><span class="string">      border-radius:0 0 5px 5px;animation:swing 4s infinite ease-in-out;&#125;</span></span><br><span class="line"><span class="string">    .shui-b&#123;position:absolute;top:14px;left:-2px;width:10px;height:10px;</span></span><br><span class="line"><span class="string">      background:#dc8f03;border-radius:50%;&#125;</span></span><br><span class="line"><span class="string">    .shui-c&#123;position:absolute;top:18px;left:-2px;width:10px;height:35px;</span></span><br><span class="line"><span class="string">      background:orange;border-radius:0 0 0 5px;&#125;</span></span><br><span class="line"><span class="string">    .deng:before,.deng:after&#123;content:&quot; &quot;;display:block;position:absolute;</span></span><br><span class="line"><span class="string">      border-radius:5px;border:1px solid #dc8f03;</span></span><br><span class="line"><span class="string">      background:linear-gradient(to right,#dc8f03,orange,#dc8f03,orange,#dc8f03);&#125;</span></span><br><span class="line"><span class="string">    .deng:before&#123;top:-7px;left:29px;height:12px;width:60px;z-index:999;&#125;</span></span><br><span class="line"><span class="string">    .deng:after&#123;bottom:-7px;left:10px;height:12px;width:60px;margin-left:20px;&#125;</span></span><br><span class="line"><span class="string">    @media(max-width:768px)&#123;.deng-t&#123;font-size:2.5rem&#125;.deng-box&#123;transform:scale(.5);top:-15px&#125;</span></span><br><span class="line"><span class="string">      .deng-box1&#123;left:-22%&#125;.deng-box2&#123;left:0&#125;.deng-box3&#123;right:50px&#125;.deng-box4&#123;right:-10px&#125;&#125;</span></span><br><span class="line"><span class="string">    @keyframes swing&#123;0%&#123;transform:rotate(-10deg)&#125;50%&#123;transform:rotate(10deg)&#125;100%&#123;transform:rotate(-10deg)&#125;&#125;</span></span><br><span class="line"><span class="string">  `</span>;</span><br><span class="line">  <span class="keyword">var</span> style = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;style&#x27;</span>);</span><br><span class="line">  style.<span class="property">textContent</span> = css;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">head</span>.<span class="title function_">appendChild</span>(style);</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> wrap = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">  wrap.<span class="property">className</span> = <span class="string">&#x27;deng-container&#x27;</span>;</span><br><span class="line">  wrap.<span class="property">innerHTML</span> = <span class="title class_">Array</span>.<span class="title function_">from</span>(text).<span class="title function_">map</span>(<span class="keyword">function</span> (<span class="params">t, i</span>) &#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="string">&#x27;&lt;div class=&quot;deng-box deng-box&#x27;</span> + (i % <span class="number">4</span> + <span class="number">1</span>) + <span class="string">&#x27;&quot;&gt;&#x27;</span> +</span><br><span class="line">      <span class="string">&#x27;&lt;div class=&quot;deng&quot;&gt;&lt;div class=&quot;xian&quot;&gt;&lt;/div&gt;&#x27;</span> +</span><br><span class="line">      <span class="string">&#x27;&lt;div class=&quot;deng-a&quot;&gt;&lt;div class=&quot;deng-b&quot;&gt;&lt;div class=&quot;deng-t&quot;&gt;&#x27;</span> + t + <span class="string">&#x27;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&#x27;</span> +</span><br><span class="line">      <span class="string">&#x27;&lt;div class=&quot;shui-a&quot;&gt;&lt;div class=&quot;shui-c&quot;&gt;&lt;/div&gt;&lt;div class=&quot;shui-b&quot;&gt;&lt;/div&gt;&lt;/div&gt;&#x27;</span> +</span><br><span class="line">      <span class="string">&#x27;&lt;/div&gt;&lt;/div&gt;&#x27;</span>;</span><br><span class="line">  &#125;).<span class="title function_">join</span>(<span class="string">&#x27;&#x27;</span>);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(wrap);</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject</code> 的 <code>bottom</code> 列表末尾追加下面那一行；<code>inject:</code> 和 <code>bottom:</code> 两个键配置里本来就有，不要重复写。<code>?text=</code> 后面就是灯笼上显示的字。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/denglong.js?text=新年快乐&quot;&gt;&lt;/script&gt;</span> <span class="comment">#新春灯笼</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="自定义标题"><a href="#自定义标题" class="headerlink" title="自定义标题"></a>自定义标题</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：换成两段中文提示，切回页面 2 秒后恢复原标题，并用 <code>inject.bottom</code> 本地加载。</p></blockquote><details class="folding-tag" blue><summary> 自定义标题 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/source/js/title.js</code> ｜ <strong>改法</strong>：新建文件，整段写入；本站已有同名文件且内容一致，有的话直接用。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> <span class="title class_">OriginTitile</span> = <span class="variable language_">document</span>.<span class="property">title</span>;</span><br><span class="line"><span class="keyword">var</span> titleTime;</span><br><span class="line"><span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;visibilitychange&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">hidden</span>) &#123;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">title</span> = <span class="string">&#x27;👀跑哪里去了~&#x27;</span>;</span><br><span class="line">    <span class="built_in">clearTimeout</span>(titleTime);</span><br><span class="line">  &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    <span class="variable language_">document</span>.<span class="property">title</span> = <span class="string">&#x27;🐖抓到你啦～&#x27;</span>;</span><br><span class="line">    titleTime = <span class="built_in">setTimeout</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="variable language_">document</span>.<span class="property">title</span> = <span class="title class_">OriginTitile</span>;</span><br><span class="line">    &#125;, <span class="number">2000</span>);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject</code> 的 <code>bottom</code> 列表末尾追加这一行。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">src=&quot;/js/title.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#网站标题改变</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="星空背景（仅暗色模式）"><a href="#星空背景（仅暗色模式）" class="headerlink" title="星空背景（仅暗色模式）"></a>星空背景（仅暗色模式）</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：只保留暗色模式启用，画布尺寸与层级按本站页面结构调整。</p></blockquote><details class="folding-tag" blue><summary> 星空背景 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/source/css/universe.css</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站已有同名文件，覆盖前先备份）。这段样式只管画布定位和「亮色模式隐藏」，配色在脚本里。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#universe</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: block;</span><br><span class="line">  <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">margin</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">border</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">left</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">top</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">pointer-events</span>: none;</span><br><span class="line">  <span class="attribute">z-index</span>: -<span class="number">1</span>;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;light&quot;</span>]</span> <span class="selector-id">#universe</span> &#123; <span class="attribute">display</span>: none; &#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/js/universe.js</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站同名文件是限 30fps 的增强版，两版选一个）。脚本从 <code>#universe</code> 取画布，画布在下一步的 <code>inject.bottom</code> 里创建。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> canvas = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;universe&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!canvas) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">var</span> ctx = canvas.<span class="title function_">getContext</span>(<span class="string">&#x27;2d&#x27;</span>);</span><br><span class="line">  <span class="keyword">var</span> stars = [];</span><br><span class="line">  <span class="keyword">var</span> raf = <span class="number">0</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">resize</span>(<span class="params"></span>) &#123;</span><br><span class="line">    canvas.<span class="property">width</span> = <span class="variable language_">window</span>.<span class="property">innerWidth</span>;</span><br><span class="line">    canvas.<span class="property">height</span> = <span class="variable language_">window</span>.<span class="property">innerHeight</span>;</span><br><span class="line">    stars = <span class="title class_">Array</span>.<span class="title function_">from</span>(&#123; <span class="attr">length</span>: <span class="number">160</span> &#125;, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      <span class="keyword">return</span> &#123;</span><br><span class="line">        <span class="attr">x</span>: <span class="title class_">Math</span>.<span class="title function_">random</span>() * canvas.<span class="property">width</span>,</span><br><span class="line">        <span class="attr">y</span>: <span class="title class_">Math</span>.<span class="title function_">random</span>() * canvas.<span class="property">height</span>,</span><br><span class="line">        <span class="attr">r</span>: <span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="number">1.2</span> + <span class="number">0.3</span>,</span><br><span class="line">        <span class="attr">s</span>: <span class="title class_">Math</span>.<span class="title function_">random</span>() * <span class="number">0.25</span> + <span class="number">0.05</span></span><br><span class="line">      &#125;;</span><br><span class="line">    &#125;);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">draw</span>(<span class="params"></span>) &#123;</span><br><span class="line">    ctx.<span class="title function_">clearRect</span>(<span class="number">0</span>, <span class="number">0</span>, canvas.<span class="property">width</span>, canvas.<span class="property">height</span>);</span><br><span class="line">    ctx.<span class="property">fillStyle</span> = <span class="string">&#x27;rgba(255,255,255,.8)&#x27;</span>;</span><br><span class="line">    stars.<span class="title function_">forEach</span>(<span class="keyword">function</span> (<span class="params">p</span>) &#123;</span><br><span class="line">      ctx.<span class="title function_">beginPath</span>();</span><br><span class="line">      ctx.<span class="title function_">arc</span>(p.<span class="property">x</span>, p.<span class="property">y</span>, p.<span class="property">r</span>, <span class="number">0</span>, <span class="title class_">Math</span>.<span class="property">PI</span> * <span class="number">2</span>);</span><br><span class="line">      ctx.<span class="title function_">fill</span>();</span><br><span class="line">      p.<span class="property">y</span> -= p.<span class="property">s</span>;</span><br><span class="line">      <span class="keyword">if</span> (p.<span class="property">y</span> &lt; <span class="number">0</span>) p.<span class="property">y</span> = canvas.<span class="property">height</span>;</span><br><span class="line">    &#125;);</span><br><span class="line">    raf = <span class="title function_">requestAnimationFrame</span>(draw);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">sync</span>(<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">var</span> dark = <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="title function_">getAttribute</span>(<span class="string">&#x27;data-theme&#x27;</span>) === <span class="string">&#x27;dark&#x27;</span>;</span><br><span class="line">    <span class="title function_">cancelAnimationFrame</span>(raf);</span><br><span class="line">    <span class="keyword">if</span> (dark &amp;&amp; !<span class="variable language_">document</span>.<span class="property">hidden</span>) <span class="title function_">draw</span>();</span><br><span class="line">    <span class="keyword">else</span> ctx.<span class="title function_">clearRect</span>(<span class="number">0</span>, <span class="number">0</span>, canvas.<span class="property">width</span>, canvas.<span class="property">height</span>);</span><br><span class="line">  &#125;</span><br><span class="line"></span><br><span class="line">  <span class="title function_">resize</span>();</span><br><span class="line">  <span class="variable language_">window</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;resize&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; <span class="title function_">resize</span>(); <span class="title function_">sync</span>(); &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;visibilitychange&#x27;</span>, sync);</span><br><span class="line">  <span class="keyword">new</span> <span class="title class_">MutationObserver</span>(sync).<span class="title function_">observe</span>(<span class="variable language_">document</span>.<span class="property">documentElement</span>, &#123;</span><br><span class="line">    <span class="attr">attributes</span>: <span class="literal">true</span>, <span class="attr">attributeFilter</span>: [<span class="string">&#x27;data-theme&#x27;</span>]</span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="title function_">sync</span>();</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：<code>inject.head</code> 末尾追加 <code>&lt;link&gt;</code> 那一条，<code>inject.bottom</code> 末尾追加 <code>&lt;canvas&gt;</code> 和 <code>&lt;script&gt;</code> 两条。顺序不能反：画布必须先于脚本出现，否则脚本取不到 <code>#universe</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;stylesheet&quot;</span> <span class="string">href=&quot;/css/universe.css&quot;</span> <span class="string">media=&quot;only</span> <span class="string">x&quot;</span> <span class="string">onload=&quot;this.onload=null;this.media=&#x27;all&#x27;&quot;&gt;</span> <span class="comment">#星空(dark模式)</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;canvas</span> <span class="string">id=&quot;universe&quot;&gt;&lt;/canvas&gt;</span> <span class="comment">#星空画板(dark模式)</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/universe.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#星空(dark模式)</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="猫猫挂件"><a href="#猫猫挂件" class="headerlink" title="猫猫挂件"></a>猫猫挂件</h1><blockquote><p>借鉴：tzy 大佬（Fomalhaut 整理）。本站改动：样式按本站层级重写，移动端默认隐藏。</p></blockquote><details class="folding-tag" blue><summary> 猫猫挂件 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/source/css/cat.css</code> ｜ <strong>改法</strong>：新建文件，整段写入。本站已改用 <code>fomal/cursor.js</code>，没有这个文件；按本篇做就新建。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.neko</span> &#123;</span><br><span class="line">  <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">right</span>: <span class="number">20px</span>;</span><br><span class="line">  <span class="attribute">bottom</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">70px</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">100px</span>;</span><br><span class="line">  <span class="attribute">background-repeat</span>: no-repeat;</span><br><span class="line">  <span class="attribute">background-position</span>: bottom;</span><br><span class="line">  <span class="attribute">background-size</span>: contain;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">100</span>;</span><br><span class="line">  <span class="attribute">cursor</span>: pointer;</span><br><span class="line">  <span class="attribute">pointer-events</span>: auto;</span><br><span class="line">  <span class="attribute">transition</span>: transform .<span class="number">25s</span> ease;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-class">.neko</span><span class="selector-pseudo">:hover</span> &#123; <span class="attribute">transform</span>: <span class="built_in">scale</span>(<span class="number">1.08</span>); &#125;</span><br><span class="line"><span class="keyword">@media</span> screen <span class="keyword">and</span> (<span class="attribute">max-width</span>: <span class="number">768px</span>) &#123; <span class="selector-class">.neko</span> &#123; <span class="attribute">display</span>: none <span class="meta">!important</span>; &#125; &#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/js/cat.js</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站同名文件是另一套实现且已停止注入，照本篇覆盖即可）。脚本依赖 jQuery，注入顺序见下一步。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params">$</span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">document</span>.<span class="property">body</span>.<span class="property">clientWidth</span> &lt;= <span class="number">992</span>) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">if</span> ($(<span class="string">&#x27;.neko&#x27;</span>).<span class="property">length</span>) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">var</span> neko = $(<span class="string">&#x27;&lt;div class=&quot;neko&quot; id=&quot;neko1&quot; title=&quot;喵~&quot;&gt;&lt;/div&gt;&#x27;</span>);</span><br><span class="line">  neko.<span class="title function_">css</span>(<span class="string">&#x27;background-image&#x27;</span>, <span class="string">&#x27;url(/img/cat.png)&#x27;</span>);</span><br><span class="line">  $(<span class="string">&#x27;body&#x27;</span>).<span class="title function_">append</span>(neko);</span><br><span class="line">  $(<span class="variable language_">window</span>).<span class="title function_">on</span>(<span class="string">&#x27;scroll&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    neko.<span class="title function_">css</span>(<span class="string">&#x27;display&#x27;</span>, $(<span class="variable language_">window</span>).<span class="title function_">scrollTop</span>() &gt; <span class="number">10</span> ? <span class="string">&#x27;block&#x27;</span> : <span class="string">&#x27;none&#x27;</span>);</span><br><span class="line">  &#125;);</span><br><span class="line">  neko.<span class="title function_">on</span>(<span class="string">&#x27;mouseover&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    neko.<span class="title function_">css</span>(<span class="string">&#x27;background-image&#x27;</span>, <span class="string">&#x27;url(/img/cat-hover.png)&#x27;</span>);</span><br><span class="line">  &#125;).<span class="title function_">on</span>(<span class="string">&#x27;mouseout&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    neko.<span class="title function_">css</span>(<span class="string">&#x27;background-image&#x27;</span>, <span class="string">&#x27;url(/img/cat.png)&#x27;</span>);</span><br><span class="line">  &#125;);</span><br><span class="line">  $(<span class="variable language_">window</span>).<span class="title function_">on</span>(<span class="string">&#x27;pjax:complete&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">    <span class="keyword">if</span> (!$(<span class="string">&#x27;.neko&#x27;</span>).<span class="property">length</span>) $(<span class="string">&#x27;body&#x27;</span>).<span class="title function_">append</span>(neko);</span><br><span class="line">  &#125;);</span><br><span class="line">&#125;)(jQuery);</span><br></pre></td></tr></table></figure><p>把猫猫图片放到 <code>[Blogroot]\source\img\cat.png</code>、<code>[Blogroot]\source\img\cat-hover.png</code>。</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：<code>inject.head</code> 末尾追加 CSS 那一条，<code>inject.bottom</code> 末尾追加 jQuery 和 <code>cat.js</code> 两条。jQuery 必须排在 <code>cat.js</code> 前面；<code>cat.js</code> 带 <code>data-pjax</code>，切页后才会重新执行。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;link</span> <span class="string">rel=&quot;stylesheet&quot;</span> <span class="string">href=&quot;/css/cat.css&quot;</span> <span class="string">media=&quot;only</span> <span class="string">x&quot;</span> <span class="string">onload=&quot;this.onload=null;this.media=&#x27;all&#x27;&quot;&gt;</span> <span class="comment">#猫猫</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/jquery.min.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#猫猫/右键菜单依赖</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">data-pjax</span> <span class="string">src=&quot;/js/cat.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#猫猫</span></span><br></pre></td></tr></table></figure><p><code>jquery.min.js</code> 用官方 jQuery 压缩版放入 <code>[Blogroot]\source\js\</code>。</p>              </div>            </details><h1 id="自定义鼠标样式"><a href="#自定义鼠标样式" class="headerlink" title="自定义鼠标样式"></a>自定义鼠标样式</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：脚本按本站交互重写，触屏设备直接跳过，不再加载额外光标资源。</p></blockquote><details class="folding-tag" blue><summary> 自定义鼠标样式 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/source/js/cursor.js</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站同名文件是「猫猫 + 右键菜单」三合一版，覆盖前先备份）。脚本只负责跟随和状态类，外观在下一步的 <code>custom.css</code> 里。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="variable language_">window</span>.<span class="title function_">matchMedia</span>(<span class="string">&#x27;(pointer: coarse)&#x27;</span>).<span class="property">matches</span>) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">var</span> dot = <span class="variable language_">document</span>.<span class="title function_">createElement</span>(<span class="string">&#x27;div&#x27;</span>);</span><br><span class="line">  dot.<span class="property">id</span> = <span class="string">&#x27;cursor&#x27;</span>;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="title function_">appendChild</span>(dot);</span><br><span class="line"></span><br><span class="line">  <span class="keyword">var</span> x = <span class="number">0</span>, y = <span class="number">0</span>, raf = <span class="number">0</span>;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mousemove&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">    x = e.<span class="property">clientX</span>;</span><br><span class="line">    y = e.<span class="property">clientY</span>;</span><br><span class="line">    <span class="keyword">if</span> (raf) <span class="keyword">return</span>;</span><br><span class="line">    raf = <span class="title function_">requestAnimationFrame</span>(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">      dot.<span class="property">style</span>.<span class="property">left</span> = x + <span class="string">&#x27;px&#x27;</span>;</span><br><span class="line">      dot.<span class="property">style</span>.<span class="property">top</span> = y + <span class="string">&#x27;px&#x27;</span>;</span><br><span class="line">      raf = <span class="number">0</span>;</span><br><span class="line">    &#125;);</span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseover&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">    dot.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;hover&#x27;</span>, !!e.<span class="property">target</span>.<span class="title function_">closest</span>(<span class="string">&#x27;a, button, .site-page&#x27;</span>));</span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mousedown&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; dot.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;active&#x27;</span>); &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseup&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; dot.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;active&#x27;</span>); &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseleave&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; dot.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;hidden&#x27;</span>); &#125;);</span><br><span class="line">  <span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;mouseenter&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; dot.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;hidden&#x27;</span>); &#125;);</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。<code>custom.css</code> 已经由 <code>inject.head</code> 引入，加规则就生效；改完把引用上的 <code>?v=</code> 版本号升一位。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#cursor</span> &#123;</span><br><span class="line">  <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">top</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">left</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">margin</span>: -<span class="number">8px</span> <span class="number">0</span> <span class="number">0</span> -<span class="number">8px</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">16px</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">16px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">rgb</span>(<span class="number">57</span>,<span class="number">197</span>,<span class="number">187</span>);</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">8px</span>;</span><br><span class="line">  <span class="attribute">opacity</span>: .<span class="number">25</span>;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">10086</span>;</span><br><span class="line">  <span class="attribute">pointer-events</span>: none;</span><br><span class="line">  <span class="attribute">transition</span>: .<span class="number">2s</span> ease-in-out;</span><br><span class="line">  <span class="attribute">transition-property</span>: background, opacity, transform;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-id">#cursor</span><span class="selector-class">.hidden</span> &#123; <span class="attribute">opacity</span>: <span class="number">0</span>; &#125;</span><br><span class="line"><span class="selector-id">#cursor</span><span class="selector-class">.hover</span> &#123; <span class="attribute">opacity</span>: .<span class="number">1</span>; <span class="attribute">transform</span>: <span class="built_in">scale</span>(<span class="number">2.5</span>); &#125;</span><br><span class="line"><span class="selector-id">#cursor</span><span class="selector-class">.active</span> &#123; <span class="attribute">opacity</span>: .<span class="number">5</span>; <span class="attribute">transform</span>: <span class="built_in">scale</span>(.<span class="number">5</span>); &#125;</span><br><span class="line"><span class="keyword">@media</span> (<span class="attribute">pointer</span>: coarse) &#123; <span class="selector-id">#cursor</span> &#123; <span class="attribute">display</span>: none; &#125; &#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject</code> 的 <code>bottom</code> 列表末尾追加这一行。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">defer</span> <span class="string">src=&quot;/js/cursor.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#鼠标样式</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="右键菜单"><a href="#右键菜单" class="headerlink" title="右键菜单"></a>右键菜单</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：Pug 注入位置按 5.7.2 调整，菜单项与本站现有功能对齐。</p></blockquote><details class="folding-tag" blue><summary> 右键菜单 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/rightmenu.pug</code> ｜ <strong>改法</strong>：新建文件，整段写入。本站 5.7.2 主题里已有同名文件（菜单项更多），这是主题目录、升级主题会被覆盖，改前先备份。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br></pre></td><td class="code"><pre><span class="line">#rightMenu.js-pjax</span><br><span class="line">    .rightMenu-group.rightMenu-small</span><br><span class="line">        a.rightMenu-item(href=&quot;javascript:window.history.back();&quot;)</span><br><span class="line">            i.fa.fa-arrow-left</span><br><span class="line">        a.rightMenu-item(href=&quot;javascript:window.history.forward();&quot;)</span><br><span class="line">            i.fa.fa-arrow-right</span><br><span class="line">        a.rightMenu-item(href=&quot;javascript:window.location.reload();&quot;)</span><br><span class="line">            i.fa.fa-refresh</span><br><span class="line">        a.rightMenu-item(href=&quot;javascript:window.scrollTo(0,0);&quot;)</span><br><span class="line">            i.fa.fa-arrow-up</span><br><span class="line">    .rightMenu-group.rightMenu-line.hide#menu-text</span><br><span class="line">        a.rightMenu-item(href=&quot;javascript:rmf.copySelect();&quot;)</span><br><span class="line">            i.fa.fa-copy</span><br><span class="line">            span=&#x27;复制&#x27;</span><br><span class="line">        a.rightMenu-item(href=&quot;javascript:window.open(&#x27;https://www.baidu.com/s?wd=&#x27;+window.getSelection().toString());&quot;)</span><br><span class="line">            i.fa.fa-search</span><br><span class="line">            span=&#x27;百度搜索&#x27;</span><br><span class="line">        a.rightMenu-item(href=&quot;javascript:rmf.copyWordsLink();&quot;)</span><br><span class="line">            i.fa.fa-link</span><br><span class="line">            span=&#x27;复制本文地址&#x27;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/js/rightmenu.js</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站同名文件更长，带遮罩和更多菜单项，整段覆盖不影响其它模块）。脚本按 <code>id=&quot;rightMenu&quot;</code> 取节点，要和上一步的 Pug 对上。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">var</span> rmf = &#123;&#125;;</span><br><span class="line"><span class="keyword">var</span> rightMenu = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;rightMenu&#x27;</span>);</span><br><span class="line"><span class="keyword">var</span> mouseMode = <span class="literal">false</span>;</span><br><span class="line"></span><br><span class="line">rmf.<span class="property">showRightMenu</span> = <span class="keyword">function</span> (<span class="params">show, y, x</span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (!rightMenu) <span class="keyword">return</span>;</span><br><span class="line">  rightMenu.<span class="property">style</span>.<span class="property">display</span> = show ? <span class="string">&#x27;block&#x27;</span> : <span class="string">&#x27;none&#x27;</span>;</span><br><span class="line">  <span class="keyword">if</span> (show) &#123;</span><br><span class="line">    rightMenu.<span class="property">style</span>.<span class="property">top</span> = y + <span class="string">&#x27;px&#x27;</span>;</span><br><span class="line">    rightMenu.<span class="property">style</span>.<span class="property">left</span> = x + <span class="string">&#x27;px&#x27;</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;;</span><br><span class="line">rmf.<span class="property">copySelect</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> text = <span class="variable language_">window</span>.<span class="title function_">getSelection</span>().<span class="title function_">toString</span>();</span><br><span class="line">  <span class="keyword">if</span> (text) navigator.<span class="property">clipboard</span>.<span class="title function_">writeText</span>(text);</span><br><span class="line">&#125;;</span><br><span class="line">rmf.<span class="property">copyWordsLink</span> = <span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  navigator.<span class="property">clipboard</span>.<span class="title function_">writeText</span>(<span class="variable language_">window</span>.<span class="property">location</span>.<span class="property">href</span>);</span><br><span class="line">&#125;;</span><br><span class="line"><span class="keyword">function</span> <span class="title function_">changeMouseMode</span>(<span class="params"></span>) &#123;</span><br><span class="line">  mouseMode = !mouseMode;</span><br><span class="line">  <span class="variable language_">document</span>.<span class="property">body</span>.<span class="property">classList</span>.<span class="title function_">toggle</span>(<span class="string">&#x27;mouse-mode&#x27;</span>, mouseMode);</span><br><span class="line">&#125;</span><br><span class="line"><span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;contextmenu&#x27;</span>, <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">  e.<span class="title function_">preventDefault</span>();</span><br><span class="line">  rmf.<span class="title function_">showRightMenu</span>(<span class="literal">true</span>, e.<span class="property">clientY</span>, e.<span class="property">clientX</span>);</span><br><span class="line">&#125;);</span><br><span class="line"><span class="variable language_">document</span>.<span class="title function_">addEventListener</span>(<span class="string">&#x27;click&#x27;</span>, <span class="keyword">function</span> (<span class="params"></span>) &#123; rmf.<span class="title function_">showRightMenu</span>(<span class="literal">false</span>); &#125;);</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/layout.pug</code> ｜ <strong>改法</strong>：在 <code>include ./rightside.pug</code> 之后插入 <code>!=partial(&#39;includes/rightmenu&#39;,{}, {cache:true})</code> 一行；本站第 82 行已有这一行，确认存在就不用改。下面整段是插入后的上下文，只加一行，别整段粘贴。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">include ./rightside.pug</span><br><span class="line">!=partial(&#x27;includes/rightmenu&#x27;,&#123;&#125;, &#123;cache:true&#125;)</span><br><span class="line">include ./additional-js.pug</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。菜单默认 <code>display: none</code>，由 <code>rightmenu.js</code> 在右键时改成 <code>block</code>。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#rightMenu</span> &#123;</span><br><span class="line">  <span class="attribute">display</span>: none;</span><br><span class="line">  <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">10087</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">6px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">8px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">255</span>,<span class="number">255</span>,<span class="number">255</span>,.<span class="number">95</span>);</span><br><span class="line">  <span class="attribute">box-shadow</span>: <span class="number">0</span> <span class="number">4px</span> <span class="number">16px</span> <span class="built_in">rgba</span>(<span class="number">0</span>,<span class="number">0</span>,<span class="number">0</span>,.<span class="number">18</span>);</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-attr">[data-theme=<span class="string">&quot;dark&quot;</span>]</span> <span class="selector-id">#rightMenu</span> &#123; <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">30</span>,<span class="number">35</span>,<span class="number">45</span>,.<span class="number">95</span>); &#125;</span><br><span class="line"><span class="selector-id">#rightMenu</span> <span class="selector-class">.rightMenu-item</span> &#123; <span class="attribute">display</span>: block; <span class="attribute">padding</span>: <span class="number">6px</span> <span class="number">12px</span>; <span class="attribute">cursor</span>: pointer; &#125;</span><br><span class="line"><span class="selector-class">.rightMenu-line</span><span class="selector-class">.hide</span> &#123; <span class="attribute">display</span>: none; &#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject</code> 的 <code>bottom</code> 列表末尾追加这一行。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">type=&quot;text/javascript&quot;</span> <span class="string">src=&quot;/js/rightmenu.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#右键菜单</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="禁止打开开发者工具"><a href="#禁止打开开发者工具" class="headerlink" title="禁止打开开发者工具"></a>禁止打开开发者工具</h1><blockquote><p>借鉴：tzy 大佬（Fomalhaut 整理）。本站改动：Pug 插入位置按 5.7.2 调整，脚本保留原提示逻辑。</p></blockquote><details class="folding-tag" blue><summary> 禁止 F12 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/layout.pug</code> ｜ <strong>改法</strong>：在 <code>html(...)</code> 那一行下面、<code>head</code> 之前插入 <code>//-魔改禁F12开始</code> 到 <code>//-魔改禁F12结束</code> 之间的两个 <code>script.</code> 块；本站第 9 行起已有同样内容，有就不用再加。整段代码只是展示插入位置，<code>doctype</code>、<code>html</code>、<code>head</code> 都是原有行。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line">doctype html</span><br><span class="line">html(lang=config.language data-theme=theme.display_mode class=htmlClassHideAside)</span><br><span class="line">  //-魔改禁F12开始</span><br><span class="line">  script.</span><br><span class="line">    ((function() &#123;var callbacks = [],timeLimit = 50,open = false;setInterval(loop, 500);return &#123;addListener: function(fn) &#123;callbacks.push(fn);&#125;,cancleListenr: function(fn) &#123;callbacks = callbacks.filter(function(v) &#123;return v !== fn;&#125;);&#125;&#125;</span><br><span class="line">    function loop() &#123;var startTime = new Date();debugger;if (new Date() - startTime &gt; timeLimit) &#123;if (!open) &#123;callbacks.forEach(function(fn) &#123;fn.call(null);&#125;);&#125;open = true;window.stop();alert(&#x27;你真坏，请关闭控制台！&#x27;);document.body.innerHTML = &quot;&quot;;&#125; else &#123;open = false;&#125;&#125;&#125;)()).addListener(function() &#123;window.location.reload();&#125;);</span><br><span class="line">  script.</span><br><span class="line">    function toDevtools()&#123;</span><br><span class="line">      let num = 0;</span><br><span class="line">      let devtools = new Date();</span><br><span class="line">      devtools.toString = function() &#123;</span><br><span class="line">        num++;</span><br><span class="line">        if (num &gt; 1) &#123; alert(&#x27;你真坏，请关闭控制台！&#x27;); window.location.href = &quot;about:blank&quot;; blast(); &#125;</span><br><span class="line">      &#125;</span><br><span class="line">      console.log(&#x27;&#x27;, devtools);</span><br><span class="line">    &#125;</span><br><span class="line">    toDevtools();</span><br><span class="line">    //-魔改禁F12结束</span><br><span class="line">  head</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/js/f12.js</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站同名文件只有这一段、逻辑一致，可以直接用）。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="variable language_">document</span>.<span class="property">onkeydown</span> = <span class="keyword">function</span> (<span class="params">e</span>) &#123;</span><br><span class="line">  <span class="keyword">if</span> (<span class="number">123</span> == e.<span class="property">keyCode</span> ||</span><br><span class="line">      (e.<span class="property">ctrlKey</span> &amp;&amp; e.<span class="property">shiftKey</span> &amp;&amp; (<span class="number">74</span> === e.<span class="property">keyCode</span> || <span class="number">73</span> === e.<span class="property">keyCode</span> || <span class="number">67</span> === e.<span class="property">keyCode</span>)) ||</span><br><span class="line">      (e.<span class="property">ctrlKey</span> &amp;&amp; <span class="number">85</span> === e.<span class="property">keyCode</span>)) &#123;</span><br><span class="line">    e.<span class="property">keyCode</span> = <span class="number">0</span>;</span><br><span class="line">    e.<span class="property">returnValue</span> = <span class="literal">false</span>;</span><br><span class="line">    <span class="keyword">return</span> <span class="literal">false</span>;</span><br><span class="line">  &#125;</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject</code> 的 <code>bottom</code> 列表末尾追加这一行；本站这一行目前是注释状态，要恢复就取消前面的 <code>#</code>。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">src=&quot;/js/f12.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#禁f12</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="帧率检测"><a href="#帧率检测" class="headerlink" title="帧率检测"></a>帧率检测</h1><blockquote><p>借鉴：LYX（Fomalhaut 整理）。本站改动：显示样式与阈值按本站低性能模式调整，低于 35 帧才触发降级。</p></blockquote><details class="folding-tag" blue><summary> 帧率检测 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/source/js/fps.js</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站同名文件带「流畅 / 卡顿」文字和开关，覆盖前先备份）。脚本要等 <code>#fps</code> 节点存在才工作，那个 <code>span</code> 在后面的 <code>inject.head</code> 里。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> box = <span class="variable language_">document</span>.<span class="title function_">getElementById</span>(<span class="string">&#x27;fps&#x27;</span>);</span><br><span class="line">  <span class="keyword">if</span> (!box) <span class="keyword">return</span>;</span><br><span class="line">  <span class="keyword">var</span> frames = <span class="number">0</span>, last = performance.<span class="title function_">now</span>(), lowStart = <span class="number">0</span>, shown = -<span class="number">1</span>;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">function</span> <span class="title function_">tick</span>(<span class="params">now</span>) &#123;</span><br><span class="line">    frames++;</span><br><span class="line">    <span class="keyword">if</span> (now - last &gt;= <span class="number">1000</span>) &#123;</span><br><span class="line">      <span class="keyword">var</span> fps = <span class="title class_">Math</span>.<span class="title function_">round</span>(frames * <span class="number">1000</span> / (now - last));</span><br><span class="line">      <span class="keyword">if</span> (fps !== shown) &#123; box.<span class="property">textContent</span> = <span class="string">&#x27;FPS &#x27;</span> + fps; shown = fps; &#125;</span><br><span class="line">      <span class="keyword">if</span> (fps &lt; <span class="number">35</span>) &#123;</span><br><span class="line">        <span class="keyword">if</span> (!lowStart) lowStart = now;</span><br><span class="line">        <span class="keyword">if</span> (now - lowStart &gt;= <span class="number">2000</span>) <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">classList</span>.<span class="title function_">add</span>(<span class="string">&#x27;low-perf&#x27;</span>);</span><br><span class="line">      &#125; <span class="keyword">else</span> &#123;</span><br><span class="line">        lowStart = <span class="number">0</span>;</span><br><span class="line">        <span class="variable language_">document</span>.<span class="property">documentElement</span>.<span class="property">classList</span>.<span class="title function_">remove</span>(<span class="string">&#x27;low-perf&#x27;</span>);</span><br><span class="line">      &#125;</span><br><span class="line">      frames = <span class="number">0</span>;</span><br><span class="line">      last = now;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="title function_">requestAnimationFrame</span>(tick);</span><br><span class="line">  &#125;</span><br><span class="line">  <span class="title function_">requestAnimationFrame</span>(tick);</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/source/css/custom.css</code> ｜ <strong>改法</strong>：追加到文件末尾。第二段 <code>html.low-perf</code> 是给低性能模式用的，帧率恢复后脚本会把这个类摘掉。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-id">#fps</span> &#123;</span><br><span class="line">  <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">right</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">bottom</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">10088</span>;</span><br><span class="line">  <span class="attribute">padding</span>: <span class="number">2px</span> <span class="number">8px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">10px</span>;</span><br><span class="line">  <span class="attribute">font-size</span>: <span class="number">12px</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">rgba</span>(<span class="number">0</span>,<span class="number">0</span>,<span class="number">0</span>,.<span class="number">35</span>);</span><br><span class="line">  <span class="attribute">color</span>: <span class="number">#fff</span>;</span><br><span class="line">  <span class="attribute">pointer-events</span>: none;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-tag">html</span><span class="selector-class">.low-perf</span> <span class="selector-class">.parallax</span> &gt; use &#123;</span><br><span class="line">  <span class="attribute">animation</span>: none <span class="meta">!important</span>;</span><br><span class="line">  -webkit-<span class="attribute">animation</span>: none <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：<code>inject.head</code> 末尾追加 <code>&lt;span id=&quot;fps&quot;&gt;</code> 那一条，<code>inject.bottom</code> 末尾追加 <code>&lt;script&gt;</code> 那一条。这个 <code>span</code> 放 head 里不影响渲染，脚本靠 <code>getElementById(&#39;fps&#39;)</code> 找它。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;span</span> <span class="string">id=&quot;fps&quot;</span> <span class="string">media=&quot;only</span> <span class="string">x&quot;</span> <span class="string">onload=&quot;this.onload=null;this.media=&#x27;all&#x27;&quot;&gt;&lt;/span&gt;</span> <span class="comment"># 帧率检测</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">src=&quot;/js/fps.js&quot;&gt;&lt;/script&gt;</span> <span class="comment"># 帧率检测</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="控制台字符画"><a href="#控制台字符画" class="headerlink" title="控制台字符画"></a>控制台字符画</h1><blockquote><p>借鉴：安知鱼（Fomalhaut 整理）。本站改动：改成可直接替换站点名与网名的占位模板，颜色跟随本站主题色。</p></blockquote><details class="folding-tag" blue><summary> 控制台字符画 </summary>              <div class='content'>              <p><strong>文件</strong>：<code>[Blogroot]/source/js/console.js</code> ｜ <strong>改法</strong>：新建文件，整段写入，再把 <code>&lt;建站日期&gt;</code>、<code>&lt;站点名&gt;</code>、<code>&lt;你的网名&gt;</code> 三处占位换成自己的内容（本站同名文件是另一版，带农历信息，覆盖前先备份）。</p><figure class="highlight js"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line">(<span class="keyword">function</span> (<span class="params"></span>) &#123;</span><br><span class="line">  <span class="keyword">var</span> start = <span class="keyword">new</span> <span class="title class_">Date</span>(<span class="string">&#x27;&lt;建站日期&gt;&#x27;</span>);</span><br><span class="line">  <span class="keyword">var</span> days = <span class="title class_">Math</span>.<span class="title function_">floor</span>((<span class="title class_">Date</span>.<span class="title function_">now</span>() - start) / <span class="number">86400000</span>);</span><br><span class="line">  <span class="keyword">var</span> style = <span class="string">&#x27;color:#5ea6e5;font-size:14px;font-weight:bold;&#x27;</span>;</span><br><span class="line">  <span class="variable language_">console</span>.<span class="title function_">log</span>(<span class="string">&#x27;%c&lt;站点名&gt;&#x27;</span>, style);</span><br><span class="line">  <span class="variable language_">console</span>.<span class="title function_">log</span>(<span class="string">&#x27;%c小站已经苟活 &#x27;</span> + days + <span class="string">&#x27; 天啦&#x27;</span>, style);</span><br><span class="line">  <span class="variable language_">console</span>.<span class="title function_">log</span>(<span class="string">&#x27;%c© &lt;你的网名&gt;&#x27;</span>, style);</span><br><span class="line">&#125;)();</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject</code> 的 <code>bottom</code> 列表末尾追加这一行。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">src=&quot;/js/console.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#控制台字符画</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="顶部渐变加载条"><a href="#顶部渐变加载条" class="headerlink" title="顶部渐变加载条"></a>顶部渐变加载条</h1><blockquote><p>借鉴：Fomalhaut（猕猴桃）。本站改动：<code>pace.js</code> 改为本地加载，进度条配色与本站主题色同步。</p></blockquote><details class="folding-tag" blue><summary> 顶部渐变加载条 </summary>              <div class='content'>              <p>把 pace.js 官方压缩版放到 <code>[Blogroot]\source\js\pace.min.js</code>。</p><p><strong>文件</strong>：<code>[Blogroot]/source/css/progress_bar.css</code> ｜ <strong>改法</strong>：新建文件，整段写入（本站已有同名文件，就是这套进度条样式）。文件名要和下一步 <code>preloader.pace_css_url</code> 里的路径一致。</p><figure class="highlight css"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.pace</span> &#123;</span><br><span class="line">  <span class="attribute">pointer-events</span>: none;</span><br><span class="line">  user-select: none;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">2000</span>;</span><br><span class="line">  <span class="attribute">position</span>: fixed;</span><br><span class="line">  <span class="attribute">margin</span>: auto;</span><br><span class="line">  <span class="attribute">top</span>: <span class="number">10px</span>;</span><br><span class="line">  <span class="attribute">left</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">right</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">8px</span>;</span><br><span class="line">  <span class="attribute">border-radius</span>: <span class="number">8px</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">4rem</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="number">#eaecf2</span>;</span><br><span class="line">  <span class="attribute">overflow</span>: hidden;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-class">.pace</span> <span class="selector-class">.pace-progress</span> &#123;</span><br><span class="line">  <span class="attribute">box-sizing</span>: border-box;</span><br><span class="line">  <span class="attribute">transform</span>: <span class="built_in">translate3d</span>(<span class="number">0</span>,<span class="number">0</span>,<span class="number">0</span>);</span><br><span class="line">  <span class="attribute">max-width</span>: <span class="number">200px</span>;</span><br><span class="line">  <span class="attribute">position</span>: absolute;</span><br><span class="line">  <span class="attribute">z-index</span>: <span class="number">2000</span>;</span><br><span class="line">  <span class="attribute">display</span>: block;</span><br><span class="line">  <span class="attribute">top</span>: <span class="number">0</span>;</span><br><span class="line">  <span class="attribute">right</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">height</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">width</span>: <span class="number">100%</span>;</span><br><span class="line">  <span class="attribute">background</span>: <span class="built_in">linear-gradient</span>(-<span class="number">45deg</span>, <span class="number">#ee7752</span>, <span class="number">#e73c7e</span>, <span class="number">#23a6d5</span>, <span class="number">#23d5ab</span>);</span><br><span class="line">  <span class="attribute">animation</span>: gradient <span class="number">1.5s</span> ease infinite;</span><br><span class="line">  <span class="attribute">background-size</span>: <span class="number">200%</span>;</span><br><span class="line">&#125;</span><br><span class="line"><span class="selector-class">.pace</span><span class="selector-class">.pace-inactive</span> &#123; <span class="attribute">opacity</span>: <span class="number">0</span>; <span class="attribute">transition</span>: .<span class="number">3s</span>; <span class="attribute">top</span>: -<span class="number">8px</span>; &#125;</span><br><span class="line"><span class="keyword">@keyframes</span> gradient &#123;</span><br><span class="line">  <span class="number">0%</span> &#123; <span class="attribute">background-position</span>: <span class="number">0%</span> <span class="number">50%</span>; &#125;</span><br><span class="line">  <span class="number">50%</span> &#123; <span class="attribute">background-position</span>: <span class="number">100%</span> <span class="number">50%</span>; &#125;</span><br><span class="line">  <span class="number">100%</span> &#123; <span class="attribute">background-position</span>: <span class="number">0%</span> <span class="number">50%</span>; &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/themes/butterfly/layout/includes/loading/index.pug</code> ｜ <strong>改法</strong>：整段替换该文件；5.7.2 原版就是这个结构，本站没改过，等于核对一遍 <code>source</code> 的三条分支都在。主题目录的文件改动会被主题升级覆盖，改前备份。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line">if theme.preloader.enable</span><br><span class="line">  if theme.preloader.source === 1</span><br><span class="line">    include ./fullpage-loading.pug</span><br><span class="line">  else if theme.preloader.source === 2</span><br><span class="line">    include ./pace.pug</span><br><span class="line">  else</span><br><span class="line">    include ./fullpage-loading.pug</span><br><span class="line">    include ./pace.pug</span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：改顶层 <code>preloader:</code> 下的 <code>enable</code>、<code>source</code>、<code>pace_css_url</code> 三个值，键要顶格写。<code>source: 3</code> 表示全屏 loading 和顶部进度条一起启用；本站当前是 <code>2</code>，只开顶部进度条。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">preloader:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">source:</span> <span class="number">3</span></span><br><span class="line">  <span class="attr">pace_css_url:</span> <span class="string">/css/progress_bar.css</span></span><br></pre></td></tr></table></figure><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：在 <code>inject</code> 的 <code>bottom</code> 列表末尾追加这一行。pace.js 自己会生成进度条 DOM，这里只负责把脚本加载进来，少了这行页面不会出现进度条。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&lt;script</span> <span class="string">async</span> <span class="string">src=&quot;/js/pace.min.js&quot;&gt;&lt;/script&gt;</span> <span class="comment">#顶部渐变加载条</span></span><br></pre></td></tr></table></figure>              </div>            </details><h1 id="改完怎么验证与部署"><a href="#改完怎么验证与部署" class="headerlink" title="改完怎么验证与部署"></a>改完怎么验证与部署</h1><p>十节都改完后，先在本地走一遍再上传：</p><ol><li><strong>生成</strong>：在博客根目录执行 <code>hexo generate</code>（简写 <code>hexo g</code>）。最后一行出现 <code>Generated</code> 才算过，有 Pug 或 YAML 报错先解决，<code>layout.pug</code>、<code>rightmenu.pug</code> 写错会直接编译失败。</li><li><strong>本地预览</strong>：执行 <code>hexo server</code>（简写 <code>hexo s</code>），打开 <code>http://localhost:4000</code>，逐个确认灯笼、标题切换、星空、猫猫、鼠标样式、右键菜单、F12 拦截、帧率、控制台字符画、顶部进度条是否都生效。</li><li><strong>强制刷新或清缓存</strong>：改过 CSS / JS 后按 <code>Ctrl + F5</code>；还不生效就 F12 → Application → Storage 清掉 <code>Cache Storage</code>。启用了 Service Worker 时先在 Application → Service Workers 里 <code>Unregister</code> 或勾 <code>Update on reload</code>，否则看到的一直是缓存里的旧文件。</li><li><strong>F12 查 404</strong>：Console 看有没有 <code>Uncaught</code>，Network 按状态码排序，确认 <code>/js/denglong.js</code>、<code>/css/universe.css</code>、<code>/css/progress_bar.css</code> 这些新路径返回 200。404 多半是目录写错（<code>source/js</code> 和 <code>source/css</code> 别混）或文件名大小写不一致。</li><li><strong>部署</strong>：把生成的 <code>public/</code> 按原来的方式传上去——Nginx 把站点根目录指向 <code>public/</code>、GitHub Pages 推 <code>public/</code>、Vercel 重新部署，或执行 <code>hexo deploy</code>。上传后关掉缓存再访问线上地址，确认和本地一致。</li></ol><p>版本号别忘了同步：<code>_config.butterfly.yml</code> 里 <code>/css/custom.css?v=...</code>、<code>/js/xxx.js?v=...</code> 的 <code>?v=</code> 改一次升一次，否则浏览器或 CDN 会继续用旧缓存，出现「明明改了却没生效」。</p>]]>
    </content>
    <id>https://cookiesky.cn/2025/01/16/hexo-magic/</id>
    <link href="https://cookiesky.cn/2025/01/16/hexo-magic/"/>
    <published>2025-01-16T04:43:18.000Z</published>
    <summary>hexo魔改教程（一）</summary>
    <title>hexo魔改教程（一）</title>
    <updated>2026-11-22T17:12:15.676Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="GXNU" scheme="https://cookiesky.cn/categories/GXNU/"/>
    <category term="AI" scheme="https://cookiesky.cn/categories/AI/"/>
    <category term="Python" scheme="https://cookiesky.cn/tags/Python/"/>
    <category term="AI" scheme="https://cookiesky.cn/tags/AI/"/>
    <category term="大数据" scheme="https://cookiesky.cn/tags/%E5%A4%A7%E6%95%B0%E6%8D%AE/"/>
    <content>
      <![CDATA[<h1 id="一、ollama安装"><a href="#一、ollama安装" class="headerlink" title="一、ollama安装"></a>一、ollama安装</h1><p>可以在ollama官网直接下载：<a href="https://ollama.com/download">https://ollama.com/download</a><br>也可以在项目仓库中下载：<a href="https://github.com/ollama/ollama">https://github.com/ollama/ollama</a><br>下载后双击安装包进行安装，默认安装至C盘，如果C盘内存不够，我们需要修改环境变量，使得大模型能够放在别的盘。</p><p>可参考教程<a href="https://blog.csdn.net/scj0725/article/details/138087028">ollama在windows系统上安装总结以及注意事项</a>、<a href="https://blog.csdn.net/qq_53795212/article/details/139690567">Ollama+Open WebUI本地部署Llama3 8b（附踩坑细节）</a></p><h2 id="1-1-修改环境变量"><a href="#1-1-修改环境变量" class="headerlink" title="1.1 修改环境变量"></a>1.1 修改环境变量</h2><p>在系统变量中添加一个名为：OLLAMA_MODELS的变量名，路径选择一个合适的位置。<br><a href="https://i-blog.csdnimg.cn/blog_migrate/6091d24315aba96a96c1bf5ab7bdb27e.png">ollama-install-1</a><br>设置好路径之后，一定要重新启动重启，才能生效。</p><h2 id="1-2-拉取大模型"><a href="#1-2-拉取大模型" class="headerlink" title="1.2 拉取大模型"></a>1.2 拉取大模型</h2><p>接下来就是拉去大模型，打开官网可以看到从ollama可以直接拉取的大模型：<br><a href="https://i-blog.csdnimg.cn/blog_migrate/68a650f133fb1ef1d0f4a7665fb2e07b.png">ollama-install-2</a><br>例如我选择的是<a href="https://ollama.com/library/qwen2.5-coder">qwen2.5-coder</a>点进去之后，也可以选择版本.<br>然后拉去这个大模型的话，直接复制右边的命令：<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">ollama run qwen2.5-coder</span><br></pre></td></tr></table></figure><br>等待下载完成进入ollama的命令行界面，即可正常运行。<br>一定要注意，自己的电脑配置是否适合模型的大小。<br><code>注意：您应该至少有 8 GB 可用 RAM 来运行 7B 型号，16 GB 来运行 13B 型号，32 GB 来运行 33B 型号。</code><br>还可以安装一些web和桌面程序来交互大模型，例如<a href="https://docs.openwebui.com/">open-webui</a></p><h2 id="1-3-安装open-webui"><a href="#1-3-安装open-webui" class="headerlink" title="1.3 安装open-webui"></a>1.3 安装open-webui</h2><p>根据官网文档<a href="https://docs.openwebui.com/">https://docs.openwebui.com/</a>中提示可知，如果使用pip来安装的话，需要python版本为3.11。<br>docker安装自行查看官网文档或上面的参考教程即可。<br>这里我们以pip安装为例，可以安装python3.11版本后使用，如果你有anaconda环境的话，也可以新建一个虚拟环境来安装。<br><code>如果不需要虚拟环境，已经是3.11版本python的话，可跳过此步。</code></p><h3 id="1-3-1、anaconda和Visual-Studio安装"><a href="#1-3-1、anaconda和Visual-Studio安装" class="headerlink" title="1.3.1、anaconda和Visual Studio安装"></a>1.3.1、anaconda和Visual Studio安装</h3><h4 id="下载"><a href="#下载" class="headerlink" title="下载"></a>下载</h4><p><a href="https://www.anaconda.com/products/distribution">下载链接：https://www.anaconda.com/products/distribution</a></p><h4 id="安装"><a href="#安装" class="headerlink" title="安装"></a>安装</h4><p>双击运行，一直下一步即可。（如不想安装在C盘，自行选择目录即可）<br><code>注意一定要选择添加进PATH，不然终端无法运行</code></p><h4 id="Visual-Studio安装"><a href="#Visual-Studio安装" class="headerlink" title="Visual Studio安装"></a>Visual Studio安装</h4><p><a href="https://visualstudio.microsoft.com/zh-hans/">下载链接：https://visualstudio.microsoft.com/zh-hans/</a></p><h3 id="anaconda新建环境"><a href="#anaconda新建环境" class="headerlink" title="anaconda新建环境"></a>anaconda新建环境</h3><p>终端输入以下命令，代表用python3.11版本新建一个名为ollama的环境<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">conda create -n ollama python=3.11</span><br></pre></td></tr></table></figure></p><h3 id="1-3-2-激活ollama环境"><a href="#1-3-2-激活ollama环境" class="headerlink" title="1.3.2 激活ollama环境"></a>1.3.2 激活ollama环境</h3><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">conda activate ollama</span><br></pre></td></tr></table></figure><p>进入环境以后就可以继续安装open-webui了。</p><h3 id="1-3-3安装open-webui"><a href="#1-3-3安装open-webui" class="headerlink" title="1.3.3安装open-webui"></a>1.3.3安装open-webui</h3><p><code>如果本身是python3.11版本的话，可以直接使用pip安装(从上面跳的步骤到这里继续)。</code><br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">pip install open-webui</span><br></pre></td></tr></table></figure></p><h3 id="1-3-4启动open-webui"><a href="#1-3-4启动open-webui" class="headerlink" title="1.3.4启动open-webui"></a>1.3.4启动open-webui</h3><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">open-webui serve</span><br></pre></td></tr></table></figure><h3 id="1-3-5访问open-webui"><a href="#1-3-5访问open-webui" class="headerlink" title="1.3.5访问open-webui"></a>1.3.5访问open-webui</h3><p>做完以上步骤我们就可以在 <a href="http://localhost:8080">http://localhost:8080</a> 访问open-webui了。 Enjoy! 😄</p><h2 id="1-4-ollama-帮助"><a href="#1-4-ollama-帮助" class="headerlink" title="1.4 ollama 帮助"></a>1.4 ollama 帮助</h2><p>Usage:<br>  ollama [flags]<br>  ollama [command]</p><p>Available Commands:<br>  serve       Start ollama<br>  create      Create a model from a Modelfile<br>  show        Show information for a model<br>  run         Run a model<br>  stop        Stop a running model<br>  pull        Pull a model from a registry<br>  push        Push a model to a registry<br>  list        List models<br>  ps          List running models<br>  cp          Copy a model<br>  rm          Remove a model<br>  help        Help about any command</p><p>Flags:<br>  -h, —help      help for ollama<br>  -v, —version   Show version information</p><p>Use “ollama [command] —help” for more information about a command.</p><h2 id="1-5-使用ollama-api-来输入并获取输出"><a href="#1-5-使用ollama-api-来输入并获取输出" class="headerlink" title="1.5 使用ollama api 来输入并获取输出"></a>1.5 使用ollama api 来输入并获取输出</h2><p>官方api文档可见：<a href="https://github.com/ollama/ollama/blob/main/docs/api.md">ollama-api</a><br>找了好久，基本找不到合适的代码，但终于找到可能能用的JAVA代码，如下：<br><figure class="highlight java"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">public</span> <span class="keyword">static</span> String <span class="title function_">askLocalQwen2Model</span><span class="params">(String prompt)</span> <span class="keyword">throws</span> IOException &#123;</span><br><span class="line">    <span class="type">String</span> <span class="variable">urlString</span> <span class="operator">=</span> <span class="string">&quot;http://localhost:11434/api/generate&quot;</span>;</span><br><span class="line">    <span class="type">URL</span> <span class="variable">url</span> <span class="operator">=</span> <span class="keyword">new</span> <span class="title class_">URL</span>(urlString);</span><br><span class="line">    <span class="type">HttpURLConnection</span> <span class="variable">conn</span> <span class="operator">=</span> (HttpURLConnection) url.openConnection();</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 设置请求方法为POST</span></span><br><span class="line">    conn.setRequestMethod(<span class="string">&quot;POST&quot;</span>);</span><br><span class="line">    conn.setRequestProperty(<span class="string">&quot;Content-Type&quot;</span>, <span class="string">&quot;application/json; utf-8&quot;</span>);</span><br><span class="line">    conn.setRequestProperty(<span class="string">&quot;Accept&quot;</span>, <span class="string">&quot;application/json&quot;</span>);</span><br><span class="line">    conn.setDoOutput(<span class="literal">true</span>);</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 创建要发送的JSON对象</span></span><br><span class="line">    <span class="type">JSONObject</span> <span class="variable">jsonInput</span> <span class="operator">=</span> <span class="keyword">new</span> <span class="title class_">JSONObject</span>();</span><br><span class="line">    jsonInput.put(<span class="string">&quot;model&quot;</span>, <span class="string">&quot;qwen2&quot;</span>);</span><br><span class="line">    jsonInput.put(<span class="string">&quot;prompt&quot;</span>, prompt);</span><br><span class="line">    jsonInput.put(<span class="string">&quot;stream&quot;</span>, <span class="literal">false</span>);</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 将JSON输入写入请求的输出流</span></span><br><span class="line">    <span class="keyword">try</span> (<span class="type">OutputStream</span> <span class="variable">os</span> <span class="operator">=</span> conn.getOutputStream()) &#123;</span><br><span class="line">        <span class="type">byte</span>[] input = jsonInput.toString().getBytes(<span class="string">&quot;utf-8&quot;</span>);</span><br><span class="line">        os.write(input, <span class="number">0</span>, input.length);</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="comment">// 读取响应内容</span></span><br><span class="line">    <span class="keyword">try</span> (<span class="type">BufferedReader</span> <span class="variable">br</span> <span class="operator">=</span> <span class="keyword">new</span> <span class="title class_">BufferedReader</span>(<span class="keyword">new</span> <span class="title class_">InputStreamReader</span>(conn.getInputStream(), <span class="string">&quot;utf-8&quot;</span>))) &#123;</span><br><span class="line">        <span class="type">StringBuilder</span> <span class="variable">response</span> <span class="operator">=</span> <span class="keyword">new</span> <span class="title class_">StringBuilder</span>();</span><br><span class="line">        String responseLine;</span><br><span class="line">        <span class="keyword">while</span> ((responseLine = br.readLine()) != <span class="literal">null</span>) &#123;</span><br><span class="line">            response.append(responseLine.trim());</span><br><span class="line">        &#125;</span><br><span class="line"></span><br><span class="line">        <span class="comment">// 解析JSON响应并提取response字段</span></span><br><span class="line">        <span class="type">JSONObject</span> <span class="variable">jsonResponse</span> <span class="operator">=</span> <span class="keyword">new</span> <span class="title class_">JSONObject</span>(response.toString());</span><br><span class="line">        <span class="keyword">return</span> jsonResponse.getString(<span class="string">&quot;response&quot;</span>);</span><br><span class="line">    &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br>因此，我们用python来写，实现相应的功能代码示例如下：<br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> requests</span><br><span class="line"><span class="keyword">import</span> json</span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">askLocalQwen2Model</span>(<span class="params">prompt</span>):</span><br><span class="line">    url = <span class="string">&quot;http://localhost:11434/api/generate&quot;</span></span><br><span class="line">    </span><br><span class="line">    <span class="comment"># 创建要发送的JSON对象</span></span><br><span class="line">    json_input = &#123;</span><br><span class="line">        <span class="string">&quot;model&quot;</span>: <span class="string">&quot;qwen2&quot;</span>,</span><br><span class="line">        <span class="string">&quot;prompt&quot;</span>: prompt,</span><br><span class="line">        <span class="string">&quot;stream&quot;</span>: <span class="literal">False</span></span><br><span class="line">    &#125;</span><br><span class="line">    </span><br><span class="line">    <span class="keyword">try</span>:</span><br><span class="line">        <span class="comment"># 发送POST请求</span></span><br><span class="line">        response = requests.post(url, headers=&#123;<span class="string">&quot;Content-Type&quot;</span>: <span class="string">&quot;application/json&quot;</span>&#125;, data=json.dumps(json_input))</span><br><span class="line">        </span><br><span class="line">        <span class="comment"># 检查响应状态码</span></span><br><span class="line">        <span class="keyword">if</span> response.status_code == <span class="number">200</span>:</span><br><span class="line">            <span class="comment"># 解析JSON响应并提取response字段</span></span><br><span class="line">            json_response = response.json()</span><br><span class="line">            <span class="keyword">return</span> json_response.get(<span class="string">&quot;response&quot;</span>, <span class="string">&quot;&quot;</span>)</span><br><span class="line">        <span class="keyword">else</span>:</span><br><span class="line">            <span class="built_in">print</span>(<span class="string">f&quot;Failed to get response from Qwen2 model. Status code: <span class="subst">&#123;response.status_code&#125;</span>&quot;</span>)</span><br><span class="line">            <span class="keyword">return</span> <span class="string">&quot;&quot;</span></span><br><span class="line">    <span class="keyword">except</span> requests.RequestException <span class="keyword">as</span> e:</span><br><span class="line">        <span class="built_in">print</span>(<span class="string">f&quot;An error occurred: <span class="subst">&#123;e&#125;</span>&quot;</span>)</span><br><span class="line">        <span class="keyword">return</span> <span class="string">&quot;&quot;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># 示例调用</span></span><br><span class="line">prompt = <span class="string">&quot;Here is an article about llamas...&quot;</span></span><br><span class="line">result = askLocalQwen2Model(prompt)</span><br><span class="line"><span class="built_in">print</span>(result)</span><br></pre></td></tr></table></figure><br>经过以上步骤，在<code>prompt = &quot;Here is an article about llamas...</code>等于号后面输入内容，我们就可以得到<code>Qwen2</code>模型生成的回答了。<br>目前api已经基本实现。后续有什么需要修改的可以自行魔改。</p>]]>
    </content>
    <id>https://cookiesky.cn/2024/12/02/ollama-install/</id>
    <link href="https://cookiesky.cn/2024/12/02/ollama-install/"/>
    <published>2024-12-02T01:55:10.000Z</published>
    <summary>
      <![CDATA[<h1 id="一、ollama安装"><a href="#一、ollama安装" class="headerlink" title="一、ollama安装"></a>一、ollama安装</h1><p>可以在ollama官网直接下载：<a]]>
    </summary>
    <title>ollama-install</title>
    <updated>2026-11-10T12:22:41.945Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="hexo" scheme="https://cookiesky.cn/categories/hexo/"/>
    <category term="hexo" scheme="https://cookiesky.cn/tags/hexo/"/>
    <content>
      <![CDATA[<div class="note blue icon-padding flat"><i class="note-icon fas fa-fan"></i><p>过了这么久，才想起做一个hexo的配置教程，因为帮很多人搭了很多遍，现在总结记录一下吧，也方便下次我复制代码<br>本文借鉴 Fomalhaut（猕猴桃）的《Hexo 博客搭建基础教程（一）》，按 <code>Hexo 8.1.2</code> + <code>Butterfly 5.7.2</code> 重写了 Windows 命令、路径与部署步骤，并补了本站踩坑说明。<br>博客搭建与魔改系列教程导航🚥🚥🚥</p><ul><li><a href="/2024/11/11/hexo-install/">hexo基础教程（一）</a></li><li><a href="/2025/01/16/hexo-magic/">hexo魔改教程（一）</a></li><li><a href="/2026/11/11/hexo-magic2/">hexo魔改教程（二）</a></li><li><a href="/2026/11/11/hexo-magic3/">hexo魔改教程（三）</a></li><li><a href="/2026/11/22/hexo-magic4/">hexo魔改教程（四）</a></li><li><a href="/2026/11/22/hexo-magic5/">hexo魔改教程（五）</a></li><li><a href="/2026/11/23/hexo-magic6/">hexo魔改教程（六）</a></li><li><a href="/2026/11/22/hexo-beauty/">综合美化模块教程</a></li></ul></div><p>阅读约定：下面每个代码块上方都标了这一块要改哪个文件、怎么改，或者命令该在哪执行、做什么。<code>[Blogroot]</code> 指博客根目录，也就是 <code>hexo init blog</code> 生成的那个 <code>blog</code> 文件夹，教程里写作 <code>D:/hexo/blog</code>。</p><h1 id="1-环境与工具准备"><a href="#1-环境与工具准备" class="headerlink" title="1.环境与工具准备"></a>1.环境与工具准备</h1><p>本教程主要面对的是Windows用户</p><ul><li>操作系统：Windows10</li><li>Node</li><li>Git</li><li>Hexo</li><li>文本编辑器(强烈推荐VSCODE)</li><li>GitHub 帐号</li><li>一个域名（强烈推荐买个域名）</li><li>云服务器（可选）<h1 id="2-Node安装"><a href="#2-Node安装" class="headerlink" title="2.Node安装"></a>2.Node安装</h1></li></ul><ol><li>打开Node官网，下载和自己系统相配的Node的安装程序，否则会出现安装问题。下载地址：<a href="https://nodejs.org/en/download/">https://nodejs.org/en/download/</a></li><li>下载后安装，安装的目录可以使用默认目录【D:/Program Files/nodejs/】，也可以自定义路径。</li><li>这个环境路径切换坑也很多，如果大家C盘空间足够可以直接装C盘，如果想切换其他盘或者把环境遍历切换到自定义路径也可以，具体教程百度(不过坑比较多就是了)!</li><li>安装完成后，检查是否安装成功。在键盘按下win + R键，输入CMD，然后回车，打开CMD窗口，执行node -v命令，看到版本信息，则说明安装成功。</li><li>修改npm源。npm下载各种模块，默认是从国处服务器下载，速度较慢，建议配置成淘宝镜像。打开CMD窗口，运行如下命令:</li></ol><p><strong>执行位置</strong>：任意目录的终端（CMD 或 Git BASH）｜ <strong>作用</strong>：把 npm 默认源换成淘宝镜像，只写本机 npm 配置，不会改动博客目录里的任何文件。这条老地址已停用，实际建议直接用下面第二条。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm config set registry https://registry.npm.taobao.org</span><br></pre></td></tr></table></figure><p>不过经过我的测试我觉得换成下面的国内告高速镜像源也不错</p><p><strong>执行位置</strong>：任意目录的终端 ｜ <strong>作用</strong>：换成 npmmirror（淘宝镜像的新地址），装包速度稳定，推荐长期用这一条。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm config set registry https://registry.npmmirror.com</span><br></pre></td></tr></table></figure><p>想要还原默认源的话，执行如下命令：</p><p><strong>执行位置</strong>：任意目录的终端 ｜ <strong>作用</strong>：还原 npm 官方源，公司内网或某些 CI 环境只认官方源时执行这一条。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm config set registry https://registry.npmjs.org</span><br></pre></td></tr></table></figure><h1 id="3-Hexo安装"><a href="#3-Hexo安装" class="headerlink" title="3.Hexo安装"></a>3.Hexo安装</h1><ol><li>在<code>Git BASH</code>输入如下命令安装</li></ol><p><strong>执行位置</strong>：任意目录的 Git BASH ｜ <strong>作用</strong>：全局安装 <code>hexo-cli</code>，装完在任何目录都能敲 <code>hexo</code> 命令；因为装在全局，此时还没有 <code>blog</code> 文件夹也能执行。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install -g hexo-cli</span><br></pre></td></tr></table></figure><ol><li>安装完后输入hexo -v验证是否安装成功。</li><li>这里方便一次性安装和初始化，我们直接使用这个命令即可</li></ol><p><strong>执行位置</strong>：准备放博客的那个目录（如 <code>D:/hexo</code>）打开 Git BASH ｜ <strong>作用</strong>：一次跑完「装 CLI → 在当前目录新建 <code>blog</code> 项目 → 进项目 → 装依赖 → 启动本地预览」。最后一行 <code>hexo server</code> 会占住终端，按 <code>Ctrl + C</code> 退出；后面第 7 节再单步做时，不要重复执行 <code>hexo init</code>。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-cli -g</span><br><span class="line">hexo init blog</span><br><span class="line">cd blog</span><br><span class="line">npm install</span><br><span class="line">hexo server</span><br><span class="line"></span><br></pre></td></tr></table></figure><h1 id="4-Github注册与创建仓库"><a href="#4-Github注册与创建仓库" class="headerlink" title="4.Github注册与创建仓库"></a>4.Github注册与创建仓库</h1><ol><li>进入官网 <a href="https://github.com/">https://github.com/</a><br><img src="https://bu.dusays.com/2022/05/12/627d2c0449341.webp" alt="Github注册"><br>点击右上角的 Sign up(注册)<br><img src="https://bu.dusays.com/2022/05/12/627d2c05ee628.png" alt="Github注册"></li><li>填写自己的邮箱、密码、用户名等信息，然后用邮箱验证即可完成。</li><li>注册完成后，点击右上角的<code>+</code>按钮，选择<code>New repository</code>，创建一个<code>&lt;用户名&gt;.github.io</code>的仓库。<br><code>注意：</code></li></ol><ul><li>仓库的格式必须为：<code>&lt;用户名&gt;.github.io</code> (注意：前缀必须为用户名，不要等后面404了再来为什么！！！)</li><li>Description：为描述仓库（选填）</li><li>勾选 Initialize this repository with a README 初始化一个 README.md 文件</li><li>点击 Creat repository 进行创建<h1 id="5-Git安装"><a href="#5-Git安装" class="headerlink" title="5. Git安装"></a>5. Git安装</h1></li></ul><ol><li>进入官网：<a href="https://git-scm.com/downloads">https://git-scm.com/downloads</a> ，由于官网下载太慢可以通过淘宝的开源镜像下载 网址：<a href="https://registry.npmmirror.com/binary.html?path=git-for-windows/v2.36.1.windows.1/">https://registry.npmmirror.com/binary.html?path=git-for-windows/v2.36.1.windows.1/</a> ，下载版本更具自己的需求选择即可。</li><li>下载后傻瓜式安装Git即可，安装的目录可以使用默认目录【D:/Program Files/Git】，也可以自定义路径。<br><img src="https://bu.dusays.com/2022/05/13/627d410ddc940.webp" alt="Git安装"></li><li>点击电脑左下角开始即可看见<code>Git Bash</code>。<br><code>Git CMD</code> 是windows命令行的指令风格<br><code>Git Bash</code> 是linux系统的指令风格（建议使用）<br><code>Git GUI</code>是图形化界面（新手学习不建议使用）</li><li>常用命令</li></ol><p><strong>执行位置</strong>：任意目录的 Git BASH ｜ <strong>作用</strong>：只读查看 Git 现有配置，用来确认下一步有没有写进去，不会改动任何文件。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">git config -l  //查看所有配置</span><br><span class="line">git config --system --list //查看系统配置</span><br><span class="line">git config --global --list //查看用户（全局）配置</span><br></pre></td></tr></table></figure><ol><li>配置用户名和邮箱</li></ol><p><strong>执行位置</strong>：任意目录的 Git BASH ｜ <strong>作用</strong>：写入全局配置 <code>C:/Users/用户名/.gitconfig</code>。把引号里的占位内容换成自己的 GitHub 用户名和注册邮箱，邮箱要和 GitHub 账号一致，否则提交记录不算在你头上。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">git config --global user.name &quot;你的用户名&quot;</span><br><span class="line">git config --global user.email &quot;你的邮箱&quot;</span><br></pre></td></tr></table></figure><p>通过<code>git config -l</code> 检查是否配置成功，至此git安装及配置全部完成。</p><h1 id="6-连接至Github"><a href="#6-连接至Github" class="headerlink" title="6.连接至Github"></a>6.连接至Github</h1><ol><li>执行以下命令生成ssh公钥，此公钥用于你的计算机连接Github</li></ol><p><strong>执行位置</strong>：任意目录的 Git BASH ｜ <strong>作用</strong>：在 <code>C:/Users/用户名/.ssh</code> 下生成 <code>id_rsa</code>（私钥）和 <code>id_rsa.pub</code>（公钥）。中途一路回车、密码留空即可；<code>-C</code> 后面只是备注，同样换成自己的邮箱。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">ssh-keygen -t rsa -C &quot;你的邮箱&quot;</span><br></pre></td></tr></table></figure><p>之后打开C盘下用户文件夹下的<code>.ssh</code>的文件夹，会看到 <code>id_rsa.pub</code><br><img src="https://bu.dusays.com/2022/05/14/627e87126fc59.png" alt="公钥"><br>用记事本打开上述图片中的公钥（id_rsa.pub），复制里面的内容，然后开始在github中配置ssh密钥。<br><img src="https://bu.dusays.com/2022/05/14/627e87156038a.png" alt="公钥"></p><ol><li>将 SSH KEY 配置到 GitHub<br>进入github，点击右上角头像 选择<code>settings</code>，进入设置页后选择 <code>SSH and GPG keys</code>，名字随便起，公钥填到<code>Key</code>那一栏。</li><li>测试连接</li></ol><p><strong>执行位置</strong>：任意目录的 Git BASH ｜ <strong>作用</strong>：用刚配好的公钥测试能否连上 GitHub，只做验证，不产生文件、不需要改配置。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">ssh -T git@github.com</span><br></pre></td></tr></table></figure><p>如果出现<code>Hi XXX! You&#39;ve successfully authenticated, but GitHub does not provide shell access.</code>，则说明连接成功，至此完成了环境准备工作。<br>如果出现<code>ssh: connect to host github.com port 22: Connection timed out</code>，则说明连接失败，需要检查网络连接。<br>如果出现<code>Are you sure you want to continue connecting (yes/no/[fingerprint])?</code>，输入<code>yes</code>即可。</p><h1 id="7-初始化-Hexo-项目"><a href="#7-初始化-Hexo-项目" class="headerlink" title="7.初始化 Hexo 项目"></a>7.初始化 Hexo 项目</h1><ul><li></li></ul><ol><li>在目标路径（我这里选的路径为【D:/hexo】）打开cmd命令窗口，执行<code>hexo init</code>初始化项目。<br><code>魔改后不要输入hexo init，否则会重置</code><br><code>如果第三步安装hexo时你已经做过这个步骤，不需要做此步了，跳到第3点去看即可</code></li></ol><p><strong>执行位置</strong>：想放博客的那个目录（教程里是 <code>D:/hexo</code>）打开终端 ｜ <strong>作用</strong>：在当前目录下新建项目文件夹。括号里是说明文字，不要照抄，直接执行 <code>hexo init blog</code>，这个 <code>blog</code> 就是后文说的 <code>[Blogroot]</code>。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">hexo init blog(项目名)</span><br></pre></td></tr></table></figure><ol><li>进入<code>blog</code> ，输入<code>npm i</code>安装相关依赖。</li></ol><p><strong>执行位置</strong>：项目的上一级目录（<code>D:/hexo</code>）终端 ｜ <strong>作用</strong>：进入 <code>blog</code> 并安装 <code>package.json</code> 里列出的依赖。<code>//</code> 后面是注释放 Git BASH 能原样粘贴，CMD 下那句只敲 <code>cd blog</code> 就好。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">cd blog  //进入blog文件夹</span><br><span class="line">npm i</span><br></pre></td></tr></table></figure><p>初始化项目后，<code>blog</code>有如下结构：</p><ul><li>【node_modules】：依赖包</li><li>【scaffolds】：生成文章的一些模板</li><li>【source】：用来存放你的文章</li><li>【themes】：主题</li><li>【.npmignore】：发布时忽略的文件（可忽略）</li><li>【_config.landscape.yml】：主题的配置文件</li><li>【config.yml】：博客的配置文件</li><li>【package.json】：项目名称、描述、版本、运行和开发等信息</li></ul><ol><li>输入<code>hexo server</code>或者<code>hexo s</code>启动项目</li><li>打开浏览器，输入地址：<code>http://localhost:4000/</code> ，看到下面的效果，说明你的博客已经构建成功了。<br><img src="https://bu.dusays.com/2022/05/26/628e5423df640.webp" alt="成功"><h1 id="8-将静态博客挂载到-GitHub-Pages"><a href="#8-将静态博客挂载到-GitHub-Pages" class="headerlink" title="8.将静态博客挂载到 GitHub Pages"></a>8.将静态博客挂载到 GitHub Pages</h1></li><li>安装 <code>hexo-deployer-git</code>上传插件</li></ol><p><strong>执行位置</strong>：博客根目录（<code>[Blogroot]</code>）终端 ｜ <strong>作用</strong>：安装 GitHub Pages 部署插件，<code>--save</code> 会把它写进 <code>package.json</code>，换电脑重装依赖时不会漏。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-deployer-git --save</span><br></pre></td></tr></table></figure><p>修改 _config.yml 文件<br>在blog目录下的_config.yml，就是整个Hexo框架的配置文件了。可以在里面修改大部分的配置。详细可参考官方的<a href="https://hexo.io/zh-cn/docs/configuration">配置描述</a>。<br>修改最后一行的配置，将repository修改为你自己的github项目地址即可，还有分支要改为<code>main</code>代表主分支（注意缩进）。</p><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code> ｜ <strong>改法</strong>：替换文件末尾的 <code>deploy:</code> 段（Hexo 默认模板里这一段是 <code>type: &#39;&#39;</code> 的注释示例），保持两格缩进；<code>repository</code> 换成你自己的仓库地址，占位符 <code>用户名</code> 的两处都要改。</p><figure class="highlight yaml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">deploy:</span></span><br><span class="line">  <span class="attr">type:</span> <span class="string">git</span></span><br><span class="line">  <span class="attr">repository:</span> <span class="string">git@github.com:用户名/用户名.github.io.git</span></span><br><span class="line">  <span class="attr">branch:</span> <span class="string">main</span></span><br></pre></td></tr></table></figure><ol><li>修改好配置后，运行如下命令，将代码部署到 GitHub（Hexo三连）。<br>Git BASH终端</li></ol><p><strong>执行位置</strong>：博客根目录的 Git BASH ｜ <strong>作用</strong>：清缓存 → 生成 <code>public/</code> → 按上一步 <code>_config.yml</code> 里的 <code>deploy</code> 配置推送，一条命令跑完。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">hexo clean &amp;&amp; hexo generate &amp;&amp; hexo deploy</span><br></pre></td></tr></table></figure><p>vscode终端</p><p><strong>执行位置</strong>：博客根目录的 VS Code 终端（默认是 PowerShell）｜ <strong>作用</strong>：和上一条完全等价，只是 PowerShell 不认 <code>&amp;&amp;</code>，所以改成分号分隔。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">hexo clean; hexo generate; hexo deploy</span><br></pre></td></tr></table></figure><ul><li>hexo clean：删除之前生成的文件，若未生成过静态文件，可忽略此命令。可以用<code>hexo cl</code>缩写</li><li>hexo generate：生成静态文章，可以用<code>hexo g</code>缩写</li><li>hexo deploy：部署文章，可以用<code>hexo d</code>缩写<div class="tip warning faa-horizontal animated"><p>注意：deploy时可能要你输入 username 和 password。</p></div>如果出现<code>Deploy done</code>，则说明部署成功了。<br>稍等两分钟，打开浏览器访问：<code>https://用户名.github.io</code> ，这时候我们就可以看到博客内容了。<h1 id="9-无法连接至Github的解决方案"><a href="#9-无法连接至Github的解决方案" class="headerlink" title="9.无法连接至Github的解决方案"></a>9.无法连接至Github的解决方案</h1><div class="note info flat"><p>注意：当你在与Github进行ssh通信时候出现超时或者是连接被关闭的情况，可以尝试以下解决方案。</p></div></li></ul><ol><li>挂代理和换网络（这个就不用多说了）</li><li><a href="https://blog.csdn.net/weixin_41287260/article/details/124368189">Git问题：解决“ssh:connect to host github.com port 22: Connection timed out”</a><br>这是评论区的朋友提供的，可以解决SSH连接超时等问题</li><li>开源项目<a href="https://github.com/521xueweihan/GitHub520">Github520</a><br>通过修改Host文件的方法解决访问速度慢的问题</li></ol><p>连接有效性检验：</p><p><strong>执行位置</strong>：任意目录的 Git BASH ｜ <strong>作用</strong>：排查网络用，两条任选其一，只验证连通性，不改任何文件。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment"># 任选其一即可</span></span><br><span class="line">ping github.com</span><br><span class="line">ssh -T git@github.com</span><br></pre></td></tr></table></figure><h1 id="10-安装主题"><a href="#10-安装主题" class="headerlink" title="10.安装主题"></a>10.安装主题</h1><p>本教程用的 🦋 hexo-theme-butterfly 主题 v4.13.0</p><p>本教程用的是npm方式安装的 <code>hexo-theme-butterfly</code>，后续魔改时更改的文件都是【D:/hexo/blog/node_modules/hexo-theme-butterfly】文件夹中的文件。如果你是git clone克隆方式安装的主题，请在【D:/hexo/blog/themes/butterfly】文件夹下修改对应的文件。<br><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">npm安装（推荐）</button><button type="button" class="tab">Github安装</button><button type="button" class="tab">Gitee安装</button></div><div class="tab-contents"><div class="tab-item-content active"><p>注意：此方法只支持 Hexo 5.0.0以上版本!<br>在你的博客根目录（我这里路径为【D:/hexo/blog】）打开<code>Git BASH</code>命令窗口执行<code>npm i hexo-theme-butterfly</code></p><p><strong>执行位置</strong>：博客根目录的 Git BASH ｜ <strong>作用</strong>：用 npm 把主题装进 <code>[Blogroot]/node_modules/hexo-theme-butterfly</code>，装完不用再改主题名，后面魔改都改这个目录里的文件。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm i hexo-theme-butterfly</span><br></pre></td></tr></table></figure><p>安装成功后可在【D:/hexo/blog/node_modules】文件夹下找到hexo-theme-butterfly文件夹</p><div class="note info modern"><p>升级方法：在博客根目录下，运行 <code>npm update hexo-theme-butterfly</code>。<br>升级前请将<code>hexo-theme-butterfly</code>文件夹备份，npm更新会直接覆盖成新的包。</p></div></div><div class="tab-item-content"><p>在你的博客根目录里（我这里路径为【D:/hexo/blog】），打开<code>Git BASH</code>工具，执行命令即可。</p><p><strong>执行位置</strong>：博客根目录的 Git BASH ｜ <strong>作用</strong>：把主题克隆到 <code>[Blogroot]/themes/butterfly</code>。<code>-b</code> 后面是主题版本号，正文说的是 v4.13.0、命令里写的是 4.5.0，按你要用的版本统一成一个即可。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">git clone -b 4.5.0 https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly</span><br></pre></td></tr></table></figure><p>安装成功后可在【D:/hexo/blog/themes】文件夹下找到<code>butterfly</code>文件夹，可以将<code>landscape</code>文件夹删掉。</p><div class="note info modern"><p>升级方法：在主题目录下，运行<code>git pull</code>。</p></div></div><div class="tab-item-content"><p>在你的博客根目录里（我这里路径为【D:/hexo/blog】），打开<code>Git BASH</code>工具，执行命令即可。</p><p><strong>执行位置</strong>：博客根目录的 Git BASH ｜ <strong>作用</strong>：从 Gitee 镜像克隆同一个主题到 <code>[Blogroot]/themes/butterfly</code>，GitHub 拉不动时用这条，和上一条二选一，不要都执行。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">git clone -b 4.5.0 https://gitee.com/iamjerryw/hexo-theme-butterfly.git themes/butterfly</span><br></pre></td></tr></table></figure><div class="note info modern"><p>升级方法：在主题目录下，运行<code>git pull</code>。</p></div></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div></p><h1 id="11-应用主题"><a href="#11-应用主题" class="headerlink" title="11.应用主题"></a>11.应用主题</h1><ol><li>修改站点配置文件<code>_config.yml</code>，把主题改为<code>butterfly</code></li></ol><p><strong>文件</strong>：<code>[Blogroot]/_config.yml</code>（站点配置，不是主题的 <code>_config.yml</code>）｜ <strong>改法</strong>：只把 <code>theme:</code> 的值从默认的 <code>landscape</code> 改成 <code>butterfly</code>，缩进和其它站点配置保持一致，不要重复写第二个 <code>theme:</code>。</p><figure class="highlight yaml"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">theme:</span> <span class="string">butterfly</span></span><br></pre></td></tr></table></figure><ol><li>如果你没有<code>pug</code>以及<code>stylus</code>的渲染器，请下载安装，这两个渲染器是<code>Butterfly</code>生成基础页面所需的依赖包：</li></ol><p><strong>执行位置</strong>：博客根目录的终端 ｜ <strong>作用</strong>：安装主题需要的 pug / stylus 渲染器；缺了这两个，换主题后执行 <code>hexo g</code> 会直接报模板渲染错误。</p><figure class="highlight shell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-renderer-pug hexo-renderer-stylus --save</span><br></pre></td></tr></table></figure><p>为了减少升级主题后带来的不便，请使用以下方法（建议，可以不做，高度魔改的一般都不会升级主题了，不然魔改的会被覆盖掉）</p><p>把主题文件夹中的 <code>_config.yml</code> 复制到 <code>Hexo</code> 根目录里（我这里路径为【D:/hexo/blog】），同时重新命名为 <code>_config.butterfly.yml</code>。以后只需要在 <code>_config.butterfly.yml</code>进行配置即可生效。Hexo会自动合併主题中的<code>_config.yml</code>和<code>_config.butterfly.yml</code>里的配置，如果存在同名配置，会使用<code>_config.butterfly.yml</code>的配置，其优先度较高。</p><h1 id="12-快速安装汇总代码"><a href="#12-快速安装汇总代码" class="headerlink" title="12.快速安装汇总代码"></a>12.快速安装汇总代码</h1><p>确保Nodejs/Git环境已经安装好，然后打开<code>Git BASH</code>工具或者cmd，执行以下命令安装hexo：</p><p><strong>执行位置</strong>：准备放博客的父目录（如 <code>D:/hexo</code>）终端 ｜ <strong>作用</strong>：汇总版，等同第 3 节和第 7 节的完整流程；已经在第 7 节建好项目就跳过整段，重复执行 <code>hexo init</code> 会往同一目录再铺一套文件。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-cli -g</span><br><span class="line">hexo init blog</span><br><span class="line"><span class="built_in">cd</span> blog</span><br><span class="line">npm install</span><br><span class="line">hexo server</span><br><span class="line"></span><br></pre></td></tr></table></figure><p>安装主题及渲染器、deploy插件、word-count插件：</p><p><strong>执行位置</strong>：博客根目录（<code>[Blogroot]</code>）终端 ｜ <strong>作用</strong>：一次装完主题、渲染器和 GitHub Pages 部署插件，分别对应第 10、11、8 节的三条安装命令。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">npm i hexo-theme-butterfly</span><br><span class="line">npm install hexo-renderer-pug hexo-renderer-stylus --save</span><br><span class="line">npm install hexo-deployer-git --save</span><br></pre></td></tr></table></figure><p>下载插件（可选）：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：装字数统计插件（可选）。<code>_config.butterfly.yml</code> 里 <code>wordcount.enable: true</code> 时必须有它，否则侧栏「网站信息」卡会读不到字数。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-wordcount --save</span><br></pre></td></tr></table></figure><p>本站复现还要用的插件：</p><p><strong>执行位置</strong>：博客根目录终端 ｜ <strong>作用</strong>：补齐站内搜索、随机页、文章加密、订阅源和第三方脚本本地化所需的插件；只搭基础主题可以跳过这一段。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">npm install hexo-butterfly-tag-plugins-plus --save</span><br><span class="line">npm install hexo-generator-search hexo-generator-random --save</span><br><span class="line">npm install hexo-generator-feed --save</span><br><span class="line">npm install hexo-blog-encrypt --save</span><br><span class="line">npm install hexo-butterfly-extjs --save</span><br></pre></td></tr></table></figure><div class="table-container"><table><thead><tr><th>插件</th><th>对应功能</th><th>不装会怎样</th></tr></thead><tbody><tr><td><code>hexo-butterfly-tag-plugins-plus</code></td><td>教程和页面里的 folding / note 标签</td><td>标签不解析，直接显示成文本</td></tr><tr><td><code>hexo-generator-search</code></td><td><code>_config.yml</code> 的 <code>search.path: search.xml</code>，主题 <code>local_search.enable: true</code></td><td>搜索框能打开，但搜不到文章</td></tr><tr><td><code>hexo-generator-random</code></td><td>导航「随便逛逛」指向 <code>/random.html</code></td><td><code>/random.html</code> 不生成，点进去 404</td></tr><tr><td><code>hexo-generator-feed</code></td><td><code>_config.yml</code> 的 <code>feed:</code>，生成 <code>/atom.xml</code></td><td>订阅源不生成；详细配置见魔改（四）</td></tr><tr><td><code>hexo-blog-encrypt</code></td><td><code>_config.yml</code> 的 <code>encrypt:</code>，文章 front matter 写 <code>password:</code></td><td>加密文章会直接明文输出</td></tr><tr><td><code>hexo-butterfly-extjs</code></td><td><code>_config.butterfly.yml</code> 把 <code>CDN.third_party_provider</code> 设为 <code>local</code></td><td>本地化配置不生效，第三方脚本仍走默认 CDN</td></tr></tbody></table></div><p>魔改（三）开头还会一次安装折叠块、页脚徽标、磁贴等组件插件；那批不是基础主题必需，做到对应章节再装。下面这些插件本站装过，但对应功能当前关闭或没有内容在用，不装不影响构建，需要时再补：<code>hexo-hide-posts</code>（隐藏文章）、<code>hexo-generator-index-pin-top</code>（<code>top</code> 置顶）、<code>hexo-butterfly-envelope</code>（信封留言，<code>enable: false</code>）、<code>hexo-filter-gitcalendar</code>（GitHub 日历，<code>enable: false</code>）、<code>hexo-tag-aplayer</code>（aplayer 标签，音乐页用的是自定义播放器）、<code>hexo-algolia</code>（Algolia 搜索，<code>enable: false</code>）。</p><h1 id="13-解决问题"><a href="#13-解决问题" class="headerlink" title="13.解决问题"></a>13.解决问题</h1><p>npm国内速度慢</p><p><strong>执行位置</strong>：任意目录的终端 ｜ <strong>作用</strong>：换回国内镜像源解决装包慢，和第 2 节那条命令等价，执行一次就够，不用每次装包都跑。</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npm config <span class="built_in">set</span> registry https://registry.npmmirror.com</span><br></pre></td></tr></table></figure><p>如果是终端安装，提示不能运行npm脚本</p><p><strong>说明</strong>：这是 PowerShell 的执行策略报错示例，给你对照用的，不需要修改任何文件；解决办法是下面那条命令。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">. : 无法加载文件 C:\Users\用户名\Documents\WindowsPowerShell\profile.ps1</span><br><span class="line">因为在此系统上禁止运行脚本。有关详细信息，请参阅</span><br></pre></td></tr></table></figure><p>使用下述命令允许所有脚本运行即可</p><p><strong>执行位置</strong>：Windows PowerShell 窗口（不要用 Git BASH，bash 不认这条命令）｜ <strong>作用</strong>：把当前用户的脚本执行策略改成 <code>RemoteSigned</code>，执行完关掉终端重开，npm 就不会再被拦。</p><figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="built_in">Set-ExecutionPolicy</span> RemoteSigned <span class="literal">-Scope</span> CurrentUser</span><br></pre></td></tr></table></figure><h1 id="配置文件复制"><a href="#配置文件复制" class="headerlink" title="配置文件复制"></a>配置文件复制</h1><p>这一步就是第 11 节最后一段说的做法：把主题自带的 <code>_config.yml</code> 复制到博客根目录并改名 <code>_config.butterfly.yml</code>。下面这份是常用键的整理版，可以整段写入，没列到的键继续沿用主题默认值。</p><p><strong>文件</strong>：<code>[Blogroot]/_config.butterfly.yml</code> ｜ <strong>改法</strong>：新建文件。先把主题自带的 <code>_config.yml</code> 整份复制过来再改名（npm 安装在 <code>[Blogroot]/node_modules/hexo-theme-butterfly/_config.yml</code>，git 克隆在 <code>[Blogroot]/themes/butterfly/_config.yml</code>），然后照着下面同名的键逐项改；同一个键两份文件都有时，以 <code>_config.butterfly.yml</code> 为准。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br><span class="line">84</span><br><span class="line">85</span><br><span class="line">86</span><br><span class="line">87</span><br><span class="line">88</span><br><span class="line">89</span><br><span class="line">90</span><br><span class="line">91</span><br><span class="line">92</span><br><span class="line">93</span><br><span class="line">94</span><br><span class="line">95</span><br><span class="line">96</span><br><span class="line">97</span><br><span class="line">98</span><br><span class="line">99</span><br><span class="line">100</span><br><span class="line">101</span><br><span class="line">102</span><br><span class="line">103</span><br><span class="line">104</span><br><span class="line">105</span><br><span class="line">106</span><br><span class="line">107</span><br><span class="line">108</span><br><span class="line">109</span><br><span class="line">110</span><br><span class="line">111</span><br><span class="line">112</span><br><span class="line">113</span><br><span class="line">114</span><br><span class="line">115</span><br><span class="line">116</span><br><span class="line">117</span><br><span class="line">118</span><br><span class="line">119</span><br><span class="line">120</span><br><span class="line">121</span><br><span class="line">122</span><br><span class="line">123</span><br><span class="line">124</span><br><span class="line">125</span><br><span class="line">126</span><br><span class="line">127</span><br><span class="line">128</span><br><span class="line">129</span><br><span class="line">130</span><br><span class="line">131</span><br><span class="line">132</span><br><span class="line">133</span><br><span class="line">134</span><br><span class="line">135</span><br><span class="line">136</span><br><span class="line">137</span><br><span class="line">138</span><br><span class="line">139</span><br><span class="line">140</span><br><span class="line">141</span><br><span class="line">142</span><br><span class="line">143</span><br><span class="line">144</span><br><span class="line">145</span><br><span class="line">146</span><br><span class="line">147</span><br><span class="line">148</span><br><span class="line">149</span><br><span class="line">150</span><br><span class="line">151</span><br><span class="line">152</span><br><span class="line">153</span><br><span class="line">154</span><br><span class="line">155</span><br><span class="line">156</span><br><span class="line">157</span><br><span class="line">158</span><br><span class="line">159</span><br><span class="line">160</span><br><span class="line">161</span><br><span class="line">162</span><br><span class="line">163</span><br><span class="line">164</span><br><span class="line">165</span><br><span class="line">166</span><br><span class="line">167</span><br><span class="line">168</span><br><span class="line">169</span><br><span class="line">170</span><br><span class="line">171</span><br><span class="line">172</span><br><span class="line">173</span><br><span class="line">174</span><br><span class="line">175</span><br><span class="line">176</span><br><span class="line">177</span><br><span class="line">178</span><br><span class="line">179</span><br><span class="line">180</span><br><span class="line">181</span><br><span class="line">182</span><br><span class="line">183</span><br><span class="line">184</span><br><span class="line">185</span><br><span class="line">186</span><br><span class="line">187</span><br><span class="line">188</span><br><span class="line">189</span><br><span class="line">190</span><br><span class="line">191</span><br><span class="line">192</span><br><span class="line">193</span><br><span class="line">194</span><br><span class="line">195</span><br><span class="line">196</span><br><span class="line">197</span><br><span class="line">198</span><br><span class="line">199</span><br><span class="line">200</span><br><span class="line">201</span><br><span class="line">202</span><br><span class="line">203</span><br><span class="line">204</span><br><span class="line">205</span><br><span class="line">206</span><br><span class="line">207</span><br><span class="line">208</span><br><span class="line">209</span><br><span class="line">210</span><br><span class="line">211</span><br><span class="line">212</span><br><span class="line">213</span><br><span class="line">214</span><br><span class="line">215</span><br><span class="line">216</span><br><span class="line">217</span><br><span class="line">218</span><br><span class="line">219</span><br><span class="line">220</span><br><span class="line">221</span><br><span class="line">222</span><br><span class="line">223</span><br><span class="line">224</span><br><span class="line">225</span><br><span class="line">226</span><br><span class="line">227</span><br><span class="line">228</span><br><span class="line">229</span><br><span class="line">230</span><br><span class="line">231</span><br><span class="line">232</span><br><span class="line">233</span><br><span class="line">234</span><br><span class="line">235</span><br><span class="line">236</span><br><span class="line">237</span><br><span class="line">238</span><br><span class="line">239</span><br><span class="line">240</span><br><span class="line">241</span><br><span class="line">242</span><br><span class="line">243</span><br><span class="line">244</span><br><span class="line">245</span><br><span class="line">246</span><br><span class="line">247</span><br><span class="line">248</span><br><span class="line">249</span><br><span class="line">250</span><br><span class="line">251</span><br><span class="line">252</span><br><span class="line">253</span><br><span class="line">254</span><br><span class="line">255</span><br><span class="line">256</span><br><span class="line">257</span><br><span class="line">258</span><br><span class="line">259</span><br><span class="line">260</span><br><span class="line">261</span><br><span class="line">262</span><br><span class="line">263</span><br><span class="line">264</span><br><span class="line">265</span><br><span class="line">266</span><br><span class="line">267</span><br><span class="line">268</span><br><span class="line">269</span><br><span class="line">270</span><br><span class="line">271</span><br><span class="line">272</span><br><span class="line">273</span><br><span class="line">274</span><br><span class="line">275</span><br><span class="line">276</span><br><span class="line">277</span><br><span class="line">278</span><br><span class="line">279</span><br><span class="line">280</span><br><span class="line">281</span><br><span class="line">282</span><br><span class="line">283</span><br><span class="line">284</span><br><span class="line">285</span><br><span class="line">286</span><br><span class="line">287</span><br><span class="line">288</span><br><span class="line">289</span><br><span class="line">290</span><br><span class="line">291</span><br><span class="line">292</span><br><span class="line">293</span><br><span class="line">294</span><br><span class="line">295</span><br><span class="line">296</span><br><span class="line">297</span><br><span class="line">298</span><br><span class="line">299</span><br><span class="line">300</span><br><span class="line">301</span><br><span class="line">302</span><br><span class="line">303</span><br><span class="line">304</span><br><span class="line">305</span><br><span class="line">306</span><br><span class="line">307</span><br><span class="line">308</span><br><span class="line">309</span><br><span class="line">310</span><br><span class="line">311</span><br><span class="line">312</span><br><span class="line">313</span><br><span class="line">314</span><br><span class="line">315</span><br><span class="line">316</span><br><span class="line">317</span><br><span class="line">318</span><br><span class="line">319</span><br><span class="line">320</span><br><span class="line">321</span><br><span class="line">322</span><br><span class="line">323</span><br><span class="line">324</span><br><span class="line">325</span><br><span class="line">326</span><br><span class="line">327</span><br><span class="line">328</span><br><span class="line">329</span><br><span class="line">330</span><br><span class="line">331</span><br><span class="line">332</span><br><span class="line">333</span><br><span class="line">334</span><br><span class="line">335</span><br><span class="line">336</span><br><span class="line">337</span><br><span class="line">338</span><br><span class="line">339</span><br><span class="line">340</span><br><span class="line">341</span><br><span class="line">342</span><br><span class="line">343</span><br><span class="line">344</span><br><span class="line">345</span><br><span class="line">346</span><br><span class="line">347</span><br><span class="line">348</span><br><span class="line">349</span><br><span class="line">350</span><br><span class="line">351</span><br><span class="line">352</span><br><span class="line">353</span><br><span class="line">354</span><br><span class="line">355</span><br><span class="line">356</span><br><span class="line">357</span><br><span class="line">358</span><br><span class="line">359</span><br><span class="line">360</span><br><span class="line">361</span><br><span class="line">362</span><br><span class="line">363</span><br><span class="line">364</span><br><span class="line">365</span><br><span class="line">366</span><br><span class="line">367</span><br><span class="line">368</span><br><span class="line">369</span><br><span class="line">370</span><br><span class="line">371</span><br><span class="line">372</span><br><span class="line">373</span><br><span class="line">374</span><br><span class="line">375</span><br><span class="line">376</span><br><span class="line">377</span><br><span class="line">378</span><br><span class="line">379</span><br><span class="line">380</span><br><span class="line">381</span><br><span class="line">382</span><br><span class="line">383</span><br><span class="line">384</span><br><span class="line">385</span><br><span class="line">386</span><br><span class="line">387</span><br><span class="line">388</span><br><span class="line">389</span><br><span class="line">390</span><br><span class="line">391</span><br><span class="line">392</span><br><span class="line">393</span><br><span class="line">394</span><br><span class="line">395</span><br><span class="line">396</span><br><span class="line">397</span><br><span class="line">398</span><br><span class="line">399</span><br><span class="line">400</span><br><span class="line">401</span><br><span class="line">402</span><br><span class="line">403</span><br><span class="line">404</span><br><span class="line">405</span><br><span class="line">406</span><br><span class="line">407</span><br><span class="line">408</span><br><span class="line">409</span><br><span class="line">410</span><br><span class="line">411</span><br><span class="line">412</span><br><span class="line">413</span><br><span class="line">414</span><br><span class="line">415</span><br><span class="line">416</span><br><span class="line">417</span><br><span class="line">418</span><br><span class="line">419</span><br><span class="line">420</span><br><span class="line">421</span><br><span class="line">422</span><br><span class="line">423</span><br><span class="line">424</span><br><span class="line">425</span><br><span class="line">426</span><br><span class="line">427</span><br><span class="line">428</span><br><span class="line">429</span><br><span class="line">430</span><br><span class="line">431</span><br><span class="line">432</span><br><span class="line">433</span><br><span class="line">434</span><br><span class="line">435</span><br><span class="line">436</span><br><span class="line">437</span><br><span class="line">438</span><br><span class="line">439</span><br><span class="line">440</span><br><span class="line">441</span><br><span class="line">442</span><br><span class="line">443</span><br><span class="line">444</span><br><span class="line">445</span><br><span class="line">446</span><br><span class="line">447</span><br><span class="line">448</span><br><span class="line">449</span><br><span class="line">450</span><br><span class="line">451</span><br><span class="line">452</span><br><span class="line">453</span><br><span class="line">454</span><br><span class="line">455</span><br><span class="line">456</span><br><span class="line">457</span><br><span class="line">458</span><br><span class="line">459</span><br><span class="line">460</span><br><span class="line">461</span><br><span class="line">462</span><br><span class="line">463</span><br><span class="line">464</span><br><span class="line">465</span><br><span class="line">466</span><br><span class="line">467</span><br><span class="line">468</span><br><span class="line">469</span><br><span class="line">470</span><br><span class="line">471</span><br><span class="line">472</span><br><span class="line">473</span><br><span class="line">474</span><br><span class="line">475</span><br><span class="line">476</span><br><span class="line">477</span><br><span class="line">478</span><br><span class="line">479</span><br><span class="line">480</span><br><span class="line">481</span><br><span class="line">482</span><br><span class="line">483</span><br><span class="line">484</span><br><span class="line">485</span><br><span class="line">486</span><br><span class="line">487</span><br><span class="line">488</span><br><span class="line">489</span><br><span class="line">490</span><br><span class="line">491</span><br><span class="line">492</span><br><span class="line">493</span><br><span class="line">494</span><br><span class="line">495</span><br><span class="line">496</span><br><span class="line">497</span><br><span class="line">498</span><br><span class="line">499</span><br><span class="line">500</span><br><span class="line">501</span><br><span class="line">502</span><br><span class="line">503</span><br><span class="line">504</span><br><span class="line">505</span><br><span class="line">506</span><br><span class="line">507</span><br><span class="line">508</span><br><span class="line">509</span><br><span class="line">510</span><br><span class="line">511</span><br><span class="line">512</span><br><span class="line">513</span><br><span class="line">514</span><br><span class="line">515</span><br><span class="line">516</span><br><span class="line">517</span><br><span class="line">518</span><br><span class="line">519</span><br><span class="line">520</span><br><span class="line">521</span><br><span class="line">522</span><br><span class="line">523</span><br><span class="line">524</span><br><span class="line">525</span><br><span class="line">526</span><br><span class="line">527</span><br><span class="line">528</span><br><span class="line">529</span><br><span class="line">530</span><br><span class="line">531</span><br><span class="line">532</span><br><span class="line">533</span><br><span class="line">534</span><br><span class="line">535</span><br><span class="line">536</span><br><span class="line">537</span><br><span class="line">538</span><br><span class="line">539</span><br><span class="line">540</span><br><span class="line">541</span><br><span class="line">542</span><br><span class="line">543</span><br><span class="line">544</span><br><span class="line">545</span><br><span class="line">546</span><br><span class="line">547</span><br><span class="line">548</span><br><span class="line">549</span><br><span class="line">550</span><br><span class="line">551</span><br><span class="line">552</span><br><span class="line">553</span><br><span class="line">554</span><br><span class="line">555</span><br><span class="line">556</span><br><span class="line">557</span><br><span class="line">558</span><br><span class="line">559</span><br><span class="line">560</span><br><span class="line">561</span><br><span class="line">562</span><br><span class="line">563</span><br><span class="line">564</span><br><span class="line">565</span><br><span class="line">566</span><br><span class="line">567</span><br><span class="line">568</span><br><span class="line">569</span><br><span class="line">570</span><br><span class="line">571</span><br><span class="line">572</span><br><span class="line">573</span><br><span class="line">574</span><br><span class="line">575</span><br><span class="line">576</span><br><span class="line">577</span><br><span class="line">578</span><br><span class="line">579</span><br><span class="line">580</span><br><span class="line">581</span><br><span class="line">582</span><br><span class="line">583</span><br><span class="line">584</span><br><span class="line">585</span><br><span class="line">586</span><br><span class="line">587</span><br><span class="line">588</span><br><span class="line">589</span><br><span class="line">590</span><br><span class="line">591</span><br><span class="line">592</span><br><span class="line">593</span><br><span class="line">594</span><br><span class="line">595</span><br><span class="line">596</span><br><span class="line">597</span><br><span class="line">598</span><br><span class="line">599</span><br><span class="line">600</span><br><span class="line">601</span><br><span class="line">602</span><br><span class="line">603</span><br><span class="line">604</span><br><span class="line">605</span><br><span class="line">606</span><br><span class="line">607</span><br><span class="line">608</span><br><span class="line">609</span><br><span class="line">610</span><br><span class="line">611</span><br><span class="line">612</span><br><span class="line">613</span><br><span class="line">614</span><br><span class="line">615</span><br><span class="line">616</span><br><span class="line">617</span><br><span class="line">618</span><br><span class="line">619</span><br><span class="line">620</span><br><span class="line">621</span><br><span class="line">622</span><br><span class="line">623</span><br><span class="line">624</span><br><span class="line">625</span><br><span class="line">626</span><br><span class="line">627</span><br><span class="line">628</span><br><span class="line">629</span><br><span class="line">630</span><br><span class="line">631</span><br><span class="line">632</span><br><span class="line">633</span><br><span class="line">634</span><br><span class="line">635</span><br><span class="line">636</span><br><span class="line">637</span><br><span class="line">638</span><br><span class="line">639</span><br><span class="line">640</span><br><span class="line">641</span><br><span class="line">642</span><br><span class="line">643</span><br><span class="line">644</span><br><span class="line">645</span><br><span class="line">646</span><br><span class="line">647</span><br><span class="line">648</span><br><span class="line">649</span><br><span class="line">650</span><br><span class="line">651</span><br><span class="line">652</span><br><span class="line">653</span><br><span class="line">654</span><br><span class="line">655</span><br><span class="line">656</span><br><span class="line">657</span><br><span class="line">658</span><br><span class="line">659</span><br><span class="line">660</span><br><span class="line">661</span><br><span class="line">662</span><br><span class="line">663</span><br><span class="line">664</span><br><span class="line">665</span><br><span class="line">666</span><br><span class="line">667</span><br><span class="line">668</span><br><span class="line">669</span><br><span class="line">670</span><br><span class="line">671</span><br><span class="line">672</span><br><span class="line">673</span><br><span class="line">674</span><br><span class="line">675</span><br><span class="line">676</span><br><span class="line">677</span><br><span class="line">678</span><br><span class="line">679</span><br><span class="line">680</span><br><span class="line">681</span><br><span class="line">682</span><br><span class="line">683</span><br><span class="line">684</span><br><span class="line">685</span><br><span class="line">686</span><br><span class="line">687</span><br><span class="line">688</span><br><span class="line">689</span><br><span class="line">690</span><br><span class="line">691</span><br><span class="line">692</span><br><span class="line">693</span><br><span class="line">694</span><br><span class="line">695</span><br><span class="line">696</span><br><span class="line">697</span><br><span class="line">698</span><br><span class="line">699</span><br><span class="line">700</span><br><span class="line">701</span><br><span class="line">702</span><br><span class="line">703</span><br><span class="line">704</span><br><span class="line">705</span><br><span class="line">706</span><br><span class="line">707</span><br><span class="line">708</span><br><span class="line">709</span><br><span class="line">710</span><br><span class="line">711</span><br><span class="line">712</span><br><span class="line">713</span><br><span class="line">714</span><br><span class="line">715</span><br><span class="line">716</span><br><span class="line">717</span><br><span class="line">718</span><br><span class="line">719</span><br><span class="line">720</span><br><span class="line">721</span><br><span class="line">722</span><br><span class="line">723</span><br><span class="line">724</span><br><span class="line">725</span><br><span class="line">726</span><br><span class="line">727</span><br><span class="line">728</span><br><span class="line">729</span><br><span class="line">730</span><br><span class="line">731</span><br><span class="line">732</span><br><span class="line">733</span><br><span class="line">734</span><br><span class="line">735</span><br><span class="line">736</span><br><span class="line">737</span><br><span class="line">738</span><br><span class="line">739</span><br><span class="line">740</span><br><span class="line">741</span><br><span class="line">742</span><br><span class="line">743</span><br><span class="line">744</span><br><span class="line">745</span><br><span class="line">746</span><br><span class="line">747</span><br><span class="line">748</span><br><span class="line">749</span><br><span class="line">750</span><br><span class="line">751</span><br><span class="line">752</span><br><span class="line">753</span><br><span class="line">754</span><br><span class="line">755</span><br><span class="line">756</span><br><span class="line">757</span><br><span class="line">758</span><br><span class="line">759</span><br><span class="line">760</span><br><span class="line">761</span><br><span class="line">762</span><br><span class="line">763</span><br><span class="line">764</span><br><span class="line">765</span><br><span class="line">766</span><br><span class="line">767</span><br><span class="line">768</span><br><span class="line">769</span><br><span class="line">770</span><br><span class="line">771</span><br><span class="line">772</span><br><span class="line">773</span><br><span class="line">774</span><br><span class="line">775</span><br><span class="line">776</span><br><span class="line">777</span><br><span class="line">778</span><br><span class="line">779</span><br><span class="line">780</span><br><span class="line">781</span><br><span class="line">782</span><br><span class="line">783</span><br><span class="line">784</span><br><span class="line">785</span><br><span class="line">786</span><br><span class="line">787</span><br><span class="line">788</span><br><span class="line">789</span><br><span class="line">790</span><br><span class="line">791</span><br><span class="line">792</span><br><span class="line">793</span><br><span class="line">794</span><br><span class="line">795</span><br><span class="line">796</span><br><span class="line">797</span><br><span class="line">798</span><br><span class="line">799</span><br><span class="line">800</span><br><span class="line">801</span><br><span class="line">802</span><br><span class="line">803</span><br><span class="line">804</span><br><span class="line">805</span><br><span class="line">806</span><br><span class="line">807</span><br><span class="line">808</span><br><span class="line">809</span><br><span class="line">810</span><br><span class="line">811</span><br><span class="line">812</span><br><span class="line">813</span><br><span class="line">814</span><br><span class="line">815</span><br><span class="line">816</span><br><span class="line">817</span><br><span class="line">818</span><br><span class="line">819</span><br><span class="line">820</span><br><span class="line">821</span><br><span class="line">822</span><br><span class="line">823</span><br><span class="line">824</span><br><span class="line">825</span><br><span class="line">826</span><br><span class="line">827</span><br><span class="line">828</span><br><span class="line">829</span><br><span class="line">830</span><br><span class="line">831</span><br><span class="line">832</span><br><span class="line">833</span><br><span class="line">834</span><br><span class="line">835</span><br><span class="line">836</span><br><span class="line">837</span><br><span class="line">838</span><br><span class="line">839</span><br><span class="line">840</span><br><span class="line">841</span><br><span class="line">842</span><br><span class="line">843</span><br><span class="line">844</span><br><span class="line">845</span><br><span class="line">846</span><br><span class="line">847</span><br><span class="line">848</span><br><span class="line">849</span><br><span class="line">850</span><br><span class="line">851</span><br><span class="line">852</span><br><span class="line">853</span><br><span class="line">854</span><br><span class="line">855</span><br><span class="line">856</span><br><span class="line">857</span><br><span class="line">858</span><br><span class="line">859</span><br><span class="line">860</span><br><span class="line">861</span><br><span class="line">862</span><br><span class="line">863</span><br><span class="line">864</span><br><span class="line">865</span><br><span class="line">866</span><br><span class="line">867</span><br><span class="line">868</span><br><span class="line">869</span><br><span class="line">870</span><br><span class="line">871</span><br><span class="line">872</span><br><span class="line">873</span><br><span class="line">874</span><br><span class="line">875</span><br><span class="line">876</span><br><span class="line">877</span><br><span class="line">878</span><br><span class="line">879</span><br><span class="line">880</span><br><span class="line">881</span><br><span class="line">882</span><br><span class="line">883</span><br><span class="line">884</span><br><span class="line">885</span><br><span class="line">886</span><br><span class="line">887</span><br><span class="line">888</span><br><span class="line">889</span><br><span class="line">890</span><br><span class="line">891</span><br><span class="line">892</span><br><span class="line">893</span><br><span class="line">894</span><br><span class="line">895</span><br><span class="line">896</span><br><span class="line">897</span><br><span class="line">898</span><br><span class="line">899</span><br><span class="line">900</span><br><span class="line">901</span><br><span class="line">902</span><br><span class="line">903</span><br><span class="line">904</span><br><span class="line">905</span><br><span class="line">906</span><br><span class="line">907</span><br><span class="line">908</span><br><span class="line">909</span><br><span class="line">910</span><br><span class="line">911</span><br><span class="line">912</span><br><span class="line">913</span><br><span class="line">914</span><br><span class="line">915</span><br><span class="line">916</span><br><span class="line">917</span><br><span class="line">918</span><br><span class="line">919</span><br><span class="line">920</span><br><span class="line">921</span><br><span class="line">922</span><br><span class="line">923</span><br><span class="line">924</span><br><span class="line">925</span><br><span class="line">926</span><br><span class="line">927</span><br><span class="line">928</span><br><span class="line">929</span><br><span class="line">930</span><br><span class="line">931</span><br><span class="line">932</span><br><span class="line">933</span><br><span class="line">934</span><br><span class="line">935</span><br><span class="line">936</span><br><span class="line">937</span><br><span class="line">938</span><br><span class="line">939</span><br><span class="line">940</span><br><span class="line">941</span><br><span class="line">942</span><br><span class="line">943</span><br><span class="line">944</span><br><span class="line">945</span><br><span class="line">946</span><br><span class="line">947</span><br><span class="line">948</span><br><span class="line">949</span><br><span class="line">950</span><br><span class="line">951</span><br><span class="line">952</span><br><span class="line">953</span><br><span class="line">954</span><br><span class="line">955</span><br><span class="line">956</span><br><span class="line">957</span><br><span class="line">958</span><br><span class="line">959</span><br><span class="line">960</span><br><span class="line">961</span><br><span class="line">962</span><br><span class="line">963</span><br><span class="line">964</span><br><span class="line">965</span><br><span class="line">966</span><br><span class="line">967</span><br><span class="line">968</span><br><span class="line">969</span><br><span class="line">970</span><br><span class="line">971</span><br><span class="line">972</span><br><span class="line">973</span><br><span class="line">974</span><br><span class="line">975</span><br><span class="line">976</span><br><span class="line">977</span><br><span class="line">978</span><br><span class="line">979</span><br><span class="line">980</span><br><span class="line">981</span><br><span class="line">982</span><br><span class="line">983</span><br><span class="line">984</span><br><span class="line">985</span><br><span class="line">986</span><br><span class="line">987</span><br><span class="line">988</span><br><span class="line">989</span><br><span class="line">990</span><br><span class="line">991</span><br><span class="line">992</span><br><span class="line">993</span><br><span class="line">994</span><br><span class="line">995</span><br><span class="line">996</span><br><span class="line">997</span><br><span class="line">998</span><br><span class="line">999</span><br><span class="line">1000</span><br><span class="line">1001</span><br><span class="line">1002</span><br><span class="line">1003</span><br><span class="line">1004</span><br><span class="line">1005</span><br><span class="line">1006</span><br><span class="line">1007</span><br><span class="line">1008</span><br><span class="line">1009</span><br><span class="line">1010</span><br><span class="line">1011</span><br><span class="line">1012</span><br><span class="line">1013</span><br><span class="line">1014</span><br><span class="line">1015</span><br><span class="line">1016</span><br><span class="line">1017</span><br><span class="line">1018</span><br><span class="line">1019</span><br><span class="line">1020</span><br><span class="line">1021</span><br><span class="line">1022</span><br><span class="line">1023</span><br><span class="line">1024</span><br><span class="line">1025</span><br><span class="line">1026</span><br><span class="line">1027</span><br><span class="line">1028</span><br><span class="line">1029</span><br><span class="line">1030</span><br><span class="line">1031</span><br><span class="line">1032</span><br><span class="line">1033</span><br><span class="line">1034</span><br><span class="line">1035</span><br><span class="line">1036</span><br><span class="line">1037</span><br><span class="line">1038</span><br><span class="line">1039</span><br><span class="line">1040</span><br><span class="line">1041</span><br><span class="line">1042</span><br><span class="line">1043</span><br><span class="line">1044</span><br><span class="line">1045</span><br><span class="line">1046</span><br><span class="line">1047</span><br><span class="line">1048</span><br><span class="line">1049</span><br><span class="line">1050</span><br><span class="line">1051</span><br><span class="line">1052</span><br><span class="line">1053</span><br><span class="line">1054</span><br><span class="line">1055</span><br><span class="line">1056</span><br><span class="line">1057</span><br><span class="line">1058</span><br><span class="line">1059</span><br><span class="line">1060</span><br><span class="line">1061</span><br><span class="line">1062</span><br><span class="line">1063</span><br><span class="line">1064</span><br><span class="line">1065</span><br><span class="line">1066</span><br><span class="line">1067</span><br><span class="line">1068</span><br><span class="line">1069</span><br><span class="line">1070</span><br><span class="line">1071</span><br><span class="line">1072</span><br><span class="line">1073</span><br><span class="line">1074</span><br><span class="line">1075</span><br><span class="line">1076</span><br><span class="line">1077</span><br><span class="line">1078</span><br><span class="line">1079</span><br><span class="line">1080</span><br><span class="line">1081</span><br><span class="line">1082</span><br><span class="line">1083</span><br><span class="line">1084</span><br><span class="line">1085</span><br><span class="line">1086</span><br><span class="line">1087</span><br><span class="line">1088</span><br><span class="line">1089</span><br><span class="line">1090</span><br><span class="line">1091</span><br><span class="line">1092</span><br><span class="line">1093</span><br><span class="line">1094</span><br><span class="line">1095</span><br><span class="line">1096</span><br><span class="line">1097</span><br><span class="line">1098</span><br><span class="line">1099</span><br><span class="line">1100</span><br><span class="line">1101</span><br><span class="line">1102</span><br><span class="line">1103</span><br><span class="line">1104</span><br><span class="line">1105</span><br><span class="line">1106</span><br><span class="line">1107</span><br><span class="line">1108</span><br><span class="line">1109</span><br><span class="line">1110</span><br><span class="line">1111</span><br><span class="line">1112</span><br><span class="line">1113</span><br><span class="line">1114</span><br><span class="line">1115</span><br><span class="line">1116</span><br><span class="line">1117</span><br><span class="line">1118</span><br><span class="line">1119</span><br><span class="line">1120</span><br><span class="line">1121</span><br><span class="line">1122</span><br><span class="line">1123</span><br><span class="line">1124</span><br><span class="line">1125</span><br><span class="line">1126</span><br><span class="line">1127</span><br><span class="line">1128</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Hexo Butterfly Theme Configuration</span></span><br><span class="line"><span class="comment"># If you have any questions, please refer to the documentation</span></span><br><span class="line"><span class="comment"># Chinese: https://butterfly.js.org/</span></span><br><span class="line"><span class="comment"># English: https://butterfly.js.org/en/</span></span><br><span class="line"><span class="comment"># version:5.4.3 update:20250827</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Navigation Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">nav:</span></span><br><span class="line">  <span class="comment"># Navigation bar logo image</span></span><br><span class="line">  <span class="attr">logo:</span> <span class="comment">##logo图片</span></span><br><span class="line">  <span class="attr">display_title:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">display_post_title:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Whether to fix navigation bar</span></span><br><span class="line">  <span class="attr">fixed:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="attr">menu:</span> <span class="comment">##菜单</span></span><br><span class="line">  <span class="comment"># Home: / || fas fa-home</span></span><br><span class="line">  <span class="comment"># List||fas fa-list:</span></span><br><span class="line">  <span class="comment">#   Music: /music/ || fas fa-music</span></span><br><span class="line">  <span class="comment">#   Movie: /movies/ || fas fa-video</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Code Blocks Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">code_blocks:</span></span><br><span class="line">  <span class="comment"># Code block theme: darker / pale night / light / ocean / false</span></span><br><span class="line">  <span class="attr">theme:</span> <span class="string">light</span> <span class="comment">##代码框主题颜色</span></span><br><span class="line">  <span class="attr">macStyle:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Code block height limit (unit: px)</span></span><br><span class="line">  <span class="attr">height_limit:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">word_wrap:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># Toolbar</span></span><br><span class="line">  <span class="attr">copy:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">language:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># true: shrink the code blocks | false: expand the code blocks | none: expand code blocks and hide the button</span></span><br><span class="line">  <span class="attr">shrink:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">fullpage:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Social media links</span></span><br><span class="line"><span class="comment"># Formal:</span></span><br><span class="line"><span class="comment">#   icon: link || the description || color</span></span><br><span class="line"><span class="attr">social:</span> <span class="comment">##社交</span></span><br><span class="line">  <span class="comment"># fab fa-github: https://github.com/xxxxx || Github || &#x27;#24292e&#x27; </span></span><br><span class="line">  <span class="comment"># fas fa-envelope: mailto:xxxxxx@gmail.com || Email || &#x27;#4a7dbe&#x27;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Image Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">favicon:</span> <span class="string">/img/favicon.png</span> <span class="comment">##网站图标</span></span><br><span class="line"></span><br><span class="line"><span class="attr">avatar:</span></span><br><span class="line">  <span class="attr">img:</span> <span class="string">/img/butterfly-icon.png</span> <span class="comment">##头像</span></span><br><span class="line">  <span class="attr">effect:</span> <span class="literal">false</span> <span class="comment">##true会一直旋转</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Disable all banner images</span></span><br><span class="line"><span class="attr">disable_top_img:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># If the banner of page not setting, it will show the default_top_img</span></span><br><span class="line"><span class="attr">default_top_img:</span> <span class="comment">##默认顶图</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The banner image of index page</span></span><br><span class="line"><span class="attr">index_img:</span> <span class="comment">##默认主页图</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The banner image of archive page</span></span><br><span class="line"><span class="attr">archive_img:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># <span class="doctag">Note:</span> tag page, not tags page</span></span><br><span class="line"><span class="attr">tag_img:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The banner image of tag page, you can set the banner image for each tag</span></span><br><span class="line"><span class="comment"># Format:</span></span><br><span class="line"><span class="comment">#  - tag name: xxxxx</span></span><br><span class="line"><span class="attr">tag_per_img:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># <span class="doctag">Note:</span> category page, not categories page</span></span><br><span class="line"><span class="attr">category_img:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The banner image of category page, you can set the banner image for each category</span></span><br><span class="line"><span class="comment"># Format:</span></span><br><span class="line"><span class="comment">#  - category name: xxxxx</span></span><br><span class="line"><span class="attr">category_per_img:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The background image of footer</span></span><br><span class="line"><span class="attr">footer_img:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Website Background</span></span><br><span class="line"><span class="comment"># Can set it to color or image url</span></span><br><span class="line"><span class="attr">background:</span> <span class="comment">##网站背景</span></span><br><span class="line"></span><br><span class="line"><span class="attr">cover:</span></span><br><span class="line">  <span class="comment"># Disable the cover or not</span></span><br><span class="line">  <span class="attr">index_enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">aside_enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">archives_enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># When cover is not set, the default cover is displayed</span></span><br><span class="line">  <span class="attr">default_cover:</span></span><br><span class="line">    <span class="comment"># - xxx.jpg</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Replace Broken Images</span></span><br><span class="line"><span class="attr">error_img:</span></span><br><span class="line">  <span class="attr">flink:</span> <span class="string">/img/friend_404.gif</span></span><br><span class="line">  <span class="attr">post_page:</span> <span class="string">/img/404.jpg</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># A simple 404 page</span></span><br><span class="line"><span class="attr">error_404:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">subtitle:</span> <span class="string">&#x27;Page Not Found&#x27;</span></span><br><span class="line">  <span class="attr">background:</span> <span class="string">/img/error-page.png</span></span><br><span class="line"></span><br><span class="line"><span class="attr">post_meta:</span></span><br><span class="line">  <span class="comment"># Home Page</span></span><br><span class="line">  <span class="attr">page:</span></span><br><span class="line">    <span class="comment"># Choose: created / updated / both</span></span><br><span class="line">    <span class="attr">date_type:</span> <span class="string">created</span></span><br><span class="line">    <span class="comment"># Choose: date / relative</span></span><br><span class="line">    <span class="attr">date_format:</span> <span class="string">date</span></span><br><span class="line">    <span class="attr">categories:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">tags:</span> <span class="literal">false</span></span><br><span class="line">    <span class="attr">label:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">post:</span></span><br><span class="line">    <span class="comment"># Choose: left / center</span></span><br><span class="line">    <span class="attr">position:</span> <span class="string">left</span></span><br><span class="line">    <span class="comment"># Choose: created / updated / both</span></span><br><span class="line">    <span class="attr">date_type:</span> <span class="string">both</span></span><br><span class="line">    <span class="comment"># Choose: date / relative</span></span><br><span class="line">    <span class="attr">date_format:</span> <span class="string">date</span></span><br><span class="line">    <span class="attr">categories:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">tags:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">label:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Index page settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The top_img settings of home page</span></span><br><span class="line"><span class="comment"># default: top img - full screen, site info - middle</span></span><br><span class="line"><span class="comment"># The position of site info, eg: 300px/300em/300rem/10%</span></span><br><span class="line"><span class="attr">index_site_info_top:</span></span><br><span class="line"><span class="comment"># The height of top_img, eg: 300px/300em/300rem</span></span><br><span class="line"><span class="attr">index_top_img_height:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The subtitle on homepage</span></span><br><span class="line"><span class="attr">subtitle:</span> <span class="comment">##副标题</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Typewriter Effect</span></span><br><span class="line">  <span class="attr">effect:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Customize typed.js</span></span><br><span class="line">  <span class="comment"># https://github.com/mattboldt/typed.js/#customization</span></span><br><span class="line">  <span class="attr">typed_option:</span></span><br><span class="line">  <span class="comment"># Source - Call the third-party service API (Chinese only)</span></span><br><span class="line">  <span class="comment"># It will show the source first, then show the content of sub</span></span><br><span class="line">  <span class="comment"># Choose: false/1/2/3</span></span><br><span class="line">  <span class="comment"># false - disable the function</span></span><br><span class="line">  <span class="comment"># 1 - hitokoto.cn</span></span><br><span class="line">  <span class="comment"># 2 - https://api.aa1.cn/doc/yiyan.html</span></span><br><span class="line">  <span class="comment"># 3 - jinrishici.com</span></span><br><span class="line">  <span class="attr">source:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># If you close the typewriter effect, the subtitle will only show the first line of sub</span></span><br><span class="line">  <span class="attr">sub:</span></span><br><span class="line">    <span class="bullet">-</span> <span class="string">&quot;欢迎来到我的博客！~&quot;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Article layout on the homepage</span></span><br><span class="line"><span class="comment"># 1: Cover on the left, info on the right</span></span><br><span class="line"><span class="comment"># 2: Cover on the right, info on the left</span></span><br><span class="line"><span class="comment"># 3: Cover and info alternate between left and right</span></span><br><span class="line"><span class="comment"># 4: Cover on top, info on the bottom</span></span><br><span class="line"><span class="comment"># 5: Info displayed on the cover</span></span><br><span class="line"><span class="comment"># 6: Masonry layout - Cover on top, info on the bottom</span></span><br><span class="line"><span class="comment"># 7: Masonry layout - Info displayed on the cover</span></span><br><span class="line"><span class="attr">index_layout:</span> <span class="number">3</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Display the article introduction on homepage</span></span><br><span class="line"><span class="comment"># 1: description</span></span><br><span class="line"><span class="comment"># 2: both (if the description exists, it will show description, or show the auto_excerpt)</span></span><br><span class="line"><span class="comment"># 3: auto_excerpt (default)</span></span><br><span class="line"><span class="comment"># false: do not show the article introduction</span></span><br><span class="line"><span class="attr">index_post_content:</span></span><br><span class="line">  <span class="attr">method:</span> <span class="number">2</span></span><br><span class="line">  <span class="comment"># If you set method to 2 or 3, the length need to config</span></span><br><span class="line">  <span class="attr">length:</span> <span class="number">500</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Post Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">toc:</span></span><br><span class="line">  <span class="attr">post:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">page:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">number:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">expand:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Only for post</span></span><br><span class="line">  <span class="attr">style_simple:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">scroll_percent:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="attr">post_copyright:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">decode:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">author_href:</span></span><br><span class="line">  <span class="attr">license:</span> <span class="string">CC</span> <span class="string">BY-NC-SA</span> <span class="number">4.0</span></span><br><span class="line">  <span class="attr">license_url:</span> <span class="string">https://creativecommons.org/licenses/by-nc-sa/4.0/</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Sponsor/reward</span></span><br><span class="line"><span class="attr">reward:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">text:</span></span><br><span class="line">  <span class="attr">QR_code:</span></span><br><span class="line">    <span class="comment"># - img: /img/wechat.jpg</span></span><br><span class="line">    <span class="comment">#   link:</span></span><br><span class="line">    <span class="comment">#   text: wechat</span></span><br><span class="line">    <span class="comment"># - img: /img/alipay.jpg</span></span><br><span class="line">    <span class="comment">#   link:</span></span><br><span class="line">    <span class="comment">#   text: alipay</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Post edit</span></span><br><span class="line"><span class="comment"># Easily browse and edit blog source code online.</span></span><br><span class="line"><span class="attr">post_edit:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/</span></span><br><span class="line">  <span class="comment"># For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/</span></span><br><span class="line">  <span class="attr">url:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Related Articles</span></span><br><span class="line"><span class="attr">related_post:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Number of posts displayed</span></span><br><span class="line">  <span class="attr">limit:</span> <span class="number">6</span></span><br><span class="line">  <span class="comment"># Choose: created / updated</span></span><br><span class="line">  <span class="attr">date_type:</span> <span class="string">created</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Choose: 1 / 2 / false</span></span><br><span class="line"><span class="comment"># 1: The &#x27;next post&#x27; will link to old post</span></span><br><span class="line"><span class="comment"># 2: The &#x27;next post&#x27; will link to new post</span></span><br><span class="line"><span class="comment"># false: disable pagination</span></span><br><span class="line"><span class="attr">post_pagination:</span> <span class="number">1</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Displays outdated notice for a post</span></span><br><span class="line"><span class="attr">noticeOutdate:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Style: simple / flat</span></span><br><span class="line">  <span class="attr">style:</span> <span class="string">flat</span></span><br><span class="line">  <span class="comment"># When will it be shown</span></span><br><span class="line">  <span class="attr">limit_day:</span> <span class="number">365</span></span><br><span class="line">  <span class="comment"># Position: top / bottom</span></span><br><span class="line">  <span class="attr">position:</span> <span class="string">top</span></span><br><span class="line">  <span class="attr">message_prev:</span> <span class="string">It</span> <span class="string">has</span> <span class="string">been</span></span><br><span class="line">  <span class="attr">message_next:</span> <span class="string">days</span> <span class="string">since</span> <span class="string">the</span> <span class="string">last</span> <span class="string">update,</span> <span class="string">the</span> <span class="string">content</span> <span class="string">of</span> <span class="string">the</span> <span class="string">article</span> <span class="string">may</span> <span class="string">be</span> <span class="string">outdated.</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Footer Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="attr">footer:</span></span><br><span class="line">  <span class="attr">nav:</span></span><br><span class="line">  <span class="attr">owner:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">since:</span> <span class="number">2025</span></span><br><span class="line">  <span class="comment"># Copyright of theme and framework</span></span><br><span class="line">  <span class="attr">copyright:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">version:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">custom_text:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Aside Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">aside:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">hide:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Show the button to hide the aside in bottom right button</span></span><br><span class="line">  <span class="attr">button:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Position: left / right</span></span><br><span class="line">  <span class="attr">position:</span> <span class="string">right</span></span><br><span class="line">  <span class="attr">display:</span></span><br><span class="line">    <span class="attr">archive:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">tag:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">category:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">card_author:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">description:</span></span><br><span class="line">    <span class="attr">button:</span></span><br><span class="line">      <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">      <span class="attr">icon:</span> <span class="string">fab</span> <span class="string">fa-github</span></span><br><span class="line">      <span class="attr">text:</span> <span class="string">Follow</span> <span class="string">Me</span></span><br><span class="line">      <span class="attr">link:</span> <span class="string">https://github.com/xxxxxx</span></span><br><span class="line">  <span class="attr">card_announcement:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">content:</span> <span class="string">This</span> <span class="string">is</span> <span class="string">my</span> <span class="string">Blog</span></span><br><span class="line">  <span class="attr">card_recent_post:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="comment"># If set 0 will show all</span></span><br><span class="line">    <span class="attr">limit:</span> <span class="number">5</span></span><br><span class="line">    <span class="comment"># Sort: date / updated</span></span><br><span class="line">    <span class="attr">sort:</span> <span class="string">date</span></span><br><span class="line">    <span class="attr">sort_order:</span></span><br><span class="line">  <span class="attr">card_newest_comments:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">    <span class="attr">sort_order:</span></span><br><span class="line">    <span class="attr">limit:</span> <span class="number">6</span></span><br><span class="line">    <span class="comment"># Unit: mins, save data to localStorage</span></span><br><span class="line">    <span class="attr">storage:</span> <span class="number">10</span></span><br><span class="line">    <span class="attr">avatar:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">card_categories:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="comment"># If set 0 will show all</span></span><br><span class="line">    <span class="attr">limit:</span> <span class="number">8</span></span><br><span class="line">    <span class="comment"># Choose: none / true / false</span></span><br><span class="line">    <span class="attr">expand:</span> <span class="string">none</span></span><br><span class="line">    <span class="attr">sort_order:</span></span><br><span class="line">  <span class="attr">card_tags:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="comment"># If set 0 will show all</span></span><br><span class="line">    <span class="attr">limit:</span> <span class="number">40</span></span><br><span class="line">    <span class="attr">color:</span> <span class="literal">false</span></span><br><span class="line">    <span class="comment"># Order of tags, random/name/length</span></span><br><span class="line">    <span class="attr">orderby:</span> <span class="string">random</span></span><br><span class="line">    <span class="comment"># Sort of order. 1, asc for ascending; -1, desc for descending</span></span><br><span class="line">    <span class="attr">order:</span> <span class="number">1</span></span><br><span class="line">    <span class="attr">sort_order:</span></span><br><span class="line">  <span class="attr">card_archives:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="comment"># Type: monthly / yearly</span></span><br><span class="line">    <span class="attr">type:</span> <span class="string">monthly</span></span><br><span class="line">    <span class="comment"># Eg: YYYY年MM月</span></span><br><span class="line">    <span class="attr">format:</span> <span class="string">MMMM</span> <span class="string">YYYY</span></span><br><span class="line">    <span class="comment"># Sort of order. 1, asc for ascending; -1, desc for descending</span></span><br><span class="line">    <span class="attr">order:</span> <span class="number">-1</span></span><br><span class="line">    <span class="comment"># If set 0 will show all</span></span><br><span class="line">    <span class="attr">limit:</span> <span class="number">8</span></span><br><span class="line">    <span class="attr">sort_order:</span></span><br><span class="line">  <span class="attr">card_post_series:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="comment"># The title shows the series name</span></span><br><span class="line">    <span class="attr">series_title:</span> <span class="literal">false</span></span><br><span class="line">    <span class="comment"># Order by title or date</span></span><br><span class="line">    <span class="attr">orderBy:</span> <span class="string">&#x27;date&#x27;</span></span><br><span class="line">    <span class="comment"># Sort of order. 1, asc for ascending; -1, desc for descending</span></span><br><span class="line">    <span class="attr">order:</span> <span class="number">-1</span></span><br><span class="line">  <span class="attr">card_webinfo:</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">post_count:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">last_push_date:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">sort_order:</span></span><br><span class="line">    <span class="comment"># Time difference between publish date and now</span></span><br><span class="line">    <span class="comment"># Formal: Month/Day/Year Time or Year/Month/Day Time</span></span><br><span class="line">    <span class="comment"># Leave it empty if you don&#x27;t enable this feature</span></span><br><span class="line">    <span class="attr">runtime_date:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Bottom right button</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The distance between the bottom right button and the bottom (default unit: px)</span></span><br><span class="line"><span class="attr">rightside_bottom:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Conversion between Traditional and Simplified Chinese</span></span><br><span class="line"><span class="attr">translate:</span> <span class="comment">##繁简转换</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># The text of a button</span></span><br><span class="line">  <span class="attr">default:</span> <span class="string">繁</span></span><br><span class="line">  <span class="comment"># the language of website (1 - Traditional Chinese/ 2 - Simplified Chinese）</span></span><br><span class="line">  <span class="attr">defaultEncoding:</span> <span class="number">2</span></span><br><span class="line">  <span class="comment"># Time delay</span></span><br><span class="line">  <span class="attr">translateDelay:</span> <span class="number">0</span></span><br><span class="line">  <span class="comment"># The text of the button when the language is Simplified Chinese</span></span><br><span class="line">  <span class="attr">msgToTraditionalChinese:</span> <span class="string">&#x27;繁&#x27;</span></span><br><span class="line">  <span class="comment"># The text of the button when the language is Traditional Chinese</span></span><br><span class="line">  <span class="attr">msgToSimplifiedChinese:</span> <span class="string">&#x27;簡&#x27;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Read Mode</span></span><br><span class="line"><span class="attr">readmode:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Dark Mode</span></span><br><span class="line"><span class="attr">darkmode:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Toggle Button to switch dark/light mode</span></span><br><span class="line">  <span class="attr">button:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Switch dark/light mode automatically</span></span><br><span class="line">  <span class="comment"># autoChangeMode: 1  Following System Settings, if the system doesn&#x27;t support dark mode, it will switch dark mode between 6 pm to 6 am</span></span><br><span class="line">  <span class="comment"># autoChangeMode: 2  Switch dark mode between 6 pm to 6 am</span></span><br><span class="line">  <span class="comment"># autoChangeMode: false</span></span><br><span class="line">  <span class="attr">autoChangeMode:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18</span></span><br><span class="line">  <span class="attr">start:</span></span><br><span class="line">  <span class="attr">end:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Show scroll percent in scroll-to-top button</span></span><br><span class="line"><span class="attr">rightside_scroll_percent:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Don&#x27;t modify the following settings unless you know how they work</span></span><br><span class="line"><span class="comment"># Choose: readmode,translate,darkmode,hideAside,toc,chat,comment</span></span><br><span class="line"><span class="comment"># Don&#x27;t repeat the same value</span></span><br><span class="line"><span class="attr">rightside_item_order:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Default: readmode,translate,darkmode,hideAside</span></span><br><span class="line">  <span class="attr">hide:</span></span><br><span class="line">  <span class="comment"># Default: toc,chat,comment</span></span><br><span class="line">  <span class="attr">show:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Animation for the bottom right config button</span></span><br><span class="line"><span class="attr">rightside_config_animation:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Global Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">anchor:</span></span><br><span class="line">  <span class="comment"># When you scroll, the URL will update according to header id.</span></span><br><span class="line">  <span class="attr">auto_update:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Click the headline to scroll and update the anchor</span></span><br><span class="line">  <span class="attr">click_to_scroll:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="attr">photofigcaption:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="attr">copy:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Add the copyright information after copied content</span></span><br><span class="line">  <span class="attr">copyright:</span> <span class="comment">##版权</span></span><br><span class="line">    <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">    <span class="attr">limit_count:</span> <span class="number">250</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Need to install the hexo-wordcount plugin</span></span><br><span class="line"><span class="attr">wordcount:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Display the word count of the article in post meta</span></span><br><span class="line">  <span class="attr">post_wordcount:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Display the time to read the article in post meta</span></span><br><span class="line">  <span class="attr">min2read:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Display the total word count of the website in aside&#x27;s webinfo</span></span><br><span class="line">  <span class="attr">total_wordcount:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Busuanzi count for PV / UV in site</span></span><br><span class="line"><span class="attr">busuanzi:</span></span><br><span class="line">  <span class="attr">site_uv:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">site_pv:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">page_pv:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Math</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># About the per_page</span></span><br><span class="line"><span class="comment"># if you set it to true, it will load mathjax/katex script in each page</span></span><br><span class="line"><span class="comment"># if you set it to false, it will load mathjax/katex script according to your setting (add the &#x27;mathjax: true&#x27; or &#x27;katex: true&#x27; in page&#x27;s front-matter)</span></span><br><span class="line"><span class="attr">math:</span></span><br><span class="line">  <span class="comment"># Choose: mathjax, katex</span></span><br><span class="line">  <span class="comment"># Leave it empty if you don&#x27;t need math</span></span><br><span class="line">  <span class="attr">use:</span></span><br><span class="line">  <span class="attr">per_page:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">hide_scrollbar:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line">  <span class="attr">mathjax:</span></span><br><span class="line">    <span class="comment"># Enable the contextual menu</span></span><br><span class="line">    <span class="attr">enableMenu:</span> <span class="literal">true</span></span><br><span class="line">    <span class="comment"># Choose: all / ams / none, This controls whether equations are numbered and how</span></span><br><span class="line">    <span class="attr">tags:</span> <span class="string">none</span></span><br><span class="line"></span><br><span class="line">  <span class="attr">katex:</span></span><br><span class="line">    <span class="comment"># Enable the copy KaTeX formula</span></span><br><span class="line">    <span class="attr">copy_tex:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Search</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">search:</span> <span class="comment">##搜索</span></span><br><span class="line">  <span class="comment"># Choose: algolia_search / local_search / docsearch</span></span><br><span class="line">  <span class="comment"># leave it empty if you don&#x27;t need search</span></span><br><span class="line">  <span class="attr">use:</span> <span class="number">2</span></span><br><span class="line">  <span class="attr">placeholder:</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># Algolia Search</span></span><br><span class="line">  <span class="attr">algolia_search:</span></span><br><span class="line">    <span class="comment"># Number of search results per page</span></span><br><span class="line">    <span class="attr">hitsPerPage:</span> <span class="number">6</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># Local Search</span></span><br><span class="line">  <span class="attr">local_search:</span></span><br><span class="line">    <span class="comment"># Preload the search data when the page loads.</span></span><br><span class="line">    <span class="attr">preload:</span> <span class="literal">false</span></span><br><span class="line">    <span class="comment"># Show top n results per article, show all results by setting to -1</span></span><br><span class="line">    <span class="attr">top_n_per_article:</span> <span class="number">1</span></span><br><span class="line">    <span class="comment"># Unescape html strings to the readable one.</span></span><br><span class="line">    <span class="attr">unescape:</span> <span class="literal">false</span></span><br><span class="line">    <span class="attr">CDN:</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># Docsearch</span></span><br><span class="line">  <span class="comment"># https://docsearch.algolia.com/</span></span><br><span class="line">  <span class="attr">docsearch:</span></span><br><span class="line">    <span class="attr">appId:</span></span><br><span class="line">    <span class="attr">apiKey:</span></span><br><span class="line">    <span class="attr">indexName:</span></span><br><span class="line">    <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Share System</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">share:</span></span><br><span class="line">  <span class="comment"># Choose: sharejs / addtoany</span></span><br><span class="line">  <span class="comment"># Leave it empty if you don&#x27;t need share</span></span><br><span class="line">  <span class="attr">use:</span> <span class="string">sharejs</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># Share.js</span></span><br><span class="line">  <span class="comment"># https://github.com/overtrue/share.js</span></span><br><span class="line">  <span class="attr">sharejs:</span></span><br><span class="line">    <span class="attr">sites:</span> <span class="string">facebook,twitter,wechat,weibo,qq</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># AddToAny</span></span><br><span class="line">  <span class="comment"># https://www.addtoany.com/</span></span><br><span class="line">  <span class="attr">addtoany:</span></span><br><span class="line">    <span class="attr">item:</span> <span class="string">facebook,twitter,wechat,sina_weibo,facebook_messenger,email,copy_link</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Comments System</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">comments:</span></span><br><span class="line">  <span class="comment"># Up to two comments system, the first will be shown as default</span></span><br><span class="line">  <span class="comment"># Leave it empty if you don&#x27;t need comments</span></span><br><span class="line">  <span class="comment"># Choose: Disqus/Disqusjs/Livere/Gitalk/Valine/Waline/Utterances/Facebook Comments/Twikoo/Giscus/Remark42/Artalk</span></span><br><span class="line">  <span class="comment"># Format of two comments system : Disqus,Waline</span></span><br><span class="line">  <span class="attr">use:</span></span><br><span class="line">  <span class="comment"># Display the comment name next to the button</span></span><br><span class="line">  <span class="attr">text:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Lazyload: The comment system will be load when comment element enters the browser&#x27;s viewport.</span></span><br><span class="line">  <span class="comment"># If you set it to true, the comment count will be invalid</span></span><br><span class="line">  <span class="attr">lazyload:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Display comment count in post&#x27;s top_img</span></span><br><span class="line">  <span class="attr">count:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Display comment count in Home Page</span></span><br><span class="line">  <span class="attr">card_post_count:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Disqus</span></span><br><span class="line"><span class="comment"># https://disqus.com/</span></span><br><span class="line"><span class="attr">disqus:</span></span><br><span class="line">  <span class="attr">shortname:</span></span><br><span class="line">  <span class="comment"># For newest comments widget</span></span><br><span class="line">  <span class="attr">apikey:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Alternative Disqus - Render comments with Disqus API</span></span><br><span class="line"><span class="comment"># https://github.com/SukkaW/DisqusJS</span></span><br><span class="line"><span class="attr">disqusjs:</span></span><br><span class="line">  <span class="attr">shortname:</span></span><br><span class="line">  <span class="attr">apikey:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Livere</span></span><br><span class="line"><span class="comment"># https://www.livere.com/</span></span><br><span class="line"><span class="attr">livere:</span></span><br><span class="line">  <span class="attr">uid:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Gitalk</span></span><br><span class="line"><span class="comment"># https://github.com/gitalk/gitalk</span></span><br><span class="line"><span class="attr">gitalk:</span></span><br><span class="line">  <span class="attr">client_id:</span></span><br><span class="line">  <span class="attr">client_secret:</span></span><br><span class="line">  <span class="attr">repo:</span></span><br><span class="line">  <span class="attr">owner:</span></span><br><span class="line">  <span class="attr">admin:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Valine</span></span><br><span class="line"><span class="comment"># https://valine.js.org</span></span><br><span class="line"><span class="attr">valine:</span></span><br><span class="line">  <span class="attr">appId:</span></span><br><span class="line">  <span class="attr">appKey:</span></span><br><span class="line">  <span class="attr">avatar:</span> <span class="string">monsterid</span></span><br><span class="line">  <span class="comment"># This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in)</span></span><br><span class="line">  <span class="attr">serverURLs:</span></span><br><span class="line">  <span class="attr">bg:</span></span><br><span class="line">  <span class="comment"># Use Valine visitor count as the page view count</span></span><br><span class="line">  <span class="attr">visitor:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Waline - A simple comment system with backend support fork from Valine</span></span><br><span class="line"><span class="comment"># https://waline.js.org/</span></span><br><span class="line"><span class="attr">waline:</span></span><br><span class="line">  <span class="attr">serverURL:</span></span><br><span class="line">  <span class="attr">bg:</span></span><br><span class="line">  <span class="comment"># Use Waline pageview count as the page view count</span></span><br><span class="line">  <span class="attr">pageview:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Utterances</span></span><br><span class="line"><span class="comment"># https://utteranc.es/</span></span><br><span class="line"><span class="attr">utterances:</span></span><br><span class="line">  <span class="attr">repo:</span></span><br><span class="line">  <span class="comment"># Issue Mapping: pathname/url/title/og:title</span></span><br><span class="line">  <span class="attr">issue_term:</span> <span class="string">pathname</span></span><br><span class="line">  <span class="comment"># Theme: github-light/github-dark/github-dark-orange/icy-dark/dark-blue/photon-dark</span></span><br><span class="line">  <span class="attr">light_theme:</span> <span class="string">github-light</span></span><br><span class="line">  <span class="attr">dark_theme:</span> <span class="string">photon-dark</span></span><br><span class="line">  <span class="attr">js:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Facebook Comments Plugin</span></span><br><span class="line"><span class="comment"># https://developers.facebook.com/docs/plugins/comments/</span></span><br><span class="line"><span class="attr">facebook_comments:</span></span><br><span class="line">  <span class="attr">app_id:</span></span><br><span class="line">  <span class="comment"># optional</span></span><br><span class="line">  <span class="attr">user_id:</span></span><br><span class="line">  <span class="attr">pageSize:</span> <span class="number">10</span></span><br><span class="line">  <span class="comment"># Choose: social / time / reverse_time</span></span><br><span class="line">  <span class="attr">order_by:</span> <span class="string">social</span></span><br><span class="line">  <span class="attr">lang:</span> <span class="string">en_US</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Twikoo</span></span><br><span class="line"><span class="comment"># https://github.com/imaegoo/twikoo</span></span><br><span class="line"><span class="attr">twikoo:</span></span><br><span class="line">  <span class="attr">envId:</span></span><br><span class="line">  <span class="attr">region:</span></span><br><span class="line">  <span class="comment"># Use Twikoo visitor count as the page view count</span></span><br><span class="line">  <span class="attr">visitor:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Giscus</span></span><br><span class="line"><span class="comment"># https://giscus.app/</span></span><br><span class="line"><span class="attr">giscus:</span></span><br><span class="line">  <span class="attr">repo:</span></span><br><span class="line">  <span class="attr">repo_id:</span></span><br><span class="line">  <span class="attr">category_id:</span></span><br><span class="line">  <span class="attr">light_theme:</span> <span class="string">light</span></span><br><span class="line">  <span class="attr">dark_theme:</span> <span class="string">dark</span></span><br><span class="line">  <span class="attr">js:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Remark42</span></span><br><span class="line"><span class="comment"># https://remark42.com/docs/configuration/frontend/</span></span><br><span class="line"><span class="attr">remark42:</span></span><br><span class="line">  <span class="attr">host:</span></span><br><span class="line">  <span class="attr">siteId:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Artalk</span></span><br><span class="line"><span class="comment"># https://artalk.js.org/guide/frontend/config.html</span></span><br><span class="line"><span class="attr">artalk:</span></span><br><span class="line">  <span class="attr">server:</span></span><br><span class="line">  <span class="attr">site:</span></span><br><span class="line">  <span class="comment"># Use Artalk visitor count as the page view count</span></span><br><span class="line">  <span class="attr">visitor:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Chat Services</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">chat:</span></span><br><span class="line">  <span class="comment"># Choose: chatra/tidio/crisp</span></span><br><span class="line">  <span class="comment"># Leave it empty if you don&#x27;t need chat</span></span><br><span class="line">  <span class="attr">use:</span></span><br><span class="line">  <span class="comment"># Chat Button [recommend]</span></span><br><span class="line">  <span class="comment"># It will create a button in the bottom right corner of website, and hide the origin button</span></span><br><span class="line">  <span class="attr">rightside_button:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># The origin chat button is displayed when scrolling up, and the button is hidden when scrolling down</span></span><br><span class="line">  <span class="attr">button_hide_show:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://chatra.io/</span></span><br><span class="line"><span class="attr">chatra:</span></span><br><span class="line">  <span class="attr">id:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://www.tidio.com/</span></span><br><span class="line"><span class="attr">tidio:</span></span><br><span class="line">  <span class="attr">public_key:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://crisp.chat/en/</span></span><br><span class="line"><span class="attr">crisp:</span></span><br><span class="line">  <span class="attr">website_id:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Analysis</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://tongji.baidu.com/web/welcome/login</span></span><br><span class="line"><span class="attr">baidu_analytics:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://analytics.google.com/analytics/web/</span></span><br><span class="line"><span class="attr">google_analytics:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://www.cloudflare.com/zh-tw/web-analytics/</span></span><br><span class="line"><span class="attr">cloudflare_analytics:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://clarity.microsoft.com/</span></span><br><span class="line"><span class="attr">microsoft_clarity:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://umami.is/</span></span><br><span class="line"><span class="attr">umami_analytics:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># For self-hosted setups, configure the hostname of the Umami instance</span></span><br><span class="line">  <span class="attr">serverURL:</span></span><br><span class="line">  <span class="attr">website_id:</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line">  <span class="attr">UV_PV:</span></span><br><span class="line">    <span class="attr">site_uv:</span> <span class="literal">false</span></span><br><span class="line">    <span class="attr">site_pv:</span> <span class="literal">false</span></span><br><span class="line">    <span class="attr">page_pv:</span> <span class="literal">false</span></span><br><span class="line">    <span class="comment"># Umami Cloud (API key) / self-hosted Umami (token)</span></span><br><span class="line">    <span class="attr">token:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://www.googletagmanager.com/</span></span><br><span class="line"><span class="attr">google_tag_manager:</span></span><br><span class="line">  <span class="attr">tag_id:</span></span><br><span class="line">  <span class="comment"># optional</span></span><br><span class="line">  <span class="attr">domain:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Advertisement</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Google Adsense</span></span><br><span class="line"><span class="attr">google_adsense:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">auto_ads:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">js:</span> <span class="string">https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js</span></span><br><span class="line">  <span class="attr">client:</span></span><br><span class="line">  <span class="attr">enable_page_level_ads:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Insert ads manually</span></span><br><span class="line"><span class="comment"># Leave it empty if you don&#x27;t need ads</span></span><br><span class="line"><span class="attr">ad:</span></span><br><span class="line">  <span class="comment"># Insert ads in the index (every three posts)</span></span><br><span class="line">  <span class="attr">index:</span></span><br><span class="line">  <span class="comment"># Insert ads in aside</span></span><br><span class="line">  <span class="attr">aside:</span></span><br><span class="line">  <span class="comment"># Insert ads in the post (before pagination)</span></span><br><span class="line">  <span class="attr">post:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Verification</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="attr">site_verification:</span></span><br><span class="line">  <span class="comment"># - name: google-site-verification</span></span><br><span class="line">  <span class="comment">#   content: xxxxxx</span></span><br><span class="line">  <span class="comment"># - name: baidu-site-verification</span></span><br><span class="line">  <span class="comment">#   content: xxxxxxx</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Beautify / Effect</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Theme color for customize</span></span><br><span class="line"><span class="comment"># Notice: color value must in double quotes like &quot;#000&quot; or may cause error!</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># theme_color:</span></span><br><span class="line"><span class="comment">#   enable: true</span></span><br><span class="line"><span class="comment">#   main: &quot;#49B1F5&quot;</span></span><br><span class="line"><span class="comment">#   paginator: &quot;#00c4b6&quot;</span></span><br><span class="line"><span class="comment">#   button_hover: &quot;#FF7242&quot;</span></span><br><span class="line"><span class="comment">#   text_selection: &quot;#00c4b6&quot;</span></span><br><span class="line"><span class="comment">#   link_color: &quot;#99a9bf&quot;</span></span><br><span class="line"><span class="comment">#   meta_color: &quot;#858585&quot;</span></span><br><span class="line"><span class="comment">#   hr_color: &quot;#A4D8FA&quot;</span></span><br><span class="line"><span class="comment">#   code_foreground: &quot;#F47466&quot;</span></span><br><span class="line"><span class="comment">#   code_background: &quot;rgba(27, 31, 35, .05)&quot;</span></span><br><span class="line"><span class="comment">#   toc_color: &quot;#00c4b6&quot;</span></span><br><span class="line"><span class="comment">#   blockquote_padding_color: &quot;#49b1f5&quot;</span></span><br><span class="line"><span class="comment">#   blockquote_background_color: &quot;#49b1f5&quot;</span></span><br><span class="line"><span class="comment">#   scrollbar_color: &quot;#49b1f5&quot;</span></span><br><span class="line"><span class="comment">#   meta_theme_color_light: &quot;ffffff&quot;</span></span><br><span class="line"><span class="comment">#   meta_theme_color_dark: &quot;#0d0d0d&quot;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The user interface setting of category and tag page</span></span><br><span class="line"><span class="comment"># Choose: index - same as Homepage UI / default - same as archives UI</span></span><br><span class="line"><span class="comment"># leave it empty or index</span></span><br><span class="line"><span class="attr">category_ui:</span></span><br><span class="line"><span class="attr">tag_ui:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Rounded corners for UI elements</span></span><br><span class="line"><span class="attr">rounded_corners_ui:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Stretches the lines so that each line has equal width</span></span><br><span class="line"><span class="attr">text_align_justify:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Add a mask to the header and footer</span></span><br><span class="line"><span class="attr">mask:</span></span><br><span class="line">  <span class="attr">header:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">footer:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Loading Animation ##预加载</span></span><br><span class="line"><span class="attr">preloader:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># source</span></span><br><span class="line">  <span class="comment"># 1. fullpage-loading</span></span><br><span class="line">  <span class="comment"># 2. pace (progress bar)</span></span><br><span class="line">  <span class="attr">source:</span> <span class="number">1</span></span><br><span class="line">  <span class="comment"># pace theme (see https://codebyzach.github.io/pace/)</span></span><br><span class="line">  <span class="attr">pace_css_url:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Page Transition</span></span><br><span class="line"><span class="attr">enter_transitions:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Default display mode - light (default) / dark</span></span><br><span class="line"><span class="attr">display_mode:</span> <span class="string">light</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Configuration for beautifying the content of the article</span></span><br><span class="line"><span class="attr">beautify:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Specify the field to beautify (site or post)</span></span><br><span class="line">  <span class="attr">field:</span> <span class="string">post</span></span><br><span class="line">  <span class="comment"># Specify the icon to be used as a prefix for the title, such as &#x27;\f0c1&#x27;</span></span><br><span class="line">  <span class="attr">title_prefix_icon:</span></span><br><span class="line">  <span class="comment"># Specify the color of the title prefix icon, such as &#x27;#F47466&#x27;</span></span><br><span class="line">  <span class="attr">title_prefix_icon_color:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Global font settings</span></span><br><span class="line"><span class="comment"># Don&#x27;t modify the following settings unless you know how they work</span></span><br><span class="line"><span class="attr">font:</span></span><br><span class="line">  <span class="attr">global-font-size:</span> <span class="string">&#x27;16px&#x27;</span> <span class="comment">#15px</span></span><br><span class="line">  <span class="attr">code-font-size:</span> <span class="string">&#x27;14px&#x27;</span></span><br><span class="line">  <span class="comment"># -apple-system, BlinkMacSystemFont, &quot;Segoe UI&quot; , &quot;Helvetica Neue&quot; , Lato, Roboto, &quot;PingFang SC&quot; , &quot;Microsoft JhengHei&quot; , &quot;Microsoft YaHei&quot; , sans-serif</span></span><br><span class="line">  <span class="comment"># Wenkai, consolas, -apple-system, &#x27;Quicksand&#x27;, &#x27;Nimbus Roman No9 L&#x27;, &#x27;PingFang SC&#x27;, &#x27;Hiragino Sans GB&#x27;, &#x27;Noto Serif SC&#x27;, &#x27;Microsoft Yahei&#x27;, &#x27;WenQuanYi Micro Hei&#x27;, &#x27;ST Heiti&#x27;, sans-serif;</span></span><br><span class="line">  <span class="attr">font-family:</span> <span class="string">-apple-system,</span> <span class="string">&#x27;Quicksand&#x27;</span><span class="string">,</span> <span class="string">&#x27;Nimbus Roman No9 L&#x27;</span><span class="string">,</span> <span class="string">&#x27;PingFang SC&#x27;</span><span class="string">,</span> <span class="string">&#x27;Hiragino Sans GB&#x27;</span><span class="string">,</span> <span class="string">&#x27;Noto Serif SC&#x27;</span><span class="string">,</span> <span class="string">&#x27;Microsoft Yahei&#x27;</span><span class="string">,</span> <span class="string">&#x27;WenQuanYi Micro Hei&#x27;</span><span class="string">,</span> <span class="string">&#x27;ST Heiti&#x27;</span><span class="string">,</span> <span class="string">sans-serif;</span></span><br><span class="line">  <span class="comment"># consolas, ZhuZiAWan_light, &quot;Microsoft YaHei&quot;, Menlo, &quot;PingFang SC&quot;, &quot;Microsoft JhengHei&quot;, sans-serif</span></span><br><span class="line">  <span class="comment"># Consolas_1, ZhuZiAWan_light, &quot;Microsoft YaHei&quot;, Menlo, &quot;PingFang SC&quot;, &quot;Microsoft JhengHei&quot;, sans-serif</span></span><br><span class="line">  <span class="attr">code-font-family:</span> <span class="string">Consolas,</span> <span class="string">&quot;Microsoft YaHei&quot;</span><span class="string">,</span> <span class="string">Menlo,</span> <span class="string">&quot;PingFang SC&quot;</span><span class="string">,</span> <span class="string">&quot;Microsoft JhengHei&quot;</span><span class="string">,</span> <span class="string">sans-serif</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Font settings for the site title and site subtitle</span></span><br><span class="line"><span class="attr">blog_title_font:</span></span><br><span class="line">  <span class="attr">font_link:</span> </span><br><span class="line">  <span class="attr">font-family:</span> <span class="string">-apple-system,</span> <span class="string">BlinkMacSystemFont,</span> <span class="string">&quot;Segoe UI&quot;</span> <span class="string">,</span> <span class="string">&quot;Helvetica Neue&quot;</span> <span class="string">,</span> <span class="string">Lato,</span> <span class="string">Roboto,</span> <span class="string">&quot;PingFang SC&quot;</span> <span class="string">,</span> <span class="string">&quot;Microsoft JhengHei&quot;</span> <span class="string">,</span> <span class="string">&quot;Microsoft YaHei&quot;</span> <span class="string">,</span> <span class="string">sans-serif</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># The setting of divider icon</span></span><br><span class="line"><span class="attr">hr_icon:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># The unicode value of Font Awesome icon, such as &#x27;\3423&#x27;</span></span><br><span class="line">  <span class="attr">icon:</span></span><br><span class="line">  <span class="attr">icon_top:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Typewriter Effect</span></span><br><span class="line"><span class="comment"># https://github.com/disjukr/activate-power-mode</span></span><br><span class="line"><span class="attr">activate_power_mode:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">colorful:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">shake:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Background effects</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># canvas_ribbon</span></span><br><span class="line"><span class="comment"># See: https://github.com/hustcc/ribbon.js</span></span><br><span class="line"><span class="attr">canvas_ribbon:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># The size of ribbon</span></span><br><span class="line">  <span class="attr">size:</span> <span class="number">150</span></span><br><span class="line">  <span class="comment"># The opacity of ribbon (0 ~ 1)</span></span><br><span class="line">  <span class="attr">alpha:</span> <span class="number">0.6</span></span><br><span class="line">  <span class="attr">zIndex:</span> <span class="number">-1</span></span><br><span class="line">  <span class="attr">click_to_change:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Fluttering Ribbon</span></span><br><span class="line"><span class="attr">canvas_fluttering_ribbon:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># canvas_nest</span></span><br><span class="line"><span class="comment"># https://github.com/hustcc/canvas-nest.js</span></span><br><span class="line"><span class="attr">canvas_nest:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Color of lines, default: &#x27;0,0,0&#x27;; RGB values: (R,G,B).(<span class="doctag">note:</span> use &#x27;,&#x27; to separate.)</span></span><br><span class="line">  <span class="attr">color:</span> <span class="string">&#x27;0,0,255&#x27;</span></span><br><span class="line">  <span class="comment"># The opacity of line (0~1)</span></span><br><span class="line">  <span class="attr">opacity:</span> <span class="number">0.7</span></span><br><span class="line">  <span class="comment"># The z-index property of the background</span></span><br><span class="line">  <span class="attr">zIndex:</span> <span class="number">-1</span></span><br><span class="line">  <span class="comment"># The number of lines</span></span><br><span class="line">  <span class="attr">count:</span> <span class="number">99</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Mouse click effects: fireworks ##点击特效</span></span><br><span class="line"><span class="attr">fireworks:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">zIndex:</span> <span class="number">9999</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Mouse click effects: Heart symbol</span></span><br><span class="line"><span class="attr">click_heart:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Mouse click effects: words</span></span><br><span class="line"><span class="attr">clickShowText:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">text:</span></span><br><span class="line">    <span class="comment"># - I</span></span><br><span class="line">    <span class="comment"># - LOVE</span></span><br><span class="line">    <span class="comment"># - YOU</span></span><br><span class="line">  <span class="attr">fontSize:</span> <span class="string">15px</span></span><br><span class="line">  <span class="attr">random:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">mobile:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Lightbox Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Choose: fancybox / medium_zoom</span></span><br><span class="line"><span class="comment"># https://github.com/francoischalifour/medium-zoom</span></span><br><span class="line"><span class="comment"># https://fancyapps.com/fancybox/</span></span><br><span class="line"><span class="comment"># Leave it empty if you don&#x27;t need lightbox</span></span><br><span class="line"><span class="attr">lightbox:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Tag Plugins settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Series</span></span><br><span class="line"><span class="attr">series:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Order by title or date</span></span><br><span class="line">  <span class="attr">orderBy:</span> <span class="string">&#x27;title&#x27;</span></span><br><span class="line">  <span class="comment"># Sort of order. 1, asc for ascending; -1, desc for descending</span></span><br><span class="line">  <span class="attr">order:</span> <span class="number">1</span></span><br><span class="line">  <span class="attr">number:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># ABCJS - The ABC Music Notation Plugin</span></span><br><span class="line"><span class="comment"># https://github.com/paulrosen/abcjs</span></span><br><span class="line"><span class="attr">abcjs:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">per_page:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Mermaid</span></span><br><span class="line"><span class="comment"># https://github.com/mermaid-js/mermaid</span></span><br><span class="line"><span class="attr">mermaid:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Write Mermaid diagrams using code blocks</span></span><br><span class="line">  <span class="attr">code_write:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># built-in themes: default / forest / dark / neutral</span></span><br><span class="line">  <span class="attr">theme:</span></span><br><span class="line">    <span class="attr">light:</span> <span class="string">default</span></span><br><span class="line">    <span class="attr">dark:</span> <span class="string">dark</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># chartjs</span></span><br><span class="line"><span class="comment"># see https://www.chartjs.org/docs/latest/</span></span><br><span class="line"><span class="attr">chartjs:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Do not modify unless you understand how they work.</span></span><br><span class="line">  <span class="comment"># The default settings are only used when the MD syntax is not specified.</span></span><br><span class="line">  <span class="comment"># General font color for the chart</span></span><br><span class="line">  <span class="attr">fontColor:</span></span><br><span class="line">    <span class="attr">light:</span> <span class="string">&#x27;rgba(0, 0, 0, 0.8)&#x27;</span></span><br><span class="line">    <span class="attr">dark:</span> <span class="string">&#x27;rgba(255, 255, 255, 0.8)&#x27;</span></span><br><span class="line">  <span class="comment"># General border color for the chart</span></span><br><span class="line">  <span class="attr">borderColor:</span></span><br><span class="line">    <span class="attr">light:</span> <span class="string">&#x27;rgba(0, 0, 0, 0.1)&#x27;</span></span><br><span class="line">    <span class="attr">dark:</span> <span class="string">&#x27;rgba(255, 255, 255, 0.2)&#x27;</span></span><br><span class="line">  <span class="comment"># Background color for scale labels on radar and polar area charts</span></span><br><span class="line">  <span class="attr">scale_ticks_backdropColor:</span></span><br><span class="line">    <span class="attr">light:</span> <span class="string">&#x27;transparent&#x27;</span></span><br><span class="line">    <span class="attr">dark:</span> <span class="string">&#x27;transparent&#x27;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Note - Bootstrap Callout</span></span><br><span class="line"><span class="attr">note:</span></span><br><span class="line">  <span class="comment"># Note tag style values:</span></span><br><span class="line">  <span class="comment">#  - simple    bs-callout old alert style. Default.</span></span><br><span class="line">  <span class="comment">#  - modern    bs-callout new (v2-v3) alert style.</span></span><br><span class="line">  <span class="comment">#  - flat      flat callout style with background, like on Mozilla or StackOverflow.</span></span><br><span class="line">  <span class="comment">#  - disabled  disable all CSS styles import of note tag.</span></span><br><span class="line">  <span class="attr">style:</span> <span class="string">flat</span></span><br><span class="line">  <span class="attr">icons:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">border_radius:</span> <span class="number">3</span></span><br><span class="line">  <span class="comment"># Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).</span></span><br><span class="line">  <span class="comment"># Offset also applied to label tag variables. This option can work with disabled note tag.</span></span><br><span class="line">  <span class="attr">light_bg_offset:</span> <span class="number">0</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"><span class="comment"># Other Settings</span></span><br><span class="line"><span class="comment"># --------------------------------------</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># https://github.com/MoOx/pjax</span></span><br><span class="line"><span class="attr">pjax:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Exclude the specified pages from pjax, such as &#x27;/music/&#x27;</span></span><br><span class="line">  <span class="attr">exclude:</span></span><br><span class="line">    <span class="comment"># - /xxxxxx/</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Inject the css and script (aplayer/meting)</span></span><br><span class="line"><span class="attr">aplayerInject:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">per_page:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Snackbar - Toast Notification</span></span><br><span class="line"><span class="comment"># https://github.com/polonel/SnackBar</span></span><br><span class="line"><span class="comment"># position: top-left / top-center / top-right / bottom-left / bottom-center / bottom-right</span></span><br><span class="line"><span class="attr">snackbar:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">position:</span> <span class="string">bottom-left</span></span><br><span class="line">  <span class="comment"># The background color of Toast Notification in light mode and dark mode</span></span><br><span class="line">  <span class="attr">bg_light:</span> <span class="string">&#x27;#49b1f5&#x27;</span></span><br><span class="line">  <span class="attr">bg_dark:</span> <span class="string">&#x27;#1f1f1f&#x27;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Instant.page</span></span><br><span class="line"><span class="comment"># https://instant.page/</span></span><br><span class="line"><span class="attr">instantpage:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Lazyload ##懒加载</span></span><br><span class="line"><span class="comment"># https://github.com/verlok/vanilla-lazyload</span></span><br><span class="line"><span class="attr">lazyload:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="comment"># Use browser&#x27;s native lazyload instead of vanilla-lazyload</span></span><br><span class="line">  <span class="attr">native:</span> <span class="literal">false</span></span><br><span class="line">  <span class="comment"># Specify the field to use lazyload (site or post)</span></span><br><span class="line">  <span class="attr">field:</span> <span class="string">site</span></span><br><span class="line">  <span class="attr">placeholder:</span></span><br><span class="line">  <span class="attr">blur:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># PWA</span></span><br><span class="line"><span class="comment"># See https://github.com/JLHwung/hexo-offline</span></span><br><span class="line"><span class="comment"># ---------------</span></span><br><span class="line"><span class="attr">pwa:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">false</span></span><br><span class="line">  <span class="attr">manifest:</span></span><br><span class="line">  <span class="attr">apple_touch_icon:</span></span><br><span class="line">  <span class="attr">favicon_32_32:</span></span><br><span class="line">  <span class="attr">favicon_16_16:</span></span><br><span class="line">  <span class="attr">mask_icon:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Open graph meta tags</span></span><br><span class="line"><span class="comment"># https://hexo.io/docs/helpers#open-graph</span></span><br><span class="line"><span class="attr">Open_Graph_meta:</span></span><br><span class="line">  <span class="attr">enable:</span> <span class="literal">true</span></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line">    <span class="comment"># twitter_card:</span></span><br><span class="line">    <span class="comment"># twitter_image:</span></span><br><span class="line">    <span class="comment"># twitter_id:</span></span><br><span class="line">    <span class="comment"># twitter_site:</span></span><br><span class="line">    <span class="comment"># google_plus:</span></span><br><span class="line">    <span class="comment"># fb_admins:</span></span><br><span class="line">    <span class="comment"># fb_app_id:</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Structured Data</span></span><br><span class="line"><span class="comment"># https://developers.google.com/search/docs/guides/intro-structured-data</span></span><br><span class="line"><span class="attr">structured_data:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Add the vendor prefixes to ensure compatibility</span></span><br><span class="line"><span class="attr">css_prefix:</span> <span class="literal">true</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Inject ##引入自定义文件</span></span><br><span class="line"><span class="comment"># Insert the code to head (before &#x27;&lt;/head&gt;&#x27; tag) and the bottom (before &#x27;&lt;/body&gt;&#x27; tag)</span></span><br><span class="line"><span class="attr">inject:</span></span><br><span class="line">  <span class="attr">head:</span></span><br><span class="line">    <span class="comment"># - &lt;link rel=&quot;stylesheet&quot; href=&quot;/xxx.css&quot;&gt;</span></span><br><span class="line">  <span class="attr">bottom:</span></span><br><span class="line">    <span class="comment"># - &lt;script src=&quot;xxxx&quot;&gt;&lt;/script&gt;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># CDN Settings</span></span><br><span class="line"><span class="comment"># Don&#x27;t modify the following settings unless you know how they work</span></span><br><span class="line"><span class="attr">CDN:</span></span><br><span class="line">  <span class="comment"># The CDN provider for internal and third-party scripts</span></span><br><span class="line">  <span class="comment"># Options for both: local/jsdelivr/unpkg/cdnjs/custom</span></span><br><span class="line">  <span class="comment"># <span class="doctag">Note:</span> Dev version can only use &#x27;local&#x27; for internal scripts</span></span><br><span class="line">  <span class="comment"># <span class="doctag">Note:</span> When setting third-party scripts to &#x27;local&#x27;, you need to install hexo-butterfly-extjs</span></span><br><span class="line">  <span class="attr">internal_provider:</span> <span class="string">local</span></span><br><span class="line">  <span class="attr">third_party_provider:</span> <span class="string">jsdelivr</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># Add version number to url, true or false</span></span><br><span class="line">  <span class="attr">version:</span> <span class="literal">false</span></span><br><span class="line"></span><br><span class="line">  <span class="comment"># Custom format</span></span><br><span class="line">  <span class="comment"># For example: https://cdn.staticfile.org/$&#123;cdnjs_name&#125;/$&#123;version&#125;/$&#123;min_cdnjs_file&#125;</span></span><br><span class="line">  <span class="attr">custom_format:</span></span><br><span class="line"></span><br><span class="line">  <span class="attr">option:</span></span><br><span class="line">    <span class="comment"># abcjs_basic_js:</span></span><br><span class="line">    <span class="comment"># activate_power_mode:</span></span><br><span class="line">    <span class="comment"># algolia_js:</span></span><br><span class="line">    <span class="comment"># algolia_search:</span></span><br><span class="line">    <span class="comment"># aplayer_css:</span></span><br><span class="line">    <span class="comment"># aplayer_js:</span></span><br><span class="line">    <span class="comment"># artalk_css:</span></span><br><span class="line">    <span class="comment"># artalk_js:</span></span><br><span class="line">    <span class="comment"># blueimp_md5:</span></span><br><span class="line">    <span class="comment"># busuanzi:</span></span><br><span class="line">    <span class="comment"># canvas_fluttering_ribbon:</span></span><br><span class="line">    <span class="comment"># canvas_nest:</span></span><br><span class="line">    <span class="comment"># canvas_ribbon:</span></span><br><span class="line">    <span class="comment"># chartjs:</span></span><br><span class="line">    <span class="comment"># click_heart:</span></span><br><span class="line">    <span class="comment"># clickShowText:</span></span><br><span class="line">    <span class="comment"># disqusjs:</span></span><br><span class="line">    <span class="comment"># disqusjs_css:</span></span><br><span class="line">    <span class="comment"># docsearch_css:</span></span><br><span class="line">    <span class="comment"># docsearch_js:</span></span><br><span class="line">    <span class="comment"># egjs_infinitegrid:</span></span><br><span class="line">    <span class="comment"># fancybox:</span></span><br><span class="line">    <span class="comment"># fancybox_css:</span></span><br><span class="line">    <span class="comment"># fireworks:</span></span><br><span class="line">    <span class="comment"># fontawesome:</span></span><br><span class="line">    <span class="comment"># gitalk:</span></span><br><span class="line">    <span class="comment"># gitalk_css:</span></span><br><span class="line">    <span class="comment"># giscus:</span></span><br><span class="line">    <span class="comment"># instantpage:</span></span><br><span class="line">    <span class="comment"># instantsearch:</span></span><br><span class="line">    <span class="comment"># katex:</span></span><br><span class="line">    <span class="comment"># katex_copytex:</span></span><br><span class="line">    <span class="comment"># lazyload:</span></span><br><span class="line">    <span class="comment"># local_search:</span></span><br><span class="line">    <span class="comment"># main:</span></span><br><span class="line">    <span class="comment"># main_css:</span></span><br><span class="line">    <span class="comment"># mathjax:</span></span><br><span class="line">    <span class="comment"># medium_zoom:</span></span><br><span class="line">    <span class="comment"># mermaid:</span></span><br><span class="line">    <span class="comment"># meting_js:</span></span><br><span class="line">    <span class="comment"># prismjs_autoloader:</span></span><br><span class="line">    <span class="comment"># prismjs_js:</span></span><br><span class="line">    <span class="comment"># prismjs_lineNumber_js:</span></span><br><span class="line">    <span class="comment"># pjax:</span></span><br><span class="line">    <span class="comment"># sharejs:</span></span><br><span class="line">    <span class="comment"># sharejs_css:</span></span><br><span class="line">    <span class="comment"># snackbar:</span></span><br><span class="line">    <span class="comment"># snackbar_css:</span></span><br><span class="line">    <span class="comment"># translate:</span></span><br><span class="line">    <span class="comment"># twikoo:</span></span><br><span class="line">    <span class="comment"># typed:</span></span><br><span class="line">    <span class="comment"># utils:</span></span><br><span class="line">    <span class="comment"># valine:</span></span><br><span class="line">    <span class="comment"># waline_css:</span></span><br><span class="line">    <span class="comment"># waline_js:</span></span><br><span class="line"></span><br></pre></td></tr></table></figure><ul><li>post草稿（新建文章时自动套用的 front matter 模板）</li></ul><p><strong>文件</strong>：<code>[Blogroot]/scaffolds/post.md</code> ｜ <strong>改法</strong>：替换文件内容，首尾要补上 <code>---</code> 分隔线；以后 <code>hexo new &quot;文章标题&quot;</code> 生成的新文章就是这套字段。</p><figure class="highlight yml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment"># 标题</span></span><br><span class="line"><span class="attr">title:</span> &#123;&#123; <span class="string">title</span> &#125;&#125;</span><br><span class="line"><span class="attr">date:</span> &#123;&#123; <span class="string">date</span> &#125;&#125;</span><br><span class="line"><span class="attr">author:</span>  <span class="comment">#作者</span></span><br><span class="line"><span class="comment"># 简述</span></span><br><span class="line"><span class="attr">description:</span></span><br><span class="line"><span class="comment"># 标签</span></span><br><span class="line"><span class="attr">tags:</span></span><br><span class="line"><span class="comment"># 分类</span></span><br><span class="line"><span class="attr">categories:</span></span><br><span class="line"><span class="comment"># 使用自定义封面 </span></span><br><span class="line"><span class="comment"># img: </span></span><br><span class="line"><span class="comment"># 是否置顶true，或者去掉</span></span><br><span class="line"><span class="attr">top:</span> </span><br><span class="line"><span class="comment"># 轮播</span></span><br><span class="line"><span class="attr">cover:</span></span><br></pre></td></tr></table></figure><h1 id="改完怎么验证与部署"><a href="#改完怎么验证与部署" class="headerlink" title="改完怎么验证与部署"></a>改完怎么验证与部署</h1><p>安装、换主题、改配置这几步做完，先在本地走一遍再上传。下面命令都在博客根目录（<code>[Blogroot]</code>）执行。</p><ol><li><strong>生成</strong>：<code>hexo generate</code>（简写 <code>hexo g</code>）。看输出最后是不是 <code>Generated</code>，出现报错先解决再往下走；动过 <code>_config.yml</code> 或主题后重新生成一次。</li><li><strong>本地预览</strong>：<code>hexo server</code>（简写 <code>hexo s</code>），浏览器打开 <code>http://localhost:4000</code>。首页、任意一篇文章、分类页各点一遍，确认主题样式、文章列表和侧栏都正常。</li><li><strong>清缓存 / 强制刷新</strong>：改过 <code>source/</code> 下的 CSS、JS 或 <code>_config.butterfly.yml</code> 之后按 <code>Ctrl + F5</code> 硬刷新；如果浏览器还是老的，重启 <code>hexo server</code> 再刷新。</li><li><strong>F12 查 404</strong>：打开开发者工具，Console 看有没有红色报错，Network 里按状态码筛 <code>404</code>。常见原因是静态资源路径写错（<code>/css/</code>、<code>/js/</code> 开头有没有漏）、<code>inject</code> 里引用的文件没放进 <code>source/</code>、主题的 <code>_config.yml</code> 没改名成 <code>_config.butterfly.yml</code>。</li><li><strong>部署</strong>：按你原来的托管方式把生成的 <code>public/</code> 传上去——Nginx / 云服务器直接把 <code>public/</code> 内容覆盖到站点根目录；GitHub Pages 用 <code>hexo deploy</code>（先按第 8 节配好 <code>deploy</code> 再执行 <code>hexo deploy</code>）；Vercel 等平台连仓库，构建命令填 <code>hexo generate</code>、输出目录填 <code>public</code>。上传后关掉浏览器缓存再访问一次，确认线上和本地一致。</li></ol><p>上线前再确认三件事：<code>_config.yml</code> 和 <code>_config.butterfly.yml</code> 的缩进没被编辑器改成 Tab（YAML 只认空格）；新增的 <code>scripts/*.js</code> 放在博客根目录的 <code>scripts</code> 里而不是主题目录里；<code>deploy</code> 里的仓库地址和分支跟你的托管方式对得上。</p>]]>
    </content>
    <id>https://cookiesky.cn/2024/11/11/hexo-install/</id>
    <link href="https://cookiesky.cn/2024/11/11/hexo-install/"/>
    <published>2024-11-11T11:45:27.000Z</published>
    <summary>hexo基础教程（一）</summary>
    <title>hexo基础教程（一）</title>
    <updated>2026-11-22T17:12:15.674Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="GXNU" scheme="https://cookiesky.cn/categories/GXNU/"/>
    <category term="AI" scheme="https://cookiesky.cn/categories/AI/"/>
    <category term="Python" scheme="https://cookiesky.cn/tags/Python/"/>
    <category term="AI" scheme="https://cookiesky.cn/tags/AI/"/>
    <category term="大数据" scheme="https://cookiesky.cn/tags/%E5%A4%A7%E6%95%B0%E6%8D%AE/"/>
    <content>
      <![CDATA[<p>之前自己从<a href="https://github.com/cqu-isse/SemEnr">SemEnr</a>下载下来用，安装了readme文件中提到的依赖库，结果到处报错。于是还是好朋友<a href="https://licyk.netlify.app/2024/11/10/deploy-semenr/">licyk</a>给了我一个优秀的解决方案。感谢他！<br>接下来我也对其进行一定的使用及修改，这是我的项目仓库：<a href="https://github.com/HG-dev17/SemEnr">https://github.com/HG-dev17/SemEnr</a></p><h1 id="一、anaconda和Visual-Studio安装"><a href="#一、anaconda和Visual-Studio安装" class="headerlink" title="一、anaconda和Visual Studio安装"></a>一、anaconda和Visual Studio安装</h1><h2 id="1-1-下载"><a href="#1-1-下载" class="headerlink" title="1.1 下载"></a>1.1 下载</h2><p><a href="https://www.anaconda.com/products/distribution">下载链接：https://www.anaconda.com/products/distribution</a></p><h2 id="1-2-安装"><a href="#1-2-安装" class="headerlink" title="1.2 安装"></a>1.2 安装</h2><p>双击运行，一直下一步即可。（如不想安装在C盘，自行选择目录即可）<br><code>注意一定要选择添加进PATH，不然终端无法运行</code></p><h2 id="1-3-Visual-Studio安装"><a href="#1-3-Visual-Studio安装" class="headerlink" title="1.3 Visual Studio安装"></a>1.3 Visual Studio安装</h2><p><a href="https://visualstudio.microsoft.com/zh-hans/">下载链接：https://visualstudio.microsoft.com/zh-hans/</a></p><h1 id="二、安装项目"><a href="#二、安装项目" class="headerlink" title="二、安装项目"></a>二、安装项目</h1><details class="folding-tag" green><summary> 安装项目 </summary>              <div class='content'>              <p>由于有一些问题过期了，所以此方法可能存在一定的问题。请自行根据报错进行修改即可</p><p>下面的操作将在 <code>PowerShell</code> 中进行，右键桌面空白处点在终端中打开就能进入 <code>PowerShell</code> 终端。</p><ol><li>现在将 MicroMamba 安装在 D 盘，为 MicroMamba 创建安装目录。<figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="built_in">New-Item</span> <span class="literal">-ItemType</span> Directory <span class="literal">-Path</span> <span class="string">&quot;D:/micromamba&quot;</span></span><br></pre></td></tr></table></figure></li><li>下载 MicroMamba。<figure class="highlight awk"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">Invoke-WebRequest -Uri https:<span class="regexp">//gi</span>tee.com<span class="regexp">/licyk/</span>README-collection<span class="regexp">/releases/</span>download<span class="regexp">/archive/mi</span>cromamba.exe -OutFile <span class="string">&quot;D:/micromamba/micromamba.exe&quot;</span></span><br></pre></td></tr></table></figure>我也fork了一份<figure class="highlight awk"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">Invoke-WebRequest -Uri https:<span class="regexp">//gi</span>tee.com<span class="regexp">/HG-dev17/</span>download<span class="regexp">/releases/</span>download<span class="regexp">/archive/mi</span>cromamba.exe -OutFile <span class="string">&quot;D:/micromamba/micromamba.exe&quot;</span></span><br></pre></td></tr></table></figure></li><li>初始化 MicroMamba 的配置。<figure class="highlight mathematica"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="operator">&amp;</span> <span class="string">&quot;D:/micromamba/micromamba.exe&quot;</span> <span class="variable">shell</span> <span class="variable">hook</span> <span class="operator">-</span><span class="variable">s</span> <span class="variable">powershell</span> <span class="operator">|</span> <span class="built_in">Out</span><span class="operator">-</span><span class="built_in">String</span> <span class="operator">|</span> <span class="variable">Invoke</span><span class="operator">-</span><span class="built_in">Expression</span></span><br><span class="line"><span class="operator">&amp;</span> <span class="string">&quot;D:/micromamba/micromamba.exe&quot;</span> <span class="variable">shell</span> <span class="variable">init</span> <span class="operator">-</span><span class="variable">s</span> <span class="variable">powershell</span> <span class="operator">-</span><span class="variable">r</span> <span class="string">&quot;D:/micromamba&quot;</span></span><br><span class="line"><span class="operator">.</span> <span class="string">&quot;$Env:USERPROFILE/Documents/WindowsPowerShell/profile.ps1&quot;</span></span><br></pre></td></tr></table></figure>注意，如果遇到以下问题：<figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">. : 无法加载文件 C:\Users\用户名\Documents\WindowsPowerShell\profile.ps1</span><br><span class="line">因为在此系统上禁止运行脚本。有关详细信息，请参阅</span><br></pre></td></tr></table></figure>解决办法是输入命令允许启动所有脚本<figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="built_in">Set-ExecutionPolicy</span> RemoteSigned <span class="literal">-Scope</span> CurrentUser</span><br></pre></td></tr></table></figure></li><li>为 MicroMamba 下载 Conda 配置文件。<figure class="highlight awk"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">Invoke-WebRequest -Uri https:<span class="regexp">//gi</span>tee.com<span class="regexp">/licyk/</span>README-collection<span class="regexp">/releases/</span>download<span class="regexp">/archive/</span>conda_config.yaml -OutFile <span class="string">&quot;$Env:USERPROFILE/.condarc&quot;</span></span><br></pre></td></tr></table></figure>我fork了一份<figure class="highlight awk"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">Invoke-WebRequest -Uri https:<span class="regexp">//gi</span>tee.com<span class="regexp">/HG-dev17/</span>download<span class="regexp">/releases/</span>download<span class="regexp">/archive/</span>conda_config.yaml -OutFile <span class="string">&quot;$Env:USERPROFILE/.condarc&quot;</span></span><br></pre></td></tr></table></figure></li><li>为 SemEnr 创建 Conda 环境。<figure class="highlight livecodeserver"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">micromamba <span class="built_in">create</span> <span class="comment">--name semenr git -y</span></span><br></pre></td></tr></table></figure></li><li>激活 SemEnr 的 Conda 环境。<figure class="highlight applescript"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">micromamba <span class="built_in">activate</span> semenr</span><br></pre></td></tr></table></figure></li><li>待会在 D 盘下载 SemEnr 这个项目，所以切换到 D 盘目录里。<figure class="highlight crmsh"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">Set-<span class="keyword">Location</span> <span class="title">D</span>:</span><br></pre></td></tr></table></figure></li><li>这个 GitHub 地址在国内网络环境下直连可能较慢或失败，所以改用 GitHub 镜像源下载 SemEnr 项目。<figure class="highlight ruby"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">git clone <span class="symbol">https:</span>/<span class="regexp">/ghproxy.net/https</span><span class="symbol">://github</span>.com/licyk/<span class="title class_">SemEnr</span></span><br></pre></td></tr></table></figure>我也fork了一份，地址是 <a href="https://github.com/HG-dev17/SemEnr">https://github.com/HG-dev17/SemEnr</a> ，所以你也可以直接用这个地址下载。<figure class="highlight ruby"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">git clone <span class="symbol">https:</span>/<span class="regexp">/github.com/</span><span class="variable constant_">HG</span>-dev17/<span class="title class_">SemEnr</span></span><br></pre></td></tr></table></figure></li><li>进入 SemEnr 项目文件夹。<figure class="highlight crmsh"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">Set-<span class="keyword">Location</span> <span class="title">SemEnr</span></span><br></pre></td></tr></table></figure></li><li>使用 MicroMamba 安装 SemEnr 的依赖。<figure class="highlight cmake"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">micromamba <span class="keyword">install</span> -f environment.yml -y</span><br></pre></td></tr></table></figure></li><li>待会使用 Pip 安装剩余的项目依赖，为了保证下载速度，设置一下 Pip 镜像源。<figure class="highlight pgsql"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">pip config <span class="keyword">set</span> <span class="keyword">global</span>.<span class="keyword">index</span>-url &quot;https://mirrors.cloud.tencent.com/pypi/simple&quot;</span><br></pre></td></tr></table></figure></li><li>使用 Pip 安装剩余的依赖。<figure class="highlight cmake"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">pip <span class="keyword">install</span> -r requirements.txt</span><br></pre></td></tr></table></figure>现在 SemEnr 项目的运行环境就配置好了，下次要进入 SemEnr 项目的运行环境就使用下面的命令。<figure class="highlight applescript"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">micromamba <span class="built_in">activate</span> semenr</span><br></pre></td></tr></table></figure></li><li>放置数据集到指定目录<br><code>/data/github</code></li></ol><ul><li>最后cd到运行目录，即可使用<code>python .\main.py</code>运行程序了</li></ul>              </div>            </details><h1 id="三、使用项目"><a href="#三、使用项目" class="headerlink" title="三、使用项目"></a>三、使用项目</h1><p>项目使用过程中，我们发现loss值并没有记录在结果文件<code>results/training_results.txt</code>中，所以我们需要修改一下main.py文件，将loss值记录到结果文件中。<br><code>记得去掉加号，保持缩进</code><br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">            <span class="keyword">if</span> hist.history[<span class="string">&#x27;val_loss&#x27;</span>][<span class="number">0</span>] &lt; val_loss[<span class="string">&#x27;loss&#x27;</span>]:</span><br><span class="line">                val_loss = &#123;<span class="string">&#x27;loss&#x27;</span>: hist.history[<span class="string">&#x27;val_loss&#x27;</span>][<span class="number">0</span>], <span class="string">&#x27;epoch&#x27;</span>: i&#125;</span><br><span class="line">+                <span class="comment"># 将 val_loss 写入文件</span></span><br><span class="line">+                f1.write(<span class="string">&#x27;Best Validation Loss: Epoch=&#123;&#125;, Loss=&#123;&#125;\n&#x27;</span>.<span class="built_in">format</span>(val_loss[<span class="string">&#x27;epoch&#x27;</span>], val_loss[<span class="string">&#x27;loss&#x27;</span>]))</span><br><span class="line">+                f1.flush()</span><br><span class="line">            <span class="built_in">print</span>(<span class="string">&#x27;Best: Loss = &#123;&#125;, Epoch = &#123;&#125;&#x27;</span>.<span class="built_in">format</span>(val_loss[<span class="string">&#x27;loss&#x27;</span>], val_loss[<span class="string">&#x27;epoch&#x27;</span>]))</span><br></pre></td></tr></table></figure></p><h2 id="3-1分析项目"><a href="#3-1分析项目" class="headerlink" title="3.1分析项目"></a>3.1分析项目</h2><details class="folding-tag" green><summary> 数据预处理 </summary>              <div class='content'>              <p>首先是数据预处理先看CreateCorpus.py文件<br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">if</span> __name__ == <span class="string">&#x27;__main__&#x27;</span>:</span><br><span class="line">    sourceFile = <span class="built_in">open</span>(<span class="string">&quot;DeepCom_JAVA/train_tokens.txt&quot;</span>, <span class="string">&quot;r&quot;</span>, encoding=<span class="string">&quot;utf-8&quot;</span>)</span><br><span class="line">    corpusFile = <span class="built_in">open</span>(<span class="string">&quot;DeepCom_JAVA/corpus_tokens.txt&quot;</span>, <span class="string">&quot;w&quot;</span>, encoding=<span class="string">&quot;utf-8&quot;</span>)</span><br><span class="line">    <span class="keyword">for</span> num, line <span class="keyword">in</span> <span class="built_in">enumerate</span>(sourceFile):</span><br><span class="line">        <span class="built_in">print</span>(num)</span><br><span class="line">        words = line.split()</span><br><span class="line">        <span class="keyword">for</span> word <span class="keyword">in</span> words:</span><br><span class="line">            corpusFile.write(word + <span class="string">&#x27;\n&#x27;</span>)</span><br><span class="line">    sourceFile.close()</span><br><span class="line">    corpusFile.close()</span><br></pre></td></tr></table></figure><br>这个文件的作用是将DeepCom_JAVA/train_tokens.txt文件中的每一行按空格分割，然后将分割后的每个单词写入DeepCom_JAVA/corpus_tokens.txt文件中，每行一个单词。<br>接着是CreateVocab.py文件<br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">from</span> collections <span class="keyword">import</span> Counter</span><br><span class="line"></span><br><span class="line">vocabWord = <span class="built_in">open</span>(<span class="string">&quot;DeepCom_JAVA/corpus_tokens.txt&quot;</span>, <span class="string">&quot;r&quot;</span>, encoding=<span class="string">&quot;utf-8&quot;</span>)</span><br><span class="line">processStaFile = <span class="built_in">open</span>(<span class="string">&quot;DeepCom_JAVA/vocab.tokens.txt&quot;</span>, <span class="string">&quot;w&quot;</span>, encoding=<span class="string">&quot;utf-8&quot;</span>)</span><br><span class="line">staTreeList = []</span><br><span class="line"><span class="keyword">while</span> <span class="number">1</span>:</span><br><span class="line">    word = vocabWord.readline().splitlines()</span><br><span class="line">    <span class="keyword">if</span> <span class="keyword">not</span> word:</span><br><span class="line">        <span class="keyword">break</span></span><br><span class="line">    staTreeList.append(word[<span class="number">0</span>])</span><br><span class="line"></span><br><span class="line">staTreeDic = Counter(staTreeList)</span><br><span class="line"></span><br><span class="line"><span class="keyword">for</span> k, v <span class="keyword">in</span> staTreeDic.items():</span><br><span class="line">    <span class="keyword">if</span> v &gt;= <span class="number">11</span>:</span><br><span class="line">        processStaFile.write(k + <span class="string">&#x27;\n&#x27;</span>)</span><br></pre></td></tr></table></figure><br>这个文件的作用是统计DeepCom_JAVA/corpus_tokens.txt文件中每个单词出现的次数，然后将出现次数大于等于11的单词写入DeepCom_JAVA/vocab.tokens.txt文件中，每行一个单词。<br>接着是Vocab2pkl.py文件<br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> codecs</span><br><span class="line"><span class="keyword">import</span> pickle</span><br><span class="line"></span><br><span class="line">sbt_list = []</span><br><span class="line">f = codecs.<span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/vocab.tokens.txt&#x27;</span>, encoding=<span class="string">&#x27;utf8&#x27;</span>, errors=<span class="string">&#x27;replace&#x27;</span>).readlines()</span><br><span class="line"></span><br><span class="line"><span class="keyword">for</span> line <span class="keyword">in</span> f:</span><br><span class="line">    line = line.strip()</span><br><span class="line">    sbt_list.append(line)</span><br><span class="line">    <span class="built_in">print</span>(line)</span><br><span class="line">sbt_dictionary = &#123;value: index + <span class="number">1</span> <span class="keyword">for</span> index, value <span class="keyword">in</span> <span class="built_in">enumerate</span>(sbt_list)&#125;</span><br><span class="line">pickle.dump(sbt_dictionary,<span class="built_in">open</span>(<span class="string">&quot;DeepCom_JAVA/vocab.tokens.pkl&quot;</span>, <span class="string">&#x27;wb&#x27;</span>))</span><br></pre></td></tr></table></figure><br>这个文件的作用是将DeepCom_JAVA/vocab.tokens.txt文件中的单词转换为字典，并将字典保存为DeepCom_JAVA/vocab.tokens.pkl文件。<br>最后是txt2pkl.py文件<br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> pickle</span><br><span class="line"><span class="keyword">import</span> codecs</span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">desc2index</span>(<span class="params">desc_dict</span>):</span><br><span class="line">    desc = []</span><br><span class="line">    desc_index = []</span><br><span class="line"></span><br><span class="line">    fileDesc = codecs.<span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/test_desc.txt&#x27;</span>, encoding=<span class="string">&#x27;utf8&#x27;</span>,</span><br><span class="line">                           errors=<span class="string">&#x27;replace&#x27;</span>).readlines()</span><br><span class="line">    <span class="keyword">for</span> line <span class="keyword">in</span> fileDesc:</span><br><span class="line">        line = line.split()</span><br><span class="line">        desc.append(line)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> item <span class="keyword">in</span> desc:</span><br><span class="line">        new_item = []</span><br><span class="line">        <span class="keyword">for</span> word <span class="keyword">in</span> item:</span><br><span class="line">            <span class="keyword">try</span>:</span><br><span class="line">                new_item.append(desc_dict[word])</span><br><span class="line">            <span class="keyword">except</span>:</span><br><span class="line">                new_item.append(<span class="number">3</span>)</span><br><span class="line">        desc_index.append(new_item)</span><br><span class="line">    <span class="keyword">return</span> desc_index</span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">tokens2index</span>(<span class="params">tokens_dict</span>):</span><br><span class="line">    tokens = []</span><br><span class="line">    tokens_index = []</span><br><span class="line"></span><br><span class="line">    fileTokens = codecs.<span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/test_tokens.txt&#x27;</span>, encoding=<span class="string">&#x27;utf8&#x27;</span>,</span><br><span class="line">                             errors=<span class="string">&#x27;replace&#x27;</span>).readlines()</span><br><span class="line">    <span class="keyword">for</span> line <span class="keyword">in</span> fileTokens:</span><br><span class="line">        line = line.split()</span><br><span class="line">        tokens.append(line)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> item <span class="keyword">in</span> tokens:</span><br><span class="line">        new_item = []</span><br><span class="line">        <span class="keyword">for</span> word <span class="keyword">in</span> item:</span><br><span class="line">            <span class="keyword">try</span>:</span><br><span class="line">                new_item.append(tokens_dict[word])</span><br><span class="line">            <span class="keyword">except</span>:</span><br><span class="line">                new_item.append(<span class="number">3</span>)</span><br><span class="line">        tokens_index.append(new_item)</span><br><span class="line">    <span class="keyword">return</span> tokens_index</span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">simWords2index</span>(<span class="params">desc_dict</span>):</span><br><span class="line">    tokens = []</span><br><span class="line">    tokens_index = []</span><br><span class="line">    fileTokens = codecs.<span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/test_IR_code_desc_sw.txt&#x27;</span>, encoding=<span class="string">&#x27;utf8&#x27;</span>,</span><br><span class="line">                             errors=<span class="string">&#x27;replace&#x27;</span>).readlines()</span><br><span class="line">    <span class="keyword">for</span> line <span class="keyword">in</span> fileTokens:</span><br><span class="line">        line = line.split()</span><br><span class="line">        tokens.append(line)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> item <span class="keyword">in</span> tokens:</span><br><span class="line">        new_item = []</span><br><span class="line">        <span class="keyword">for</span> word <span class="keyword">in</span> item:</span><br><span class="line">            <span class="keyword">try</span>:</span><br><span class="line">                new_item.append(desc_dict[word])</span><br><span class="line">            <span class="keyword">except</span>:</span><br><span class="line">                new_item.append(<span class="number">3</span>)</span><br><span class="line">        tokens_index.append(new_item)</span><br><span class="line"></span><br><span class="line">        </span><br><span class="line">    <span class="keyword">return</span> tokens_index</span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> __name__ == <span class="string">&#x27;__main__&#x27;</span>:</span><br><span class="line"></span><br><span class="line">    desc_dict = pickle.load(<span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/vocab.desc.pkl&#x27;</span>, <span class="string">&#x27;rb&#x27;</span>)) <span class="comment">##描述</span></span><br><span class="line">    tokens_dict = pickle.load(<span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/vocab.tokens.pkl&#x27;</span>, <span class="string">&#x27;rb&#x27;</span>)) <span class="comment">##代码</span></span><br><span class="line">    desc = desc2index(desc_dict) <span class="comment">##描述</span></span><br><span class="line">    tokens = tokens2index(tokens_dict) <span class="comment">##代码</span></span><br><span class="line">    sim_desc=simWords2index(desc_dict) <span class="comment">##相似代码描述</span></span><br><span class="line"></span><br><span class="line">    pickle.dump(desc, <span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/test.desc.pkl&#x27;</span>, <span class="string">&#x27;wb&#x27;</span>)) <span class="comment">##描述</span></span><br><span class="line">    pickle.dump(tokens, <span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/test.tokens.pkl&#x27;</span>, <span class="string">&#x27;wb&#x27;</span>)) <span class="comment">##代码</span></span><br><span class="line">    pickle.dump(sim_desc, <span class="built_in">open</span>(<span class="string">&#x27;DeepCom_JAVA/test_IR_code_desc.pkl&#x27;</span>, <span class="string">&#x27;wb&#x27;</span>)) <span class="comment">##相似代码描述</span></span><br><span class="line"></span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&#x27;finish transfering data to index...&#x27;</span>)</span><br></pre></td></tr></table></figure><br>这个文件的作用是将文本文件中的描述、代码片段和相似代码片段转换为索引，并将这些索引保存到pickle文件中。<br>至此，数据预处理部分已经完成。</p>              </div>            </details><h1 id="四、优化项目"><a href="#四、优化项目" class="headerlink" title="四、优化项目"></a>四、优化项目</h1><p>我们的研究希望能够优化代码搜索。根据<a href="https://webofscience.clarivate.cn/wos/alldb/full-record/WOS:001098366600001">原论文文档</a>，我们尝试通过用大模型处理<code>train_desc.txt</code>来生成新的相似描述<code>sim_desc.txt</code>，然后通过<code>train_tokens.txt</code>和<code>sim_desc.txt</code>制作出模型能够识别的<code>pkl</code>文件来训练模型，而不是仅仅依靠字词的<code>token</code>去制作<code>sim_desc</code>文本从而优化代码搜索。<br>因此，我们利用<code>ollama api</code>实现每一行的描述的相似描述生成，并保存到相似描述文本中。</p><ul><li>大模型的使用可以参考我的这篇文章：<a href="/2024/12/02/ollama-install/">ollama api的使用</a>，完成上述步骤后再进行以下步骤。<br><code>注意，运行以下代码时必须启动open-webui服务</code></li><li><p>建议使用如下代码前安装以下环境:(复制内容到<code>requirements.txt</code>文件中，然后使用<code>pip install -r requirements.txt</code>安装)</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">requests==2.28.1</span><br><span class="line">tqdm==4.64.0</span><br><span class="line">concurrent.futures==3.9.2</span><br><span class="line">logging==0.5.1.2</span><br><span class="line">os==0.1.0</span><br><span class="line">signal==0.2.0</span><br></pre></td></tr></table></figure><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">2024/12/2</button><button type="button" class="tab">2024/12/3</button></div><div class="tab-contents"><div class="tab-item-content active"><p><strong>这是实现基本功能的代码</strong><br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> requests</span><br><span class="line"><span class="keyword">import</span> json</span><br><span class="line"><span class="keyword">from</span> tqdm <span class="keyword">import</span> tqdm</span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">askLocalQwen2Model</span>(<span class="params">prompt</span>):</span><br><span class="line">    url = <span class="string">&quot;http://localhost:11434/api/generate&quot;</span></span><br><span class="line">    </span><br><span class="line">    <span class="comment"># 创建要发送的JSON对象</span></span><br><span class="line">    json_input = &#123;</span><br><span class="line">        <span class="string">&quot;model&quot;</span>: <span class="string">&quot;qwen2.5-coder:latest&quot;</span>,</span><br><span class="line">        <span class="string">&quot;prompt&quot;</span>: prompt,</span><br><span class="line">        <span class="string">&quot;stream&quot;</span>: <span class="literal">False</span></span><br><span class="line">    &#125;</span><br><span class="line">    </span><br><span class="line">    <span class="keyword">try</span>:</span><br><span class="line">        <span class="comment"># 发送POST请求</span></span><br><span class="line">        response = requests.post(url, headers=&#123;<span class="string">&quot;Content-Type&quot;</span>: <span class="string">&quot;application/json&quot;</span>&#125;, data=json.dumps(json_input))</span><br><span class="line">        </span><br><span class="line">        <span class="comment"># 检查响应状态码</span></span><br><span class="line">        <span class="keyword">if</span> response.status_code == <span class="number">200</span>:</span><br><span class="line">            <span class="comment"># 解析JSON响应并提取response字段</span></span><br><span class="line">            json_response = response.json()</span><br><span class="line">            <span class="keyword">return</span> json_response.get(<span class="string">&quot;response&quot;</span>, <span class="string">&quot;&quot;</span>)</span><br><span class="line">        <span class="keyword">else</span>:</span><br><span class="line">            <span class="built_in">print</span>(<span class="string">f&quot;Failed to get response from Qwen2 model. Status code: <span class="subst">&#123;response.status_code&#125;</span>&quot;</span>)</span><br><span class="line">            <span class="keyword">return</span> <span class="string">&quot;&quot;</span></span><br><span class="line">    <span class="keyword">except</span> requests.RequestException <span class="keyword">as</span> e:</span><br><span class="line">        <span class="built_in">print</span>(<span class="string">f&quot;An error occurred: <span class="subst">&#123;e&#125;</span>&quot;</span>)</span><br><span class="line">        <span class="keyword">return</span> <span class="string">&quot;&quot;</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># 读取输入文件</span></span><br><span class="line">input_file_path = <span class="string">&quot;train_desc.txt&quot;</span></span><br><span class="line">output_file_path = <span class="string">&quot;final_desc.txt&quot;</span></span><br><span class="line">train_prompt=<span class="string">&quot;Please generate only the similar descriptive text without any extra content. The output should be approximately the same length as the input and in English.\n&quot;</span></span><br><span class="line"><span class="keyword">with</span> <span class="built_in">open</span>(input_file_path, <span class="string">&#x27;r&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> input_file:</span><br><span class="line">    lines = input_file.readlines()</span><br><span class="line"></span><br><span class="line"><span class="comment"># 处理每一行并写入输出文件</span></span><br><span class="line"><span class="keyword">with</span> tqdm(total=<span class="built_in">len</span>(lines), desc=<span class="string">&quot;Processing&quot;</span>, unit=<span class="string">&quot;line&quot;</span>) <span class="keyword">as</span> pbar:</span><br><span class="line">    <span class="keyword">with</span> <span class="built_in">open</span>(output_file_path, <span class="string">&#x27;w&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> output_file:</span><br><span class="line">        <span class="keyword">for</span> line <span class="keyword">in</span> lines:</span><br><span class="line">            <span class="comment"># 去除行尾的换行符</span></span><br><span class="line">            prompt = train_prompt + line.strip()</span><br><span class="line">            </span><br><span class="line">            <span class="comment"># 使用模型处理生成相似文本</span></span><br><span class="line">            result = askLocalQwen2Model(prompt)</span><br><span class="line">            </span><br><span class="line">            <span class="comment"># 将结果写入输出文件</span></span><br><span class="line">            output_file.write(result + <span class="string">&quot;\n&quot;</span>)</span><br><span class="line">            </span><br><span class="line">            <span class="comment"># 更新进度条</span></span><br><span class="line">            pbar.update(<span class="number">1</span>)</span><br><span class="line"></span><br><span class="line"><span class="built_in">print</span>(<span class="string">&quot;处理完成，结果已保存到final.txt&quot;</span>)</span><br></pre></td></tr></table></figure><br>这是目前的代码，可能还会修改。提示词可以修改<code>train_prompt</code>，来控制生成的文本能够符合输出要求。</p></div><div class="tab-item-content"><p>使用完基本代码发现跑的非常慢，于是添加了多线程，代码如下：<br><strong>这是添加了多线程的代码</strong><br>修改完上述部分以后，发现处理完本项目的<code>train_desc.txt</code>文件竟然要300多个小时，于是想用多进程来加速处理，于是修改了代码如下：<br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> requests</span><br><span class="line"><span class="keyword">import</span> json</span><br><span class="line"><span class="keyword">from</span> tqdm <span class="keyword">import</span> tqdm</span><br><span class="line"><span class="keyword">from</span> concurrent.futures <span class="keyword">import</span> ThreadPoolExecutor, as_completed</span><br><span class="line"><span class="keyword">import</span> logging</span><br><span class="line"><span class="keyword">import</span> os</span><br><span class="line"><span class="keyword">import</span> signal</span><br><span class="line"><span class="comment"># 读取输入文件</span></span><br><span class="line">input_file_path = <span class="string">&quot;train_desc.txt&quot;</span> <span class="comment">##输入文件</span></span><br><span class="line">output_file_path = <span class="string">&quot;final_desc.txt&quot;</span> <span class="comment">##输出文件</span></span><br><span class="line">model_name = <span class="string">&quot;qwen2.5-coder:latest&quot;</span> <span class="comment">## 模型名称</span></span><br><span class="line">num_workers = <span class="number">1000</span> <span class="comment">## 线程数(目前1000最佳)</span></span><br><span class="line"><span class="comment">## 模型提示词（要求）</span></span><br><span class="line">train_prompt = <span class="string">&quot;Please generate only the similar descriptive text without any extra content. The output should be approximately the same length as the input and in English.\n&quot;</span></span><br><span class="line"><span class="comment"># temp_dir = &quot;temp_files&quot;</span></span><br><span class="line"><span class="comment"># os.makedirs(temp_dir, exist_ok=True)</span></span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="comment"># 配置日志记录</span></span><br><span class="line">logging.basicConfig(level=logging.INFO, <span class="built_in">format</span>=<span class="string">&#x27;%(asctime)s - %(levelname)s - %(message)s&#x27;</span>)</span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">askLocalQwen2Model</span>(<span class="params">prompt</span>):</span><br><span class="line">    url = <span class="string">&quot;http://localhost:11434/api/generate&quot;</span></span><br><span class="line">    </span><br><span class="line">    <span class="comment"># 创建要发送的JSON对象</span></span><br><span class="line">    json_input = &#123;</span><br><span class="line">        <span class="string">&quot;model&quot;</span>: model_name, </span><br><span class="line">        <span class="string">&quot;prompt&quot;</span>: prompt,</span><br><span class="line">        <span class="string">&quot;stream&quot;</span>: <span class="literal">False</span></span><br><span class="line">    &#125;</span><br><span class="line">    </span><br><span class="line">    <span class="keyword">try</span>:</span><br><span class="line">        <span class="comment"># 发送POST请求</span></span><br><span class="line">        response = requests.post(url, headers=&#123;<span class="string">&quot;Content-Type&quot;</span>: <span class="string">&quot;application/json&quot;</span>&#125;, data=json.dumps(json_input))</span><br><span class="line">        </span><br><span class="line">        <span class="comment"># 检查响应状态码</span></span><br><span class="line">        <span class="keyword">if</span> response.status_code == <span class="number">200</span>: <span class="comment">#成功</span></span><br><span class="line">            <span class="comment"># 解析JSON响应并提取response字段</span></span><br><span class="line">            json_response = response.json()</span><br><span class="line">            <span class="keyword">return</span> json_response.get(<span class="string">&quot;response&quot;</span>, <span class="string">&quot;&quot;</span>)</span><br><span class="line">        <span class="keyword">else</span>:</span><br><span class="line">            logging.error(<span class="string">f&quot;Failed to get response from model. Status code: <span class="subst">&#123;response.status_code&#125;</span>&quot;</span>)</span><br><span class="line">            <span class="keyword">return</span> <span class="string">&quot;&quot;</span></span><br><span class="line">    <span class="keyword">except</span> requests.RequestException <span class="keyword">as</span> e:</span><br><span class="line">        logging.error(<span class="string">f&quot;An error occurred: <span class="subst">&#123;e&#125;</span>&quot;</span>)</span><br><span class="line">        <span class="keyword">return</span> <span class="string">&quot;&quot;</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">with</span> <span class="built_in">open</span>(input_file_path, <span class="string">&#x27;r&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> input_file:</span><br><span class="line">    lines = input_file.readlines()</span><br><span class="line">results = []</span><br><span class="line"><span class="keyword">def</span> <span class="title function_">save_results_and_exit</span>(<span class="params">signum, frame</span>):</span><br><span class="line">    <span class="keyword">with</span> <span class="built_in">open</span>(output_file_path, <span class="string">&#x27;w&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> output_file:</span><br><span class="line">        <span class="keyword">for</span> i <span class="keyword">in</span> <span class="built_in">range</span>(<span class="built_in">len</span>(lines)):</span><br><span class="line">            result = <span class="built_in">next</span>((res <span class="keyword">for</span> index, res <span class="keyword">in</span> results <span class="keyword">if</span> index == i), <span class="literal">None</span>)</span><br><span class="line">            <span class="keyword">if</span> result <span class="keyword">is</span> <span class="keyword">not</span> <span class="literal">None</span>:</span><br><span class="line">                output_file.write(result + <span class="string">&quot;\n&quot;</span>)</span><br><span class="line">    logging.info(<span class="string">&quot;Results saved to file. Exiting... 多线程无法返回命令提示符，请自行关闭窗口&quot;</span>)</span><br><span class="line">    exit(<span class="number">0</span>)</span><br><span class="line"><span class="comment"># 捕获中断信号，防止Ctrl+C中断程序</span></span><br><span class="line">signal.signal(signal.SIGINT, save_results_and_exit)</span><br><span class="line"><span class="keyword">with</span> tqdm(total=<span class="built_in">len</span>(lines), desc=<span class="string">&quot;Processing&quot;</span>, unit=<span class="string">&quot;line&quot;</span>) <span class="keyword">as</span> pbar:</span><br><span class="line">    <span class="comment">#并行处理数量</span></span><br><span class="line">    <span class="keyword">with</span> ThreadPoolExecutor(max_workers=num_workers) <span class="keyword">as</span> executor:</span><br><span class="line">        futures = &#123;executor.submit(askLocalQwen2Model, train_prompt + line.strip()): i <span class="keyword">for</span> i, line <span class="keyword">in</span> <span class="built_in">enumerate</span>(lines)&#125;</span><br><span class="line">        </span><br><span class="line">        <span class="keyword">for</span> future <span class="keyword">in</span> as_completed(futures):</span><br><span class="line">            i = futures[future]</span><br><span class="line">            <span class="keyword">try</span>:</span><br><span class="line">                result = future.result()</span><br><span class="line">                results.append((i, result))</span><br><span class="line">            <span class="keyword">except</span> Exception <span class="keyword">as</span> e:</span><br><span class="line">                logging.error(<span class="string">f&quot;Error processing line <span class="subst">&#123;i&#125;</span>: <span class="subst">&#123;e&#125;</span>&quot;</span>)</span><br><span class="line">                results.append((i, <span class="string">&quot;&quot;</span>))</span><br><span class="line">            </span><br><span class="line">            pbar.update(<span class="number">1</span>)</span><br><span class="line"><span class="comment"># 将结果写入输出文件</span></span><br><span class="line"><span class="keyword">with</span> <span class="built_in">open</span>(output_file_path, <span class="string">&#x27;w&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> output_file:</span><br><span class="line">    <span class="keyword">for</span> i <span class="keyword">in</span> <span class="built_in">range</span>(<span class="built_in">len</span>(lines)):</span><br><span class="line">        result = <span class="built_in">next</span>((res <span class="keyword">for</span> index, res <span class="keyword">in</span> results <span class="keyword">if</span> index == i), <span class="literal">None</span>)</span><br><span class="line">        output_file.write(result + <span class="string">&quot;\n&quot;</span>)</span><br><span class="line"><span class="built_in">print</span>(<span class="string">&quot;处理完成，结果已保存到final.txt&quot;</span>)</span><br></pre></td></tr></table></figure><br>但是上述代码有一些问题，例如线程过多会报错，因此优化后的代码如下：<br><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br><span class="line">53</span><br><span class="line">54</span><br><span class="line">55</span><br><span class="line">56</span><br><span class="line">57</span><br><span class="line">58</span><br><span class="line">59</span><br><span class="line">60</span><br><span class="line">61</span><br><span class="line">62</span><br><span class="line">63</span><br><span class="line">64</span><br><span class="line">65</span><br><span class="line">66</span><br><span class="line">67</span><br><span class="line">68</span><br><span class="line">69</span><br><span class="line">70</span><br><span class="line">71</span><br><span class="line">72</span><br><span class="line">73</span><br><span class="line">74</span><br><span class="line">75</span><br><span class="line">76</span><br><span class="line">77</span><br><span class="line">78</span><br><span class="line">79</span><br><span class="line">80</span><br><span class="line">81</span><br><span class="line">82</span><br><span class="line">83</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> requests</span><br><span class="line"><span class="keyword">import</span> json</span><br><span class="line"><span class="keyword">from</span> tqdm <span class="keyword">import</span> tqdm</span><br><span class="line"><span class="keyword">from</span> concurrent.futures <span class="keyword">import</span> ThreadPoolExecutor, as_completed</span><br><span class="line"><span class="keyword">import</span> logging</span><br><span class="line"><span class="keyword">import</span> os</span><br><span class="line"><span class="keyword">import</span> signal</span><br><span class="line"><span class="keyword">import</span> time</span><br><span class="line"></span><br><span class="line"><span class="comment"># 读取输入文件</span></span><br><span class="line">input_file_path = <span class="string">&quot;train_desc.txt&quot;</span> <span class="comment">##输入文件</span></span><br><span class="line">output_file_path = <span class="string">&quot;final_desc.txt&quot;</span> <span class="comment">##输出文件</span></span><br><span class="line">model_name = <span class="string">&quot;qwen2.5-coder:latest&quot;</span> <span class="comment">## 模型名称</span></span><br><span class="line">num_workers = <span class="number">10</span> <span class="comment">## 线程数(目前10最佳)</span></span><br><span class="line"><span class="comment">## 模型提示词（要求）</span></span><br><span class="line">train_prompt = <span class="string">&quot;Please generate only the similar descriptive text without any extra content. The output should be approximately the same length as the input and in English.\n&quot;</span></span><br><span class="line"><span class="comment"># 配置日志记录</span></span><br><span class="line">logging.basicConfig(level=logging.INFO, <span class="built_in">format</span>=<span class="string">&#x27;%(asctime)s - %(levelname)s - %(message)s&#x27;</span>)</span><br><span class="line"><span class="keyword">def</span> <span class="title function_">askLocalQwen2Model</span>(<span class="params">prompt, max_retries=<span class="number">3</span></span>):</span><br><span class="line">    url = <span class="string">&quot;http://localhost:11434/api/generate&quot;</span></span><br><span class="line">    </span><br><span class="line">    <span class="comment"># 创建要发送的JSON对象</span></span><br><span class="line">    json_input = &#123;</span><br><span class="line">        <span class="string">&quot;model&quot;</span>: model_name, </span><br><span class="line">        <span class="string">&quot;prompt&quot;</span>: prompt,</span><br><span class="line">        <span class="string">&quot;stream&quot;</span>: <span class="literal">False</span></span><br><span class="line">    &#125;</span><br><span class="line">    </span><br><span class="line">    <span class="keyword">for</span> attempt <span class="keyword">in</span> <span class="built_in">range</span>(max_retries):</span><br><span class="line">        <span class="keyword">try</span>:</span><br><span class="line">            <span class="comment"># 发送POST请求</span></span><br><span class="line">            response = requests.post(url, headers=&#123;<span class="string">&quot;Content-Type&quot;</span>: <span class="string">&quot;application/json&quot;</span>&#125;, data=json.dumps(json_input))</span><br><span class="line">            </span><br><span class="line">            <span class="comment"># 检查响应状态码</span></span><br><span class="line">            <span class="keyword">if</span> response.status_code == <span class="number">200</span>: <span class="comment">#成功</span></span><br><span class="line">                <span class="comment"># 解析JSON响应并提取response字段</span></span><br><span class="line">                json_response = response.json()</span><br><span class="line">                <span class="keyword">return</span> json_response.get(<span class="string">&quot;response&quot;</span>, <span class="string">&quot;&quot;</span>)</span><br><span class="line">            <span class="keyword">else</span>:</span><br><span class="line">                logging.warning(<span class="string">f&quot;Attempt <span class="subst">&#123;attempt + <span class="number">1</span>&#125;</span> failed. Status code: <span class="subst">&#123;response.status_code&#125;</span>&quot;</span>)</span><br><span class="line">        <span class="keyword">except</span> requests.RequestException <span class="keyword">as</span> e:</span><br><span class="line">            logging.warning(<span class="string">f&quot;Attempt <span class="subst">&#123;attempt + <span class="number">1</span>&#125;</span> failed: <span class="subst">&#123;e&#125;</span>&quot;</span>)</span><br><span class="line">    </span><br><span class="line">    <span class="comment"># 如果所有尝试都失败，返回空字符串</span></span><br><span class="line">    <span class="keyword">return</span> <span class="string">&quot;&quot;</span></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">save_results_and_exit</span>(<span class="params">signum, frame</span>):</span><br><span class="line">    <span class="keyword">with</span> <span class="built_in">open</span>(output_file_path, <span class="string">&#x27;w&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> output_file:</span><br><span class="line">        <span class="keyword">for</span> i <span class="keyword">in</span> <span class="built_in">range</span>(<span class="built_in">len</span>(lines)):</span><br><span class="line">            <span class="keyword">if</span> i <span class="keyword">in</span> processed_indices:</span><br><span class="line">                result = results[processed_indices.index(i)]</span><br><span class="line">                output_file.write(result + <span class="string">&quot;\n&quot;</span>)</span><br><span class="line">    logging.info(<span class="string">&quot;Results saved to file. Exiting...&quot;</span>)</span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;程序已保存结果并退出。请手动关闭窗口或终端。&quot;</span>)</span><br><span class="line">    time.sleep(<span class="number">2</span>)  <span class="comment"># 等待一段时间</span></span><br><span class="line">    exit(<span class="number">0</span>)</span><br><span class="line"><span class="comment"># 捕获中断信号，防止Ctrl+C中断程序</span></span><br><span class="line">signal.signal(signal.SIGINT, save_results_and_exit)</span><br><span class="line"><span class="keyword">with</span> <span class="built_in">open</span>(input_file_path, <span class="string">&#x27;r&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> input_file:</span><br><span class="line">    lines = input_file.readlines()</span><br><span class="line">results = []</span><br><span class="line">processed_indices = []</span><br><span class="line"><span class="keyword">with</span> tqdm(total=<span class="built_in">len</span>(lines), desc=<span class="string">&quot;Processing&quot;</span>, unit=<span class="string">&quot;line&quot;</span>) <span class="keyword">as</span> pbar:</span><br><span class="line">    <span class="comment"># 并行处理数量</span></span><br><span class="line">    <span class="keyword">with</span> ThreadPoolExecutor(max_workers=num_workers) <span class="keyword">as</span> executor:</span><br><span class="line">        futures = &#123;executor.submit(askLocalQwen2Model, train_prompt + line.strip()): i <span class="keyword">for</span> i, line <span class="keyword">in</span> <span class="built_in">enumerate</span>(lines)&#125;</span><br><span class="line">        </span><br><span class="line">        <span class="keyword">for</span> future <span class="keyword">in</span> as_completed(futures):</span><br><span class="line">            i = futures[future]</span><br><span class="line">            <span class="keyword">try</span>:</span><br><span class="line">                result = future.result()</span><br><span class="line">                results.append(result)</span><br><span class="line">                processed_indices.append(i)</span><br><span class="line">            <span class="keyword">except</span> Exception <span class="keyword">as</span> e:</span><br><span class="line">                logging.error(<span class="string">f&quot;Error processing line <span class="subst">&#123;i&#125;</span>: <span class="subst">&#123;e&#125;</span>&quot;</span>)</span><br><span class="line">            </span><br><span class="line">            pbar.update(<span class="number">1</span>)</span><br><span class="line"><span class="comment"># 将结果写入输出文件</span></span><br><span class="line"><span class="keyword">with</span> <span class="built_in">open</span>(output_file_path, <span class="string">&#x27;w&#x27;</span>, encoding=<span class="string">&#x27;utf-8&#x27;</span>) <span class="keyword">as</span> output_file:</span><br><span class="line">    <span class="keyword">for</span> i <span class="keyword">in</span> <span class="built_in">range</span>(<span class="built_in">len</span>(lines)):</span><br><span class="line">        <span class="keyword">if</span> i <span class="keyword">in</span> processed_indices:</span><br><span class="line">            result = results[processed_indices.index(i)]</span><br><span class="line">            output_file.write(result + <span class="string">&quot;\n&quot;</span>)</span><br><span class="line"><span class="built_in">print</span>(<span class="string">&quot;处理完成，结果已保存到final_desc.txt&quot;</span>)</span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div></li><li><p>生成文本以后，再通过文本预处理以后生成pkl，我们还可以使用以下代码查看pkl文件的内容</p><figure class="highlight python"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> pickle</span><br><span class="line">desc_dict = pickle.load(<span class="built_in">open</span>(<span class="string">&#x27;vocab.desc.pkl&#x27;</span>, <span class="string">&#x27;rb&#x27;</span>))</span><br><span class="line"><span class="comment"># desc_dict = pickle.load(open(&#x27;想查看的pkl文件.pkl&#x27;, &#x27;rb&#x27;))</span></span><br><span class="line"><span class="built_in">print</span>(desc_dict)</span><br></pre></td></tr></table></figure></li></ul>]]>
    </content>
    <id>https://cookiesky.cn/2024/11/11/semenr/</id>
    <link href="https://cookiesky.cn/2024/11/11/semenr/"/>
    <published>2024-11-10T17:34:09.000Z</published>
    <summary>代码搜索-大数据探索</summary>
    <title>代码搜索SemEnr使用记录</title>
    <updated>2026-11-18T05:28:36.768Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="编程语言" scheme="https://cookiesky.cn/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/"/>
    <category term="信息学竞赛" scheme="https://cookiesky.cn/tags/%E4%BF%A1%E6%81%AF%E5%AD%A6%E7%AB%9E%E8%B5%9B/"/>
    <category term="C++" scheme="https://cookiesky.cn/tags/C/"/>
    <content>
      <![CDATA[<h1 id="编程基础"><a href="#编程基础" class="headerlink" title="编程基础"></a>编程基础</h1><h2 id="排序"><a href="#排序" class="headerlink" title="排序"></a>排序</h2><h3 id="sort简介"><a href="#sort简介" class="headerlink" title="sort简介"></a>sort简介</h3><p>sort函数包含在头文件&lt; algorithm &gt;中<br>在使用前需要#include &lt; algorithm &gt;或使用万能头文件。<br>sort是C++标准库中的一个函数模板，用于对指定范围内的元素进行排序。<br>sort算法使用的是快速排序(QuickSort)或者类似快速排序的改进算法，具有较好的平均时间复杂度，一般为O(nlogn)。</p><h3 id="sort用法"><a href="#sort用法" class="headerlink" title="sort用法"></a>sort用法</h3><p>sort(起始地址，结束地址下一位，*比较函数);<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="type">int</span> a[<span class="number">1000</span>];</span><br><span class="line"><span class="type">int</span> n;</span><br><span class="line"><span class="comment">//读取数组大小</span></span><br><span class="line">cin&gt;&gt;n;</span><br><span class="line"><span class="comment">//读取元素</span></span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i&lt;n;i++)cin&gt;&gt;a[i];</span><br><span class="line"><span class="comment">//对数组进行排序</span></span><br><span class="line"><span class="built_in">sort</span>(a+<span class="number">1</span>,a+n+<span class="number">1</span>);</span><br><span class="line"><span class="comment">//输出</span></span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i&lt;n;i++)cout&lt;&lt;a[i]&lt;&lt;<span class="string">&quot; &quot;</span>;</span><br></pre></td></tr></table></figure><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">//初始化v</span></span><br><span class="line">vector&lt;<span class="type">int</span>&gt; v=&#123;<span class="number">5</span>,<span class="number">1</span>,<span class="number">3</span>,<span class="number">9</span>,<span class="number">11</span>&#125;;</span><br><span class="line"><span class="comment">//对数组排序</span></span><br><span class="line"><span class="built_in">sort</span>(v.<span class="built_in">begin</span>(),v.<span class="built_in">end</span>());</span><br><span class="line"><span class="comment">//输出</span></span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;v.<span class="built_in">size</span>();i++)cout&lt;&lt;v[i]&lt;&lt;<span class="string">&quot; &quot;</span>;</span><br><span class="line"><span class="comment">//结果：1 3 5 9 11</span></span><br></pre></td></tr></table></figure></p><h3 id="自定义比较函数"><a href="#自定义比较函数" class="headerlink" title="自定义比较函数"></a>自定义比较函数</h3><p>sort默认使用小于号进行排序，如果想要自定义比较规则可以传入第三个参数，可以是函数或lambda表达式<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">bool</span> <span class="title">cmp</span><span class="params">(<span class="type">const</span> <span class="type">int</span> &amp;u,<span class="type">const</span> <span class="type">int</span> &amp;v)</span></span>&#123;</span><br><span class="line">    <span class="keyword">return</span> u&gt;v;</span><br><span class="line">&#125;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>),cin.<span class="built_in">tie</span>(<span class="number">0</span>),cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line">    <span class="comment">//初始化v</span></span><br><span class="line">    vector&lt;<span class="type">int</span>&gt; v=&#123;<span class="number">5</span>,<span class="number">1</span>,<span class="number">3</span>,<span class="number">9</span>,<span class="number">11</span>&#125;;</span><br><span class="line">    <span class="comment">//对数组排序，降序</span></span><br><span class="line">    <span class="built_in">sort</span>(v.<span class="built_in">begin</span>(),v.<span class="built_in">end</span>(),cmp);</span><br><span class="line">    <span class="comment">//输出</span></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;v.<span class="built_in">size</span>();i++)cout&lt;&lt;v[i]&lt;&lt;<span class="string">&quot; &quot;</span>;</span><br><span class="line">    <span class="comment">//结果：11 9 5 3 1</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br>lamvda(匿名函数)<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">//初始化</span></span><br><span class="line">vector&lt;<span class="type">int</span>&gt; v=&#123;<span class="number">5</span>,<span class="number">1</span>,<span class="number">3</span>,<span class="number">9</span>,<span class="number">11</span>&#125;;</span><br><span class="line"><span class="comment">//对数组排序，降序排列</span></span><br><span class="line"><span class="built_in">sort</span>(v.<span class="built_in">begin</span>(),v.<span class="built_in">end</span>(),[](<span class="type">const</span> <span class="type">int</span> &amp;u, <span class="type">const</span> <span class="type">int</span> &amp;v)&#123;</span><br><span class="line">    <span class="keyword">return</span> u&gt;v;</span><br><span class="line">&#125;);</span><br><span class="line"><span class="comment">//输出</span></span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;v.<span class="built_in">size</span>();i++)cout&lt;&lt;v[i]&lt;&lt;<span class="string">&quot; &quot;</span>;</span><br><span class="line"><span class="comment">//结果：11 9 5 3 1</span></span><br></pre></td></tr></table></figure><br>结构体可以将小于号重载后进行排序，当然用前面的方法也是可行的<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">struct</span> <span class="title class_">node</span>&#123;</span><br><span class="line">    <span class="type">int</span> x,y;</span><br><span class="line">    <span class="type">bool</span> <span class="keyword">operator</span>&lt;(<span class="type">const</span> Node &amp;m)<span class="type">const</span>&#123;</span><br><span class="line">        <span class="comment">//以u为第一关键字，v为第二关键字排序</span></span><br><span class="line">        <span class="keyword">return</span> u==m.u?v&lt;m.v:u&lt;m.u;</span><br><span class="line">    &#125;</span><br><span class="line">&#125;; </span><br></pre></td></tr></table></figure></p><h3 id="例题"><a href="#例题" class="headerlink" title="例题"></a>例题</h3><p>题目详见<a href="https://www.lanqiao.cn/problems/1265/learning/">蓝桥OJ：排序</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N=<span class="number">5e5</span>+<span class="number">3</span>;</span><br><span class="line"><span class="type">int</span> a[N];</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">  <span class="comment">//取消同步流</span></span><br><span class="line">  ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>),cin.<span class="built_in">tie</span>(<span class="number">0</span>), cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line">  </span><br><span class="line">  <span class="type">int</span> n;cin&gt;&gt;n;</span><br><span class="line">  <span class="comment">//输入</span></span><br><span class="line">  <span class="keyword">for</span> (<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;++i)cin&gt;&gt;a[i];</span><br><span class="line">  <span class="comment">//升序排列</span></span><br><span class="line">  <span class="built_in">sort</span>(a+<span class="number">1</span>,a+<span class="number">1</span>+n);</span><br><span class="line">  <span class="keyword">for</span> (<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;++i)cout&lt;&lt;a[i]&lt;&lt;<span class="string">&quot; \n&quot;</span>[i==n];<span class="comment">//如果i==n则换行，否则输出空格</span></span><br><span class="line">  <span class="comment">//降序排列lambda法</span></span><br><span class="line">  <span class="built_in">sort</span>(a+<span class="number">1</span>,a+<span class="number">1</span>+n,[](<span class="type">const</span> <span class="type">int</span> &amp;u,<span class="type">const</span> <span class="type">int</span> &amp;v)&#123;</span><br><span class="line">    <span class="keyword">return</span> u&gt;v;</span><br><span class="line">  &#125;);</span><br><span class="line">  <span class="comment">//或者sort(a+1,a+1+n,cmp);然后再在前面定义bool cmp(int u,int v)&#123;return u&gt;v;&#125;</span></span><br><span class="line">  <span class="keyword">for</span> (<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;++i)cout&lt;&lt;a[i]&lt;&lt;<span class="string">&quot; \n&quot;</span>[i==n]; </span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="comment">//或者逆序输出可以在正序排完序以后</span></span><br><span class="line"><span class="comment">//for (int i=1;i&gt;=1;--i)cout&lt;&lt;a[i]&lt;&lt;&quot; \n&quot;[i==n]; </span></span><br><span class="line">  <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h2 id="最值查找"><a href="#最值查找" class="headerlink" title="最值查找"></a>最值查找</h2><h2 id="min和max函数"><a href="#min和max函数" class="headerlink" title="min和max函数"></a>min和max函数</h2><p>min(a,b)返回a和b中较小的那个值，只能传入两个值，或传入一个列表。<br>例如:<br>min(3, 5)= 3<br>min({1, 2, 3, 4})=1<br>max(a,b)返回a和b中较大的那个值，只能传入两个值，或传入一个列表。<br>例如:<br>max(7,5)=7<br>min({1, 2, 3, 4})= 4<br>时间复杂度为O(1)，传入参数为数组时时间复杂度为O(n)，n为数组大小。<br>min,max函数是在取最值操作时最常用的操作。</p><h2 id="min-element和max-element"><a href="#min-element和max-element" class="headerlink" title="min_element和max_element"></a>min_element和max_element</h2><p>min_element(st,ed)返回地址[st,ed)中最小的那个值的地址(迭代器)，传入参数为<br>两个地址或迭代器。<br>max_element(st,ed)返回地址[st,ed)中最大的那个值的地址(迭代器)，传入参数为<br>两个地址或迭代器。<br>时间复杂度均为0(n)，n为数组大小(由传入的参数决定)<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">//初始化v</span></span><br><span class="line">vector&lt;<span class="type">int</span>&gt;v=&#123;<span class="number">5</span>,<span class="number">1</span>,<span class="number">3</span>,<span class="number">9</span>,<span class="number">11</span>&#125;;</span><br><span class="line"><span class="comment">//输出最大的元素，*表示解引用，即通过地址(迭代器)得到值</span></span><br><span class="line">cout &lt;&lt; *<span class="built_in">max_element</span>(v.<span class="built_in">begin</span>(),v.<span class="built_in">end</span>())&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line"><span class="comment">//输出11</span></span><br></pre></td></tr></table></figure></p><h3 id="nth-element函数"><a href="#nth-element函数" class="headerlink" title="nth_element函数"></a>nth_element函数</h3><p>nth_element(st, k, ed)<br>进行部分排序，返回值为void()<br>传入参数为三个地址或迭代器。其中第二个参数位置的元素将处于正确位置，其他位置元素的顺序可能是任意的，但前面的都比它小，后面的都比它大。<br>时间复杂度O(n)。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">//初始化v</span></span><br><span class="line">vector&lt;<span class="type">int</span>&gt;v=&#123;<span class="number">5</span>,<span class="number">1</span>,<span class="number">7</span>,<span class="number">3</span>,<span class="number">10</span>,<span class="number">18</span>,<span class="number">9</span>&#125;;</span><br><span class="line"><span class="comment">//输出最大的元素，*表示解引用，即通过地址(迭代器)得到值</span></span><br><span class="line"><span class="built_in">nth_element</span>(v.<span class="built_in">begin</span>(),v.<span class="built_in">begin</span>()+<span class="number">3</span>,v.<span class="built_in">end</span>());</span><br><span class="line"><span class="comment">//这里v[3]的位置将会位于排序后的位置，其他的任意</span></span><br><span class="line"><span class="keyword">for</span>(<span class="keyword">auto</span> &amp;i : v)cout&lt;&lt; i&lt;&lt;<span class="string">&#x27; &#x27;</span>;</span><br><span class="line"><span class="comment">//输出：3 1 5 7 9 18 10</span></span><br></pre></td></tr></table></figure></p><h3 id="例题-1"><a href="#例题-1" class="headerlink" title="例题"></a>例题</h3><p>题目详见<a href="https://www.lanqiao.cn/problems/497/learning/">蓝桥OJ：成绩分析</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="keyword">using</span> ll=<span class="type">long</span> <span class="type">long</span>;<span class="comment">//定义ll为long long的别名</span></span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N=<span class="number">1e4</span>+<span class="number">9</span>;<span class="comment">//题目范围10^4+8，这里+9是为了防止数组越界</span></span><br><span class="line"><span class="type">int</span> a[N];</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">  ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>), cin.<span class="built_in">tie</span>(<span class="number">0</span>), cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line">  <span class="type">int</span> n;cin&gt;&gt;n;</span><br><span class="line"></span><br><span class="line">  <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;++i)cin&gt;&gt;a[i];</span><br><span class="line">  cout&lt;&lt; *<span class="built_in">max_element</span>(a+<span class="number">1</span>,a+<span class="number">1</span>+n) &lt;&lt; <span class="string">&#x27;\n&#x27;</span>;<span class="comment">//最高分</span></span><br><span class="line">  cout&lt;&lt; *<span class="built_in">min_element</span>(a+<span class="number">1</span>,a+<span class="number">1</span>+n) &lt;&lt; <span class="string">&#x27;\n&#x27;</span>;<span class="comment">//最低分</span></span><br><span class="line">  ll sum=<span class="number">0</span>;</span><br><span class="line">  <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;++i)sum+=a[i];<span class="comment">//求和</span></span><br><span class="line">  cout&lt;&lt;fixed&lt;&lt;<span class="built_in">setprecision</span>(<span class="number">2</span>)&lt;&lt;<span class="number">1.0</span>*sum/n;<span class="comment">//求平均，强制转化浮点型，保留两位小数</span></span><br><span class="line">  <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h2 id="二分查找"><a href="#二分查找" class="headerlink" title="二分查找"></a>二分查找</h2><h3 id="二分查找的前提"><a href="#二分查找的前提" class="headerlink" title="二分查找的前提"></a>二分查找的前提</h3><p>库函数只能对数组进行二分查找。<br>对一个数组进行二分查找的前提是这个数组中的元素是单调的，一般为单调不减，当然如果是单调不增也可以(需要修改比较函数，类似sort)<br>例如:<br>[1,5,5,9,18]是单调的<br>[1,9,9,7,15]不是单调的<br>[9,8,8,7,7,1]是单调的</p><h3 id="binary-search函数"><a href="#binary-search函数" class="headerlink" title="binary_search函数"></a>binary_search函数</h3><p>binary_search是C++标准库中的一个算法函数，用于在已排序的序列(例如数组或容器)中查找特定元素。<br>它通过<code>二分查找</code>算法来确定序列中<code>是否存在</code>目标元素。<br>函数返回一个<code>bool值</code>，表示目标元素是否存在于序列中。<br>如果需要获取找到的元素的位置，可以使用<br>std::lower bound函数或<br>std::upper_bound函数。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br></pre></td><td class="code"><pre><span class="line">vector&lt;<span class="type">int</span>&gt;numbers=&#123;<span class="number">1</span>,<span class="number">3</span>,<span class="number">5</span>,<span class="number">7</span>,<span class="number">9</span>&#125;;</span><br><span class="line"></span><br><span class="line"><span class="type">int</span> target = <span class="number">5</span>;</span><br><span class="line"></span><br><span class="line"><span class="comment">// 使用 binary_search 查找目标元素</span></span><br><span class="line"><span class="type">bool</span> found = <span class="built_in">binary_search</span>(numbers.<span class="built_in">begin</span>(), numbers.<span class="built_in">end</span>(), target);</span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span>(found)&#123;</span><br><span class="line">    cout &lt;&lt; <span class="string">&quot;Target element &quot;</span>&lt;&lt; target &lt;&lt;<span class="string">&quot; found.&quot;</span> &lt;&lt; endl;</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">else</span>&#123;</span><br><span class="line">    cout&lt;&lt;<span class="string">&quot;Target element&quot;</span>&lt;&lt; target &lt;&lt;<span class="string">&quot; not found.&quot;</span>&lt;&lt; endl;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h3 id="lower-bound和upper-bound函数"><a href="#lower-bound和upper-bound函数" class="headerlink" title="lower_bound和upper_bound函数"></a>lower_bound和upper_bound函数</h3><p>前提:数组必须为非降序。<br>如果要在非升序的数组中使用，可以通过修改比较函数实现(方法与sort自定义比较函数类似)<br>lower_bound(st,ed,x)返回地址[st,ed)中第一个大于等于x的元素的<code>地址</code>。<br>upper_bound(st,ed,x)返回地址[st,ed)中第一个大于x的元素的<code>地址</code>。<br>如果不存在则返回最后一个元素的下一个位置，在vector中即end()。<br><code>地址-首地址=下标</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="comment">//初始化v</span></span><br><span class="line">vector&lt;<span class="type">int</span>&gt;v=&#123;<span class="number">5</span>,<span class="number">1</span>,<span class="number">7</span>,<span class="number">3</span>，<span class="number">10</span>，<span class="number">18</span>,<span class="number">9</span>&#125;;</span><br><span class="line"><span class="built_in">sort</span>(v.<span class="built_in">begin</span>()，v.<span class="built_in">end</span>());</span><br><span class="line"></span><br><span class="line"><span class="keyword">for</span>(<span class="keyword">auto</span> &amp;i : v)cout&lt;&lt; i &lt;&lt;<span class="string">&#x27; &#x27;</span>;</span><br><span class="line">cout&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line"></span><br><span class="line"><span class="comment">//找到数组中第一个大于等于8的元素的位置</span></span><br><span class="line">cout&lt;&lt;(<span class="built_in">lower_bound</span>(v.<span class="built_in">begin</span>(),v.<span class="built_in">end</span>(),<span class="number">8</span>)- v.<span class="built_in">begin</span>())&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br></pre></td></tr></table></figure></p><h3 id="例题-2"><a href="#例题-2" class="headerlink" title="例题"></a>例题</h3><p>题目详见<a href="https://www.lanqiao.cn/problems/1389/learning/">蓝桥OJ：二分查找数组元素</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">  <span class="type">int</span> data[<span class="number">200</span>];</span><br><span class="line">  <span class="keyword">for</span>(<span class="type">int</span> i = <span class="number">0</span> ; i &lt; <span class="number">200</span> ; i ++)data[i] = <span class="number">4</span> * i + <span class="number">6</span>;</span><br><span class="line">  <span class="type">int</span> target;cin&gt;&gt;target;</span><br><span class="line">  cout&lt;&lt;(<span class="built_in">lower_bound</span>(data,data+<span class="number">200</span>,target)-data);</span><br><span class="line">  <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h2 id="大小写转换"><a href="#大小写转换" class="headerlink" title="大小写转换"></a>大小写转换</h2><h3 id="islower-isupper函数"><a href="#islower-isupper函数" class="headerlink" title="islower/isupper函数"></a>islower/isupper函数</h3><p>islower和isupper是C++标准库中的字符分类函数，用于检查一个字符是否为小写字母或大写字母，islower和isupper函数需要包含头文件&lt; cctype &gt;，也可用万能头文件包含。<br>函数返回值为<code>bool</code>。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="type">char</span> ch1 =<span class="string">&#x27;A&#x27;</span>;</span><br><span class="line"><span class="type">char</span> ch2 = <span class="string">&#x27;b&#x27;</span>;</span><br><span class="line"><span class="comment">// 使用 islower 函数判断字符是否为小写字母</span></span><br><span class="line"><span class="keyword">if</span>(<span class="built_in">islower</span>(ch1))&#123;</span><br><span class="line">cout&lt;&lt;ch1&lt;&lt;<span class="string">&quot;is a lowercase letter.&quot;</span>&lt;&lt; endl;</span><br><span class="line">&#125;<span class="keyword">else</span> &#123;</span><br><span class="line">cout&lt;&lt; ch1&lt;&lt;<span class="string">&quot;is not a lowercase letter.&quot;</span>&lt;&lt; endl;</span><br><span class="line">&#125;</span><br><span class="line"><span class="comment">// 使用 isupper 函数判断字符是否为大写字母</span></span><br><span class="line"><span class="keyword">if</span>(<span class="built_in">isupper</span>(ch2))&#123;</span><br><span class="line">cout &lt;&lt; ch2&lt;&lt;<span class="string">&quot; is an uppercase letter.&quot;</span>&lt;&lt;endl;</span><br><span class="line">&#125; <span class="keyword">else</span> &#123;</span><br><span class="line">cout&lt;&lt; ch2 &lt;&lt;<span class="string">&quot; is not an uppercase letter.&quot;</span>&lt;&lt;endl;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h3 id="tolower-toupper函数"><a href="#tolower-toupper函数" class="headerlink" title="tolower/toupper函数"></a>tolower/toupper函数</h3><p>tolower(char ch)可以将ch转换为小写字母，如果ch不是大写字母则不进行操作。<br>toupper()同理。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="type">char</span> ch1 =<span class="string">&#x27;A&#x27;</span>;</span><br><span class="line"><span class="type">char</span> ch2 =<span class="string">&#x27;b&#x27;</span></span><br><span class="line"><span class="comment">//使用 tolower 函数将字符转换为小写字母</span></span><br><span class="line"><span class="type">char</span> lowercasech1 = <span class="built_in">tolower</span>(ch1);</span><br><span class="line">cout&lt;&lt;<span class="string">&quot;Lowercase of &quot;</span>&lt;&lt; ch1&lt;&lt;<span class="string">&quot;is &quot;</span>&lt;&lt; lowercasech1 &lt;&lt; endl;</span><br><span class="line"><span class="comment">//使用 toupper 函数将字符转换为大写字母</span></span><br><span class="line"><span class="type">char</span> uppercasech2 =<span class="built_in">toupper</span>(ch2);</span><br><span class="line">cout&lt;&lt; <span class="string">&quot;Uppercase of &quot;</span>&lt;&lt; ch2&lt;&lt;<span class="string">&quot;is &quot;</span>&lt;&lt; uppercasech2 &lt;&lt; endl;</span><br></pre></td></tr></table></figure></p><h3 id="ASCII码"><a href="#ASCII码" class="headerlink" title="ASCII码"></a>ASCII码</h3><p>详见<a href="https://www.asciim.cn/">ASCII码表</a><br>char ~ 8bit,2^8种可能，0~127为标准ASCII码，128~255为扩展ASCII码。<br>从48号开始，0~9的ASCII码依次为48~57，A~Z的ASCII码依次为65~90，a~z的ASCII码依次为97~122。<br><code>ASCII码表中，大写字母的ASCII码比小写字母的ASCII码小32。</code><br>在了解了ascii码后，我们可以通过直接对英文字母进行加减运算计算出其大小写的字符。<br>在ASCII码表中，大写字母的编码范围是65(A)到90(Z)，而小写字母的编码范围<br>是97(‘a’)到122(z)。根据这个规则，可以使用ASCII码表进行大小写转换。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="type">char</span> ch=<span class="string">&#x27;A&#x27;</span>; <span class="comment">// 大写字母</span></span><br><span class="line"><span class="type">char</span> convertedch;</span><br><span class="line"><span class="keyword">if</span>(ch &gt;= <span class="string">&#x27;A&#x27;</span>&amp;&amp; ch &lt;= <span class="string">&#x27;z&#x27;</span>)&#123;</span><br><span class="line"><span class="comment">// 大写字母转换为小写字母</span></span><br><span class="line">convertedch=ch+<span class="number">32</span>;<span class="comment">//更推荐ch-&#x27;A+&#x27;a&#x27;的写法</span></span><br><span class="line">cout&lt;&lt;<span class="string">&quot;Converted character:&quot;</span></span><br><span class="line">&lt;&lt; convertedch&lt;&lt; endl;</span><br><span class="line">&#125;<span class="keyword">else</span> <span class="keyword">if</span>(ch &gt;= <span class="string">&#x27;a&#x27;</span>&amp;&amp; ch&lt;= <span class="string">&#x27;z&#x27;</span>)&#123;</span><br><span class="line"><span class="comment">// 小写字母转换为大写字母</span></span><br><span class="line">convertedch=ch<span class="number">-32</span>;<span class="comment">//更推荐ch-&#x27;a+&#x27;A&#x27;的写法</span></span><br><span class="line">cout&lt;&lt;<span class="string">&quot;converted character:&quot;</span></span><br><span class="line">&lt;&lt; convertedch&lt;&lt; endl;</span><br><span class="line">&#125; <span class="keyword">else</span> &#123;</span><br><span class="line">cout&lt;&lt;<span class="string">&quot;Invalid character!&quot;</span>&lt;&lt; endl;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br><code>Tips</code>:在程序设计时，尤其是用到char类型时<br>一定要注意0~9到底是“数字0~9”还是“字符0~9”<br>它们也可以通过ascii进行转换。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">char</span> <span class="title">convertedch</span><span class="params">(<span class="type">char</span> ch)</span></span>&#123;</span><br><span class="line">    <span class="keyword">if</span>(<span class="built_in">islower</span>(ch))ch=<span class="built_in">touper</span>(ch);<span class="comment">//if(&#x27;a&#x27;&lt;= ch &amp;&amp; ch&lt;=&#x27;z&#x27;)ch = ch-&#x27;a&#x27;+&#x27;A&#x27;;</span></span><br><span class="line">    <span class="keyword">else</span> <span class="keyword">if</span>(<span class="built_in">isupper</span>(ch))ch=<span class="built_in">tolower</span>(ch);<span class="comment">//else if(&#x27;A&#x27;&lt;= ch &amp;&amp; ch&lt;=&#x27;Z&#x27;)ch = ch-&#x27;A&#x27;+&#x27;a&#x27;;</span></span><br><span class="line">    <span class="keyword">return</span> ch;</span><br><span class="line">&#125;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    string s;<span class="built_in">getline</span>(cin, s);</span><br><span class="line">    <span class="keyword">for</span>(<span class="keyword">auto</span> &amp;i : s)</span><br><span class="line">        i = <span class="built_in">convertedch</span>(i);</span><br><span class="line">    cout&lt;&lt; s&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h2 id="全排列"><a href="#全排列" class="headerlink" title="全排列"></a>全排列</h2><h3 id="next-permutation-函数"><a href="#next-permutation-函数" class="headerlink" title="next_permutation()函数"></a>next_permutation()函数</h3><p>next_permutation函数用于生成当前序列的下一个排列。它按照字典序对序列进行重新排列，如果存在下一个排列，则将当前序列更改为下一个排列，并返回true;如果当前序列已经是最后一个排列，则将序列更改为第一个排列，并返回 false。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br></pre></td><td class="code"><pre><span class="line">vector&lt;<span class="type">int</span>&gt;nums=&#123;<span class="number">1</span>,<span class="number">2</span>,<span class="number">3</span>&#125;;</span><br><span class="line"></span><br><span class="line">cout&lt;&lt;<span class="string">&quot;Initial permutation:&quot;</span>;</span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> num :nums)&#123;</span><br><span class="line">cout &lt;&lt; num&lt;&lt;<span class="string">&quot; &quot;</span>;</span><br><span class="line">&#125;</span><br><span class="line">cout &lt;&lt; endl;</span><br><span class="line"></span><br><span class="line"><span class="comment">// 生成下一个排列</span></span><br><span class="line"><span class="keyword">while</span>(<span class="built_in">next_permutation</span>(nums.<span class="built_in">begin</span>(), nums.<span class="built_in">end</span>()))&#123;</span><br><span class="line">    cout&lt;&lt;<span class="string">&quot;Next permutation:&quot;</span>;</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> num :nums)&#123;</span><br><span class="line">    cout &lt;&lt; num &lt;&lt; <span class="string">&quot; &quot;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    cout&lt;&lt; endl;</span><br><span class="line">&#125;</span><br><span class="line"><span class="comment">// 123</span></span><br><span class="line"><span class="comment">// 132</span></span><br><span class="line"><span class="comment">// 213</span></span><br><span class="line"><span class="comment">// 231</span></span><br><span class="line"><span class="comment">// 312</span></span><br><span class="line"><span class="comment">// 321</span></span><br></pre></td></tr></table></figure></p><h3 id="prev-permutation-函数"><a href="#prev-permutation-函数" class="headerlink" title="prev_permutation()函数"></a>prev_permutation()函数</h3><p>prev_permutation函数与next_permutation函数相反，它用于生成当前序列的上一个排列。它按照字典序对序列进行重新排列，如果存在上一个排列，则将当前序列更改为上一个排列，并返回true;如果当前序列已经是第一个排列，则将序列更改为最后一个排列，并返回false。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br></pre></td><td class="code"><pre><span class="line">vector&lt;<span class="type">int</span>&gt;nums2 =&#123;<span class="number">3</span>,<span class="number">2</span>,<span class="number">1</span>&#125;;</span><br><span class="line"></span><br><span class="line">cout&lt;&lt;<span class="string">&quot;Initial permutation:&quot;</span>;</span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> num : nums2)&#123;</span><br><span class="line">    cout &lt;&lt; num&lt;&lt; <span class="string">&quot; &quot;</span>;</span><br><span class="line">&#125;</span><br><span class="line">cout &lt;&lt; endl;</span><br><span class="line"></span><br><span class="line"><span class="comment">//生成上一个排列</span></span><br><span class="line"><span class="keyword">while</span>(<span class="built_in">prev_permutation</span>(nums2.<span class="built_in">begin</span>(),nums2.<span class="built_in">end</span>()))&#123;</span><br><span class="line">    cout&lt;&lt;<span class="string">&quot;Previous permutation:&quot;</span>;</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> num :nums2)&#123;</span><br><span class="line">        cout &lt;&lt; num &lt;&lt; <span class="string">&quot; &quot;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    cout&lt;&lt; endl;</span><br><span class="line">&#125;</span><br><span class="line"><span class="comment">// 321</span></span><br><span class="line"><span class="comment">// 312</span></span><br><span class="line"><span class="comment">// 231</span></span><br><span class="line"><span class="comment">// 213</span></span><br><span class="line"><span class="comment">// 132</span></span><br><span class="line"><span class="comment">// 123</span></span><br></pre></td></tr></table></figure></p><h3 id="例子"><a href="#例子" class="headerlink" title="例子"></a>例子</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="type">int</span> a[<span class="number">10</span>];</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i &lt;= <span class="number">4</span>;++i)a[i]=i;</span><br><span class="line">    <span class="comment">//哪怕是从中间开始，也最终输出4 3 2 1截止</span></span><br><span class="line">    <span class="type">bool</span> tag = <span class="literal">true</span>;</span><br><span class="line">    <span class="keyword">while</span>(tag)&#123;</span><br><span class="line">        <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i &lt;= <span class="number">4</span>;++i)cout &lt;&lt; a[i] &lt;&lt; <span class="string">&quot; &quot;</span>;</span><br><span class="line">        cout &lt;&lt; endl;</span><br><span class="line">        tag = <span class="built_in">next_permutation</span>(a+<span class="number">1</span>,a+<span class="number">5</span>);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i &lt;= <span class="number">4</span>;++i)cout &lt;&lt; a[i] &lt;&lt; <span class="string">&quot; &quot;</span>;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br><span class="line"><span class="comment">// 1 2 3 4</span></span><br><span class="line"><span class="comment">// 1 3 2 4</span></span><br><span class="line"><span class="comment">// 1 3 4 2</span></span><br><span class="line"><span class="comment">// 1 4 2 3</span></span><br><span class="line"><span class="comment">// 1 4 3 2</span></span><br><span class="line"><span class="comment">// 2 1 3 4</span></span><br><span class="line"><span class="comment">// 2 1 4 3</span></span><br><span class="line"><span class="comment">// 2 3 1 4</span></span><br><span class="line"><span class="comment">// 2 3 4 1</span></span><br><span class="line"><span class="comment">// 2 4 1 3</span></span><br><span class="line"><span class="comment">// 2 4 3 1</span></span><br><span class="line"><span class="comment">// 3 1 2 4</span></span><br><span class="line"><span class="comment">// 3 1 4 2</span></span><br><span class="line"><span class="comment">// 3 2 1 4</span></span><br><span class="line"><span class="comment">// 3 2 4 1</span></span><br><span class="line"><span class="comment">// 3 4 1 2</span></span><br><span class="line"><span class="comment">// 3 4 2 1</span></span><br><span class="line"><span class="comment">// 4 1 2 3</span></span><br><span class="line"><span class="comment">// 4 1 3 2</span></span><br><span class="line"><span class="comment">// 4 2 1 3</span></span><br><span class="line"><span class="comment">// 4 2 3 1</span></span><br><span class="line"><span class="comment">// 4 3 1 2</span></span><br><span class="line"><span class="comment">// 4 3 2 1</span></span><br><span class="line"><span class="comment">// 1 2 3 4</span></span><br></pre></td></tr></table></figure><h2 id="其他库函数"><a href="#其他库函数" class="headerlink" title="其他库函数"></a>其他库函数</h2><p>（万能头文件&lt; bits/stdc++.h &gt;就能省略其他库了）</p><h3 id="memset"><a href="#memset" class="headerlink" title="memset()"></a>memset()</h3><p>memset()是一个用于设置内存块值的函数。它的原型定义在&lt; cstring &gt;头文件中，函数声明如下：<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">void</span> *<span class="title">memset</span><span class="params">(<span class="type">void</span> *ptr, <span class="type">int</span> value, <span class="type">size_t</span> num)</span></span>;</span><br></pre></td></tr></table></figure><br>memset()函数接受三个参数:<br>1.ptr:指向要设置值的内存块的指针。<br>2.value:要设置的值，通常是一个整数。<br>3.num:要设置的字节数。（Byte=8bit）<br>memset()函数将ptr指向的内存块的前num个字节设置为value的值。它返回一个指向ptr的指针。<br>memset()函数通常用于初始化内存块，将其设置为特定的值。<br>例如，如果要将一个整型数组的所有元素设置为0，可以使用memset()函数如下<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="type">int</span> arr[<span class="number">10</span>];</span><br><span class="line"><span class="built_in">memset</span>(arr,<span class="number">0</span>,<span class="built_in">sizeof</span>(arr));</span><br></pre></td></tr></table></figure><br>在上述示例中，<br><code>memset(arr,0,sizeof(arr))</code>将数组arr的所有元素设置为0。<br>需要注意的是，memset()函数对于非字符类型的数组可能会产生未定义行为。<br>在处理非字符类型的数组时，更好使用C++中的其他方法，如循环遍历来初始化数组。<br>memset会将每个byte设置为value。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line"> <span class="type">int</span> a[<span class="number">5</span>];</span><br><span class="line"> <span class="built_in">memset</span>(a,<span class="number">0x3f</span>,<span class="keyword">sizeof</span> a);<span class="comment">//memset(a,0,sizeof(a));(0x3f二进制字节中为0011 1111)</span></span><br><span class="line"> <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;<span class="number">5</span>;++i)cout &lt;&lt; <span class="built_in">bitset</span>&lt;<span class="number">32</span>&gt;(a[i]) &lt;&lt; <span class="string">&quot;\n&quot;</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h3 id="swap"><a href="#swap" class="headerlink" title="swap()"></a>swap()</h3><p>swap(T &amp;a,T &amp;b)函数接受两个参数:<br>要交换值的第一个变量的引用。<br>1.a:要交换值的第二个变量的引用<br>2.b:swap()函数通过将第一个变量的值存储到临时变量中，然后将第二个变量的值赋给第一个变量，最后将临时变量的值赋给第二个变量，实现两个变量值的交换。<br>swap()函数可以用于交换任意类型的变量，包括基本类型(如整数、浮点数等)和自定义类型(如结构体、类对象等)。<br>以下是一个示例，展示如何使用swap()函数交换两个整数的值:<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="type">int</span> a = <span class="number">10</span>;</span><br><span class="line"><span class="type">int</span> b = <span class="number">20</span>;</span><br><span class="line">std::<span class="built_in">swap</span>(a,b);</span><br></pre></td></tr></table></figure></p><h3 id="reverse"><a href="#reverse" class="headerlink" title="reverse()"></a>reverse()</h3><p>reverse()是一个用于反转容器中元素顺序的函数。<br>它的原型定义在&lt; algorithm &gt;头文件中，函数的声明如下:<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">template</span> &lt;<span class="keyword">class</span> <span class="title class_">BidirIt</span>&gt;</span><br><span class="line"><span class="function"><span class="type">void</span> <span class="title">reverse</span> <span class="params">(BidirIt first, BidirIt last)</span></span>;</span><br></pre></td></tr></table></figure><br>reverse()函数接受两个参数:<br>1.first:指向容器中要反转的第一个元素的迭代器<br>2.last:指向容器中要反转的最后一个元素的下一个位置的迭代器。<br>reverse()函数将[first, last)范围内的元素顺序进行反转。<br>也就是说，它会将[first,last)范围内的元素按相反的顺序重新排列。<br>reverse()函数可用于反转各种类型的容器，包括数组、向量、链表等。<br>以下是一个示例，展示如何使用reverse()函数反转一个整型向量的元素顺序:<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;iostream&gt;</span></span></span><br><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;vector&gt;</span></span></span><br><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;algorithm&gt;</span></span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    std::vector&lt;<span class="type">int</span>&gt;vec=&#123;<span class="number">1</span>,<span class="number">2</span>,<span class="number">3</span>,<span class="number">4</span>,<span class="number">5</span>&#125;;</span><br><span class="line">    std::<span class="built_in">reverse</span>(vec.<span class="built_in">begin</span>(),vec.<span class="built_in">end</span>());</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> num :vec)&#123;</span><br><span class="line">        std::cout&lt;&lt; num&lt;&lt;“</span><br><span class="line">    &#125;</span><br><span class="line">    std::cout&lt;&lt; std::endl;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h3 id="unique"><a href="#unique" class="headerlink" title="unique()"></a>unique()</h3><p>unique()是一个用于去除容器中<code>相邻</code>重复元素的函数,<br>它的原型定义在&lt; algorithm &gt;头文件中，函数的声明如下<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">template</span> &lt;<span class="keyword">class</span> <span class="title class_">ForwardIt</span>&gt;</span><br><span class="line"><span class="function">ForwardIt <span class="title">unique</span> <span class="params">(ForwardIt first, ForwardIt last)</span></span>;</span><br></pre></td></tr></table></figure><br>unique(first, last)函数接受两个参数:<br>1.first:指向容器中要去重的第一个元素的迭代器,<br>2.last:指向容器中要去重的最后一个元素的下一个位置的迭代器。<br>unique()函数将[first,last)范围内的相邻重复元素去除，并返回一个指向去重后范围的尾后迭代器。去重后的范围中只保留了第一个出现的元素，后续重复的元素都被移除。<br>unique()函数可用于去除各种类型的容器中的相邻重复元素，包括数组、向量、链表等。<br>以下是一个示例，展示如何使用unique()函数去除一个整型向量中的相邻重复元素:<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    std::vector&lt;<span class="type">int</span>&gt;vec=&#123;<span class="number">1</span>,<span class="number">1</span>,<span class="number">2</span>,<span class="number">2</span>,<span class="number">3</span>,<span class="number">3</span>,<span class="number">3</span>,<span class="number">4</span>,<span class="number">4</span>,<span class="number">5</span>&#125;;</span><br><span class="line">    <span class="keyword">auto</span> it = std::<span class="built_in">unique</span>(vec.<span class="built_in">begin</span>(),vec.<span class="built_in">end</span>());<span class="comment">//1234512334</span></span><br><span class="line">    vec.<span class="built_in">erase</span>(it,vec.<span class="built_in">end</span>());<span class="comment">//12345</span></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> num :vec)&#123;</span><br><span class="line">        std::cout&lt;&lt; num&lt;&lt;<span class="string">&quot; &quot;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    std::cout&lt;&lt; std::endl;</span><br><span class="line"></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br>在上述示例中，std::unique(vec.begin(),vec.end())将整型向量vec中的相邻重复元素去除。最终输出的结果是1 2 3 4 5.<br>需要注意的是，unigue()函数只能去除相邻的重复元素，如果容器中存在非相邻的重复元素，则无法去除。<br>如果需要去除所有重复元素，而不仅仅是相邻的重复元素，可对容器进行排序，然后再使用unique()函数。<br>unique()时间复杂度为O(n).<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">int</span> a[]= &#123;<span class="number">3</span>,<span class="number">1</span>,<span class="number">2</span>,<span class="number">2</span>,<span class="number">3</span>&#125;;</span><br><span class="line">    <span class="built_in">sort</span>(a,a+<span class="number">5</span>);<span class="comment">//必需排序，不然输出结果是3 1 2 3</span></span><br><span class="line">    <span class="type">int</span> n = <span class="built_in">unique</span>(a,a+<span class="number">5</span>)-a;</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;n;i++)cout&lt;&lt;a[i]&lt;&lt;<span class="string">&quot; &quot;</span>;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>]]>
    </content>
    <id>https://cookiesky.cn/2024/10/11/note-cpp-2/</id>
    <link href="https://cookiesky.cn/2024/10/11/note-cpp-2/"/>
    <published>2024-10-11T14:59:30.000Z</published>
    <summary>蓝桥云课C和C++学习笔记(二)</summary>
    <title>C和C++学习笔记(二)</title>
    <updated>2026-10-18T08:16:46.004Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="编程语言" scheme="https://cookiesky.cn/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/"/>
    <category term="信息学竞赛" scheme="https://cookiesky.cn/tags/%E4%BF%A1%E6%81%AF%E5%AD%A6%E7%AB%9E%E8%B5%9B/"/>
    <category term="C++" scheme="https://cookiesky.cn/tags/C/"/>
    <content>
      <![CDATA[<h1 id="编程基础"><a href="#编程基础" class="headerlink" title="编程基础"></a>编程基础</h1><h2 id="C-版本"><a href="#C-版本" class="headerlink" title="C++版本"></a>C++版本</h2><p>C++98 (ISO/IEC 14882:1998):C++的第一个版本于 1998年10月发布。有一些较老的oj在使用。<br>C++03 (ISO/IEC 14882:2003):在这个版本的c++中，值初始化(<code>int i=1;</code>)是在2003年2月引入的。<br><code>C++11(蓝桥杯选用)</code>:它于 2011年8月发布。这个 C++修订版引入了 Lambda 表达式、委托构造函数、统一初始化语法、自动类型推导auto、nullptr、decltype、Rvalue、References 等。<br>C++14：它于 2014年8月发布。此版本中添加的功能包括多态lambda、数字分隔符、通用lambda捕获、变量模板、二进制整数文字、引用字符串等。<br>C++17:它于 2017年 12月发布。它引入了折叠表达式、十六进制浮点文字、u8字符文字、带有初始化程序的选择语句、内联变量等。<br>C++20:它于 2020年12月发布。包括的一些新功能包括:测试宏3路比较、运算符&lt;=&gt;和运算符==()=默认值、新属性:[[no_unique_address]]、[[likely]]</p><h2 id="基本数据类型"><a href="#基本数据类型" class="headerlink" title="基本数据类型"></a>基本数据类型</h2><p><code>int</code> 整数<br><code>lomg long</code> 长整<br><code>float</code> 单精度浮点型（小数）<br><code>double</code> 双精度浮点型（小数）<br><code>char</code> 字符<br><code>chan[]</code> 字符串（数组）<br><code>bool</code> 布尔型（true/false），输出是1/0。</p><h2 id="常量"><a href="#常量" class="headerlink" title="常量"></a>常量</h2><p><code>#define</code> 定义常量，如<code>#define PI 3.14</code>，使用时<code>PI</code>就是<code>3.14</code>。<br><code>const</code> 定义常量，如<code>const int PI = 3.14</code>，使用时<code>PI</code>就是<code>3.14</code>。</p><h2 id="变量"><a href="#变量" class="headerlink" title="变量"></a>变量</h2><p><code>int a = 1;</code> 定义变量a，并赋值为1。<br><code>int a;</code> 定义变量a，不赋值。<br><code>int a, b, c;</code> 定义多个变量。<br><code>int a[n];</code> 定义数组，n为数组长度。,元素下标为a[0]~a[n-1]。（注意，n必须为常量（不会变化的））。</p><h2 id="C-代码格式与语法基础"><a href="#C-代码格式与语法基础" class="headerlink" title="C++代码格式与语法基础"></a>C++代码格式与语法基础</h2><h3 id="Hello-World"><a href="#Hello-World" class="headerlink" title="Hello, World!"></a>Hello, World!</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">代码</button><button type="button" class="tab">输入输出</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span><span class="comment">//使用万能头文件</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;<span class="comment">//使用标准命名空间</span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span><span class="comment">//main函数是c++中内置的启动函数，也就是程序入口</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    cout&lt;&lt;<span class="string">&quot;Hello, World!&quot;</span>;<span class="comment">//利用cout将字符串输出，字符串用双引号括起来</span></span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;Hello, World!&quot;</span>);<span class="comment">//利用printf将字符串输出</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;<span class="comment">//函数遇到return会立刻结束。返回0表示main函数正常结束</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><p>输出<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">Hello, World!</span><br><span class="line">Hello, World!</span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h3 id="基本数据类型-1"><a href="#基本数据类型-1" class="headerlink" title="基本数据类型"></a>基本数据类型</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">代码</button><button type="button" class="tab">输入输出</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span><span class="comment">//使用万能头文件</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;<span class="comment">//使用标准命名空间</span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span><span class="comment">//main函数是c++中内置的启动函数，也就是程序入口</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="type">int</span> x=<span class="number">3</span>;<span class="comment">//整数型x=3</span></span><br><span class="line">    <span class="type">double</span> d=<span class="number">3.14</span>;<span class="comment">//浮点型（小数）d=3.14</span></span><br><span class="line">    <span class="type">char</span> ch =<span class="string">&#x27;A&#x27;</span><span class="comment">//字符ch</span></span><br><span class="line">    <span class="type">char</span> s[]=<span class="string">&quot;Hello&quot;</span>;<span class="comment">//字符串s</span></span><br><span class="line">    <span class="type">bool</span> b=<span class="literal">true</span>;<span class="comment">//布尔型(即真假值)b</span></span><br><span class="line"></span><br><span class="line">    cout&lt;&lt;x&lt;&lt;endl;<span class="comment">//输出整数x，endl表示换行</span></span><br><span class="line">    cout&lt;&lt;d&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//输出浮点数d，&#x27;\n&#x27;表示换行,\n换行会更快</span></span><br><span class="line">    cout&lt;&lt;ch&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//输出字符ch</span></span><br><span class="line">    cout&lt;&lt;s&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//输出字符串s</span></span><br><span class="line">    cout&lt;&lt;b&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//输出布尔型b</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;<span class="comment">//函数遇到return会立刻结束。返回0表示main函数正常结束</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><p>输出<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="number">3</span></span><br><span class="line"><span class="number">3.14</span></span><br><span class="line">A</span><br><span class="line">Hello</span><br><span class="line"><span class="number">1</span></span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h3 id="示例代码1（数组）"><a href="#示例代码1（数组）" class="headerlink" title="示例代码1（数组）"></a>示例代码1（数组）</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="comment">//const表示常量，后续不可被修改</span></span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N=<span class="number">1e5</span>+<span class="number">9</span>;</span><br><span class="line"><span class="type">int</span> a[N];<span class="comment">//开一个大小为N的全局数组，下标为[0,N-1]，自动初始化为0（全局变量自动声明）</span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;    </span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="示例代码2-typedef"><a href="#示例代码2-typedef" class="headerlink" title="示例代码2(typedef)"></a>示例代码2(typedef)</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="keyword">typedef</span> <span class="type">long</span> <span class="type">long</span> ll;<span class="comment">//typedef可以给类型起别名，如ll表示long long</span></span><br><span class="line"><span class="comment">//const表示常量，后续不可被修改</span></span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N=<span class="number">1e5</span>+<span class="number">9</span>;</span><br><span class="line"><span class="comment">//开一个大小为N的全局数组(类型为long long)，下标为[0,N-1]，自动初始化为0（全局变量自动声明）</span></span><br><span class="line">ll a[N];</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="示例代码3-字符串"><a href="#示例代码3-字符串" class="headerlink" title="示例代码3(字符串)"></a>示例代码3(字符串)</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">代码</button><button type="button" class="tab">输入输出</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="type">char</span> s[]=<span class="string">&quot;Hello&quot;</span><span class="comment">//长度为5的数组，下标区间为[0,4]</span></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;<span class="number">4</span>;++i)<span class="comment">//数组下标从0开始，for(初始化;结束条件;后语句，一次循环结束执行)</span></span><br><span class="line">    &#123;</span><br><span class="line">        cout&lt;&lt;s[i];<span class="comment">//字符串s中下标为i的元素</span></span><br><span class="line">    &#125;</span><br><span class="line">    cout&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//换行</span></span><br><span class="line">    cout&lt;&lt;s&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//输出s(遇到\0结束)，并换行</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><p>输出<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">Hello</span><br><span class="line">Hello</span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h3 id="示例代码4-交换变量"><a href="#示例代码4-交换变量" class="headerlink" title="示例代码4(交换变量)"></a>示例代码4(交换变量)</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">代码</button><button type="button" class="tab">输入输出</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="type">int</span> a=<span class="number">5</span>,b=<span class="number">3</span>;<span class="comment">//初始化变量a,b</span></span><br><span class="line">    <span class="type">int</span> tmp=b;<span class="comment">//定义临时变量tmp</span></span><br><span class="line">    b=a;<span class="comment">//a的值给b</span></span><br><span class="line">    a=tmp;<span class="comment">//tmp的值给a</span></span><br><span class="line">    cout&lt;&lt;a&lt;&lt;<span class="string">&#x27; &#x27;</span>&lt;&lt;b&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//输出a,b的值</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><p>输出<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="number">3</span> <span class="number">5</span></span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h3 id="示例代码5-判断"><a href="#示例代码5-判断" class="headerlink" title="示例代码5(判断)"></a>示例代码5(判断)</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">代码</button><button type="button" class="tab">输入输出</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="comment">//输出1~n中所有偶数</span></span><br><span class="line">    <span class="type">int</span> n=<span class="number">10</span>;</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;++i)</span><br><span class="line">    &#123;</span><br><span class="line">        <span class="comment">//如果后面不加大括号则仅执行一条语句</span></span><br><span class="line">        <span class="comment">//i%2==0表述i除以2余数为0</span></span><br><span class="line">        <span class="keyword">if</span>(i%<span class="number">2</span>==<span class="number">0</span>)cout&lt;&lt;i&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><p>输出<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="number">2</span></span><br><span class="line"><span class="number">4</span></span><br><span class="line"><span class="number">6</span></span><br><span class="line"><span class="number">8</span></span><br><span class="line"><span class="number">10</span></span><br><span class="line"></span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h2 id="输入输出"><a href="#输入输出" class="headerlink" title="输入输出"></a>输入输出</h2><h3 id="scnanf和printf"><a href="#scnanf和printf" class="headerlink" title="scnanf和printf"></a>scnanf和printf</h3><p>scanf和printf的优势：<br>1.格式化和输出<br>2.效率高<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="type">int</span> a, b;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%d %d&quot;</span>, &amp;a, &amp;b);<span class="comment">//&amp;取址符and；输入2 9</span></span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%d, %d\n&quot;</span>, a, b);<span class="comment">//输出2, 9</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="type">double</span> a, b;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%lf %lf&quot;</span>, &amp;a, &amp;b);<span class="comment">//输入3 5</span></span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%.2f, %.3f\n&quot;</span>, a, b);<span class="comment">//输出3.00, 5.000(自动四舍五入)</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="type">char</span> a, b;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%c %c&quot;</span>, &amp;a, &amp;b);<span class="comment">//输入a b</span></span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%c, %c\n&quot;</span>, a, b);<span class="comment">//输出a, b,\n换行</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">char</span> s[<span class="number">100</span>];</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%s&quot;</span>, s);<span class="comment">//输入abc这里因为本来就是指针形式，所以不用&amp;</span></span><br><span class="line">    <span class="comment">//scanf遇到空格或换行符就停止</span></span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%s\n&quot;</span>, s);<span class="comment">//输出abc</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">char</span> s[<span class="number">15</span>];</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%[^\n]&quot;</span>, s);<span class="comment">//[]中是正则表达式，表示只要不是回车就读入。^上尖号表示排除。\n回车转义字符</span></span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%s\n&quot;</span>, s);<span class="comment">//输出abc</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br>常见类型<br>int <code>%d</code>或<code>%i</code>(少用)<br>double <code>%lf</code><br>char <code>%c</code><br>char[] <code>%s</code><br>string <code>%s</code><br>long long <code>%lld</code></p><h3 id="cin-和-cout"><a href="#cin-和-cout" class="headerlink" title="cin 和 cout"></a>cin 和 cout</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">int</span> a, b;</span><br><span class="line">    cin &gt;&gt; a &gt;&gt; b;<span class="comment">//输入2 9</span></span><br><span class="line">    cout &lt;&lt; a &lt;&lt; <span class="string">&quot; &quot;</span> &lt;&lt; b &lt;&lt; endl;<span class="comment">//输出2 9</span></span><br><span class="line"></span><br><span class="line">    <span class="type">double</span> c,d;</span><br><span class="line">    cin&gt;&gt;c&gt;&gt;d;<span class="comment">//输入3 5</span></span><br><span class="line">    cout&lt;&lt;c&lt;&lt;d;<span class="comment">//输出35</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">double</span> a, b;</span><br><span class="line">    cin &gt;&gt; a &gt;&gt; b;<span class="comment">//输入3 5</span></span><br><span class="line">    cout &lt;&lt; fixed &lt;&lt; <span class="built_in">setprecision</span>(<span class="number">2</span>) &lt;&lt; a &lt;&lt; <span class="string">&quot;, &quot;</span> &lt;&lt; fixed &lt;&lt; <span class="built_in">setprecision</span>(<span class="number">3</span>) &lt;&lt; b &lt;&lt; endl;<span class="comment">//输出3.00, 5.000(自动四舍五入)</span></span><br><span class="line">    <span class="comment">//fixed表示固定小数点，setprecision表示保留几位小数</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">char</span> ch;</span><br><span class="line">    cin &gt;&gt; ch;<span class="comment">//输入a</span></span><br><span class="line">    cout &lt;&lt; ch &lt;&lt; endl;<span class="comment">//输出a</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">char</span> s[<span class="number">10</span>];</span><br><span class="line">    cin &gt;&gt; s;<span class="comment">//输入lan qiao</span></span><br><span class="line">    cout&lt;&lt; s &lt;&lt; endl;<span class="comment">//输出lan,因为遇到空格或回车就停止</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    string s;</span><br><span class="line">    <span class="built_in">getline</span>(cin, s);<span class="comment">//输入lan qiao 这里的避免了cin遇到空格或回车就停止</span></span><br><span class="line">    cout&lt;&lt; s &lt;&lt; endl;<span class="comment">//输出lan qiao</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="取消同步流"><a href="#取消同步流" class="headerlink" title="取消同步流"></a>取消同步流</h3><p>由于cin和cout需要自动判断变量类型等内部原因flash()，读写效率比scanf和printf更低。当数据量较大时，可能导致程序运行超时,我们可以通过取消同步流来加速cin和cout，加速后效率相差无几。<br><code>注意，最好不要cin/cout和scanf/printf混用，防止出问题</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="comment">//取消同步流</span></span><br><span class="line">    ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>), cin.<span class="built_in">tie</span>(<span class="number">0</span>), cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line">    <span class="comment">//其他操作不变</span></span><br><span class="line">    <span class="type">int</span> x;cin&gt;&gt;x;</span><br><span class="line">    cout&lt;&lt;x&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//取消后换行用\n</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h3 id="代码示例1"><a href="#代码示例1" class="headerlink" title="代码示例1"></a>代码示例1</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="keyword">using</span> ll = <span class="type">long</span> <span class="type">long</span>;</span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N = <span class="number">150</span>;</span><br><span class="line"></span><br><span class="line"><span class="type">int</span> a[N];</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="comment">//取消同步流</span></span><br><span class="line">    ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>), cin.<span class="built_in">tie</span>(<span class="number">0</span>), cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line"></span><br><span class="line">    <span class="type">int</span> n;cin&gt;&gt;n;<span class="comment">//输入数组大小</span></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;n;i++) cin&gt;&gt;a[i];<span class="comment">//遍历输入数组元素</span></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;i&lt;n;i++) cout&lt;&lt;a[i]&lt;&lt;<span class="string">&#x27; &#x27;</span>;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">    <span class="comment">// 输入5</span></span><br><span class="line">    <span class="comment">// 1 2 3 4 5</span></span><br><span class="line">    <span class="comment">// 输出5 4 3 2 1</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="代码示例2"><a href="#代码示例2" class="headerlink" title="代码示例2"></a>代码示例2</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="keyword">using</span> ll = <span class="type">long</span> <span class="type">long</span>;</span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N = <span class="number">150</span>;</span><br><span class="line"></span><br><span class="line"><span class="type">int</span> a[N];</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="comment">//取消同步流</span></span><br><span class="line">    ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>), cin.<span class="built_in">tie</span>(<span class="number">0</span>), cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line"></span><br><span class="line">    cin&gt;&gt;s+<span class="number">1</span>;<span class="comment">//从s[1]开始输入</span></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;s[i];++i) cout&lt;&lt;s[i];<span class="comment">//从s[1]开始输出，i=1;中间结束条件是s[i]≠&#x27;\0&#x27;的省略写法</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">    <span class="comment">// 输入lanqiao</span></span><br><span class="line">    <span class="comment">// 输出lanqiao</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="代码示例3"><a href="#代码示例3" class="headerlink" title="代码示例3"></a>代码示例3</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="keyword">using</span> ll = <span class="type">long</span> <span class="type">long</span>;</span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N = <span class="number">150</span>;</span><br><span class="line"></span><br><span class="line"><span class="type">char</span> s[N];</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%s&quot;</span>,s);<span class="comment">//不用取址符号</span></span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">0</span>;s[i];++i) cout&lt;&lt;s[i]&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;<span class="comment">//注意以后不要混用scanf和cin</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">    <span class="comment">// 输入lanqiao</span></span><br><span class="line">    <span class="comment">// 输出l</span></span><br><span class="line">    <span class="comment">// a</span></span><br><span class="line">    <span class="comment">// n</span></span><br><span class="line">    <span class="comment">// q</span></span><br><span class="line">    <span class="comment">// i</span></span><br><span class="line">    <span class="comment">// a</span></span><br><span class="line">    <span class="comment">// o</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="代码示例4"><a href="#代码示例4" class="headerlink" title="代码示例4"></a>代码示例4</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="keyword">using</span> ll = <span class="type">long</span> <span class="type">long</span>;</span><br><span class="line"><span class="type">const</span> <span class="type">int</span> N = <span class="number">150</span>;</span><br><span class="line"></span><br><span class="line"><span class="type">double</span> a[N];</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">int</span> n;<span class="built_in">scanf</span>(<span class="string">&quot;%d&quot;</span>,&amp;n);</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;i++) <span class="built_in">scanf</span>(<span class="string">&quot;%lf&quot;</span>,&amp;a[i]);</span><br><span class="line">    <span class="type">double</span> sum=<span class="number">0</span>;</span><br><span class="line">    <span class="keyword">for</span>(<span class="type">int</span> i=<span class="number">1</span>;i&lt;=n;i++) sum+=a[i];</span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%.2lf&quot;</span>,sum);<span class="comment">//保留两位小数，自动四舍五入</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">    <span class="comment">// 输入5</span></span><br><span class="line">    <span class="comment">//1.0 2.313 6.22 5.47 9.299</span></span><br><span class="line">    <span class="comment">// 输出24.30</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="示例题目"><a href="#示例题目" class="headerlink" title="示例题目"></a>示例题目</h3><p>题目详见<a href="https://www.lanqiao.cn/problems/254/learning/">蓝桥OJ：A+B问题</a><br>在里面好好练习输入输出吧，顺便练习一下取消同步流。</p><h2 id="String的使用"><a href="#String的使用" class="headerlink" title="String的使用"></a>String的使用</h2><h3 id="string简介"><a href="#string简介" class="headerlink" title="string简介"></a>string简介</h3><p>string是C++标准库的重要组成部分，主要用于字符串处理。<br>使用string库需要在头文件中包括该库#include<string><br>string与char[]不同，string实现了高度的封装，可以很方便地完成各种字符串的操作，比如拼接、截取、匹配等等。</p><ol><li>字符串管理:string封装了字符串的存储和管理。它自动处理字符串的内存分配和释放，避免了手动管理内存的麻烦。</li><li>动态大小调整:string可以根据需要自动调整字符串的大小。在添加或删除字符时，string会自动调整内部的存储容量，确保足够的空间来容纳字符串。</li><li>安全性:string提供了一些方法来确保字符串的安全性。例如，它提供了越界访问检查，以避免访问超出字符串范围的字符。</li><li>迭代器支持:string支持迭代器，可以使用迭代器遍历字符串中的字符，进行字符级别的操作。</li><li>兼容性:string是C++标准库的一部分，因此在C++中广泛使用，并且与其他标准库组件和C++语言特性兼容。<h3 id="string的声明与初始化"><a href="#string的声明与初始化" class="headerlink" title="string的声明与初始化"></a>string的声明与初始化</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">代码</button><button type="button" class="tab">输入输出</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;iostream&gt;</span></span></span><br><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;string&gt;</span></span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    <span class="comment">//如果用了using namespace std;则不需要std::</span></span><br><span class="line">    <span class="comment">//声明并初始化一个空字符串</span></span><br><span class="line">    std::string str1;</span><br><span class="line">    <span class="comment">//使用字符串字面量初始化字符串</span></span><br><span class="line">    std::string str2 = <span class="string">&quot;Hello, World!&quot;</span>;</span><br><span class="line">    <span class="comment">//使用另一个string对象来初始化字符串</span></span><br><span class="line">    std::string str3=str2;</span><br><span class="line">    <span class="comment">//使用部分字符串初始化字符串，从第0位开始，选5位</span></span><br><span class="line">    std::string str4 = str2.<span class="built_in">substr</span>(<span class="number">0</span>, <span class="number">5</span>);;</span><br><span class="line">    <span class="comment">//使用字符数组初始化字符串</span></span><br><span class="line">    <span class="type">const</span> <span class="type">char</span>* charArray=<span class="string">&quot;Hello&quot;</span>;</span><br><span class="line">    <span class="function">std::string <span class="title">str5</span><span class="params">(charArrary)</span></span>;</span><br><span class="line">    <span class="comment">//使用重复字符初始化字符串AAAAA</span></span><br><span class="line">    <span class="function">std::string <span class="title">str6</span><span class="params">(<span class="number">5</span>, <span class="string">&#x27;A&#x27;</span>)</span></span>;</span><br><span class="line"></span><br><span class="line">    <span class="comment">//输出</span></span><br><span class="line">    std::cout &lt;&lt; str1 &lt;&lt; std::endl;</span><br><span class="line">    std::cout &lt;&lt; str2 &lt;&lt; std::endl;</span><br><span class="line">    std::cout &lt;&lt; str3 &lt;&lt; std::endl;</span><br><span class="line">    std::cout &lt;&lt; str4 &lt;&lt; std::endl;</span><br><span class="line">    std::cout &lt;&lt; str5 &lt;&lt; std::endl;</span><br><span class="line">    std::cout &lt;&lt; str6 &lt;&lt; std::endl;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><p>输出<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"></span><br><span class="line">Hello, World!</span><br><span class="line">Hello, World!</span><br><span class="line">Hello</span><br><span class="line">Hello</span><br><span class="line">AAAAA</span><br><span class="line"></span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h3 id="string的常用操作0：printf输出字符串"><a href="#string的常用操作0：printf输出字符串" class="headerlink" title="string的常用操作0：printf输出字符串"></a>string的常用操作0：printf输出字符串</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">代码</button><button type="button" class="tab">输入输出</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">    ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>),cin.<span class="built_in">tie</span>(<span class="number">0</span>),cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line">    <span class="type">char</span> buf[<span class="number">100</span>];<span class="comment">//临时变量，用于输入</span></span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%s&quot;</span>,buf);<span class="comment">//输入buf</span></span><br><span class="line">    <span class="function">string <span class="title">str</span><span class="params">(buf)</span></span>;<span class="comment">//用buf构造str</span></span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;str = %s\n&quot;</span>,str.<span class="built_in">c_str</span>());<span class="comment">//输出str</span></span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><p>输入<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">Hello</span><br></pre></td></tr></table></figure><br>输出<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">str = Hello</span><br><span class="line"></span><br></pre></td></tr></table></figure></p></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h3 id="string的常用操作1：获取字符串长度"><a href="#string的常用操作1：获取字符串长度" class="headerlink" title="string的常用操作1：获取字符串长度"></a>string的常用操作1：获取字符串长度</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">std::string str = <span class="string">&quot;Hello, World!&quot;</span>;</span><br><span class="line"><span class="type">int</span> len = str.<span class="built_in">length</span>();<span class="comment">//或者int len = str.size();</span></span><br><span class="line">std::cout &lt;&lt; len &lt;&lt; std::endl;</span><br></pre></td></tr></table></figure><h3 id="string的常用操作2：字符串拼接"><a href="#string的常用操作2：字符串拼接" class="headerlink" title="string的常用操作2：字符串拼接"></a>string的常用操作2：字符串拼接</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">std::string str1 = <span class="string">&quot;Hello, &quot;</span>;</span><br><span class="line">std::string str2 = <span class="string">&quot;World!&quot;</span>;</span><br><span class="line">std::string str3 = str1 + str2;<span class="comment">//使用+运算符</span></span><br><span class="line">std::string str4 = str1.<span class="built_in">append</span>(<span class="string">&quot;,&quot;</span>).<span class="built_in">append</span>(str2);<span class="comment">//使用append函数</span></span><br><span class="line">std::cout &lt;&lt; str3 &lt;&lt; std::endl;</span><br><span class="line">std::cout &lt;&lt; str4 &lt;&lt; std::endl;</span><br></pre></td></tr></table></figure><h3 id="string的常用操作3：字符串查找"><a href="#string的常用操作3：字符串查找" class="headerlink" title="string的常用操作3：字符串查找"></a>string的常用操作3：字符串查找</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line">std::string str = <span class="string">&quot;Hello, World!&quot;</span>;</span><br><span class="line"><span class="type">size_t</span> pos = str.<span class="built_in">find</span>(<span class="string">&quot;World&quot;</span>);<span class="comment">//查找子串&quot;World&quot;在str中的位置</span></span><br><span class="line"><span class="keyword">if</span> (pos != std::string::npos) &#123;<span class="comment">//npos=-1，表示未找到</span></span><br><span class="line">    std::cout &lt;&lt; <span class="string">&quot;Found at position: &quot;</span> &lt;&lt; pos &lt;&lt; std::endl;<span class="comment">//pos目前是等于7的,下标（index）从0开始</span></span><br><span class="line">&#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    std::cout &lt;&lt; <span class="string">&quot;Not found&quot;</span> &lt;&lt; std::endl;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="string的常用操作4：字符串替换"><a href="#string的常用操作4：字符串替换" class="headerlink" title="string的常用操作4：字符串替换"></a>string的常用操作4：字符串替换</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">std::string str = <span class="string">&quot;Hello, World!&quot;</span>;</span><br><span class="line">str.<span class="built_in">replace</span>(<span class="number">7</span>, <span class="number">5</span>, <span class="string">&quot;Universe&quot;</span>);<span class="comment">//将str中从第7个位置开始的5个字符替换为&quot;Universe&quot;</span></span><br><span class="line">std::cout &lt;&lt; str &lt;&lt; std::endl;</span><br></pre></td></tr></table></figure><h3 id="string的常用操作5：字符串截取"><a href="#string的常用操作5：字符串截取" class="headerlink" title="string的常用操作5：字符串截取"></a>string的常用操作5：字符串截取</h3><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">std::string str = <span class="string">&quot;Hello, World!&quot;</span>;</span><br><span class="line">std::string subStr = str.<span class="built_in">substr</span>(<span class="number">7</span>, <span class="number">5</span>);<span class="comment">//从第7个位置开始截取5个字符</span></span><br><span class="line">std::cout &lt;&lt; subStr &lt;&lt; std::endl;</span><br></pre></td></tr></table></figure><h3 id="string的常用操作6：字符串比较"><a href="#string的常用操作6：字符串比较" class="headerlink" title="string的常用操作6：字符串比较"></a>string的常用操作6：字符串比较</h3>string重载了不等号，所以可以直接使用s1 &lt; s2的方式来比较string的大小，比较的规则是按照字典序大小进行比较。<br>字典序的比较方法是从小到大一个一个比较，一旦遇到不相等的字符就确定大小关系。<br>例如:<br>аааа &lt; bььь<br>аzz &lt; baaa<br>aZZZZZZZZZZZZz &lt; b<br>lanqiao == lanqiao<figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line">std::string str1 = <span class="string">&quot;Hello&quot;</span>;</span><br><span class="line">std::string str2 = <span class="string">&quot;World&quot;</span>;</span><br><span class="line"><span class="type">int</span> result = str1.<span class="built_in">compare</span>(str2);<span class="comment">//比较两个字符串的大小</span></span><br><span class="line"><span class="keyword">if</span> (result == <span class="number">0</span>) &#123;</span><br><span class="line">    std::cout &lt;&lt; str1 &lt;&lt; <span class="string">&quot; is equal to &quot;</span> &lt;&lt; str2 &lt;&lt; std::endl;</span><br><span class="line">&#125; <span class="keyword">else</span> <span class="keyword">if</span> (result &lt; <span class="number">0</span>) &#123;</span><br><span class="line">    std::cout &lt;&lt; str1 &lt;&lt; <span class="string">&quot; is less than &quot;</span> &lt;&lt; str2 &lt;&lt; std::endl;</span><br><span class="line">&#125; <span class="keyword">else</span> &#123;</span><br><span class="line">    std::cout &lt;&lt; str1 &lt;&lt; <span class="string">&quot; is less than &quot;</span> &lt;&lt; str2 &lt;&lt; std::endl;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><h3 id="string的常用操作7：字符串遍历"><a href="#string的常用操作7：字符串遍历" class="headerlink" title="string的常用操作7：字符串遍历"></a>string的常用操作7：字符串遍历</h3><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">循环枚举下标</button><button type="button" class="tab">迭代器</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line">string s = <span class="string">&quot;Hello&quot;</span>;</span><br><span class="line"><span class="keyword">for</span> (<span class="type">int</span> i = <span class="number">0</span>; i &lt; s.<span class="built_in">length</span>(); ++i)cout &lt;&lt; s[i];</span><br><span class="line">cout&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line"><span class="keyword">for</span> (<span class="keyword">auto</span> i : s)&#123;</span><br><span class="line">    cout &lt;&lt; i;</span><br><span class="line">    i=<span class="string">&#x27;z&#x27;</span>;<span class="comment">//此处i只是s的拷贝，不是引用，因此修改无效</span></span><br><span class="line">&#125;</span><br><span class="line">cout&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line"><span class="comment">//此时s为&quot;Hello&quot;</span></span><br><span class="line"><span class="keyword">for</span>(<span class="keyword">auto</span> &amp;i : s)&#123;</span><br><span class="line">    cout&lt;&lt;i;</span><br><span class="line">    i=<span class="string">&#x27;a&#x27;</span>;<span class="comment">//此处修改会改变s的值</span></span><br><span class="line">&#125;</span><br><span class="line">cout&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line"><span class="comment">//此时s为&quot;aaaaa&quot;</span></span><br><span class="line">cout&lt;&lt;s&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line">string s = <span class="string">&quot;Hello&quot;</span>;</span><br><span class="line"><span class="keyword">for</span> (<span class="keyword">auto</span> it = s.<span class="built_in">begin</span>(); it != s.<span class="built_in">end</span>(); it++) &#123;</span><br><span class="line">    cout &lt;&lt; *it &lt;&lt; endl;<span class="comment">//利用迭代器依次输出</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h3 id="string练习题：反转字符串中的字符"><a href="#string练习题：反转字符串中的字符" class="headerlink" title="string练习题：反转字符串中的字符"></a>string练习题：反转字符串中的字符</h3>题目详见<a href="https://www.lanqiao.cn/problems/250/learning/">蓝桥OJ:反转字符串中的字符</a><div class="tabs"><div class="nav-tabs"><button type="button" class="tab active">反向输出法</button><button type="button" class="tab">reverse函数</button><button type="button" class="tab">swap函数对半替换</button></div><div class="tab-contents"><div class="tab-item-content active"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">  string s;</span><br><span class="line">  <span class="built_in">getline</span>(cin, s);  <span class="comment">// 用于获取带有空格的字符串</span></span><br><span class="line">  <span class="keyword">for</span> ( <span class="type">int</span> i=s.<span class="built_in">size</span>()<span class="number">-1</span>; i&gt;=<span class="number">0</span>; i-- ) cout &lt;&lt; s[i];  <span class="comment">// 反向输出字符串</span></span><br><span class="line">  <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">  string s;</span><br><span class="line">  <span class="built_in">getline</span>(cin, s);</span><br><span class="line">  <span class="built_in">reverse</span>(s.<span class="built_in">begin</span>(), s.<span class="built_in">end</span>());</span><br><span class="line">  cout &lt;&lt; s;</span><br><span class="line">  <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div><div class="tab-item-content"><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">  string s;</span><br><span class="line">  <span class="built_in">getline</span>(cin, s); </span><br><span class="line">  <span class="keyword">for</span> ( <span class="type">int</span> i=<span class="number">0</span>; i&lt;s.<span class="built_in">size</span>()/<span class="number">2</span>; i++) <span class="built_in">swap</span>(s[i], s[s.<span class="built_in">size</span>()<span class="number">-1</span>-i]); </span><br><span class="line">  cout &lt;&lt; s;</span><br><span class="line">  <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></div></div><div class="tab-to-top"><button type="button" aria-label="scroll to top"><i class="fas fa-arrow-up"></i></button></div></div><h2 id="小作业：妮妮的翻转游戏"><a href="#小作业：妮妮的翻转游戏" class="headerlink" title="小作业：妮妮的翻转游戏"></a>小作业：妮妮的翻转游戏</h2>题目详见<a href="https://www.lanqiao.cn/problems/4983/learning/">蓝桥OJ：妮妮的翻转游戏</a><br>方法很多，这里列举一种。<figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">  ios::<span class="built_in">sync_with_stdio</span>(<span class="number">0</span>), cin.<span class="built_in">tie</span>(<span class="number">0</span>), cout.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line">  <span class="type">int</span> x;</span><br><span class="line">  cin&gt;&gt;x;</span><br><span class="line">  <span class="keyword">if</span>(x)x=<span class="number">0</span>;</span><br><span class="line">  <span class="keyword">else</span> x=<span class="number">1</span>;</span><br><span class="line">  cout&lt;&lt;x&lt;&lt;<span class="string">&#x27;\n&#x27;</span>;</span><br><span class="line">  <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></li></ol>]]>
    </content>
    <id>https://cookiesky.cn/2024/10/07/note-cpp-1/</id>
    <link href="https://cookiesky.cn/2024/10/07/note-cpp-1/"/>
    <published>2024-10-07T03:58:09.000Z</published>
    <summary>蓝桥云课C和C++学习笔记(一)</summary>
    <title>C和C++学习笔记(一)</title>
    <updated>2026-10-18T08:16:45.823Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="教育技术学" scheme="https://cookiesky.cn/categories/%E6%95%99%E8%82%B2%E6%8A%80%E6%9C%AF%E5%AD%A6/"/>
    <category term="GXNU" scheme="https://cookiesky.cn/categories/GXNU/"/>
    <category term="教育技术学" scheme="https://cookiesky.cn/tags/%E6%95%99%E8%82%B2%E6%8A%80%E6%9C%AF%E5%AD%A6/"/>
    <category term="信息学竞赛" scheme="https://cookiesky.cn/tags/%E4%BF%A1%E6%81%AF%E5%AD%A6%E7%AB%9E%E8%B5%9B/"/>
    <category term="C++" scheme="https://cookiesky.cn/tags/C/"/>
    <content>
      <![CDATA[<h1 id="1-新建代码模板"><a href="#1-新建代码模板" class="headerlink" title="1.新建代码模板"></a>1.新建代码模板</h1><p>本次使用C++语言，新建一个代码模板，方便后续使用。在小熊猫工具-代码模板-C++中新建一个代码模板，内容如下：<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span><span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br>如果是蓝桥杯，这里有一些小建议建议你加上：<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span><span class="string">&lt;bits/stdc++.h&gt;</span><span class="comment">//万能头文件</span></span></span><br><span class="line"><span class="meta">#<span class="keyword">define</span> endl <span class="string">&#x27;\n&#x27;</span><span class="comment">//如果改了cin/cout速读速写，这里建议你改为&#x27;\n&#x27;，不然没用。</span></span></span><br><span class="line"><span class="meta">#<span class="keyword">define</span> int long long<span class="comment">//为了防止数据溢出，这里建议你将int改为long long</span></span></span><br><span class="line"><span class="meta">#<span class="keyword">define</span> INF 0x3f3f3f3f3f3f3f3f<span class="comment">//int类型的正无穷</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">void</span> <span class="title">solve</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="comment">//这里写你的代码</span></span><br><span class="line">&#125;</span><br><span class="line"><span class="function"><span class="type">signed</span> <span class="title">main</span><span class="params">()</span></span>&#123;<span class="comment">//signed避免int被改为long long报错，也是int类的</span></span><br><span class="line">    ios::<span class="built_in">sync_with_stdio</span>(<span class="literal">false</span>);</span><br><span class="line">    cin.<span class="built_in">tie</span>(<span class="number">0</span>);</span><br><span class="line">    cout.<span class="built_in">tie</span>(<span class="number">0</span>);<span class="comment">//上面三行修改cin/cout速读速写</span></span><br><span class="line">    <span class="type">int</span> t=<span class="number">1</span>;</span><br><span class="line">    <span class="comment">//cin&gt;&gt;t;</span></span><br><span class="line">    <span class="keyword">while</span>(t--)&#123;</span><br><span class="line">        <span class="built_in">solve</span>();<span class="comment">//蓝桥杯一般是多个测试用例，这里建议你写一个solve函数</span></span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p><h1 id="2-题解基础（一）C-语言"><a href="#2-题解基础（一）C-语言" class="headerlink" title="2.题解基础（一）C++语言"></a>2.题解基础（一）C++语言</h1><h2 id="第一章C-语言入门"><a href="#第一章C-语言入门" class="headerlink" title="第一章C++语言入门"></a>第一章C++语言入门</h2><h3 id="1000：入门测试题目"><a href="#1000：入门测试题目" class="headerlink" title="1000：入门测试题目"></a>1000：入门测试题目</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>求两个整数的和。<br>【输入】<br>一行，两个用空格隔开的整数。<br>【输出】<br>两个整数的和。<br>【输入样例】<br><code>2 3</code><br>【输出样例】<br><code>5</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;stdio.h&gt;</span></span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">int</span> x,y;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%d %d&quot;</span>,&amp;x,&amp;y);</span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%d&quot;</span>,x+y);</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="2060：【例1-1】计算机输出"><a href="#2060：【例1-1】计算机输出" class="headerlink" title="2060：【例1.1】计算机输出"></a>2060：【例1.1】计算机输出</h3><p>打印个helloworld，应该都会吧？</p><h3 id="2061：【例1-2】梯形面积"><a href="#2061：【例1-2】梯形面积" class="headerlink" title="2061：【例1.2】梯形面积"></a>2061：【例1.2】梯形面积</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=2061">2061：【例1.2】梯形面积</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;stdio.h&gt;</span></span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">float</span> area;</span><br><span class="line">    <span class="type">int</span> h;</span><br><span class="line">    h=<span class="number">2</span>*<span class="number">150</span>/<span class="number">15</span>;</span><br><span class="line">    area=(<span class="number">15</span>+<span class="number">25</span>)*h/<span class="number">2</span>;</span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%.2f&quot;</span>,area);</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="2062：【例1-3】电影票"><a href="#2062：【例1-3】电影票" class="headerlink" title="2062：【例1.3】电影票"></a>2062：【例1.3】电影票</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>已知一位小朋友的电影票价是10元，计算x位小朋友的总票价是多少？<br>【输入】<br>输入x。<br>【输出】<br>人数和电影票总价，中间用一个空格隔开。<br>【输入样例】<br><code>2</code><br>【输出样例】<br><code>2 20</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;stdio.h&gt;</span></span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    <span class="type">int</span> x;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%d&quot;</span>,&amp;x);</span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%d %d&quot;</span>,x,x*<span class="number">10</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="2063：【例1-4】牛吃牧草"><a href="#2063：【例1-4】牛吃牧草" class="headerlink" title="2063：【例1.4】牛吃牧草"></a>2063：【例1.4】牛吃牧草</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>有一个牧场，牧场上的牧草每天都在匀速生长，这片牧场可供15头牛吃20天，或可供20头牛吃10天，那么，这片牧场每天新生的草量可供几头牛吃1天？<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;iostream&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span> </span>&#123;</span><br><span class="line">    cout &lt;&lt; (<span class="number">15</span> * <span class="number">20</span> - <span class="number">20</span> * <span class="number">10</span>) / (<span class="number">20</span> - <span class="number">10</span>);</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="1001：Hello-World"><a href="#1001：Hello-World" class="headerlink" title="1001：Hello,World!"></a>1001：Hello,World!</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>编写一个能够输出“<code>Hello,World!</code>”的程序，这个程序常常作为一个初学者接触一门新的编程语言所写的第一个程序，也经常用来测试开发、编译环境是否能够正常工作。<br>提示：“<code>Hello,World!</code>”中间没空格。<br>【输入】<br>无<br>【输出】<br>Hello,World!<br>【输入样例】<br>（无）<br>【输出样例】<br><code>Hello,World!</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span><span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span>&#123;</span><br><span class="line">    cout&lt;&lt;<span class="string">&quot;Hello,World!&quot;</span>;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="1002：输出第二个整数"><a href="#1002：输出第二个整数" class="headerlink" title="1002：输出第二个整数"></a>1002：输出第二个整数</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>输入三个整数，整数之间由一个空格分隔，整数是32位有符号整数。把第二个输入的整数输出。<br>【输入】<br>只有一行，共三个整数，整数之间由一个空格分隔。整数是32位有符号整数。<br>【输出】<br>只有一行，一个整数，即输入的第二个整数。<br>【输入样例】<br><code>123 456 789</code><br>【输出样例】<br><code>456</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;iostream&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span> </span>&#123;</span><br><span class="line"><span class="type">int</span> x,y,z;</span><br><span class="line">cin &gt;&gt; x &gt;&gt; y &gt;&gt; z;</span><br><span class="line">cout &lt;&lt; y;</span><br><span class="line"><span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="1003：对齐输出"><a href="#1003：对齐输出" class="headerlink" title="1003：对齐输出"></a>1003：对齐输出</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>读入三个整数，按每个整数占8个字符的宽度，右对齐输出它们，按照格式要求依次输出三个整数，之间以一个空格分开。<br>【输入】<br>只有一行，包含三个整数，整数之间以一个空格分开。<br>【输出】<br>只有一行，按照格式要求依次输出三个整数，之间以一个空格分开。<br>【输入样例】<br><code>123456789 0 -1</code><br>【输出样例】<br><code>123456789       0      -1</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span><span class="string">&lt;stdio.h&gt;</span></span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line">    <span class="type">int</span> a,b,c;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%d%d%d&quot;</span>,&amp;a,&amp;b,&amp;c);</span><br><span class="line">    <span class="built_in">printf</span>(<span class="string">&quot;%8d %8d %8d&quot;</span>,a,b,c);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="1004：字符三角形"><a href="#1004：字符三角形" class="headerlink" title="1004：字符三角形"></a>1004：字符三角形</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>给定一个字符，用它构造一个底边长5个字符，高3个字符的等腰字符三角形。<br>【输入】<br>输入只有一行，包含一个字符。<br>【输出】<br>该字符构成的等腰三角形，底边长5个字符，高3个字符。<br>【输入样例】<br><em><br>【输出样例】  </em></p><hr><hr><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;stdio.h&gt;</span></span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span> <span class="params">(<span class="type">void</span>)</span></span>&#123; </span><br><span class="line">    <span class="type">char</span> a ;</span><br><span class="line">    <span class="type">int</span> i ,j ;</span><br><span class="line">    <span class="built_in">scanf</span>(<span class="string">&quot;%c&quot;</span>,&amp;a);</span><br><span class="line">    <span class="keyword">for</span>(i=<span class="number">1</span>;i&lt;=<span class="number">3</span>;i++)&#123;</span><br><span class="line">        <span class="keyword">for</span>(j=<span class="number">1</span>;j&lt;=<span class="number">3</span>-i;j++)&#123;</span><br><span class="line">            <span class="built_in">printf</span>(<span class="string">&quot; &quot;</span>);</span><br><span class="line">        &#125;</span><br><span class="line">        <span class="keyword">for</span>(j=<span class="number">1</span>;j&lt;i*<span class="number">2</span>;j++)&#123;</span><br><span class="line">            <span class="built_in">printf</span>(<span class="string">&quot;%c&quot;</span>,a);</span><br><span class="line">        &#125;</span><br><span class="line">        <span class="built_in">printf</span>(<span class="string">&quot;\n&quot;</span>);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>              </div>            </details><h3 id="1005：地球人口承载力估计"><a href="#1005：地球人口承载力估计" class="headerlink" title="1005：地球人口承载力估计"></a>1005：地球人口承载力估计</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>假设地球上的新生资源按恒定速度增长。照此测算，地球上现有资源加上新生资源可供x亿人生活a年，或供y亿人生活b年。为了能够实现可持续发展，避免资源枯竭，地球最多能够养活多少亿人？<br>【输入】<br>一行，包括四个正整数x，a，y，b，两个整数之间用单个空格隔开。x&gt;y，a&lt; b，ax&lt; by，各整数均不大于10000<br>【输出】<br>一个实数z，表示地球最多养活z亿人，舍入到小数点后两位。<br>【输入样例】<br>110 90 90 210<br>【输出样例】<br>75.00<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;iostream&gt;</span></span></span><br><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;algorithm&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="type">int</span> x,a,b,y;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line">cin&gt;&gt;x&gt;&gt;a&gt;&gt;y&gt;&gt;b;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.2lf&quot;</span>,(b*y-a*x)*<span class="number">1.0</span>/(<span class="number">1.0</span>*(b-a)));</span><br><span class="line"><span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h2 id="第二章-顺序结构程序设计"><a href="#第二章-顺序结构程序设计" class="headerlink" title="第二章 顺序结构程序设计"></a>第二章 顺序结构程序设计</h2><h3 id="第一节-运算符和表达式"><a href="#第一节-运算符和表达式" class="headerlink" title="第一节 运算符和表达式"></a>第一节 运算符和表达式</h3><h4 id="2064：【例2-1】交换值"><a href="#2064：【例2-1】交换值" class="headerlink" title="2064：【例2.1】交换值"></a>2064：【例2.1】交换值</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目描述】<br>输入两个正整数a和b，试交换a、b的值（使a的值等于b，b的值等于a）。<br>【输入】<br>输入两个正整数a和b。<br>【输出】<br>输出a与b交换值后的结果。<br>【输入样例】<br><code>2 3</code><br>【输出样例】<br><code>3 2</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a,b,t;</span><br><span class="line">cin &gt;&gt; a &gt;&gt; b;</span><br><span class="line">t=a;a=b;b=t;</span><br><span class="line">cout &lt;&lt; a &lt;&lt; <span class="string">&quot; &quot;</span> &lt;&lt; b;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="2065：【例2-2】整数的和"><a href="#2065：【例2-2】整数的和" class="headerlink" title="2065：【例2.2】整数的和"></a>2065：【例2.2】整数的和</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>求3个整数的和。<br>输入a、b、c这3个整数，求它们的和。<br>【输入】<br>3个整数。<br>【输出】<br>三个数的和。<br>【输入样例】<br><code>1 2 3</code><br>【输出样例】<br><code>6</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a,b,c;</span><br><span class="line">cin&gt;&gt;a&gt;&gt;b&gt;&gt;c;</span><br><span class="line">cout&lt;&lt;a+b+c;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="2066：【例2-3】买图书"><a href="#2066：【例2-3】买图书" class="headerlink" title="2066：【例2.3】买图书"></a>2066：【例2.3】买图书</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>已知小明有n元，他买了一本书，这本书原价为m元，现在打8折出售。求小明还剩多少钱(保留2位小数)。<br>【输入】<br>输入n,m。<br>【输出】<br>小明还剩多少钱(保留2位小数)。<br>【输入样例】<br><code>100 100</code><br>【输出样例】<br><code>20.00</code></p>              </div>            </details><h4 id="1006：A-B问题-同1000做法"><a href="#1006：A-B问题-同1000做法" class="headerlink" title="1006：A+B问题(同1000做法)"></a>1006：A+B问题(同1000做法)</h4><p>这里不再赘述，详情看1000</p><h4 id="1007：计算-a-b-×c的值"><a href="#1007：计算-a-b-×c的值" class="headerlink" title="1007：计算(a+b)×c的值"></a>1007：计算(a+b)×c的值</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>给定3个整数a、b、c，计算表达式(a+b)×c的值。<br>【输入】<br>输入仅一行，包括三个整数a、b、c, 数与数之间以一个空格分开。(－10,000&lt; a,b,c&lt; 10,000)<br>【输出】<br>输出一行，即表达式的值。<br>【输入样例】<br><code>2 3 5</code><br>【输出样例】<br><code>25</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a,b,c;</span><br><span class="line">cin&gt;&gt;a&gt;&gt;b&gt;&gt;c;</span><br><span class="line">cout&lt;&lt;(a+b)*c;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1008：计算-a-b-c的值"><a href="#1008：计算-a-b-c的值" class="headerlink" title="1008：计算(a+b)/c的值"></a>1008：计算(a+b)/c的值</h4><p><code>*</code>改为<code>/</code>即可。</p><h4 id="1009：带余除法"><a href="#1009：带余除法" class="headerlink" title="1009：带余除法"></a>1009：带余除法</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>给定被除数和除数，求整数商及余数。此题中请使用默认的整除和取余运算，无需对结果进行任何特殊处理。<br>【输入】<br>一行，包含两个整数，依次为被除数和除数（除数非零），中间用一个空格隔开。<br>【输出】<br>一行，包含两个整数，依次为整数商和余数，中间用一个空格隔开。<br>【输入样例】<br><code>10 3</code><br>【输出样例】<br><code>3 1</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a,b;</span><br><span class="line">cin&gt;&gt;a&gt;&gt;b;</span><br><span class="line">cout&lt;&lt;a/b&lt;&lt;<span class="string">&quot; &quot;</span>&lt;&lt;a%b;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="1010：计算分数的浮点数值"><a href="#1010：计算分数的浮点数值" class="headerlink" title="1010：计算分数的浮点数值"></a>1010：计算分数的浮点数值</h3><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>两个整数a和b分别作为分子和分母，既分数ab，求它的浮点数值(双精度浮点数，保留小数点后9位)。<br>【输入】<br>输入仅一行，包括两个整数a和b。<br>【输出】<br>输出也仅一行，分数ab的浮点数值（双精度浮点数，保留小数点后9位）。<br>【输入样例】<br><code>5 7</code><br>【输出样例】<br><code>0.714285714</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> a,b;</span><br><span class="line">cin&gt;&gt;a&gt;&gt;b;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.9lf&quot;</span>,a/b);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="第二节-常量和变量"><a href="#第二节-常量和变量" class="headerlink" title="第二节 常量和变量"></a>第二节 常量和变量</h3><h4 id="2067：【例2-5】圆"><a href="#2067：【例2-5】圆" class="headerlink" title="2067：【例2.5】圆"></a>2067：【例2.5】圆</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>输入半径r，输出圆的直径、周长、面积，数与数之间以一个空格分开，每个数保留小数点后4位。<br>【输入】<br>输入半径。<br>【输出】<br>如题述。数与数之间以一个空格分开。<br>【输入样例】<br><code>1.0</code><br>【输出样例】<br><code>2.0000 6.2832 3.1416</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="meta">#<span class="keyword">define</span> pi 3.1415926</span></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> r;</span><br><span class="line">cin&gt;&gt;r;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.4lf %.4lf %.4lf&quot;</span>,<span class="number">2</span>*r,<span class="number">2</span>*pi*r,pi*r*r);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="2068：【例2-6】鸡兔同笼"><a href="#2068：【例2-6】鸡兔同笼" class="headerlink" title="2068：【例2.6】鸡兔同笼"></a>2068：【例2.6】鸡兔同笼</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=2061">2068：【例2.6】鸡兔同笼</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">long</span> <span class="type">long</span> ck,rb,f,h;</span><br><span class="line">cin&gt;&gt;h&gt;&gt;f;</span><br><span class="line">rb=(f<span class="number">-2</span>*h)/<span class="number">2</span>;</span><br><span class="line">ck=h-rb;</span><br><span class="line">cout&lt;&lt;ck&lt;&lt;<span class="string">&quot; &quot;</span>&lt;&lt;rb;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1011：甲流疫情死亡率"><a href="#1011：甲流疫情死亡率" class="headerlink" title="1011：甲流疫情死亡率"></a>1011：甲流疫情死亡率</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>甲流并不可怕，在中国，它的死亡率并不是很高。请根据截止2009年12月22日各省报告的甲流确诊数和死亡数，计算甲流在各省的死亡率。<br>【输入】<br>输入仅一行，有两个整数，第一个为确诊数，第二个为死亡数。<br>【输出】<br>输出仅一行，甲流死亡率，以百分数形式输出，精确到小数点后3位。<br>【输入样例】<br><code>10433 60</code><br>【输出样例】<br><code>0.575%</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> a,b;</span><br><span class="line">cin&gt;&gt;a&gt;&gt;b;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.3lf%%&quot;</span>,b*<span class="number">100</span>/a);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1012：计算多项式的值"><a href="#1012：计算多项式的值" class="headerlink" title="1012：计算多项式的值"></a>1012：计算多项式的值</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>对于多项式f(x)=ax3+bx2+cx+d和给定的a,b,c,d,x，计算f(x)的值，保留到小数点后7位。<br>【输入】<br>输入仅一行，包含5个实数，分别是x，及参数a、b、c、d的值，每个数都是绝对值不超过100的双精度浮点数。数与数之间以一个空格分开。<br>【输出】<br>输出一个实数，即f(x)的值，保留到小数点后位。<br>【输入样例】<br><code>2.31 1.2 2 2 3</code><br>【输出样例】<br><code>33.0838692</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> x,a,b,c,d,ans;</span><br><span class="line">cin&gt;&gt;x&gt;&gt;a&gt;&gt;b&gt;&gt;c&gt;&gt;d;</span><br><span class="line">ans=a*x*x*x+b*x*x+c*x+d;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.7lf&quot;</span>,ans);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1013：温度表达转化"><a href="#1013：温度表达转化" class="headerlink" title="1013：温度表达转化"></a>1013：温度表达转化</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1013">1013：温度表达转化</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> C,F;</span><br><span class="line">cin&gt;&gt;F;</span><br><span class="line">C=<span class="number">5</span>*(F<span class="number">-32</span>)/<span class="number">9</span>;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.5lf&quot;</span>,C);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1014：与圆相关的计算"><a href="#1014：与圆相关的计算" class="headerlink" title="1014：与圆相关的计算"></a>1014：与圆相关的计算</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1014">1014：与圆相关的计算</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> r,pi=<span class="number">3.14159</span>;</span><br><span class="line">cin&gt;&gt;r;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.4lf %.4lf %.4lf&quot;</span>,<span class="number">2</span>*r,<span class="number">2</span>*pi*r,pi*r*r);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1015：计算并联电阻的阻值"><a href="#1015：计算并联电阻的阻值" class="headerlink" title="1015：计算并联电阻的阻值"></a>1015：计算并联电阻的阻值</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1015">1015：计算并联电阻的阻值</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> r1,r2;</span><br><span class="line">cin&gt;&gt;r1&gt;&gt;r2;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.2lf&quot;</span>,<span class="number">1</span>/((<span class="number">1</span>/r1)+(<span class="number">1</span>/r2)));</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="第三节-标准数据类型"><a href="#第三节-标准数据类型" class="headerlink" title="第三节 标准数据类型"></a>第三节 标准数据类型</h3><h4 id="1414：【17NOIP普及组】成绩"><a href="#1414：【17NOIP普及组】成绩" class="headerlink" title="1414：【17NOIP普及组】成绩"></a>1414：【17NOIP普及组】成绩</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1414">1414：【17NOIP普及组】成绩</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a,b,c;</span><br><span class="line">cin&gt;&gt;a&gt;&gt;b&gt;&gt;c;</span><br><span class="line">cout&lt;&lt;a*<span class="number">0.2</span>+b*<span class="number">0.3</span>+c*<span class="number">0.5</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1016：整型数据类型存储空间大小"><a href="#1016：整型数据类型存储空间大小" class="headerlink" title="1016：整型数据类型存储空间大小"></a>1016：整型数据类型存储空间大小</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>分别定义int，short类型的变量各一个，并依次输出它们的存储空间大小(单位：字节)。<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a;</span><br><span class="line"><span class="type">short</span> b;</span><br><span class="line">cout&lt;&lt;<span class="built_in">sizeof</span>(a)&lt;&lt;<span class="string">&quot; &quot;</span>&lt;&lt;<span class="built_in">sizeof</span>(b);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1017：浮点型数据类型存储空间大小"><a href="#1017：浮点型数据类型存储空间大小" class="headerlink" title="1017：浮点型数据类型存储空间大小"></a>1017：浮点型数据类型存储空间大小</h4><p>将1016题代码中的<code>int</code>和<code>short</code>类型改为<code>float</code>和<code>double</code>类型，输出它们的存储空间大小(单位：字节)即可。</p><h4 id="1018：其他数据类型存储空间大小"><a href="#1018：其他数据类型存储空间大小" class="headerlink" title="1018：其他数据类型存储空间大小"></a>1018：其他数据类型存储空间大小</h4><p>将1016题代码中的<code>int</code>和<code>short</code>类型改为<code>bool</code>和<code>char</code>类型，输出它们的存储空间大小(单位：字节)即可。</p><h4 id="1019：浮点数向零舍入"><a href="#1019：浮点数向零舍入" class="headerlink" title="1019：浮点数向零舍入"></a>1019：浮点数向零舍入</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>输入一个单精度浮点数，将其向零舍入到整数。说明：向零舍入的含义是，正数向下舍入，负数向上舍入。提示：可以使用强制类型转换来实现。<br>【输入】<br>一个单精度浮点数。<br>【输出】<br>一个整数，即向零舍入到整数的结果。<br>【输入样例】<br>2.3<br>【输出样例】<br>2<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">float</span> a;</span><br><span class="line">cin&gt;&gt;a;</span><br><span class="line">cout&lt;&lt;<span class="built_in">int</span>(a);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1020：打印ASCII码"><a href="#1020：打印ASCII码" class="headerlink" title="1020：打印ASCII码"></a>1020：打印ASCII码</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1020">1020：打印ASCII码</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">char</span> a;</span><br><span class="line"><span class="built_in">scanf</span>(<span class="string">&quot;%c&quot;</span>,&amp;a);</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%d&quot;</span>,a);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1021：打印字符"><a href="#1021：打印字符" class="headerlink" title="1021：打印字符"></a>1021：打印字符</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1021">1021：打印字符</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a;</span><br><span class="line"><span class="built_in">scanf</span>(<span class="string">&quot;%d&quot;</span>,&amp;a);</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%c&quot;</span>,a);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1022：整型与布尔型的转换"><a href="#1022：整型与布尔型的转换" class="headerlink" title="1022：整型与布尔型的转换"></a>1022：整型与布尔型的转换</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1022">1022：整型与布尔型的转换</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a;</span><br><span class="line"><span class="built_in">scanf</span>(<span class="string">&quot;%d&quot;</span>,&amp;a);</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%d&quot;</span>,<span class="built_in">bool</span>(a));</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br>或<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a;</span><br><span class="line"><span class="type">bool</span> b;</span><br><span class="line">cin&gt;&gt;a;</span><br><span class="line">b=a;</span><br><span class="line">cout&lt;&lt;b;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1023：Hello-World-的大小"><a href="#1023：Hello-World-的大小" class="headerlink" title="1023：Hello,World!的大小"></a>1023：Hello,World!的大小</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1023">1023：Hello,World!的大小</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line">cout&lt;&lt;<span class="built_in">sizeof</span>(<span class="string">&quot;Hello, World!&quot;</span>);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h3 id="第四节-数据输入输出"><a href="#第四节-数据输入输出" class="headerlink" title="第四节 数据输入输出"></a>第四节 数据输入输出</h3><h4 id="1024：保留3位小数的浮点数"><a href="#1024：保留3位小数的浮点数" class="headerlink" title="1024：保留3位小数的浮点数"></a>1024：保留3位小数的浮点数</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1024">1024：保留3位小数的浮点数</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> a;</span><br><span class="line">cin&gt;&gt;a;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.3lf&quot;</span>,a);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1025：保留12位小数的浮点数"><a href="#1025：保留12位小数的浮点数" class="headerlink" title="1025：保留12位小数的浮点数"></a>1025：保留12位小数的浮点数</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1025">1025：保留12位小数的浮点数</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> a;</span><br><span class="line">cin&gt;&gt;a;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%.12lf&quot;</span>,a);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1026：空格分隔输出"><a href="#1026：空格分隔输出" class="headerlink" title="1026：空格分隔输出"></a>1026：空格分隔输出</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1026">1026：空格分隔输出</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">char</span> a;</span><br><span class="line"><span class="type">int</span> b;</span><br><span class="line"><span class="type">float</span> c;</span><br><span class="line"><span class="type">double</span> d;</span><br><span class="line">cin&gt;&gt;a&gt;&gt;b&gt;&gt;c&gt;&gt;d;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%c %d %.6lf %.6lf&quot;</span>,a,b,c,d);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1027：输出浮点数"><a href="#1027：输出浮点数" class="headerlink" title="1027：输出浮点数"></a>1027：输出浮点数</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1027">1027：输出浮点数</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">double</span> a;</span><br><span class="line">cin&gt;&gt;a;</span><br><span class="line"><span class="built_in">printf</span>(<span class="string">&quot;%f\n%.5f\n%e\n%g&quot;</span>,a,a,a,a);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1028：字符菱形"><a href="#1028：字符菱形" class="headerlink" title="1028：字符菱形"></a>1028：字符菱形</h4><p>不太会打印题哇<br><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=1028">1028：字符菱形</a><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line"><span class="type">char</span> c;</span><br><span class="line">cin&gt;&gt;c;</span><br><span class="line"><span class="type">int</span> n = <span class="number">5</span>;<span class="comment">//菱形对角线长度。若要输出任意对角线长度的菱形，则输入该变量。 </span></span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> i = <span class="number">0</span>; i &lt; n; ++i)<span class="comment">//一共有n行</span></span><br><span class="line">&#123;</span><br><span class="line"><span class="type">int</span> sn = <span class="built_in">abs</span>(i - n / <span class="number">2</span>);<span class="comment">//该行前面空格数</span></span><br><span class="line"><span class="type">int</span> en = n - <span class="number">2</span> * sn;<span class="comment">//该行字符个数 </span></span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> j = <span class="number">0</span>; j &lt; sn; ++j)</span><br><span class="line">cout&lt;&lt;<span class="string">&#x27; &#x27;</span>;</span><br><span class="line"><span class="keyword">for</span>(<span class="type">int</span> j = <span class="number">0</span>; j &lt; en; ++j)</span><br><span class="line">cout&lt;&lt;c;</span><br><span class="line">cout&lt;&lt;endl; </span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details></p><h3 id="第五节-顺序结构实例"><a href="#第五节-顺序结构实例" class="headerlink" title="第五节 顺序结构实例"></a>第五节 顺序结构实例</h3><h4 id="2070：【例2-13】数字对调"><a href="#2070：【例2-13】数字对调" class="headerlink" title="2070：【例2.13】数字对调"></a>2070：【例2.13】数字对调</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>题目详见<a href="http://ybt.ssoier.cn:8088/problem_show.php?pid=2070">2070：【例2.13】数字对调</a><br>第一种方法没有考虑0不能作为首位的情况，所以会提交失败<br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a;</span><br><span class="line">cin&gt;&gt;a;</span><br><span class="line">cout&lt;&lt;a%<span class="number">10</span>&lt;&lt;a/<span class="number">10</span>%<span class="number">10</span>&lt;&lt;a/<span class="number">100</span>%<span class="number">10</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span><span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">()</span></span></span><br><span class="line"><span class="function"></span>&#123;</span><br><span class="line"><span class="type">int</span> n, a, b, c;</span><br><span class="line">cin &gt;&gt; n;</span><br><span class="line">a = n%<span class="number">10</span>;<span class="comment">//个位</span></span><br><span class="line">b = n/<span class="number">10</span>%<span class="number">10</span>;<span class="comment">//十位</span></span><br><span class="line">c = n/<span class="number">100</span>;<span class="comment">//百位</span></span><br><span class="line">cout &lt;&lt; a*<span class="number">100</span>+b*<span class="number">10</span>+c;<span class="comment">//如果a是0，那么输出的数字没有百位</span></span><br><span class="line"><span class="keyword">return</span> <span class="number">0</span>;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1031：反向输出一个三位数"><a href="#1031：反向输出一个三位数" class="headerlink" title="1031：反向输出一个三位数"></a>1031：反向输出一个三位数</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>将一个三位数反向输出，例如输入358，反向输出853。<br>【输入】<br>一个三位数n。<br>【输出】<br>反向输出n。<br>【输入样例】<br><code>100</code><br>【输出样例】<br><code>001</code><br><figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> n,g,s,b;</span><br><span class="line">cin&gt;&gt;n;</span><br><span class="line">g=n%<span class="number">10</span>;</span><br><span class="line">s=n/<span class="number">10</span>%<span class="number">10</span>;</span><br><span class="line">b=n/<span class="number">100</span>%<span class="number">10</span>;</span><br><span class="line">cout &lt;&lt; g &lt;&lt; s &lt;&lt; b;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details><h4 id="1035：等差数列末项计算"><a href="#1035：等差数列末项计算" class="headerlink" title="1035：等差数列末项计算"></a>1035：等差数列末项计算</h4><details class="folding-tag" green><summary> 查看本题 </summary>              <div class='content'>              <p>【题目描述】<br>给出一个等差数列的前两项a1，a2，求第n项是多少。<br>【输入】<br>一行，包含三个整数a1，a2，n。−100≤a1,a2≤100，0<n≤1000。【输出】一个整数，即第n项的值。【输入样例】`1 4 100`【输出样例】`298`<figure class="highlight c++"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#<span class="keyword">include</span> <span class="string">&lt;bits/stdc++.h&gt;</span></span></span><br><span class="line"><span class="keyword">using</span> <span class="keyword">namespace</span> std;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="type">int</span> <span class="title">main</span><span class="params">(<span class="type">void</span>)</span></span>&#123;</span><br><span class="line"><span class="type">int</span> a1,a2,n;</span><br><span class="line">cin&gt;&gt;a1&gt;&gt;a2&gt;&gt;n;</span><br><span class="line">cout&lt;&lt;a1+(n<span class="number">-1</span>)*(a2-a1);</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure></p>              </div>            </details>]]>
    </content>
    <id>https://cookiesky.cn/2024/10/02/oier-1/</id>
    <link href="https://cookiesky.cn/2024/10/02/oier-1/"/>
    <published>2024-10-02T15:11:52.000Z</published>
    <summary>信息学与信息学竞赛习题题解</summary>
    <title>信息学与信息学竞赛习题题解(一)</title>
    <updated>2026-10-18T08:16:46.128Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="易语言" scheme="https://cookiesky.cn/categories/%E6%98%93%E8%AF%AD%E8%A8%80/"/>
    <category term="工具" scheme="https://cookiesky.cn/categories/%E5%B7%A5%E5%85%B7/"/>
    <category term="易语言" scheme="https://cookiesky.cn/tags/%E6%98%93%E8%AF%AD%E8%A8%80/"/>
    <category term="工具" scheme="https://cookiesky.cn/tags/%E5%B7%A5%E5%85%B7/"/>
    <category term="黑科技" scheme="https://cookiesky.cn/tags/%E9%BB%91%E7%A7%91%E6%8A%80/"/>
    <content>
      <![CDATA[<h1 id="易语言制作刷屏器"><a href="#易语言制作刷屏器" class="headerlink" title="易语言制作刷屏器"></a>易语言制作刷屏器</h1><p>注意：本文章仅供学习交流，请勿用于非法用途！<br>记得用易语言全选支持库，否则可能代码无法运行</p><ul><li>这个代码还增加了管理员不限速的功能，所以如果需要原始功能，可以自行删除部分代码 <h2 id="窗口界面"><a href="#窗口界面" class="headerlink" title="窗口界面"></a>窗口界面</h2>这里只介绍我们主要功能的界面内容，其余注释等UI、标签可自行添加。</li><li>编辑框（内容框）：用于显示当前鼠标点击的次数</li><li>超级按钮x2（开始、关闭）：用于控制程序开始和关闭</li><li>编辑框（速度框）：用于设置刷屏速度</li><li>透明标签1：用于显示当前刷屏的状态</li><li>时钟1：用于控制刷屏<h2 id="代码"><a href="#代码" class="headerlink" title="代码"></a>代码</h2>因为我这是写在另一个窗口上的，不是启动窗口，所以你可以使用<code>载入（窗口名，，假）</code>然后换行<code>销毁()</code>来调用这个窗口。<h3 id="刷屏器窗口代码"><a href="#刷屏器窗口代码" class="headerlink" title="刷屏器窗口代码"></a>刷屏器窗口代码</h3><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br></pre></td><td class="code"><pre><span class="line">.版本 2</span><br><span class="line">.支持库 eAPI</span><br><span class="line">.支持库 iext</span><br><span class="line"></span><br><span class="line">.程序集 窗口程序集_刷屏器</span><br><span class="line"></span><br><span class="line">.子程序 _刷屏器_创建完毕</span><br><span class="line"></span><br><span class="line"></span><br><span class="line"></span><br><span class="line">.子程序 _时钟1_周期事件</span><br><span class="line"></span><br><span class="line">置剪辑板文本 (内容框.内容)</span><br><span class="line">模拟按键 (#Ctrl键, #V键, )</span><br><span class="line">模拟按键 (#回车键, , )</span><br><span class="line"></span><br><span class="line"></span><br><span class="line">.子程序 _开始_被单击</span><br><span class="line"></span><br><span class="line">.如果 (速度框.内容 ＝ “” 或 速度框.内容 ＝ “请填写速度”)</span><br><span class="line">    速度框.内容 ＝ “1000”</span><br><span class="line"></span><br><span class="line">.否则</span><br><span class="line"></span><br><span class="line">.如果结束</span><br><span class="line">.如果 (管理员 ＝ 假)</span><br><span class="line">    .如果真 (到整数 (速度框.内容) ＜ 700)</span><br><span class="line">        速度框.内容 ＝ “700”</span><br><span class="line">    .如果真结束</span><br><span class="line"></span><br><span class="line">.否则</span><br><span class="line"></span><br><span class="line">.如果结束</span><br><span class="line">时钟1.时钟周期 ＝ 到整数 (速度框.内容)</span><br><span class="line">.如果 (管理员 ＝ 假)</span><br><span class="line">    透明标签1.标题 ＝ “状态：您未激活，最快速度为700，已开始”</span><br><span class="line">.否则</span><br><span class="line">    透明标签1.标题 ＝ “状态：已开始”</span><br><span class="line">.如果结束</span><br><span class="line"></span><br><span class="line"></span><br><span class="line">.子程序 _关闭_被单击</span><br><span class="line"></span><br><span class="line">时钟1.时钟周期 ＝ 0</span><br><span class="line">透明标签1.标题 ＝ “状态：已停止”</span><br><span class="line"></span><br></pre></td></tr></table></figure><h2 id="运行"><a href="#运行" class="headerlink" title="运行"></a>运行</h2>使用方法：输入刷屏内容后点击开始，再点击需要刷屏的软件的输入框<br>刷屏速度：1000为1秒，100为0.1秒，建议最少输入10，否则容易卡顿</li></ul>]]>
    </content>
    <id>https://cookiesky.cn/2024/09/25/EPL-sp/</id>
    <link href="https://cookiesky.cn/2024/09/25/EPL-sp/"/>
    <published>2024-09-24T17:21:27.000Z</published>
    <summary>易语言制作刷屏器</summary>
    <title>易语言制作刷屏器</title>
    <updated>2026-10-18T08:16:39.979Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="易语言" scheme="https://cookiesky.cn/categories/%E6%98%93%E8%AF%AD%E8%A8%80/"/>
    <category term="工具" scheme="https://cookiesky.cn/categories/%E5%B7%A5%E5%85%B7/"/>
    <category term="易语言" scheme="https://cookiesky.cn/tags/%E6%98%93%E8%AF%AD%E8%A8%80/"/>
    <category term="工具" scheme="https://cookiesky.cn/tags/%E5%B7%A5%E5%85%B7/"/>
    <category term="黑科技" scheme="https://cookiesky.cn/tags/%E9%BB%91%E7%A7%91%E6%8A%80/"/>
    <content>
      <![CDATA[<h1 id="易语言制作连点器"><a href="#易语言制作连点器" class="headerlink" title="易语言制作连点器"></a>易语言制作连点器</h1><p>注意：本文章仅供学习交流，请勿用于非法用途！</p><h2 id="窗口界面"><a href="#窗口界面" class="headerlink" title="窗口界面"></a>窗口界面</h2><p>这里只介绍我们主要功能的界面内容，其余注释等UI、标签可自行添加。</p><ul><li>按钮1：点击按钮用于测试是否开启连点。</li><li>编辑框1：用于显示当前连点数量,只读。</li><li>标签3：用于显示当前连点状态。</li><li>时钟1：用于寻找鼠标坐标并模拟点击。</li><li>时钟2：监测按钮是否按下开始连点或关闭连点。<h2 id="代码"><a href="#代码" class="headerlink" title="代码"></a>代码</h2><h3 id="Dll自定义表"><a href="#Dll自定义表" class="headerlink" title="Dll自定义表"></a>Dll自定义表</h3>这里我们需要利用一个dll文件，用于模拟鼠标点击。<figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">.版本 2</span><br><span class="line"></span><br><span class="line">.DLL命令 监视热键, 整数型, , &quot;GetAsyncKeyState&quot;</span><br><span class="line">    .参数 键值, 整数型</span><br><span class="line"></span><br></pre></td></tr></table></figure><h3 id="启动窗口"><a href="#启动窗口" class="headerlink" title="启动窗口"></a>启动窗口</h3><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br></pre></td><td class="code"><pre><span class="line">.版本 2</span><br><span class="line">.支持库 eAPI</span><br><span class="line"></span><br><span class="line">.程序集 窗口程序集_启动窗口</span><br><span class="line">.程序集变量 a, 整数型</span><br><span class="line"></span><br><span class="line">.子程序 __启动窗口_创建完毕</span><br><span class="line"></span><br><span class="line">时钟2.时钟周期 ＝ 1</span><br><span class="line"></span><br><span class="line">.子程序 _时钟2_周期事件</span><br><span class="line"></span><br><span class="line">.如果真 (监视热键 (#F1键) ≠ 0)</span><br><span class="line">    时钟1.时钟周期 ＝ 1</span><br><span class="line">    标签3.标题 ＝ “状态：已开启”</span><br><span class="line">.如果真结束</span><br><span class="line">.如果真 (监视热键 (#F2键) ≠ 0)</span><br><span class="line">    时钟1.时钟周期 ＝ 0</span><br><span class="line">    标签3.标题 ＝ “状态：已关闭”</span><br><span class="line">.如果真结束</span><br><span class="line"></span><br><span class="line"></span><br><span class="line"></span><br><span class="line">.子程序 _时钟1_周期事件</span><br><span class="line"></span><br><span class="line">模拟鼠标点击 (取鼠标水平位置 (), 取鼠标垂直位置 (), )</span><br><span class="line"></span><br><span class="line"></span><br><span class="line">.子程序 _按钮1_被单击</span><br><span class="line"></span><br><span class="line">a ＝ a ＋ 1</span><br><span class="line">编辑框1.内容 ＝ “点击数：” ＋ 到文本 (a)</span><br><span class="line"></span><br><span class="line"></span><br></pre></td></tr></table></figure><h2 id="运行"><a href="#运行" class="headerlink" title="运行"></a>运行</h2>运行只需要使用F1键开启，F2键关闭即可。</li></ul>]]>
    </content>
    <id>https://cookiesky.cn/2024/09/25/EPL-click/</id>
    <link href="https://cookiesky.cn/2024/09/25/EPL-click/"/>
    <published>2024-09-24T17:08:10.000Z</published>
    <summary>易语言制作连点器</summary>
    <title>易语言制作连点器</title>
    <updated>2026-10-18T08:16:39.891Z</updated>
  </entry>
  <entry>
    <author>
      <name>cookiesky</name>
    </author>
    <category term="教育技术学" scheme="https://cookiesky.cn/categories/%E6%95%99%E8%82%B2%E6%8A%80%E6%9C%AF%E5%AD%A6/"/>
    <category term="GXNU" scheme="https://cookiesky.cn/categories/GXNU/"/>
    <category term="教育技术学" scheme="https://cookiesky.cn/tags/%E6%95%99%E8%82%B2%E6%8A%80%E6%9C%AF%E5%AD%A6/"/>
    <category term="Github" scheme="https://cookiesky.cn/tags/Github/"/>
    <category term="Python" scheme="https://cookiesky.cn/tags/Python/"/>
    <content>
      <![CDATA[<h1 id="前言"><a href="#前言" class="headerlink" title="前言"></a>前言</h1><p>最近我们宿舍前任室委书记陈同志参加了软工那边的人工智能基地，入门考核搞了个这个玩意的环境配置。看他抓耳挠腮的样子，于是决定写一下我的配置过程。</p><h1 id="一、anaconda和Visual-Studio安装"><a href="#一、anaconda和Visual-Studio安装" class="headerlink" title="一、anaconda和Visual Studio安装"></a>一、anaconda和Visual Studio安装</h1><p>如果你是python小白，建议使用anaconda安装python环境，省去了很多麻烦。anaconda类似于一个python的集成环境，可以创建各个环境来适配各个项目，方便我们使用。</p><h2 id="1-1-下载"><a href="#1-1-下载" class="headerlink" title="1.1 下载"></a>1.1 下载</h2><p><a href="https://www.anaconda.com/products/distribution">下载链接：https://www.anaconda.com/products/distribution</a></p><h2 id="1-2-安装"><a href="#1-2-安装" class="headerlink" title="1.2 安装"></a>1.2 安装</h2><p>双击运行，一直下一步即可。（如不想安装在C盘，自行选择目录即可）</p><h2 id="1-3-Visual-Studio安装"><a href="#1-3-Visual-Studio安装" class="headerlink" title="1.3 Visual Studio安装"></a>1.3 Visual Studio安装</h2><p><a href="https://visualstudio.microsoft.com/zh-hans/">下载链接：https://visualstudio.microsoft.com/zh-hans/</a></p><h1 id="二、环境配置"><a href="#二、环境配置" class="headerlink" title="二、环境配置"></a>二、环境配置</h1><h2 id="2-1-创建环境"><a href="#2-1-创建环境" class="headerlink" title="2.1 创建环境"></a>2.1 创建环境</h2><p>我给这个项目命名为<code>face_recognition</code>，python版本为3.8。<br>打开终端，输入以下命令：<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">conda create -n face_recognition python=3.8</span><br></pre></td></tr></table></figure></p><h2 id="2-2-激活环境"><a href="#2-2-激活环境" class="headerlink" title="2.2 激活环境"></a>2.2 激活环境</h2><p>以后需要运行这个项目只需要在项目文件夹的终端输入这个命令启动环境即可。<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">conda activate face_recognition</span><br></pre></td></tr></table></figure></p><h2 id="2-3-安装项目依赖"><a href="#2-3-安装项目依赖" class="headerlink" title="2.3 安装项目依赖"></a>2.3 安装项目依赖</h2><p>因为项目文件夹有<code>requirements.txt</code>提示了我们需要下载的库文件，所以在终端输入以下命令：<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">pip install -r requirements.txt</span><br></pre></td></tr></table></figure><br>等待下载完成，发现编辑器中库文件没有报错则为下载完成。</p><h1 id="三、运行项目"><a href="#三、运行项目" class="headerlink" title="三、运行项目"></a>三、运行项目</h1><p>大概流程如图<br><img src="/img/external/dlib-overview.png" alt="流程"></p><h2 id="3-1-运行以及采集人脸"><a href="#3-1-运行以及采集人脸" class="headerlink" title="3.1 运行以及采集人脸"></a>3.1 运行以及采集人脸</h2><div class="tip warning"><p>人脸信息属于《个人信息保护法》规定的<strong>敏感个人信息</strong>。本文仅用于本地环境配置练习：请只采集你本人的照片，或在取得对方明确同意后再采集；不要建立他人人脸库、不要上传到公网服务器、练习结束后及时删除本地图片与 csv 特征文件。</p></div><p><code>注意，python3如果不能运行则改为python。当然你直接在编辑器如vscode或pycharm里点运行也行</code><br>在项目文件夹的终端输入以下命令：<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python3 get_face_from_camera.py</span><br></pre></td></tr></table></figure><br>这个窗口通过键盘来操作，但我不喜欢，我更喜欢下面这个<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python3 get_face_from_camera_tkinter.py</span><br></pre></td></tr></table></figure><br><img src="/img/external/dlib-tkinter.png" alt="tkinter采集人脸"><br>然后确保人脸识别为白色（没有超出拍摄范围）输入你的人脸名字（最好是英文，防止编码问题），然后点拍照即可。<br>输入这个命令是提取人脸特征，提取后会在项目文件夹中生成一个csv文件，这个文件是用于识别的。<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python3 features_extraction_to_csv.py</span><br></pre></td></tr></table></figure></p><h2 id="3-3-识别"><a href="#3-3-识别" class="headerlink" title="3.3 识别"></a>3.3 识别</h2><p>输入这个命令，即可开始识别之前已录入的人脸。<br><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python3 face_reco_from_camera_ot.py</span><br></pre></td></tr></table></figure><br><img src="/img/external/dlib-reco.png" alt="人脸识别"></p><h1 id="四、项目仓库"><a href="#四、项目仓库" class="headerlink" title="四、项目仓库"></a>四、项目仓库</h1><p><a href="https://github.com/coneypo/Dlib_face_recognition_from_camera">项目仓库：https://github.com/coneypo/Dlib_face_recognition_from_camera</a></p>]]>
    </content>
    <id>https://cookiesky.cn/2024/09/21/Dilb-face-recognize/</id>
    <link href="https://cookiesky.cn/2024/09/21/Dilb-face-recognize/"/>
    <published>2024-09-21T04:55:50.000Z</published>
    <summary>Dlib人脸识别python环境配置</summary>
    <title>Dlib人脸识别</title>
    <updated>2026-11-22T14:00:57.250Z</updated>
  </entry>
</feed>
