xdtui
X岛匿名版（xdnmb）的终端（TUI）客户端。基于 Rust 核心 + Python Textual 界面 的混合架构：Rust 核心负责网络请求、缓存、全文检索与本地数据库，Python 端提供终端交互界面，二者在本机通过 gRPC 通信。
功能特性
- 浏览版块 / 时间线，翻页、跳页与按 ID 跳串
- 串详情阅读：只看 Po、回复、引用跳转、引用列表、剧透揭示
- 发新串 / 回复 / 举报，多饼干（Cookie）切换与颜文字快捷插入
- 订阅（Feed）列表与「我的发言」本地记录
- 星标收藏（Favorites），主要是清理豁免
- 「Tips 酱」语录收集
- 本地全文检索（Tantivy + 仓颉，支持自定义梗词分词）
- 本地离线缓存（内存 + SQLite 分层存储）
- 图片浏览（缩略图 / 原图 / TUI 原生模式）
- 浏览历史（本地记录看过的串）
- 版规查看、存储管理（DB/索引统计、缓存清理、Tips 管理）与设置面板
- 深色主题、动态配色
- 核心服务崩溃自动重启
- 极简模式（隐藏多余 UI）
安装
需要 Python 3.12+。
pip install 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 |
订阅 |
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 |
星标（收藏） |
R |
举报 |
t |
看图（仅含图楼层可用；无图模式或配置缺失时禁用） |
发帖 / 回复 / 举报 弹窗
| 按键 | 功能 |
|---|---|
esc |
取消 |
ctrl+g |
快捷插入（颜文字） |
ctrl+enter |
快捷回复 |
模态窗口 / 确认弹窗
所有带明确确认/取消或关闭按钮的模态窗口（如二次确认、跳页、岛公告、选择饼干、选择订阅 UUID、版规、帮助、关于等）：
| 按键 | 功能 |
|---|---|
y |
快捷确认 / 同意 / 知道了 |
n |
快捷取消 / 拒绝 / 关闭 |
esc |
取消 / 关闭 |
注：含有文本输入框的弹窗（如发帖/回复、搜索输入框、星标备注）在焦点处于输入框时优先响应文本输入，不影响字符输入。
引用弹窗
在串详情中点击某条引用（或按 alt+r 打开引用列表后选中某条）弹出的引用查看窗口：
| 按键 | 功能 |
|---|---|
g |
跳转到被引用的原串 |
esc |
关闭 |
历史界面
| 按键 | 功能 |
|---|---|
c |
清空浏览历史 |
esc |
返回 |
搜索
| 按键 | 功能 |
|---|---|
enter / ctrl+s |
搜索 |
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 许可证 发布。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xdtui-0.1.33-cp312-abi3-win_arm64.whl.
File metadata
- Download URL: xdtui-0.1.33-cp312-abi3-win_arm64.whl
- Upload date:
- Size: 14.9 MB
- Tags: CPython 3.12+, Windows ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5274b4c53325c2a27dfc872643626530ad95c2251ea02ed8f1f0b95b823bf1ed
|
|
| MD5 |
f319ab7a438f3acccd68619e0dd2f87e
|
|
| BLAKE2b-256 |
1bfc72f4d0ef508e08589ea70f5c5d77aa32974ba7ec8ca7572e609c5bfa67e2
|
File details
Details for the file xdtui-0.1.33-cp312-abi3-win_amd64.whl.
File metadata
- Download URL: xdtui-0.1.33-cp312-abi3-win_amd64.whl
- Upload date:
- Size: 15.4 MB
- Tags: CPython 3.12+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c738c4ba7fa3cfc87d378a0be20bca0a392f160783720f84438449d4d38e771
|
|
| MD5 |
02217946172f46374967bcbe07e80a89
|
|
| BLAKE2b-256 |
3caa67051ccacf4194c21aef4d5cfdcf9a70ede955e2f723687b6b3ca76ce6ad
|
File details
Details for the file xdtui-0.1.33-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: xdtui-0.1.33-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 16.8 MB
- Tags: CPython 3.12+, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ad67c347da9e511ff26af1ff827b5ee4b21a3b0d9fb8b26c742b62358f39afcb
|
|
| MD5 |
a26736289d617a142e99d19d100b6483
|
|
| BLAKE2b-256 |
5e0684455ad626035b6cbe2b8ecfe44d2249894e56a30b480513071de873b675
|
File details
Details for the file xdtui-0.1.33-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: xdtui-0.1.33-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 16.0 MB
- Tags: CPython 3.12+, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
842f0f7f4c001051c7019042ae9887b2fd427376616e78f6351539a5ef1826fe
|
|
| MD5 |
05d5e35d999d44b90b3c12612121ea2a
|
|
| BLAKE2b-256 |
9cfcd123419c47dd35992f73583229835baa6f6a1bdf00eb2822882d8e194910
|
