Setting up zh TW
如果您是第一次來到這裡，歡迎！ 我們很高興又看到一位對我們的專案感興趣的旅客，但請記住：能力越強，責任越大—— ASF 能夠完成許多不同的 Steam 相關事項，但您必須足夠小心地學習使用方法。 入門 ASF 的過程將會是一條陡峭的學習曲線，我們希望您在這方面閱讀 Wiki，它會詳細解釋一切如何運作。
如果您還在這裡，那就表示您堅持看完了上面的文字，非常好。 除非您跳過了上面的文字，那樣您很快就會經歷一段**糟糕的時間**…… 總之，ASF 是一個控制台應用程序，這意味著應用程式本身沒有你習慣的圖型介面。 ASF 主要設計執行於伺服器，所以它只是一個服務（守護行程）而非桌面應用程式。
然而這並不代表您不能在電腦上使用 ASF 或是使用比一般程式複雜。 ASF 是一個無需安裝的獨立程式，並且可以立即使用，但在這之前需要進行設定。 設定檔會告訴 ASF 啟動之後應該做什麼。 如果你在沒有設定檔的情況下啟動它，那麼 ASF 將不會做任何事情，就是這麼簡單。
一般來說，這是我們在接下來的幾分鐘內要做的事情：
聽起來有夠簡單，是吧？ 那就一起繼續吧。
第一步是確保您的作業系統可以正確地啟動 ASF。 ASF 是用 C# 語言編寫的，基於 .NET 平台，並且可能需要你的平台上尚不可用的原生程式庫。 Depending on whether you use Windows, Linux or macOS, you will have different requirements, although all of them are listed in .NET prerequisites document that you should follow. 這是我們應該使用的參考資料，但為了簡單起見，我們還額外詳細說明了下面所有需要的軟體。因此您無需閱讀完整的文件。
由於您正在使用的第三方軟體，一些（甚至全部）相依性已經存在於您的作業系統是完全正常的。 但您仍應透過在作業系統上執行合適的安裝程式來確保這些軟體確實已經安裝——缺少這些相依性，ASF 將完全無法啟動。
Keep in mind that you don't need to do anything else for OS-specific builds, especially installing .NET SDK or even runtime, since OS-specific package includes all of that already. You need only .NET prerequisites (dependencies) to run .NET runtime included in ASF.
- Microsoft Visual C++ Redistributable Update (x64 for 64-bit Windows, x86 for 32-bit Windows)
- 強烈建議確保已安裝所有Windows更新。 At the very least you need KB2533623, KB2999226, but more updates may be needed. 如果您的 Windows 更新到最新版，則上述所有都已安裝。 在安裝 Visual C++ 套件之前，請確保滿足這些要求。
- If you're using Windows 7, you'll be forced to run generic variant as your OS is no longer supported by OS-specific package. We strongly recommend an update soon, as future versions of ASF are likely to stop working altogether with it, not to mention that the OS reached its end of life back in 2020.
套件名稱取決於您正在使用的 Linux 發行版，我們已經列出了最常見的套件。 您可以使用本地套件管理系統，為您的作業系統取得全部套件（例如 Debian 的 apt 或 CentOS 的 yum）。
-
ca-certificates(standard trusted SSL certificates to make HTTPS connections) -
libc6(libc) -
libgcc1(libgcc) -
libicu(icu-libs, latest version for your distribution, for examplelibicu67) -
libgssapi-krb5-2(libkrb5-3,krb5-libs) -
libssl1.1(libssl,openssl-libs, latest version for your distribution, at least1.1.Xas1.0.Xmay no longer work) -
libstdc++6(libstdc++, in version5.0or higher) -
zlib1g（zlib）
At least a majority of those should be already natively available on your system. The minimal installation of Debian stable required only libicu67.
- None for now, but you should have latest version of macOS installed, at least 10.15+
既然我們已經擁有所有相依性程式，下一步就是下載**最新的 ASF 版本。 ASF 有許多變體可用，但您應該關注符合您作業系統和系統架構的套件。 例如，如果您正在使用 64 位元 Windows，那麼您將需要 ASF-win-x64 套件。 要取得更多關於可用變體的資訊，請參閱相容性部分。 ASF 也可以執行在我們沒有建置特定作業系統套件的系統上，例如 32 位元 Windows 請前往安裝通用（Generic）套件**。
下載完成之後，從解壓縮 ZIP 檔至一個資料夾中開始。 We recommend using 7-zip, but all standard utilities like unzip from Linux/macOS should work without problems as well.
建議將 ASF 解壓縮到獨立的目錄中而不是任何已有其他用途的目錄—— ASF 的自動更新功能將會在升級時刪除所有舊的和無關檔案，可能會使您丟失您儲存於 ASF 目錄的任何檔案。 如果您有任何想用於 ASF 的額外腳本或檔案，請將他們置放在 ASF 資料夾的上一層。
一個範例結構看起來會像是這樣：
C:\ASF (where you put your own things)
├── ASF shortcut.lnk (optional)
├── Config shortcut.lnk (optional)
├── Commands.txt (optional)
├── MyExtraScript.bat (optional)
├── (...) (any other files of your choice, optional)
└── Core (dedicated to ASF only, where you extract the archive)
├── ArchiSteamFarm(.exe)
├── config
├── logs
├── plugins
└── (...)
現在只剩最後一步：設定檔。 這是目前為止最複雜的步驟，因為它包含了許多您還不熟悉的新資訊，所以我們會嘗試在此提供一些易於理解的範例和簡單的解釋。
首先最重要的，設定檔頁面解釋了跟設定檔有關的一切事物，但它包含了數量龐大的新資訊，其中有很大一部分是我們不需要立即瞭解的。 作為代替，我們會教您如何取得您真正應該查找的資訊。
ASF configuration can be done in at least three ways - through our web config generator, ASF-ui or manually. 這在**設定檔**部分有深入地解釋，所以如果您想要取得更多詳細資訊，請參閱此部分。 We'll use web config generator as a starting point.
使用您最愛的瀏覽器造訪我們的**網頁設定檔產生器**頁面，在您手動停用了 JavaScript 的情況下您將需要啟用它。 我們建議使用 Chrome 瀏覽器或 Firefox 瀏覽器，不過產生器應該能在大多數熱門瀏覽器上作業。
開啟頁面後，切換到「BOT」分頁。 您應該會看見跟下面圖片相似的頁面：
如果您剛剛下載的 ASF 版本低於設定檔產生器的預設值的話，只需要在下拉式選單中選擇您的 ASF 版本號。 這會在設定檔產生器可用於尚未標記為穩定版的更新版（預覽版）ASF時發生。 您已經下載了已證實能可靠工作的最新穩定版 ASF。
從把 BOT 名稱輸入紅色醒目提示的欄位開始。 您可以使用任何名稱，例如您的暱稱、帳戶名稱、一串數字或是任何其他文字。 只有一個不能使用的名稱，ASF，因為這個關鍵字是為全域設定檔保留的。 除了 BOT 名稱不能以一個點開始（ASF 會故意略過那些檔案）以外。 我們還建議您避免使用空格，如果需要請使用「_」作為分隔符號。
決定好 BOT 名稱之後，把「Enabled」開啟，這個選項決定了您的 BOT 是否應該在 ASF 開啟後自動啟用。
現在您可以在兩件事上做決定：
- 您可以將帳戶名稱填入
SteamLogin欄位，密碼填入SteamPassword欄位 - 或者您可以留空
選擇做第一件事會允許 ASF 開啟時自動使用您的帳戶認證資訊，這樣您就不需要每次 ASF 需要這些資訊時都手動輸入。 不過您也可以選擇忽略它們，這樣它們就不會被儲存，所以缺少您的幫助 ASF 將無法自動啟動，您需要在執行階段輸入。
ASF 需要您的登入認證，因為它透過內建 Steam 用戶端自行實現，需要跟您自己使用的用戶端相同的資訊來登入。 您的登入認證只會儲存在您的電腦上的 ASF Config 目錄，不會儲存在其他地方，我們的網頁設定檔產生器是基於用戶端的，也就是說代碼是在您的瀏覽器本地執行來產生 ASF 設定檔的，您輸入的資訊永遠不會離開您的電腦，所以沒有必要擔心任何可能的敏感資料洩漏。 然而，無論是什麼原因讓您不想輸入登入認證，我們能夠理解，您可以稍後手動輸入到產生的檔案裡，或者徹底省略並只在 ASF 命令提示字元輸入。 更多安全性問題可以在**設定檔**部分找到。
您也可以選擇只省略一個欄位，例如 SteamPassword（Steam 密碼），這樣將能使 ASF 自動登入，不過仍然會詢問密碼（類似 Steam 用戶端）。 如果您在使用 Steam 家庭監護，要解鎖您的帳戶，您需要將 PIN 碼填入 SteamParentalCode 欄位。
在一連串的決定和選擇過後，您的網頁現在看起來會像是下圖：
您現在可以按下您現在可以按下「下載」按鈕了，網頁設定檔產生器將會產生一個名為您剛才輸入的名稱的 json 檔。 Save that file into config directory which is located in the folder where you've extracted our zip file in the previous step.
您的 config 目錄現在看來會像是這樣：
恭喜！ 您剛剛完成了最基本的 ASF BOT 設定。 我們之後將會擴充設定檔，現在您暫時只需要這些。
現在您已經準備好第一次啟動程式了。 Simply double-click ArchiSteamFarm binary in ASF directory. You can also start it from the console.
按下以後，如果您在第一步正確地安裝了所有相依性，ASF 應該會正確地啟動，注意您的第一個 BOT（如果您沒忘記把產生的設定檔置放在 config 目錄裡），然後嘗試登入：
如果您在設定檔提供了 SteamLogin 和 SteamPassword 給 ASF 使用，ASF 將只會詢問您的 Steam Guard 權杖（電子郵件、兩步驟驗證或無，取決於您的 Steam 設定）。 如果您沒有提供這兩項，ASF 也會同時詢問您的 Steam 帳戶名稱和密碼。
Now would be a good time to review our remote communication section if you're concerned about stuff ASF is programmed to do, including actions it'll take in your name.
After passing through initial login gate, assuming your details are correct, you'll successfully log in, and ASF will start farming using default settings that you didn't change as of now:
這表明 ASF 現在成功在您的帳戶上工作了，所以您現在可以最小化程式然後幹其他事。 經過足夠的時間後（取決於**效能**），您將會看到 Steam 交換卡片慢慢掉落。 Of course, for that to happen you must have valid games to farm, showing as "you can get X more card drops from playing this game" on your badges page - if there are no games to farm, then ASF will state that there is nothing to do, as stated in our FAQ.
我們最基本的新手上路指南到此結束。 您現在可以決定要進一步設定 ASF，還是讓 ASF 以預設設定工作。 我們將會介紹更多基本細節，然後您可以自己探索整個 Wiki。
ASF 支援一個帳戶以上同時掛卡，也是它的主要功能。 您可以透過產生更多 BOT 設定檔來添加更多帳戶，方法跟您幾分鐘前產生的第一個設定檔完全相同。 您只需要確保兩件事：
- BOT 名稱唯一，例如假設您的第一個 BOT 名為「主帳戶」，您就不能擁有另一個跟它名稱一樣的 BOT。
- 登入資訊有效，例如
SteamLogin、SteamPassword和SteamParentalCode（如果正在使用 Steam 家庭監護）
換句話說，只要再次跳轉到設定檔部分，然後做完全一樣的事，只不過這次要填入您第二或是第三個帳戶的資訊。 記住為您所有的 BOT 使用唯一的名稱。
您可以透過完全相同的方式來變更現有的設定——產生一個新的設定檔。 如果您還沒有關閉網頁設定檔產生器，按一下「開啟進階設定」然後看看有什麼是您發現您所需要的選項。 For this tutorial we'll change CustomGamePlayedWhileFarming setting, which allows you to set custom name being displayed when ASF is farming, instead of showing actual game.
So let's do that, if you run ASF and start farming, in default settings you'll see that your Steam account is in-game now:
那就讓我們一起來完善吧。 在網頁設定檔產生器中按一下「開啟進階設定」然後找到 CustomGamePlayedWhileFarming。 找到後，輸入您想要顯示的的自訂文字，例如「掛卡中（Idling cards）」：
現在跟之前一樣下載新的設定檔，然後用新的設定檔取代舊的。 當然，您也可以先刪除舊的設定檔，然後再放置新的。
一旦完成並重新啟動 ASF，您將注意到現在 ASF 會在之前的位置顯示您的自訂文字：
This confirms that you've successfully edited your config. In exactly the same way you can change global ASF properties, by switching from bot tab to "ASF" tab, downloading generated ASF.json config file and putting it in your config directory.
Editing your ASF configs can be done much easier by using our ASF-ui frontend, which will be explained further below.
ASF 是一個沒有圖形使用者介面的主控台應用程式。 然而，我們正在積極開發 IPC 介面的 ASF-ui 前端，一個存取各種 ASF 功能非常方便的使用者友好型方式。
In order to use ASF-ui, you need to have IPC enabled, which is the default option starting with ASF V5.1.0.0. Once you launch ASF, you should be able to confirm that it properly started the IPC interface automatically:
You can access ASF's IPC interface under this link, as long as ASF is running, from the same machine. You can use ASF-ui for various purposes, e.g. editing the config files in-place or sending commands. 請隨意看看來發現 ASF-ui 的全部功能。
您已經成功設定好讓 ASF 使用您的 Steam 帳戶，並且根據您的喜好進行了客製化。 If you followed our entire guide, then you also managed to tweak ASF through our ASF-ui interface and found out that ASF actually has a GUI of some sort. Now is a good time to read our entire configuration section in order to learn what all those different settings you've seen actually do, and what ASF has to offer. If you've stumbled upon some issue or you have some generic question, read our FAQ instead which should cover all, or at least a vast majority of questions that you may have. 如果您想瞭解關於 ASF 的一切以及它如何讓您掛卡事半功倍，請閱讀 ASF Wiki 的剩餘部分。 If you found out our program to be useful for you and you're feeling generous, you can also consider donating to our project. In any case, have fun!
這部分是為想要安裝 ASF 通用（Generic） 套件的進階使用者準備的。 如果您可以**安裝特定作業系統（OS-specific）套件**，我們不推薦安裝您安装通用套件。
You want to use generic variant mainly in those situations (but of course you can use it regardless):
- 當您正在使用沒有建置特定作業系統套件的系統（例如 32 位元 Windows）
- When you already have .NET Runtime/SDK, or want to install and use one
- 當您想透過自行管理執行階段必要條件來最小化 ASF 結構大小
- When you want to use a custom plugin which requires a
genericsetup of ASF to run properly (due to missing native dependencies)
However, keep in mind that you're in charge of .NET runtime in this case. This means that if your .NET SDK (runtime) is unavailable, outdated or broken, ASF won't work. This is why we don't recommend this setup for casual users, since you now need to ensure that your .NET SDK (runtime) matches ASF requirements and can run ASF, as opposed to us ensuring that our .NET runtime bundled with ASF can do so.
For generic package, you can follow entire OS-specific guide above, with two small changes. In addition to installing .NET prerequisites, you also want to install .NET SDK, and instead of having OS-specific ArchiSteamFarm(.exe) executable file, you now have a generic ArchiSteamFarm.dll binary only. 其他步驟完全一樣。
額外步驟：
- 安裝 .NET 的必要條件。
- Install .NET SDK (or at least ASP.NET Core runtime) appropriate for your OS. 大部分情況下您會需要一個安裝程式。 如果您不知道要安裝 .NET Core 的哪一個版本，請參閱**執行階段必要條件**。
- Download latest ASF release in
genericvariant. - 將壓縮檔解壓到一個新資料夾。
- 設定 ASF
- 透過輔助腳本或是手動在 Shell 中執行
dotnet /path/to/ArchiSteamFarm.dll指令來啟動 ASF。
Helper scripts (such as ArchiSteamFarm.cmd for Windows and ArchiSteamFarm.sh for Linux/macOS) are located next to ArchiSteamFarm.dll binary - those are included in generic variant only. 如果您不想手動執行 dotnet 指令，請使用輔助腳本。 Obviously helper scripts won't work if you didn't install .NET SDK and you don't have dotnet executable available in your PATH. 輔助腳本完全是非必要的，您永遠可以透過手動執行 dotnet /path/to/ArchiSteamFarm.dll 指令來啟動 ASF。
