99 lines
1.8 KiB
Markdown
99 lines
1.8 KiB
Markdown
|
# 🧰 luogu-cli – 洛谷命令行工具
|
|||
|
|
|
|||
|
|
一个用 Python 编写的命令行工具，用于从 [洛谷（Luogu）](https://www.luogu.com.cn) 下载题目描述、样例输入输出、题解等内容，方便本地学习与练习。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📦 功能特性
|
|||
|
|
|
|||
|
|
- ✅ `lgcli parse PID`：下载指定题目的题面、样例和题解
|
|||
|
|
- ✅ `lgcli view PID`：在终端中查看题目描述（支持 Markdown 渲染）
|
|||
|
|
- ✅ `lgcli solution PID`：列出所有题解或查看某一篇详细内容
|
|||
|
|
- ✅ 使用 `rich` 渲染终端 Markdown，支持彩色样式
|
|||
|
|
- ✅ 支持打包为单文件 `.exe`（通过 PyInstaller）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🧩 依赖库
|
|||
|
|
|
|||
|
|
确保你已安装以下 Python 包：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install rich requests beautifulsoup4 python-dotenv
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ⚙️ 配置 Cookie
|
|||
|
|
|
|||
|
|
你需要先登录洛谷官网，并获取以下 Cookie 值填入 `.env` 文件中：
|
|||
|
|
|
|||
|
|
```env
|
|||
|
|
CLIENT_ID=你的client_id
|
|||
|
|
UID=你的uid
|
|||
|
|
CF_CLEARANCE=你的cf_clearance
|
|||
|
|
C3VK=你的c3vk
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> 注意：这些值可以在浏览器开发者工具的“Application > Cookies”中找到。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚀 使用方式
|
|||
|
|
|
|||
|
|
### 1. 下载题目信息
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python main.py parse P1145
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这会创建一个以题目编号命名的目录（如 `P1145/`），包含：
|
|||
|
|
- `P1145.md`：题面描述
|
|||
|
|
- `samples/`：样例输入输出
|
|||
|
|
- `solutions/`：题解 Markdown 文件
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2. 查看题目描述
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python main.py view P1145
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
使用 `rich` 在终端中渲染 Markdown 格式的题目内容。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3. 查看题解列表或具体内容
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python main.py solution P1145
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
列出所有题解标题：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
可用题解：
|
|||
|
|
1. 题解1_xxxxx
|
|||
|
|
2. 题解2_yyyyyy
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
查看具体题解内容：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python main.py solution P1145 --id 题解1_xxxxx
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚗 下一步发展
|
|||
|
|
|
|||
|
|
- 📝 提交代码
|
|||
|
|
- 🚩参加比赛
|
|||
|
|
- ...
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📜 许可证
|
|||
|
|
|
|||
|
|
本项目采用 LGPL License。
|