SuperAPI AI 工具集

keepass

智能体与模型

查看项目

更新于 10-15 22:41

技能介绍

用途:该技能用于在 Cursor 中通过 KeePassXC 数据库 cursor.kdbx 统一管理密钥,数据库可放在 OneDrive 或 Google Drive 同步,配合操作系统原生 keyring 只保存 master 密码,所有应用密钥存放在 KeePass 中,不写入仓库或 .env。调用方式为 /keepass。

主要能力:按平台使用原生 keyring——Windows 用 SecretStore(KeePassXC-Cursor-DB),Linux/WSL 用 secret-tool(service=keepassxc,attribute=cursor-db);提供路径解析、密钥读取、保存密码到 keyring、初始化 keyring、新增主机条目等脚本,以及 keepass_ops.py 的 get/add/update 操作。条目结构约定:SSH 主机为 hosts/<hostname>/<username>,sudo 为 hosts/<hostname>/sudo,项目为 <project>/<env>/<title>,MCP API keys 为 API Keys/<Service>。

使用方式:先确保 ~/.cursor/keepass-db.path 存在且首行为 cursor.kdbx 的绝对路径,否则停止并请用户提供,不猜测路径。WSL 下同一文件可能位于 ~/.cursor/ 或 /mnt/c/Users/<user>/.cursor/,脚本会检查两处;Windows 侧改动后可运行 wsl bash /mnt/c/Users/janja/.cursor/scripts/sync-keepass-to-wsl-home.sh。也可在会话中设置 export KEEPASS_DB_PATH="/pełna/ścieżka/cursor.kdbx"。缺少工具时按平台安装,例如 Linux/WSL 执行 sudo apt install -y libsecret-tools gnome-keyring dbus-x11 与 sudo apt install -y keepassxc;Windows 安装 Microsoft.PowerShell.SecretManagement 与 SecretStore 模块。测试可用 ~/.cursor/scripts/test-keepass-read.sh(Linux/WSL)或 .\get-keepass-secret.ps1 "hosts/euk-sl01/sudo" "Password"(Windows)。

限制与规则:不混用不同系统的 keyring 机制;WSL 视为 Linux,使用 bash 与 secret-tool,不用 powershell.exe 或 Windows SecretStore;不记录密钥值;无路径回退,也不在 ~/.cursor 保存密码文件副本;需要 sudo 时先请求用户确认。相关文档为 ~/.cursor/doc/keepass.md 与 ~/.cursor/doc/mcp-secrets.md。