Klip

极简终端密码管理器。

功能 · 安装 · 使用 · 安全

功能

• 完全离线运行。
• 安全加密：使用 Argon2id 进行密钥派生，并利用 libsodium 进行认证加密。
• 安全的密码生成器。
• 无需外部库的自定义 TUI。

安装

AppImage

从 发布 下载 AppImage 并运行：

chmod +x klip-x86_64.appimage 
./klip-x86_64.appimage

从源码构建

依赖项：

• libsodium

安装：

git clone https://github.com/vid4l-07/Klip.git
cd klip
mkdir build
cd build
cmake ..
make
sudo make install

使用

全局

标签栏

数据库

复制到剪贴板

当选中一条凭证时：

• 在用户上按 Enter 复制用户名。
• 在密码上按 Enter 复制密码。

打开文件

选择“打开”时，会出现一个文本弹窗。在弹窗内，你可以按 Tab 在最近打开的数据库之间切换。

你可以输入数据库的绝对路径或相对路径。如果文件不存在，且指定路径有效，则会创建该文件。

最近的文件路径存储在 $HOME/.config/klip/recents 中。

安全

所有加密逻辑位于 src/Security.cpp 中。

密钥派生

• 创建数据库时，会要求输入主密码。
• 使用来自 libsodium 的 crypto_pwhash，基于 Argon2id 的交互式模式（可通过调整成本参数抵御暴力攻击），从密码和唯一随机盐中派生加密密钥。

加密

• 使用派生的密钥和随机 nonce，通过 crypto_secretbox_easy 对数据库进行加密。
• 该算法通过 MAC 提供篡改检测。

存储格式

• 加密文件以二进制格式存储，格式如下：

[salt][nonce][ciphertext]

解密过程

• 使用用户提供的密码和存储的盐来派生密钥。
• 使用 crypto_secretbox_open_easy 解密数据。
• 如果密码不正确或文件被修改，MAC 验证将失败，操作会被拒绝。

贡献

欢迎任何形式的贡献。如果你发现 bug 或想帮助开发新功能，可以：

• 在仓库中提交 issue。
• 提交 pull request。
• 发送电子邮件至 [email protected]

贡献想法

我需要有关方向键检测的帮助：

目前，普通按键能被正确检测，但方向键总被解析为单独的 ESC 按键，而不是完整的转义序列。

如果你有终端输入（termios、ANSI 转义序列等）方面的经验，我将非常感谢你的帮助。

读取按键的逻辑位于 src/term/term.cpp，尤其是 read_char 函数，并且由位于 src/ui/app/app.cpp 中的 App 类的 start 函数使用。

如果你想贡献代码，请尽量将更改限制在 read_char 函数或 Terminal 类中，这样项目的其余部分就不需要修改。