Niracler's TIL 每日一学

Mired 与 Kelvin：深入理解色温控制

Wed, 07 May 2025 16:47:53 +0800

1 要点总结

Mired 和 Kelvin 是色温控制中常用的两种单位。Kelvin (K) 直接测量光源的色温，是色温的标准单位。然而，人类对色温变化的感知并非线性，例如 3000K 到 4000K 的变化比 5000K 到 6000K 的变化在视觉上更为显著。Mired（微互成度）是 Kelvin 的倒数乘以一百万（$M = \frac{1,000,000}{T}$），它提供了一个更符合人类感知的线性尺度。色温概念起源于17世纪牛顿的光学实验，Kelvin 温标在19世纪由开尔文勋爵提出。1932年，Irwin G. Priest 提出了 Mired 的概念，以解决 Kelvin 尺度在感知上的非线性问题。色温广泛应用于摄影（白平衡）、照明设计（营造氛围）和显示技术（颜色校准）等领域。

2 Mired 和 Kelvin 的定义与区别

2.1 Kelvin (K)

Kelvin 是国际单位制中温度的基本单位，也用于衡量光源的颜色温度。色温描述的是一个理想黑体辐射器加热到特定温度时所发出的光的颜色。例如：

蜡烛火焰：约 1850K
钨丝灯泡（家用）：约 2700-3300K
日光（平均）：约 5600K
阴天：约 6500-7500K

Kelvin 值直接反映了光源的物理特性。然而，正如前面提到的，Kelvin 尺度在描述人类对色温变化的感知时存在非线性问题。

2.2 Mired (Micro Reciprocal Degree)

Mired，即微倒数度或微互成度，是为了弥补 Kelvin 在感知线性度上的不足而引入的单位。其计算公式为：

$$ M = \frac{1,000,000}{T_K} $$

其中 $T_K$ 是以 Kelvin 为单位的色温。

通过 Mired，色温变化的感知变得更加线性。例如：

从 3000K (333 Mired) 到 4000K (250 Mired) 的变化是 83 Mired。
从 5000K (200 Mired) 到 6000K (167 Mired) 的变化是 33 Mired。

这更准确地反映了人眼对前者色温变化更为敏感的事实。

2.3 主要区别

特性	Kelvin (K)	Mired
定义	色温的绝对单位，基于黑体辐射	色温的倒数，更符合人类感知
感知线性度	非线性	相对线性
主要用途	定义光源的固有色温	计算色温校正值（如滤镜），调整色温
示例	日光灯约为 5600K	从 3200K 调至 5500K 需约 -137 Mired 滤镜

在实际应用中，Kelvin 通常用于标识光源本身固有的色温类型，而 Mired 则更多地应用于需要调整或校正色温的场景，尤其是在摄影和专业照明领域，它可以帮助精确计算所需的滤镜强度。

3 Mired 和 Kelvin 的前世今生

色温概念的发展历程漫长而有趣：

17世纪：艾萨克·牛顿爵士 (Sir Isaac Newton) 在1665年通过三棱镜实验，将白光分解为七色光谱（红、橙、黄、绿、蓝、靛、紫），奠定了现代光学和颜色理论的基础。
19世纪：随着温度测量技术的发展，科学家们开始探索热与光之间的关系。威廉·汤姆森，即后来的开尔文勋爵 (Lord Kelvin)，在19世纪中期提出了绝对温标，即 Kelvin 温标，以绝对零度 (-273.15°C) 为起点。这为色温的量化提供了标准单位。
20世纪初：色温测量和标准化取得重要进展。1931年，国际照明委员会 (CIE) 定义了 CIE XYZ 色彩空间，并引入了相关色温 (Correlated Color Temperature, CCT) 的概念，用于描述非理想黑体光源的颜色特性。
1932年：美国国家标准局的科学家欧文·G·普里斯特 (Irwin G. Priest) 发表了关键论文，指出人类对色温差异的感知与色温的倒数值成正比，而非色温的绝对差值。他因此提出了 “Mired” (micro-reciprocal-degree) 这一单位。这一发现极大地推动了色温在实际应用中的精确控制，特别是在摄影滤镜和照明设计领域。Mired 的引入有效解决了 Kelvin 尺度在感知上的非线性问题。

苹果的 HomeKit 平台也采用 Mired 来指定灯光的色温，进一步证明了其在现代智能家居技术中的实用性。

4 关于色温的那些事

色温不仅仅是一个物理参数，它深刻影响着我们的视觉体验和心理感受。

暖色调与冷色调：
- 低色温（通常低于 3300K）的光源呈现偏红、橙、黄的暖色调，能营造出温馨、舒适、放松的氛围，例如白炽灯和日出日落时的阳光。
- 高色温（通常高于 5300K）的光源呈现偏蓝的冷色调，能带来清爽、专注、警觉的感觉，例如正午日光和阴天的光线。
- 中等色温（3300K - 5300K）的光线则相对中性，常被称为"白光"。
摄影与白平衡 (White Balance, WB)：人类的视觉系统具有很强的适应性，可以在不同色温的光线下识别出物体本来的颜色。但相机等成像设备则不然，它们需要通过"白平衡"设置来校正不同光源下的颜色偏差，以确保白色物体在照片中呈现为准确的白色。摄影师常根据拍摄环境的色温（如钨丝灯 3200K，闪光灯 5500K）调整相机的白平衡，或使用不同 Mired 值的滤色片来达到期望的色温效果。
照明设计：在室内外照明设计中，色温的选择至关重要。
- 家居照明：卧室、客厅等区域通常采用暖色温（2700K-3000K）光源，以营造舒适放松的氛围。书房、厨房等区域可能选用中性或稍冷的色温（3500K-4500K）以提高专注度和清晰度。
- 商业与办公照明：办公室、商场、医院等场所常采用中性到冷白色温（4000K-6500K），有助于提高工作效率和警觉性。
- 显色指数 (Color Rendering Index, CRI)：除了色温，光源的显色指数也非常重要。CRI衡量光源还原物体真实颜色的能力，高CRI（通常大于80或90）的光源能更准确地展现物品的色彩。
显示技术与色彩校准：显示器、电视和投影仪等设备的色彩表现也与色温密切相关。D65 (对应约 6504K) 是一个常见的行业标准白点，用于确保在不同设备上观看内容时颜色的一致性。

4.1 常见光源色温及对应 Mired 值

光源类型	色温 (K)	Mired 值
烛光	1850	541
白炽灯 (100W)	2800-2900	357-345
卤素灯	3000	333
钨丝灯 (摄影棚)	3200	312
日出/日落	2000-3000	500-333
LED (暖白)	2700-3000	370-333
LED (中性白)	3500-4500	286-222
LED (冷白/日光型)	5000-6500	200-154
正午太阳光	5000-5800	200-172
电子闪光灯	5500-6000	182-167
阴天/多云	6500-7500	154-133
显示器标准 (D65)	6504	154

数据来源: 综合 Wikipedia 及行业常见数值。

5 总结与展望

Kelvin 和 Mired 都是描述色温的重要单位，但它们各有侧重。Kelvin 直接定义了光源的物理色温，而 Mired 则提供了一个更符合人类视觉感知的尺度，尤其在需要精确调整色温的摄影和照明领域中至关重要。从牛顿的光学启蒙到现代复杂的照明系统，对色温的理解和应用不断深化。随着 LED 技术和智能控制系统的发展，未来我们可以期待更加个性化、更利于健康的动态色温照明方案，Mired 和 Kelvin 的概念将继续在其中扮演核心角色。

6 参考资料与拓展阅读

Mired - Wikipedia
Color temperature - Wikipedia
Colour temperature: mireds versus Kelvin – Visuals Producer
Priest, I. G. (1932). A proposed scale for use in specifying the chromaticity of incandescent illuminants and various phases of daylight. Journal of the Optical Society of America, 23(2), 41-45. (DOI: 10.1364/JOSA.23.000041)
Apple Developer Documentation - HMCharacteristicTypeColorTemperature
Understanding color temperature - Westinghouse Lighting
Color Temperature - Evident Scientific
Mired/Filter Calculator - Points in Focus Photography
WHAT COLOUR IS THAT TEMPERATURE? - Video & Filmmaker magazine

物联网照明的类型分析

Tue, 06 May 2025 16:36:23 +0800

1 要点总结

物联网中的灯主要包括可调光（DIM）、可调色温（CCT）、可变色（RGB）等类型，这些分类基于灯具功能。这些分类不是协议，而是描述灯具能力的术语，它们是通用的照明功能描述。照明工程协会（IES）可能通过标准如ANSI/IES LP-12-21提供了相关指导，但这些分类并非由单一机构提出。

2 灯的种类与分类

物联网中的灯根据其控制功能分为几类，例如：

可调光（DIM）：可以调节亮度的灯。
可调色温（CCT）：可以改变白光温暖程度的灯，从暖白到冷白。
可变色（RGB）：通过混合红、绿、蓝三种颜色产生多种颜色的灯。
还有组合类型如RGBW（RGB+白光）和RGB+CCT（RGB+可调色温）。

这些分类帮助用户根据需求选择合适的灯具，例如在卧室可能更喜欢暖白光（CCT），而在娱乐场所可能需要彩色灯光（RGB）。

3 分类是否为协议

DIM、CCT、RGB等分类不是协议，而是灯具功能的描述。在物联网中，这些灯通过如Zigbee、Wi-Fi、Bluetooth或Matter等标准协议进行控制，但这些术语本身不属于协议。

4 提出机构

这些分类是照明行业的通用术语，照明工程协会（IES）通过标准如ANSI/IES LP-12-21 IoT Connected Lighting提供了相关指导，但并非由单一机构独家提出。

5 详细分析

5.1 物联网中灯的种类功能详解

根据功能，物联网中的灯可以分为以下几类：

可调光（DIM）：指可以调节亮度的灯，用户可以通过IoT设备调整光线强弱，适合需要不同照明环境的空间。
可调色温（CCT）：即Correlated Color Temperature，可调白光灯，可以从暖白（约2700K）调整到冷白（6500K以上），用于创建不同的氛围，例如卧室可能偏向暖白，办公室可能偏向冷白。
可变色（RGB）：通过红、绿、蓝三种LED组合，可以产生1600万种颜色，适合娱乐场所或装饰照明。
RGBW：在RGB基础上增加白光LED，提供更真实的白光，适合需要高质量白光的场景。
RGB+CCT：结合RGB的颜色变化和CCT的可调白光功能，适合多功能需求的空间。

5.2 分类原因分析

这些分类的目的是描述灯具的不同控制能力，满足多样化的照明需求：

DIM功能适合节能和氛围调节，如餐厅可能需要低亮度营造温馨环境。
CCT功能影响光线的温暖程度，研究表明不同色温对人体生理和心理有不同影响，例如暖光有助于放松，冷光提升专注力。
RGB功能则用于装饰和动态照明，如节日灯光或舞台效果。

从技术角度，这些分类反映了LED技术的进步和IoT控制的灵活性。用户可以通过智能手机或智能家居系统远程调整这些功能，增强了便利性和个性化。

5.3 RGB、RGBW和RGB-CCT的比较

以下表格比较了RGB、RGBW和RGB-CCT的差异，基于Lucas LED的分析：

类型	描述	颜色能力	白光细节	核心线数	LED芯片数
RGB	使用红、绿、蓝LED，提供1600万种颜色	1600万种颜色，可调饱和度和亮度	无真实白光，白色由RGB组合生成，非纯白	4	3
RGBW	在RGB基础上增加白光LED，提供真实白光	1600万种颜色+真实白光，可选暖白、自然白、冷白	真实白光，选项取决于型号/用途	5	4
RGB-CCT	结合全色谱+可调白光，从暖白到冷白	1600万种颜色+白光全谱	两个白光芯片覆盖2700K到6500K+	6	5

5.4 未来趋势

当前，IoT照明市场快速增长，DIM、CCT、RGB功能的集成度越来越高。研究表明，未来可能出现更多组合功能，如"Dim-to-Warm"（调光变暖），进一步模糊分类界限。

6 参考资料

使用 Caddy 将运行在云服务器特定端口上的服务通过 HTTPS 暴露在指定域名下

Tue, 29 Apr 2025 09:08:26 +0800

1 要干什么

要使用 Caddy 将运行在云服务器特定端口上的服务通过 HTTPS 暴露在指定域名下。

2 要怎么干

2.1 安装 Caddy

确保服务器上已安装 Caddy。您可以从 Caddy 官方网站获取安装指南。安装完成后，可以通过以下命令确认 Caddy 的安装路径：

which caddy

2.2 配置 DNS

将域名的 DNS 记录指向您的云服务器的公网 IP 地址。

2.3 配置 Caddyfile

Caddy 的默认配置文件路径为 /etc/caddy/Caddyfile。使用文本编辑器打开配置文件：

sudo nano /etc/caddy/Caddyfile

添加以下配置内容：

example.com {
 reverse_proxy localhost:<PORT>
}

2.4 管理 Caddy 服务

重启 Caddy 服务以应用新配置：

sudo systemctl restart caddy

检查服务状态：

sudo systemctl status caddy

2.5 验证 HTTPS

Caddy 会自动为您的域名获取并安装 SSL 证书。在浏览器中访问 https://example.com，确认可以通过 HTTPS 访问服务。

3 注意事项

Caddy 默认会自动处理 HTTPS 证书的获取和续期，简化了 HTTPS 配置过程。

解决 Surge 增强模式下 UDP 组播失效的问题

Wed, 23 Apr 2025 16:15:51 +0800

1 要干什么

今天在 macOS 上使用一个 Node.js 脚本通过 UDP 组播 (Multicast) 发现局域网内的智能网关设备。脚本大致逻辑是向组播地址 239.255.255.250 的 1900 端口发送发现指令，并监听本地端口等待设备响应。

在 Surge 未开启增强模式 (Enhanced Mode) 时，脚本工作正常。但一旦开启增强模式，即使 Surge 规则配置了局域网直连，脚本也无法收到任何设备的响应。同时，开启了 Surge 的 DHCP 功能。

2 探索过程

初步排查:
- 确认 Surge 规则中 FINAL,PROXY 或类似规则不会拦截局域网通信。
- 确认 macOS 防火墙允许 Node.js 或相应端口的入站连接。
- 尝试在脚本中将组播地址改为广播地址 (192.168.x.255)，发现可以工作，这暗示问题与组播的路由方式有关。
理解 Surge 增强模式:
- Surge 的增强模式会在 macOS 中创建一个虚拟网络接口 (TUN)，通常名为 utunX。
- 系统会将默认路由指向这个 TUN 接口，使得几乎所有的网络流量（除少数系统服务或特殊配置外）先经过 Surge 处理，再决定是走代理还是直连。
分析组播与 TUN 的冲突:
- UDP 组播依赖于网络接口加入特定的组播组 (client.addMembership(multicast_addr)) 以及从正确的接口发送组播包 (socket.send(..., multicast_addr))。
- 当增强模式开启时，由于默认路由指向 utunX，脚本：
  - 发送组播包时，系统倾向于通过 utunX 发送，但 TUN 接口本身通常不适合直接处理物理局域网的组播。
  - 监听并加入组播组时，可能也是在 utunX 接口上完成的，导致无法接收到来自物理网卡 (如 en0) 的组播包。
- 简单来说，流量被 Surge “劫持”到了 TUN 接口，但组播这种特殊的局域网通信方式在 TUN 接口上“迷路”了。

3 解决方案

核心思路是让发往组播地址的流量绕过 TUN 接口，直接通过物理网卡发送和接收。

在 Surge 的配置文件 config.conf (或其他你使用的配置文件) 的 [General] 部分，添加或修改 tun-excluded-routes 选项，将所有 IP 组播地址范围排除掉：

[General]
# ... 其他通用设置 ...

# 添加 224.0.0.0/4 到排除列表
tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, 224.0.0.0/4

解释:

224.0.0.0/4 这个 CIDR 地址块覆盖了从 224.0.0.0 到 239.255.255.255 的所有 IPv4 组播地址范围 (Class D)。
tun-excluded-routes 的作用是在系统路由表中添加特定的路由规则，告诉 macOS：凡是目标地址匹配这些网段的数据包，不要发送给 Surge 创建的 TUN 接口，而是根据系统原有的路由规则（通常是直接走物理网卡）处理。
添加 224.0.0.0/4 后，当你的脚本向 239.255.255.250 发送数据时，系统会匹配到这条排除规则，数据包将直接通过物理网卡发出。同样，物理网卡接收到的组播包也能被正确监听。

操作: 修改配置后，在 Surge 菜单中选择「重新载入配置」使设置生效。

4 最小化测试用例 (Python)

可以创建两个简单的 Python 脚本来模拟这个问题和验证解决方案：

发送端 (sender.py):

import socket
import time

MULTICAST_GROUP = '239.255.255.250'
MULTICAST_PORT = 1900
MESSAGE = b'Simple Multicast Test Message'

# 创建 UDP socket
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)

# 设置 TTL (Time-To-Live)，防止包在网络中无限循环
# 1 表示只在本地子网传播
sock.setsockopt(socket.IPPROTO_IP, socket.IP_MULTICAST_TTL, 1)

print(f"Sending message to {MULTICAST_GROUP}:{MULTICAST_PORT}")
try:
 while True:
 sock.sendto(MESSAGE, (MULTICAST_GROUP, MULTICAST_PORT))
 print(".", end="", flush=True)
 time.sleep(2)
except KeyboardInterrupt:
 print("\nSender stopped.")
finally:
 sock.close()

接收端 (receiver.py):

import socket
import struct

MULTICAST_GROUP = '239.255.255.250'
LISTEN_PORT = 1900
LISTEN_IP = '0.0.0.0' # 监听所有接口

# 创建 UDP socket
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)

# 允许端口复用
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)

# 绑定到监听地址和端口
sock.bind((LISTEN_IP, LISTEN_PORT))

# 告诉内核加入组播组
# INADDR_ANY 表示使用默认接口，但当 TUN 存在时可能选错
# 如果需要显式指定接口，可以用物理网卡的 IP 替换 INADDR_ANY
group = socket.inet_aton(MULTICAST_GROUP)
mreq = struct.pack('4sL', group, socket.INADDR_ANY) # Use INADDR_ANY by default
# 或者: mreq = struct.pack('4s4s', group, socket.inet_aton('YOUR_PHYSICAL_IP'))

sock.setsockopt(socket.IPPROTO_IP, socket.IP_ADD_MEMBERSHIP, mreq)

print(f"Listening on {LISTEN_IP}:{LISTEN_PORT} for multicast group {MULTICAST_GROUP}")

try:
 while True:
 data, addr = sock.recvfrom(1024)
 print(f"Received message: '{data.decode()}' from {addr}")
except KeyboardInterrupt:
 print("\nReceiver stopped.")
finally:
 # 退出组播组
 sock.setsockopt(socket.IPPROTO_IP, socket.IP_DROP_MEMBERSHIP, mreq)
 sock.close()

测试步骤:

开启 Surge 增强模式，但不加 tun-excluded-routes 规则:
- 在一台电脑上运行 python receiver.py。
- 在同一局域网的另一台电脑 (或本机，如果网络允许) 上运行 python sender.py。
- 预期：接收端收不到消息。
在 Surge 配置中添加 tun-excluded-routes = ..., 224.0.0.0/4 并重载:
- 保持接收端运行。
- 再次运行发送端。
- 预期：接收端能够收到发送端的消息。

5 关键知识点

Surge 增强模式 (TUN): 通过创建虚拟网卡拦截和重定向系统流量，实现更底层的代理控制。
UDP 组播: 一种一对多的网络通信方式，数据包发送到特定的组播地址，只有加入了该组播组的接口才能收到。常用于设备发现、流媒体等。
路由: 网络数据包根据目标地址选择下一跳和出接口的过程。增强模式会修改默认路由。
tun-excluded-routes: Surge 配置项，用于指定哪些目标地址的流量不应被发送到 TUN 接口，从而绕过 Surge 的底层处理，直接按系统原有路由规则转发（通常是物理网卡）。
224.0.0.0/4: IPv4 组播地址的标准范围。

6 总结

Surge 的增强模式通过 TUN 接口改变了系统的默认路由行为，这可能干扰依赖特定接口或路由方式的协议，如 UDP 组播。通过在 tun-excluded-routes 中排除组播地址范围 (224.0.0.0/4)，可以强制组播流量绕过 TUN 接口，恢复其在局域网中的正常通信。

四块半榻榻米大小

Fri, 11 Apr 2025 10:37:19 +0800

昨天在读谷川俊太郎的《一个人生活》，开篇就提到了「四块半榻榻米大小」，这个颇具日本特色的描述引起了我的兴趣。我们常听说日本房间用榻榻米计数，但这「四叠半」究竟是多大，又有什么特别的含义呢？

什么是「四叠半」？

「四叠半」（Yojōhan）是日语中描述房间大小的说法，「叠」（Jō）指的就是榻榻米（Tatami），「半」（Han）则是半块。所以，「四叠半」字面意思就是能放下四块标准榻榻米和半块榻榻米的房间。

榻榻米是日本传统的草编地垫，除了铺设地面，也长期作为计算房间面积的单位。不过，榻榻米的尺寸并非全国统一，根据地区不同有所差异：

地区	尺寸 (米)	面积 (平方米)	备注
京都 (京間, Kyōma)	1.91 × 0.955	≈ 1.82	较长，常见于关西、中国、四国地区的传统建筑
名古屋 (中京間, Chūkyōma)	1.82 × 0.91	≈ 1.65	中间尺寸，常用作标准，亦称「三六間」(3×6 尺)
东京 (江戸間, Edoma)	1.76 × 0.88	≈ 1.55	较小，常见于关东及以北地区，亦称「五八間」(5.8×2.9 尺)

注：尺寸基于传统单位「尺」（shaku），1 尺约 0.303 米。尺寸和面积为近似值。

以最常见的名古屋尺寸（中京間）计算，一块榻榻米约 1.65 平方米，那么四叠半的总面积就是 $4.5 \times 1.65 \approx 7.43$ 平方米。如果按东京尺寸（江戸間）算，则是 $4.5 \times 1.55 \approx 6.98$ 平方米。

所以，「四叠半」大约是一个 7 到 7.5 平方米（约 75-80 平方英尺）见方的空间，常见的布局是中间放半叠，四周环绕四叠，形成约 2.7 米 × 2.7 米的正方形。

（看到这张图，我就觉得挺有趣的）

文化意义

在日本，四叠半不仅仅是一个面积单位，更承载着特定的文化含义：

茶室的标准尺寸：根据 Wikipedia 关于榻榻米的介绍，四叠半是日本传统茶室（茶室, Chashitsu）的典型规格。这种紧凑的空间被认为有助于集中精神，营造茶道所追求的宁静、亲密和简约的氛围。
极简生活与蜗居的象征：四叠半也常常象征着极小的居住空间。如 NamuWiki 相关条目所述，在 20 世纪 60 年代，经济拮据的年轻人（所谓的「穷青年」）常居住在这种狭小的公寓中，甚至催生了相关的「四叠半民谣」文化，带有一丝清贫或无奈的色彩。日本也有谚语「起き半畳、寝一畳」（醒时半叠，睡时一叠），意指人实际所需空间有限，体现了知足常乐或物尽其用的观念。

《四叠半神话大系》

提到「四叠半」，很多人可能会联想到森见登美彦的小说及其改编的动画《四叠半神话大系》（四畳半神話大系, The Tatami Galaxy）。这部作品以京都大学附近常见的四叠半房间为舞台，讲述了主角在不同平行世界中选择不同社团，经历荒诞青春的故事。标题本身就点明了这种空间在日本文化，尤其是学生生活中的代表性。虽然我还没看过 Dynasty Reader 上的 The Legend of the Great Four-and-a-Half Tatami Room，但标题也暗示了四叠半这一意象的延伸。

总而言之，「四叠半」不仅是一个具体的尺寸概念（约 7-7.5 平方米），更是一个蕴含着日本茶道文化、极简主义、乃至一代人生活记忆的文化符号。下次再看到这个词，就能更好地理解其背后的含义了。

通过 jq 获取 pinboard 的文章列表, 并转换为 markdown 格式

Fri, 21 Mar 2025 10:41:51 +0800

1 要干什么

主要是为了写周记的时候方便，可以直接复制粘贴。

2 偷工减料版

export PINBOARD_TOKEN=your-api-token
curl -sS "https://api.pinboard.in/v1/posts/all?format=json&auth_token=$PINBOARD_TOKEN" \
 | jq -r '.[] | "- [\(.description)](\(.href)) - \(.extended)"'

效果，就是生成像下面这种格式的 markdown 列表

- [simonw/til: Today I Learned](https://github.com/simonw/til/blob/main/ab/apache-bench-length-errors.md) - 可以考虑用这种格式来写 TIL, 纯 markdown 就可以了，大块代码以及图片用外面的链接就好。关键是每一个思路要写完整，不要滥竽充数。然后达到一定的
- [Downloading a video should be “fair use” as recording a song from the radio | Hacker News --- 下载视频应该像从广播中录制歌曲一样“合理使用”|黑客新闻](https://news.ycombinator.com/item?id=37112615) - 其实我还是不懂这种下载是违法还是怎么说
- [一个大学老师决定去送外卖](https://mp.weixin.qq.com/s/cSL-Inf0QDKOPJd4yzkAGw) - <blockquote>长年在象牙塔内，他想从封闭、自负和优越感中突围。</blockquote>
- [中国的防火长城是如何检测和封锁完全加密流量的](https://gfw.report/publications/usenixsecurity23/zh/) -
- [You’re probably using the wrong dictionary « the jsomers.net blog --- 您可能使用了错误的字典 « jsomers.net 博客](https://jsomers.net/blog/dictionary) - 一个好的词典原来作用可以这么大
- [使用自动化工作流聚合信息摄入和输出 | Reorx’s Forge](https://reorx.com/blog/sharing-my-footprints-automation/) - <blockquote>展示我是如何用 n8n 将 Twitter, YouTube, GitHub, Douban 等服务的动态同步到 Telegram Channel，实现个人数字生活的信息聚合。</blockquote>
- [nodebestpractices/README.chinese.md at master · goldbergyoni/nodebestpractices](https://github.com/goldbergyoni/nodebestpractices/blob/master/README.chinese.md) -
- [37%法則 - MBA智库百科](https://wiki.mbalib.com/zh-tw/37%25%E6%B3%95%E5%88%99#:~:text=%5B%E7%B7%A8%E8%BC%AF%5D-,%E4%BB%80%E9%BA%BC%E6%98%AF37%25%E6%B3%95%E5%89%87,%E4%B9%9F%E5%B0%B1%E6%98%AF11%E5%80%8B%E6%88%BF%E5%AD%90%E3%80%82) - <blockquote>37%法則、37%規則37%法則，出自《演算法之美》一書。意思是經過數學家歐拉的實驗，以37%作為分界點，前面的時間用來觀察，後面的時間用來作決策的一種方法。舉例來說，比如要買房子，整個地區的房子有30處，那麼需要先看37%的房子，也就是11個房子。37%前的房子只看不買，但是要記住自己認為最好的是什麼樣子。看完後，從37%以後只有遇到比之前最好的還要好的房子就應該下手買。</blockquote>
- [（译）2023 年每个软件开发者都必须知道的关于 Unicode 的基本知识 | 新世界的大门](https://blog.xinshijiededa.men/unicode/) - <blockquote>自从那时以来，Python 已经进步了，CD-ROM 已经过时了，但其余的仍然停留在 UTF-16 或甚至 UCS-2。因此，UTF-16 作为内存表示而存在。

PS. 注意，国内需要代理才能访问 pinboard.in

杂鱼想法: 更好的设计是不是应该就是 ny pinboard export –md ? 代理、token 什么都自动设好。 pinboard cli （伪）。

3 参考资料

pinboard password - 这里可以找到 token
pinboard api - 还可以加更多一些过滤条件，例如 tag 以及时间
jq Manual (development version) - 这个其实问 gpt 即可，’ 用 jq 命令去 parse, 格式为每行 description - extended'

为我的博客添加媒体预览和 RSS 支持

Thu, 20 Mar 2025 15:52:32 +0800

1 要干什么

我想为博客增强元数据功能，主要包括两方面：

添加媒体预览功能，使文章在社交平台（如Telegram）上分享时能显示精美的预览图；
实现RSS订阅功能，方便读者及时获取博客更新。这些改进将提升博客的专业性和用户体验。

2 开始我们的美化工作吧

2.1 设置预览图和摘要

---
title: "OpenWRT 设置启用 IPv6 让子设备能拿到 IPv6 的 公网 IP （原理未明）"
summary: '为了可以更方便 Tailscale 穿透。'
cover:
 image: 'https://image.niracler.com/2025/03/5c38aaa0c519bf066184b086c76d5304.png'
---

其实这里有点小问题，封面在正文里也会显示。与我的初衷不符，不过下次再改吧。

（效果图什么的）

（遗憾的是，Telegram Instant View 要申请好像挺困难的。但整个预览区域是可点击的，直接链接到文章。）

2.2 添加网站图标（Favicon）

为博客添加一个网站图标可以提升专业性，并在浏览器标签页中显示您的品牌标识。以下是添加 favicon 的步骤：

准备图标文件：建议使用 .ico 格式，尺寸为 32×32 或 16×16 像素。也可以使用 PNG 格式。
添加到静态目录：将图标文件放入项目的 static 文件夹中：
- 直接放入 favicon.ico 到 static 目录
- 或创建 static/images 目录并放入图标文件
配置设置：在 hugo.toml 配置文件中添加：

[params]
 favicon = "img/favicon.png" # 放在 static/img 目录

可以使用在线工具如 favicon.io 生成各种尺寸的图标。添加图标后，网站在浏览器标签页中会显示您的品牌标识，让博客更加专业化。

(效果图)

2.2 添加 RSS 支持

全文 RSS 设置 : Hugo 默认生成包含摘要的 RSS 提要，但您可以启用全文。在 PaperMod 主题中，可以在 hugo.toml 中添加：

[params]
 ShowFullTextinRSS = true

 # 顺便添加 RSS 图标
 [[params.socialIcons]]
 name = "rss"
 url = "index.xml" # 或使用完整链接 "https://til.niracler.com/index.xml"

(效果图)

然后顺手做个 Follow 认证吧。

2.3 添加 RSS feed 描述以验证所有权

要在 RSS feed 中添加特定的描述文本以便在 RSS 阅读器中声明所有权，需要创建自定义的 RSS 模板：

创建自定义 RSS 模板：在项目根目录创建 layouts/_default/rss.xml 文件（如果不存在）

编辑 RSS 模板：将以下内容复制到该文件中（关键是修改 <description> 标签）：

{{- $pctx := . -}}
{{- if .IsHome -}}{{ $pctx = .Site }}{{- end -}}
{{- $pages := slice -}}
{{- if or $.IsHome $.IsSection -}}
{{- $pages = $pctx.RegularPages -}}
{{- else -}}
{{- $pages = $pctx.Pages -}}
{{- end -}}
{{- $limit := .Site.Config.Services.RSS.Limit -}}
{{- if ge $limit 1 -}}
{{- $pages = $pages | first $limit -}}
{{- end -}}
{{- printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
 <channel>
 <title>{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}</title>
 <link>{{ .Permalink }}</link>
 <follow_challenge>
 <feedId>125502964885313536</feedId>
 <userId>41434914948866048</userId>
 </follow_challenge>
 <description>Recent content on Niracler's TIL 每日一学</description>
 <generator>Hugo -- gohugo.io</generator>{{ with .Site.LanguageCode }}
 <language>{{.}}</language>{{end}}{{ with .Site.Author.email }}
 <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Author.email }}
 <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }}
 <copyright>{{.}}</copyright>{{end}}{{ if not .Date.IsZero }}
 <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
 {{- with .OutputFormats.Get "RSS" -}}
 {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
 {{- end -}}
 {{ range $pages }}
 <item>
 <title>{{ .Title }}</title>
 <link>{{ .Permalink }}</link>
 <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
 {{ with .Site.Author.email }}<author>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</author>{{end}}
 <guid>{{ .Permalink }}</guid>
 <description>{{ with .Description }}{{ . }}{{ else }}{{ if .Site.Params.ShowFullTextinRSS }}{{ .Content | html }}{{ else }}{{ .Summary | html }}{{ end }}{{ end }}</description>
 </item>
 {{ end }}
 </channel>
</rss>

重新构建网站部署

(可以啦)

关键引文

折腾 Hugo & PaperMod 主题

一个纠正我写作表达的 prompt

Wed, 19 Mar 2025 19:02:48 +0800

1 要干什么

整理了一个写作表达用的 prompt ，主要用来矫正我文字表达很啰嗦的问题

2 内容

你是我的写作老师，若是我文章中遇到了这些问题，请你帮我纠正:

- **抽象名词的过度使用**：中文不习惯用抽象名词做主词，如「收入减少改变生活方式」，应改为「他因为收入减少而改变生活方式」。
- **冗赘句式**：将简单的表达变得复杂，如「因此」变成「基于这个原因」。
- **成语的衰退**：成语的使用减少，影响了文化意识，如只会说「总的来说」，不会说「总而言之」。
- **动词弱化**：简单动词被抽象名词和泛动词替代，如「贡献」变成「作出贡献」。
- **介词滥用**：如「有关」和「关于」等词的过度使用。
- **连接词的多余**：如「和」、「与」、「及」、「以及」等连接词的过多使用。
- **复数语尾的滥用**：如「人们」取代「人人」、「大家」。

**改进建议**

- 避免使用不必要的抽象名词和冗赘句式，保持句子简洁明了。
- 多使用成语，保持文化的传承。
- 简化动词表达，避免使用抽象名词词组。
- 减少介词和连接词的使用，保持句子的流畅和自然。
- 不必要使用复数语尾，以免句子显得繁琐。

若是还有其余的歧义、错别字什么的也一定要提出来。将修改后的文章发出来并在回复的时候写清楚每一处为什么要这么改。

3 参考

-《余光中: 怎样改进英式中文？ –论中文的常态与变态》 - 找不到原文了（

将所有邮箱整合到 Fastmail 并同步到 Apple Mail

Tue, 18 Mar 2025 18:28:47 +0800

1 要干什么

我想把任何邮件都转发到 Fastmail 邮箱，然后 Fastmail 转发到 Apple Mail。

2 从其他邮箱到 fastmail 邮箱

2.1 QQ 邮箱邮件迁移并同步到 Fastmail

在 QQ 邮箱中启用IMAP服务是同步的前提条件。操作步骤如下：

登录QQ邮箱，进入设置-帐户
勾选"开启IMAP服务"
生成授权码（POP3/IMAP/SMTP服务项）

（中间会有几次发送短信的流程）

然后来到 Fastmail，在 My email address 中点击 Add address

其实我们要做的是 Migrate an address。

然后我们选到 Other（同时我们可以看到 Gmail 那种要同步的话，是超级简单的）

就是填上面拿到的授权码，不是你登陆邮箱的密码。

那我们来开导吧～～

也算是将各种乱七八糟的邮箱迁移到 Fastmail 了。

3 Apple Mail 的 Fastmail 配置

在 Apple Mail 中，添加账户，然后选择其他账户，然后选择 Fastmail。

然后在 Fastmail 中的 Privacy & security -> Connected apps & API tokens 点击 Manage app passwords and access

我们 new 一个 password

然后再回到 Apple Mail 中，填入刚才的 password 就可以了。

4 总结

大功告成！

OpenWRT 设置启用 IPv6 让子设备能拿到 IPv6 的公网 IP （原理未明）

Fri, 14 Mar 2025 14:00:00 +0800

1 要干什么

我想给我宿舍的 window 配置好公网的 IPv6 然后方便可以使用 tailscale 进行穿透。

2 关键要点（未经校对）

研究表明，配置 OpenWrt 的 IPv6 需要通过 WAN6 接口使用 DHCPv6 从 ISP 获取前缀。
证据倾向于 LAN 接口设置 ip6assign 64，以分配 /64 前缀给子设备，方便它们通过 SLAAC 或 DHCPv6 获取地址。
防火墙配置需要允许 LAN 到 WAN6 的流量转发，可能涉及额外的安全考虑。
测试连通性可使用 test-ipv6.com 确保子设备能访问 IPv6 站点。

3 配置步骤

注意：以下的配置文件修改改的都是 /etc/config/network 这个文件。

3.1 确认 ISP 支持和接口名称

首先，确保你的 ISP 提供 IPv6 支持，并确定 OpenWrt 中的 WAN 和 LAN 接口名称。通常为 ‘wan’ 和 ’lan’，可通过查看 /etc/config/network 确认。

3.2 配置 WAN 接口（IPv4）

确保 WAN 接口已正确配置 IPv4（如 DHCP 或静态 IP）。示例配置（DHCP）：

config interface 'wan'
 option device 'eth0'
 option proto 'dhcp'

如果 ISP 使用 PPPoE，需相应调整。

3.3 配置 WAN6 接口（IPv6）

创建或配置 WAN6 接口，使用 dhcpv6 协议从 ISP 获取 IPv6 前缀。示例：

config interface 'wan6'
 option device 'eth0' # 与 WAN 接口相同
 option proto 'dhcpv6'

3.4 配置 LAN 接口（IPv6）

将 LAN 接口设置为桥接模式，协议为静态，并设置 ip6assign 64 以分配 /64 前缀。示例：

config interface 'lan'
 option type 'bridge'
 option ifname 'eth1' # 替换为实际 LAN 接口名称
 option proto 'static'
 option ipaddr '192.168.2.1' # IPv4 地址（可选）
 option netmask '255.255.255.0' # IPv4 子网掩码（可选）
 option ip6assign '64'

3.5 配置 DHCP 服务器（IPv6）

确保 DHCP 服务器为 LAN 接口提供路由器广告（RA）和/或 DHCPv6 服务。示例：

config dhcp 'lan'
 option interface 'lan'
 option dhcpv6 'server'
 option ra 'server'

3.6 配置防火墙（IPv6）

为 WAN6 接口创建单独的防火墙区域，并允许从 LAN 到 WAN6 的流量转发。示例：

config zone
 option name 'wan6'
 option network 'wan6'
 option family 'ipv6'
 option input 'ACCEPT'
 option output 'ACCEPT'
 option forward 'REJECT'
config forwarding
 option dest 'wan6'
 option src 'lan'

3.7 应用更改

保存配置并重启网络和防火墙服务：

uci commit
service network restart
service firewall restart

3.8 最终结果

这是我最后得到的 /etc/config/network

$cat /etc/config/network

config interface 'loopback'
 option device 'lo'
 option proto 'static'
 option ipaddr '127.0.0.1'
 option netmask '255.0.0.0'

config globals 'globals'
 option ula_prefix 'fdd4:40f1:2b71::/48'

config device
 option name 'br-lan'
 option type 'bridge'
 list ports 'eth0'

config interface 'lan'
 option type 'bridge'
 option ifname 'eth0'
 option proto 'static'
 option ipaddr '192.168.2.1'
 option netmask '255.255.255.0'
 option ip6assign '64'
 option interface 'lan'
 option dhcpv6 'server'
 option ra 'server'

config zone
 option name 'wan6'
 option network 'wan6'
 option family 'ipv6'
 option input 'ACCEPT'
 option output 'ACCEPT'
 option forward 'REJECT'

config forwarding
 option dest 'wan6'
 option src 'lan'

config interface 'wan'
 option device 'eth1'
 option proto 'dhcp'

config interface 'wan6'
 option device 'eth1'
 option proto 'dhcpv6'

4 测试和验证

从路由器 ping IPv6 地址测试连通性，例如：

$ ping6 2001:4860:4860::8888
PING 2001:4860:4860::8888 (2001:4860:4860::8888): 56 data bytes
64 bytes from 2001:4860:4860::8888: seq=0 ttl=54 time=21.947 ms
64 bytes from 2001:4860:4860::8888: seq=1 ttl=54 time=21.384 ms
64 bytes from 2001:4860:4860::8888: seq=2 ttl=54 time=22.012 ms
64 bytes from 2001:4860:4860::8888: seq=3 ttl=54 time=21.772 ms
^C
--- 2001:4860:4860::8888 ping statistics ---
4 packets transmitted, 4 packets received, 0% packet loss
round-trip min/avg/max = 21.384/21.778/22.012 ms

从子设备进行相同测试，确保能访问 IPv6 站点。使用 test-ipv6.com 验证 IPv6 连通性。

(虽然说感觉有什么问题，但大体上是可以的)

到此，我 windows 设备使用 tailscale netcheck 能拿到公网 IPv6 了。

5 关键引文（未经校对）

从零开始使用 Hugo 在 Cloudflare Pages 上搭建 TIL 博客

Thu, 13 Mar 2025 14:00:00 +0800

1 要干什么

本文提供了一个全面的指南，帮助开发者在 Cloudflare Pages 上使用 Hugo 构建一个 TIL（Today I Learned）博客，用于记录和发布每天学到的内容。以下是详细步骤，适合 Hugo 新手但有一定技术背景的用户。


第一作者	Grok DeepSearch
校对&编辑	Niracler
排版	claude-3.7-sonnet-thinking
Hugo 版本	v0.145.0

Prompt

1.1 Prompt（此处应折叠）

我是一个开发者，之前使用过 Hexo 搭建博客系统，但现在想尝试在 Cloudflare Pages 上使用 Hugo 静态网站框架搭建一个 TIL（Today I Learned）博客，用来记录和发布我每天学到的东西。我对 Hugo 是新手，但有一定的技术背景。我希望这个博客有以下特点：

1. **主题要求**：
 - 功能完整且足够多（支持标签、分类、搜索功能等）。
 - 加载速度快，轻量级。
 - 设计风格可爱一些。

2. **GitHub 仓库**：
 - 我需要从头开始创建一个 GitHub 仓库，并连接到 Cloudflare Pages 进行自动部署。

3. **内容结构**：
 - 完全从零开始的 TIL 记录。
 - 按日期排序，并支持标签（tag）功能。

4. **额外功能**：
 - 评论系统。
 - 访问统计。
 - 社交分享按钮。

请提供一个详细的指南，包括以下内容：

- 如何安装和配置 Hugo。
- 推荐一个符合我要求的 Hugo 主题，并说明如何安装和配置。
- 如何创建 GitHub 仓库并连接到 Cloudflare Pages。
- 如何编写和发布 TIL 条目。
- 如何添加评论系统、访问统计和社交分享按钮等额外功能。

请确保指南适合 Hugo 新手，并提供详细的命令和步骤。

PS. 本文也是计划中的一环

2 从零到一的步骤

咱们就一步一步开始吧～

2.1 安装和配置 Hugo

Hugo 是一个基于 Go 语言的静态网站生成器，以其速度和简单性著称，适合技术背景的用户快速上手。安装方法因操作系统而异：

macOS：推荐使用 Homebrew，运行以下命令：（其他系统，请上网查）

brew install hugo

安装完成后，创建新站点以开始构建博客：

运行 hugo new site til，这会在当前目录下生成一个名为 til 的文件夹，包含 Hugo 的基本目录结构。
进入站点目录：cd til。
初始化 Git：git init

2.2 选择并安装 PaperMod 主题

主题是博客外观和功能的核心，根据你的需求（支持标签、分类、搜索，加载快，设计可爱），我们推荐使用 PaperMod 主题。它是免费的，功能丰富，设计简洁，可能符合你对“可爱”风格的期待。

添加 PaperMod 主题：(PaperMod 托管在 GitHub 上，通过 Git 子模块添加)

git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod

配置主题：在 Hugo 的配置文件中设置主题。Hugo 支持 YAML、TOML 或 JSON 格式，推荐使用 YAML 或 TOML。如果使用 hugo.toml，添加：(这个是自动生成的，并且趁着这个时候我们将 hugo.yml 的信息填对)

baseURL = "https://til.niracler.com/"
languageCode = "zh-cn"
title = "每日一学 TIL"
theme = "PaperMod"

[params]
 [params.homeInfoParams]
 Title = "欢迎来到我的 TIL 博客"
 Content = "这里记录了我每天学习的新知识，欢迎探索！"

 [[params.socialIcons]]
 name = "github"
 url = "https://github.com/niracler"

主题配置：PaperMod 有多种自定义选项，如支持深色/浅色模式、多语言、社交图标等。详细配置请参考 PaperMod 文档，包括如何启用搜索功能（通常通过 Lunr.js 或 Fuse.js 实现）。（这里没有校对）

2.3 编写和发布 TIL 条目

TIL 博客的内容完全从零开始，按日期排序，并支持标签功能。Hugo 使用 Markdown 文件管理内容，存储在 content 目录下。

创建新帖子：使用 Hugo 的 new 命令创建帖子 (这会在 content/post 目录下生成一个 Markdown 文件，文件名以日期开头，便于按日期排序)。如下：

hugo new post/2025-03-13-build-til-blog-by-hugo.md

编辑内容：打开生成的 Markdown 文件，顶部是前置元数据（front matter），用于定义帖子属性。例如：(就是我当前这篇文章了，呵呵)

---
title: "从零开始使用 Hugo 搭建 TIL 博客"
date: 2025-03-13T14:00:00+08:00
tags: ["til", "hugo"]
---
...

title：帖子标题。
date：发布日期，建议使用当前日期，如 2025-03-12。
tags：标签列表，支持多个标签，PaperMod 会自动生成标签页面。

内容部分写在 --- 之后，使用 Markdown 语法。

本地预览：运行 hugo server 查看本地预览，访问 localhost:1313 查看效果。按 Ctrl+C 停止服务器。

构建和部署：运行 hugo 构建站点，生成静态文件到 public 目录。提交并推送更改：

git add .
git commit -m "Added new TIL post"
git push

2.4 创建 GitHub 仓库并连接 Cloudflare Pages

为了实现自动部署，需要将博客项目托管在 GitHub 上，并连接到 Cloudflare Pages。

创建 GitHub 仓库：登录 GitHub，创建一个新仓库，例如 niracler/til，保持仓库为空。

添加远程仓库（替换 niracler 为你的 GitHub 用户名）

git remote add origin https://github.com/niracler/til

提交初始文件并推送：

git add .
git commit -m "Initial commit"
git push -u origin main

连接 Cloudflare Pages：注册 Cloudflare 账户（如果没有），进入 Pages 仪表板，点击“Create a project”。

选择“Connect to Git”

选择 GitHub 提供商并授权，找到你的仓库。

设置生产分支为 “main”（或你使用的分支）。并配置构建设置，构建命令 hugo --minify 输出目录 public，以及最好设置一下 hugo 的版本 HUGO_VERSION, 我写这篇文章的时候最新的是 0.126.1

保存后，Cloudflare Pages 会自动从 GitHub 拉取代码并部署。每次推送代码都会触发自动构建和部署。更多细节见 Cloudflare Pages Hugo 文档。

（完成部署啦，可喜可贺）

2.5 设置自定义域名

因为上面我设了 baseURL = "https://til.niracler.com/"，所以我的博客地址是 https://til.niracler.com/，此时需要设置自定义域名。（因为我的域名是托管在 cloudflare 上的，所以直接就用了）

访问 Cloudflare 仪表板，导航至 “Workers & Pages”，选择您的 Pages 项目。进入 “Custom domains” 部分。

点击 “Set up a custom domain”，输入 “til.niracler.com”，然后选择 “Continue”。 Cloudflare 将提供后续指导，具体取决于域名类型（顶域或子域）。

好啦，大功告成。请点击：https://til.niracler.com/ 查看效果。（丑爆了，留给未来的自己改吧。）

3 One More Thing

3.1 将 `public` 目录放到 `gitignore`

其实我们是不需要将 public 目录上传上去的。

对于使用 Hugo 和 Cloudflare Pages 的博客，不建议将 public 文件夹上传到 GitHub 仓库。
public 文件夹是 Hugo 构建生成的静态文件，Cloudflare Pages 会在部署时自动运行 hugo --minify 生成这些文件，因此无需手动上传。
只需上传源文件（包括 content、themes、hugo.toml 等），保持仓库轻量并避免冗余。

为了确保 public 文件夹不会意外上传到 GitHub，建议在项目根目录创建或编辑 .gitignore 文件，添加以下内容，这会忽略 public 文件夹及其所有内容：（上面流程下来，应该是没有这个文件，不过 anyway，我们使用追加的方式。）

echo -e "\npublic/" >> .gitignore

如果您之前已将 public 上传到仓库，可以运行以下命令清理：

git rm -r --cached public
git add .gitignore
git commit -m "Removed public folder and added .gitignore"
git push

验证方法

检查当前仓库：访问 https://github.com/niracler/til，确认 public/ 是否已上传。
如果已上传，建议删除（参考 .gitignore 清理步骤）。
查看 Cloudflare Pages 部署日志，确保构建命令 hugo --minify 正常运行并生成 public/。

3.2 本地与部署的工作流程

3.2.1 本地开发

编辑文章（content/post/）和配置文件（hugo.toml）。
运行 hugo server 本地预览，Hugo 会生成 public/ 文件夹供测试。
测试完成后，无需保留 public/，它会在下次构建时重新生成。

推送到 GitHub，提交并推送源文件：

git add .
git commit -m "Updated TIL post"
git push

3.2.2 Cloudflare Pages 部署

Cloudflare Pages 检测到推送后，运行 hugo --minify，生成 public/ 文件并部署。
您无需手动干预 public/ 的内容。

3.3 添加额外功能

你希望博客有评论系统、访问统计和社交分享按钮，以下是实现方法：（略，差不多得了，下篇再写）

4 参考资料

关键文档

Hugo 官网安装指南
PaperMod GitHub 仓库
Cloudflare Pages Hugo 框架指南
Hugo TIL 博客搭建指南 | Shared Grok Conversation - 与 Grok 的完全对话记录

资源和进一步学习

官方 Hugo 文档：Hugo 官网，提供详细教程和 API 参考。
PaperMod 社区支持：查看 GitHub 讨论区，获取用户经验分享。
Cloudflare Pages 论坛：解决部署问题，优化性能。

关于我和这个博客

Thu, 14 Mar 2024 00:00:00 +0000

关于这个博客

“每日一学”（Today I Learned，简称 TIL）是我记录日常学习和探索的地方。这个博客的灵感来源于 simonw/til 和 jbranchaud/til，旨在分享我每天学到的新知识、技巧和见解。

TIL 与普通博客的区别

TIL（Today I Learned）是一种特定题材的博客，专注于记录作者每天或近期学到的具体知识点。它与普通博客有以下几个明显区别：

非常具体的场景：大多是特定场景特定环境下的解决方案。例如 Hugo + Mac + Cloudflare Page + GitHub，这一般不是其中一个平台的文档可以说清楚的，而且也与各个软件的版本有关。也是因此时效性、不通用性会比较高。
原创性低：我打算后续很多 TIL 文章都是基于大模型的输出结果校对而写出来的。既然定位如此，也是某种程度上解决了，「既然别人都写过了，并且写的比我更好，我为啥要写」的那种心态。所以心理负担以及写作压力没这么强，同时也可以练习技术写作。
篇幅短，更新频率高：例如「我今天学到了在马桶上厕所，需要先垫一块纸巾，然后就不怕溅水了」这种也可以写一篇 TIL。
用作记录使用：也是在很多情况下，经常会有那种「我当时是怎么做的」的那种情况，然后再上网找一次之前的教程，然后再踩一次之前踩过的坑。写下来就能避免这个事情了。

我为什么想弄个 TIL 博客

记录学习笔记（根本原因）：最近工作上会经常学到各种各样的知识，想用来做简单的笔记。
直接原因：我想弄一个自己从零搭建的新博客了。（才不是因为 xlog 比较卡）
TG 不适合：我也想过在 Telegram 上写这个 TIL 的，不过这里不适合贴任何代码，甚至不适合写任何 500 字以上的内容。也就作罢。
灵感来源：从最开始 simonw/til 和 jbranchaud/til 这两人的博客我就知道了有 til 这种流派，最后一根稻草，其实是 LOTU$ 的 blog ，我看他有在记录之前各种折腾的一些过程。（受到鼓舞了）

至于为什么会有流派 til 笔记为什么值得写，可以看看这 simonw 的 What to blog about

Niracler's TIL 每日一学

Mired 与 Kelvin：深入理解色温控制

1 要点总结

2 Mired 和 Kelvin 的定义与区别

2.1 Kelvin (K)

2.2 Mired (Micro Reciprocal Degree)

2.3 主要区别

3 Mired 和 Kelvin 的前世今生

4 关于色温的那些事

4.1 常见光源色温及对应 Mired 值

5 总结与展望

6 参考资料与拓展阅读

物联网照明的类型分析

1 要点总结

2 灯的种类与分类

3 分类是否为协议

4 提出机构

5 详细分析

5.1 物联网中灯的种类功能详解

5.2 分类原因分析

5.3 RGB、RGBW和RGB-CCT的比较

5.4 未来趋势

6 参考资料

使用 Caddy 将运行在云服务器特定端口上的服务通过 HTTPS 暴露在指定域名下

1 要干什么

2 要怎么干

2.1 安装 Caddy

2.2 配置 DNS

2.3 配置 Caddyfile

2.4 管理 Caddy 服务

2.5 验证 HTTPS

3 注意事项

解决 Surge 增强模式下 UDP 组播失效的问题

1 要干什么

2 探索过程

3 解决方案

4 最小化测试用例 (Python)

5 关键知识点

6 总结

四块半榻榻米大小

什么是「四叠半」？

文化意义

《四叠半神话大系》

通过 jq 获取 pinboard 的文章列表, 并转换为 markdown 格式

1 要干什么

2 偷工减料版

3 参考资料

为我的博客添加媒体预览和 RSS 支持

1 要干什么

2 开始我们的美化工作吧

2.1 设置预览图和摘要

2.2 添加网站图标（Favicon）

2.2 添加 RSS 支持

2.3 添加 RSS feed 描述以验证所有权

关键引文

一个纠正我写作表达的 prompt

1 要干什么

2 内容

3 参考

将所有邮箱整合到 Fastmail 并同步到 Apple Mail

1 要干什么

2 从其他邮箱到 fastmail 邮箱

2.1 QQ 邮箱邮件迁移并同步到 Fastmail

3 Apple Mail 的 Fastmail 配置

4 总结

OpenWRT 设置启用 IPv6 让子设备能拿到 IPv6 的 公网 IP （原理未明）

1 要干什么

2 关键要点（未经校对）

3 配置步骤

3.1 确认 ISP 支持和接口名称

3.2 配置 WAN 接口（IPv4）

3.3 配置 WAN6 接口（IPv6）

3.4 配置 LAN 接口（IPv6）

3.5 配置 DHCP 服务器（IPv6）

3.6 配置防火墙（IPv6）

3.7 应用更改

3.8 最终结果

4 测试和验证

5 关键引文（未经校对）

从零开始使用 Hugo 在 Cloudflare Pages 上搭建 TIL 博客

OpenWRT 设置启用 IPv6 让子设备能拿到 IPv6 的公网 IP （原理未明）

3.1 将 `public` 目录放到 `gitignore`