KeyPass Float

About

## Brief description

Generate secure passwords in a draggable floating panel on any webpage. Passwords stay in memory and never leave your browser.

## detailed description
KeyPass Float is a lightweight password generator that opens as a draggable floating panel on the current webpage.

Features:
- Generate one or many secure passwords locally
- Automatically refresh while the panel is active, with a play/pause control
- Use Generate, Undo, Copy all and Clear actions with clear icon tooltips
- Choose length, quantity, lowercase, uppercase, digits and symbols
- Exclude custom or visually confusing characters
- Click a password to copy it; double-click or use the edit button to adjust it
- Remember generator preferences and the floating-panel position locally
- Keep generated passwords and Undo history in memory only

Privacy-first by design: passwords are generated entirely inside your browser. No account, no server request, no password upload, and no persistent password storage.

## 详细说明（中文）
KeyPass Float 是一个轻量级悬浮密码生成器。点击 Chrome 工具栏的小钥匙图标，即可在当前网页打开可拖动的密码生成面板。

功能：
- 本地一次生成一条或多条高强度密码
- 支持自动刷新与播放 / 暂停控制；后台标签不会持续刷新
- 图标化 Generate、Undo、Copy all 和 Clear 操作，悬停可查看提示
- 自定义长度、数量、小写字母、大写字母、数字、符号及排除字符
- 单击密码即可复制；双击或点击编辑按钮可修改
- 自动记住生成配置和悬浮窗位置
- 密码结果与 Undo 历史仅保留在当前面板内存中，不写入本地存储

隐私设计：所有密码均在浏览器本地生成，不会发送到服务器，不会持久保存密码。

## 当前功能

- 点击 Chrome 工具栏里的透明金色钥匙图标，在当前网页打开可拖动的悬浮密码生成器。
- 点击钥匙图标打开面板时，会立即生成一组密码，并自动开始刷新；再次点击图标会隐藏面板并停止自动刷新。
- 自动播放仅在当前标签页前台、面板显示、且用户没有进入编辑状态时运行。切换标签、隐藏或关闭面板时会立刻停止，不会在后台持续使用 CPU。
- 操作区从左到右：
  - `❚❚ / ▶`：播放或暂停自动生成
  - `↻`：立即生成一组新密码，并暂停自动生成
  - `↶`：恢复上一组生成结果，并暂停自动生成
  - `⧉`：复制全部密码，并暂停自动生成
  - `🗑`：清空全部当前密码和 Undo 历史，并暂停自动生成
- 单击任意一条密码会自动复制，同时暂停自动生成；双击或点击 `✎` 可编辑。
- 长度、数量、字符集、排除字符和悬浮窗位置会保存到浏览器本地。
- **生成的密码和 Undo 历史不会写入浏览器存储。** 它们仅存在于当前悬浮窗的内存中；关闭面板、刷新页面或重新加载扩展后即消失。
- 所有生成逻辑都在本地运行，不联网、不上传、不收集密码内容。

## 安全设计

- 随机密码使用浏览器的 `crypto.getRandomValues()` 生成，而不是 `Math.random()`。
- 生成结果位于关闭式 Shadow DOM 中，普通网页脚本不能通过 `shadowRoot` 直接读取面板内容。
- 密码不写入 `chrome.storage.local`；仅保存非敏感偏好与面板位置。
- Clear 会清空当前显示内容、内存中的 Undo 历史，并删除旧版本可能留下的本地密码结果。
- 复制到系统剪贴板后，剪贴板属于系统全局内容。Clear 不会自动清空剪贴板，以免误删用户后来复制的其他内容。