xdtui
X岛匿名版(xdnmb)的终端(TUI)客户端。基于 Rust 核心 + Python Textual 界面 的混合架构:Rust 核心负责网络请求、缓存、全文检索与本地数据库,Python 端提供终端交互界面,二者在本机通过 gRPC 通信。
功能特性
- 浏览版块 / 时间线,翻页、跳页与按 ID 跳串,查看最新回复
- 串详情阅读:只看 Po、回复、引用跳转、引用列表、防剧透黑幕
- 发新串 / 回复 / 举报,多饼干(Cookie)切换与颜文字快捷插入
- 订阅(Feed)列表与「我的发言」本地记录
- 星标串(Favorites,支持备注,主要是清理豁免)
- 屏蔽串(折叠不想看的串,支持备注)
- 「Tips 酱」语录收集
- 本地全文检索(Tantivy + 仓颉分词,支持自定义分词列表)
- 本地离线缓存(内存 + SQLite 分层存储)
- 图片浏览(缩略图 / 原图查看器)
- 浏览历史(本地记录看过的串)
- 版规查看、存储管理(DB/索引统计、缓存清理、Tips 管理)与设置面板
- 多种主题、动态配色
- 核心服务崩溃自动重启
- 极简模式(隐藏多余 UI)
浏览页数上限与「重放」
X 岛服务端在翻页很深时会回放前序页的内容。xdtui 按「整页串 ID 序列完全相同」识别它,并弹出「检测到重放」警告。两类现象成因不同,不要混淆:
- 普通版面串列表(非时间线):翻到深处(通常第 100 页起,边界随时可能变动)仍会重放,与有没有饼干无关。请求本身不报错、不返空,只是内容重复,相当于服务端给单版块可浏览页数加了一道软限制;应用有效饼干也无法越过。时间线则另有 API 返回的真实末页硬上限,与此不同。
- 串详情:只有游客模式(无饼干)在回复翻到深处时才会重放,应用有效饼干后通常可以越过。也就是说,有无饼干影响的是串详情内的重放现象,不影响串列表。
客户端把最后一个有效页(即「重放源页」,如第 100 页)记作可浏览上限:触底时仍会继续探查下一页(边界推后可自动越过),但重复页不再追加渲染。跳页直接越过它时(例如已知最后有效页是 100,却从第 1 页跳到 101),请求仍会发出以重新确认边界;确认是重放后界面会回落渲染第 100 页并弹出警告,而不是把用户留在跳页前的第 1 页。
安装与更新
需要 Python 3.12+。
推荐方式(uv)
推荐使用 uv 进行隔离全局安装,兼顾依赖隔离与全局命令调用的便利:
# 安装
uv tool install xdtui
# 更新
uv tool upgrade xdtui
# 卸载
uv tool uninstall xdtui
传统方式(pip)
# 安装
pip install xdtui
# 更新
pip install -U xdtui
# 卸载
pip uninstall xdtui
安装后直接在终端运行:
xdtui
系统依赖
支持平台:Windows、Linux(x86_64 / aarch64)。
- Windows:开箱即用,二维码解码库(zbar)已随包附带,无需额外安装。
- Linux:需系统提供 zbar 库,否则扫码功能会报错:
- Debian/Ubuntu:
sudo apt install libzbar0 - Fedora:
sudo dnf install zbar
- Debian/Ubuntu:
键盘快捷键
全局
| 按键 | 功能 |
|---|---|
ctrl+q / q |
退出 |
z |
极简模式(隐藏多余 UI) |
主界面(版块 / 串列表)
| 按键 | 功能 |
|---|---|
j / ↓ |
下一项 |
k / ↑ |
上一项 |
h / ← |
上一页 |
l / → |
下一页 |
space |
首页(回到第 1 页并刷新) |
enter |
打开当前串 / 版块 |
s |
跳页 |
r |
刷新本页 |
b |
版块侧栏 |
/ |
搜索 |
n |
发新串 |
m |
发言 |
f |
订阅 |
B |
展开/折叠屏蔽 |
alt+h |
浏览历史 |
alt+t |
跳串(按 ID) |
alt+g |
版规 |
alt+r |
引用列表 |
t |
看图(仅含图卡片可用;无图模式或配置缺失时禁用) |
版块侧栏内:↑/↓(或 k/j)移动焦点,←/→(或 h/l)展开/折叠组节点(在版块或时间线叶子节点上按 Enter / → / l 均可直接加载该版块);r 重新加载侧栏、e 全部展开/折叠、esc 返回列表。
串详情界面
| 按键 | 功能 |
|---|---|
esc |
返回 |
/ |
搜索 |
o |
只看 Po |
p |
回复 |
P |
引用回复 |
f |
订阅 |
S |
星标 |
B |
屏蔽 |
R |
举报 |
t |
看图(仅含图楼层可用;无图模式或配置缺失时禁用) |
发串 / 回复 / 举报 弹窗
| 按键 | 功能 |
|---|---|
esc |
取消 |
ctrl+g |
快捷插入(颜文字) |
ctrl+enter |
快捷回复 |
模态窗口 / 确认弹窗
所有带明确确认/取消或关闭按钮的模态窗口(如二次确认、跳页、岛公告、选择饼干、选择订阅 UUID、版规、帮助、关于等):
| 按键 | 功能 |
|---|---|
y |
快捷确认 / 同意 / 知道了 |
n |
快捷取消 / 拒绝 / 关闭 |
esc |
取消 / 关闭 |
注:含有文本输入框的弹窗(如发串/回复、搜索输入框、星标备注)在焦点处于输入框时优先响应文本输入,不影响字符输入。
引用弹窗
在串详情中点击某条引用(或按 alt+r 打开引用列表后选中某条)弹出的引用查看窗口。此外,串详情中每条「最新回复」的单行文本也可直接点击,以同样方式弹出该条回复的完整图文(零延迟本地渲染)。
| 按键 | 功能 |
|---|---|
g |
跳转到被引用的原串 |
esc |
关闭 |
历史界面
| 按键 | 功能 |
|---|---|
c |
清空浏览历史 |
esc |
返回 |
搜索
| 按键 | 功能 |
|---|---|
enter / ctrl+s |
搜索 / 重新搜索(焦点在结果卡片时回车打开串或回复) |
/ |
聚焦搜索栏 |
← / h |
上一页 |
→ / l |
下一页 |
space |
首页 |
s |
跳页 |
r |
刷新本页 |
esc |
关闭 |
其他界面与鼠标快捷操作
- ESC 返回:订阅、历史、我的发言、设置、存储管理、图片查看以及各类模态弹窗均支持按
esc返回 / 关闭。 - 全屏中键快捷返回:在系统设置中开启「中键返回」(默认开启)后,在所有支持
esc返回的界面及弹窗中,在全屏任意位置点击鼠标中键(滚轮按下)均等价于按esc;在各类y/n确认弹窗中中键等价于「取消」。 - 主界面中键表现:在无
esc返回的主界面中,鼠标中键保持原始行为(与左键/右键一致;若已聚焦版块树时中键等价于按esc聚焦回串列表)。 - 空白处关闭:模态窗口(除发串编辑器外)均支持点击遮罩空白处直接关闭。
数据与日志位置
应用数据(配置 config.toml、本地数据库 data.db、全文检索索引)统一存放在:
- Windows:
%APPDATA%\xdtui\xdtui\config\ - Linux:
~/.config/xdtui
运行日志 app.log 位于数据目录下的 cache/ 子目录:
- Windows:
%APPDATA%\xdtui\xdtui\config\cache\app.log - Linux:
~/.config/xdtui/cache/app.log
许可证
本项目以 MIT 许可证 发布。
Metadata
Release files for xdtui 0.1.52
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| xdtui-0.1.52-cp312-abi3-win_arm64.whl | CPython 3.12 | abi3 | Windows ARM64 | Details for xdtui-0.1.52-cp312-abi3-win_arm64.whl |
| xdtui-0.1.52-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details for xdtui-0.1.52-cp312-abi3-win_amd64.whl |
| xdtui-0.1.52-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ x86-64 | Details for xdtui-0.1.52-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
| xdtui-0.1.52-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ ARM64 | Details for xdtui-0.1.52-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
Total release size: 56.5 MB
Release files / xdtui-0.1.52-cp312-abi3-win_arm64.whl
| Download URL | xdtui-0.1.52-cp312-abi3-win_arm64.whl |
|---|---|
| Size | 13.4 MB |
| Tags | CPython 3.12 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
9d23badf2035f49b91bae582e9967a86902fdf465adcd3f901cea744307d3162
|
|
BLAKE2b-256 checksum How to use checksums |
2f1bbe1749aa2f012d2bd778c4d2761aaf0753e0b3d29c50d81f4e43b43dab02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / xdtui-0.1.52-cp312-abi3-win_amd64.whl
| Download URL | xdtui-0.1.52-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 13.7 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
3e3daaddb9311443f4715d6509c1b18a6eb8f34afe70fc3ab4e9ecfdf9ee6365
|
|
BLAKE2b-256 checksum How to use checksums |
9f226c4dd98ff82c82a02fb86f0bd8ea3c63282ee7f38cc7bdac8c315b2a7691
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / xdtui-0.1.52-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | xdtui-0.1.52-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 15.0 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
13fbcfd645795405b68466b9300fc5349907af93be9822c84e197f6cfb7655e7
|
|
BLAKE2b-256 checksum How to use checksums |
1811c345fe7e349d66f0f193fc9d5aea0201d66a6d8c742ea9b64554dd509715
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / xdtui-0.1.52-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | xdtui-0.1.52-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 14.4 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
cf1f93ea7f19dca5026226095fc06c076d9a8d6984a0a218611b74f2e16035d2
|
|
BLAKE2b-256 checksum How to use checksums |
adf27cdcb20cbd7f2268d483068e447516320f72cbde3ad98c3e1808e55c79f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for xdtui 0.1.52
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.