OnePass 密码管家
本地加密、完全离线的密码管理器。灵感来自 KeePassXC:数据存在本机文件,不联网,启动密码即唯一钥匙。
安装依赖(首次使用前)
需要 Python 3.9+ 与 cryptography 库:
pip install cryptography
> 若用户没有 Python 环境,可改用独立窗口程序 OnePass.exe(单独分发,双击即用,无需安装 Python)。
给助手(AI 调用):命令行子命令
当用户在对话里说「保存 GitHub 账号 alice 的密码」「GitHub 密码是多少」时,用 python(Windows)或 python3(macOS/Linux)运行本技能目录下 scripts/onepass.py 的子命令:
PY=python3 # Windows 下改为 python
S="<本技能目录>/scripts/onepass.py" # 脚本与 SKILL.md 同级,AI 自动定位
"$PY" "$S" save --platform GitHub --account alice --password 'xxxx' [--note '备注']
"$PY" "$S" query --platform GitHub # 或 --account alice
"$PY" "$S" list
"$PY" "$S" delete --platform GitHub --account alice
"$PY" "$S" clean --yes
说明:
- 保险库默认保存在用户目录 ~/.onepass/vault.opx;可用 --vault <路径> 指定到 U 盘实现便携。
- 首次运行且无保险库时,脚本会引导设置启动密码;之后每次操作需输入启动密码。
- 若提示缺少 cryptography,先执行 pip install cryptography。
- 直接运行脚本(不带子命令)进入交互菜单;窗口版为 scripts/onepass_gui.py(用 pythonw 启动可无黑框)。
给用户(不熟悉电脑):图形窗口
- 双击
OnePass.exe(独立窗口程序,无需安装 Python);若只有源码,运行pythonw onepass_gui.py。 - 首次打开:弹窗要求「设置启动密码」(输入两次,至少 4 位)。这就是以后每次打开都要输入的钥匙。
- 解锁后点按钮操作:保存账号 / 查询密码 / 复制密码 / 删除选中 / 清空全部。
安全提示(务必告知用户)
- 启动密码 = 唯一钥匙。密码忘记或输错,所有信息都无法找回、无法重置。
- 软件完全不联网,不上传任何服务器。
- 保险库是加密文件(AES-256-GCM + PBKDF2-HMAC-SHA256 60 万轮),可整文件夹拷贝或放 U 盘携带。