TUI 模式
直接运行 sip(不带任何参数)进入文件夹式 TUI,启动后先显示开始界面(slogan + Dashboard 数据面板),回车进入、Q 退出。
左侧是订阅源 + 文章合并的树形视图:订阅源是父节点(▶/▼ 展开收起),展开后看到该源的所有文章,像浏览文件夹一样。订阅源默认全部折叠(按 l/Enter/Space 展开;你展开的源在刷新后保持展开)。文章标题过长会自动换行(不会截断),方便一眼看全。每篇文章只显示最新一版;若该文被作者改过、有旧版本,标题右侧会有 ✎ 标记,选中后按 V 可查看全部版本。选中文章时右侧用 Markdown 渲染正文。
快捷键
| 操作 | 说明 |
|---|---|
j / k(或 ↑ / ↓) | 在侧栏中上下选择(标题过长自动换行) |
l / Enter / Space | 在订阅源上:折叠/展开;在文章上:跳转到正文页 |
← | 在正文栏时返回侧栏 |
b(或 PageUp) | 侧栏翻页(Space 在侧栏只做「打开」) |
Space / PageDown | 正文栏内翻页(有历史进度时 Space = 跳回上次位置) |
Ctrl+D / Ctrl+U | 正文栏内半页向下 / 半页向上(vim 习惯) |
i | 沉浸阅读:隐藏侧栏/状态栏/状态行,正文占满全屏(再按 i 恢复) |
U | 下载更新当前订阅源(同 CLI -u) |
F6 | 更新所有订阅源 |
A | 归档当前源(标题加时间戳,同 CLI -a) |
R | 去归档(同 CLI -una) |
X | 删除选中源 / 单篇文章(同 CLI -r) |
D | 添加新订阅源(同 CLI -d) |
S | 语义搜索(同 CLI --search) |
Y | 给当前文章生成摘要(同 CLI --summary) |
G | 切换「完整正文 / 文章概要」 |
V | 查看文章版本/变更历史(标题带 ✎ 标记的文章才有;输入编号可看旧版正文) |
M(或命令行 manage) | 打开「订阅源管理页」:全屏列出所有源,j/k 移动、u 更新、a 归档、r 去归档、x 删除、s 设计划、d 加源 |
C | 折叠/展开左侧栏 |
H | 快捷键帮助 |
F2 | 关于页 |
Esc | 唤出底部命令行,输入指令后 Enter 执行、再按 Esc 关闭 |
Ctrl+O | 链接导航模式 |
Q | 退出程序 |
阅读进度记忆:每篇文章的滚动位置会记住(存在
readwithhotsoup/reading_progress.json,不改数据库)——重新打开有历史进度的文章时,底部状态行会提示「▷ 按 Space 跳回上次位置」,按Space快速跳回上次读到的位置(已做边界校验,不会跳到负值或超出正文)。
底部命令行
按 Esc 唤出(平时隐藏),可直接输入与 CLI 相同的命令,例如:
u 2 # 更新 2 号源
d https://xxx # 下载添加新源
a 2 # 归档 2 号源
r 2 # 去归档 2 号源
s 关键词 # 语义搜索
g 关键词 # 全文搜索(不依赖 AI)
fetch # 抓取当前文章的全文(首次需输入同意短语;摘要过短时正文会提示)
manage # 打开订阅源管理页(同 M 键)
y # 给当前选中文章生成摘要
init # AI 配置向导(对话框版)
index # 向量化当前选中源
reindex # 清空全部向量并重新向量化
q # 退出