Setting up zh TW
如果您是第一次來到這裡，歡迎！ 我們很高興又看到一位對我們的專案感興趣的旅客，但請記住：能力越強，責任越大──只要您足夠認真學習如何使用它，ASF 就能完成相當多的 Steam 相關事務。 學習的過程將充滿艱辛與坎坷，我們希望您閱讀與之相關的 Wiki，並詳細了解這一切是如何運作的。
如果您還在這裡，那就代表您堅持看完了上面的文字，做得不錯。 除非您跳過了它，那樣的話，您很快就會經歷一段**不好的時光**…… 總的來說，ASF 是一個控制台應用程式，這代表程式本身沒有您習慣的圖型介面。 ASF 主要是設計執行於伺服器中，所以它更偏向為一個服務（常駐程式），而非桌面應用程式。
然而，這並不代表您無法在電腦上使用 ASF，或是使用起來會比一般的程式更為複雜。 ASF 是一個獨立的免安裝應用程式，可以直接使用，但在此之前，需要先進行組態設定。 設定檔會告訴 ASF 啟動之後應該做什麼。 若您在沒有設定檔的情況下啟動它，那麼，ASF 將不會做任何事情，就是如此簡單。
一般來說，這是我們在接下來的幾分鐘內要做的事情：
- 安裝必要的 [.NET 需求套件](#.NET 需求套件)。
- 在 **ASF 發布頁面**下載適用於您的作業系統的版本變體。
- 將壓縮檔解壓縮至一個新資料夾中。
- 設定 ASF。
- 執行 ASF，並見證奇蹟！
聽起來十分簡單，對吧？ 那就讓我們繼續吧。
首要步驟，是確保您的作業系統可以正確地啟動 ASF。 ASF 是用 C# 語言編寫的，基於 .NET 平台，並可能需要您平台上尚未擁有的原生函式庫。 取決您使用的是 Windows、Linux 還是 macOS，您將有不同的系統需求。所有要求都列在您應遵循的 **[.NET 需求套件](#.NET 需求套件)**文件中。 這是我們應當使用的參考資料，但為了簡單起見，我們在下面額外列出需要的所有軟體套件。因此您無需閱讀完整的文件。
若您已安裝並使用其他第三方軟體，一些（甚至全部）相依性套件已存在於您的作業系統上，是很正常的。 不過，您仍應在作業系統上執行合適的安裝程式，來確保這些軟體確實已被安裝──缺少這些相依套件，ASF 將完全無法啟動。
請注意，您不需要特地為作業系統的建置版本做其他任何事情，特別是 .NET SDK 的安裝或執行環境，因為它們已包含於作業系統套件中。 您只需要安裝必要的 .NET 相依需求套件，即可執行 ASF 裡面自帶的 .NET 執行環境。
- Microsoft Visual C++ 可轉散發套件更新（x64 適用於 64 位元 Windows；x86 適用於 32 位元 Windows）
- 強烈建議您，務必確保已安裝所有的 Windows 更新。 您最少需要安裝 KB2533623、KB2999226，但仍可能需要更多的更新。 如果您的 Windows 已更新至最新版，則上述更新補丁都已安裝。 在安裝 Visual C++ 套件前，請確保滿足上述需求。
- 若您使用 Windows 7，您必須使用 Generic 變體版本，因為套件不再支援您的作業系統。 我們強烈建議您盡快進行更新您的作業系統，因為 ASF 的未來版本可能會完全無法在上面使用，而且說實話，Windows 7 在 2020 年就已經結束了生命週期。
套件名稱取決於您使用的 Linux 發行版本，我們列出了最常見的套件名稱。 您可以使用本機中的套件管理系統，為您的作業系統取得全部套件（例如適用於 Debian 的 apt 或適用於 CentOS 的 yum）。
-
ca-certificates（用於建立 HTTPS 連線的標準可信賴的 SSL 憑證） -
libc6（libc） -
libgcc1（libgcc） -
libicu（icu-libs，您的發行版本的最新版，例如libicu67） -
libgssapi-krb5-2（libkrb5-3、krb5-libs） -
libssl1.1（libssl、openssl-libs，您的發行版本的最新版，且至少為1.1.X版本，因為1.0.X版本可能無法運作） -
libstdc++6（libstdc++，5.0版本或更高） -
zlib1g（zlib）
上述大多數套件應早已安裝於您的系統中。 Debian 穩定版的最小安裝也只需再安裝 libicu67 即可。
- 暫時沒有需求，但您仍應安裝最新版本的 macOS，至少為 10.15+ 版本
既然我們有了所有的相依性套件，那麼接下來就是下載 ASF 最新版本。 ASF 有許多變體版本可供使用，但您應使用符合您作業系統及其架構的版本套件。 舉例來說，假設您使用 64 位元 Windows，那麼您需使用 ASF-win-x64 版本的套件。 欲取得關於可用變體的更多資訊，請參閱**相容性章節。 ASF 也可以執行於沒有提供建置版本的作業系統上，例如 32 位元 Windows，請前往安裝通用版本套件**繼續閱讀。
下載完成後，請先解壓縮 .zip 檔至一個資料夾中。 我們建議使用 7-zip，但所有標準工具（例如 Linux/macOS 中的 unzip 工具）應該也可以正常運作。
並建議將 ASF 解壓縮至獨立資料夾中，而不是包含其他檔案的資料夾中：ASF 的自動更新功能，會在升級時刪除所有舊的或無關的檔案，並可能導致您遺失儲存於 ASF 資料夾中的其餘檔案。 若您有任何額外用於 ASF 的腳本或檔案，請將它們存放於 ASF 的上層資料夾。
一個檔案結構範例，看起來會像是這樣：
C:\ASF（可存放您自己的東西）
├── ASF shortcut.lnk（選擇性）
├── Config shortcut.lnk（選擇性）
├── Commands.txt（選擇性）
├── MyExtraScript.bat（選擇性）
├── (...)（其餘您想存放的檔案，選擇性）
└── Core（ASF 專用資料夾，也就是您解壓縮壓縮檔的地方）
├── ArchiSteamFarm(.exe)
├── config
├── logs
├── plugins
└── (...)
現在只剩最後一步：組態設定。 這是迄今為止最複雜的步驟，因為它包含了許多您還不熟悉的新資訊，所以我們在此會嘗試提供一些讓您便於理解的範例及簡明扼要的解釋。
首先，組態設定頁面解釋了與設定檔相關的一切事物，但它包含了數量龐大的新資訊，其中有很大一部分是我們不需要立即瞭解的。 但我們會教您如何取得您真正需要查找的資訊。
您可以透過至少三種方式來設定 ASF：線上設定檔生成器、ASF-ui 或是手動設定。 這在**組態設定**章節中有深入的解釋，若您想要取得更多詳細資訊，請參閱此部分。 我們先以線上設定檔生成器為例。
使用您常用的瀏覽器造訪我們的**設定檔生成器**網頁工具，若您手動停用了 JavaScript，您需要啟用它。 我們建議使用 Chrome 或 Firefox，但它應能在大部分的主流瀏覽器上運作。
開啟頁面後，切換到「Bot」分頁。 您應該會看見類似於下圖的頁面：
如果您剛剛下載的 ASF 版本低於設定檔生成器的預設值，只需在下拉式選單中選擇您的 ASF 版本。 這種情況會在設定檔生成器用於尚未標示為穩定版的更新版本（預覽版）ASF 時發生。 您下載的最新穩定版本的 ASF，是證實能穩定運作的版本。
首先將您的 Bot 名稱輸入至紅色醒目的欄位中。 您可以使用任何名稱，例如您的暱稱、帳號名稱、一串數字或是任何其他文字。 其中只有一個您無法使用的名稱，ASF，因為這個關鍵字是為全域設定檔保留的。 除此之外，Bot 的名稱不能以一個點作為開頭（ASF 會略過那些檔案）。 並建議您避免使用空格，如有需要，請使用「_」作為分隔符號。
在您決定好名稱後，將「Enabled」選項開啟，這個選項會決定您的 Bot 是否會在 ASF 開啟後自動啟用。
您接下來會面臨一項選擇：
- 您可以將帳號名稱及密碼分別填入
SteamLogin與SteamPassword欄位中 - 或是將兩個欄位留空
如果填入，ASF 將在開啟時自動使用您的帳號憑證，這樣您就無需在每次 ASF 需要這些資訊時，都手動輸入它們。 不過，您也可以選擇不填入帳號密碼，這樣它們就不會被儲存。但缺少這些資訊，ASF 會無法自動登入，您需要在執行期間手動輸入。
ASF 需要您的登入憑證，因為它是透過內建的 Steam 用戶端來實現的，且需要跟您自己使用的用戶端相同的登入資訊。 您的登入認證只會儲存在您電腦上的 ASF config 資料夾中，我們的設定檔生成器也是基於用戶端的網頁，也就是說，代碼是在您本機的瀏覽器中執行，以此來生成 ASF 設定檔。您輸入的資訊永遠不會從您的電腦發送出去，所以您不必擔心任何可能的敏感資料洩漏。 儘管如此，我們能理解您仍可能出於某些原因不想輸入登入資訊。您可以稍後再手動輸入到產生的檔案中，或者徹底略過，並只在 ASF 的命令提示字元中輸入。 更多安全性問題，請參閱**組態設定**章節。
您也可以省略其中一個欄位，例如 SteamPassword，這樣 ASF 仍能自動登入，但會向您詢問密碼（類似 Steam 用戶端）。 若您使用 Steam 家庭監護帳號，您需要將 PIN 碼填入 SteamParentalCode 欄位來解鎖。
在這些操作完成後，您的網頁現在看起來會像是下圖：
現在您可以點擊「下載」按鈕，設定檔生成器會生成一個名為您剛才輸入的名稱的 .json 檔。 將這個檔案儲存至 config 資料夾中，該資料夾位於您在上個步驟解壓縮 .zip 檔後，得到的資料夾中。
現在，您的 config 資料夾看起來會像這樣：
恭喜！ 您剛剛完成了最基本的 ASF Bot 組態設定。 我們之後會擴充設定檔，而現在您暫時只需要這些。
現在您已經準備好第一次啟動程式了。 只需雙擊 ASF 資料夾中的 ArchiSteamFarm 二進制執行檔即可。 您也可以使用控制台來開啟它。
開啟後，若您在第一步正確地安裝了所有需要的相依性套件，ASF 應該會正常啟動。如果您沒忘記把生成的設定檔存放至 config 資料夾中，就可以看到 ASF 正嘗試登入您的第一個 Bot：
若您在設定檔中提供了 SteamLogin 和 SteamPassword 給 ASF 使用，ASF 就只會詢問您的 Steam Guard 權杖（電子郵件、雙重驗證或未設定，取決於您的 Steam 設定）。 若您並未提供，ASF 也會同時詢問您的 Steam 帳號名稱及密碼。
如果您對 ASF 有任何的擔心，例如以您的身分進行操作，現在可以到遠端通訊章節閱讀。
在輸入資訊後，假設您填寫的資訊無誤，您會成功地登入，而 ASF 將使用您目前尚未更改的預設設定來開始掛卡：
這代表 ASF 現在已成功地在您的帳號上運作，您可以將程式最小化，然後去做其他事情。 在經過足夠的時間後（取決於**效能），您將會看到 Steam 交換卡片慢慢掉落。 當然，要做到這一點，您必須擁有可以掛卡的遊戲，它會在您的徽章頁面上顯示「您可以透過遊玩本遊戲獲得 X 更多掉落卡片」；如果沒有可供掛卡的遊戲，ASF 將不做任何事情，如同常見問題**中所述。
我們最基本的新手上路指南到此結束。 您現在可以決定要進一步設定 ASF，或是讓 ASF 以預設設定運作。 我們將會介紹更多基本細節，然後您可以自己探索整個 Wiki。
ASF 支援一個帳號以上的同時掛卡，這也是它的主要功能。 您可以透過生成更多 Bot 設定檔來增加更多帳號，方法跟您幾分鐘前產生的第一個設定檔完全相同。 您只需要確保兩件事：
- 唯一的 Bot 名稱，例如假設您的第一個 Bot 名叫「MainAccount」，您就不能擁有另一個跟它名稱一樣的 Bot。
- 正確的登入資訊，例如
SteamLogin、SteamPassword和SteamParentalCode（如果使用 Steam 家庭監護功能）
換句話說，就是再次回到組態設定的部分，然後做完全一樣的事情，只不過這次要填入您第二或是第三個帳號的資訊。 記住，您所有的 Bot 需使用唯一的名稱。
您可以透過相同的方式來修改現有的設定：生成一個新的設定檔。 若您還沒有關閉設定檔生成器網頁，按一下「開啟／關閉進階設定」然後看看裡面有些什麼。 在本篇教學中，我們會更改 CustomGamePlayedWhileFarming 選項，這個選項可以使 ASF 在掛卡時，顯示自訂名稱，而不是實際上的遊戲名稱。
讓我們現在開始教學。如果您執行了 ASF 並開始掛卡，在預設情形下，您會看到您的 Steam 帳號正在遊戲中：
我們來更改它。 在設定檔生成器的網頁上按一下「開啟／關閉進階設定」，然後找到 CustomGamePlayedWhileFarming。 找到後，輸入您想要顯示的的自訂文字，例如「掛卡中（Idling cards）」：
現在跟之前一樣下載新的設定檔，然後用新的設定檔取代舊的。 當然，您也可以先刪除舊的設定檔，然後再放置新的。
完成並重新啟動 ASF 後，您將會看到 ASF 在之前的位置顯示您的自訂文字：
這證明了您已成功修改您的設定。 您也可以使用相同的方法來修改 ASF 全域屬性，切換至「ASF」分頁，下載生成的 ASF.json 設定檔，並放到 config 資料夾中。
使用我們的 ASF-ui 前端，可以更輕鬆地編輯您的 ASF 設定，我們之後會有更深入的說明。
ASF 是一個沒有圖形使用者介面的控制台應用程式。 然而，我們正積極開發 IPC 介面的 ASF-ui 前端，能夠存取各種 ASF 功能，是個非常方便的使用者友好方式。
要使用 ASF-ui，您需要啟用 IPC，它在 ASF V5.1.0.0 版本開始已預設成啟用。 啟動 ASF 之後，您應該能夠看到它正確地自動開啟 IPC 介面：
只要 ASF 在執行中，您就可以在同一台機器上透過**這個連結，來存取 ASF 的 IPC 介面。 您可以使用 ASF-ui 來進行各種操作，例如直接編輯設定檔，或是傳送指令**。 您可以隨意瀏覽，來發現 ASF-ui 的全部功能。
您已成功設定了 ASF，讓它使用您的 Steam 帳號，並根據您的喜好進行了客製化。 若您按照我們的整個指南進行操作，那麼您應已成功地透過 ASF-ui 介面來調整 ASF，並發現 ASF 實際上具有某種 GUI。 您現在可以閱讀完整的**組態設定章節，來了解您之前看到不同的選項有何用途，以及 ASF 都有哪些功能。 如果您遇到問題或有疑問，請閱讀我們的常見問題**，它應該涵蓋了所有，或至少絕大多數您可能會遇到的問題。 如果您想了解關於 ASF 的一切資訊，及它如何讓您掛卡事半功倍，請閱讀 ASF Wiki 的剩餘部分。 若您認為我們的程式很有用，並且您願意慷慨解囊，您也可以考慮捐款幫助我們的專案。 無論如何，祝您使用愉快！
這部分是為想要安裝 ASF Generic 變體版本的進階使用者所準備的。 若您可以使用**適用於您的作業系統的套件**，我們不推薦安裝您安裝 Generic（通用）套件。
您可能會在這些情形下選擇使用 Generic 變體版本（當然也可以沒有任何原因）：
- 當套件的建置版本沒有適用於您的作業系統時（例如 32 位元 Windows）
- 當您已安裝 .NET 執行環境／SDK，或打算安裝時
- 當您想自行管理執行環境需求，來最小化 ASF 的結構大小時
- 當您想要使用自訂**外掛程式**，且它需要 Generic 版本的 ASF 才能正常運作時（因為缺少原生相依套件）
但是，請注意，在這種情況下您需要自行負責 .NET 執行環境。 這代表如果您的 .NET SDK（執行環境）無法使用、過期或損毀，ASF 就會無法運作。 這就是為什麼我們不建議普通使用者使用這個版本的原因，因為現在您需要確保您的 .NET SDK（執行環境）與 ASF 的要求相符，並能執行 ASF，而不是使用我們驗證過的 ASF 自帶的 .NET 執行環境。
對於 Generic 套件，您需要參考上述適用於您的作業系統的安裝指南，但有兩處微小的差別。 除了安裝 .NET 需求套件外，您還需要安裝 .NET SDK，且 ArchiSteamFarm.dll 二進制檔案會取代適用於您的作業系統的 ArchiSteamFarm(.exe) 執行檔。 而其他步驟都是完全相同的。
增加了額外步驟之後：
- 安裝必要的 [.NET 需求套件](#.NET 需求套件)。
- 安裝適合您的作業系統的 .NET SDK（或至少安裝 ASP.NET Core 執行環境）。 大部分情況下您會需要一個安裝程式。 如果您不知道要安裝 .NET Core 的哪一個版本，請參閱**執行階段必要條件**。
- 在 **ASF 發布頁面**下載
Generic版本變體。 - 將壓縮檔解壓縮至一個新資料夾中。
- 設定 ASF。
- 透過輔助腳本或是手動在 Shell 中執行
dotnet /路徑/至/ArchiSteamFarm.dll指令來啟動 ASF。
輔助腳本（例如用於 Windows 的 ArchiSteamFarm.cmd 及用於 Linux/macOS 的 ArchiSteamFarm.sh）與 ArchiSteamFarm.dll 二進制檔案，這些檔案都是 Generic 變體版本獨有的。 若您不想手動執行 dotnet 指令，您可以使用輔助腳本。 當然，如果您沒有安裝 .NET SDK，或您的 PATH 中沒有可用的 dotnet 執行檔，則輔助腳本將無法運作。 輔助腳本不完全是必要的，您永遠可以透過手動執行 dotnet /路徑/至/ArchiSteamFarm.dll 指令來開啟 ASF。
