<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>Origin</title>
  <icon>https://blog.singee.me/icons/favicon.ico</icon>
  <subtitle>Singee&#39;s Blog</subtitle>
  <link href="https://blog.singee.me/atom.xml" rel="self"/>
  <link href="https://pubsubhubbub.appspot.com/" rel="hub"/>
  <link href="https://blog.singee.me/"/>
  <updated>2026-01-24T01:18:00.000Z</updated>
  <id>https://blog.singee.me/</id>
  
  <author>
    <name>Singee</name>
    
  </author>
  
  <generator uri="https://hexo.io/">Hexo</generator>
  
  <entry>
    <title>在 Python 中复现 Race Condition</title>
    <link href="https://blog.singee.me/2026/01/24/2f2f4bee3ed7809a98f1c7fe6bbd1c36/"/>
    <id>https://blog.singee.me/2026/01/24/2f2f4bee3ed7809a98f1c7fe6bbd1c36/</id>
    <published>2026-01-24T01:18:00.000Z</published>
    <updated>2026-01-24T01:18:00.000Z</updated>
    
    <content type="html"><![CDATA[<h2 id="背景"><a href="#背景" class="headerlink" title="背景"></a>背景</h2><p>在学习 Race 或原子操作时，往往会有一个很经典的示例</p><figure class="highlight sql"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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></pre></td><td class="code"><pre><span class="line">#include <span class="operator">&lt;</span>stdio.h<span class="operator">&gt;</span></span><br><span class="line">#include <span class="operator">&lt;</span>stdlib.h<span class="operator">&gt;</span></span><br><span class="line">#include <span class="operator">&lt;</span>errno.h<span class="operator">&gt;</span></span><br><span class="line">#include <span class="operator">&lt;</span>pthread.h<span class="operator">&gt;</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">static</span> long long counter <span class="operator">=</span> <span class="number">0</span>;</span><br><span class="line"><span class="keyword">static</span> long long loops <span class="operator">=</span> <span class="number">0</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">static</span> void <span class="operator">*</span>worker(void <span class="operator">*</span>arg) &#123;</span><br><span class="line">    (void)arg;</span><br><span class="line">    <span class="keyword">for</span> (long long i <span class="operator">=</span> <span class="number">0</span>; i <span class="operator">&lt;</span> loops; i<span class="operator">+</span><span class="operator">+</span>) &#123;</span><br><span class="line">        counter <span class="operator">+</span><span class="operator">=</span> <span class="number">1</span>;  <span class="operator">/</span><span class="operator">/</span> 故意不加锁：会丢更新</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> <span class="keyword">NULL</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">static</span> long long parse_ll(const <span class="type">char</span> <span class="operator">*</span>s, const <span class="type">char</span> <span class="operator">*</span>name) &#123;</span><br><span class="line">    errno <span class="operator">=</span> <span class="number">0</span>;</span><br><span class="line">    <span class="type">char</span> <span class="operator">*</span><span class="keyword">end</span> <span class="operator">=</span> <span class="keyword">NULL</span>;</span><br><span class="line">    long long v <span class="operator">=</span> strtoll(s, <span class="operator">&amp;</span><span class="keyword">end</span>, <span class="number">10</span>);</span><br><span class="line">    if (errno <span class="operator">!=</span> <span class="number">0</span> <span class="operator">||</span> <span class="keyword">end</span> <span class="operator">=</span><span class="operator">=</span> s <span class="operator">||</span> <span class="operator">*</span><span class="keyword">end</span> <span class="operator">!=</span> <span class="string">&#x27;\0&#x27;</span> <span class="operator">||</span> v <span class="operator">&lt;</span> <span class="number">0</span>) &#123;</span><br><span class="line">        fprintf(stderr, &quot;invalid %s: %s\n&quot;, name, s);</span><br><span class="line">        exit(<span class="number">1</span>);</span><br><span class="line">    &#125;</span><br><span class="line">    <span class="keyword">return</span> v;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="type">int</span> main(<span class="type">int</span> argc, <span class="type">char</span> <span class="operator">*</span><span class="operator">*</span>argv) &#123;</span><br><span class="line">    if (argc <span class="operator">!=</span> <span class="number">3</span>) &#123;</span><br><span class="line">        fprintf(stderr, &quot;usage: %s &lt;loops&gt; &lt;threads&gt;\n&quot;, argv[<span class="number">0</span>]);</span><br><span class="line">        <span class="keyword">return</span> <span class="number">1</span>;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    loops <span class="operator">=</span> parse_ll(argv[<span class="number">1</span>], &quot;loops&quot;);</span><br><span class="line">    long long num_threads_ll <span class="operator">=</span> parse_ll(argv[<span class="number">2</span>], &quot;threads&quot;);</span><br><span class="line"></span><br><span class="line">    if (num_threads_ll <span class="operator">&lt;=</span> <span class="number">0</span> <span class="operator">||</span> num_threads_ll <span class="operator">&gt;</span> <span class="number">1000000</span>) &#123;</span><br><span class="line">        fprintf(stderr, &quot;threads out of range: %lld\n&quot;, num_threads_ll);</span><br><span class="line">        <span class="keyword">return</span> <span class="number">1</span>;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    <span class="type">int</span> num_threads <span class="operator">=</span> (<span class="type">int</span>)num_threads_ll;</span><br><span class="line"></span><br><span class="line">    pthread_t <span class="operator">*</span>threads <span class="operator">=</span> (pthread_t <span class="operator">*</span>)malloc(sizeof(pthread_t) <span class="operator">*</span> (size_t)num_threads);</span><br><span class="line">    if (<span class="operator">!</span>threads) &#123;</span><br><span class="line">        perror(&quot;malloc&quot;);</span><br><span class="line">        <span class="keyword">return</span> <span class="number">1</span>;</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    printf(&quot;Initial value: %lld\n&quot;, counter);</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> (<span class="type">int</span> i <span class="operator">=</span> <span class="number">0</span>; i <span class="operator">&lt;</span> num_threads; i<span class="operator">+</span><span class="operator">+</span>) &#123;</span><br><span class="line">        <span class="type">int</span> rc <span class="operator">=</span> pthread_create(<span class="operator">&amp;</span>threads[i], <span class="keyword">NULL</span>, worker, <span class="keyword">NULL</span>);</span><br><span class="line">        if (rc <span class="operator">!=</span> <span class="number">0</span>) &#123;</span><br><span class="line">            fprintf(stderr, &quot;pthread_create failed (rc=%d)\n&quot;, rc);</span><br><span class="line">            <span class="keyword">free</span>(threads);</span><br><span class="line">            <span class="keyword">return</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">for</span> (<span class="type">int</span> i <span class="operator">=</span> <span class="number">0</span>; i <span class="operator">&lt;</span> num_threads; i<span class="operator">+</span><span class="operator">+</span>) &#123;</span><br><span class="line">        pthread_join(threads[i], <span class="keyword">NULL</span>);</span><br><span class="line">    &#125;</span><br><span class="line"></span><br><span class="line">    long long expected <span class="operator">=</span> loops <span class="operator">*</span> num_threads_ll;</span><br><span class="line">    printf(&quot;Expected: %lld\n&quot;, expected);</span><br><span class="line">    printf(&quot;Final value: %lld\n&quot;, counter);</span><br><span class="line">    printf(&quot;Lost updates: %lld\n&quot;, expected <span class="operator">-</span> counter);</span><br><span class="line"></span><br><span class="line">    <span class="keyword">free</span>(threads);</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><br></pre></td></tr></table></figure><p>用 <code>./race 2000 5</code> 来运行它，最终会创建 5 个线程并发对一个全局变量自增，因为这个「自增」操作不是原子的，所以最终的更新结果往往是一个小于 <code>10000</code> 的数字</p><p>但是，如果把这个代码翻译成 Python</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><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></pre></td><td class="code"><pre><span class="line"><span class="keyword">import</span> sys</span><br><span class="line"><span class="keyword">import</span> threading</span><br><span class="line"></span><br><span class="line"></span><br><span class="line">counter = <span class="number">0</span></span><br><span class="line">loops = <span class="number">0</span></span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">worker</span>():</span><br><span class="line">    <span class="keyword">global</span> counter</span><br><span class="line">    <span class="keyword">for</span> _ <span class="keyword">in</span> <span class="built_in">range</span>(loops):</span><br><span class="line">        counter += <span class="number">1</span></span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">main</span>():</span><br><span class="line">    <span class="keyword">global</span> loops</span><br><span class="line"></span><br><span class="line">    <span class="keyword">if</span> <span class="built_in">len</span>(sys.argv) != <span class="number">3</span>:</span><br><span class="line">        <span class="built_in">print</span>(<span class="string">&quot;usage: python race.py &lt;loops&gt; &lt;threads&gt;&quot;</span>, file=sys.stderr)</span><br><span class="line">        sys.exit(<span class="number">1</span>)</span><br><span class="line"></span><br><span class="line">    loops = <span class="built_in">int</span>(sys.argv[<span class="number">1</span>])</span><br><span class="line">    num_threads = <span class="built_in">int</span>(sys.argv[<span class="number">2</span>])</span><br><span class="line"></span><br><span class="line">    threads = []</span><br><span class="line"></span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Initial value:&quot;</span>, counter)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> _ <span class="keyword">in</span> <span class="built_in">range</span>(num_threads):</span><br><span class="line">        t = threading.Thread(target=worker)</span><br><span class="line">        threads.append(t)</span><br><span class="line">        t.start()</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> t <span class="keyword">in</span> threads:</span><br><span class="line">        t.join()</span><br><span class="line"></span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Expected:&quot;</span>, loops * num_threads)</span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Final value:&quot;</span>, counter)</span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Lost updates:&quot;</span>, loops * num_threads - counter)</span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> __name__ == <span class="string">&quot;__main__&quot;</span>:</span><br><span class="line">    main()</span><br></pre></td></tr></table></figure><p>你会发现无论执行 <code>python</code> <a href="http://race.py/"><code>race.py</code></a> <code>2000 5</code> 多少次，最终的结果永远是稳定的 <code>10000</code> —— 竞争消失了</p><h2 id="GIL"><a href="#GIL" class="headerlink" title="GIL"></a>GIL</h2><p>没错，稍有经验的人几乎可以一下子反应过来这是 GIL 的锅！</p><p>Python 3.10 起引入了一个<a href="https://github.com/python/cpython/pull/18334">优化</a>，并不是所有操作都会去进行获取 + 释放 GIL 的操作。而我们想要产生竞态的核心逻辑 <code>[LOAD_GLOBAL counter, LOAD_CONST 1, INPLACE_ADD, STORE_GLOBAL counter]</code> 正好都不在这些 GIL 操作上，因此上述代码看似是两个线程并行，但实际上是分开执行的，所以并没有产生竞争、没有同时读写一个全局变量的情况出现，导致无法复现</p><h2 id="解决办法"><a href="#解决办法" class="headerlink" title="解决办法"></a>解决办法</h2><h3 id="关闭-GIL"><a href="#关闭-GIL" class="headerlink" title="关闭 GIL"></a>关闭 GIL</h3><p>既然它是 GIL 导致的，那我们关了 GIL 不就好了🤔 Python 3.13 起开始有了一个 free-threaded 版本（常称为 <code>python3.13t</code> ），将 GIL 剔除了，所以我们如果直接用这种不含 GIL 的发行版去执行上面的程序，可以发现竞态成功复现了</p><h3 id="引入-GIL-切换"><a href="#引入-GIL-切换" class="headerlink" title="引入 GIL 切换"></a>引入 GIL 切换</h3><p>既然问题出在我们的代码「过于简单」以至于不会给 GIL 释放锁的机会，那我们就手动给它引入释放的机会就好了，最简单方法就是利用「函数返回」—— 我们只需要将 <code>+= 1</code> 替换成一个函数调用即可</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><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">import</span> sys</span><br><span class="line"><span class="keyword">import</span> threading</span><br><span class="line"><span class="keyword">import</span> time</span><br><span class="line"></span><br><span class="line"></span><br><span class="line">counter = <span class="number">0</span></span><br><span class="line">loops = <span class="number">0</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">one</span>():</span><br><span class="line">    <span class="keyword">return</span> <span class="number">1</span></span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">worker</span>():</span><br><span class="line">    <span class="keyword">global</span> counter</span><br><span class="line">    <span class="keyword">for</span> _ <span class="keyword">in</span> <span class="built_in">range</span>(loops):</span><br><span class="line">        counter += one()</span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="keyword">def</span> <span class="title function_">main</span>():</span><br><span class="line">    <span class="keyword">global</span> loops</span><br><span class="line"></span><br><span class="line">    <span class="keyword">if</span> <span class="built_in">len</span>(sys.argv) != <span class="number">3</span>:</span><br><span class="line">        <span class="built_in">print</span>(<span class="string">&quot;usage: python race.py &lt;loops&gt; &lt;threads&gt;&quot;</span>, file=sys.stderr)</span><br><span class="line">        sys.exit(<span class="number">1</span>)</span><br><span class="line"></span><br><span class="line">    loops = <span class="built_in">int</span>(sys.argv[<span class="number">1</span>])</span><br><span class="line">    num_threads = <span class="built_in">int</span>(sys.argv[<span class="number">2</span>])</span><br><span class="line"></span><br><span class="line">    threads = []</span><br><span class="line"></span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Initial value:&quot;</span>, counter)</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> _ <span class="keyword">in</span> <span class="built_in">range</span>(num_threads):</span><br><span class="line">        t = threading.Thread(target=worker)</span><br><span class="line">        threads.append(t)</span><br><span class="line">        t.start()</span><br><span class="line"></span><br><span class="line">    <span class="keyword">for</span> t <span class="keyword">in</span> threads:</span><br><span class="line">        t.join()</span><br><span class="line"></span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Expected:&quot;</span>, loops * num_threads)</span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Final value:&quot;</span>, counter)</span><br><span class="line">    <span class="built_in">print</span>(<span class="string">&quot;Lost updates:&quot;</span>, loops * num_threads - counter)</span><br><span class="line"></span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> __name__ == <span class="string">&quot;__main__&quot;</span>:</span><br><span class="line">    main()</span><br><span class="line"></span><br></pre></td></tr></table></figure><p><code>counter += one()</code> 的指令是 <code>[LOAD_GLOBAL counter, CALL_FUNCTION x, INPLACE_ADD, STORE_GLOBAL counter]</code> ，而其中的 <code>CALL_FUNCTION</code> 会触发 GIL 切换检查，即在读写的过程中给了 GIL 释放锁的机会、允许了竞争</p><blockquote><p>不过注意一点，因为现在 GIL 是 time-based switching，默认要 5ms 才会触发一次线程切换，所以每轮多跑几次，例如用 <code>python</code> <a href="http://race.py/"><code>race.py</code></a> <code>200000 5</code> - 少了的话在现代 CPU 上可能根本来不及满足切换的条件程序就运行完了</p></blockquote><h2 id="参考"><a href="#参考" class="headerlink" title="参考"></a>参考</h2><p><a href="https://www.reddit.com/r/learnprogramming/comments/16mlz4h/race_condition_doesnt_happen_from_python_310/">https://www.reddit.com/r/learnprogramming/comments/16mlz4h/race_condition_doesnt_happen_from_python_310&#x2F;</a></p>]]></content>
    
    
      
      
    <summary type="html">&lt;h2 id=&quot;背景&quot;&gt;&lt;a href=&quot;#背景&quot; class=&quot;headerlink&quot; title=&quot;背景&quot;&gt;&lt;/a&gt;背景&lt;/h2&gt;&lt;p&gt;在学习 Race 或原子操作时，往往会有一个很经典的示例&lt;/p&gt;
&lt;figure class=&quot;highlight sql&quot;&gt;&lt;table&gt;</summary>
      
    
    
    
    
    <category term="Python" scheme="https://blog.singee.me/tags/Python/"/>
    
  </entry>
  
  <entry>
    <title>再看看 SQL 中的 null</title>
    <link href="https://blog.singee.me/2025/10/16/28bf4bee3ed7808382cfe25abbb2140a/"/>
    <id>https://blog.singee.me/2025/10/16/28bf4bee3ed7808382cfe25abbb2140a/</id>
    <published>2025-10-16T05:52:00.000Z</published>
    <updated>2026-01-24T09:21:11.779Z</updated>
    
    <content type="html"><![CDATA[<h3 id="NULL-与任何值的运算结果都是-NULL"><a href="#NULL-与任何值的运算结果都是-NULL" class="headerlink" title="NULL 与任何值的运算结果都是 NULL"></a>NULL 与任何值的运算结果都是 NULL</h3><p>NULL 有一个很重要的特性：NULL 与任何值的运算结果都是 NULL</p><figure class="highlight sql"><table><tr><td class="gutter"><pre><span class="line">1</span><br><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">SELECT</span> <span class="number">1</span> <span class="operator">=</span> <span class="number">1</span>; <span class="comment">-- true</span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="number">1</span> <span class="operator">=</span> <span class="keyword">NULL</span>; <span class="comment">-- null</span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="keyword">NULL</span> <span class="operator">=</span> <span class="keyword">NULL</span>; <span class="comment">-- null</span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="number">1</span> <span class="operator">!=</span> <span class="keyword">NULL</span>; <span class="comment">-- null</span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="keyword">NULL</span> <span class="operator">!=</span> <span class="keyword">NULL</span>; <span class="comment">-- null</span></span><br></pre></td></tr></table></figure><p>这也就意味着，对于存在列 <code>col BOOLEAN NULLABLE</code> 的表，如果一行中 col 列的值为 NULL，则下面的四条查询都不会包含这行</p><figure class="highlight sql"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="operator">=</span> <span class="literal">true</span>;</span><br><span class="line"><span class="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="operator">=</span> <span class="literal">false</span>;</span><br><span class="line"></span><br><span class="line"><span class="comment">-- 但不等于也不会包括值为 null 的行 </span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="operator">!=</span> <span class="literal">true</span>;</span><br><span class="line"><span class="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="operator">!=</span> <span class="literal">false</span>;</span><br></pre></td></tr></table></figure><h3 id="IS-NULL"><a href="#IS-NULL" class="headerlink" title="IS NULL"></a>IS NULL</h3><p>我们其实基本都知道这点，所以我们在进行不等运算时通常会用 <code>IS NULL</code> &#x2F; <code>IS NOT NULL</code> 特殊处理 NULL 列</p><figure class="highlight sql"><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">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="keyword">is</span> <span class="keyword">null</span> <span class="keyword">OR</span> col <span class="operator">!=</span> <span class="literal">true</span>; <span class="comment">-- 筛选 col = null 或 false</span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="keyword">is</span> <span class="keyword">null</span> <span class="keyword">OR</span> col <span class="operator">!=</span> <span class="literal">false</span>; <span class="comment">-- 筛选 col = null 或 true</span></span><br></pre></td></tr></table></figure><h3 id="IS-TRUE-IS-FALSE"><a href="#IS-TRUE-IS-FALSE" class="headerlink" title="IS TRUE &#x2F; IS FALSE"></a>IS TRUE &#x2F; IS FALSE</h3><p>但其实，除了 <code>IS NULL</code>， <code>IS</code> 操作符后面还可以跟随 BOOL 值，那么，用 <code>IS NOT</code> 其实是一个更加精准的不等于操作</p><figure class="highlight sql"><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">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="keyword">IS</span> <span class="keyword">NOT</span> <span class="literal">true</span>; <span class="comment">-- 筛选 col = null 或 false</span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="keyword">IS</span> <span class="keyword">NOT</span> <span class="literal">false</span>; <span class="comment">-- 筛选 col = null 或 true</span></span><br></pre></td></tr></table></figure><p>而对于不是 bool 类型的 nullable 列，我们则可以搭配使用 <code>=</code> <code>!=</code> 与 <code>IS</code></p><figure class="highlight sql"><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">-- 筛选 col = null 或任何不为 1 的值</span></span><br><span class="line"><span class="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="keyword">is</span> <span class="keyword">null</span> <span class="keyword">OR</span> col <span class="operator">!=</span> <span class="number">1</span>;</span><br><span class="line"><span class="keyword">SELECT</span> <span class="operator">*</span> <span class="keyword">FROM</span> &quot;table&quot; <span class="keyword">WHERE</span> col <span class="operator">=</span> <span class="number">1</span> <span class="keyword">IS</span> <span class="keyword">NOT</span> <span class="literal">TRUE</span>; </span><br></pre></td></tr></table></figure><h3 id="concat"><a href="#concat" class="headerlink" title="concat"></a>concat</h3><p>NULL 与任何值的运算结果都是 NULL，但在函数中则不一定（取决于具体实现）</p><p>以连接字符串为例，如果中间存在 NULL，用 <code>||</code> 连接属于运算符，中间任何一项为 NULL 则结果为 NULL，而用 <code>concat</code> 连接则是函数，中间出现的 NULL 会被忽略</p><figure class="highlight sql"><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">SELECT</span> <span class="string">&#x27;hello-&#x27;</span> <span class="operator">||</span> <span class="keyword">NULL</span> <span class="operator">||</span> <span class="string">&#x27;world&#x27;</span>; <span class="comment">-- null</span></span><br><span class="line"><span class="keyword">SELECT</span> concat(<span class="string">&#x27;hello-&#x27;</span>, <span class="keyword">NULL</span>, <span class="string">&#x27;world&#x27;</span>); <span class="comment">-- hello-world</span></span><br></pre></td></tr></table></figure><h3 id="布尔逻辑"><a href="#布尔逻辑" class="headerlink" title="布尔逻辑"></a>布尔逻辑</h3><p>NULL 与任何值的运算结果都是 NULL，但在布尔逻辑中则不一样…… 试试看能不能说出下面的返回值</p><figure class="highlight sql"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">select</span> <span class="keyword">not NULL</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">or</span> <span class="keyword">null</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">and</span> <span class="keyword">null</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">OR</span> <span class="literal">true</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="literal">true</span> <span class="keyword">OR</span> <span class="keyword">null</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">OR</span> <span class="literal">false</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="literal">false</span> <span class="keyword">OR</span> <span class="keyword">null</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">AND</span> <span class="literal">true</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="literal">true</span> <span class="keyword">AND</span> <span class="keyword">null</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">AND</span> <span class="literal">false</span>;</span><br><span class="line"><span class="keyword">select</span> <span class="literal">false</span> <span class="keyword">AND</span> <span class="keyword">null</span>;</span><br></pre></td></tr></table></figure><details>  <summary>答案</summary><figure class="highlight sql"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">select</span> <span class="keyword">not NULL</span>;          <span class="comment">-- NULL</span></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">or</span> <span class="keyword">null</span>;      <span class="comment">-- NULL</span></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">and</span> <span class="keyword">null</span>;     <span class="comment">-- NULL</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">OR</span> <span class="literal">true</span>;      <span class="comment">-- TRUE</span></span><br><span class="line"><span class="keyword">select</span> <span class="literal">true</span> <span class="keyword">OR</span> <span class="keyword">null</span>;      <span class="comment">-- TRUE</span></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">OR</span> <span class="literal">false</span>;     <span class="comment">-- NULL</span></span><br><span class="line"><span class="keyword">select</span> <span class="literal">false</span> <span class="keyword">OR</span> <span class="keyword">null</span>;     <span class="comment">-- NULL</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">AND</span> <span class="literal">true</span>;     <span class="comment">-- NULL</span></span><br><span class="line"><span class="keyword">select</span> <span class="literal">true</span> <span class="keyword">AND</span> <span class="keyword">null</span>;     <span class="comment">-- NULL</span></span><br><span class="line"><span class="keyword">select</span> <span class="keyword">null</span> <span class="keyword">AND</span> <span class="literal">false</span>;    <span class="comment">-- FALSE</span></span><br><span class="line"><span class="keyword">select</span> <span class="literal">false</span> <span class="keyword">AND</span> <span class="keyword">null</span>;    <span class="comment">-- FALSE</span></span><br><span class="line"></span><br></pre></td></tr></table></figure>  </details>其实逻辑在于理解 NULL 代表着「未知」，与「真」「假」一起构成了一个三值集合<p>那么自运算，无论「未知的反面」还是「未知和未知」「未知或未知」都是未知，也因此都是 NULL</p><p>OR 的逻辑则是「有任何一个值为 TRUE 就是 TRUE」，因此，在 NULL 参与的运算中，存在 TRUE 则为 TRUE，不存在 TRUE 则为 NULL（继续未知）</p><p>AND 的逻辑则是「有任何一个值为 FALSE 就是 FALSE」，因此，在 NULL 参与的运算中，存在 FALSE 则为 FALSE，不存在 FALSE 则为 NULL（继续未知）</p><h3 id="在聚合函数中"><a href="#在聚合函数中" class="headerlink" title="在聚合函数中"></a>在聚合函数中</h3><p>在聚合时，如果对 NULL 值进行聚合，它的数值是被完全忽略的 —— 一个例子是 avg，如果对 <code>1, 2, 3, 4, NULL</code> 做 avg，结果是 <code>(1+2+3+4)/4</code></p><p>如果期望给 NULL 在聚合时一个默认值，可以用 <a href="https://www.postgresql.org/docs/current/functions-conditional.html#FUNCTIONS-COALESCE-NVL-IFNULL">coalesce</a> 函数为它赋一个「默认值」</p><h3 id="COALESCE"><a href="#COALESCE" class="headerlink" title="COALESCE"></a>COALESCE</h3><p>上面已经提过 <a href="https://www.postgresql.org/docs/current/functions-conditional.html#FUNCTIONS-COALESCE-NVL-IFNULL">coalesce</a> 函数了，再说一句就是，coalesce 函数可以接受多个参数（而不只是两个），会返回第一个非 NULL 值</p><p>例如用 <code>coalesce(first_name, nickname, email)</code> 取用户「昵称」</p><h3 id="NULLIF"><a href="#NULLIF" class="headerlink" title="NULLIF"></a>NULLIF</h3><p>pg 中还存在一个 <a href="https://www.postgresql.org/docs/current/functions-conditional.html#FUNCTIONS-NULLIF">nullif</a> 函数，接收两个值，如果两个值相等则返回 NULL 否则返回第一个值，等价于 <code>CASE WHEN a = b THEN NULL ELSE a END</code></p><p>这个函数主要用来「将零值转换为空值」；举个例子就是</p><figure class="highlight sql"><table><tr><td class="gutter"><pre><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">SELECT</span> </span><br><span class="line">  <span class="built_in">NULLIF</span>(<span class="built_in">TRIM</span>(name), <span class="string">&#x27;&#x27;</span>) <span class="keyword">AS</span> name,</span><br><span class="line">  <span class="built_in">NULLIF</span>(status, <span class="string">&#x27;N/A&#x27;</span>)  <span class="keyword">AS</span> status</span><br><span class="line"><span class="keyword">FROM</span> t;</span><br></pre></td></tr></table></figure><p>还有就是搭配 NULL 的「可转换为其他类型」的特性</p><figure class="highlight sql"><table><tr><td class="gutter"><pre><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">SELECT</span></span><br><span class="line">  <span class="comment">-- 将 &#x27;&#x27; 直接转换成 date 是会报错的，但是先转换为 NULL 再转换为 date 就可以了</span></span><br><span class="line">  <span class="built_in">NULLIF</span>(col_date, <span class="string">&#x27;&#x27;</span>)::<span class="type">date</span> <span class="keyword">AS</span> <span class="type">date</span></span><br><span class="line"><span class="keyword">FROM</span> t;</span><br></pre></td></tr></table></figure><h3 id="NULL-值在-PostgresQL-协议中的表示"><a href="#NULL-值在-PostgresQL-协议中的表示" class="headerlink" title="NULL 值在 PostgresQL 协议中的表示"></a>NULL 值在 PostgresQL 协议中的表示</h3><p>虽然大概率不会引起混淆，但还是说一下，虽然我们用 <code>psql</code> 规则看到 NULL 值就像是文本一样，但它的底层传输是二进制，PG 规定用 len &#x3D; -1 代表 NULL 值，所以不存在它与空字符串、null 字符串等混淆的情况</p><p>另外，特殊的，在 <code>COPY</code> 中，如果用的 text format（PG 的消息协议中，对于一个值存在 text 和 binary 两种 format），那么会用 <code>\N</code> 代表 NULL 值</p><p>参考：<a href="https://www.postgresql.org/docs/current/protocol-message-formats.html">https://www.postgresql.org/docs/current/protocol-message-formats.html</a> 中的 Query, Parse, Bind, RowDescription, DataRow</p><h3 id="NULL-值在文件系统中的存储"><a href="#NULL-值在文件系统中的存储" class="headerlink" title="NULL 值在文件系统中的存储"></a>NULL 值在文件系统中的存储</h3><p>当行中有任一列值为 NULL 时，「行头」HeapTupleHeaderData 中的 t_infomask 字段内的 HEAP_HASNULL flag 会被标记为 1，此时在行头后面、其余数据前面会增加一个 null bitmap，用位图的形式存储所有列的 NULL 情况，且如果某一列的值为 null，后面的 data 中将不会出现这一列的信息</p><p>另外，null bitmap 除了用来处理 NULL 值，还会用来处理 drop column —— 当一列被删除时其实际上依然存在着，只是后面所有的行都会带有 null bitmap 将这一列标记为 NULL（更事实上，删除列是懒删除，行内的数据都还在，只有下次更新行时才会清理这些数据 —— 当然，清理的方式也是将它标记为 NULL）；</p><p>参考：<a href="https://www.postgresql.org/docs/current/storage-page-layout.html">https://www.postgresql.org/docs/current/storage-page-layout.html</a></p>]]></content>
    
    
      
      
    <summary type="html">&lt;h3 id=&quot;NULL-与任何值的运算结果都是-NULL&quot;&gt;&lt;a href=&quot;#NULL-与任何值的运算结果都是-NULL&quot; class=&quot;headerlink&quot; title=&quot;NULL 与任何值的运算结果都是 NULL&quot;&gt;&lt;/a&gt;NULL 与任何值的运算结果都是 NULL&lt;/</summary>
      
    
    
    
    
    <category term="sql" scheme="https://blog.singee.me/tags/sql/"/>
    
    <category term="postgresql" scheme="https://blog.singee.me/tags/postgresql/"/>
    
  </entry>
  
  <entry>
    <title>迁移 Zeabur 集群</title>
    <link href="https://blog.singee.me/2025/10/06/284f4bee3ed78098a6e3ee6a07968db0/"/>
    <id>https://blog.singee.me/2025/10/06/284f4bee3ed78098a6e3ee6a07968db0/</id>
    <published>2025-10-06T03:12:00.000Z</published>
    <updated>2025-10-06T05:19:00.000Z</updated>
    
    <content type="html"><![CDATA[<p>我之前的 Zeabur 集群是独立跑在一台物理机上的，物理机相比云服务器的劣势之一就是底层存储的数据安全性 —— 云服务器的硬盘通常是由云服务商保证了安全性不同，物理硬盘坏了就是坏了</p><p>而不幸的是，不久前我就遇到了…… 所有数据差点消失，幸亏坏的盘并没有完全坏，以只读方式还能读（只是不能写）算是挽留了我的数据</p><p>但那以后我就一直在思考怎么保证数据安全，经过数个不同的方案研究，我最终的选择是 —— 将整机移动到 PVE 中 然后在 PVE 的底层使用 RAID 1 硬盘</p><p>方案敲定，行动开始 —— 我整个的迁移不太具有可复制性，因此写一篇完整的「迁移指南」确实不太有意义，但中间确确实实遇到了一些小问题，我觉得记录下来还是比较有价值的</p><blockquote><p>💡 我两台机器（原 Zeabur 物理机和新的在 PVE 里面装的虚拟机）：  </p><ol><li>在同一个机房  </li><li>都是用的 RHEL 系的系统  </li><li>内部文件系统都是 LVM + xfs</li></ol></blockquote><h3 id="将-PVE-的硬盘改成-RAID1"><a href="#将-PVE-的硬盘改成-RAID1" class="headerlink" title="将 PVE 的硬盘改成 RAID1"></a>将 PVE 的硬盘改成 RAID1</h3><p>我的 PVE 并不是在安装时就直接做好 RAID1 的，因此保证安全性的第一点是将 PVE 的硬盘改成 RAID1</p><blockquote><p>⚠️ 需要注意的是，RAID 只是冗余，不是备份也无法替代备份  </p><p>这次我的迁移也顺便把备份加上了，但备份又是一个较大的话题，因此本文不会写备份相关的内容，如果未来有机会我会单独写一篇文章，不过可以顺便说一嘴的是，我选用的备份方案是 Velero</p></blockquote><p>我没有阵列卡，那么硬盘改 RAID 就只能是通过软 RAID 来组，在 Linux 下组软 RAID 有两种办法，一是利用 mdadm 组 RAID，另一种则是用 lvm 组 RAID；二者各有优劣，我为了灵活性选择了 lvm 的方案 —— 我现在是 2 块 1TB 的硬盘，使用 lvm 的话后面扩容可以很方便的通过加 1 块 2TB 的硬盘来得到完整的 2TB 可用 RAID1 空间，而如果不用 lvm 虽然也能实现但相对来说更加麻烦，且有难以避免的 degrade 时段</p><p>哦对，还有，做冗余不能只将数据做冗余，也要考虑引导，都是老步骤，复制下 ELF 分区、重做下 grub 引导，没什么值得说的，有什么问题问问 ChatGPT 它应该能相当完美的回答。</p><p>假设我们现在的环境是：原有的数据卷 <code>/dev/sda3</code>、原有的 VG <code>pve</code>、原有的 LV <code>pve/root</code> <code>/pve/swap</code> <code>pve/data</code>、新的数据卷 <code>/dev/sdb3</code></p><p>首先将新的数据卷转换为 PV <code>pvcreate /dev/sdb3</code> 然后将它加入至 VG <code>vgextend pve /dev/sdb3</code></p><p>将 <code>pve/root</code> 转换为 RAID1 十分简单：一行命令 <code>lvconvert --type raid1 -m1 pve/root /dev/sda3 /dev/sdb3</code> 搞定</p><p><code>pve/swap</code> 是个 swap 分区，没有做 RAID1 的必要，我们跳过</p><p>难点来到了 <code>pve/data</code> 这个逻辑卷 —— 它不是一个普通的 LV 而是一个 Thin Pool，如果我们直接执行 <code>lvconvert --type raid1 -m1 pve/data /dev/sda3 /dev/sdb3</code> LVM 会报错 Operation not permitted on LV pve&#x2F;data type thinpool.</p><p>可以认为 Thin Pool 是一个「逻辑逻辑卷」，它事实上分成了 meta 和 data 两部分（通过 <code>lvs -a</code> 命令可以看到，它是用 <code>pve/data_tmeta</code> 和 <code>pve/data_tdata</code> 组合而成的），所以我们说是对它做 RAID1 但事实上想做的是对它底层依赖的 meta 和 data 做 RAID1 —— 这样，Thin Pool 本身和从这个 Thin Pool 所分配出去的子 LV 也都是 RAID1 了。</p><p>所以我们要做的是，将它的底层数据卷转换为 RAID1 即可：</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">lvconvert --type raid1 -m1 pve/data_tmeta /dev/sda3 /dev/sdb3</span><br><span class="line">lvconvert --type raid1 -m1 pve/data_tdata /dev/sda3 /dev/sdb3</span><br></pre></td></tr></table></figure><p>然后等待 <code>lvs -a</code> 的输出中 Cpy%Sync 列变为 100% 即为 RAID 转换完成。</p><p>哦对，还有一件事情，虽然示例中我用的另一块盘也是 SATA 盘做例子，但事实上我的另一块盘是 NVME 的，因此我上面说的「<code>pve/swap</code> 不用做 RAID1」之外，我其实还将 <code>pve/swap</code> 给移动到了新的盘上</p><p>将 LV 从一个 PV 移动到另一个 PV 的命令：<code>pvmove -n pve/swap /dev/sda3 /dev/nvme0n1p3</code></p><h3 id="迁移方案的选择"><a href="#迁移方案的选择" class="headerlink" title="迁移方案的选择"></a>迁移方案的选择</h3><p>物理机迁移到 PVE 最直接的方法就是直接做整盘磁盘镜像然后导入，这种方案没什么可说的，也是最简单的</p><p>但是基于下面几个原因</p><ol><li>我想换个系统，原来的系统是 CentOS Stream，嗯…… 不太适合一个稳定的环境使用</li><li>原来的系统在装 Zeabur 之前还装了一些别的东西，现在已经不需要了</li><li>我所有有价值的数据全都在 k3s 里面了，其实只要迁移 k3s 数据就行，而且我也想试试到底怎么迁移下集群，都要迁移哪些数据</li><li>我讨厌 Live CD 带的 Bash 的体验，特别是我可能还得用 IPMI 的 Remote Console 而不是自己的本地终端 SSH 过去</li><li>我原来其实也不是一块硬盘，而是两块硬盘组的 LVM 卷，两块盘都有数据，整盘迁移还得在 live cd 版系统里面折腾下加载 LVM</li><li>我原来物理机的启动用的 UEFI，但新的跑在虚拟机里面的引导用的 BIOS</li><li>整机迁移我也得迁移完去 PVE 里面改各种网卡、硬盘的映射什么的，也不容易</li><li>嗯…… 我没有一块多余的足够大的盘让我存这么大的磁盘镜像了 &#x3D; &#x3D;</li></ol><p>我最后放弃了整盘迁移的方案，而是选择 rsync 拷贝 k3s 相关的数据：</p><ol><li>在 Zeabur 中添加一个新的 Dedicated Server 让它为我们安装 k3s 的相关内容</li><li>安装好以后，执行 <code>/usr/local/bin/k3s-killall.sh</code> 停止整个集群、删除给 zeabur 用的 ssh key、在 zeabur 中删除这个服务器</li><li>利用 rsync 拷贝所有集群需要的数据</li><li>启动 k3s 服务，耐心等待它把原来所有的镜像下好</li><li>登录 zeabur 面板，执行一次 Reinstall Zeabur Service</li></ol><h3 id="将-ufw-换成-firewalld"><a href="#将-ufw-换成-firewalld" class="headerlink" title="将 ufw 换成 firewalld"></a>将 ufw 换成 firewalld</h3><p>我之前使用的防火墙时 ufw，它简单易用，但有一个非常重要的缺陷：只要 k8s 暴露的端口，它没办法阻止</p><p>因此，趁着这次，换回 firewalld 了；根据 Zeabur 的<a href="https://zeabur.com/docs/en-US/dedicated-server/register#prerequisites">说明</a>和 k3s <a href="https://docs.k3s.io/installation/requirements?_highlight=firewall#operating-systems">文档</a>，需要执行下面的内容放行相关流量</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><span class="line">12</span><br><span class="line">13</span><br></pre></td><td class="code"><pre><span class="line">firewall-cmd --permanent --zone=public --add-service=ssh    <span class="comment"># 22</span></span><br><span class="line">firewall-cmd --permanent --zone=public --add-service=http   <span class="comment"># 80</span></span><br><span class="line">firewall-cmd --permanent --zone=public --add-service=https  <span class="comment"># 443</span></span><br><span class="line"></span><br><span class="line">firewall-cmd --permanent --zone=public --add-port=4222/tcp</span><br><span class="line">firewall-cmd --permanent --zone=public --add-port=6443/tcp</span><br><span class="line">firewall-cmd --permanent --zone=public --add-port=30000-32767/tcp</span><br><span class="line">firewall-cmd --permanent --zone=public --add-port=30000-32767/udp</span><br><span class="line"></span><br><span class="line">firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16</span><br><span class="line">firewall-cmd --permanent --zone=trusted --add-source=10.43.0.0/16</span><br><span class="line"></span><br><span class="line">firewall-cmd --reload</span><br></pre></td></tr></table></figure><p>注：我个人不建议放开 30000-32767 —— 我询问过 Zeabur 支持人员，不放开这些端口不会影响 Zeabur 本身的能力，只是非 http 类型的端口映射无法被访问。Zeabur 会默认将所有端口都暴露到公网，部分端口所对应的服务可能有安全问题，所以我的建议是不要添加 <code>30000-32767</code> 两台规则，而仅在确实需要访问映射的端口时再添加</p><p>注 2：如果你是基于你自己需要的目的去访问内部服务（如数据库、Redis），我非常不建议你将这些服务暴露到公网，而是应当使用 <a href="https://zeabur.com/templates/ZL5OKK?referralCode=ImSingee">zproxy</a> 通过代理访问这些内部服务（当然，你需要将 zproxy 本身使用的端口放开）</p><h3 id="不停机更换-IP"><a href="#不停机更换-IP" class="headerlink" title="不停机更换 IP"></a>不停机更换 IP</h3><p>zeabur 和 k3s 本身对于「本机 IP 」有一定的偏好，如果要改的话比较麻烦，所以简单起见，我的选择是：</p><p>假设原机器 IP 1.1.1.1，现在新的机器 IP 2.2.2.2，我将两个机器的 IP 对调下就好了</p><p>云主机换个 IP 轻轻松松，物理机换个 IP 就很麻烦，特别是远程物理机换 IP（好吧，其实可以直接登录 IPMI 在 Remote console 里面改 IP 的，但我们当这个不存在）</p><p>不过挺好的一点是，我可以通过引入一个新的临时 IP 让这两台机器都不离线的情况下对调下 IP</p><blockquote><p>💡 我这两台机器在同一个内网、网关相同、DNS 相同，都是手动指定的 IP 没有使用 DHCP  </p><p>假设两台机器的网卡都是 eno1、临时 IP 是 3.3.3.3</p></blockquote><p>流程是：</p><ol><li>虽然和换 IP 的流程没关系，但是建议先执行 <code>/usr/local/bin/k3s-killall.sh</code> 把整个机器的 k3s 停掉</li><li>在原机器（1.1.1.1）执行 <code>nmcli con mod eno1 +ipv4.addresses &quot;3.3.3.3/24&quot; &amp;&amp; nmcli dev reapply eno1</code>  让这个机器有 1.1.1.1 和 3.3.3.3 两个 IP</li><li>通过 3.3.3.3 登录原机器（1.1.1.1 + 3.3.3.3），执行 <code>nmcli con mod eno1 -ipv4.addresses &quot;1.1.1.1/24&quot; &amp;&amp; nmcli dev reapply eno1</code> 让这台机器只剩下 3.3.3.3 一个 IP</li><li>登录新机器（2.2.2.2）执行 <code>nmcli con mod eno1 +ipv4.addresses &quot;1.1.1.1/24&quot; &amp;&amp; nmcli dev reapply eno1</code>  让这个机器有 1.1.1.1 和 2.2.2.2 两个 IP</li><li>通过 1.1.1.1 登录新机器（2.2.2.2 + 1.1.1.1）执行 <code>nmcli con mod eno1 -ipv4.addresses &quot;2.2.2.2/24&quot; &amp;&amp; nmcli dev reapply eno1</code> 让这台机器只剩下 1.1.1.1 一个 IP</li><li>通过 3.3.3.3 登录原机器，执行 <code>nmcli con mod eno1 +ipv4.addresses &quot;2.2.2.2/24&quot; &amp;&amp; nmcli dev reapply eno1</code>  让这个机器有 2.2.2.2 和 3.3.3.3 两个 IP</li><li>通过 2.2.2.2 登录原机器（2.2.2.2 + 3.3.3.3）执行 <code>nmcli con mod eno1 -ipv4.addresses &quot;3.3.3.3/24&quot; &amp;&amp; nmcli dev reapply eno1</code> 让这台机器只剩下 2.2.2.2 一个 IP</li><li>好了，现在原机器 IP 变成了 2.2.2.2、新机器 IP 则变成了 1.1.1.1 —— 对调完成</li></ol><p>🤷 显得繁琐了点，但其实不难</p><h3 id="利用-rsync-迁移数据"><a href="#利用-rsync-迁移数据" class="headerlink" title="利用 rsync 迁移数据"></a>利用 rsync 迁移数据</h3><p>主要有两部分的信息我们需要迁移</p><ul><li>Zeabur 连接集群所用的 SSH 凭据</li><li>集群本身的各种配置、数据</li></ul><p>我们需要用 rsync 同步下面的文件&#x2F;目录到新的集群：</p><ul><li><code>/etc/rancher/k3s</code> k3s 配置及连接集群的凭证</li><li><code>/var/lib/rancher/k3s/server/db/</code> k3s 数据库</li><li><code>/var/lib/rancher/k3s/server/token</code> k3s 内部授权 token</li><li><code>/var/lib/rancher/k3s/storage</code> 使用的 local volume 的存储路径</li></ul><p>同步时使用的命令为（在原机器上执行）</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">P=/etc/rancher/k3s <span class="comment"># 依次使用上面所需要同步的路径</span></span><br><span class="line">NEW=2.2.2.2        <span class="comment"># 新机器的 IP 地址</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># 同步数据</span></span><br><span class="line">rsync -aHAX --numeric-ids --info=progress2 \</span><br><span class="line">  --delete --delete-delay \</span><br><span class="line">  <span class="variable">$P</span> \</span><br><span class="line">  root@<span class="variable">$NEW</span>:<span class="variable">$P</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># 恢复 SELinux 属性（如果需要的话）</span></span><br><span class="line">ssh root@<span class="variable">$NEW</span> <span class="string">&quot;restorecon -RF <span class="variable">$P</span> || true&quot;</span></span><br></pre></td></tr></table></figure><p>在启动前，删掉下面的目录（k3s 启动时会自动重新创建）</p><ul><li><code>/var/lib/rancher/k3s/server/cred</code></li><li><code>/var/lib/rancher/k3s/server/tls</code></li></ul><h3 id="合并卷容量"><a href="#合并卷容量" class="headerlink" title="合并卷容量"></a>合并卷容量</h3><p>我为虚拟机分配了 512GB 的硬盘，但我没想到的是我使用的 Automatic Disk Partition 竟然将绝大多数空间给了 <code>/home</code> 导致我迁移数据一半告诉我没空间了 &#x3D; &#x3D;</p><p>幸好，虽然这个奇怪的硬盘分区有点烦人，但 RHEL 系一律使用 LVM —— 它也只是个 LV 而已！简简单单，删掉这个 LV 把空间匀给 root 就好了</p><p>对了，删除 <code>/home</code> 挂载点要记得改 <code>/etc/fstab</code>，不然下次系统可能启动不起来</p><h3 id="更新-node"><a href="#更新-node" class="headerlink" title="更新 node"></a>更新 node</h3><p>因为 Zeabur 不允许同一个 IP 有两个 Dedicated Server 出现，所以安装的过程中是使用了一个新的 IP 装的</p><p>在迁移完，如果想用回原来的 IP，需要修改 <code>/etc/systemd/system/k3s.service.env</code> 文件里面的 <code>K3S_NODE_NAME</code></p><p>然后启动起来看看 <code>kubectl get nodes</code>，如果还有原来的 IP 的 Node，删了就好</p><h3 id="Pod-扩容"><a href="#Pod-扩容" class="headerlink" title="Pod 扩容"></a>Pod 扩容</h3><p>我数据迁移完一启动各种飙红，仔细一看原来是 Pod 数量超限（默认 110），需要修改 kubelet 配置</p><p>在 <code>/var/lib/rancher/k3s/agent/etc/kubelet.conf.d</code> 目录下，创建一个 <code>01-max-pods.conf</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></pre></td><td class="code"><pre><span class="line"><span class="attr">apiVersion:</span> <span class="string">kubelet.config.k8s.io/v1beta1</span></span><br><span class="line"><span class="attr">kind:</span> <span class="string">KubeletConfiguration</span></span><br><span class="line"><span class="attr">maxPods:</span> <span class="number">1000</span></span><br></pre></td></tr></table></figure><p>然后执行 <code>systemctl restart k3s</code> 就好</p><p>哦对，这个其实我之前就改过，但是迁移的时候漏了，你可以看看原来机器的 <code>/var/lib/rancher/k3s/agent/etc/kubelet.conf.d</code> 目录下有没有除了 <code>00-k3s-defaults.conf</code> 以外的文件，有的话最好前面 rsync 的时候直接一起迁移了，省事</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;我之前的 Zeabur 集群是独立跑在一台物理机上的，物理机相比云服务器的劣势之一就是底层存储的数据安全性 —— 云服务器的硬盘通常是由云服务商保证了安全性不同，物理硬盘坏了就是坏了&lt;/p&gt;
&lt;p&gt;而不幸的是，不久前我就遇到了…… 所有数据差点消失，幸亏坏的盘并没有完全坏，</summary>
      
    
    
    
    
    <category term="infra" scheme="https://blog.singee.me/tags/infra/"/>
    
  </entry>
  
  <entry>
    <title>2025Q3 订阅 Recap</title>
    <link href="https://blog.singee.me/2025/09/19/273f4bee3ed7802bb5cbd0be20aa7dea/"/>
    <id>https://blog.singee.me/2025/09/19/273f4bee3ed7802bb5cbd0be20aa7dea/</id>
    <published>2025-09-19T00:27:00.000Z</published>
    <updated>2025-09-27T22:21:00.000Z</updated>
    
    <content type="html"><![CDATA[<h2 id="现存订阅"><a href="#现存订阅" class="headerlink" title="现存订阅"></a>现存订阅</h2><h3 id="ChatGPT-Plus"><a href="#ChatGPT-Plus" class="headerlink" title="ChatGPT Plus"></a>ChatGPT Plus</h3><p>ChatGPT 目前已经成了我的长期订阅选择</p><p>一方面，GPT-5（和原来的 o3）体验确实好，可以在思考的过程去搜索、执行代码简直是王炸</p><p>另一方面，Codex 写代码是真的强，绝大多数能力已经能超过 Claude 了，只有 Codex 软件本身的用户体验差了一点</p><p>还有一点，Codex 自带 PR 代码审查！而且是完全免费的，完全可以替代掉 Code Rabbit &#x2F; Cursor 之类的产品了</p><p>这一切只要 $20 真的很值</p><h3 id="Proton-Visionary"><a href="#Proton-Visionary" class="headerlink" title="Proton Visionary"></a>Proton Visionary</h3><p>Proton Visionary 依然在我的订阅列表中</p><p>但我已经越来越少用它了，目前没有退订一方面这东西退订需要 Deactivate 邮件地址。。另一方面则是我的上古版 Visionary 价格太香了（现在退了再买差不多涨价了得有 70%）</p><p>目前我已经停用了绝大多数 Proton 的组件，只在使用 <a href="https://simplelogin.io/">SimpleLogin</a> 和 Mail。</p><p>btw，如果你也在用 Proton Mail 但是不想用它的官方客户端（官方客户端实在太难用了，改版前难用，改版后不但难用 bug 还多）可以考虑各种第三方邮件客户端 + <a href="https://github.com/ImSingee/protonmail-bridge-docker">protonmail-bridge-docker</a> 方案</p><p>AD：Proton Visionary 可以分享给他人加入，如果你想加入我的家庭组请发邮件给我 <a href="mailto:singee@proton.me">singee@proton.me</a>，价格为 92 天 ¥109</p><h3 id="Cursor-Pro"><a href="#Cursor-Pro" class="headerlink" title="Cursor Pro"></a>Cursor Pro</h3><p>没错，我依然订阅着 Cursor 🤔 Cursor 在折腾它的 plan 把自己折腾的残废的情况下，我依然在订阅着它😂</p><p>首先一点，Cursor Tab 是真的强，市面上没有对手。我最初就是完全因为 Tab 而订阅的 Cursor，而现在也经常用它来修一些 AI 搞不定的复杂逻辑。</p><p>另外，看似 Cursor 涨价了，但作为老用户还能继续享受一个月 500 次（Opt out of new pricing）。而现在的 500 次是不再限制 20 个工具调用的 500 次，比 max 只差在了 context 长度上（但我基本都会拆分好任务再给 AI，达到 200k 的次数屈指可数 —— 而且就算达到了 Cursor 也会自动 compact），所以整体依然很香（至少在强制 usage-based billing 之前很香😂）</p><h3 id="lisa-host"><a href="#lisa-host" class="headerlink" title="lisa host"></a>lisa host</h3><p>在 AI 时代，一个独享的家宽 IP 可能已经是想流畅使用各种服务的必备品了；之前的 IP Royal 虽然便宜但是质量真的不敢说好，目前换成了 lisa，相当棒</p><p>AD：要购买欢迎使用我的推广链接 <a href="https://lisahost.com/aff.php?aff=3372">https://lisahost.com/aff.php?aff=3372</a> </p><h3 id="Dler-Cloud-Diamond"><a href="#Dler-Cloud-Diamond" class="headerlink" title="Dler Cloud Diamond"></a><strong>Dler Cloud Diamond</strong></h3><p>Dler 的服务我觉得已经回到了原来的水平，所以我目前也回到了 Diamond Plan，我觉得目前它又一次成为了我心目中的第一（至少比某 N 家强 emm）</p><h3 id="iximiuz-labs-Lifetime"><a href="#iximiuz-labs-Lifetime" class="headerlink" title="iximiuz labs Lifetime"></a><strong>iximiuz labs Lifetime</strong></h3><p>曾经我是 Premium 订阅，在今年中升级到了 Lifetime</p><p>对于想学习 k8s、网络、Linux 的，很推荐这个平台，Learn by doing 的形式，边学习边实践还有对应的测试，绝对比单纯看某些文档&#x2F;博客更适合学习</p><p>而且，在过去一年的更新中，iximiuz labs 增加了不少新功能，对我最重要的就是自定义 Playground —— 想学习&#x2F;体验下什么产品，可以快速创建一个去测试，而且多机器的设计也可以自由去测试集群相关功能。</p><h3 id="其他"><a href="#其他" class="headerlink" title="其他"></a>其他</h3><p>还有一些仍然在订阅的，但与<a href="https://blog.singee.me/2024/10/17/122f4bee3ed780a2ba69db8723d3eed1/">《2024Q3 订阅 Recap》</a>相比没什么变化或没什么想写的，就不再赘述了，在这里列个清单，感兴趣的可以回看我之前的 Recap</p><ul><li><a href="https://academy.zerotomastery.io/a/aff_bh0bg3nb/external?affcode=441520_wi5f5nqb">Zero to Mastery</a></li><li>iCloud 2TB</li><li>山姆卓越</li><li>Setapp</li><li>GLaDOS</li><li>Exercism</li><li>IFTTT</li><li>labuladong 算法笔记</li><li>国内、国外两台独立服务器</li><li>杂七杂八的各种国内会员</li></ul><h2 id="其他这一年订阅过又退订了的"><a href="#其他这一年订阅过又退订了的" class="headerlink" title="其他这一年订阅过又退订了的"></a>其他这一年订阅过又退订了的</h2><h3 id="Claude-Max"><a href="#Claude-Max" class="headerlink" title="Claude Max"></a>Claude Max</h3><p>首当其冲的自然是 Claude 了；其实到现在 Claude 都是桌面 MCP 做的最好的、Claude Code 也是综合体验最好的，奈何 Opus 持续降智的同时 Codex GPT-5 太强了而且性价比真的高……</p><h2 id="相比-2024Q3-的变化"><a href="#相比-2024Q3-的变化" class="headerlink" title="相比 2024Q3 的变化"></a>相比 2024Q3 的变化</h2><p>传送门：<a href="https://blog.singee.me/2024/10/17/122f4bee3ed780a2ba69db8723d3eed1/">《2024Q3 订阅 Recap》</a></p><h3 id="退订-Monica-Unlimited"><a href="#退订-Monica-Unlimited" class="headerlink" title="退订 Monica Unlimited"></a>退订 Monica Unlimited</h3><p>我曾经对于 Monica 十分满意（可以回看我上次的 Recap）</p><p>奈何，它家就是出了 Manus 的那家，然后重心转移了之后 Monica 就再也没什么新功能了，对于新模型的支持也不积极，高级模型还出了个积分制额外收费……</p><p>不过最重要的还是，ChatGPT Plus 已经成为了我的常订，而我对于 Claude、Gemini 等模型也没那么高的需求了</p><p>当然，如果你想要一个大而全又没那么贵的解决方案，Monica 还是一个很棒的选择（其实我现在依然用者它的浏览器插件，简单的问题随时划词问下体验也不错），如果你想订阅，欢迎使用我的邀请链接 <a href="https://monica.im/?ref=bryan">https://monica.im/?ref=bryan</a></p><h3 id="退订-GitHub-Copilot"><a href="#退订-GitHub-Copilot" class="headerlink" title="退订 GitHub Copilot"></a>退订 <strong>GitHub Copilot</strong></h3><p>感觉 GitHub Copilot 已经跟不上现在这个时代了……</p><p>作为 Cursor + JetBrains 双持的我，前者自不用说，Copilot 对我而言毫无吸引力，而后者嘛</p><p>JetBrains 的 AI Assistant 已经自带了 AI 补全，将模式改成 Creative 后（我其实不太理解为啥它不是默认 - 可能是这个模式更耗费服务器资源？）体验十分棒。美中不足的是 NES（Next Edit Suggestions）还在 beta 且仅支持特定语言（没一个我在写的 &#x3D; &#x3D;），但 Copilot 虽然支持但也不咋地。。还不如免费的 Trae 呢😂</p><p>综上，👋 Copilot —— 一个我从内测就开始用的插件，一个几乎重塑了我的编码习惯的插件</p><h3 id="退订-Cloudflare-Workers"><a href="#退订-Cloudflare-Workers" class="headerlink" title="退订 Cloudflare Workers"></a><strong>退订 Cloudflare Workers</strong></h3><p>我曾经是一个 Serverless 的「爱好者」，我觉得它是未来</p><p>奈何，现在越来越感觉到对于一个标准的应用来说，数据库是不可或缺的，而在 Serverless 的环境下，用户-边缘计算服务-数据库的延迟会变得十分明显，造成极差的用户体验</p><p>我目前几乎所有的服务都已迁移到 <a href="http://fly.io/">fly.io</a> 和 zeabur —— 与之对应，Cloudflare Workers 也退订了</p><h3 id="退订-Inoreader"><a href="#退订-Inoreader" class="headerlink" title="退订 Inoreader"></a>退订 Inoreader</h3><p>目前我已将 RSS 完全切换到了我自己写的 <a href="https://1space.tech/">1Space</a>，也因此退订了 Inoreader</p><p>不过，虽然退订了，但我没想到的是，过去的一年多 Inoreader 竟然获得了若干更新 —— 很神奇的事情，获取是换了个激进的产品经理吧，一个停止了七八年没大更新的服务突然更新&#x2F;优化了不少</p><h3 id="退订-WeRSS"><a href="#退订-WeRSS" class="headerlink" title="退订 WeRSS"></a>退订 <strong>WeRSS</strong></h3><p>这不是我想退订，是官网登录系统直接挂了，给开发者发邮件&#x2F;微信都不回！</p><p>哎，再没有通过 RSS 稳定订阅微信公众号的方式了</p><ul><li>基于搜狗、即刻抓取的方案，十分不靠谱（有时候丢，不丢的时候有时候能延迟个一周）</li><li>而基于微信读书的 <a href="https://github.com/cooderl/wewe-rss">WeWe RSS</a>、<a href="https://wechat2rss.xlab.app/deploy/deploy">WeChat2RSS</a> 等确实靠谱，但我珍爱我的微信读书账号不想让它被封啊…… 为啥没有个 SaaS 啊……</li><li>哦，（写这篇文章的时候）刚搜到了个 <a href="https://github.com/rachelos/we-mp-rss">WeRSS - 微信公众号订阅助手</a>，看上去是基于微信公众平台？我感觉有整个微信被封号的风险</li></ul><p>🤷 现在只能，已经不看微信公众号了</p><h3 id="其他已退订的服务"><a href="#其他已退订的服务" class="headerlink" title="其他已退订的服务"></a>其他已退订的服务</h3><ul><li>X Premium（优惠到期，没啥续费的动力，后面需要的话可能开个 Basic）</li><li>IPRoyal（使用 lisa 替代）</li></ul>]]></content>
    
    
      
      
    <summary type="html">&lt;h2 id=&quot;现存订阅&quot;&gt;&lt;a href=&quot;#现存订阅&quot; class=&quot;headerlink&quot; title=&quot;现存订阅&quot;&gt;&lt;/a&gt;现存订阅&lt;/h2&gt;&lt;h3 id=&quot;ChatGPT-Plus&quot;&gt;&lt;a href=&quot;#ChatGPT-Plus&quot; class=&quot;headerlink&quot; </summary>
      
    
    
    
    
  </entry>
  
  <entry>
    <title>再见 xlog</title>
    <link href="https://blog.singee.me/2025/08/01/242f4bee3ed780428287d44edcd7dd3a/"/>
    <id>https://blog.singee.me/2025/08/01/242f4bee3ed780428287d44edcd7dd3a/</id>
    <published>2025-08-01T00:21:00.000Z</published>
    <updated>2025-08-01T00:54:00.000Z</updated>
    
    <content type="html"><![CDATA[<p>2023 年 4 月我在 xlog 下写下了第一篇博客。xlog 真的是一个我很喜欢的博客平台，好看，对于 markdown 的第一方支持，不用考虑部署、图床等问题，自带 AI Summary、自带双语翻译，真的是一切只需要「写」即可，哦对，更重要的是，依赖于区块链技术，虽然你写的文章是在平台上的，但所有数据都依然属于你，且所有数据都是永久保存。</p><p>然而，两年过去了，xlog 这个平台虽然还在，但我认为它已经死了。GitHub 更新已基本停滞，没有人处理 issue、没有人审阅 pr，xlog 官网上充满了 spam，也没有人去管理社区。</p><p>其实这一切的原因都很好理解 —— xlog 的开发者 DIYGod 转去做 Folo 了。是啊，Folo 相比于 xlog 绝对是更有前景的项目，也更容易讲故事……</p><p>xlog 已被放弃，再加上 xlog 的母公司 RSS3 最近的动荡，我觉得是时候从 xlog 迁移走了。</p><hr><p>我其实无比庆幸，两年前的时候我是打算把我所有博客迁移到 xlog 的。但是我的博客用的是 <code>/yyyy/mm/dd/xxx</code> 的 url 格式，而 xlog 并不支持这种格式，因而我一直是用 <a href="http://blog.singee.me/">blog.singee.me</a> 作为博客主域名 + <a href="http://articles.singee.me/">articles.singee.me</a> 作为 xlog 博客域名的，然后通过自动化将内容进行同步，且配置 xlog 博客的链接作为 Canonical URL。</p><p>这让我这次的迁移十分简单：将我原始博客的链接删掉、将 <a href="http://articles.singee.me/">articles.singee.me</a> 的原链接进行跳转即可！</p><p>嗯…… 唯一的副作用，通过 RSS 订阅我的博客的人应该会因为 id 变化了重新看一遍我的博客。其实这个是可以解决的，因为我之前 <a href="http://blog.singee.me/">blog.singee.me</a> 的 RSS 是通过 patch 了 hexo-generator-feed 实现的，完全可以特殊处理，但考虑到经历这个事件以后我应该不会再考虑这种「奇葩」的两处链接的形式了，所以我就把之前的 patch 回滚了，顺便增加一下我博客的曝光度 emm</p><hr><p>anyway，博客又回来了，我又回到了原来的工作流：Notion 写作 + 同步到博客。已经这样写了两个博客了，一切都挺好，和两年前相比仿佛什么都没变 XD</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;2023 年 4 月我在 xlog 下写下了第一篇博客。xlog 真的是一个我很喜欢的博客平台，好看，对于 markdown 的第一方支持，不用考虑部署、图床等问题，自带 AI Summary、自带双语翻译，真的是一切只需要「写」即可，哦对，更重要的是，依赖于区块链技术，虽</summary>
      
    
    
    
    
  </entry>
  
  <entry>
    <title>Python 的 pth 文件：在程序启动前自动执行命令</title>
    <link href="https://blog.singee.me/2025/07/18/234f4bee3ed78004a05ef2496e81044f/"/>
    <id>https://blog.singee.me/2025/07/18/234f4bee3ed78004a05ef2496e81044f/</id>
    <published>2025-07-17T21:36:00.000Z</published>
    <updated>2025-07-18T04:29:00.000Z</updated>
    
    <content type="html"><![CDATA[<p>Python 的 <a href="https://docs.python.org/3/library/site.html">pth</a> 文件提供了在任何 Python 解释器执行前执行命令的能力，可以方便的执行一些初始化脚本</p><h2 id="pth-文件的能力"><a href="#pth-文件的能力" class="headerlink" title="pth 文件的能力"></a>pth 文件的能力</h2><p>Python 解释器在启动时会自动 import <a href="https://docs.python.org/3/library/site.html">site</a> 模块（除非启动时指定 <a href="https://docs.python.org/3/using/cmdline.html#cmdoption-S">-S</a> flag），而 site 模块有一个行为就是会寻找 <a href="https://stackoverflow.com/questions/31384639/what-is-pythons-site-packages-directory">site-packages</a> 目录（最常用的场景就是我们安装包的目录）下的所有 <code>.pth</code> 文件并依次「执行」它。</p><p>需要注意的是， <code>pth</code> 实质上并不是脚本，它的定义是「path configuration file」，格式是每行一个「additional items (one per line) to be added to <code>sys.path</code>」，实际上，它每一行可以是下面的值之一：</p><ul><li>空行、注释行（以 # 开头）：跳过</li><li>以 <code>import</code>  开头的字符串：会被 <a href="https://docs.python.org/3/library/functions.html#exec">exec()</a> 解释执行</li><li>其他字符串：会被追加进 <code>sys.path</code> 之中</li></ul><p>因此，利用第二个能力，我们实质上可以任意执行我们需要的脚本！</p><blockquote><p>🗒️ 注：如果脚本执行出现异常，只会打印出错误而不会阻止解释器的继续执行</p></blockquote><h2 id="可用性-执行时机"><a href="#可用性-执行时机" class="headerlink" title="可用性 &amp; 执行时机"></a>可用性 &amp; 执行时机</h2><p>在 Python 3 的所有版本可用</p><p>相关 <code>pth</code> 文件会在 python 解释器启动时执行 —— 这包括执行脚本前、启动解释器前、执行任何用 python 写的程序前（如 pip）</p><p>当存在多个 <code>pth</code> 文件时，将采用字母序的方式依次执行 —— 一个值得强调的点是，python 的 <a href="https://virtualenv.pypa.io/en/latest/">virtualenv</a> 就是通过 <code>_virtualenv.pth</code> 执行的 —— 这意味着，我们应当注意 <code>pth</code> 的命名以让其确保在 venv 之前或之后运行</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;Python 的 &lt;a href=&quot;https://docs.python.org/3/library/site.html&quot;&gt;pth&lt;/a&gt; 文件提供了在任何 Python 解释器执行前执行命令的能力，可以方便的执行一些初始化脚本&lt;/p&gt;
&lt;h2 id=&quot;pth-文件的能力</summary>
      
    
    
    
    
    <category term="Python" scheme="https://blog.singee.me/tags/Python/"/>
    
  </entry>
  
  <entry>
    <title>浏览器从 A 到 Z</title>
    <link href="https://blog.singee.me/2025/03/21/liu-lan-qi-cong-a-dao-z/"/>
    <id>https://blog.singee.me/2025/03/21/liu-lan-qi-cong-a-dao-z/</id>
    <published>2025-03-20T23:57:06.000Z</published>
    <updated>2025-03-20T23:57:06.000Z</updated>
    
    <content type="html"><![CDATA[<p>将 A-Z 逐一输入到 Google Chrome 的地址栏里，我的 Google Chrome 都会自动补全出哪些域名呢？</p><blockquote><p>本文灵感来源于 <a href="https://www.clckblog.space/blog/a2z/">2024: 浏览器从 A 到 Z</a>，首发于<a href="https://sspai.com/post/97620">少数派</a></p></blockquote><h3 id="A-https-axiom-co"><a href="#A-https-axiom-co" class="headerlink" title="A - https://axiom.co"></a>A - <a href="https://axiom.co/">https://axiom.co</a></h3><p>Axiom 是我最喜欢的网站日志收集分析工具，免费版拥有着高达 500GB &#x2F; 月的免费额度，我的多款产品（包括我最新正在做的 <a href="https://1space.tech/">1Space</a>）都是使用的它作为日志收集。</p><p>如果你在找一款日志工具，强烈推荐它！</p><h3 id="B-https-baidu-com"><a href="#B-https-baidu-com" class="headerlink" title="B - https://baidu.com"></a>B - <a href="https://baidu.com/">https://baidu.com</a></h3><p>无可争议…… 虽然我现在确实不怎么用百度了，但是网络连不上的时候还是第一时间用百度做测试的😂</p><h3 id="C-https-chatgpt-com"><a href="#C-https-chatgpt-com" class="headerlink" title="C - https://chatgpt.com"></a>C - <a href="https://chatgpt.com/">https://chatgpt.com</a></h3><p>ChatGPT 作为 AI 时代的先驱，在目前似乎仍然保持着第一🤔</p><p>如果这篇文章是在 2024 年写的，那么我的 C 可能就不是它了；2024 年或许算是 ChatGPT 落后的一年，但是在 2025 年，O1-Pro 和 Deep Research 让它再次成为了模型领域的 No.1。我追随着最新的前沿技术，也订阅了高达 $200 &#x2F; 月的 ChatGPT Pro，或许很贵，但我觉得它确确实实为我节省了很多的时间和精力。</p><h3 id="D-https-discord-com"><a href="#D-https-discord-com" class="headerlink" title="D - https://discord.com"></a>D - <a href="https://discord.com/">https://discord.com</a></h3><p>论「社区」，似乎已经有越来越多的服务选择在 Discord 这个平台上建立了。我在用的很多产品都用它作为产品发布和讨论的渠道。</p><h3 id="E-edge-inspect"><a href="#E-edge-inspect" class="headerlink" title="E - edge:&#x2F;&#x2F;inspect"></a>E - edge:&#x2F;&#x2F;inspect</h3><p>没想到竟然是个 Inspect 页面。这是 Chrome 自带的浏览器调试工具页面（不过因为我在用的是 Edge，所以不是 chrome:&#x2F;&#x2F;inspect 而是 edge:&#x2F;&#x2F;inspect）。我在做的 <a href="https://1space.tech/">1Space</a>，因为利用了 Shared Workers 作为多标签页的同步方案，因此我需要频繁访问它来查看同步日志。</p><h3 id="F-https-fly-io"><a href="#F-https-fly-io" class="headerlink" title="F - https://fly.io"></a>F - <a href="https://fly.io/">https://fly.io</a></h3><p>Fly IO 是我用了数年的容器服务平台，曾经驱动了我绝大多数的产品（其实现在也有不少，还剩下 40% 吧），体验很不错。</p><p>Fly IO 给我印象最深刻的其实是他们的 <a href="https://fly.io/docs/hiring/">招聘</a>。他们的招聘与绝大多数的面试不同，采用的是「做 2-3 道实践题」+「与他们工作一天」的形式，只看能力，不看背景（甚至他们不要求简历），而且是全远程工作、薪资透明（仅与面试定级有关，与历史薪资、所在地域无关）。</p><h3 id="G-https-gmail-com"><a href="#G-https-gmail-com" class="headerlink" title="G - https://gmail.com"></a>G - <a href="https://gmail.com/">https://gmail.com</a></h3><p>Gmail ——  一个不存在的邮箱平台</p><h3 id="H-http-localhost-3333"><a href="#H-http-localhost-3333" class="headerlink" title="H - http://localhost:3333"></a>H - <a href="http://localhost:3333/">http://localhost:3333</a></h3><p>好好好，竟然是 localhost —— 3333 这个端口是我的  <a href="https://1space.tech/">1Space</a> 的本地开发服务器所使用的端口。</p><h3 id="I-https-inoreader-com"><a href="#I-https-inoreader-com" class="headerlink" title="I - https://inoreader.com"></a>I - <a href="https://inoreader.com/">https://inoreader.com</a></h3><p>虽然 RSS 越来越没落，虽然 RSS 平台越来越多（嗯？这俩之间的因果关系有点反直觉），但我还是觉得 RSS 是最适合我的信息收集渠道，inoreader 也是最好用的 RSS 客户端。</p><p>多说一句（广告时间到），inoreader 单纯做 RSS 已经到了几乎极致了，但是我们用 RSS 的目的或许不是为了收集信息，而是为了学习信息，而在整理回顾上，inoreader 就没那么强了，甚至我觉得其他能作为它下游知识管理的产品（例如我目前在用 readwise，或许下面 R 能看到它的身影）也不够优秀。因此我做的 <a href="https://1space.tech/">1Space</a> 目的就是打通知识「收集 - 管理 - 回顾」的全流程。</p><h3 id="J-https-www-jetbrains-com"><a href="#J-https-www-jetbrains-com" class="headerlink" title="J - https://www.jetbrains.com"></a>J - <a href="https://www.jetbrains.com/">https://www.jetbrains.com</a></h3><p>JetBrains 曾经是无可争议的 IDE 老大。</p><p>唉，曾经。JetBrains 的体验真的比 VS Code 好太多，哪怕在 VS Code 最擅长的前端领域，我也敢说 WebStorm 吊打它。奈何，现在是 AI 的时代，IDE 已经被 Cursor 为首的 AI IDE 重塑，而 JetBrains 真的在 AI 的潮流上落后了。打败你的，可能并不是你的竞争对手。</p><h3 id="K-https-kb-singee-me"><a href="#K-https-kb-singee-me" class="headerlink" title="K - https://kb.singee.me"></a>K - <a href="https://kb.singee.me/">https://kb.singee.me</a></h3><p>哦吼，我自己的 Knowledge Base！我的知识库一直是公开的，我的很多<del>懒得</del>不适合整理成博客的内容都写在了上面，主要记录我各种笔记、踩过的各种坑。</p><h3 id="L-http-localhost-3333"><a href="#L-http-localhost-3333" class="headerlink" title="L - http://localhost:3333"></a>L - <a href="http://localhost:3333/">http://localhost:3333</a></h3><p>嗯…… 和 H 一样，看出来我真的很努力去做 <a href="https://1space.tech/">1Space</a> 了。</p><h3 id="M-https-monica-im"><a href="#M-https-monica-im" class="headerlink" title="M - https://monica.im"></a>M - <a href="https://monica.im/">https://monica.im</a></h3><p>在我从浏览器中测试「M」之前，我就猜到了，我最常用的网站必有它。</p><p>Monica 可能宣传的不多，但是说它所属公司的另一个产品 Manus 估计大多数人都听过。如果说 Manus 是 AI Agent、完全替代人工方面的王炸，那么 Monica 就是你日常使用 AI 过程中的瑞士军刀 —— 你需要的 AI 能力，几乎总能在 Monica 中找到。</p><h3 id="N-https-notion-so"><a href="#N-https-notion-so" class="headerlink" title="N - https://notion.so"></a>N - <a href="https://notion.so/">https://notion.so</a></h3><p>竟然是 Notion。Notion 似乎我已经不用多余篇幅介绍了，估计能看到本文的受众都见过它。我曾经是 Notion 最早期的用户之一，但坦白说我已经挺长时间没怎么用过 Notion 了…… 其他 N 开头的产品还不够能打哇🤷</p><h3 id="O-https-originui-com"><a href="#O-https-originui-com" class="headerlink" title="O - https://originui.com"></a>O - <a href="https://originui.com/">https://originui.com</a></h3><p>又是一个程序员专属产品。这是一个 UI 组件库，算是 shadcn 的补充，同样以「复制-粘贴」的形式引入组件，需要的人值得一看！</p><h3 id="P-https-www-paypal-com"><a href="#P-https-www-paypal-com" class="headerlink" title="P - https://www.paypal.com"></a>P - <a href="https://www.paypal.com/">https://www.paypal.com</a></h3><p>竟然是 Paypal，类似国内的支付宝的产品？又是一个实际上我没怎么用的产品，看起来 P 开头的服务也不够能打😮‍💨</p><h3 id="Q-不便透露"><a href="#Q-不便透露" class="headerlink" title="Q - 不便透露"></a>Q - 不便透露</h3><p>emm 企业内部平台，略过</p><h3 id="R-https-read-readwise-io"><a href="#R-https-read-readwise-io" class="headerlink" title="R - https://read.readwise.io"></a>R - <a href="https://read.readwise.io/">https://read.readwise.io</a></h3><p>哦！Readwise Reader！一个稍后读的阅读器 + RSS！</p><p>真的挺好用的，而且对于我一个早期的 Readwise 用户而言直接是加量不加价。但我其实对它的很多细节还是不怎么满意的。我的 <a href="https://1space.tech/">1Space</a> 去年才开始正式做，但其实早在数年前就有计划了。但当时，刚刚打算做，就遇到了 Readwise Reader 宣布立项，我被他们开始宣传的「Reader for Power Reader」吸引了，决定等他们的产品，奈何，等了这么久，虽然已经比其他阅读器做的好很多了，还是不足以达到我想要的地步😮‍💨 最后还是没逃开自己做的命运。</p><h3 id="S-不便透露"><a href="#S-不便透露" class="headerlink" title="S - 不便透露"></a>S - 不便透露</h3><p>我的某产品的内测页面🤔</p><h3 id="T-temporal-web-temporal-svc-cluster-local-8080"><a href="#T-temporal-web-temporal-svc-cluster-local-8080" class="headerlink" title="T - temporal-web.temporal.svc.cluster.local:8080"></a>T - temporal-web.temporal.svc.cluster.local:8080</h3><p><a href="https://temporal.io/">Temporal</a> 的管理面板。Temporal 是一个 Workflow 管理与调度的工具。写后端的人应该都知道，如果一个逻辑直接使用很普通的代码编写，在项目发展的过程中，很容易就会遇到复杂度指数级提升。如果并发、重试等基础操作在每个接口、每个 RPC 调用都自己写一遍，实在是没有意义，而且很容易漏了哪里导致上线 bomb。Workflow 就是对这种场景的一个解决方案，你的一切逻辑都定义成 Workflow，而重试、日志、并发等等都由调度器管理，项目初期看起来可能稍显繁琐，但是随着项目复杂度的提升、随着项目对并发的要求的提升，你会感谢当年选型选择了使用 Workflow 进行组织的你的。</p><p>哦对，Temporal 被设计为可以支撑超大型项目。如果你的项目是个中小型项目，也可以看看其他解决方案，例如 <a href="https://trigger.dev/">Trigger.dev</a>、<a href="https://www.inngest.com/">inngest</a>、<a href="https://restate.dev/">Restate</a>。</p><h3 id="U-https-ui-shadcn-com"><a href="#U-https-ui-shadcn-com" class="headerlink" title="U - https://ui.shadcn.com"></a>U - <a href="https://ui.shadcn.com/">https://ui.shadcn.com</a></h3><p>要不是这篇文章严格按照字母序组织，它应该是和前面的 Origin UI 放在一起的。Shadcn&#x2F;ui 简直就是没有设计能力的开发者的福音，如果你想做一个自己的产品，又苦于不知如何让页面变得好看，不如试试它。</p><p>另外，shadcn&#x2F;ui 的开发者目前已经加入了 Vercel，因此 Vercel 的 <a href="https://v0.dev/">v0</a> 对 shadcn&#x2F;ui 有很强的支持，如果你不但没有设计能力、甚至不是开发者，那么，利用 v0，只动动嘴皮子也可以得到利用 shadcn&#x2F;ui 组织的很好看的界面。</p><h3 id="V-https-v2ex-com"><a href="#V-https-v2ex-com" class="headerlink" title="V - https://v2ex.com"></a>V - <a href="https://v2ex.com/">https://v2ex.com</a></h3><p><del>i2ex</del>v2ex 论坛可以说是中国最大的<del>同性交友社区</del>程序员论坛了，嗯，就是这样。</p><h3 id="W-不便透露"><a href="#W-不便透露" class="headerlink" title="W - 不便透露"></a>W - 不便透露</h3><p>我自用的某产品页面</p><h3 id="X-https-x-com"><a href="#X-https-x-com" class="headerlink" title="X - https://x.com"></a>X - <a href="https://x.com/">https://x.com</a></h3><p>全球最大的社交平台，实话说，对不追星的人来说，比微博好玩多了</p><h3 id="Y-https-www-youdao-com"><a href="#Y-https-www-youdao-com" class="headerlink" title="Y - https://www.youdao.com"></a>Y - <a href="https://www.youdao.com/">https://www.youdao.com</a></h3><p>各种词典软件层出不穷，但我觉得依然还是有道最好用。带有韦氏、柯林斯、牛津的资源，各种原版例句，而且完全免费。</p><h3 id="Z-https-zeabur-com"><a href="#Z-https-zeabur-com" class="headerlink" title="Z - https://zeabur.com"></a>Z - <a href="https://zeabur.com/">https://zeabur.com</a></h3><p>如果你是一个开发者，又不想浪费过多的精力在自动部署、运维上，就选 Zeabur 吧！推送代码秒部署，最重要的是，还有国内的服务器节点，真的很好用</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;将 A-Z 逐一输入到 Google Chrome 的地址栏里，我的 Google Chrome 都会自动补全出哪些域名呢？&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;本文灵感来源于 &lt;a href=&quot;https://www.clckblog.space/blog/a2z/&quot;</summary>
      
    
    
    
    
  </entry>
  
  <entry>
    <title>2024Q3 订阅 Recap</title>
    <link href="https://blog.singee.me/2024/10/17/122f4bee3ed780a2ba69db8723d3eed1/"/>
    <id>https://blog.singee.me/2024/10/17/122f4bee3ed780a2ba69db8723d3eed1/</id>
    <published>2024-10-16T22:22:00.000Z</published>
    <updated>2026-01-24T09:21:11.779Z</updated>
    
    <content type="html"><![CDATA[<h2 id="现存订阅"><a href="#现存订阅" class="headerlink" title="现存订阅"></a>现存订阅</h2><p>（按照实付月金额降序）</p><h3 id="Proton"><a href="#Proton" class="headerlink" title="Proton"></a>Proton</h3><p>我是 Proton Visionary 用户，Proton Visionary 的价格 $479.76 &#x2F; 2y，是我所有订阅服务中最贵的了。</p><p>我依然在持续订阅中，且目前对于 Proton 依然很满意</p><ol><li>Visionary 套餐持续「加量不加价」</li><li>相比之前，近年明显增加了 Visionary 套餐的「新品尝鲜特权」，所有新产品&#x2F;新功能都会优先给 Visionary 用户使用</li></ol><p>在可以预见的未来我将继续长期订阅下去</p><p>AD：Proton Visionary 可以分享给他人加入，如果你想加入我的家庭组请发邮件给我 <a href="mailto:&#x73;&#105;&#x6e;&#x67;&#101;&#x65;&#64;&#112;&#114;&#x6f;&#116;&#111;&#110;&#x2e;&#x6d;&#x65;">&#x73;&#105;&#x6e;&#x67;&#101;&#x65;&#64;&#112;&#114;&#x6f;&#116;&#111;&#110;&#x2e;&#x6d;&#x65;</a>，价格为 92 天 ¥109</p><h3 id="Monica"><a href="#Monica" class="headerlink" title="Monica"></a>Monica</h3><p>订阅了 Monica Unlimited，年付 $199</p><p>Monica 是一个我认为最全的 AI 工具，可以说覆盖了几乎所有需要 AI 的平台，有网页版的 chat、浏览器插件扩展（Chrome + iOS Safari）、桌面端、手机端，几乎可以说只要订阅 Monica 即可满足所有对于 AI 的需求</p><p>AD：如果想购买 Monica，请使用我的邀请链接 <a href="https://monica.im/?ref=bryan">https://monica.im/?ref=bryan</a></p><h3 id="Zero-to-Mastery"><a href="#Zero-to-Mastery" class="headerlink" title="Zero to Mastery"></a>Zero to Mastery</h3><p>订阅了 ZTM 年度订阅，价格 $195.3 &#x2F; 年（使用了提供给中国用户的 30% PPP 折扣）</p><p>一个计算机相关知识的学习网站。我是从 Udemy 学习到的他的课程，质量很不错而且持续更新，并且有比较多我感兴趣的内容，所以就去网站订阅了。目前在这上主要用来学习算法、系统设计和设计。</p><p>如果你也对它感兴趣，单门课程可以看看 Udemy 搞促销的时候，大概七八十一节，如果想订阅的话记得取申请 PPP 折扣订阅</p><p>另外他家还有一点有意思的是，Lifetime 标价 $999，但只要你学习 30 个月（每个月学习至少一节课）就可以得到免费的 Lifetime Plan。这种不促销而是鼓励你持续学习的做法我很喜欢。</p><h3 id="Duolingo"><a href="#Duolingo" class="headerlink" title="Duolingo"></a>Duolingo</h3><p>订阅了 Duolingo Family，价格 $195.3 &#x2F; 年</p><p>和 GF 一起用，总觉得用多邻国学知识是次要的，玩玩才是主要的…… 我目前用它来学习日语和粤语，女票用来学习韩语</p><p>如果你也对多邻国感兴趣，去淘宝买 ¥40 &#x2F; 年的家庭组拼车或许才是最划算的方案</p><h3 id="GitHub-Copilot"><a href="#GitHub-Copilot" class="headerlink" title="GitHub Copilot"></a>GitHub Copilot</h3><p>订阅了 Personal Plan，价格 $10 &#x2F; 月</p><p>不知何故我三年的 Copilot 免费突然没了，或许和最近确实没怎么折腾开源有关吧。 一直用 Copilot 已经形成惯性了，写代码时候没有 Copilot 提示（特别是一些错误信息什么的）总觉得麻烦好多，价格也不贵，就付费订阅了。</p><p>而且现在 Copilot 已经不只是代码补全了，一方面支持了 CLI，一方面支持了 Chat。特别是 Chat，之前只能在 IDE 和手机版用，现在不但可以在 GitHub 主站用了，还可以索引仓库来 Ask Repo，甚至还有<a href="https://github.com/copilot">独立的 Chat 页面</a>。</p><p>Copilot 我唯一不满意的应该还是在 JetBrains 下生成 Commit Message 吧（而 JetBrains 自家的 JetBrains AI 就支持），我其实挺期待一个可以学习我历史 commit message 习惯来自动生成一个 commit message 然后我只需要简单更改就可以提交的功能的。</p><h3 id="iCloud"><a href="#iCloud" class="headerlink" title="iCloud"></a>iCloud</h3><p>订阅了 iCloud+ 2TB，价格 ¥68 &#x2F; 月</p><p>emmm 这可能是唯一一个我一直想退订但是没退吧，还每次扣款前五天提醒我下让我头疼。因为和家人共用，存储照片 + 备份，所以虽然感觉这是个性价比极低还不好用的东西我也只能忍着用了</p><h3 id="Dler-Cloud"><a href="#Dler-Cloud" class="headerlink" title="Dler Cloud"></a>Dler Cloud</h3><p>翻*服务，Pass Gold 套餐，享受了 8 折，折后 ¥800 &#x2F; 年</p><p>实话说已经不是很满意了，两年前我对 Dler 的评价是「综合体验最好的翻*服务」，但是现在我已经要打个问号了。</p><p>近年来持续的涨价 + 服务劣化，可能和大环境有关，但是我也实在不想为它付这么高昂的费用了。（事实上，之前我的套餐是最高等级 ¥1688&#x2F;年 的 Diamond，现在也降级了）</p><h3 id="山姆"><a href="#山姆" class="headerlink" title="山姆"></a>山姆</h3><p>卓越会员，¥680 &#x2F; 年</p><p>有点乱入的感觉，毕竟山姆可能是这个列表里唯一不是数字产品的了</p><p>之前一直都是蹭别人的卡或者闲鱼，今年终于自己开了。在 ¥260 的普通卡和 ¥680 的卓越卡之间纠结来着，但是想了下差价每个月 ¥35，卓越+联名卡额外返利共 3%，平均每个月消费 1167 应该还是很容易的；而如果想完全赚回卡费，扣除掉送了 ¥50 开卡礼券、副卡 ¥100 闲鱼卖了，¥530 的价格在 4% 的返利下只需要每月消费 1104 就能回本相当于卡完全没付钱（这个金额我没算错哈，420&#x2F;0.3 &gt; 530&#x2F;0.4），更何况还有副卡也会消费、加上卓越还有一些洗牙洗车券什么的，很容易回本，就开了。</p><h3 id="Cloudflare-Workers"><a href="#Cloudflare-Workers" class="headerlink" title="Cloudflare Workers"></a>Cloudflare Workers</h3><p>Paid Plan，$5.2 &#x2F; 月（因为我超用量了……）</p><p>我有数十个小服务跑在 Worker 上，大大提升了我的效率，可以说这个 5 刀是我付的最值的 5 刀了。</p><h3 id="iximiuz"><a href="#iximiuz" class="headerlink" title="iximiuz"></a>iximiuz</h3><p>前期通过 Pateron 赞助获得的 Premium，$5 &#x2F; 月</p><p>一个用来学习服务端技能的 learn-by-doing 平台，提供 tutorial 和对应的实验环境</p><h3 id="Inoreader"><a href="#Inoreader" class="headerlink" title="Inoreader"></a>Inoreader</h3><p>RSS 服务商，活动时候开的 $89.99 &#x2F; 18 月</p><h3 id="Readwise"><a href="#Readwise" class="headerlink" title="Readwise"></a>Readwise</h3><p>$4.5&#x2F;月（中国用户 PPP 优惠 50%）</p><p>我在同时用着它的回顾卡和 Reader 服务。但事实上我对它并不是非常满意，更多的是一种「市面上没有替代品」心态在用着它；我也在筹备我自己的类似产品，或许 2025 能见面。</p><h3 id="X-Premium"><a href="#X-Premium" class="headerlink" title="X Premium"></a>X Premium</h3><p>HK$396 &#x2F; 年（前几天活动 40% off 开的）</p><p>X Premium 可以说是一个我有时候需要有时候不需要的东西，大多数情况 Basic 够了，但我又很烦广告。之前一直都是一阵开一阵关的，这次想了下入了年付。</p><p>X Premium 有一个非常坑的地方！如果你点了升级按钮，那么不会有任何二次确认而是会给你直接升级+扣费；而如果你点了降级按钮，那么会立刻把你降级而且没有任何退款。</p><p>月付下损失可控，但是想像下年付的情况下，还剩下 11 个月的时候，想看看 Premium+，点了下，立刻升级成功了，反应过来不对，我只是想看看啊，于是又点了下降级，然后立刻降级成功了，紧接着发现哎竟然扣款了，那我降级会退款吗，等了几天发现没退，然后想那应该差额成为 credit 了吧，再次支付，嘿，又扣了一次钱。。然后联系客服，等待一周得到了一个「no refund」的回复……</p><h3 id="GLaDOS"><a href="#GLaDOS" class="headerlink" title="GLaDOS"></a>GLaDOS</h3><p>同样是翻 * 服务，¥398 &#x2F; 400 天</p><p>我用来做 Dler 的 backup 的，另外如果坚持每日签到的话价格要低于标价，因为差不多每签到 20 天能得 10 天，算下来 ¥398 能用两年多</p><h3 id="IPRoyal"><a href="#IPRoyal" class="headerlink" title="IPRoyal"></a>IPRoyal</h3><p>固定美国家宽出口 IP，$4 &#x2F; 月</p><p>懂得都懂，应付风控</p><h3 id="WeRSS"><a href="#WeRSS" class="headerlink" title="WeRSS"></a>WeRSS</h3><p>微信公众号转 RSS 订阅，VIP3 ¥292.5&#x2F;年</p><h3 id="Setapp"><a href="#Setapp" class="headerlink" title="Setapp"></a>Setapp</h3><p>家庭组拼车，¥18&#x2F;月</p><p>单单其中的 Timing 这个订阅 App 就能回本了，我额外在用的 Spark、Bartender、iStat Menus 等都算是白送的</p><h3 id="Dropbox"><a href="#Dropbox" class="headerlink" title="Dropbox"></a>Dropbox</h3><p>土耳其订阅 TRY 809.99&#x2F;年</p><p>我认为体验最好的网盘，没有之一</p><h3 id="Exercism"><a href="#Exercism" class="headerlink" title="Exercism"></a>Exercism</h3><p>一个编程学习平台，在出 Insider 之前赞助了 $2 &#x2F; 月现在获得了免费的 Insider【但其实所有功能都能免费使用】</p><p>主要可以用来学习多种编程语言，让自己刻意走出舒适区，而且有问题可以找 mentor 帮忙，完全免费</p><h3 id="IFTTT"><a href="#IFTTT" class="headerlink" title="IFTTT"></a>IFTTT</h3><p>Pro+ Plan，很早期订阅的，$1.99 &#x2F; 月</p><h3 id="labuladong-算法笔记"><a href="#labuladong-算法笔记" class="headerlink" title="labuladong 算法笔记"></a>labuladong 算法笔记</h3><p>算法学习网站，¥109 &#x2F; 年</p><h3 id="淘宝-88-VIP"><a href="#淘宝-88-VIP" class="headerlink" title="淘宝 88 VIP"></a>淘宝 88 VIP</h3><p>¥88 &#x2F; 年</p><h3 id="各种域名"><a href="#各种域名" class="headerlink" title="各种域名"></a>各种域名</h3><p>我名下目前有 13 个域名，差不多均价 $12 &#x2F; 年，加起来约 $150</p><h3 id="服务器"><a href="#服务器" class="headerlink" title="服务器"></a>服务器</h3><p>目前我的主要服务都跑在 <a href="http://fly.io/">fly.io</a> 和 Digital Ocean 上，约 $100 &#x2F; 月，但目前均在免费 credit 范围内</p><h3 id="杂七杂八的国内会员"><a href="#杂七杂八的国内会员" class="headerlink" title="杂七杂八的国内会员"></a>杂七杂八的国内会员</h3><ul><li>腾讯视频</li><li>爱奇艺</li><li>优酷</li><li>京东 plus</li><li>网易严选</li><li>京东 1 号店</li><li>QQ 绿钻</li><li>网易云</li><li>QQ 超级会员</li><li>QQ 阅读</li><li>知乎会员</li></ul><p>各种联名卡活动开的，很难去算清楚具体花了多少钱，差不多每年 ¥400 吧</p><h3 id="信用卡年费"><a href="#信用卡年费" class="headerlink" title="信用卡年费"></a>信用卡年费</h3><ul><li>建行大山白：¥1800&#x2F;年，可用 40w 积分抵扣</li><li>中信<ul><li>美国运通 Safari 白金卡：¥480&#x2F;年，可用 6w 积分抵扣</li><li>银联 Plus 白金卡：¥480&#x2F;年，可用 12w 积分抵扣</li><li>万豪精逸白金卡：¥980&#x2F;年，刚性年费</li></ul></li></ul><h2 id="相比于-2024Q2-的主要变化"><a href="#相比于-2024Q2-的主要变化" class="headerlink" title="相比于 2024Q2 的主要变化"></a>相比于 2024Q2 的主要变化</h2><h3 id="取消了-Monica-的自动续费"><a href="#取消了-Monica-的自动续费" class="headerlink" title="取消了 Monica 的自动续费"></a>取消了 Monica 的自动续费</h3><p>之前订阅了 Monica 的年付（$199 &#x2F; 年），本来是打算长久用下去的，但是这个季度我决定取消了它的自动续费，等到过期了再重新考虑是否续费，主要原因：</p><ol><li>降价，Monica 的 Unlimited 在我订阅期间有一两个月的 $99 &#x2F; 年的循环折扣，现在应该也只需要 $149 &#x2F; 年；而我的订阅费用却只能是 $199 &#x2F; 年，不能享受折扣</li><li>劣化：GPT-4 在很多情况下比 GPT-4o 要强，但是 Monica 在 4o 出了以后下掉了 GPT-4，且无法恢复（在智能体 - Models 中仍然可以选择 4，但是无法使用任何非文字的功能）</li><li>劣化 + 涨价：我初用的时候 Monica 可以在长上下文的情况下获得比较不错的响应，但是两个月前我开始发现在长上下文的情况下 Monica 会丢失一些信息，猜测做了截断&#x2F;压缩；在 o1 出了以后直接更新摊牌，不限上下文的要按量付费</li></ol><h3 id="申请了-Memex-的退款"><a href="#申请了-Memex-的退款" class="headerlink" title="申请了 Memex 的退款"></a>申请了 Memex 的退款</h3><p>我曾经入了 Memex 的 lifetime plan，但是用了不到一周就发现完全不足以达到我的期望，就申请了退款。作者很快回复了，了解我不满意的点并承诺会在 6 个月内改善（也就是到现在这个月，2024.10）如果到时候仍然未能改善，继续给我退款，我同意了。</p><p>但自那以后，我所有的询问邮件、产品反馈邮件都石沉大海，再无人回复过。而现在 6 个月到了，我更是发现整个产品已经 3 个月没有更新了。</p><p>我以 Chargeback 作为威胁给作者再次发了最后一封邮件并表达了我的愤怒之情，这次作者倒是很快恢复了，说会 asap 启动 退款流程，然而至此又消失了，没有退款、没有回复……</p><h3 id="计划停用-inoreader"><a href="#计划停用-inoreader" class="headerlink" title="计划停用 inoreader"></a>计划停用 inoreader</h3><p>其实早在两年前我就已经计划停用 inoreader 了，一个原因就是日益渐长的年费，现在已经丧心病狂到了$7.5 &#x2F; 月（对比 miniflux 官方实例只要 $15&#x2F;年），另一个原因就是最近的新 UI 让我卡到完全无法正常使用（事实上，在我现在的数据规模下，旧的 UI  也在某些地方会很卡，但至少不至于卡到不能用）</p><p>替代方案现在主要打算自己开发了，想做一个完整的 RSS + Workflow 的形式，来替代我目前 inoreader + IFTTT 的形式</p>]]></content>
    
    
      
      
    <summary type="html">&lt;h2 id=&quot;现存订阅&quot;&gt;&lt;a href=&quot;#现存订阅&quot; class=&quot;headerlink&quot; title=&quot;现存订阅&quot;&gt;&lt;/a&gt;现存订阅&lt;/h2&gt;&lt;p&gt;（按照实付月金额降序）&lt;/p&gt;
&lt;h3 id=&quot;Proton&quot;&gt;&lt;a href=&quot;#Proton&quot; class=&quot;heade</summary>
      
    
    
    
    
    <category term="订阅" scheme="https://blog.singee.me/tags/%E8%AE%A2%E9%98%85/"/>
    
  </entry>
  
  <entry>
    <title>使用 TypeScript 撰写 OmniFocus 脚本</title>
    <link href="https://blog.singee.me/2023/12/13/omni-focus-scripts-ts/"/>
    <id>https://blog.singee.me/2023/12/13/omni-focus-scripts-ts/</id>
    <published>2023-12-13T02:08:49.000Z</published>
    <updated>2023-12-13T02:08:49.000Z</updated>
    
    <content type="html"><![CDATA[<p>OmniFocus 4 即将发布！在我多年管理我的待办的过程中，我尝试过 Todoist、滴答清单、Things、Sorted 等等几乎所有市面上的 TODO 软件，但最终，OmniFocus 终成我一直以来的最终选择。而谈及 OmniFocus 的强大性，不得不提的就是他强大的自动化能力 —— <a href="https://omni-automation.com/">Omni Automation</a>。</p><p>Omni Automation 实际上是基于 JS 脚本的，而编写纯 JS 脚本的过程…… 一言难尽。虽然 Omni Automation 官方提供了 TypeScript 的定义文件，但一方面难以做好类型检查，另一方面其详尽程度仍有待提升（长久不更新、大量使用 any 等），此外，由于缺乏打包工具，代码逻辑的复用也显得颇为困难（我甚至很长一段时间都是靠着 Mac 版本 OmniFocus 的一个 bug 实现的逻辑复用）。</p><p>为了庆祝 OmniFocus 4 的面世，我决定将我个人开发并使用的方案整理开源，包括打包脚本和类型定义，还有我使用的一些工具函数及脚本，希望可以让更多人能够愉快地编写 OmniFocus Script。</p><h2 id="使用"><a href="#使用" class="headerlink" title="使用"></a>使用</h2><ol><li><a href="https://github.com/new?template_name=OFScriptsTemplate&template_owner=ImSingee">使用此模板</a>创建一个仓库</li><li>克隆你创建的仓库</li><li>运行 <code>pnpm install</code> 安装依赖项</li><li>运行 <code>pnpm build</code> 构建脚本</li></ol><p>脚本源码放在 <code>src</code> 目录中，编译结果（可被 OmniFocus Scripts 使用的）放在 <code>dist</code> 目录中。</p><h2 id="撰写脚本"><a href="#撰写脚本" class="headerlink" title="撰写脚本"></a>撰写脚本</h2><p><code>src</code> 目录内的任何不以 <code>_</code> 开头的 TypeScript 文件都将被视为 OmniFocus 脚本并编译（<code>_</code> 开头的脚本文件被保留用于工具函数）。</p><p>任何脚本都必须遵循以下模式：</p><figure class="highlight typescript"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">export</span> <span class="keyword">const</span> action = <span class="keyword">new</span> <span class="title class_">PlugIn</span>.<span class="title class_">Action</span>(<span class="keyword">function</span> (<span class="params">selection</span>) &#123;</span><br><span class="line">  <span class="comment">// do anything you want</span></span><br><span class="line">&#125;);</span><br><span class="line"></span><br><span class="line">action.<span class="property">validate</span> = <span class="keyword">function</span> (<span class="params">selection</span>) &#123;</span><br><span class="line">  <span class="comment">// do anything you want</span></span><br><span class="line">&#125;;</span><br><span class="line"></span><br><span class="line"><span class="keyword">export</span> <span class="keyword">const</span> <span class="attr">meta</span>: <span class="title class_">Meta</span> = &#123;</span><br><span class="line">  <span class="attr">label</span>: <span class="string">&quot;...&quot;</span>,</span><br><span class="line">  <span class="attr">description</span>: <span class="string">&quot;...&quot;</span>,</span><br><span class="line">  <span class="attr">identifier</span>: <span class="string">&quot;...&quot;</span>,</span><br><span class="line">  <span class="attr">author</span>: <span class="string">&quot;...&quot;</span>,</span><br><span class="line">  <span class="attr">version</span>: <span class="string">&quot;0.1&quot;</span>,</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure><p>其中：</p><ol><li><code>action</code> 和 <code>meta</code> 是必需的，<code>action.validate</code> 是可选的</li><li><code>meta</code> 必须是脚本的最后一部分。它之后不可以有任何内容。</li></ol><h2 id="构建与使用"><a href="#构建与使用" class="headerlink" title="构建与使用"></a>构建与使用</h2><p>运行 <code>pnpm build</code>，构建后的脚本（以 <code>.omnifocusjs</code> 结尾）将被放置在 <code>dist</code> 目录下。</p><p>你可以直接将 dist 目录中的脚本拷贝到 OmniFocus 的脚本目录，也可以利用脚本进行同步。</p><p>如果你使用 iCloud 保存 OmniFocus 脚本，可以直接使用 <code>pnpm sync</code> 自动将构建好的脚本同步到 iCloud 中的 OmniFocus 脚本目录；如果你不使用 iCloud 而是使用了自定义路径，可修改 <code>sync.sh</code> 文件改变目标路径。</p><h2 id="End"><a href="#End" class="headerlink" title="End"></a>End</h2><p>此方案我个人已用一年有余，但一方面开源版本可能有些错误，另一方面可能有更多的定制化需求。</p><p>欢迎进入 <a href="https://github.com/ImSingee/OFScriptsTemplate">仓库</a> 页面提交 Issue 和 PR！</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;OmniFocus 4 即将发布！在我多年管理我的待办的过程中，我尝试过 Todoist、滴答清单、Things、Sorted 等等几乎所有市面上的 TODO 软件，但最终，OmniFocus 终成我一直以来的最终选择。而谈及 OmniFocus 的强大性，不得不提的就是他</summary>
      
    
    
    
    
  </entry>
  
  <entry>
    <title>[备忘] Go init 行为</title>
    <link href="https://blog.singee.me/2023/12/12/go-init-behaviour/"/>
    <id>https://blog.singee.me/2023/12/12/go-init-behaviour/</id>
    <published>2023-12-11T22:29:38.000Z</published>
    <updated>2023-12-11T22:33:08.000Z</updated>
    
    <content type="html"><![CDATA[<h1 id="总结"><a href="#总结" class="headerlink" title="总结"></a>总结</h1><p>基础规则：</p><ol><li>所有的 init 函数都在一个 Goroutine 中执行（但请参见下面的特殊注意）</li><li>如果 package a 引用了 package b，那么 a 的 init 一定在 b 的 init 运行完成后运行</li><li>main package 的 main 函数一定在其他 init 函数均运行完成后再运行（即运行顺序为 package 的 init -&gt; main 的 init -&gt; main 的 main）</li><li>同一 package 中的多个文件中的 init 执行顺序未定义，同一文件中的 init 自上而下运行</li><li>如果 package a 同时引用了 package b 和 c，那么 b 与 c 的 init 顺序在 Go1.21 及之后定义</li></ol><p>在 Go1.20 及之前：</p><ol><li>如果 package a 引用了 package b，那么 b 的 init 一定在 a 之前运行</li><li>但是，如果 package a 同时引用了 package b 和 c，只要 b c 之间没有引用关系，b c 的执行顺序是不定的</li></ol><p>在 Go1.21 及之后：</p><ol><li>对于无引用关系的包（即 Go1.20 及之前的中的第 2 点），按照其包名字母序决定引用顺序（例如 a 一定在 b 之前执行，github.com&#x2F;xxx&#x2F;xxx 一定在 gitlab.com&#x2F;xxx&#x2F;xxx 之前执行）</li></ol><p>特殊注意：  </p><ol><li>如果 init 存在阻塞，那么用于运行 init 的 goroutine 可能创建新的 goroutine，这会导致某些 init 代码并发运行</li><li>存在阻塞的情况下，不会保证无引用关系的 package 的 init 完成先后顺序（参考示例 c）</li><li>存在阻塞的情况下，如果 package a 依赖了 package b，那么 a 的 init 一定在 b 的 init 运行完成后开始运行（参考示例 d）</li></ol><h1 id="示例项目"><a href="#示例项目" class="headerlink" title="示例项目"></a>示例项目</h1><p><a href="https://github.com/singee-study/go-init">https://github.com/singee-study/go-init</a></p><h1 id="参考"><a href="#参考" class="headerlink" title="参考"></a>参考</h1><p><a href="https://go.dev/ref/mem">The Go Memory Model</a><br><a href="https://go.dev/doc/go1.21">Go 1.21 Release Notes</a></p>]]></content>
    
    
      
      
    <summary type="html">&lt;h1 id=&quot;总结&quot;&gt;&lt;a href=&quot;#总结&quot; class=&quot;headerlink&quot; title=&quot;总结&quot;&gt;&lt;/a&gt;总结&lt;/h1&gt;&lt;p&gt;基础规则：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;所有的 init 函数都在一个 Goroutine 中执行（但请参见下面的特殊注意）&lt;/li&gt;
&lt;li</summary>
      
    
    
    
    
    <category term="Go" scheme="https://blog.singee.me/tags/Go/"/>
    
  </entry>
  
  <entry>
    <title>[随笔] 一开始就公布定价</title>
    <link href="https://blog.singee.me/2023/11/25/memos_211/"/>
    <id>https://blog.singee.me/2023/11/25/memos_211/</id>
    <published>2023-11-25T09:13:06.000Z</published>
    <updated>2023-11-25T09:13:06.000Z</updated>
    
    <content type="html"><![CDATA[<p>看到了 <a href="https://feedbacktrace.com/">FeedbackTrace</a> 这个项目，看起来不错，但是我不会去使用，一个主要的原因就是它没有公布定价。</p><p>如果去选择一个一个直接面向 C 端的第三方产品，我一定会选择已经有了明确定价的 —— 否则我将承担巨大的未来的风险。如果未来定价不满足我的预期，我需要去考虑怎么迁移数据、怎么抹平用户体验差异等，一方面可能带来不确定的时间成本，另一方面可能产生糟糕的终端用户体验。</p><p>面对公测期间的价格和上线后不一致的做法，各个产品有各个产品不同的思路，最统一的就是降价后下一期账单自动降价、涨价保持原有价格不变或至少保持原有价格一定时间。特别的，<a href="https://rewind.ai/">Rewind</a> 在 Early Access 期间的策略是调低定价后为历史订单全额退款、调高价格保持用户的原有价格不变，而 <a href="https://chat.openai.com/">ChatGPT</a> 的策略则是调低定价后给予用户差额价格退款并给予额外补偿。</p><p>多说一句，公测免费并不是不预先提供价格点的「借口」，完全可以预先告诉哪些是付费点但是公测期间可以免费使用（例如 <a href="https://omnivore.app/">Omnivore</a> 明确在文档中说明了它的哪些功能未来可能是收费的）。</p><p>因此，我的产品，也一定在最初就给出一个收费点定价方案 —— 哪怕不够完美。大体来说，我会提前将价格和收费点列明，公测期间可以免费使用收费功能（或部分收费功能），而预先开始订阅收费版本的用户（即早期支持者）承诺未来如果存在价格调整他们一定可以「使用最低且不高于现有的价格得到最多的服务」。</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;看到了 &lt;a href=&quot;https://feedbacktrace.com/&quot;&gt;FeedbackTrace&lt;/a&gt; 这个项目，看起来不错，但是我不会去使用，一个主要的原因就是它没有公布定价。&lt;/p&gt;
&lt;p&gt;如果去选择一个一个直接面向 C 端的第三方产品，我一定会选择已经有</summary>
      
    
    
    
    <category term="随笔" scheme="https://blog.singee.me/categories/%E9%9A%8F%E7%AC%94/"/>
    
    
  </entry>
  
  <entry>
    <title>[随笔] Server Action</title>
    <link href="https://blog.singee.me/2023/10/27/memos_209/"/>
    <id>https://blog.singee.me/2023/10/27/memos_209/</id>
    <published>2023-10-26T23:48:02.000Z</published>
    <updated>2023-11-01T21:40:45.000Z</updated>
    
    <content type="html"><![CDATA[<p>最近在一个自己的小 Side Project 中使用了一下 Server Action，感受大概是</p><ol><li>更多的其实是替换原来的 &#x2F;api 路由，可以把它想做一个 TypeSafe 的 RPC，原来需要自己去定义 API 然后生成代码，这些 Server Action 直接帮你做了</li><li>因此，感觉原来用了 Next.js 的 &#x2F;api 路由的，迁移到 Server Action 会有较大的体验提升</li><li>Server Action 本质只能向前端发送一个 JSON Object，缺少了标准 HTTP&#x2F;RPC 的 StatusCode 和 Headers 的能力，因此如果真的想去很好的用它可能 Server 和 Client 仍然需要包一层</li><li>目前 Server Action 实质上缺少触发前端状态更新的逻辑，如果很需要其实可以利用 WebSocket 或者利用「包的那层」来手搓，实现起来其实也不难</li><li>我遇到 Server Action 最主要的问题其实是它触发调用的那层做的事情实在是太多了，会触发很多 React 内部的状态转换逻辑，另外我发现它与 useReducer 一起用甚至还有 bug（哪怕是目前 Next.js 14 Stable 了）</li></ol><p>综上，全栈项目玩玩可以，其余的…没啥必要</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;最近在一个自己的小 Side Project 中使用了一下 Server Action，感受大概是&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;更多的其实是替换原来的 &amp;#x2F;api 路由，可以把它想做一个 TypeSafe 的 RPC，原来需要自己去定义 API 然后生成代码，这些 S</summary>
      
    
    
    
    <category term="随笔" scheme="https://blog.singee.me/categories/%E9%9A%8F%E7%AC%94/"/>
    
    
    <category term="前端" scheme="https://blog.singee.me/tags/%E5%89%8D%E7%AB%AF/"/>
    
    <category term="Next.js" scheme="https://blog.singee.me/tags/Next-js/"/>
    
  </entry>
  
  <entry>
    <title>[随笔] Swift 异步：Task vs DispatchQueue</title>
    <link href="https://blog.singee.me/2023/09/21/memos_204/"/>
    <id>https://blog.singee.me/2023/09/21/memos_204/</id>
    <published>2023-09-21T01:31:41.000Z</published>
    <updated>2023-11-01T21:40:59.000Z</updated>
    
    <content type="html"><![CDATA[<p>在 Swift 上，执行一个异步的函数大体上有两种办法</p><ul><li>Task</li><li>DispatchQueue</li></ul><h3 id="背景知识：线程和队列"><a href="#背景知识：线程和队列" class="headerlink" title="背景知识：线程和队列"></a>背景知识：线程和队列</h3><p>Swift 同时支持多线程和异步，因此</p><ul><li>存在主线程和多个后台线程</li><li>每个线程存在若干队列（若干个全局 global 队列（每个优先级一个）、自定义队列（人为创建））</li></ul><h3 id="背景知识：队列优先级"><a href="#背景知识：队列优先级" class="headerlink" title="背景知识：队列优先级"></a>背景知识：队列优先级</h3><p>在队列层面，存在优先级的概念（在 Task 中叫 priority，在 DispatchQueue 中叫 qos）</p><ul><li>userInteractive：最高优先级，适用于 UI 操作（例如动画等）（在 Task 中被弃用）</li><li>userInitiated：较高优先级，适用于用户触发的操作</li><li>default：中优先级，默认（在 Task 中被弃用）</li><li>high, medium, low：高中低优先级（仅在 Task 中存在）</li><li>utility：较低优先级，适用于耗时的后台任务</li><li>background：最低优先级，适用于耗时的后台任务</li><li>unspecified：继承于 Thread.current.qualityOfService（在 Task 中被弃用）</li></ul><h3 id="背景知识：main"><a href="#背景知识：main" class="headerlink" title="背景知识：main"></a>背景知识：main</h3><p>main 同时隐含着两个概念：main thread 和 main queue，事实上无需特意区分（可以认为只有 main thread 才有 main queue，而 main thread 的不同 queue 之间并无特殊区别）</p><p>main 的主要用处在于其是直接和用户交互的，只有在 main 才能修改 UI、如果 main 繁忙用户会感觉到 UI 刷新卡顿</p><ul><li>对于 Task 而言，在 main 执行使用 <code>Task &#123; @MainActor</code></li><li>对于 DispatchQueue 而言，在 main 执行使用 <code>DispatchQueue.main</code></li></ul><p>注意，Task 的 @MainActor 实际上并不是让闭包代码在 main 执行，而是让其他执行它的 concurrency-aware 代码逻辑在 main 上执行（但是目前存在非 concurrency-aware 的代码，因此可能标记了 @MainActor 实际上仍然是在非 main 执行的，这种时候需要手动切换到 main；不过这种情况 XCode 会有警告，所以不必过于担心）</p><h3 id="DispatchQueue-相关"><a href="#DispatchQueue-相关" class="headerlink" title="DispatchQueue 相关"></a>DispatchQueue 相关</h3><ul><li>依赖的是 <code>Grand Central Dispatch(GCD)</code> <code>libdispatch</code></li><li>Dispatch.main 是在主线程执行的，其他均不保证实际执行线程</li><li>执行顺序先进先出</li><li>队列类型分为 serial 和 concurrent 两种，serial 在执行完一个任务后才会开始执行另一个、concurrent 会同时执行多个任务（故不保证任务的结束顺序）；main 是 serial 类型的、默认也是 serial 类型的</li><li>执行时存在 sync 和 async 两种，sync 会等待这个任务完成后返回，async 会直接返回</li><li>因上述特性，在 main 线程执行 DispatchQueue.main.sync 会导致死锁</li><li>无法直接获得执行结果</li></ul><h3 id="Task-相关"><a href="#Task-相关" class="headerlink" title="Task 相关"></a>Task 相关</h3><ul><li>Task 有 child 和 detached 两种类型，区别在于后者无法访问到调用方可见的变量</li><li>来自于 main 创建的 child Task 会始终在 main 执行，否则（除非标记 @MainActor）不保证执行的线程&#x2F;队列</li><li>已提交的任务可取消、可获取（等待）结果（获取结果需要 await）</li><li>如果和 DispatchQueue 类比，可以认为 Task 与 DispatchQueue.async 执行上的行为一致</li></ul><h3 id="额外：RunLoop"><a href="#额外：RunLoop" class="headerlink" title="额外：RunLoop"></a>额外：RunLoop</h3><ul><li>RunLoop.current 返回当前的线程循环、.main 返回主线程循环</li><li>通常情况下，无需特别注意 RunLoop.main 和 DispatchQueue.main 的区别，二者都是在 main 上执行逻辑</li><li>RunLoop.main 中执行的逻辑可以被外部用户操作暂停，而 DispatchQueue.main 不会，因此在处理滚动时可能更希望使用 RunLoop.main，而其他通常场景则一般使用 DispatchQueue.main</li></ul>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;在 Swift 上，执行一个异步的函数大体上有两种办法&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Task&lt;/li&gt;
&lt;li&gt;DispatchQueue&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;背景知识：线程和队列&quot;&gt;&lt;a href=&quot;#背景知识：线程和队列&quot; class=&quot;headerli</summary>
      
    
    
    
    <category term="随笔" scheme="https://blog.singee.me/categories/%E9%9A%8F%E7%AC%94/"/>
    
    
    <category term="Swift" scheme="https://blog.singee.me/tags/Swift/"/>
    
  </entry>
  
  <entry>
    <title>[随笔] RSS 与稍后阅读</title>
    <link href="https://blog.singee.me/2023/09/18/memos_202/"/>
    <id>https://blog.singee.me/2023/09/18/memos_202/</id>
    <published>2023-09-17T20:18:30.000Z</published>
    <updated>2023-09-17T20:24:15.000Z</updated>
    
    <content type="html"><![CDATA[<ol><li>尽可能降低 RSS 的「手动筛选」，包括内容量和频率</li><li>更多的关注你的稍后阅读，而不是追求新的信息</li></ol><p>1 有两个层面，一是尽可能的用自动化，将关注的内容直接推送到稍后阅读工具中，而不是人工筛选，另一个是人工筛选的频率要尽可能降低，至少不应该每天都去筛选</p><p>2 是，尽管新闻很诱人，但是稍后阅读中堆积的内容也曾是你的兴趣，尽可能让你的稍后阅读呈现递减的趋势，反而新的内容没那么重要</p>]]></content>
    
    
      
      
    <summary type="html">&lt;ol&gt;
&lt;li&gt;尽可能降低 RSS 的「手动筛选」，包括内容量和频率&lt;/li&gt;
&lt;li&gt;更多的关注你的稍后阅读，而不是追求新的信息&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;1 有两个层面，一是尽可能的用自动化，将关注的内容直接推送到稍后阅读工具中，而不是人工筛选，另一个是人工筛选的频率要尽</summary>
      
    
    
    
    <category term="随笔" scheme="https://blog.singee.me/categories/%E9%9A%8F%E7%AC%94/"/>
    
    
  </entry>
  
  <entry>
    <title>在 Shell 脚本中嵌入二进制文件</title>
    <link href="https://blog.singee.me/2023/08/28/embed-bin-in-shell-script/"/>
    <id>https://blog.singee.me/2023/08/28/embed-bin-in-shell-script/</id>
    <published>2023-08-27T20:03:36.000Z</published>
    <updated>2023-08-27T20:03:36.000Z</updated>
    
    <content type="html"><![CDATA[<h2 id="前言"><a href="#前言" class="headerlink" title="前言"></a>前言</h2><p>在构建 Linux&#x2F;Unix 系安装包时，除了打包成标准的适用于各种发行版的软件包以外，我们更多的可能希望可以提供一个 shell 脚本进行程序的安装，将安装步骤简单收敛为两步：下载脚本 + 运行脚本。</p><p>通常，这种大多数的安装脚本都是再次从互联网上下载所需资源的，这样可以最小化脚本的体积并保证安装的始终是最新版本，但是这同样导致了下载到的「安装包」本质上是个「安装器」，无法离线安装。</p><p>本文将介绍一种已经在生产环境验证过的方案，来动态在安装包中嵌入网址。</p><blockquote><p>受限于一些原因，本文更多的从原理层面进行讲解，暂无法提供完整的代码解决方案，敬请谅解</p><p>另外，以下代码均为根据原理为本文撰写，虽然原理已经经过生产验证但所使用的代码并未经过严格的生产验证，如有 bug 烦请告知</p></blockquote><h2 id="脚本构成"><a href="#脚本构成" class="headerlink" title="脚本构成"></a>脚本构成</h2><p>整个脚本由 head + embed-bin 两部份构成；embed-bin 是不加改动的将我们的程序进行嵌入的，而 head 是一个动态生成的脚本，用于从当前脚本中提取 embed-bin 并执行。</p><p>head 脚本随是动态生成，但为了维护的简单，这里采用模板的形式</p><figure class="highlight sh"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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></pre></td><td class="code"><pre><span class="line"><span class="meta">#!/bin/sh</span></span><br><span class="line"><span class="comment">#</span></span><br><span class="line"><span class="comment"># NAME:     &#123;&#123; .Name &#125;&#125;</span></span><br><span class="line"><span class="comment"># PLATFORM: &#123; .Platform &#125;&#125;</span></span><br><span class="line"><span class="comment"># DIGEST:   &#123;&#123; .MD5 &#125;&#125;, @LINES@</span></span><br><span class="line"></span><br><span class="line">THIS_DIR=$(DIRNAME=$(<span class="built_in">dirname</span> <span class="string">&quot;<span class="variable">$0</span>&quot;</span>); <span class="built_in">cd</span> <span class="string">&quot;<span class="variable">$DIRNAME</span>&quot;</span>; <span class="built_in">pwd</span>)</span><br><span class="line">THIS_FILE=$(<span class="built_in">basename</span> <span class="string">&quot;<span class="variable">$0</span>&quot;</span>)</span><br><span class="line">THIS_PATH=<span class="string">&quot;<span class="variable">$THIS_DIR</span>/<span class="variable">$THIS_FILE</span>&quot;</span></span><br><span class="line">EXTRACT=&#123;&#123; <span class="keyword">if</span> .AutoExtract &#125;&#125;1&#123;&#123; <span class="keyword">else</span> &#125;&#125;0&#123;&#123; end &#125;&#125;</span><br><span class="line">FORCE_EXTRACT=0</span><br><span class="line">PREFIX=&#123;&#123; .DefaultPrefix &#125;&#125;</span><br><span class="line">EXECUTE=&#123;&#123; <span class="keyword">if</span> .AutoExecute &#125;&#125;1&#123;&#123; <span class="keyword">else</span> &#125;&#125;0&#123;&#123; end &#125;&#125;</span><br><span class="line">&#123;&#123;- end &#125;&#125;</span><br><span class="line"></span><br><span class="line">USAGE=<span class="string">&quot;&#123;&#123; .Opts.Usage &#125;&#125;&quot;</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">while</span> <span class="built_in">getopts</span> <span class="string">&quot;:h&#123;&#123; .Opts.FlagNames &#125;&#125;&quot;</span> flag; <span class="keyword">do</span></span><br><span class="line"> <span class="keyword">case</span> <span class="string">&quot;<span class="variable">$flag</span>&quot;</span> <span class="keyword">in</span></span><br><span class="line">    h)</span><br><span class="line">        <span class="built_in">printf</span> <span class="string">&quot;%s&quot;</span> <span class="string">&quot;<span class="variable">$USAGE</span>&quot;</span></span><br><span class="line">        <span class="built_in">exit</span> 2</span><br><span class="line">        ;;</span><br><span class="line">    &#123;&#123;- range .Opts.All &#125;&#125;</span><br><span class="line">    &#123;&#123; .Name &#125;&#125;)</span><br><span class="line">        &#123;&#123; range .Action.DoIfSet &#125;&#125;&#123;&#123; . &#125;&#125;</span><br><span class="line">        &#123;&#123; end &#125;&#125;;;&#123;&#123; end &#125;&#125;</span><br><span class="line">    *)</span><br><span class="line">        <span class="built_in">printf</span> <span class="string">&quot;ERROR: did not recognize option &#x27;%s&#x27;, please try -h\\n&quot;</span> <span class="string">&quot;<span class="variable">$1</span>&quot;</span></span><br><span class="line">        <span class="built_in">exit</span> 1</span><br><span class="line">        ;;</span><br><span class="line"> <span class="keyword">esac</span></span><br><span class="line"><span class="keyword">done</span></span><br><span class="line"></span><br><span class="line"><span class="comment"># Verify MD5</span></span><br><span class="line"><span class="built_in">printf</span> <span class="string">&quot;%s\\n&quot;</span> <span class="string">&quot;Verifying file...&quot;</span></span><br><span class="line">MD5=$(<span class="built_in">tail</span> -n +@LINES@ <span class="string">&quot;<span class="variable">$THIS_PATH</span>&quot;</span> | <span class="built_in">md5sum</span>)</span><br><span class="line"><span class="keyword">if</span> ! <span class="built_in">echo</span> <span class="string">&quot;<span class="variable">$MD5</span>&quot;</span> | grep &#123;&#123; .MD5 &#125;&#125; &gt;/dev/null; <span class="keyword">then</span></span><br><span class="line">    <span class="built_in">printf</span> <span class="string">&quot;ERROR: md5sum mismatch of tar archive\\n&quot;</span> &gt;&amp;2</span><br><span class="line">    <span class="built_in">printf</span> <span class="string">&quot;expected: &#123;&#123; .MD5 &#125;&#125;\\n&quot;</span> &gt;&amp;2</span><br><span class="line">    <span class="built_in">printf</span> <span class="string">&quot;     got: %s\\n&quot;</span> <span class="string">&quot;<span class="variable">$MD5</span>&quot;</span> &gt;&amp;2</span><br><span class="line">    <span class="built_in">exit</span> 3</span><br><span class="line"><span class="keyword">fi</span></span><br><span class="line"></span><br><span class="line">&#123;&#123; <span class="keyword">if</span> .Archive -&#125;&#125;</span><br><span class="line"><span class="keyword">if</span> [ -z <span class="string">&quot;<span class="variable">$PREFIX</span>&quot;</span> ]; <span class="keyword">then</span></span><br><span class="line">    PREFIX=$(<span class="built_in">mktemp</span> -d -p $(<span class="built_in">pwd</span>))</span><br><span class="line"><span class="keyword">fi</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> [ <span class="string">&quot;<span class="variable">$EXTRACT</span>&quot;</span> = <span class="string">&quot;1&quot;</span> ]; <span class="keyword">then</span></span><br><span class="line">    <span class="keyword">if</span> [ <span class="string">&quot;<span class="variable">$FORCE_EXTRACT</span>&quot;</span> = <span class="string">&quot;1&quot;</span> ] || [ ! -f <span class="string">&quot;<span class="variable">$PREFIX</span>/.extract-done&quot;</span> ] || [ <span class="string">&quot;<span class="subst">$(cat <span class="string">&quot;<span class="variable">$PREFIX</span>/.extract-done&quot;</span>)</span>&quot;</span> != <span class="string">&quot;&#123;&#123; .MD5&#125;&#125;&quot;</span> ]; <span class="keyword">then</span></span><br><span class="line">        <span class="built_in">printf</span> <span class="string">&quot;Extracting archive to %s ...\\n&quot;</span> <span class="string">&quot;<span class="variable">$PREFIX</span>&quot;</span></span><br><span class="line"></span><br><span class="line">        &#123;</span><br><span class="line">            <span class="built_in">dd</span> <span class="keyword">if</span>=<span class="string">&quot;<span class="variable">$THIS_PATH</span>&quot;</span> bs=1            skip=@ARCHIVE_FIRST_OFFSET@ count=@ARCHIVE_FIRST_BYTES@  2&gt;/dev/null</span><br><span class="line">            <span class="built_in">dd</span> <span class="keyword">if</span>=<span class="string">&quot;<span class="variable">$THIS_PATH</span>&quot;</span> bs=@BLOCK_SIZE@ skip=@ARCHIVE_BLOCK_OFFSET@ count=@ARCHIVE_BLOCKS_COUNT@ 2&gt;/dev/null</span><br><span class="line">            <span class="built_in">dd</span> <span class="keyword">if</span>=<span class="string">&quot;<span class="variable">$THIS_PATH</span>&quot;</span> bs=1            skip=@ARCHIVE_LAST_OFFSET@  count=@ARCHIVE_LAST_BYTES@   2&gt;/dev/null</span><br><span class="line">        &#125; | tar zxf - -C <span class="string">&quot;<span class="variable">$PREFIX</span>&quot;</span></span><br><span class="line"></span><br><span class="line">        <span class="built_in">echo</span> -n &#123;&#123; .MD5 &#125;&#125; &gt; <span class="string">&quot;<span class="variable">$PREFIX</span>/.extract-done&quot;</span></span><br><span class="line">    <span class="keyword">else</span></span><br><span class="line">        <span class="built_in">printf</span> <span class="string">&quot;Archive has already been extracted to %s\\n&quot;</span> <span class="string">&quot;<span class="variable">$PREFIX</span>&quot;</span></span><br><span class="line">    <span class="keyword">fi</span></span><br><span class="line"><span class="keyword">fi</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> [ <span class="string">&quot;<span class="variable">$EXECUTE</span>&quot;</span> = <span class="string">&quot;1&quot;</span> ]; <span class="keyword">then</span></span><br><span class="line">    <span class="built_in">echo</span> <span class="string">&quot;Run Command:&quot;</span> &#123;&#123; .Command &#125;&#125;</span><br><span class="line">    <span class="built_in">cd</span> <span class="string">&quot;<span class="variable">$PREFIX</span>&quot;</span> &amp;&amp; &#123;&#123; .Command &#125;&#125;</span><br><span class="line"><span class="keyword">fi</span></span><br><span class="line">&#123;&#123;- end &#125;&#125;</span><br><span class="line"></span><br><span class="line"><span class="built_in">exit</span> 0</span><br><span class="line"><span class="comment">## --- DATA --- ##</span></span><br></pre></td></tr></table></figure><p>这个脚本模板存在着两种类型的变量：<code>&#123;&#123; XX &#125;&#125;</code> 与 <code>%XX%</code>，其中主要的区别在于整个模板渲染要分成两步：首先渲染所有的 <code>&#123;&#123; XX &#125;&#125;</code> 变量，然后再渲染剩余的 <code>%XX%</code> 变量；渲染前者时无特殊要求，而渲染后者时需要保证变量的渲染前后文本的长度与行数不变。</p><p>这个脚本会将 embed-bin 作为压缩包进行解压，这主要是因为我们内部使用时相关数据可能很大（数百兆乃至上 GB），如果你只需要一个小的脚本可以移除压缩有关的代码。</p><p>另外，这个脚本会在执行前进行一次 MD5 校验，这主要是为了防止一些情况下脚本下载不完全导致的。但是因为本身 embed-bin 就是压缩包了，因此可以删除校验有关的代码来加快安装速度（我们内部保留的原因一方面是因为我们 embed 的内容不止压缩包甚至不止一个文件，另一方面就是为了给出更好的错误提示）。</p><p>这个脚本也提供了参数传递的能力和部分默认值的指定，这是因为在某些情况下相关步骤可能异常而全量执行所有步骤较为耗时，在实际使用中你可根据实际需要删改脚本参数。</p><blockquote><p>脚本的参数由模板渲染引擎给出，这主要是为了可维护性，如果你更希望在脚本中撰写相关的内容则可以修改相关部分</p></blockquote><h2 id="渲染脚本"><a href="#渲染脚本" class="headerlink" title="渲染脚本"></a>渲染脚本</h2><p>话不多说，直接上代码</p><figure class="highlight go"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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></pre></td><td class="code"><pre><span class="line"><span class="comment">//go:embed &quot;header.sh.tmpl&quot;</span></span><br><span class="line"><span class="keyword">var</span> headerTemplate <span class="type">string</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">type</span> headerOptions <span class="keyword">struct</span> &#123;</span><br><span class="line">Name <span class="type">string</span></span><br><span class="line">MD5  <span class="type">string</span></span><br><span class="line"></span><br><span class="line">Opts *Opts</span><br><span class="line"></span><br><span class="line">*ArchiveOptions</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">type</span> ArchiveOptions <span class="keyword">struct</span> &#123;</span><br><span class="line">DefaultPrefix <span class="type">string</span></span><br><span class="line">AutoExtract   <span class="type">bool</span></span><br><span class="line">AutoExecute   <span class="type">bool</span></span><br><span class="line">Command       <span class="type">string</span> <span class="comment">// 使用 $PREFIX 引用 prefix</span></span><br><span class="line"></span><br><span class="line">Filename <span class="type">string</span> <span class="comment">// 供 builder 使用，不会打入最终文件</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="params">(o *ArchiveOptions)</span></span> QuotedCommand() <span class="type">string</span> &#123;</span><br><span class="line"><span class="keyword">return</span> shells.Quote(o.Command)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">renderHeaders</span><span class="params">(o *headerOptions)</span></span> ([]<span class="type">byte</span>, <span class="type">error</span>) &#123;</span><br><span class="line">t := template.New(<span class="string">&quot;&quot;</span>)</span><br><span class="line"></span><br><span class="line">tt, err := t.Parse(headerTemplate)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> <span class="literal">nil</span>, ee.Wrap(err, <span class="string">&quot;invalid template&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">b := bytes.Buffer&#123;&#125;</span><br><span class="line"></span><br><span class="line">err = tt.Execute(&amp;b, o)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> <span class="literal">nil</span>, err</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">return</span> b.Bytes(), <span class="literal">nil</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">getHeaders</span><span class="params">(o *headerOptions)</span></span> ([]<span class="type">byte</span>, <span class="type">error</span>) &#123;</span><br><span class="line">tmpl, err := renderHeaders(o)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> <span class="literal">nil</span>, err</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">lines := bytes.Count(tmpl, []<span class="type">byte</span>(<span class="string">&quot;\n&quot;</span>)) + <span class="number">1</span></span><br><span class="line"></span><br><span class="line">tmpl = bytes.ReplaceAll(tmpl, []<span class="type">byte</span>(<span class="string">&quot;@LINES@&quot;</span>), []<span class="type">byte</span>(strconv.Itoa(lines)))</span><br><span class="line"></span><br><span class="line">replaceAndFillSpace(tmpl, <span class="string">&quot;@BLOCK_SIZE@&quot;</span>, blockSize)</span><br><span class="line"></span><br><span class="line"><span class="keyword">return</span> tmpl, <span class="literal">nil</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">replaceAndFillSpace</span><span class="params">(data []<span class="type">byte</span>, old <span class="type">string</span>, <span class="built_in">new</span> <span class="type">int64</span>)</span></span> &#123;</span><br><span class="line">oldBytes := []<span class="type">byte</span>(old)</span><br><span class="line">newString := strconv.FormatInt(<span class="built_in">new</span>, <span class="number">10</span>)</span><br><span class="line"></span><br><span class="line">newWithExtraSpace := <span class="built_in">append</span>([]<span class="type">byte</span>(newString), bytes.Repeat([]<span class="type">byte</span>&#123;<span class="string">&#x27; &#x27;</span>&#125;, <span class="built_in">len</span>(old)-<span class="built_in">len</span>(newString))...)</span><br><span class="line"></span><br><span class="line"><span class="comment">// assert len(old) == len(newWithExtraSpace)</span></span><br><span class="line"></span><br><span class="line"><span class="comment">// Apply replacements to buffer.</span></span><br><span class="line">start := <span class="number">0</span></span><br><span class="line"><span class="keyword">for</span> &#123;</span><br><span class="line">i := bytes.Index(data[start:], oldBytes)</span><br><span class="line"><span class="keyword">if</span> i == <span class="number">-1</span> &#123;</span><br><span class="line"><span class="keyword">return</span> <span class="comment">// stop</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">start += i</span><br><span class="line">start += <span class="built_in">copy</span>(data[start:], newWithExtraSpace)</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">type</span> Opts <span class="keyword">struct</span> &#123;</span><br><span class="line">All []*Opt</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="params">(opts *Opts)</span></span> FlagNames() <span class="type">string</span> &#123;</span><br><span class="line">b := strings.Builder&#123;&#125;</span><br><span class="line"><span class="keyword">for</span> _, opt := <span class="keyword">range</span> opts.All &#123;</span><br><span class="line">b.WriteString(opt.Name)</span><br><span class="line"><span class="keyword">if</span> <span class="built_in">len</span>(opt.Arg) != <span class="number">0</span> &#123;</span><br><span class="line">b.WriteString(<span class="string">&quot;:&quot;</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> b.String()</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="params">(opts *Opts)</span></span> Usage() <span class="type">string</span> &#123;</span><br><span class="line">b := strings.Builder&#123;&#125;</span><br><span class="line"></span><br><span class="line">b.WriteString(<span class="string">&quot;Usage: $0 [options]\n\n&quot;</span>)</span><br><span class="line"></span><br><span class="line">all := <span class="built_in">make</span>([][<span class="number">2</span>]<span class="type">string</span>, <span class="number">0</span>, <span class="number">1</span>+<span class="built_in">len</span>(opts.All))</span><br><span class="line"></span><br><span class="line">nameLen := <span class="number">2</span></span><br><span class="line"></span><br><span class="line">all = <span class="built_in">append</span>(all, [<span class="number">2</span>]<span class="type">string</span>&#123;<span class="string">&quot;-h&quot;</span>, <span class="string">&quot;Print this help message and exit&quot;</span>&#125;)</span><br><span class="line"></span><br><span class="line"><span class="keyword">for</span> _, opt := <span class="keyword">range</span> opts.All &#123;</span><br><span class="line">bb := strings.Builder&#123;&#125;</span><br><span class="line">bb.WriteString(<span class="string">&quot;-&quot;</span>)</span><br><span class="line">bb.WriteString(opt.Name)</span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> opt.Arg != <span class="string">&quot;&quot;</span> &#123;</span><br><span class="line">bb.WriteString(<span class="string">&quot; [&quot;</span>)</span><br><span class="line">bb.WriteString(opt.Arg)</span><br><span class="line">bb.WriteString(<span class="string">&quot;]&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">name := bb.String()</span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> <span class="built_in">len</span>(name) &gt; nameLen &#123;</span><br><span class="line">nameLen = <span class="built_in">len</span>(name)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">all = <span class="built_in">append</span>(all, [<span class="number">2</span>]<span class="type">string</span>&#123;name, opt.Help&#125;)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">for</span> _, a := <span class="keyword">range</span> all &#123;</span><br><span class="line">b.WriteString(a[<span class="number">0</span>])</span><br><span class="line">b.WriteString(strings.Repeat(<span class="string">&quot; &quot;</span>, nameLen-<span class="built_in">len</span>(a[<span class="number">0</span>])))</span><br><span class="line">b.WriteString(<span class="string">&quot;\t&quot;</span>)</span><br><span class="line">b.WriteString(a[<span class="number">1</span>])</span><br><span class="line">b.WriteString(<span class="string">&quot;\n&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">return</span> b.String()</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">type</span> Opt <span class="keyword">struct</span> &#123;</span><br><span class="line">Name   <span class="type">string</span></span><br><span class="line">Arg    <span class="type">string</span></span><br><span class="line">Help   <span class="type">string</span></span><br><span class="line">Action OptAction</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">type</span> OptAction <span class="keyword">interface</span> &#123;</span><br><span class="line">DoIfSet() []<span class="type">string</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">type</span> DoAndExitAction <span class="keyword">struct</span> &#123;</span><br><span class="line">Do       []<span class="type">string</span></span><br><span class="line">ExitCode <span class="type">int</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="params">(a *DoAndExitAction)</span></span> DoIfSet() []<span class="type">string</span> &#123;</span><br><span class="line">r := <span class="built_in">append</span>([]<span class="type">string</span>&#123;&#125;, a.Do...)</span><br><span class="line">r = <span class="built_in">append</span>(r, <span class="string">&quot;exit &quot;</span>+strconv.Itoa(a.ExitCode))</span><br><span class="line"><span class="keyword">return</span> r</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">type</span> DoAndContinueAction <span class="keyword">struct</span> &#123;</span><br><span class="line">Do []<span class="type">string</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="params">(a *DoAndContinueAction)</span></span> DoIfSet() []<span class="type">string</span> &#123;</span><br><span class="line"><span class="keyword">return</span> a.Do</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">SimpleSetEnvAction</span><span class="params">(envName <span class="type">string</span>, envValue <span class="keyword">interface</span>&#123;&#125;)</span></span> *DoAndContinueAction &#123;</span><br><span class="line"><span class="keyword">return</span> &amp;DoAndContinueAction&#123;</span><br><span class="line">Do: []<span class="type">string</span>&#123;fmt.Sprintf(<span class="string">&quot;%s=%v&quot;</span>, envName, envValue)&#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">type</span> Builder <span class="keyword">struct</span> &#123;</span><br><span class="line">Name <span class="type">string</span></span><br><span class="line"></span><br><span class="line">ArchiveOptions *ArchiveOptions</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">openAndWrite</span><span class="params">(filename <span class="type">string</span>, w io.Writer)</span></span> (<span class="type">int64</span>, <span class="type">error</span>) &#123;</span><br><span class="line">f, err := os.Open(filename)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> <span class="number">0</span>, err</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">defer</span> f.Close()</span><br><span class="line"></span><br><span class="line"><span class="keyword">return</span> io.Copy(w, f)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">fillAndSetHeader</span><span class="params">(prefix, filename <span class="type">string</span>, f io.Writer, headers []<span class="type">byte</span>, offset <span class="type">int64</span>)</span></span> (<span class="type">int64</span>, <span class="type">error</span>) &#123;</span><br><span class="line"></span><br><span class="line">fileLength, err := openAndWrite(filename, f)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> <span class="number">0</span>, ee.Wrap(err, <span class="string">&quot;cannot append data for &quot;</span>+prefix)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">firstOffset := offset</span><br><span class="line">firstBytes := blockSize - (firstOffset % blockSize)</span><br><span class="line">replaceAndFillSpace(headers, fmt.Sprintf(<span class="string">&quot;@%s_FIRST_OFFSET@&quot;</span>, prefix), firstOffset)</span><br><span class="line">replaceAndFillSpace(headers, fmt.Sprintf(<span class="string">&quot;@%s_FIRST_BYTES@&quot;</span>, prefix), firstBytes)</span><br><span class="line"></span><br><span class="line">copy2Start := firstOffset + firstBytes</span><br><span class="line">copy2Skip := copy2Start / blockSize</span><br><span class="line">copy2Blocks := (fileLength - copy2Start + firstOffset) / blockSize</span><br><span class="line">replaceAndFillSpace(headers, fmt.Sprintf(<span class="string">&quot;@%s_BLOCK_OFFSET@&quot;</span>, prefix), copy2Skip)</span><br><span class="line">replaceAndFillSpace(headers, fmt.Sprintf(<span class="string">&quot;@%s_BLOCKS_COUNT@&quot;</span>, prefix), copy2Blocks)</span><br><span class="line"></span><br><span class="line">copy3Start := (copy2Skip + copy2Blocks) * blockSize</span><br><span class="line">copy3Size := fileLength - firstBytes - (copy2Blocks * blockSize)</span><br><span class="line">replaceAndFillSpace(headers, fmt.Sprintf(<span class="string">&quot;@%s_LAST_OFFSET@&quot;</span>, prefix), copy3Start)</span><br><span class="line">replaceAndFillSpace(headers, fmt.Sprintf(<span class="string">&quot;@%s_LAST_BYTES@&quot;</span>, prefix), copy3Size)</span><br><span class="line"></span><br><span class="line"><span class="keyword">return</span> fileLength, <span class="literal">nil</span></span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="params">(b *Builder)</span></span> Build(saveTo <span class="type">string</span>) <span class="type">error</span> &#123;</span><br><span class="line">header := &amp;headerOptions&#123;</span><br><span class="line">Name:           b.Name,</span><br><span class="line">ArchiveOptions: b.ArchiveOptions,</span><br><span class="line">Opts:           &amp;Opts&#123;&#125;,</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">fileMD5 := md5.New()</span><br><span class="line"></span><br><span class="line"><span class="keyword">var</span> dataSize <span class="type">int64</span></span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> header.ArchiveOptions != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">if</span> header.ArchiveOptions.AutoExtract &#123;</span><br><span class="line">header.Opts.All = <span class="built_in">append</span>(header.Opts.All, &amp;Opt&#123;</span><br><span class="line">Name:   <span class="string">&quot;E&quot;</span>,</span><br><span class="line">Help:   <span class="string">&quot;Do not extract archive&quot;</span>,</span><br><span class="line">Action: SimpleSetEnvAction(<span class="string">&quot;EXTRACT&quot;</span>, <span class="number">0</span>),</span><br><span class="line">&#125;)</span><br><span class="line">&#125; <span class="keyword">else</span> &#123;</span><br><span class="line">header.Opts.All = <span class="built_in">append</span>(header.Opts.All, &amp;Opt&#123;</span><br><span class="line">Name:   <span class="string">&quot;e&quot;</span>,</span><br><span class="line">Help:   <span class="string">&quot;Also extract archive&quot;</span>,</span><br><span class="line">Action: SimpleSetEnvAction(<span class="string">&quot;EXTRACT&quot;</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">header.Opts.All = <span class="built_in">append</span>(header.Opts.All, &amp;Opt&#123;</span><br><span class="line">Name:   <span class="string">&quot;f&quot;</span>,</span><br><span class="line">Help:   <span class="string">&quot;Force extract archive&quot;</span>,</span><br><span class="line">Action: SimpleSetEnvAction(<span class="string">&quot;FORCE_EXTRACT&quot;</span>, <span class="number">1</span>),</span><br><span class="line">&#125;)</span><br><span class="line"></span><br><span class="line">prefixOpt := &amp;Opt&#123;</span><br><span class="line">Name: <span class="string">&quot;d&quot;</span>,</span><br><span class="line">Arg:  <span class="string">&quot;DIR&quot;</span>,</span><br><span class="line">Help: <span class="string">&quot;Extract to directory&quot;</span>,</span><br><span class="line">Action: &amp;DoAndContinueAction&#123;</span><br><span class="line">Do: []<span class="type">string</span>&#123;<span class="string">`PREFIX=&quot;$&#123;OPTARG&#125;&quot;`</span>&#125;,</span><br><span class="line">&#125;,</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">if</span> header.ArchiveOptions.DefaultPrefix != <span class="string">&quot;&quot;</span> &#123;</span><br><span class="line">prefixOpt.Help += fmt.Sprintf(<span class="string">&quot; (default: %s)&quot;</span>, header.ArchiveOptions.DefaultPrefix)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">header.Opts.All = <span class="built_in">append</span>(header.Opts.All, prefixOpt)</span><br><span class="line"></span><br><span class="line"><span class="keyword">if</span> header.ArchiveOptions.Command != <span class="string">&quot;&quot;</span> &#123;</span><br><span class="line"><span class="keyword">if</span> header.ArchiveOptions.AutoExecute &#123;</span><br><span class="line">header.Opts.All = <span class="built_in">append</span>(header.Opts.All, &amp;Opt&#123;</span><br><span class="line">Name:   <span class="string">&quot;X&quot;</span>,</span><br><span class="line">Help:   <span class="string">&quot;Do not execute command&quot;</span>,</span><br><span class="line">Action: SimpleSetEnvAction(<span class="string">&quot;EXECUTE&quot;</span>, <span class="number">0</span>),</span><br><span class="line">&#125;)</span><br><span class="line">&#125; <span class="keyword">else</span> &#123;</span><br><span class="line">header.Opts.All = <span class="built_in">append</span>(header.Opts.All, &amp;Opt&#123;</span><br><span class="line">Name:   <span class="string">&quot;x&quot;</span>,</span><br><span class="line">Help:   <span class="string">&quot;Also execute the command&quot;</span>,</span><br><span class="line">Action: SimpleSetEnvAction(<span class="string">&quot;EXECUTE&quot;</span>, <span class="number">1</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">n, err := openAndWrite(header.ArchiveOptions.Filename, fileMD5)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> ee.Wrap(err, <span class="string">&quot;failed to read archive file to get md5&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line">dataSize += n</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">_ = dataSize</span><br><span class="line"></span><br><span class="line">header.MD5 = hex.EncodeToString(fileMD5.Sum(<span class="literal">nil</span>))</span><br><span class="line"></span><br><span class="line">headers, err := getHeaders(header)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> ee.Wrap(err, <span class="string">&quot;failed to get headers&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">f, err := os.OpenFile(saveTo, os.O_RDWR|os.O_CREATE|os.O_TRUNC, <span class="number">0755</span>)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> ee.Wrap(err, <span class="string">&quot;failed to write file&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">defer</span> f.Close()</span><br><span class="line"></span><br><span class="line"><span class="comment">// write header</span></span><br><span class="line">headersLen, err := f.Write(headers)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> ee.Wrap(err, <span class="string">&quot;failed to write headers&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">currentOffset := <span class="type">int64</span>(headersLen)</span><br><span class="line"></span><br><span class="line"><span class="comment">//  embed archive</span></span><br><span class="line"><span class="keyword">if</span> header.ArchiveOptions != <span class="literal">nil</span> &#123;</span><br><span class="line">n, err := fillAndSetHeader(<span class="string">&quot;ARCHIVE&quot;</span>, header.ArchiveOptions.Filename, f, headers, currentOffset)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> ee.Wrap(err, <span class="string">&quot;failed to embed installer&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line">currentOffset += n</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">_ = currentOffset</span><br><span class="line"></span><br><span class="line"><span class="comment">// rewrite headers</span></span><br><span class="line">_, err = f.Seek(<span class="number">0</span>, <span class="number">0</span>)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> ee.Wrap(err, <span class="string">&quot;failed to seek file&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line">newHeadersLen, err := f.Write(headers)</span><br><span class="line"><span class="keyword">if</span> err != <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> ee.Wrap(err, <span class="string">&quot;failed to rewrite headers&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">if</span> headersLen != newHeadersLen &#123;</span><br><span class="line"><span class="keyword">return</span> ee.New(<span class="string">&quot;headers unexpected change after rewrite&quot;</span>)</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="keyword">return</span> <span class="literal">nil</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>使用则是</p><figure class="highlight go"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">b := &amp;Builder&#123;</span><br><span class="line">    Name: name,</span><br><span class="line">    ArchiveOptions: &amp;binbundler.ArchiveOptions&#123;</span><br><span class="line">        DefaultPrefix: <span class="string">&quot;/path/to/extract&quot;</span>,</span><br><span class="line">        AutoExtract:   <span class="literal">true</span>,</span><br><span class="line">        AutoExecute:   <span class="literal">true</span>,</span><br><span class="line">        Command:       <span class="string">&quot;bash $PREFIX/install.sh&quot;</span>, # 安装命令，简单可直接执行，复杂可使用一个额外的脚本</span><br><span class="line">        Filename:      <span class="string">&quot;/path/to/embed&quot;</span>,</span><br><span class="line">    &#125;,</span><br><span class="line">&#125;</span><br><span class="line">err = b.Build(<span class="string">&quot;/path/to/script-save-to.sh&quot;</span>)</span><br></pre></td></tr></table></figure><p>在整个脚本中，动态插入了相关模板变量，并计算了相关 offset</p><h2 id="后记"><a href="#后记" class="headerlink" title="后记"></a>后记</h2><p>本文更多的只是提供一种思路（利用 dd 来解压、动态生成 opt 来控制执行过程），相比于网上更多的利用 grep 等手段来定位二进制内容更加的高效、易维护。</p><p>在此基础上，其实还可以实现更多的事情（依赖验证、安装多个文件等），欢迎尝试</p>]]></content>
    
    
      
      
    <summary type="html">&lt;h2 id=&quot;前言&quot;&gt;&lt;a href=&quot;#前言&quot; class=&quot;headerlink&quot; title=&quot;前言&quot;&gt;&lt;/a&gt;前言&lt;/h2&gt;&lt;p&gt;在构建 Linux&amp;#x2F;Unix 系安装包时，除了打包成标准的适用于各种发行版的软件包以外，我们更多的可能希望可以提供一个 shell</summary>
      
    
    
    
    
    <category term="linux" scheme="https://blog.singee.me/tags/linux/"/>
    
    <category term="shell" scheme="https://blog.singee.me/tags/shell/"/>
    
  </entry>
  
  <entry>
    <title>谈谈时区</title>
    <link href="https://blog.singee.me/2023/08/20/timezone/"/>
    <id>https://blog.singee.me/2023/08/20/timezone/</id>
    <published>2023-08-20T06:52:56.000Z</published>
    <updated>2023-08-20T06:52:56.000Z</updated>
    
    <content type="html"><![CDATA[<p>通常在本地化时往往会涉及到时区转换的问题，而通常在真正关注到时区之前我们所「默认」使用的时区为 UTC 或“本地”。</p><p>本文以 Go 为例，分析下 Go 中的时区使用。</p><h2 id="读取时区"><a href="#读取时区" class="headerlink" title="读取时区"></a>读取时区</h2><p>在 Go 中，读取时区使用的是 <code>LoadLocation</code> 函数。</p><figure class="highlight go"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">// LoadLocation returns the Location with the given name.</span></span><br><span class="line"><span class="comment">//</span></span><br><span class="line"><span class="comment">// If the name is &quot;&quot; or &quot;UTC&quot;, LoadLocation returns UTC.</span></span><br><span class="line"><span class="comment">// If the name is &quot;Local&quot;, LoadLocation returns Local.</span></span><br><span class="line"><span class="comment">//</span></span><br><span class="line"><span class="comment">// Otherwise, the name is taken to be a location name corresponding to a file</span></span><br><span class="line"><span class="comment">// in the IANA Time Zone database, such as &quot;America/New_York&quot;.</span></span><br><span class="line"><span class="comment">//</span></span><br><span class="line"><span class="comment">// LoadLocation looks for the IANA Time Zone database in the following</span></span><br><span class="line"><span class="comment">// locations in order:</span></span><br><span class="line"><span class="comment">//</span></span><br><span class="line"><span class="comment">// - the directory or uncompressed zip file named by the ZONEINFO environment variable</span></span><br><span class="line"><span class="comment">// - on a Unix system, the system standard installation location</span></span><br><span class="line"><span class="comment">// - $GOROOT/lib/time/zoneinfo.zip</span></span><br><span class="line"><span class="comment">// - the time/tzdata package, if it was imported</span></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">LoadLocation</span><span class="params">(name <span class="type">string</span>)</span></span> (*Location, <span class="type">error</span>)</span><br></pre></td></tr></table></figure><p>阅读注释可知，如果 name 为空 &#x2F; UTC 则使用 UTC、为 Local 则使用本地时区（在后面进行讲解），否则，从特定位置进行读取。</p><blockquote><p>所谓读取，是读取的 <a href="https://man7.org/linux/man-pages/man5/tzfile.5.html">tzfile</a> 时区文件，可阅读该文档查阅更多信息。简单来说，时区文件是一个以 <code>TZif</code> 开头的二进制文件，其中包含了时区的偏移量、闰秒、夏令时等信息，Go 可以读取相关文件并解析。</p></blockquote><ol><li>如果存在 <code>ZONEINFO</code> 环境变量，利用该变量指向的目录&#x2F;压缩文件进行读取</li><li>在 Unix 系统上，使用系统标准位置</li><li>（主要用于编译 Go 时）从 <code>$GOROOT/lib/time/zoneinfo.zip</code> 进行读取</li><li>（如果 import 了 <code>time/tzdata</code> ）从程序嵌入的数据读取</li></ol><p>我们比较关注的是 2，即 Unix 的标准时区文件的存储位置。在 Unix 系系统中，时区文件通常存储在 <code>/usr/share/zoneinfo/</code> 目录中（根据系统不同，还可能是 <code>/usr/share/lib/zoneinfo/ 或 /usr/lib/locale/TZ/</code>），例如，中国（<code>Asia/Shanghai</code>）的时区定义文件就是 <code>/usr/share/zoneinfo/Asia/Shanghai</code>。因此，通常程序可以直接从系统中获取到时区的信息。</p><p>注意，在 alpine 环境中，是没有时区定义文件的，因此我们需要特别关注进行处理</p><ol><li>可以在程序中使用 <code>import _ &quot;time/tzdata&quot;</code> 在编译期将时区文件编入程序中，这样在无法找到系统中的时区定义时也可以查找到标准的 IANA 时区定义</li><li>如果我们不需要特别动态的时区，我们可以避免使用 <code>LoadLocation</code> 而是使用 <code>FixedZone</code> 由我们自己提供时区名称和偏移，例如对于中国 UTF+8 可以使用 <code>time.FixedZone(&quot;Asia/Shanghai&quot;, 8*60*60)</code></li></ol><h2 id="本地时区"><a href="#本地时区" class="headerlink" title="本地时区"></a>本地时区</h2><p>通常在我们真正考虑到时区问题之前我们所「默认」使用的时区均为所谓的「本地时区」。</p><p>以 <code>time.Now</code> 为例，</p><figure class="highlight go"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">type</span> Time <span class="keyword">struct</span> &#123;</span><br><span class="line">wall <span class="type">uint64</span></span><br><span class="line">ext  <span class="type">int64</span></span><br><span class="line"></span><br><span class="line">loc *Location</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="comment">// Now returns the current local time.</span></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="title">Now</span><span class="params">()</span></span> Time &#123;</span><br><span class="line">sec, nsec, mono := now()</span><br><span class="line">mono -= startNano</span><br><span class="line">sec += unixToInternal - minWall</span><br><span class="line"><span class="keyword">if</span> <span class="type">uint64</span>(sec)&gt;&gt;<span class="number">33</span> != <span class="number">0</span> &#123;</span><br><span class="line"><span class="comment">// Seconds field overflowed the 33 bits available when</span></span><br><span class="line"><span class="comment">// storing a monotonic time. This will be true after</span></span><br><span class="line"><span class="comment">// March 16, 2157.</span></span><br><span class="line"><span class="keyword">return</span> Time&#123;<span class="type">uint64</span>(nsec), sec + minWall, Local&#125;</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">return</span> Time&#123;hasMonotonic | <span class="type">uint64</span>(sec)&lt;&lt;nsecShift | <span class="type">uint64</span>(nsec), mono, Local&#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>可以看到，<code>Time</code> 结构体的最后一个字段 <code>loc *Location</code> 就是时区，而 <code>time.Now</code> 中使用的时区为 <code>Local</code>。</p><blockquote><p>我们本文主要关注时区，如果你对这段代码中的其他因素感兴趣，欢迎阅读 <a href="https://articles.singee.me/golang-time">你真的了解 time.Now() 吗？</a>。</p></blockquote><p>这里的 <code>Local</code> 就是本地时区，即运行这个程序所在的机器的时区。</p><figure class="highlight go"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">// Local represents the system&#x27;s local time zone.</span></span><br><span class="line"><span class="comment">// On Unix systems, Local consults the TZ environment</span></span><br><span class="line"><span class="comment">// variable to find the time zone to use. No TZ means</span></span><br><span class="line"><span class="comment">// use the system default /etc/localtime.</span></span><br><span class="line"><span class="comment">// TZ=&quot;&quot; means use UTC.</span></span><br><span class="line"><span class="comment">// TZ=&quot;foo&quot; means use file foo in the system timezone directory.</span></span><br><span class="line"><span class="keyword">var</span> Local *Location = &amp;localLoc</span><br></pre></td></tr></table></figure><p>阅读 Go 中关于 <code>Local</code> 的说明可知，Go 会优先尊重 <code>TZ</code> 环境变量所指定的时区，如果没有特殊指定，则使用 <a href="https://man7.org/linux/man-pages/man5/localtime.5.html">&#x2F;etc&#x2F;localtime</a> 文件读取当前时区。</p><p>那么，<code>Local</code> 又是怎么初始化的呢？</p><figure class="highlight go"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><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">// localLoc is separate so that initLocal can initialize</span></span><br><span class="line"><span class="comment">// it even if a client has changed Local.</span></span><br><span class="line"><span class="keyword">var</span> localLoc Location</span><br><span class="line"><span class="keyword">var</span> localOnce sync.Once</span><br><span class="line"></span><br><span class="line"><span class="function"><span class="keyword">func</span> <span class="params">(l *Location)</span></span> get() *Location &#123;</span><br><span class="line"><span class="keyword">if</span> l == <span class="literal">nil</span> &#123;</span><br><span class="line"><span class="keyword">return</span> &amp;utcLoc</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">if</span> l == &amp;localLoc &#123;</span><br><span class="line">localOnce.Do(initLocal)</span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">return</span> l</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>从这段代码的逻辑中不难<em>猜</em>出，<code>Local</code> 并没有真的在程序启动时读取上述信息，而是在首次使用时才真正的通过执行 <code>initLocal</code> 函数来进行初始化。同时，这段代码也隐性的为使用 Location 提出了一个要求：必须调用 get 方法来获取「真正的 Location」。</p><p><code>initLocal</code> 函数在 <code>zoneinfo_*.go</code> 中定义，在不同的机器上有着不同的实现，但本质上都是</p><blockquote><p>如果 TZ 内容以 <code>:</code> 开头，则会忽略该冒号</p></blockquote><ol><li>如果没有指定 TZ 环境变量，阅读 <code>/etc/localtime</code>（通常就是指向了真正时区文件的软链接）</li><li>如果指定的 TZ 环境变量为绝对路径，阅读该文件</li><li>否则按照上文所分析的 LoadLocation 流程进行时区文件的读取</li></ol><p>另外，上述 3 步骤如果失败，会 fallback 到使用 UTC 时间</p><h2 id="加餐：tzdata"><a href="#加餐：tzdata" class="headerlink" title="加餐：tzdata"></a>加餐：tzdata</h2><p>tzdata 详细定义了历史时区的变更情况，包括夏令时、闰秒等，因此 <code>Asia/Shanghai</code> 相比于简单的 <code>GMT+8</code> 更具有通用性、且可正确处理历史数据。</p><p>如果你感兴趣，可以利用 <code>zdump Asia/Shanghai -i</code> 查看上海的时区变化，并和使用夏令时的时间 <code>zdump America/Chicago -i</code> 进行对比。</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;通常在本地化时往往会涉及到时区转换的问题，而通常在真正关注到时区之前我们所「默认」使用的时区为 UTC 或“本地”。&lt;/p&gt;
&lt;p&gt;本文以 Go 为例，分析下 Go 中的时区使用。&lt;/p&gt;
&lt;h2 id=&quot;读取时区&quot;&gt;&lt;a href=&quot;#读取时区&quot; class=&quot;heade</summary>
      
    
    
    
    
    <category term="linux" scheme="https://blog.singee.me/tags/linux/"/>
    
    <category term="Go" scheme="https://blog.singee.me/tags/Go/"/>
    
  </entry>
  
  <entry>
    <title>利用 Fly.io 部署 Windmill</title>
    <link href="https://blog.singee.me/2023/08/02/deploy-windmill-on-fly/"/>
    <id>https://blog.singee.me/2023/08/02/deploy-windmill-on-fly/</id>
    <published>2023-08-02T06:01:17.000Z</published>
    <updated>2023-08-02T06:01:17.000Z</updated>
    
    <content type="html"><![CDATA[<p><a href="https://windmill.dev/">Windmill</a> 是一个开源可自部署的工作流引擎（甚至低代码平台），可访问 <a href="https://www.windmill.dev/docs/compared_to">https://www.windmill.dev/docs/compared_to</a> 查看其官方与 Zapier 等服务的对比。</p><p>本文将展示如何将其部署到  <a href="https://fly.io/">Fly.io</a></p><h2 id="概览"><a href="#概览" class="headerlink" title="概览"></a>概览</h2><p>本文介绍了两种方式来进行部署 Windmill，我分别称之为 minimal 和 full 模式。</p><p>在 minimal 模式下，所有 Windmill 组件运行在单一 app 中，这是最简单且经济的方案，但是不够灵活（例如，因为 Server 和 Worker 运行在同一个容器中，难以水平扩展）；<br>在 full 模式下，Windmill 组件被拆分至两个不同的 app 中，其中一个运行 Server，另一个运行 Worker，相比于 minimal 方案较为复杂，但是可以让你更灵活的控制分布式的 Worker。</p><p>请克隆仓库 <a href="https://github.com/imsingee/windmill-on-fly">windmill-on-fly</a>，然后继续下面的步骤。</p><h2 id="LSP-组件"><a href="#LSP-组件" class="headerlink" title="LSP 组件"></a>LSP 组件</h2><blockquote><p>minimal 与 full 均需预先安装 LSP</p></blockquote><p>LSP 提供了 Windmill 前端页面上的代码补全功能，需要独立部署。 </p><h3 id="Launch-Deploy"><a href="#Launch-Deploy" class="headerlink" title="Launch &amp; Deploy"></a>Launch &amp; Deploy</h3><blockquote><p>如果想要修改区域，请修改 <code>fly.toml</code> 文件中的 <code>primary_region</code> 字段（默认为 sea）。如果修改区域，建议将所有 app 的区域保持一致以获得最佳体验。</p></blockquote><p>进入 lsp 目录下，执行 <code>fly launch</code> 来启动项目；启动时，针对 <code>Would you like to copy its configuration to the new app? (y/N)</code> 问询选择 <code>Y</code>，并稍后为该 app 起个名字。</p><blockquote><p>后续本文中如果出现 <code>my-windmill-lsp</code> 请替换成你在这里设置的 app 名称。</p></blockquote><p>在接下来的问询中，<strong>不要</strong>创建 Postgresql 和 Redis（针对相关问询均选择 <code>N</code>）。</p><p>最后询问 <code>Would you like to deploy now? (y/N)</code> 时选择 <code>Y</code> 来进行部署。</p><h3 id="分配-IP"><a href="#分配-IP" class="headerlink" title="分配 IP"></a>分配 IP</h3><p>部署完成后，执行 <code>fly ips allocate-v6 --private</code> 来为服务分配一个 Private IP（你也可以同时删除所有的 Public IP）。</p><h3 id="Scale"><a href="#Scale" class="headerlink" title="Scale"></a>Scale</h3><p>LSP 对于性能的要求比较高。基于我实际感受，想要正常使用建议至少为其分配 4GB 内存。可执行 <code>fly scale vm performance-2x</code> 进行 Scale。</p><blockquote><p>考虑到价格因素，可开启 <code>fly.toml</code> 中的 <code>auto_start_machines=true</code> 和 <code>auto_stop_machines=true</code> 来节省成本</p></blockquote><h2 id="Minimal-模式部署"><a href="#Minimal-模式部署" class="headerlink" title="Minimal 模式部署"></a>Minimal 模式部署</h2><blockquote><p>如果你选择 Full 模式，请跳过当前步骤</p></blockquote><p>下面所有的操作均在 minimal 目录下进行。</p><h3 id="Launch"><a href="#Launch" class="headerlink" title="Launch"></a>Launch</h3><p>执行 <code>fly launch</code> 来启动项目；启动时，针对 <code>Would you like to copy its configuration to the new app? (y/N)</code> 问询选择 <code>Y</code>，并稍后为该 app 起个名字。</p><blockquote><p>后续本文中如果出现 <code>my-windmill</code> 请替换成你在这里设置的 app 名称</p></blockquote><p>在接下来的问询中，<strong>不要</strong>创建 Postgresql 和 Redis（针对相关问询均选择 <code>N</code>）。</p><p>最后询问 <code>Would you like to deploy now? (y/N)</code> 时选择 <code>N</code> 来跳过 Deploy。</p><h3 id="配置数据库"><a href="#配置数据库" class="headerlink" title="配置数据库"></a>配置数据库</h3><p>请跟随 <a href="https://fly.io/docs/postgres/">Fly Postgres 教程</a> 先创建好一个数据库集群。</p><blockquote><p>请将下面命令中的 <code>my-pg</code> 修改为你的数据库集群的名称</p></blockquote><p>执行 <code>fly pg attach my-pg --superuser</code> 来创建数据库与用户。</p><h3 id="配置-LSP"><a href="#配置-LSP" class="headerlink" title="配置 LSP"></a>配置 LSP</h3><p>编辑 <code>Caddyfile</code>，将其中的 <code>xxx-windmill-lsp</code> 修改成你自己的 windmill-lsp 的服务名。</p><h3 id="（可选）绑定自定义域名"><a href="#（可选）绑定自定义域名" class="headerlink" title="（可选）绑定自定义域名"></a>（可选）绑定自定义域名</h3><blockquote><p>如果你没有或不想绑定自定义域名，请跳过此步骤。</p></blockquote><p>执行 <code>fly certs add YOUR_DOMAIN</code> 配置自定义域名（将 <code>YOUR_DOMAIN</code> 替换为你的域名），并按照要求配置相应的 CNAME 记录。</p><h3 id="配置环境变量"><a href="#配置环境变量" class="headerlink" title="配置环境变量"></a>配置环境变量</h3><p>打开 <code>fly.toml</code> 文件，将 <code>env.BASE_URL</code> 修改为你的外部访问域名 —— 如果你没有使用自定义域名，那么这里输入 <code>https://my-windmill.fly.dev</code>，否则输入 <code>https://YOUR_DOMAIN</code>。</p><p>如果你想修改 worker 的数量，可修改 <code>env.NUM_WORKERS</code> 的变量值。</p><h3 id="Deploy"><a href="#Deploy" class="headerlink" title="Deploy"></a>Deploy</h3><p>输入 <code>fly deploy</code> 进行部署（部署过程中会自动构建所需镜像、创建需要的 volume）。等待部署成功后访问你的实例，测试利用账号  <code>admin@windmill.dev</code> 密码 <code>changeme</code> 登录。</p><h2 id="Full-模式部署"><a href="#Full-模式部署" class="headerlink" title="Full 模式部署"></a>Full 模式部署</h2><blockquote><p>如果你选择 Minimal 模式，请跳过当前步骤</p></blockquote><p>full 目录下包括两个目录 - server 与 worker，分别存储了 Server 与 Worker 组件的配置。</p><h3 id="Server-Launch"><a href="#Server-Launch" class="headerlink" title="Server - Launch"></a>Server - Launch</h3><p>进入 <code>full/server</code> 目录下，执行 <code>fly launch</code> 来启动项目；启动时，针对 <code>Would you like to copy its configuration to the new app? (y/N)</code> 问询选择 <code>Y</code>，并稍后为该 app 起个名字。</p><blockquote><p>后续本文中如果出现 <code>my-windmill-server</code> 请替换成你在这里设置的 app 名称</p></blockquote><p>在接下来的问询中，<strong>不要</strong>创建 Postgresql 和 Redis（针对相关问询均选择 <code>N</code>）。</p><p>最后询问 <code>Would you like to deploy now? (y/N)</code> 时选择 <code>N</code> 来跳过 Deploy。</p><h3 id="Server-配置数据库"><a href="#Server-配置数据库" class="headerlink" title="Server - 配置数据库"></a>Server - 配置数据库</h3><p>请跟随 <a href="https://fly.io/docs/postgres/">Fly Postgres 教程</a> 先创建好一个数据库集群。</p><blockquote><p>请将下面命令中的 <code>my-pg</code> 修改为你的数据库集群的名称；下面命令中的 database-name 和 database-user 均使用 <code>windmill</code>，你也可以自行修改成你需要的名字。</p></blockquote><p>进入 <code>full/server</code> 目录下，执行 <code>fly pg attach my-pg --superuser --database-name windmill --database-user windmill</code> 来创建数据库与用户。</p><p><strong>记录上述命令执行时打印出来的 DATABASE_URL 备用</strong> </p><h3 id="Server-配置-LSP"><a href="#Server-配置-LSP" class="headerlink" title="Server - 配置 LSP"></a>Server - 配置 LSP</h3><p>进入 <code>full/server</code> 目录下，编辑 <code>Caddyfile</code>，将其中的 <code>xxx-windmill-lsp</code> 修改成你自己的 windmill-lsp 的服务名。</p><h3 id="（可选）Server-绑定自定义域名"><a href="#（可选）Server-绑定自定义域名" class="headerlink" title="（可选）Server - 绑定自定义域名"></a>（可选）Server - 绑定自定义域名</h3><blockquote><p>如果你没有或不想绑定自定义域名，请跳过此步骤。</p></blockquote><p>进入 <code>full/server</code> 目录下，执行 <code>fly certs add YOUR_DOMAIN</code> 配置自定义域名（将 <code>YOUR_DOMAIN</code> 替换为你的域名），并按照要求配置相应的 CNAME 记录。</p><h3 id="Server-配置环境变量"><a href="#Server-配置环境变量" class="headerlink" title="Server - 配置环境变量"></a>Server - 配置环境变量</h3><p>进入 <code>full/server</code> 目录下，打开 <code>fly.toml</code> 文件，将 <code>env.BASE_URL</code> 修改为你的外部访问域名 —— 如果你没有使用自定义域名，那么这里输入 <code>https://my-windmill-server.fly.dev</code>，否则输入 <code>https://YOUR_DOMAIN</code>。</p><h3 id="Server-Deploy"><a href="#Server-Deploy" class="headerlink" title="Server - Deploy"></a>Server - Deploy</h3><p>进入 <code>full/server</code> 目录下，输入 <code>fly deploy</code> 进行部署（部署过程中会自动构建所需镜像、创建需要的 volume）。</p><p>新版无 volume 的 fly app 会默认部署两个实例，Server 使用多实例的意义通常不大，可执行 <code>fly scale count 1</code> 将多余的实例删除。</p><p>等待部署成功后访问你的实例，测试利用账号  <code>admin@windmill.dev</code> 密码 <code>changeme</code> 登录。</p><h3 id="Worker-Launch"><a href="#Worker-Launch" class="headerlink" title="Worker - Launch"></a>Worker - Launch</h3><p>进入 <code>full/worker</code> 目录下，执行 <code>fly launch</code> 来启动项目；启动时，针对 <code>Would you like to copy its configuration to the new app? (y/N)</code> 问询选择 <code>Y</code>，并稍后为该 app 起个名字。</p><blockquote><p>后续本文中如果出现 <code>my-windmill-worker</code> 请替换成你在这里设置的 app 名称</p></blockquote><p>在接下来的问询中，<strong>不要</strong>创建 Postgresql 和 Redis（针对相关问询均选择 <code>N</code>）。</p><p>最后询问 <code>Would you like to deploy now? (y/N)</code> 时选择 <code>N</code> 来跳过 Deploy。</p><h3 id="Worker-配置数据库"><a href="#Worker-配置数据库" class="headerlink" title="Worker - 配置数据库"></a>Worker - 配置数据库</h3><p>进入 <code>full/worker</code> 目录下，执行 <code>fly secrets set &#39;DATABASE_URL=xxx&#39; --stage</code> 来配置连接数据库的凭据。（将 <code>xxx</code> 替换成上面步骤中打印出来的 DATABASE_URL 的内容）</p><h3 id="Worker-配置环境变量"><a href="#Worker-配置环境变量" class="headerlink" title="Worker - 配置环境变量"></a>Worker - 配置环境变量</h3><p>进入 <code>full/worker</code> 目录下，打开 <code>fly.toml</code> 文件，将 <code>env.BASE_URL</code> 修改为你的 windmill-server 的外部访问域名 —— 如果你没有使用自定义域名，那么这里输入 <code>https://my-windmill-server.fly.dev</code>，否则输入 <code>https://YOUR_DOMAIN</code>。</p><p>如果你想修改 worker 的数量，可修改 <code>env.NUM_WORKERS</code> 的变量值。</p><h3 id="Worker-Deploy"><a href="#Worker-Deploy" class="headerlink" title="Worker - Deploy"></a>Worker - Deploy</h3><p>进入 <code>full/worker</code> 目录下，输入 <code>fly deploy</code> 进行部署。</p><p>访问你实例的 &#x2F;workers 路由（例如 <code>https://my-windmill-server.fly.dev/workers</code>）查看是否有你的 Worker 展示。</p><h2 id="常见问题"><a href="#常见问题" class="headerlink" title="常见问题"></a>常见问题</h2><h3 id="升级（或指定版本号）"><a href="#升级（或指定版本号）" class="headerlink" title="升级（或指定版本号）"></a>升级（或指定版本号）</h3><p>当前所有版本号均使用 <code>latest</code>，这在生产上可能不适用（因为每次重新部署都会升级到最新版本）。</p><p>版本号存在于如下的文件中</p><ul><li><code>lsp/fly.toml</code></li><li><code>minimal/Dockerfile</code></li><li><code>full/server/Dockerfile</code></li><li><code>full/worker/fly.toml</code></li></ul><p>你可将这些文件中的 <code>&quot;ghcr.io/windmill-labs/windmill:latest&quot;</code> 中的 latest 换成你希望的版本号，例如 <code>1.133</code>。</p><p>唯一需要着重注意的点：请始终保持所有版本号一致，否则可能出现未知问题。</p><p>升级：修改版本号后在各自相关目录下重新执行 <code>fly deploy</code> 即可。</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;&lt;a href=&quot;https://windmill.dev/&quot;&gt;Windmill&lt;/a&gt; 是一个开源可自部署的工作流引擎（甚至低代码平台），可访问 &lt;a href=&quot;https://www.windmill.dev/docs/compared_to&quot;&gt;https://www</summary>
      
    
    
    
    
    <category term="Fly.io" scheme="https://blog.singee.me/tags/Fly-io/"/>
    
    <category term="Windmill" scheme="https://blog.singee.me/tags/Windmill/"/>
    
  </entry>
  
  <entry>
    <title>强制关闭 xLog 的 Dark Mode</title>
    <link href="https://blog.singee.me/2023/08/02/force-disable-xlog-dark-mode/"/>
    <id>https://blog.singee.me/2023/08/02/force-disable-xlog-dark-mode/</id>
    <published>2023-08-01T22:30:15.000Z</published>
    <updated>2023-08-01T23:06:43.000Z</updated>
    
    <content type="html"><![CDATA[<p>自从 xLog 引入了 Dark Mode 以后，因为大大降低了对比度造成文字灰色可读性差，我就暂停使用了 xLog （同时暂停了写作和阅读）而期待官方更新。然而，数月过去了，依然没有丝毫改善（难道开发团队都没人用 Dark Mode 吗）…… 行吧，自己动手，丰衣足食🌚</p><h2 id="关闭自己博客的-Dark-Mode"><a href="#关闭自己博客的-Dark-Mode" class="headerlink" title="关闭自己博客的 Dark Mode"></a>关闭自己博客的 Dark Mode</h2><p>因为 xLog 不支持自定义 js，故无法直接修改 xLog 的 Dark Mode 判断逻辑。因此，只能强行将 Dark Mode 模式下的 CSS 覆盖成 Light Mode 的。</p><blockquote><p><strong>警告</strong><br>使用该功能意味着需要时刻跟随 xLog 的官方样式更新，否则会造成博客效果变差。如果使用请自行承担相关风险。<br>下面的 CSS 尽可能覆盖了所有 Dark Mode 下的样式，并隐藏了 Theme Switcher（可查看当前站点来预览效果）。<br>另外，因为 xLog 使用了 Service Worker，修改站点样式后可能需要刷新两次才能预览到最新效果。</p></blockquote><details><summary> 附：CSS </summary><p>首先打开你的博客页面，切换成 Light Mode，然后在浏览器控制台执行下面的脚本来获取你的主题色</p><blockquote><p>当然，你也可以从其他人的 xLog 博客中执行来获取他的主题色</p></blockquote><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="string">&#x27;--auto-hover-color&#x27;</span>, <span class="string">&#x27;--auto-theme-color&#x27;</span>, <span class="string">&#x27;--auto-banner-bg-color&#x27;</span>].<span class="title function_">forEach</span>(<span class="function"><span class="params">name</span> =&gt;</span> <span class="variable language_">console</span>.<span class="title function_">log</span>(<span class="string">`<span class="subst">$&#123;name&#125;</span>: <span class="subst">$&#123;getComputedStyle(<span class="variable language_">document</span>.documentElement).getPropertyValue(name)&#125;</span> !important;`</span>))</span><br></pre></td></tr></table></figure><p>使用获取到的值来替换下面的第一个 <code>.dark</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><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></pre></td><td class="code"><pre><span class="line"><span class="selector-class">.dark</span> &#123; <span class="comment">/* 将下面的三个变量值替换 */</span></span><br><span class="line">   <span class="attr">--auto-hover-color</span>: <span class="number">#e9e7e8</span> <span class="meta">!important</span>;</span><br><span class="line">   <span class="attr">--auto-theme-color</span>: <span class="number">#bd80bd</span> <span class="meta">!important</span>;</span><br><span class="line">   <span class="attr">--auto-banner-bg-color</span>: <span class="number">#d3cfd2</span> <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-class">.dark</span> <span class="selector-class">.xlog-banner</span> &#123;</span><br><span class="line">    <span class="attribute">background-color</span>: <span class="built_in">var</span>(--banner-bg-color, <span class="number">#f9f9f9</span>) <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">.dark</span> &#123;</span><br><span class="line">    <span class="attr">--border-color</span>: <span class="number">#eee</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attribute">color-scheme</span>: light <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-pseudo">:root</span> &#123;</span><br><span class="line">    <span class="attr">--csb-ck-color-text</span>: <span class="number">46</span>,<span class="number">46</span>,<span class="number">46</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--csb-ck-color-text2</span>: <span class="number">17</span>,<span class="number">17</span>,<span class="number">17</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--csb-ck-color-text-subtle</span>: <span class="number">153</span>,<span class="number">153</span>,<span class="number">153</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--csb-ck-color-bg</span>: <span class="number">255</span>,<span class="number">255</span>,<span class="number">255</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--csb-ck-color-bg1</span>: <span class="number">247</span>,<span class="number">247</span>,<span class="number">247</span> <span class="meta">!important</span>;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="selector-pseudo">:root</span> &#123;</span><br><span class="line">    <span class="attr">--tw-color-black</span>: <span class="number">0</span> <span class="number">0</span> <span class="number">0</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-white</span>: <span class="number">255</span> <span class="number">255</span> <span class="number">255</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-slate-50</span>: <span class="number">248</span> <span class="number">250</span> <span class="number">252</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-slate-100</span>: <span class="number">241</span> <span class="number">245</span> <span class="number">249</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-slate-200</span>: <span class="number">226</span> <span class="number">232</span> <span class="number">240</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-50</span>: <span class="number">249</span> <span class="number">250</span> <span class="number">251</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-100</span>: <span class="number">243</span> <span class="number">244</span> <span class="number">246</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-200</span>: <span class="number">229</span> <span class="number">231</span> <span class="number">235</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-300</span>: <span class="number">209</span> <span class="number">213</span> <span class="number">219</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-400</span>: <span class="number">156</span> <span class="number">163</span> <span class="number">175</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-500</span>: <span class="number">107</span> <span class="number">114</span> <span class="number">128</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-600</span>: <span class="number">75</span> <span class="number">85</span> <span class="number">99</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-700</span>: <span class="number">55</span> <span class="number">65</span> <span class="number">81</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-800</span>: <span class="number">31</span> <span class="number">41</span> <span class="number">55</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-gray-900</span>: <span class="number">17</span> <span class="number">24</span> <span class="number">39</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-50</span>: <span class="number">250</span> <span class="number">250</span> <span class="number">250</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-100</span>: <span class="number">244</span> <span class="number">244</span> <span class="number">245</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-200</span>: <span class="number">228</span> <span class="number">228</span> <span class="number">231</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-300</span>: <span class="number">212</span> <span class="number">212</span> <span class="number">216</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-400</span>: <span class="number">161</span> <span class="number">161</span> <span class="number">170</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-500</span>: <span class="number">113</span> <span class="number">113</span> <span class="number">122</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-600</span>: <span class="number">82</span> <span class="number">82</span> <span class="number">91</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-700</span>: <span class="number">63</span> <span class="number">63</span> <span class="number">70</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-800</span>: <span class="number">39</span> <span class="number">39</span> <span class="number">42</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-zinc-900</span>: <span class="number">24</span> <span class="number">24</span> <span class="number">27</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-stone-400</span>: <span class="number">168</span> <span class="number">162</span> <span class="number">158</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-red-100</span>: <span class="number">254</span> <span class="number">226</span> <span class="number">226</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-red-200</span>: <span class="number">254</span> <span class="number">202</span> <span class="number">202</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-red-400</span>: <span class="number">248</span> <span class="number">113</span> <span class="number">113</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-red-500</span>: <span class="number">239</span> <span class="number">68</span> <span class="number">68</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-red-600</span>: <span class="number">220</span> <span class="number">38</span> <span class="number">38</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-red-700</span>: <span class="number">185</span> <span class="number">28</span> <span class="number">28</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-orange-50</span>: <span class="number">255</span> <span class="number">247</span> <span class="number">237</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-orange-100</span>: <span class="number">255</span> <span class="number">237</span> <span class="number">213</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-orange-200</span>: <span class="number">254</span> <span class="number">215</span> <span class="number">170</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-orange-400</span>: <span class="number">251</span> <span class="number">146</span> <span class="number">60</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-orange-500</span>: <span class="number">249</span> <span class="number">115</span> <span class="number">22</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-orange-600</span>: <span class="number">234</span> <span class="number">88</span> <span class="number">12</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-orange-700</span>: <span class="number">194</span> <span class="number">65</span> <span class="number">12</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-yellow-200</span>: <span class="number">254</span> <span class="number">240</span> <span class="number">138</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-yellow-400</span>: <span class="number">250</span> <span class="number">204</span> <span class="number">21</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-yellow-500</span>: <span class="number">234</span> <span class="number">179</span> <span class="number">8</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-green-100</span>: <span class="number">220</span> <span class="number">252</span> <span class="number">231</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-green-200</span>: <span class="number">187</span> <span class="number">247</span> <span class="number">208</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-green-400</span>: <span class="number">74</span> <span class="number">222</span> <span class="number">128</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-green-500</span>: <span class="number">34</span> <span class="number">197</span> <span class="number">94</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-green-600</span>: <span class="number">22</span> <span class="number">163</span> <span class="number">74</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-green-700</span>: <span class="number">21</span> <span class="number">128</span> <span class="number">61</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-teal-600</span>: <span class="number">13</span> <span class="number">148</span> <span class="number">136</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-sky-500</span>: <span class="number">14</span> <span class="number">165</span> <span class="number">233</span> <span class="meta">!important</span>;</span><br><span class="line">    <span class="attr">--tw-color-sky-700</span>: <span class="number">3</span> <span class="number">105</span> <span class="number">161</span> <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">footer</span>&gt;<span class="selector-tag">div</span>&gt;<span class="selector-tag">button</span><span class="selector-attr">[role=switch]</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></details><h2 id="关闭他人博客的-Dark-Mode"><a href="#关闭他人博客的-Dark-Mode" class="headerlink" title="关闭他人博客的 Dark Mode"></a>关闭他人博客的 Dark Mode</h2><p>因为 xLog 支持自定义域名，而暗色模式的 Theme Switcher 仅在当前域名上生效，因此无法简单地为所有站点关闭 Dark Mode。只能…… 写一个脚本检测到是 xLog 后强制关闭深色模式。</p><p>脚本：<a href="https://greasyfork.org/zh-CN/scripts/472216-auto-disable-xlog-dark-mode">https://greasyfork.org/zh-CN/scripts/472216-auto-disable-xlog-dark-mode</a> 可自由取用（以 MIT 协议开源）。</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;自从 xLog 引入了 Dark Mode 以后，因为大大降低了对比度造成文字灰色可读性差，我就暂停使用了 xLog （同时暂停了写作和阅读）而期待官方更新。然而，数月过去了，依然没有丝毫改善（难道开发团队都没人用 Dark Mode 吗）…… 行吧，自己动手，丰衣足食🌚</summary>
      
    
    
    
    
    <category term="前端" scheme="https://blog.singee.me/tags/%E5%89%8D%E7%AB%AF/"/>
    
    <category term="xLog" scheme="https://blog.singee.me/tags/xLog/"/>
    
  </entry>
  
  <entry>
    <title>解决 CentOS8 中 yum 源失效</title>
    <link href="https://blog.singee.me/2023/06/07/baf5a24c337a4c3f8666398d601f97d5/"/>
    <id>https://blog.singee.me/2023/06/07/baf5a24c337a4c3f8666398d601f97d5/</id>
    <published>2023-06-06T21:34:00.000Z</published>
    <updated>2023-06-08T20:01:00.000Z</updated>
    
    <content type="html"><![CDATA[<p>先吐槽下，为什么 CentOS 会 breaking 正常运行的系统啊</p><p>如果之前没有配置过其他镜像的话</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">sed -i <span class="string">&#x27;s/mirrorlist/#mirrorlist/g&#x27;</span> /etc/yum.repos.d/CentOS-*</span><br><span class="line">sed -i <span class="string">&#x27;s|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g&#x27;</span> /etc/yum.repos.d/CentOS-*</span><br></pre></td></tr></table></figure><p>如果配置过的话，将 baseurl 中的域名改成 <code>http://vault.centos.org</code> 就好（注意只支持 HTTP）</p><p>这个原因是，因为 CentOS 8 Deprecated 了于是就在 Mirror 中把仓库删了🙃</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;先吐槽下，为什么 CentOS 会 breaking 正常运行的系统啊&lt;/p&gt;
&lt;p&gt;如果之前没有配置过其他镜像的话&lt;/p&gt;
&lt;figure class=&quot;highlight bash&quot;&gt;&lt;table&gt;&lt;tr&gt;&lt;td class=&quot;gutter&quot;&gt;&lt;pre&gt;&lt;span cl</summary>
      
    
    
    
    
    <category term="centos" scheme="https://blog.singee.me/tags/centos/"/>
    
    <category term="随笔" scheme="https://blog.singee.me/tags/%E9%9A%8F%E7%AC%94/"/>
    
  </entry>
  
  <entry>
    <title>[随笔] 避免完美主义导致的看似时间不够</title>
    <link href="https://blog.singee.me/2023/05/23/memos_171/"/>
    <id>https://blog.singee.me/2023/05/23/memos_171/</id>
    <published>2023-05-23T07:43:46.000Z</published>
    <updated>2023-09-17T21:21:14.000Z</updated>
    
    <content type="html"><![CDATA[<p>我经常会有想做一件事然后看了下时间可支配时间只有半小时了然后就会想「只有半小时了，等时间充裕的时候再做吧」然后一点点拖延下去</p><p>然而突然发现，以时间不够为为理由的拖延不但是完美主义的表现之一，更是一种可笑的借口</p><p>时间是最最宝贵的不可再生资源，一天可支配时间有 12 小时已经很了不起了，半小时已经是一天中的 1&#x2F;24 了、半小时已经可以做很多事了。<br>而一周多来几次半小时的话，完成的事情可能已经抵得上正常半天甚至一天的任务量了。<br>更何况，借效率之名实拖延之事、让时间白白流逝，才是更可惜、又可笑的。</p><p>action &gt;&gt; thinking</p>]]></content>
    
    
      
      
    <summary type="html">&lt;p&gt;我经常会有想做一件事然后看了下时间可支配时间只有半小时了然后就会想「只有半小时了，等时间充裕的时候再做吧」然后一点点拖延下去&lt;/p&gt;
&lt;p&gt;然而突然发现，以时间不够为为理由的拖延不但是完美主义的表现之一，更是一种可笑的借口&lt;/p&gt;
&lt;p&gt;时间是最最宝贵的不可再生资源，一天可</summary>
      
    
    
    
    <category term="随笔" scheme="https://blog.singee.me/categories/%E9%9A%8F%E7%AC%94/"/>
    
    
  </entry>
  
</feed>
