# 密码管理扩展

**Repository Path**: legend0/Ipass

## Basic Information

- **Project Name**: 密码管理扩展
- **Description**: Ipass - Edge 浏览器密码管理扩展 - 一个安全易用的密码管理工具，支持 WebDAV 云端同步。
- **Primary Language**: JavaScript
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# iPass 密码管理器

> 基于 Chrome MV3 的本地优先（local-first）密码管理浏览器扩展。所有敏感数据通过 AES-256-GCM 加密存储于本地 IndexedDB，支持表单自动填充、密码泄露检测、AI 智能助手与加密备份同步。

[![Gitee Stars](https://gitee.com/legend0/Ipass/badge/star.svg?theme=dark)](https://gitee.com/legend0/Ipass)

## 特性

- **本地加密存储**：AES-256-GCM + PBKDF2（600,000 轮 SHA-256 派生），CryptoKey 以 non-extractable 形式持久化于 IndexedDB
- **表单自动填充**：智能识别登录表单，加权属性评分匹配最优条目，支持手动下拉与自动填充
- **提交捕获**：检测用户登录提交，主动询问是否保存或更新凭据（密码相同时不重复打扰）
- **密码泄露检测**：基于 HIBP k-anonymity 协议，仅上传 SHA-1 前缀（5 位），后缀哈希本地比对
- **AI 智能助手**：OpenAI 兼容接口，支持自然语言查找条目、智能修正标题/分类（账号脱敏 + 密码哈希截断后送 AI）
- **加密备份同步**：WebDAV / Gitee Gist 双通道，本地加密后再上传，支持合并 / 覆盖两种策略
- **三级安全等级**：low / medium / high，适配不同场景的锁定策略
- **凭据恢复**：8 组 hex 恢复密钥，校验身份后重置主密码（不泄露旧 vault）

## 为什么开发？

说来也简单——被某国外密码管理工具折磨够了。隔三差五连不上、动不动要验证、还把你密码存在人家服务器上。密码这么私密的东西，放别人口袋里总觉得不踏实。干脆自己撸一个：数据本地加密，WebDAV 自建同步，钥匙全在自己手里。顺便接入 AI，懒得翻列表的时候直接问一句，主打一个能偷懒绝不手写。

## CRX文件安装步骤

以Chrome和Edge浏览器为例，安装步骤基本相同：

### 1. 打开扩展管理页面
- **Chrome**：地址栏输入 `chrome://extensions/` 并回车
- **Edge**：地址栏输入 `edge://extensions/` 并回车

### 2. 开启开发者模式
- **Chrome**：打开页面右上角的**“开发者模式”**开关
- **Edge**：打开左下角的**“开发人员模式”**开关

### 3. 拖拽安装
将下载好的 `.crx` 文件直接拖拽到扩展管理页面中，松开鼠标。浏览器会弹出确认对话框，点击 **“添加扩展”**（或“添加扩展程序”）即可完成安装。

---

## 常见问题

### 提示“无法从该网站添加扩展程序”
这是浏览器对第三方来源安装的限制，忽略提示即可，按上述拖拽方法依然可以安装。

### 拖拽安装失败
可以尝试将 `.crx` 文件后缀改为 `.zip`，解压后，在扩展管理页面点击 **“加载已解压的扩展程序”**，选择解压出来的文件夹完成安装。

### 其他浏览器
大多数基于Chromium内核的浏览器（如360浏览器、华为浏览器等）操作方法类似：打开扩展程序页面 → 开启开发者模式 → 拖拽CRX文件安装。

## 截图

<img src="./.imgs/Popup.png" alt="iPass Popup 弹窗" width="320" />

<img src="./.imgs/首页.png" alt="iPass 快捷面板" width="320" />

<img src="./.imgs/列表.png" alt="iPass 密码库管理" width="720" />

<img src="./.imgs/设置.png" alt="iPass 设置页面" width="720" />

## 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+Shift+P` | 打开 iPass 快捷面板 |
| `Ctrl+Shift+L` | 自动填充当前站点 |
| `Ctrl+Shift+G` | 打开密码库管理页 |

## 技术栈

React 18 + TypeScript + Vite 7、Tailwind CSS 3 + Radix UI、Biome 代码质量、Web Crypto API 加密、IndexedDB 持久化

## 本地开发

```bash
# 安装依赖
pnpm install

# 构建扩展
pnpm run build

# 类型检查与 lint
pnpm run lint
```

构建产物输出到 `dist/`，在 `chrome://extensions/` 开启「开发者模式」后加载该目录即可。

## 许可

MIT License

Copyright (c) 2025 iPass Password Manager