# 115 Cookie自动获取工具

**Repository Path**: deepin20/115_cookie_tool

## Basic Information

- **Project Name**: 115 Cookie自动获取工具
- **Description**: 115 Cookie 自动获取工具:一款专为 Deepin/UOS 设计的图形化工具，用于自动获取 115.com 的 Cookie，并支持多账号加密管理、自动续期、Web API 等功能。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 115 Cookie 自动获取工具

一款专为 Deepin/UOS 设计的图形化工具，用于自动获取 115.com 的 Cookie，并支持多账号加密管理、自动续期、Web API 等功能。

---

## 📌 功能特性

- **一键获取 Cookie**：打开浏览器，扫码或验证码登录后自动保存 Cookie。
- **多账号加密存储**：支持添加多个 115 账号，Cookie 使用 AES-256 加密保存，需主密码解密。
- **自动检测与续期**：定时检测 Cookie 有效性，失效时自动通知并支持一键重新获取（CLI 支持无人值守续期）。
- **命令行模式（CLI）**：支持 `--get`、`--test`、`--auto-renew` 等参数，便于集成到自动化脚本。
- **Web 管理界面**（可选）：基于 Flask 提供轻量级 Web 服务，远程查看 Cookie 状态和触发续期。
- **系统托盘**：最小化到托盘，后台运行，支持显示主窗口和退出。
- **国际化（i18n）**：支持中文/英文界面，根据系统语言自动切换。
- **代理支持**：可配置 HTTP/HTTPS/SOCKS5 代理，适应不同网络环境。
- **多浏览器支持**：支持 Chromium、Firefox、WebKit、Chrome（可切换）。
- **导出格式**：支持导出为 Netscape 格式（cookies.txt），兼容 curl/wget。
- **批量导入导出**：账号数据可打包为 ZIP 文件（支持密码加密）。

---

## 🚀 快速开始

### 1. 安装依赖
```bash
# 进入项目目录
cd 115_cookie_tool

# 创建并激活虚拟环境（推荐）
python3 -m venv venv
source venv/bin/activate

# 安装 Python 依赖
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 下载 Playwright 浏览器
playwright install chromium
```

### 2. 运行 GUI
```bash
python run.py
```

### 3. 命令行使用
```bash
# 获取 Cookie（交互登录）
python -m src.cli --get

# 获取并保存到加密账号
python -m src.cli --get --account myaccount

# 测试 Cookie 有效性
python -m src.cli --test

# 自动续期（每 3600 秒检测一次）
python -m src.cli --auto-renew 3600
```

### 4. 生成 .deb 安装包
```bash
python create_deb.py
sudo dpkg -i 115-cookie-tool_2.0.0_amd64.deb
```

---

## 📁 项目结构

```
115_cookie_tool/
├── config/                # 配置文件
├── data/                  # Cookie 数据存储
├── locale/                # 国际化语言文件
├── scripts/               # 辅助脚本
├── src/
│   ├── core/              # 核心辅助函数和 worker
│   ├── gui/               # GUI 主窗口和对话框
│   ├── platforms/         # 多平台支持（扩展）
│   ├── account_manager.py # 账号管理
│   ├── browser_launcher.py # 浏览器启动与测试
│   ├── cli.py             # 命令行入口
│   ├── config_manager.py  # 配置管理
│   ├── cookie_manager.py  # Cookie 操作
│   ├── encryption.py      # AES 加密
│   ├── keyring_manager.py # 系统密钥环
│   ├── notifier.py        # 通知模块
│   └── ...
├── create_deb.py          # deb 打包脚本
├── run.py                 # GUI 启动入口
├── run_api.py             # API 服务入口
├── run_web.py             # Web 管理入口
├── requirements.txt       # 依赖列表
└── README.md              # 本文件
```

---

## 🔧 配置说明

配置文件位于 `~/.config/115-cookie-tool/config.json`，包含以下主要字段：

```json
{
  "cookie_file_path": "data/115_cookies.json",
  "default_account": null,
  "browser_channel": "chromium",
  "proxy": null,
  "platform": "115",
  "api_token": "your-secret-token",
  "notification": {
    "method": "none",
    "smtp_server": "",
    "smtp_port": 465,
    "sender": "",
    "password": "",
    "receiver": "",
    "webhook": ""
  }
}
```

---

## 🛠️ 开发与贡献

欢迎提交 Issue 和 Pull Request。建议使用虚拟环境进行开发。

### 打包 .deb
```bash
python create_deb.py
```

### 运行测试
```bash
pytest tests/   # 若已编写测试
```

---

## 📄 许可证

本项目基于 **MIT 许可证** 开源。

---

## 👤 作者

**温暖断章（1802272181@qq.com）**

---

## ⚠️ 免责声明

本工具仅供学习和个人使用，请勿用于非法用途。使用本工具产生的任何后果由使用者自行承担。