eilmeldung 是一款基于 news-flash 库构建的终端 TUI RSS 阅读器，专为 Vim 爱好者打造。它采用经典的 (Neo)Vim 风格快捷键设计，同时完整支持鼠标点击、右键标记和滚轮滚动，让你在终端里以"手指不离键盘"的速度读完所有订阅源。本手册系统梳理导航、读文、标记、过滤等全部默认快捷键与鼠标操作，帮你快速上手这款轻量级 RSS 阅读器。

1分钟认识界面：三栏布局是快捷键的地基

理解 eilmeldung 的快捷键，先要理解它的三栏结构：

g f/g a/g c是 Vim 风格的"跳转序列"——先按g，再按目标键。Tab/Shift-Tab则可在三个面板间循环切换焦点，类似 Vim 里的窗口跳转。

核心快捷键速查：导航篇

移动光标：j/k 走天下

j / k 下移 / 上移（Vim 经典） gg 跳到列表第一项 G 跳到列表最后一项 Ctrl-f 向下翻一页 Ctrl-b 向上翻一页 h / l 左移焦点（内容→列表→源）/ 右移焦点（源→列表→内容）

跨面板的"远程移动"非常实用，无需先切焦点：

• C-j/C-k：从任何面板直接控制订阅源列表的上下移动
• M-j/M-k：从任何面板直接控制文章列表（M-即 Alt 键）
• J/K：从任何面板直接滚动文章正文

订阅源树的高效操作

space展开/折叠分类树节点，C-h/C-l在树中上下导航。配合j/k浏览订阅源，基本不需要碰鼠标。

核心快捷键速查：读文篇

💡 小技巧：0 r可把当前文章及其上方所有文章标记为已读；$ r则标记当前及下方全部。对u（未读）、m（标记）、v（取消标记）同样有效——这是 eilmeldung 独有的"位置批量操作"语法，源自 Vim 的0/$行首行尾语义。

标记与旗标：批量操作的高级玩法

Vim 用户熟悉"可视区选择"，eilmeldung 用**旗标（flag）**实现同样的批量能力：

f / d 标记 / 取消标记当前文章为旗标 F / D 标记 / 取消标记列表全部文章 i / I 反转当前 / 全部文章旗标

打上旗标后，再执行r（已读）、m（标记收藏）、t（加标签）等命令，就会作用到所有旗标文章上。0 f和$ f同样支持按位置批量打旗标。

收藏与标签：m收藏当前文章、M收藏全部；t/T打开命令行添加/删除标签（Tab自动补全标签名和颜色），例如:tag tech unread可给所有未读文章批量打tech标签。

搜索与过滤：秒级定位文章

配合查询语法，unread today、author xxx这类组合让"今天谁发了什么"一问即得。更多查询写法见 docs/queries.md。

在文章内打开链接：Hints 提示模式

阅读时想打开正文里的超链接？eilmeldung 借鉴了 Vim 的 hint 机制：正文中的每个链接/图片前会浮现一个字母提示。

只需按下对应组合键：

• ; ;再按提示字母 → 在浏览器中打开该链接
• ; y+ 字母 → 复制链接到剪贴板
• ; s+ 字母 → 分享该链接

鼠标操作完全指南：不敲键盘也能读

不想背快捷键？eilmeldung 默认开启鼠标支持（[mouse_config]中enable = true），三个面板各有分工：

订阅源面板

• 左键：聚焦面板并选中条目；再次点击已选中条目可展开/折叠树节点
• 滚轮：上下移动选中项
• 右键：确认并标记该订阅源为已读

文章列表面板

• 左键：聚焦并选中文章
• 右键：标记该文章为已读（清栏神器）
• 中键：浏览器打开文章并标记已读
• Ctrl+左键：反转该文章的旗标状态
• 滚轮：上下切换文章

文章内容面板

• 左键：聚焦正文
• 中键：抓取文章全文（scrape）
• 滚轮：滚动正文

拖拽调整面板宽度

按住文章列表与正文之间的分隔条左右拖动，即可动态调整内容面板宽度——宽屏看长文，窄屏扫标题，随心切换。

⚠️ 如果你的终端（如 ghostty）滚动事件过快，可在配置中设置scroll_debounce_millis = 50到500来平滑滚动；某些终端不传中键事件时，可用C-left（Ctrl+左键）代替。

自定义快捷键：像改 Vim 配置一样简单

所有键位都能在配置文件的[input_config.mappings]段重新映射，支持多键序列（"g g"）、修饰键（C-/M-/S-）以及一个键绑定多个命令。完整默认映射见 examples/default-config.toml，配置语法详解见 docs/configuration.md。

[input_config.mappings] # Vim 风格保存退出 "Z Z" = ["confirm quit"] # 快速标签序列 "t i" = ["tag important"] "t u" = ["tag urgent"]

鼠标映射同理，在[mouse_config.feeds_mappings]、[mouse_config.articles_mappings]、[mouse_config.content_mappings]三段中按面板分别定义，事件支持left、middle、right、scroll_up等，并可加C-/M-/S-修饰。

快速上手建议：3步建立肌肉记忆

1. 第一天：只记j/k移动、l进入正文、h返回列表、r标记已读、q退出
2. 第二周：加上/搜索、g f跳订阅源、0 r批量已读、; ;打开链接
3. 进阶：尝试f旗标批量操作、\自定义排序、禅模式z深读

遇到任何拿不准的键位，随时按?打开帮助面板（支持/过滤查找命令）——完整快捷键参考文档就在 docs/keybindings.md。掌握这份手册后，你的终端新闻流将快得像 Vim 的gg一样干脆。