@spoonly/otpm

OTPm

OTPm 是一款轻量、高效的命令行两步验证密码器，专注于 TOTP 动态口令的生成与管理。无需图形界面，即可快速安全地生成一次性密码，为各类平台账号提供二次身份验证保护。

支持密钥导入、多账户管理、自动刷新令牌与本地加密存储，兼顾安全与便捷，适合开发者、运维人员与注重隐私的用户在终端环境下快速使用两步验证能力。

Installation

npm install -g @spoonly/otpm
# or
pnpm add -g @spoonly/otpm

Commands

Account Management

Command	Alias	Description
otpm add	a	添加账户（手动输入 或 otpauth:// URI）
otpm delete [account]	del	删除账户
otpm rename [account]	mv	重命名账户
otpm info [account]	i	查看账户详细配置

OTP Generation

Command	Alias	Description
otpm list	ls	列出所有账户及当前 OTP 码
otpm generate [account]	g	生成指定账户的 OTP

Backup & Restore

Command	Alias	Description
otpm export [file]	—	导出账户备份（明文或加密）
otpm import [file]	—	从备份文件导入账户

Usage

添加账户

otpm add

支持两种方式：

• 手动输入：依次填写账户名、issuer（平台名）和 secret，其余参数自动使用主流默认值
• otpauth:// URI：直接粘贴扫码后的 URI 一键导入

生成 OTP

# 交互式选择账户
otpm generate

# 直接指定账户
otpm generate "GitHub:[e-mail]"

# 生成并复制到剪贴板
otpm generate --copy

# 自动刷新（每个周期更新）
otpm generate --watch

列出所有账户

# 一次性列出
otpm list

# 持续刷新所有 TOTP 码
otpm list --watch

备份与恢复

# 导出（可选加密）
otpm export
otpm export my-backup.json

# 导入（自动识别加密备份）
otpm import
otpm import my-backup.json

Security

• 本地存储文件基于机器信息派生密钥，使用 AES 加密，secret 不会明文落盘
• 加密导出使用 AES-256-CBC + scrypt 密钥派生，需要用户设置独立密码
• 导出的明文备份文件请妥善保管

Release

首次发布需手动执行 pnpm publish 在 npm 创建包，然后前往 https://www.npmjs.com/package/otpm/access 配置 GitHub Trusted Publisher。

后续发布执行 pnpm run release，GitHub Actions 会自动完成发布流程。

License

MIT License © OSpoon