# 密码管理扩展

**Repository Path**: legend0/Ipass

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ipass - Edge 浏览器密码管理扩展

一个安全易用的密码管理工具，支持 WebDAV 云端同步。

## 功能特性

- 🔐 **自动保存密码** - 检测登录表单并提示保存账号密码
- 🎯 **智能填充密码** - 访问登录页面时自动填充已保存的密码
- ☁️ **WebDAV 同步** - 支持手动/自动同步到 WebDAV 服务器
- 🔒 **本地加密存储** - AES-256-CBC 加密保护所有密码数据
- 🎨 **优秀用户体验** - 流畅无干扰的交互设计
- 📱 **密码管理界面** - 完整的密码增删改查功能
- 🔍 **快速搜索** - 支持按域名、用户名搜索密码
- 📋 **批量操作** - 支持批量删除和密码导入导出

## 安装方法

### 方法一：开发者模式加载（推荐用于开发测试）

1. 打开 Edge 浏览器，进入 `edge://extensions/`
2. 开启左上角的"开发人员模式"
3. 点击"加载解压缩的扩展"
4. 选择本项目的根目录（包含 manifest.json 的目录）
5. 扩展即安装完成

### 方法二：打包安装

1. 在 Edge 扩展管理页面点击"打包扩展"
2. 选择项目根目录生成 .crx 文件
3. 双击 .crx 文件安装

## 使用说明

### 首次使用

1. 安装扩展后，点击浏览器工具栏中的 Ipass 图标
2. 进入设置页面配置主密码（用于加密本地密码数据）
3. 如需云同步，配置 WebDAV 服务器信息

### 保存密码

- **自动保存**：当你在网页登录并提交表单时，扩展会自动检测并提示保存密码
- **手动保存**：右键点击页面，选择"保存此页面的密码"

### 填充密码

- **自动填充**：访问已保存密码的网站时，自动检测并填充登录表单
- **手动填充**：
  - 点击扩展图标，在列表中选择账号
  - 使用快捷键 `Ctrl+Shift+F` 快速填充
  - 右键点击输入框，选择"填充密码"

### WebDAV 同步配置

推荐使用以下 WebDAV 服务：

- **坚果云**：国内访问快，免费额度够用
- **Nextcloud**：自建私有云
- **ownCloud**：自建私有云
- **其他支持 WebDAV 的服务**

配置步骤：
1. 进入扩展设置 → WebDAV 同步
2. 填写 WebDAV 服务器地址、用户名、密码
3. 点击"测试连接"验证配置
4. 设置自动同步间隔（可选）

## 项目结构

```
Ipass/
├── manifest.json          # 扩展配置文件
├── background.js          # 后台服务脚本
├── content.js            # 内容脚本（注入网页）
├── lib/
│   ├── crypto.js         # 加密模块
│   ├── webdav.js         # WebDAV 同步模块
│   ├── storage.js        # 本地存储模块
│   └── utils.js          # 工具函数
├── popup/
│   ├── popup.html        # 扩展弹窗界面
│   ├── popup.css         # 弹窗样式
│   └── popup.js          # 弹窗逻辑
├── pages/
│   ├── options.html      # 设置页面
│   ├── options.css       # 设置页样式
│   └── options.js        # 设置页逻辑
└── icons/                # 扩展图标资源
```

## 技术栈

- **Manifest V3** - Edge 扩展最新标准
- **原生 JavaScript** - 零依赖，轻量高效
- **CryptoJS** - AES-256-CBC 加密
- **Chrome Storage API** - 本地数据存储
- **Fetch API** - WebDAV HTTP 请求

## 安全说明

1. **主密码**：所有密码数据通过主密码加密后存储，请务必牢记主密码
2. **本地加密**：采用 AES-256-CBC 加密算法，密钥通过 PBKDF2-SHA256 派生
3. **传输安全**：WebDAV 通信强制使用 HTTPS
4. **内存安全**：密钥仅缓存在内存中，关闭浏览器即清除
5. **最小权限**：仅申请必要的浏览器权限

## 开发指南

### 调试

1. 后台脚本：在扩展管理页面点击"service worker"查看控制台
2. 内容脚本：在网页开发者工具的控制台中查看（筛选 ipass）
3. Popup 和设置页面：像普通网页一样调试

### 构建图标

项目提供了 SVG 格式的图标源文件，可以使用以下工具转换为 PNG：

```bash
# 使用 ImageMagick
convert -background none -density 300 icons/icon.svg icons/icon16.png
convert -background none -density 300 icons/icon.svg icons/icon48.png
convert -background none -density 300 icons/icon.svg icons/icon128.png
```

或者使用在线转换工具：https://cloudconvert.com/svg-to-png

### 测试建议

- 在常见网站（Google、GitHub、淘宝等）测试密码保存和填充
- 测试不同结构的登录表单（单页应用、动态加载等）
- 测试 WebDAV 同步的各种场景（首次同步、冲突处理等）
- 测试导入导出功能的数据完整性

## 常见问题

### Q: 为什么有些网站无法自动填充密码？
A: 部分网站使用自定义表单组件或特殊的验证机制，可能导致识别困难。可以手动点击扩展图标选择账号填充。

### Q: WebDAV 同步失败怎么办？
A: 检查以下几点：
- 确认 WebDAV 服务器地址正确（包含 https://）
- 确认用户名密码正确
- 检查网络连接
- 查看浏览器控制台错误信息

### Q: 忘记了主密码怎么办？
A: 出于安全考虑，主密码无法找回。你可以：
1. 清除扩展数据重新设置主密码（会丢失已保存的密码）
2. 如果之前导出过备份，可以导入备份数据

### Q: 数据存储在本地还是云端？
A: 数据默认加密存储在本地，配置 WebDAV 后可以同步到云端。两者可以同时存在，扩展会自动处理同步。

## 隐私政策

- 本扩展不会收集任何用户数据
- 所有密码数据加密存储在本地
- WebDAV 同步由用户自行配置和控制
- 不包含任何第三方统计或追踪代码

## 更新日志

### v1.0.0 (2026-03-18)
- ✨ 初始版本发布
- ✅ 实现密码自动保存和填充
- ✅ 实现 WebDAV 同步功能
- ✅ 实现完整的密码管理界面
- ✅ 实现本地加密存储

## 开发计划

- [ ] 密码强度检测和安全报告
- [ ] 重复密码检测
- [ ] 密码生成器
- [ ] 泄露密码监控（Have I Been Pwned API）
- [ ] 安全笔记功能
- [ ] 生物识别支持（Windows Hello）

## 贡献指南

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT License

## 联系方式

如有问题或建议，请提交 Issue。

---

**Ipass** - Made with ❤️ for better password management.