pkq

跨发行版（DEB / RPM）Linux 软件包统一查询工具 —— 一套命令，两种生态。

pkq（Package Query）统一封装 dpkg/apt 与 rpm/dnf 两套包管理生态， 提供一致的查询语法、双语（中/英）排版与统一的 JSON 输出、退出码语义。

特性

• 双后端统一：DEB（dpkg / apt / Contents 索引）与 RPM（rpmdb 三格式原生解析 / repodata）
• 九大子命令：info list owns deps rdeps search source changelog cache
• Tab 补全：子命令 / 参数 / 包名 / 文件路径全量可补（bash / zsh，安装器自动注册）
• 语义对齐原生工具：rdeps 与 dnf repoquery --whatrequires 结果一致（强依赖 + 能力集匹配）
• 多级缓存：HTTP ETag/TTL → 解析结果 postcard → mmap Contents 检索；离线自动降级
• 机器可读：--output json 统一结构化输出；退出码 0/1/2（命中/未找到/错误）
• 中文友好：运行时中英切换、CJK 宽度对齐排版

安装

一键安装（自动识别 x86_64 / aarch64，下载并校验 sha256 后安装）：

curl --proto '=https' --tlsv1.2 -sSfL https://github.com/rtczza/pkq/releases/latest/download/install.sh | sh

默认安装到 /usr/local/bin（无写权限时自动降级到 ~/.local/bin，并提示 PATH 配置）。 可用环境变量控制：PKQ_VERSION（指定版本）、INSTALL_DIR（安装目录）。

卸载（删除二进制、安装器写入的 PATH 行和 ~/.cache/pkq 缓存）：

curl --proto '=https' --tlsv1.2 -sSfL https://github.com/rtczza/pkq/releases/latest/download/install.sh | sh -s -- uninstall

从源码构建（Rust 1.89+，见 Cargo.toml 的 rust-version）：

cargo install pkq          # 从 crates.io 安装
cargo install --path .     # 从本仓库源码安装
cargo build --release && ./target/release/pkq --help   # 或直接使用构建产物

快速上手

pkq info bash              # 软件包详情（本地优先，未装自动查仓库）
pkq list xz-utils          # 文件列表
pkq owns /usr/bin/sudo     # 文件归属（支持通配符 */bin/unzip）
pkq deps sudo              # 依赖（RPM 自动反查 .so 能力到真实包名）
pkq rdeps bash             # 反向依赖（与 dnf repoquery --whatrequires 对齐）
pkq search unzip           # 关键词 + 文件路径双索引搜索
pkq source xz-utils        # 源码包 ↔ 二进制包互查
pkq cache status|update|clean

任意命令加 --output json 获得结构化输出；--all 查看完整列表（默认限流防刷屏）。

命令总览

缓存管理

pkq cache status           # 各缓存目录占用
pkq cache update           # 强制刷新仓库元数据（逐源进度 + 成败汇总）
pkq cache clean [target]   # 清理：all | index | repos | contents

Tab 补全

一键安装已自动注册（bash / zsh，写入 rc 文件，卸载自动清理）；cargo install 等手动安装时补一行：

echo 'source <(COMPLETE=bash pkq)' >> ~/.bashrc   # bash
echo 'source <(COMPLETE=zsh pkq)' >> ~/.zshrc     # zsh

重新打开终端后：子命令、参数、枚举值（--output json）全部可补； 包名位置参数自动补全本地已安装包（附摘要说明）；owns / search 的 / 开头参数按文件路径补全。补全仅读本地数据库，不触网。

平台支持

仅支持 Linux（依赖 /var/lib/dpkg、/var/lib/rpm、/etc/os-release 等 系统路径，不支持 Windows/macOS）。

• DEB 系：Deepin / UOS Desktop / Debian / Ubuntu
• RPM 系：UOS Server / openEuler / Fedora / CentOS 等

文档

中文：命令参考 · 用户手册

English: Command Reference · User Manual

License

Apache-2.0