# session_box

**Repository Path**: zxx95/session_box

## Basic Information

- **Project Name**: session_box
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-24
- **Last Updated**: 2025-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SessionBox - 多账户会话管理器

一个功能强大的 Chrome 扩展，支持在独立会话中管理多个账户，具备代理支持和指纹保护功能。

## 功能特性

### 🔐 会话管理

- 创建无限个隔离会话
- 每个会话维护独立的 cookies、localStorage 和 sessionStorage
- 彩色编码的会话标识
- 带有可视化指示器的简易会话切换

### 🌐 代理支持

- 支持 HTTP、HTTPS、SOCKS4 和 SOCKS5 代理
- 每会话代理配置
- 代理身份验证支持
- 内置代理连接测试

### 🛡️ 指纹保护

- 带噪声注入的 Canvas 指纹保护
- WebGL 指纹修改
- 音频上下文指纹保护
- WebRTC IP 泄露防护
- 自定义用户代理支持

### 📊 高级功能

- 会话导入/导出功能
- 自动备份和恢复
- 会话超时管理
- 故障排除调试模式
- 会话事件通知系统

## 安装

### 从 Chrome 网上应用店安装

1. 访问 Chrome 网上应用店（链接即将推出）
2. 点击"添加至 Chrome"
3. 确认安装

### 手动安装（开发者模式）

1. 下载或克隆此仓库
2. 打开 Chrome 并导航到 `chrome://extensions/`
3. 在右上角启用"开发者模式"
4. 点击"加载已解压的扩展程序"并选择项目文件夹
5. SessionBox 图标应出现在您的扩展工具栏中

## 使用方法

### 创建您的第一个会话

1. 点击工具栏中的 SessionBox 图标
2. 点击"新建会话"
3. 配置您的会话：
   - 输入会话名称
   - 选择颜色以便识别
   - 如需要可启用指纹保护
   - 配置代理设置（可选）
4. 点击"创建会话"

### 管理会话

- **切换会话**：点击 SessionBox 图标并选择不同的会话
- **编辑会话**：转到设置 > 会话标签页修改现有会话
- **删除会话**：使用会话列表中的删除按钮（这将关闭该会话中的所有标签页）

### 代理配置

1. 转到设置 > 代理标签页
2. 点击"添加代理"创建新的代理配置
3. 输入代理详细信息：
   - 配置名称
   - 代理类型（HTTP/HTTPS/SOCKS4/SOCKS5）
   - 主机和端口
   - 用户名和密码（如需要）
4. 保存前测试连接
5. 将代理分配给特定会话

### 指纹保护

在设置 > 指纹保护标签页配置指纹保护：

- **Canvas 保护**：为 Canvas 渲染添加噪声
- **WebGL 保护**：修改 GPU 指纹参数
- **音频保护**：为音频上下文添加噪声
- **WebRTC 阻止**：防止 IP 地址泄露

## 技术架构

### 核心组件

- **后台服务**：管理会话、代理和指纹保护
- **内容脚本**：处理页面级会话隔离
- **弹窗界面**：快速会话管理和切换
- **选项页面**：高级配置和设置

### 会话隔离

会话隔离使用：

- 每会话独立的 cookie 容器
- 独立的 localStorage/sessionStorage 空间
- 隔离的 IndexedDB 和 WebSQL 数据库
- 每会话代理配置

### 数据存储

- 会话数据存储在 Chrome 的本地存储中
- 加密的代理凭据
- 会话删除时自动数据清理

## 配置

### 默认设置

扩展带有合理的默认设置：

- 启用基础指纹保护
- 启用会话指示器
- 启用自动会话切换
- 最大 10 个会话（可配置）

### 高级配置

通过选项页面访问高级设置：

- 会话超时配置
- 故障排除调试模式
- 自动备份设置
- 数据管理选项

## API 参考

### 后台消息

扩展支持以下后台消息：

```javascript
// 创建新会话
chrome.runtime.sendMessage({
  action: "createSession",
  config: {
    name: "我的会话",
    color: "#4285f4",
    proxy: {
      /* 代理配置 */
    },
    fingerprintProtection: true,
  },
});

// 切换到会话
chrome.runtime.sendMessage({
  action: "switchSession",
  sessionId: "session-id",
});

// 获取所有会话
chrome.runtime.sendMessage({
  action: "getSessions",
});
```

## 开发

### 项目结构

```
session_box/
├── manifest.json          # 扩展清单
├── background/            # 后台脚本
│   ├── background.js
│   └── session-manager.js
├── content/              # 内容脚本
│   └── content.js
├── popup/               # 弹窗界面
│   ├── popup.html
│   ├── popup.css
│   └── popup.js
├── options/             # 选项页面
│   ├── options.html
│   ├── options.css
│   └── options.js
├── utils/               # 实用工具模块
│   ├── storage.js
│   ├── proxy.js
│   └── fingerprint.js
└── assets/              # 静态资源
    └── icons/
```

### 构建和测试

1. 在开发者模式下加载扩展
2. 测试核心功能：
   - 会话创建和切换
   - 代理配置
   - 指纹保护
   - 数据持久化

### 贡献

欢迎贡献！请阅读我们的贡献指南：

1. Fork 仓库
2. 创建功能分支
3. 提交您的更改
4. 推送到分支
5. 创建 Pull Request

## 故障排除

### 常见问题

**Q: 会话没有正确隔离**
A: 确保扩展有所有必要的权限，并尝试重新加载页面。

**Q: 代理连接失败**
A: 验证代理设置并测试连接。检查防火墙设置。

**Q: 指纹保护不工作**
A: 确保在会话设置中启用了指纹保护。

### 调试模式

启用调试模式以获取详细日志：

1. 转到设置 > 高级
2. 启用"调试模式"
3. 打开开发者工具查看控制台日志

## 隐私和安全

- 所有数据本地存储，不发送到外部服务器
- 代理凭据使用 Chrome 的安全存储加密
- 指纹保护使用随机化技术防止跟踪
- 会话数据在删除时完全清除

## 许可证

本项目采用 MIT 许可证 - 详情请见 [LICENSE](LICENSE) 文件。

## 支持

如需支持，请：

1. 查看常见问题解答
2. 搜索现有的 GitHub issues
3. 创建新的 issue 并提供详细信息

## 更新日志

### v1.0.0

- 初始发布
- 基础会话管理
- 代理支持
- 指纹保护
- 导入/导出功能

---

**免责声明**：此扩展仅用于合法目的。用户有责任确保遵守所有适用的法律法规。