# 成大打卡小精靈使用手冊
###### tags: `王助中心`

[TOC]

## 0. 基本介紹
> Github專案位置：[DutyGremlinNCKU](https://github.com/Raistlinwolf/DutyGremlinNCKU)

給成大 (國立成功大學 / NCKU)教職員的自動打卡上下班小精靈，讓你每天不論是超級忙碌、偶爾偷懶耍廢，都不用擔心忘記打卡。

A simple python code to automatically check in & out for NCKU employees. Currently we don't have the english version manual. Concisely, you'll have to install python, selenium module, and webdriver in order to use this code.

## 1. 前置環境準備
### 1.1 下載最新版本Python
到 [Python官網](https://www.python.org/downloads/) 選擇對應作業系統的安裝檔，並直接執行即可。

### 1.2 安裝Selenium套件
1. 點擊左下角的【搜尋】，輸入"CMD"以打開「命令提示字元(Command Prompt)」
2. 輸入安裝selenium的指令`pip install selenium`
3. 看到出現`Successfully installed selenium`即可

### 1.3 安裝WebDriver
由於需要控制瀏覽器行為，所以我們要安裝相應的WebDriver以及版本。
現今常聽見的Brave、Opera、Edge、Chrome、Firefox幾乎都是基於Chromium的瀏覽器，直接在網址輸入`chrome://settings/help` 就可以看到版本資訊：

Edge：
Opera：

選擇一個想使用的瀏覽器，程式預設是 Microsoft Edge ，但也有用 Google Chrome 試過能正常使用。找到版本之後就可以下載對應版本的WebDriver：

| 序號 | 瀏覽器 | 下載點 |
| -------- | -------- | -------- |
| 1 | Edge | [Microsoft Edge WebDriver](https://developer.microsoft.com/zh-cn/microsoft-edge/tools/webdriver/) |
| 2 | Chrome | [Webdriver for Chrome](https://chromedriver.chromium.org/downloads)|

## 2. 主程式下載
請直接點擊左方連結，並按下載：[(public)DutyGremlinNCKU.py](https://github.com/Raistlinwolf/DutyGremlinNCKU/blob/main/(public)DutyGremlinNCKU.py "(public)DutyGremlinNCKU.py")

### 2.1 更改登入資訊
下載完成後須先輸入自己的登入資訊，請打開python程式，再從【file】處打開主程式。

此處duty開頭為上班的小時與分鐘、off開頭則為下班的小時與分鐘。分鐘會隨機在指定的區間內選擇，可以自行調整。

接下來就是登入資訊，將 YourUsername 與 YourPassword 改為你的職員編號與密碼，就完成所有設定。

### 2.2 更改瀏覽器為Chrome(如欲使用Edge請跳過這步)
程式第14行改為：`browser = webdriver.Chrome(ChromeDriverManager().install())`

### 2.3 使用說明
上班時直接滑鼠左鍵雙擊DutyGremlinNCKU程式，即會自動在指定時間打卡上下班。如果電腦不關機，就可以連續執行好幾天！

你可以週一上班打開，到週五再關掉，但程式不會每天重新隨機選一個下班時間，所以看起來會整個禮拜都同一個時間上下班XD。解決方式是有想到就把程式關掉重開，反正從任何時間開始執行都可以，但是人事室應該也不太看，所以不用太擔心(?

如果星期一睡太晚了，記得先打開程式把下班時間改晚一點，不然還是要補假單。

*註：使用者仍須自行確認打卡結果，如有任何爭議皆與DutyGremlin程式開發人員無涉*

## 3. 使用範例
會打開一個Edge跟一個Python執行視窗，兩個**都不要關掉！**

上班前每分鐘確認時間，可以藉此判斷程式仍在運作：

上班時間到，打卡成功：

上班期間每分鐘確認時間，可以藉此判斷程式仍在運作：

## 4. 故障排除
### 4.1 沒辦法使用pip
If you have pip installed but Windows cannot find it, you can try the following steps:

1. 以系統管理員身分打開「命令提示字元」

2. 輸入 `python --version` 並按下Enter，若是正常安裝應該會顯示目前安裝的版本。若是不能顯示可能表示系統找不到，或是python並未正確安裝

3. 輸入 `where pip` 並按下Enter，這條指令應該會顯示pip安裝的位置。若是不能顯示可能表示系統找不到，或是pip並未正確安裝

### 4.2 系統找不到python或pip路徑
1. 如果 Windows找不到正確安裝的python或pip路徑，你可以從搜尋欄輸入「環境變數」，會找到【編輯系統環境變數】
2. 在跳出的窗格中，按下【環境變數】按鈕
3. 從【系統變數】欄，往下滾找到一個名為「path」的變數，並按下【編輯】
4. 按下【新增】，並貼上你的Python安裝路徑，例如你將Python 3.10安裝在預設路徑，那就是 `C:\Python310\`
5. 在每個窗格中按下【確定】以關閉窗格。

將Python路徑加到你系統上的PATH變數後，你應該要可以從CMD或是PowerShell開啟Python，或是輸入 `python --version` 指令應該要有反應

### 4.3 平常正常開啟，今天卻出現一堆紅字
高機率是瀏覽器更新、web driver 過期了，請回到[【1.3 安裝WebDriver】](https://hackmd.io/cJ3DzpByS_iyWUlquWwPZg#13-%E5%AE%89%E8%A3%9DWebDriver)下載最新的 web driver 即可繼續使用。