Setting up zh TW
如果您是第一次來到這裡，歡迎！ 我們很高興又看到一位對我們的專案感興趣的旅客，但請記住：能力越強，責任越大⸺只要您足夠認真學習如何使用它，ASF就能完成相當多的Steam相關事務。 也對，詳讀Wiki、遵循我們的指南，並深入了解ASF的各種功能，最後將使您掌握目前Steam最強大工具之一的獨特使用技巧。
我們建議您一次只做一件事。 ASF涉及的領域非常廣泛，部分較為簡單，而另一些則相當複雜。 您不需要立即理解或閱讀一切，我們建議您以輕鬆的態度一點一點地來。 放輕鬆，拿杯喜歡的飲料，抽出一個小時進入我們的課堂⸺我們保證它值得。
讓我們從基礎開始：ASF本質上是一款控制台應用程式，這代表它不會生成您經常使用的圖形化介面。 ASF作為一個通用應用程式，主要以服務（常駐程式）的形式執行，而非桌面應用程式。 它的其中一個使用範例為在伺服器設備上執行，而桌面應用程式完全不適合在這個情境下使用。 不過，這僅描述了程式的核心，因為事實上ASF確實有圖形化介面⸺也就是內建的前端，ASF-ui，我們會在稍後討論這部分⸺我們先提這部分，是為了避免您被黑色控制台視窗之類的東西嚇到。
在您取得ASF二進制檔案後，程式需要您來設定，也就是您指定ASF要來做哪些事情。 您可以在尚未設定的情形下直接啟動程式，在這種情形下，ASF會以預設設定啟動，能夠讓您進行部分操作，例如透過ASF-ui設定，但除此之外就無法在未經預先設定的情形下發揮出更多功能了。
大概就先說這些吧，讓我們先開始！
在一般情形下，這是我們在接下來的幾分鐘內要做的事情：
某些步驟一目了然，但其他的可能需要您稍加注意。 別擔心，我們會手把手帶您進入。
首要步驟，是確保您的作業系統可以正確地啟動ASF。 這部分您不必特別了解，但ASF是用C#語言編寫的，基於.NET平台，並可能需要您平台上尚未擁有的原生函式庫。 您可以把它想像成3D遊戲需要DirectX，或是車子需要引擎發動。
依據您是使用Windows、Linux或macOS，您將需要滿足不同的需求。 參考文件為.NET需求套件，但為了簡單起見，我們也在下方列出了一切所需，這樣您就不必閱讀整份文件，除非您遇到了問題或有額外需求。
若您已安裝並使用了其他第三方軟體，一些（甚至全部）相依性套件已存在於您的作業系統上，是很正常的。 不過，這種情形並非總是發生，導致您需要在您的作業系統中執行相應的安裝程式⸺沒有這些相依套件的話，ASF將會完全無法啟動，且您在這種情形下也基本不會看到任何有用的錯誤資訊。
請注意，您不需要特地為特定作業系統的組建版本做其他任何事情，特別是.NET SDK的安裝或執行環境，因為它們已包含於作業系統套件中。 您只需要安裝.NET需求套件（相依套件），使ASF自帶的.NET執行環境能執行即可⸺僅需安裝下列指定的內容，不需安裝其他東西。
Windows：
- Microsoft Visual C++可轉散發套件更新（64位元組使用x64、32位元組使用x86、64位元組ARM使用arm64）
- 強烈建議您，務必確保已安裝所有的Windows更新。 若您尚未啟用自動更新，您最少需要安裝KB2533623及KB2999226，但有可能還需要安裝更多更新。 若您的Windows已是最新版本，或足夠新版，則可跳過這項說明。
Linux：
套件名稱取決於您使用的Linux發行版本，我們列出了最常見的套件名稱。 您可以使用本機中的套件管理系統，為您的作業系統取得全部套件（例如適用於Debian的apt，或適用於CentOS的yum）。 這些都是非常標準的函式庫，不論您使用哪種發行版本都應該有對應的可供使用，您只需要弄清楚它們在您的環境中叫什麼名稱。
-
ca-certificates（用於建立HTTPS連線的標準可信賴的SSL憑證） -
libc6（libc） -
libgcc-s1（libgcc1、libgcc） -
libicu（icu-libs，您的發行版本的最新版，例如libicu76） -
libgssapi-krb5-2（libkrb5-3、krb5-libs） -
libssl3（libssl、openssl-libs，您的發行版本的最新版，且至少為1.1.X版本） -
libstdc++6（libstdc++，5.0版本或更高） -
zlib1g（zlib）
上述大多數套件應早已安裝於您的系統中。 舉例來說，Debian穩定版的最小安裝通常也只需再安裝libicu76即可。
macOS：
- 您不必做額外的事情，但您仍應安裝最新版本的macOS，至少為12.0+版本
既然我們有了所有的相依性套件，那麼接下來就是下載ASF最新版本。 ASF有許多變體版本可供使用，但您應使用符合您作業系統及其架構的版本套件。 舉例來說，假設您使用64位元Windows，那麼您需使用ASF-win-x64版本的套件。 欲取得關於可用變體的更多資訊，請參閱相容性章節。 ASF也可以執行於沒有提供組建版本的環境中，例如32位元Windows，但您需要安裝Generic版本。
下載完成後，請先解壓縮.zip檔至一個資料夾中。 若您需要特定的工具，7-zip即可做到，不過使用任何標準工具（例如Windows內建的解壓縮，或Linux/macOS中的unzip工具）應該也沒有問題。
請注意，務必將ASF解壓縮至獨立的資料夾中，不要解壓縮至有其它用途的資料夾⸺這非常重要。 ASF含有自動更新功能，也就是會取代自身的檔案，在升級時，通常會刪除舊的或不相關的檔案，會使得您在ASF資料夾中放置的任何的無關檔案遺失。 若您擁有與ASF相關的額外腳本或檔案，那也沒問題，您可以為其建立一個獨立資料夾，或是將ASF放在其子資料夾中。
一個檔案結構範例，看起來會像是這樣：
C:\ASF（可存放您自己的東西）
├── MyNotes.txt（選擇性）
├── AsfMakeMeCoffeeScript.bat（選擇性）
├── (...)（其餘您想存放的檔案，選擇性）
└── Core（ASF專用資料夾，也就是您解壓縮壓縮檔的地方）
├── ArchiSteamFarm(.exe)
├── config
├── logs
├── plugins
├── www
└── (...)
現在只剩最後一步：組態設定。 ASF基於「Bot」的概念運作，每個Bot對應了您要在ASF中使用的每個Steam帳號。 您可以定義任意數量的Bot，但對於初學者而言，我們將專注於單一一個⸺通常是您的主要帳號。 ASF也擁有非Bot的設定檔，最重要的當屬全域設定檔，它會影響到實例中的所有Bot。
建議您，如果不清楚、或不了解某個設定，最好維持預設值，不要隨意修改。 ASF提供了多種方式來設定、自訂及調整幾乎所有的功能，但如同前面所提到的，貿然嘗試理解其所有功能可能會讓你陷入困境，甚至墜入深淵。 我們建議您先擁有正常運作的ASF，然後再探索額外的功能。可以參考Wiki上的組態設定頁面，且一次只改一個功能。
ASF可以由不同方式設定⸺透過內建的ASF-ui前端、獨立的設定檔生成器網頁工具，或手動設定。 這在組態設定章節中有深入的解釋，若您想要取得更多詳細資訊，請參閱此部分。 我們將從獨立的設定檔生成器網頁工具開始，因為萬一ASF-ui啟動失敗，它仍能使用。
使用您偏好的瀏覽器前往我們的設定檔生成器網頁工具頁面（別忘了在左上角選擇繁體中文）。 我們建議您使用Chrome或Firefox，但其它任何能正常瀏覽網頁的瀏覽器也可以。
開啟頁面後，切換到「Bot」分頁。 您應該會看見類似於下圖的頁面：
如果您剛剛下載的ASF版本低於設定檔生成器的預設值，只需在下拉式選單中選擇您的ASF版本。 這種（罕見）情形會在設定檔生成器用於尚未標示為穩定版的更新版本（預覽版）ASF時發生。 您下載了最新的穩定版本ASF，已被驗證能夠可靠的運作，因此它可能比最新的開發版本略舊，但對於新手而言，最新的預覽版並不適合使用。
首先在紅色高亮Name欄位中填入您的Bot的名稱。 您可以使用任何名稱，例如您的暱稱、帳號名稱、一串數字或是任何其他文字。 其中只有一個您無法使用的名稱，ASF，因為這個關鍵字是為全域設定檔保留的。 除此之外，Bot的名稱不能以一個點作為開頭（ASF會略過那些檔案）。 我們還建議您避免使用空格，如果需要，您可以使用底線_作為單字的分隔符號⸺這非強制性的，但若您使用了空格，您可能會在使用ASF指令時遭遇困難。
確定Bot的名稱了嗎？ 非常好。在下一步中，更改Enabled開關至「勾」，該選項會決定您的Bot是否會在ASF程式啟動後自動執行。 如果不啟用，會使得ASF認為設定檔中您的Bot被停用，且需要您的指令才能啟動，在本範例中，這並不是我們要的效果。
現在，來處理兩個敏感屬性：SteamLogin與SteamPassword。 您這裡可以再次做出自己的判斷⸺您可以在這兩個屬性中填入您的Steam登入資訊，或是留空。
ASF需要您的登入憑證，因為它是透過內建的Steam用戶端來實現的，且需要跟您自己使用的用戶端相同的登入資訊。 您的登入憑證只會儲存於您電腦中ASF的config資料夾中（在您下載生成好的設定檔後）。 我們的設定檔生成器網頁工具是執行於用戶端的應用程式，這代表您在該頁面上的任何操作或行為，都只會在您的本機瀏覽器中執行，包含生成可用的ASF設定檔，您輸入的資訊不會被傳送至他處，因此您無須擔心任何敏感性資料會洩漏。 以防萬一您還是不想要輸入您的憑證（我們可以理解這點），您可以在稍後手動填入已生成完畢的設定檔中，或是完全忽略這兩個屬性，並在留白的情形下操作。
如果您決定輸入您的憑證，ASF將能在啟動過程中自動登入，並結合選擇性的雙重驗證功能，使您能夠按兩下執行程式就能完成一切。 若您決定省略它們，那麼ASF將會在需要時詢問您所需資訊⸺這樣系統不會存有這些資訊，但顯然，如果您在被詢問時仍不提供，則ASF將無法運作。 使用何種方式取決於您，與平時一樣，您可以在組態設定章節中找到更多資訊。
順道一提，您也可以只留空一個欄位，例如SteamPassword​。 之後ASF就可以自動使用您的登入資訊，但仍會在需要時向您詢問密碼（與Steam用戶端行為相似）。 如果您需要使用4位數的家庭監護PIN碼來解鎖您的帳號，我們也建議將其填入SteamParentalPin​欄位。當然您也可以直接留空就好，順便見證這種保護機制究竟多麼脆弱，因為ASF可以在登入後的數秒內直接「破解」它。 哎喲喂呀！
完成上述所有步驟後⸺再說一次，Bot名稱、啟用開關，以及登入憑證⸺您的頁面應該會與下面類似：
現在您可以點擊「下載」按鈕，設定檔生成器會生成一個名為您剛才輸入的名稱的.json檔。 將該檔案儲存至config資料夾中，位於您上個步驟中解壓縮.zip檔案所得到的資料夾中。
恭喜！ 您剛剛完成了最基本的ASF Bot組態設定。 還有許許多多功能等待您去發現，但現在這就是您需要的一切。
我知道您一直都在等這一刻的到來，我也不應該再讓您等下去了，因為您已經準備好第一次啟動程式了。 只需點兩下ASF資料夾中的ArchiSteamFarm二進制執行檔即可。 您也可以使用控制台來開啟它。
如果您會擔心ASF會做哪些事情，特別是它會以您的身分來執行何種操作，例如預設會加入我們的Steam群組，現在您正是您查看我們的遠端通訊章節的好時機。 若您不喜歡，隨時都可以停用特定的功能：ASF擁有精心設計過的預設設定，我們需要依據多數使用者的普遍需求，以及我們自身對程式的一般性的原則，做出相應的設定。
假設一切順利，特別是在第一個步驟中安裝所需的相依套件，及第三個步驟中的輸入設定，ASF應該會正確地啟動、自動偵測到您的第一個Bot，並嘗試登入：
ASF很可能還需要您提供更多資訊⸺雙重驗證代碼，以存取您的帳號（除非您完全停用了Steam Guard）。 您只需依照畫面中的指示，提供來自驗證器或電子郵件的代碼，或在行動裝置應用程式中接受登入即可。
出錯了嗎？
您要嘛是缺少了.NET需求套件，要嘛是下載了不符合您設備的ASF版本。 如果您不知道哪裡有問題，可以試著在常見問題中找到對應的狀況；若您仍無法解決此問題，可以在我們的支援站中尋求協助。
您沒有將已生成的設定檔放入config資料夾中。 該步驟其餘常見的錯誤還有：手動把副檔名從.json更改為.txt等。部分作業系統（例如Windows）預設會隱藏常見的附檔名，您需要確保您的檔案位於正確的位置，也擁有正確的名稱。
您忘記將Enabled開關打開了，這個選項會告訴ASF是否自動啟動您的Bot。 當然，除非您本來就希望如此。如果是這種情形，則您應該已經知道如何執行指令，在看到這個訊息後直接執行start即可。
您的登入憑證很大的機率是錯誤的。 在已生成的設定檔中檢查您的SteamLogin與SteamPassword，如果出錯了，請回到設定步驟來更正它們。 若仍有問題，請嘗試在您自己的Steam用戶端中使用相同的憑證登入⸺應該也會失敗，且您有機會看到更具體的出錯原因。
如果您輸入的資訊都正確，在經過登入驗證後，您將會成功登入，ASF會以您尚未更改的預設設定開始掛卡：
這代表ASF現在已成功地在您的帳號上運作，您可以將程式最小化，然後去做其他事情。 不妨再去倒杯飲料，享受片刻放鬆再回來。
掛卡是個需要單開一頁來深入討論的話題，但一般來說，在經過足夠的時間後（取決於效能），您會看到Steam交換卡片逐漸掉落。 當然，這件事要發生的前提是，您需要有可以掛卡的遊戲，在您的徽章頁面中會顯示「還有X張卡片會掉落」；如果沒有可供掛卡的遊戲，ASF將不做任何事情，如常見問題中所述。
我們最基本的新手上路指南到此結束。 像每個RPG遊戲一樣，您已完成了新手教學，而我們為您準備了整個ASF世界來探索。 舉例來說，您現在可以決定要進一步設定ASF，或是讓ASF以預設設定運作。 若您想要了解更多資訊，我們將會介紹更多基本細節，然後您可以自己探索整個Wiki。
ASF支援一個帳號以上的同時掛卡，這也是它的主要功能。 您可以透過生成更多Bot設定檔來增加更多帳號，方法跟您幾分鐘前產生的第一個設定檔完全相同。 您只需要確保兩件事：
- 唯一的Bot名稱，假如您的第一個Bot叫做「
MainAccount」，您就不能擁有另一個跟它名稱一樣的Bot。 - 有效的登入資訊，例如
SteamLogin、SteamPassword及SteamParentalCode（如果您決定填入它們）
也就是說，就是再次回到組態設定的部分，然後做完全一樣的事情，只不過這次要填入您第二或是第三個帳號的資訊。 別忘了您的每個Bot的名稱都需要是獨一無二的，避免覆蓋掉已有的設定檔。
在我們的獨立設定檔生成器網頁工具，修改現有設定的方式完全相同⸺生成一個新的設定檔。 點擊「開啟／關閉進階設定」，查看有哪些可供調整的設定。 在本範例中，我們會修改CustomGamePlayedWhileFarming選項，這個選項可以使ASF在掛卡時顯示自訂名稱，而不是實際上的遊戲名稱。
讓我們先簡單分析一下。 如果您執行了ASF並開始掛卡，在預設情形下，您會看到您的Steam帳號正在遊戲中：
這很合理，因為ASF告訴了Steam平台我們正在玩這款遊戲，因為我們需要它的交換卡片，對吧？ 但我們可以自訂這個！ 按一下「開啟／關閉進階設定」（若您還沒開啟），然後找到CustomGamePlayedWhileFarming。 在這裡輸入任何您想要顯示的文字，例如「Idling cards」（正在掛卡）：
現在跟之前一樣下載新的設定檔，然後用新的設定檔取代舊的。 當然，您也可以先刪除舊的設定檔，然後再放置新的。
ASF足夠聰明，它應當會注意到您修改了設定，然後自動讀取並套用新的設定，不需要重新啟動程式。 萬一沒有自動套用新設定，您只要直接重新啟動程式來載入您的新設定即可。 完成後，您應該會看到ASF在剛剛提到的地方顯示您自訂的文字：
這證明了您已成功修改您的設定。 您也可以使用相同的方式來修改ASF全域屬性，切換至「ASF」分頁，下載生成出來的ASF.json設定檔，並放到config資料夾中。
使用我們的ASF-ui前端，可以更輕鬆地編輯您的ASF設定，我們在接下來會有更深入的說明。
正如我們剛剛所提到的，ASF是一個控制台應用程式，預設情形下不會啟動圖形化的使用者介面。 但是，我們也積極開發使用IPC介面的ASF-ui前端，它能夠存取各種ASF功能，是個非常方便的使用者友好方式。
要使用ASF-ui，您需要擁有啟用的IPC，這是ASF預設開啟的，所以直到您手動停用它，都會保持啟用。 啟動ASF之後，您應該能夠看到它自動成功開啟IPC介面的訊息：
簡單來說，IPC是ASF內建的網頁伺服器，執行於您的本機設備中，使您能夠透過偏好的瀏覽器來與之互動。 假設IPC正常啟動，您就可以在與執行ASF相同的設備上，透過點擊這個連結，來存取ASF的IPC介面。 您可以使用ASF-ui來進行各種操作，例如直接編輯設定檔，或是傳送指令。 您可以隨意瀏覽它，來發現ASF-ui的全部功能。
您已成功設定了ASF，讓它使用您的Steam帳號，並依據您的喜好進行了客製化。 若您按照我們的整個指南進行操作，那麼您應已成功透過ASF-ui介面來調整ASF，並已開始探索更多功能了。 本教學到此結束，但我們也想向您推薦一下其他內容（也可以稱為「支線任務」），如果您願意的話：
- 我們的組態設定章節會詳細解釋您看到的各種設定的實際功能，以及ASF還可以提供您哪些功能。 別忘了在閱讀時適當地補充水分，我們已經提醒過您了。
- 如果您遇到問題或有疑問，請參考我們的常見問題，它應該涵蓋了所有，或至少絕大多數您可能會遇到的問題。
- 如果您想了解關於ASF的一切資訊，及它如何讓您的掛卡事半功倍，請閱讀ASF Wiki的剩餘部分。 使用右方的側邊欄來挑選您感興趣的主題。
- 最後，若您覺得我們的程式對您有幫助，且感謝我們這份經大量努力的成果，也可以考慮贊助我們。 我們為愛發電，這才有了ASF。在過去的10多年裡，我們一直利用空閒時間努力開發，為您帶來更進一步的體驗，我們對此感到非常自豪⸺即使是如$1美元的小額贊助，也會讓我們倍感珍惜，這代表了您的支持與關心。 無論如何，祝您使用愉快！
本篇附錄是針對那些想要執行Generic版本的ASF進階使用者所準備的。 雖然比起適用於特定作業系統的版本使用起來更加麻煩，但這也讓它擁有了其他的優點。
您可能會在擁有下列情形時使用Generic版本：
- 我們準備的套件的組建版本，沒有一種適用於您的作業系統（例如32位元Windows）
- 您已安裝.NET執行環境／SDK，或者打算安裝它們
- 您想自行管理執行環境需求，來最小化ASF的結構大小及記憶體使用量
- 您想要使用自訂外掛程式，且它需要Generic版本的ASF才能正常運作（因為缺少原生相依套件）
當然，您也可以在任何情境中使用它，但上述是您最有可能用到的時機。
但請注意，Generic安裝方式需要額外注意⸺在這種情形下，您必須負責管理.NET執行環境。 這代表只要您的.NET SDK（執行環境）無法使用、過舊或損毀，ASF就會無法運作。 這就是為什麼我們完全不建議普通使用者使用這個版本的原因，因為現在您需要確保您的.NET SDK（執行環境）與ASF的要求相符，並能執行ASF，而不是使用我們驗證過的ASF自帶的.NET執行環境。
對於Generic套件，您需要參考上述適用於您的作業系統的安裝指南，但僅有兩處微小的差別。 除了安裝.NET需求套件外，您還需要安裝.NET SDK，且不要下載特定作業系統的ArchiSteamFarm(.exe)執行檔，而是使用ArchiSteamFarm.dll二進制檔案。 而其他步驟都是完全相同的。
增加了額外步驟之後：
- 安裝.NET需求套件。
- 安裝適合您的作業系統的.NET SDK（或至少安裝ASP.NET Core及.NET執行環境）。 大部分情形下您會需要一個安裝程式。 如果您不知道要安裝.NET Core的哪一個版本，請參閱執行環境需求。
- 在ASF發布頁面下載
Generic版本變體。 - 將壓縮檔解壓縮至一個新資料夾中。
- 設定ASF，方式與上述內容完全相同。
- 透過輔助腳本或是手動在Shell中執行
dotnet /路徑/至/ArchiSteamFarm.dll指令來啟動ASF。
ASF的Generic版本不包含特定系統的二進制檔案，這也是它被稱作Generic的原因⸺它能跨平台使用，並於任何地方執行。
這也是為什麼我們要將輔助腳本（例如用於Windows的ArchiSteamFarm.cmd，以及用於Linux／macOS的ArchiSteamFarm.sh），附隨至ArchiSteamFarm.dll二進制檔案旁。 若您不想手動執行dotnet指令，就可以使用輔助腳本。
當然，如果您沒有安裝.NET SDK，或您的PATH中沒有可用的dotnet執行檔，則輔助腳本會無法運作。 這些腳本用與不用取決於個人，您也可以手動執行dotnet /path/to/ArchiSteamFarm.dll命令，這些腳本就是在做這件事情，只不過對這個命令做了些額外的調整。
