# 更新说明 — crypto_key

本文档记录各版本功能变更与升级注意事项。

---

## v2.1.1（当前）

### 新增 / 调整

- **图片点击放大**：查询/添加预览支持灯箱全屏查看（Esc / 点击遮罩关闭）
- **一键部署改为 curl | bash**（与 crypto_monitor_user 同风格）:
  ```bash
  curl -fsSL https://git.bz121.com/dekun/crypto_key/raw/branch/main/deploy/manage.sh | bash
  ```
- 部署脚本迁至 `deploy/manage.sh`（支持管道自举、从 `/dev/tty` 读菜单）
- 文档仅保留 **Ubuntu** 说明，移除 Windows 相关内容

---

## v2.1.0

### 新增

- **钱包助记词 / 钱包密钥** 内置类型（链/网络、助记词或私钥、地址、备注）
- **图片上传**：字段类型 `image`，存储于 `uploads/`，查询时可预览
- **主界面 Tab**：添加凭证 / 查询凭证
- **查询类型筛选**：下拉框（含「全部类型」）
- **系统设置 Tab**：账户密码 / 自定义类型 / 备份恢复
- **前端备份恢复**：下载 `.tar.gz`、立即备份、上传恢复（含 `.env`、`data.json`、`settings.json`、`uploads`）
- **每日自动备份**：服务内线程（03:00）+ 部署脚本 cron，备份到 `/root/crypto_key_backups/`
- **交互式管理脚本**：
  1. 一键部署  
  2. 更新（**仅 `git pull`，严禁 scp**）  
  3. 一键卸载  

### 变更

- 自定义字段类型增加：`textarea`、`image`

### 升级注意

```bash
curl -fsSL https://git.bz121.com/dekun/crypto_key/raw/branch/main/deploy/manage.sh | bash
# 选择 2) 更新
```

---

## v2.0.0

### 新增

- **登录系统**：用户名 + 密码（单用户），凭据保存在 `.env`
- **数据加密**：`data.json` 使用 Fernet（AES）加密存储，密钥为 `DATA_ENCRYPTION_KEY`（`.env`）
- **凭证类型扩展**：
  - 交易所 API（Binance / OKX / Gate）
  - 网站账号（网址可点击）
  - 邮箱账户（mailto / 网页登录链接）
  - 企业微信机器人、钉钉机器人
  - 微信（微信号 + 手机号）、QQ（QQ 号 + 手机号）
- **自定义类型**：系统设置中自行添加字段（如小红书、抖音、快手）
- **系统设置页**：
  - 修改登录用户名/密码（写入 `.env`）
  - 管理自定义类型（增删、搜索）
- **查询机制**：添加后不自动展示；按类型 + 关键词 +「确认」后显示
- **类型搜索**：添加/查询时支持输入过滤类型
- **旧数据迁移**：明文 `data.json` 首次加载自动转为加密格式

### 变更

- 监听地址由 `127.0.0.1` 改为 **`0.0.0.0`**，支持局域网访问
- API 主路径由 `/api/accounts` 扩展为 `/api/credentials`（保留旧路径兼容）
- 数据模型由固定 `username/api_key/api_secret` 改为 `type_id + fields` 结构
- 依赖增加：`python-dotenv`、`cryptography`、`werkzeug`

### 安全

- 浏览器 **不** 使用 localStorage/sessionStorage 存储明文
- Session Cookie 设置 `HttpOnly`、`SameSite=Lax`
- `.env`、`data.json`、`settings.json` 默认加入 `.gitignore`

### 升级注意（从 v1.x 升级）

1. 备份现有 `data.json`
2. 安装新依赖并配置 `.env`
3. 启动服务，旧明文数据将自动迁移为加密格式
4. PM2：`pm2 restart api-key-manager`

> **重要**：升级后切勿删除或修改 `.env` 中的 `DATA_ENCRYPTION_KEY`，否则无法解密已有数据。

---

## v1.2.0

### 新增

- 交易所下拉：Binance / OKX / Gate
- OKX 专用 Passphrase 字段
- 按交易所查询（下拉 + 确认）
- 添加成功后默认不展示列表
- 敏感字段打码显示（复制仍为明文）

### 变更

- 支持局域网访问（`0.0.0.0:5200`）

---

## v1.1.0

### 新增

- PM2 守护进程支持（`ecosystem.config.cjs`）
- Ubuntu `/opt/crypto_key` 部署脚本与文档
- 启动脚本：`pm2-start.sh` / `pm2-stop.sh`

---

## v1.0.0

### 初始功能

- Flask 后端 + 单页前端（黑色主题）
- 多账户 API 密钥管理：`username`、`api_key`、`api_secret`
- 本地 `data.json` 明文存储
- 每条记录三个复制按钮
- 端口 5200，无登录

---

## 版本规划（待定）

- [ ] 可选 HTTPS / 反向代理说明模板
- [ ] 凭证编辑（当前仅支持添加、删除）
- [ ] 登录失败次数限制