Wanten

Emacs Wayland 解决输入法候选框跳动的问题

Tue, 28 Apr 2026 12:20:00 GMT

一、问题描述#

使用 Emacs Wayland v30.2 版本，搭配 fcitx5 输入中文时，会出现一个影响使用体验的问题：输入法候选框会跟随 preedit（汉字未上屏时的拼音显示）不断跳动，输入过程中候选框位置不稳定，影响输入流畅度。

二、快速解决方案#

无需修改 Emacs 源码、无需重新编译，只需在 Emacs 配置文件中添加以下 Lisp 代码，即可直接解决候选框跳动问题：

;; Emacs Wayland 避免候选框跟随 preedit 跳动
(with-eval-after-load 'pgtk-win
  (advice-add
   'pgtk-preedit-text :filter-return
   (lambda (_)
     (when pgtk-preedit-overlay
       (overlay-put
        pgtk-preedit-overlay
        'before-string
        (propertize
         (overlay-get pgtk-preedit-overlay 'before-string)
         'cursor 1))))))

三、原理分析#

要理解问题的根源和解决方案的逻辑，我们先从 Emacs Wayland 下的输入渲染机制说起。

3.1 Emacs Wayland 输入渲染基础#

Emacs 在 Wayland 环境下，通过 PGTK（Pure GTK）后端进行界面渲染和输入处理。当我们使用输入法输入中文时，会经历一个 preedit 状态——即拼音已输入、但汉字尚未上屏的阶段，此时输入法会向 Emacs 发送 preedit-text 事件，告知 Emacs 需显示的拼音内容及样式。

这个事件的处理逻辑，定义在 Emacs 源码的 emacs/lisp/term/pgtk-win.el 文件中，核心函数是 pgtk-preedit-text。

3.2 原始函数工作流程#

以下是 pgtk-preedit-text 函数的完整源码，我们拆解其工作流程，找到问题关键：

(defun pgtk-preedit-text (event)
  "An internal function to display preedit text from input method.

EVENT is a `preedit-text' event."
  (interactive "e")
  (when pgtk-preedit-overlay
    (delete-overlay pgtk-preedit-overlay))
  (setq pgtk-preedit-overlay nil)

  (let ((ovstr "")
        (idx 0)
        atts ov str color face-name)
    (dolist (part (nth 1 event))
      (setq str (car part))
      (setq face-name (intern (format "pgtk-im-%d" idx)))
      (eval
       `(defface ,face-name nil "face of input method preedit"))
      (setq atts nil)
      (when (setq color (cdr-safe (assq 'fg (cdr part))))
        (setq atts (append atts `(:foreground ,color))))
      (when (setq color (cdr-safe (assq 'bg (cdr part))))
        (setq atts (append atts `(:background ,color))))
      (when (setq color (cdr-safe (assq 'ul (cdr part))))
        (setq atts (append atts `(:underline ,color))))
      (face-spec-set face-name `((t . ,atts)))
      (add-text-properties 0 (length str) `(face ,face-name) str)
      (setq ovstr (concat ovstr str))
      (setq idx (1+ idx)))

    (setq ov (make-overlay (point) (point)))
    (overlay-put ov 'before-string ovstr)
    (setq pgtk-preedit-overlay ov)))

其工作步骤可概括为 3 步：

清空旧状态：删除上一次生成的 Overlay（覆盖层），避免残留内容干扰。
构造拼音字符串：遍历输入法传来的事件数据，将拼音内容（ovstr）根据输入法指定的样式（前景色、背景色、下划线）进行着色处理。
创建并渲染 Overlay：在当前光标位置（point）创建一个长度为 0 的 Overlay，将着色后的拼音字符串作为 before-string 渲染——简单说，就是“在光标位置之前显示这段拼音”。

3.3 候选框跳动的核心原因#

问题就出在 before-string 的渲染逻辑上：

当 before-string 插入拼音文本后，Emacs 的物理光标会被自动推到这段拼音的后面；而 GTK 后端会将光标所在的实时位置告知输入法，输入法则会根据光标位置调整候选框的显示坐标。

这样一来，每输入一个拼音字符，before-string 的长度就会增加，光标就会向后移动，候选框也会跟着向后“跳动”，形成我们遇到的问题。

3.4 解决方案的核心逻辑#

解决问题的关键，是固定光标的位置——让光标始终停留在 preedit 拼音的起始位置，这样输入法获取到的光标坐标就不会变化，候选框自然也就不会跳动。

在 Emacs 中，cursor 文本属性可以控制物理光标在 Overlay 字符串上的停留位置。我们只需给 before-string 增加 'cursor 1 属性，就能让光标固定在拼音字符串的第一个字符位置，修改逻辑如下（对比原始代码）：

-    (overlay-put ov 'before-string ovstr)
+    (overlay-put ov 'before-string (propertize ovstr 'cursor 1))

四、解决方案补充说明#

我们使用 Emacs 强大的 Advice 机制（类似面向切面编程 AOP），在不修改源码的前提下，动态注入上述修改逻辑，这也是我们开头给出的配置代码的核心原理。下面拆解这段配置的关键细节：

;; 解决 Wayland 环境下 PGTK 版本 Emacs 候选框跳动问题
(with-eval-after-load 'pgtk-win
  (advice-add
   'pgtk-preedit-text :filter-return
   (lambda (_)
     (when pgtk-preedit-overlay
       (let ((ovstr (overlay-get pgtk-preedit-overlay 'before-string)))
         (overlay-put
          pgtk-preedit-overlay
          'before-string
          (propertize ovstr 'cursor 1))))))

with-eval-after-load 'pgtk-win：延迟加载保护。因为 pgtk-preedit-text 函数定义在 pgtk-win.el 模块中，只有在 Wayland 环境下加载该模块后，advice-add 才能找到目标函数，避免启动报错。
:filter-return：Advice 的类型，意为“在原始函数执行完毕后，对其返回值进行过滤/修改”。这里我们不需要修改返回值，只是利用其“执行时机”，在原始函数创建完 Overlay 后，追加光标位置的设置。
overlay-put ... 'cursor 1：核心操作。原始函数执行后，pgtk-preedit-overlay 已创建并渲染，我们获取其 before-string，添加 'cursor 1 属性后重新赋值，从而固定光标位置，解决候选框跳动问题。

最好用的视频倍速脚本

Tue, 17 Mar 2026 11:32:00 GMT

这个脚本是我写的，对我来说，当然是“最好的”。

在播放器里手动调节视频速度我觉得相当麻烦，倍速之后想回到原速还得再调一遍，繁琐且不便，于是我写了一个可以便捷控制视频倍速的浏览器脚本。

这个脚本只需要使用到右手，在视频全屏状态下生效，按键绑定为：

J – 原速
K – 2 倍速
L – 3 倍速
H – 后退 5 秒
; – 前进 5 秒
O – 后退 90 秒
P – 前进 90 秒

键盘 J 键有一个凸起，可以快速定位，右手默认摆放的位置就和平常打字时一样，食指 J 原速，中指 K 二倍速，无名指 L 三倍速。

当因为倍速播放错过了精彩的片段，则可以按 H 后退 5 秒，如果退太多，则可以按;（分号）前进 5 秒。

拇指放在空格键，随时暂停视频。O 和 P 分别是 90 秒，即 1 分 30 秒，主要用于跳过动画的 OP，绝大多数的动画 OP 时常都是 90 秒。

用一只手就能控制视频的倍速，还能前进后退跳转，这太棒了！我觉得这个按键设计是最好的，没有之一。

我喜欢文字

Tue, 17 Mar 2026 10:45:00 GMT

文字能保存我的想法，在我需要时，重新阅读文字，就能让我再次想起当时的想法。

文字让我轻松改进自己的想法，因为对文字的优化，就是对想法的优化。

文字减少了我的思考负担，一边思考，一边记录，审视自己的思路，避免忽略重要细节。

文字输入很方便，无论在手机还是电脑上，都能轻松输入；编辑器数量繁多，输入方式多样——触屏、键盘、语音识别都可以使用。

文字能长时间保存，只要载体存在，文字便不会轻易消失。

文字空间占用小，便于传输和存储。

在 Archlinux 上运行网易云音乐

Mon, 26 Jan 2026 19:19:00 GMT

安装必要的软件：

sudo pacman -S wine wine-mono winetricks

在官网下载网易云音乐的安装包：

https://music.163.com/#/download

使用 winetricks 安装必要的字体和依赖：

WINEPREFIX=~/wine/netease-music winetricks arial courier cjkfonts allcodecs d3dx9 dxvk winhttp wininet

安装网易云：

WINEPREFIX=~/wine/netease-music wine ~/Downloads/NeteaseCloudMusic_Music_official_3.1.26.204919_32.exe

之后的启动方式：

WINEPREFIX=~/wine/netease-music wine "/home/wanten/wine/netease-music/drive_c/Program Files (x86)/NetEase/CloudMusic/cloudmusic.exe"

Git Bash 的 ln -s 无法创建软链接

Fri, 16 Jan 2026 12:43:00 GMT

在 Windows 中创建软链接，我一般都是在 PowerShell 中执行这个命令：

New-Item -ItemType SymbolicLink -Path "Path to target" -Target "Path to source" -Force

但这个命令太长了，而且先写目标，再写源的这个命令顺序非常不自然。

于是我尝试在 Git Bash 中用 ln -s命令，这个命令很简短，先源再到目标的这个顺序也让我感到舒服：

ln -s /path/to/source /path/to/target

我运行这个命令，成功了。但没过多久，我感到不对劲，因为我偶然发现对源文件的修改，没有同步到目标文件中，两者就好像毫无关联一般。

针对这个问题，我认真测试了ln -s命令，运行之后，分别对源文件和目标文件进行修改，对照着观察变化。结果就是，它没有创建软链接，而是直接复制了一份源文件。

这个结果让我感到意外，我猜测可能是兼容性问题。

在网上调研后发现，这是一个常见的坑。Git Bash 中创建软链接要用 mklink 替代，或配置 core.symlinks或开启Developer Mode……我觉得这个也好麻烦啊，干脆继续使用 PowerShell 命令。

在 Obsidian 中专注于子文件夹

Thu, 15 Jan 2026 12:13:00 GMT

我的 Vault 中很多文件夹，其中有一些文件夹有很深的子文件夹，例如 vault/a/b/c/d/e。某些时候我想专注于文件夹e进行编辑，而不想在Files中看到这个文件夹之外的内容。

我想到的解决方案是将文件夹e作为一个 vault 打开，用另一个 obsidian 窗口去编辑它，但这样做的问题是，它会在文件夹e之下创建新的配置文件夹.obsidian，这有些烦人。

我要么重新配置，要么把原 vault 中的配置复制过来。这导致的情况是我要用额外的空间去存储多出一份的配置文件。

我想到了另一个解决方案，用软连接将原 vault 中的配置文件链接到子目录e中，这样几乎不占多余的空间，并且完全继承了原 vault 的各种配置。

ln -s /path/to/vault/.obsidian /path/to/vault/a/b/c/d/e/.obsidian

现在的坏消息是，模板功能没法正常使用了，因为它们的配置是基于目录的，除非我把目录文件夹也软链接到子目录中。

这样做确实有效。

ln -s /path/to/vault/templates /path/to/vault/a/b/c/d/e/templates

我写了一个脚本，只需输入目标路径，就能自动将原 vault 的配置和模板自动链接过去。

最终我达成了我的目的：在 Obsidian 中专注于子目录。

我认为这是一个实用的功能，希望官方能够实现它，比如点击某个按钮后，Files只显示我想要专注的目录。

我为什么不再使用纯纯写作

Thu, 26 Oct 2023 15:13:00 GMT

多窗口支持#

纯纯写作在手机上的功能比较健全，电脑版的纯纯写作只有一个编辑器，这个编辑器通过热点连接可以编辑手机上纯纯写作正在编辑的内容。

手机上的纯纯写作一次只能打开一个文章，这导致电脑上的编辑器一次也只能编辑一个文章，想同时打开两篇及以上的文章？抱歉，目前还做不到。

文字工作者写作时经常要参考之前写过的文章或笔记，因为纯纯写作无法同时打开多篇文章，于是作者不可避免地要在当前文章和其他参考文章之间频繁性切换，这样的写作体验是非常糟糕的。

纯纯写作作者 Drakeet 在开发全新的电脑版纯纯写作，到时应该能够在电脑上同时编辑查看不同的文章。

章卷管理#

纯纯写作中可以创建【书籍】，在【书籍】下可以创建【卷】，在【卷】之下能创建文章，这就是它所有的文章组织方式了。

卷与卷之间无法嵌套，这样限制了文章的多层级分类管理。文章写得多了，会出现一个卷里有非常多的文章，或一个书籍下有非常多的卷，有些卷是包含关系，但因为不能嵌套，所以只能放到平级。

我认为理想的组织方式是像传统的文件/文件夹结构一样，文件夹里可以有文件夹，可以一直嵌套。

除了章卷组织，在纯纯写作中，文章的转移也非常难用。

一个文章想从 A 卷转移到 X 卷，只能手动拖拽，无法指定转移。

两个及以上的文章想同时从 A 卷转移到 X 卷？抱歉，做不到，只能一个个拖。

A 书籍 A1 卷中的文章想转移到 B 书籍 B1 卷中？没有直接的方法，只能先转移到 B 书籍最后一个卷 B99 中，再从 B99 卷拖拽到 B1 卷中。

A 书籍 A1 卷想要整体转移到 B 书籍中？没有快捷方法，要先在 B 书籍最后面创建一个名叫 A1 的卷，再从 A 书籍中全选 A1 卷中的文章，批量转入到 B 书籍最后一个卷 A1 中。

A 书籍想要和 B 书籍合并？麻烦，要按前一个方法所说一个一个卷地转移。

章卷管理，纯纯写作为数不多的优势就是可以手动调整章节的顺序。

文章导出#

单篇文章要导出？简单，复制、导出图片、PDF、txt 文件。

整个卷要导出？麻烦，先把这个卷复制到……噢，好像不能复制，先整卷转移到一本新书籍中，然后整本书导出，接着再转移回去。

A 书籍整本书导出？就给你生成一个 A.txt，里面混杂所有的章节，所有内容堆在一起。为什么不能生成一个 A 文件夹呢？A 文件夹下面再是卷文件夹 A1、A2、A3，这些卷文件夹下面再是一个个独立的章节文件，a.txt, b.txt……这样不是很好？

总结#

我不需要太多东西，只需要【文章的多层级分类管理】、【快捷的文章转移及组织】以及能够【开启多个窗口同时编辑多个文章】。纯纯写作无法满足我这些需求，因此我决定将文章从纯纯写作中迁移出去，迁移到一个能满足我需求的工具上。

迁移可把我折腾坏了，导出的东西居然是全部混杂在一起的。