Skip to content

Commit

Permalink
add(docs): add program how-to and FAQ (#6)
Browse files Browse the repository at this point in the history
* add(docs): add program how-to and FAQ

* fix(decs): 修改 README,添加 requirements.txt

Co-authored-by: Fatpandac <i@Fatpandac.com>
  • Loading branch information
RX-105 and Fatpandac authored Mar 26, 2022
1 parent 723bec4 commit 7df81f7
Show file tree
Hide file tree
Showing 2 changed files with 57 additions and 3 deletions.
37 changes: 34 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# fuck_cqooc [![sync -> gitee](https://github.com/Fatpandac/fuck_cqooc/actions/workflows/sync-to-gitee.yml/badge.svg?branch=master&event=push)](https://github.com/Fatpandac/fuck_cqooc/actions/workflows/sync-to-gitee.yml)

<details>
<summary>这是一个简单的 [cqooc](http://www.cqooc.com) 刷课工具。</summary>
<summary>这是一个简单的 cqooc(http://www.cqooc.com) 刷课工具。</summary>

> 🥁 We don't need no education
>
Expand All @@ -12,6 +12,37 @@
> 🎙️ Teacher, leave those kids alone
</details>
## [Sample](./sample.py)
## [Core 的样例](./sample.py)

Just run `python3 sample.py`, it will tell you how to use the core.
只需要运行 `python3 sample.py` 它将会告诉你 Core 的运行方式。

## 使用方法

1. 安装
- 源码
下载源码后运行`pip install -r requirements.txt` 或运行 Python 虚拟环境运行 `pipenv install`,之后再双击打开`fuck_cqooc.pyw`
- 二进制文件
对于 Windows 系统用户,你还可以选择使用exe文件,[在这下载](https://github.com/Fatpandac/fuck_cqooc/releases)
2. 启动程序
- 等待程序启动。进入登陆界面之后,输入你的重庆高校在线课程平台的用户名和密码,点击登录。
3. 选择课程
- 登录成功进入主界面之后,左侧列表中将会展示你的课程列表。选取其中一个课程,右侧列表中将会展示该课程的任务列表。
4. 开始运行程序
- 选取一个或多个任务并将其勾选。选择完成之后,点击右下方的"fuck"按钮,开始跳过选中的任务。完成之后,任务列表将会自动刷新。

## 常见问题

- 我的用户名和密码没错,但我不能登录?

这种情况可能的原因是,程序的登录请求被服务器拒绝。
这种情况下,你需要在浏览器中打开重庆高校在线课程平台,手动完成一次登录,然后回到程序中,再尝试重新登录。

- 跳过任务花费的时间特别长,这是为什么?

这是因为重庆高校在线课程平台服务器的管控策略。短时间跳过太多任务,你可能会遭到网站临时屏蔽。屏蔽不会持续太久,不到一分钟就会解除。
但为了保证所有任务都能成功跳过,程序设置跳过每个任务之间都会间隔一段时间,具体是30秒。

- 跳过的过程中按钮没有反应?

为了防止反复多次跳过任务,执行任务期间,程序会阻止按钮的点击,直到任务完成。
如果程序进入无响应状态,跳过任务仍然在进行,请不要尝试关闭程序。
23 changes: 23 additions & 0 deletions requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
attrs==21.4.0
certifi==2021.10.8
charset-normalizer==2.0.12
coverage==6.3.2
idna==3.3
iniconfig==1.1.1
Js2Py==0.71
packaging==21.3
Pillow==9.0.1
pluggy==1.0.0
py==1.11.0
pyjsparser==2.7.1
pyparsing==3.0.7
pytest==7.0.1
pytest-cov==3.0.0
pytz-deprecation-shim==0.1.0.post0
requests==2.27.1
six==1.16.0
tomli==2.0.1
ttkbootstrap==1.7.4
tzdata==2022.1
tzlocal==4.1
urllib3==1.26.9

0 comments on commit 7df81f7

Please sign in to comment.