🔐 Keyring — AI 时代密钥管理

你存一次，AI 永远看不到明文。

⚡ 30 秒上手

# 安装
pip install keyring-cli

# 初始化
kyi

# 存账户密码
kya set github [email protected] mypassword

# 存平台密钥
kyk set github ghp_xxxxxxxxxxxx

# AI 用
kyr --env GITHUB_TOKEN=ghp_xxxxxxxxxxxx -- git push

快捷别名： ky=keyring kyp=platform kya=account kyk=key kyi=init kyr=run

🎯 为什么需要 Keyring？

痛点

你: 帮我推代码到 GitHub
AI: 好的，我看到你的 token 是 ghp_abc123...（已泄露）

解决

你: 帮我推代码到 GitHub  
AI: keyring run --env GITHUB_TOKEN=github_token -- git push
    （只看到别名，看不到明文）

🔥 核心亮点

📖 使用指南

账户管理

# 保存账户（用户名+密码）
kya set github [email protected] mypassword123
kya set github [email protected] adminpass456

# 读取密码
kya get github [email protected]

# 列出平台下所有账户
kya list github

# 删除账户
kya delete github [email protected]

密钥管理

# 保存平台密钥（API Key、Token 等）
kyk set github ghp_xxxxxxxxxxxx
kyk set openai sk-xxxxxxxxxxxx

# 读取密钥
kyk get github ghp_xxxxxxxxxxxx

# 列出平台下所有密钥
kyk list github

# 删除密钥
kyk delete github ghp_xxxxxxxxxxxx

平台查询

# 列出所有平台及摘要
kyp

# 查看指定平台详情
kyp github

AI 集成

# 推代码
kyr --env GITHUB_TOKEN=ghp_xxxxxxxxxxxx -- git push

# 调 API
kyr --env OPENAI_API_KEY=sk-xxxxxxxxxxxx -- python app.py

# 多个密钥
kyr --env TOKEN1=secret1 --env TOKEN2=secret2 -- python script.py

别名系统

# 创建别名（AI 只认识这个）
ky alias set github_token secret://github/ghp_xxxxxxxxxxxx

# 用别名注入
kyr --env GITHUB_TOKEN=github_token -- git push

从 .env 迁移

# 预览（不实际导入）
ky import --file .env --dry-run

# 导入全部
ky import --file .env

# 只导入 GitHub 相关
ky import --file .env --prefix GITHUB_

📁 安全架构

~/.keyring/
├── master.key       # AES-256 密钥（chmod 600）
└── secrets.json     # 加密后的账户/密钥（AES-256-GCM）

存储结构

{
  "github": {
    "accounts": {
      "user@gmail": "encrypted_password_1",
      "admin@gmail": "encrypted_password_2"
    },
    "keys": {
      "ghp_xxx": "encrypted_key_1",
      "ghp_yyy": "encrypted_key_2"
    }
  }
}

• 加密算法: AES-256-GCM（认证加密）
• 密钥派生: SHA-256
• 存储: 纯本地，零网络
• 权限: master.key 仅所有者可读

📋 命令速查

🤖 兼容平台

LLM 大模型

开发平台

🏆 对比

🤝 贡献

欢迎贡献！请查看 CONTRIBUTING.md。

# 开发环境
git clone https://github.com/webkubor/keyring.git
cd keyring
pip install -e .
pip install pytest
pytest

📄 许可证

MIT License