依云's Blog

因为腾讯的关系，不得不使用 Windows。不是QQ也不是RTX，这次 Wine 帮不上忙了。那好吧，SSD + 16G 内存，跑个 Windows 虚拟机也没多大问题。

但是问题来了：我在虚拟机里每次点击链接，会调用安装于 Windows 上的浏览器来访问。可是我登录了各种工作账号的浏览器在外面的自由世界 Linux 主系统里啊。

办法也好想：来一个远程调用，让 Windows 调用咱自己的程序打开链接，然后咱自己的程序再把链接传给外面的 Linux 就好了。理想是美满的，可是 Windows 里设置默认浏览器并不是写个 .desktop 文件那么简单！

在 Google 上找了半天资料（真的花掉了半天！），最终终于确认，需要设置以下一大堆注册表键，Windows 才会认可咱自己的浏览器：

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser]
@="RemoteBrowser"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\Capabilities]
"ApplicationName"="RemoteBrowser"
"ApplicationIcon"="C:\\RemoteBrowser\\launch.exe,0"
"ApplicationDescription"="RemoteBrowser"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\Capabilities\StartMenu]
"StartMenuInternet"="RemoteBrowser"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\Capabilities\URLAssociations]
"https"="RemoteBrowserHTML"
"http"="RemoteBrowserHTML"
"ftp"="RemoteBrowserHTML"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\DefaultIcon]
@="C:\\RemoteBrowser\\launch.exe,0"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\InstallInfo]
"IconsVisible"=dword:00000001
"ShowIconsCommand"="\"C:\\RemoteBrowser\\launch.exe\" --show-icons"
"HideIconsCommand"="\"C:\\RemoteBrowser\\launch.exe\" --hide-icons"
"ReinstallCommand"="\"C:\\RemoteBrowser\\launch.exe\" --make-default-browser"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\shell]

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\shell\open]

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\StartMenuInternet\RemoteBrowser\shell\open\command]
@="\"C:\\RemoteBrowser\\launch.exe\" \"%1\""

[HKEY_LOCAL_MACHINE\SOFTWARE\RegisteredApplications]
"RemoteBrowser"="SOFTWARE\\Clients\\StartMenuInternet\\RemoteBrowser\\Capabilities"

[HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Associations\UrlAssociations]

[HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http]

[HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http\UserChoice]
"Progid"="RemoteBrowserHTML"

[HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\https]

[HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\https\UserChoice]
"Progid"="RemoteBrowserHTML"

[HKEY_CLASSES_ROOT\RemoteBrowserHTML]
@="RemoteBrowser"
"FriendlyTypeName"="RemoteBrowser"
"URL Protocol"=""
"EditFlags"=dword:00000002

[HKEY_CLASSES_ROOT\RemoteBrowserHTML\DefaultIcon]
@="C:\\RemoteBrowser\\launch.exe,0"

[HKEY_CLASSES_ROOT\RemoteBrowserHTML\shell]
@="open"

[HKEY_CLASSES_ROOT\RemoteBrowserHTML\shell\open]

[HKEY_CLASSES_ROOT\RemoteBrowserHTML\shell\open\command]
@="\"C:\\RemoteBrowser\\launch.exe\" \"%1\""

相比之下 Linux 只需要以下这么几行：

Version=1.0
Name=Firefox
GenericName=Web Browser
Comment=Browse the Web
Exec=/usr/lib/firefox/firefox %u
Icon=firefox
Terminal=false
Type=Application
MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
StartupNotify=true
StartupWMClass=Firefox
Categories=Network;WebBrowser;
Keywords=web;browser;internet;

（不过真实的 firefox.desktop 有三百多行，因为各种语言的名字和描述的翻译。）

上边那个注册表文件，引用了一个 exe 文件，和里边的一个图标资源。我不知道图标使用独立的文件可不可以。加个图标并不难，上网搜一下就有了，使用 windres 命令即可。

首先准备好图标文件 icon.ico，然后写一个资源文件：

1 ICON DISCARDABLE "icon.ico"

用 windres 把它编译成 COFF 文件。因为我是在 Linux 上使用 mingw 操作，所以使用的命令叫 x86_64-w64-mingw32-windres。然后把它和其它目标文件链接到一起就可以了。因为我使用的是 Rust，它的 build.rs 脚本不支持目标文件，所以先打包成静态库，然后再链接：

x86_64-w64-mingw32-windres launch.rc -O coff -o icon.res
x86_64-w64-mingw32-ar q libres.a icon.res

然后 build.rs 脚本里说一下：

fn main() {
  println!("cargo:rustc-link-search=native=..");
  println!("cargo:rustc-link-lib=static=res");
}

然后咱的主程序，通过 TCP 把链接发到 Linux，以及 Linux 端的服务，接收链接并打开浏览器，因为很简单很常规，所以这里就不列出来了。有兴趣的去源码仓库看就好了。

exe 编译好之后，扔到之前注册表文件里提及的地方就好。然后双击那个注册表文件将其导入。接下来在默认软件的设置里就能够找到我们的「Remote Browser」了（虽然不知道为什么没有显示指定的名字，而是 exe 文件名）。

另外，那个图标资源，也可以使用 Resource Hacker 把图标文件给弄到 exe 文件里边去。

最后一步，写个用户级的 systemd 服务，把负责在浏览器里打开链接的程序给跑起来～

仓库地址在此。喜欢的话，记得 star 哦～

咱买了一个录音笔，效果比使用笔记本话筒录音好多了还省电。当然啦，我也曾试过使用手机录音，结果是，没能录多久就中断了（Android 就是这么不靠谱）。

我的录音需要记录较为准确的时间信息。录音笔怎么知道现在是什么时间呢？还好它没有跟风，用不着联网！

它带了一个小程序，叫「录音笔专用时间同步工具」（英文叫「SetUDiskTime」，可以搜到的）。是一个 EXE 文件，以及一个 DLL 文件。功能很棒，没有广告，没有推荐，也不需要注册什么乱七八糟的账户，甚至都不需要打开浏览器访问人家官网。就弹一个框，显示当前时间，确定一下就设置好时间了。这年头，这么单纯的 Windows 软件还真是难得呢。

然而，它不支持我用的 Linux 啊。虽然我努力地保证这录音笔一直有电，但是时间还是丢失了几次，它的FAT文件系统也脏了几次。每次我都得开 WinXP 虚拟机来设置时间，好麻烦。

Wine 是不行的，硬件相关的东西基本上没戏。拿 Procmon 跟踪了一下，也没什么复杂的操作，主要部分就几个 DeviceIoControl 调用，但是看不到调用参数。试了试 IDA，基本看不懂……不过倒是能知道，它通过 IOCTL_SCSI_PASSTHROUGH 直接给设备发送了 SCSI 命令。

既然跟踪不到，试试抓 USB 的包好了。本来想用 Wireshark 的，但是 WinXP 版的 Wireshark 看来不支持。又尝试了设备分配给 VBox 然后在 Linux 上抓包，结果 permission denied……我是 root 啊都被 deny 了……

那么，还是在 Windows 上抓包吧。有一个软件叫 USBPcap，下载安装最新版，结果遇到 bug。那试试旧版本吧。官网没给出旧版本的下载地址，不过看到下载链接带上了版本号，这就好办了。去 commit log 里找到旧的版本号替换进去，https://dl.bintray.com/desowin/USBPcap/USBPcapSetup-1.0.0.7.exe，就好了～

抓好包，取到 Linux 下扔给 Wireshark 解读。挺小的呢，不到50个包，大部分还都是重复的。很快就定位到关键位置了：

一个 0xcc 命令发过去，设备回复「ACTIONSUSBD」，大概是让设备做好准备。然后一个 0xb0 命令，带上7字节数据发过去，时间就设置好了。简单明了，不像那些小米空气净化器之类的所谓「物联网」，通讯加密起来不让人好好使用。

那么，这7字节是怎么传递时间数据的呢？我首先检查了UNIX时间戳，对不上。后来发送这个字串看上去挺像YYYYMMDDHHMMSS格式的，只是明显不是当时的时间。啊，它是十六进制的嘛！心算了几个，符合！再拿出我的 Python 牌计算器，确定年份是小端序的16位整数。

好了，协议细节都弄清楚了，接下来是实现。我原以为我得写个 C 程序，调几个 ioctl 的，后来网友说有个 sg3_utils 包。甚好，直接拿来用 Python 调，省得研究那几个 ioctl 要怎么写。

#!/usr/bin/env python3

import os
import sys
import struct
import subprocess
import datetime

def set_time(dev):
  cmd = ['sg_raw', '-s', '7', dev, 'b0', '00', '00', '00', '00', '00',
         '00', '07', '00', '00', '00', '00']
  p = subprocess.Popen(cmd, stdin=subprocess.PIPE, stderr=subprocess.PIPE)
  dt = datetime.datetime.now()
  data = struct.pack('<HBBBBB', dt.year, dt.month, dt.day,
                     dt.hour, dt.minute, dt.second)
  _, stderr = p.communicate(data)
  ret = p.wait()
  if ret != 0:
    raise subprocess.CalledProcessError(ret, cmd, stderr=stderr)

def actionsusbd(dev):
  cmd = ['sg_raw', '-r', '11', dev, 'cc', '00', '00', '00', '00', '00',
         '00', '0b', '00', '00', '00', '00']
  subprocess.run(cmd, check=True, stderr=subprocess.PIPE)

def main():
  if len(sys.argv) != 2:
    sys.exit('usage: setudisktime DEV')

  dev = sys.argv[1]
  if not os.access(dev, os.R_OK | os.W_OK):
    sys.exit(f'insufficient permission for {dev}')

  actionsusbd(dev)
  set_time(dev)

if __name__ == '__main__':
  main()

早就说了要介绍我在用的火狐扩展，现在终于来啦。

桌面版

• 复制链接/标签名称和地址

• 书签搜索: 右键搜索功能，见之前的文章

• AgentX: User-Agent 切换。

• Bookmarklets context menu: 因为 CSP，有些小书签不能加载了，通过 Web Extensions 绕过好了。

• Containers On The Go: 自动创建和清除临时身份。每个身份的 cookies 等存储是相互独立的。

• Decentraleyes: 给流行 JavaScript 库建立一个本地 CDN。

• Drag-Select Link Text: 选择链接里的文本。（可惜不支持 X 选择区。）

• Foxy Gestures: 手势。

• FoxyImage: 有时候会遇到方向不对的图片，用这个修理一下。

• Google™ Translator (web-extension): 翻译。目前网页内的选择翻译坏掉了，不过工具栏按钮还可以用。

• HTTPS Everywhere

• Inoreader Companion: 为了在后台打开 InoReader 里的文章。

• Octotree: GitHub / BitBucket 文件树。

• Push to Kindle

• Redirect Link: 在互联网档案馆、Archive.is 或者 Google 缓存里寻找当前页面，或者存档之。

• Redirector: 自定义重定向。比如查看图像时直接跳转到大图、跳过各种重定向链接之类的。

• Referer Control: 反盗链有时候很烦的。

• Rotate and Zoom Image: 另一个旋转图片的工具。

• Stylus: 更换网站样式，比如把 GitHub 顶栏变成白色、已访问链接使用不同的颜色。

• Tampermonkey: 更大力地修改网站。我正在使用的脚本都放在这里了。

• Textarea Cache: 在网站写东西的时候，遇到浏览器、系统崩溃死机？网站突然挂了？写的东西可别丢了。

• uBlock Origin: 广告屏蔽。

• User-Agent Switcher: 另一个切换 User-Agent 的扩展。

• v2ex plus: v2ex 新消息提醒、查看被回复的评论等。

• VimFx: 使用 Vim 的方式操作火狐。这是一个旧式扩展，使用 nightly 的话开启 extensions.legacy.enabled 选项才可以用。（AMO 上的文件链接）

• Wappalyzer: 看看网站都用了哪些技术。

• wxIF: 查看图片元数据。没什么用。

• Bookmarks Organizer: 整理书签。默认禁用，想整理的时候启用一下下。

• ScrollAnywhere: 按住中键移动鼠标时滚动页面。因为和 Foxy Gestures 使用中键冲突，暂时禁用。

Android 版

Android 版上使用的扩展比较少，大部分是桌面上用的扩展同时支持 Android，所以同步过来了。只有一个例外：Text Reflow WE。

这个扩展是我移植到 Web Extensions 的。在点击内容时限制文本宽度，从而限制需要不断地横向滚动。原本是 Opera Mobile 的特色功能，后来我换到火狐时找了个替代品，结果它没更新了，不支持57+，我就移植了一下。代码十分简单，本来是一个 user script 就可以搞定的内容，但是 Android 上好像没 user script 扩展……

2017年11月25日更新：

装回了 cliget，一个为下载项生成 wget / curl / aria2 调用命令的工具。虽然因为没有 XUL API 可以修改保存对话框了，但是作者找到了一种不错的办法，把候选下载项保存到一个列表里方便取用。会有误判，忽略就好。这个列表是下载对话框弹出的时候就会更新，所以挺适合下载大的「百k盘」文件，下载链接超时失效之后可以获取一个新的让 wget 接着下。

暂时把 uBlock Origin 换回了 Adblock Plus。界面比前者好看许多，可惜还是没有规则使用计数和最后使用时间记录，不方便清理失效的规则。

启用了 ScrollAnywhere，因为妨碍 Foxy Gestures 使用右键的 bug 已经解决了。我使用的是 Nightly 版本所以很快就用上了，Linux 发行版如 Arch 也有做 backport。

考虑换回 GreaseMonkey，不过发现有一个 bug 导致它不能在特定网站上触发安装操作。

这事本来是有个 browsercookie 库可以做的，但是初看它就有不少问题：

1. 不能指定要使用的火狐 profile（后来发现可以指定数据库文件）。
2. 找不到 sessionstore.js 文件时会向标准输出打印一行信息。对于 cron 脚本，这种行为是非常非常讨厌的。

我在尝试解决这些问题时，又发现了额外的问题：它每次都要把所有的 cookie 全部读取。再加上不必要地导入 keyring、Crypto 等库，让我想放弃了。

于是我考虑自己实现一个 cookiejar。但发现它有如下问题：

• 公开接口和实现细节没有清晰地分离
• 没有提供存储和读取 cookie 的抽象，而是存在一个字典里

这样扩展起来就十分令人不爽了，也不知道能正常工作多久。

也罢，cookiejar 是个十分复杂的东西，我不如实现一个获取匹配的 cookie 的独立功能，然后通过各种姿势传给 HTTP 客户端库好了。

火狐的 cookie 数据库文件「cookies.sqlite」里就一个「moz_cookies」表，其结构也挺简单的。但是，怎么做 cookie 的匹配呢？既然决定放弃 Python 自带的 cookiejar，那就不看它，直接看火狐的源码好了。

于是去 DXR 上搜索火狐的源码。没费多少力气就找到了相关的部分，然后跟着代码就能知道是怎么匹配的了：

1. 通过祼域名查得候选 cookie
2. 根据域名、路径和 secure 等属性来过滤 cookie
3. 就这样，没有第三步了

祼域名使用 tldextract 库来做，其它属性的匹配算法直接看火狐的代码。虽然是不熟悉的 C++ 代码，但是写得很棒，很容易理解。

把自己需要的部分写成 Python，得一新模块——firefoxcookies。就一个方法，返回一个 cookie 的字典，用起来也很方便。比如在我的 requestsutils.RequestsBase 中，这么干就可以了：

class FireRequests(RequestsBase):
  def initialize(self):
    self._fc = FirefoxCookies(os.path.expanduser(
      '~/.mozilla/firefox/nightly/cookies.sqlite'))

  def request(self, url, method=None, *args, **kwargs):
    if self.baseurl:
      url = urljoin(self.baseurl, url)

    cookies = self._fc.get_cookies(url)

    return super().request(url, method=method, cookies=cookies)

就这样就满足我的需求了。以后再有别的需求，再慢慢扩展。

家里和公司电脑连接，因为厌倦了一个个做端口映射，有些还因为安全原因得走 ssh，所以决定弄个 VPN。之前使用过 OpenVPN，然而现在懒得再去配置 OpenVPN 的证书了，所以决定尝试一下新东西。

首先，去 WireGuard 官网上转了一圈，结果还是没弄明白怎么配置。后来尝试了一下 demo，把服务端和客户端的脚本分别看了一下，才弄明白。其实在 WireGuard 里，客户端和服务端基本是平等的，差别只是谁主动连接谁而已。双方都会监听一个 UDP 端口。双方都需要一对密钥。双方都需要把对方的公钥加进来。最后一步，谁主动连接，谁就是客户端。因为家里路由器有公网 IP，我做了端口映射，所以我当然是从公司连家里方便了，用不着麻烦的打洞脚本。

首先 pacman -S wireguard-tools 安装。这也会安装上 WireGuard 的内核模块。然后使用熟悉的 ip 命令添加并配置 WireGuard 的网络接口：

# 生成密钥对
wg genkey | tee privatekey | wg pubkey > publickey

sudo ip link add dev wg0 type wireguard
sudo ip address add dev wg0 192.168.58.1/24
sudo wg set wg0 listen-port 60010 private-key privatekey
sudo ip link set wg0 up

这是我家里的配置。使用的是网段 192.168.58.0/24，因为 56 是 vbox 虚拟机用的，57 分配给 lxc 和我的网络命名空间了。指定了一下监听的端口号。我把之前给 mosh 配置了转发的端口号中最高的那个挪用了。

公司里也是同时的配置，只是不需要指定监听端口号，然后把家里那边设置成 peer，并且连过去（相同的命令我没写）：

sudo wg set wg0 private-key privatekey peer 这里是公钥 endpoint 家里的IP:60010 allowed-ips 0.0.0.0/0 persistent-keepalive 180

allowed-ips 指定过来的 IP。这里没怎么限制。persistent-keepalive 是为 NAT 设置的。WireGuard 本来很安静，不需要说话的时候就不说话，但是要往 NAT 后边的主机发送信息，需要经常通信，让 NAT 记得对应的映射关系。

然后家里那边也需要添加一下公司这边的公钥：

sudo wg set wg0 peer YiyFylL+1Dr3j2Cyf0lwXQYz2qaNwm3XyV5YvMFp3Vs= allowed-ips 192.168.58.2/32

IP 限制加上也是没有问题的。这里就不用加上 endpoint 了，它连过来的时候自然就知道了。WireGuard 是支持漫游的，也就是说，双方不管谁的地址变动了，WireGuard 在看到对方从新地址说话的时候，就会记住它的新地址（跟 mosh 一样，不过是双向的）。所以双方要是一直保持在线，并且通信足够频繁的话（比如配置 persistent-keepalive），两边的 IP 都不固定也不影响的。

最后，用得不错，可以把这几条命令写到一个 systemd service 文件里，就可以不用每次敲一串命令了，也可以做到联网后自动启动。

刚刚找了一下，其实之前使用的证书什么的还在，而且还没过期。而且因为弄 nghttpx，用了一下 xca，比 easy-rsa 好用很多呢。不过 WireGuard 的双向漫游很棒啊～

故事起源于同事想在后台跑一个服务：

$ nohup node xxx.js &

一切如愿。

——是吗？

实际情况是，这时退出 bash 是如愿了，但是直接关掉终端窗口的话，那个服务会死掉。

bash 奇怪行为之五

（我好像没有写前四个耶。等有时间了简单写一下吧。）

man bash 然后搜索 SIGHUP，你会发现，其实默认设置，bash 正常退出时，根本不会杀害后台进程。它们会和从脚本里运行时一样欢快地继续跑下去。只有 bash 因为收到 SIGHUP 而退出时，它才会给后台进程发 SIGHUP。

所以，直接 Ctrl-D 或者 exit 退出的话，（处理好了重定向的话，）要不要 nohup 都一样，进程不会死。

zsh 默认退出时会给后台任务发送 SIGHUP（除非你 disown 了）。

但这还是不能解释关窗口的时候，服务为什么会死掉呀？nohup 不是已经忽略掉 SIGHUP 了么？

与众不同的 nodejs

通常情况下，nohup 工作得很好。但是，UNIX 世界里来了位不了解、也不愿意遵循 UNIX 传统惯例的年轻气盛的小伙子。

我还记得 npm 直接往 /usr 下安装东西。

我还记得 npm 把 http_proxy 当 https_proxy 而我的缓存代理不支持 HTTPS，造成无法安装任何东西。

现在，nodejs 将所有信号的处理重置为默认行为，除了它自己想处理的那几个。

「nohup？那是什么鬼？我搞不懂！」nodejs 说，然后它被 SIGHUP 杀死了。

结语

The devil is in the detail!

最近开始用 Firefox nightly 了。纯 WebExtensions 时代就要来临了，然而 WebExtensions 还不能访问浏览器搜索引擎，所以我没办法选中文本，然后选个正确的搜索引擎了……

我之前使用的是 FireGuestures。选中文本，一个手势弹出我所有的搜索引擎，然后选一个使用。挺好挺方便。然而看现在使用 WebExtensions 的搜索扩展，因为无法访问浏览器搜索引擎，所以都是内置了几个搜索引擎，最多让用户手动添加自己想要使用的。多麻烦啊，而且还要维护额外的数据。

而火狐从一开始就可以「为此搜索引擎添加关键词」（如下图）。虽然也叫「搜索引擎」，但是并不是搜索栏用的那个，而是带关键字的书签。对于 GET 请求的搜索，是在 URL 里把搜索词写作「%s」。对于 POST 请求，「PostData」是用户看不到、扩展也访问不到的，也不能被同步。不过大部分搜索都是 GET 嘛。功能上是弱了一些，比如不能在只有关键词、没有搜索词的时候打开主页。但是书签可以同步呀！

于是，利用书签来存储、同步搜索引擎的扩展——书签搜索——诞生了！效果图如下：

（这个其实是之前《改了一下 GTK 3 的默认主题》的配图 :-)

感兴趣就前往安装书签搜索吧～喜欢请给小星星（AMO 和 GitHub 都可以给星星的哦）～遇到问题请点击右侧「用户支持网站」报告～

这是我的第一个 WebExtensions 扩展，也是第一个正式发布的火狐扩展（其实也支持 Google Chrome 和 Opera；Microsoft Edge 没有尝试，大概也支持吧）。WebExtensions 写起来比 XUL 舒服很多，最主要是文档全面了！不用像写 XUL 那样，拿浏览器工具箱找要修改的 DOM，然后满世界找自己需要的 API。WebExtensions 提供的 API 就那么点，在 MDN 上都有写。另外就是 JavaScript 这些年来进步很大，越来越像 Python 了！可惜 Google Chrome 和 Opera 它们的扩展还不使用 Promise、不能用 await，不然写起来更舒服了。

ZeroMQ 的指南文档很长很长。我想放在 Kindle 里，上下班的时候看，长知识又不伤眼。

首先尝试 Push to Kindle。就是本博客每篇文章下边都有的那个链接里的东西。试了好几次终于成功了。然而，章节标题看不出来跑哪儿去了也就算了，代码去哪儿了？注意格式啊！

于是换浏览器，HTML 转 PDF。顺手按 F12，把每个标题右边的导航链接删掉了。然后打印～代码格式没有坏哦～然而，还是有很多代码没显示出来，倒是显示了一堆其它语言代码的链接……继续 F12 改样式表修了。这些都是小问题，最大的问题是，在我不断地调整页面大小的时候，我的火狐每次「准备……」的过程都特别漫长，那个负责转换的子进程吃很多很多 CPU，还卡死了所有它负责的标签页……终于，在等待近半小时它还没准备好的时候，我失去了耐心，杀掉了那个火狐子进程，换 Prince 了。这次我体会到多进程架构的好处了：页面卡了，换个标签页打开，分配到另外的子进程的时候就可以正常使用了。

Prince 是个非常不错的 HTML 转 PDF 软件。免费版本会有个它自己的图标放第一页右上角，没啥问题，打印的时候也不会出现。要是你非要去掉它的话，也可以找个 PDF 编辑工具删掉它。

然后是确定页面大小。因为代码的行都比较长，我决定横屏阅读，也就是「landscape」模式。然后拿尺子量了一下，差不多是 9cm×12cm。维基百科告诉我 Kindle Paperwhite 是6英寸的屏幕，但是我没有弄明白它的长和宽到底是多少，所以还是动手测量了。因为 Kindle 上字显示小一些也挺清晰的，所以我把短边乘以了二（好像并不合理啊，因为已经是 landscape 了，应该两边同步放大才对；不过其实我一开始想的是一页占两屏……）。

然后再加上针对 ZeroMQ 文档的修改，得样式表如下：

td + td {
  display: none;
}

.collapsible-block-folded {
  display: none;
}

.collapsible-block-unfolded {
  display: block !important;
}

.collapsible-block + br + span {
  display: none;
}

body {
  font-family: serif !important;
}

@page {
  size: 18cm 12cm landscape;
  margin: 0;
}

然后让我们的王子干活啦：

prince -s zguide.css zguide.html -o zguide.pdf

因为需要反复尝试，所以我已经把 ZeroMQ 那个巨大的 HTML 下载到本地了。

最终成果在这里。因为页边距为零，所以在一般的阅读器里看起来挺难看的，但是在 Kindle 里就挺适合了～

you-get 是一个视频下载工具。我于五年零一周前（2012年9月7日）在 AUR 打包并维护其 git 版本。当时还是叫 python-you-get-git，后来根据 Arch 官方的推荐，与语言没什么关系的软件不带语言前缀，改名为 you-get-git。

youtube-dl 是另一个差不多同时期出现的视频下载工具，一开始主要针对 YouTube 等跨国网站。

选择 you-get 一部分原因是当时它对国内网站的支持更好，另一方面也是支持国产。但是今天，我决定放弃 you-get 了。

五年来，我一直是支持 you-get 的。也尝试过向其贡献代码。目前已经有29个提交被合并，排名第五位。基本上都是一些很小的修改，比如编码问题、未回收的僵尸进程、标题的反转义、ffmpeg 命令的特殊字符转义、支持 python -m 调用、视频链接的解析更新和扩充、进度条的修正和优化，等等。

其实这些年来，我一直想做更多事：

• 可选地使用 requests 库，以提高解析速度，改善用户体验
• 支持使用 aria2c 下载视频链接
• 支持网易云课堂的更高清晰度的未内嵌字幕的视频（pr#1002）
• 解析更准确的信息
• 一些其它网站的解析器（比如 bilibili 的 bangumi.bilibili.com 子域）

但是，其中很多都没能完成。勉强完成的也很奇怪：明明是针对网易云课堂的解析，我还非得关心网易云音乐。一直以来，我对 you-get 的修改都是事倍功半。我也曾尝试过更深入的修改，但是牵一发而动全身，往往要改就得改很大很大一部分代码，然后完全没有办法保证其正确性。就像今天的事情一样。

我花了数小时的时间，牺牲睡眠，把命令行选项解析由 getopt 改成了 argparse（pr#2260）。促使我做此修改的原因是，我想下载 bilibili 一整个播放列表的视频。我记得 you-get 有下载整个播放列表的功能。但是我读了好几遍 help 信息，都没有找到那个选项。我记错了吗？阅读源码之后，我终于找到了那个选项。同时，我也看到了在 C 和 bash 代码里经常看到的，一长串 if/else 来解析命令行选项。翻了好几屏。

当一个相对独立的代码片断翻屏时，bug 数量会骤增。

曾经在公司里遇到过一个 case，非常直接地证明这句论断是有多么正确。那个函数刚好超过一屏数行，而在第二屏的那部分代码，有个「}」和「return」的顺序写反了。我也是拿 Vim 的匹配括号跳转功能才发现的。

当然了，不管怎样的代码，不动它是不会出新问题的。然而我动了它。回报我的是两个局部变量名忘记改了：pr#2346、pr#2355。

这种问题在 nvchecker 重构以支持 aiohttp 时并没有发生。为什么呢？我们有测试。如此明显的问题，只要 cover 了必然会发现。所以我可以放心大胆地重构。

you-get 呢？you-get 也有测试。我在提交 pull requests 之后有个习惯：盯着未完成的测试，直到它变绿。如果红了，赶紧看看是不是自己代码的问题，是就赶紧修掉。一些项目（比如 Tornado）的测试本地跑起来要配置环境、装不少东西，太麻烦了，所以我习惯先提了 pr，然后等 Travis-CI 的结果。可这次，测试过了。但是有两个重要的功能却并不能正常工作。

其实呢，对于这种简单的错误，通常 linter 会告诉我的。我有装 neomake，全面支持各种 linter，用起来十分惬意。但 pylint……就像 jslint 一样，我很讨厌它们。因为它们不仅检查潜在的问题，同时还检查代码风格。而代码风格这事是每个项目单独配置的，而不是开发者自己配置好，然后让自己参与的所有开源项目都遵守。不过今天我也终于知道了另一个 Python linter——pyflakes 很对我的味口：只管问题，不管风格。

总之呢，由于各种原因，重写中出了这么两个直接立刻让用户不能用的 bug。很抱歉。一般来说，出错了就改呗。更深入一些，分析一下为什么会出现这种错误，今后怎么避免同样的错误两次出现（早年向 Tornado 提交代码时，Ben Darnell 一个简单的行为教会了我一件事：修了 bug 就写个对应的测试）。但是 you-get 的协作者 rosynirvana 不按惯例来，反而要求放弃此修改。如果就如此也就算了，后续讨论中我意识到了一个真相——为什么我在 you-get 上的工作如此困难？

The best part of you-get is that it's not so pythonic so those who only know js or as3 can take part in, moving from the universal getopt to a py-domain-specific library cannot be a nice idea.

source

What library nowaday pythonists love do not really matter here because those one know js and as3 can contribute even more in this project.

source

因为 you-get 根本就是反 Pythoner 的！作为一个 Python 项目，you-get 想要吸引的是 JavaScript 和 ActionScript 3 开发者！

我很震惊。

• 作为 Python 开发者，我已被他们刻意排斥在外。
• 作为 JavaScript 开发者，我还是觉得 C 好难写，还是 pythonic 的代码比较好维护啊。
• 作为 C 开发者，我倒是对这种长达数屏的作用域见怪不怪了。不过重复的逻辑，咱一般会用宏之类的手段给整成声明式的啊。

所以，我的努力注定不会有多少效果。

然后，我看了一眼 youtube-dl。其实就瞟了一眼，也没看出太多东西来，但是

• 按 URL 进行正则匹配的，网易云音乐和网易云课堂可以分开处理了！
• 解析器以 class 表达，有组织有纪律！不用用 Python 的语法写 C 了！

我 disown 了 AUR 和 [archlinuxcn] 里的 you-get-git 包。关闭了未完成的 issue 和 feature pr。等修复 argparse 引入的错误的 pr 被合并（不管是只修正问题还是退回到 getopt），事一了，我就删掉仓库，只保留网易云课堂的高清视频解析代码（花了我一整天的）。已安装的 you-get 暂时保留，但首选 youtube-dl，遇到问题有时间就去修一下。已经投入到 you-get 的时间是沉没成本，不必留恋。

最近公司弄了 Wi-Fi 登录。就是那个叫 captive portal 的东西。

Android 早就会在连接 Wi-Fi 时检测网络是不是要登录了，为此 Google 弄了个 /generate_204 的 URL。小米、高通、USTC、v2ex 也都提供了这个东西，方便广大中国大陆 Android 用户使用。（我发现我的 Android 使用的是高通的地址，没有用 Google 的。）

但我使用的 Arch Linux 自行开发的 netctl 网络管理工具没这种功能。火狐倒是不知道什么时候加上了，不过使用的地址 http://detectportal.firefox.com/success.txt 是返回 200 的。

所以我启动火狐就可以看到要登录的提示了。然而问题是，其它程序不知道要登录啊。像 offlineimap、openvpn、rescuetime 这种还好，会自己重试。可每次网络需要登录的时候 dcron 就会给我发一堆邮件告诉我我的 git pull 都失败了……当然还有我老早就注意到的 pkgstats，经常会因为启动过早而无法发送统计数据。

所以呢，得想个办法，等连上互联网之后再跑那些脚本啊服务什么的。

检测是不是连好了很简单，不断尝试就可以了。但我需要一个系统级的 Condition 对象来通知等待方可以继续了。然而我只知道 Linux 有提供信号量。难道要自己弄共享内存来用么？

去 #archlinux-cn 问了一下，farseerfc 说试试命名管道。我想了想，还真可以。只有读端的时候进程就会阻塞，一旦有写端就能成功打开了。当然没有读端的打开写端会打不开，不过没关系，反正这进程也不能退出，得一直拿着这个文件描述符。

没想到很少用到的命名管道有意想不到的用法呢。我以前还为了不阻塞而专门写了篇文章呢。

于是负责检测网络连通的 check-online 和等待网络连好的 wait-online 都写好了。

check-online 应当是个服务。那就交给 systemd 吧。然后……systemd 不是有个 network-online.target 么？正好可以让 check-online 来达成这个目标呢，多合适呀。

于是服务写好了。测试了几天，大成功！不仅 wait-online 很好地工作了，而且我发现 openvpn 和 pkgstats 自动排到 network-online.target 后边去了。nginx 的 OSCP staple 经常因为 DNS 失败而无法成功，我也可以在联好网之后去 reload 一下它了。（不是强依赖，我可不希望连不上网的时候我本地的 wiki 也访问不了。）

整个项目就叫作 wait-online，在 GitHub 上，欢迎送小星星哦～Arch Linux 包可以从 [archlinuxcn] 仓库 安装 wait-online-git 包。