ItemsMatcherPlugin zh TW
ItemsMatcherPlugin是ASF官方的外掛程式，使用ASF STM清單來擴充ASF的功能。 這特別是包含了RemoteCommunication中的PublicListing，及TradingPreferences中的MatchActively。 ASF發行版本附隨了ItemsMatcherPlugin，因此能夠立即使用。
顧名思義，公開清單是當前可供使用的ASF STM Bot的清單。 它位於我們的網站上，進行自動管理並作為一項公共服務，提供使用MatchActively的ASF使用者及手動匹配的ASF與非ASF使用者使用。
In order to be listed, you have a set of requirements to meet. At the minimum you must have allowed PublicListing in RemoteCommunication (default setting), SteamTradeMatcher enabled in TradingPreferences, public inventory privacy settings, unrestricted account, ASF 2FA active and at least 100 items from specified MatchableTypes, such as trading cards.
雖然PublicListing預設為啟用，但請注意，如果您不滿足所有要求，您將不會被顯示在網站上，特別是SteamTradeMatcher，它在預設情形下並未啟用。 對於不滿足條件的人，即使他們保持啟用PublicListing，ASF也不會以任何方式與伺服器通訊。 公開清單也只會與ASF最新的穩定版相容，並可能拒絕顯示過時的Bot，特別是如果它們缺少只能在新版本中找到的核心功能。
ASF會在登入後傳送一次初始資料，其中包含公開清單使用的所有屬性。 然後每隔10分鐘，ASF會傳送一個非常微小的「心跳」請求，來通知我們的伺服器該Bot仍在執行。 如果由於某種原因該心跳未能送達，例如網路問題，那麼ASF將每分鐘重新傳送一次，直到被伺服器記錄。 透過這種方式，我們的伺服器可以準確知道哪些Bot仍在執行，並準備好接受交易提案。 ASF還會依據需要傳送初始發布，例如它偵測到我們的物品庫自上個紀錄以來發生了變化時。
我們顯示在過去15分鐘內，所有啟用ASF雙重驗證及STM的活躍帳號。 使用者會依他們的相對有用性排序：首先是顯示帶有Any標題，接受所有1:1交易的MatchEverything Bot，然後依遊戲數量，最後依物品數量排序。
ASF STM清單暫時只接受ASF Bot。 目前無法在我們的清單中顯示第三方Bot，因為我們無法輕易查看它們的程式碼，並確保它們符合我們的整個交易邏輯。 所以，參與清單需要最新的ASF穩定版本，雖然它仍可以使用自訂外掛程式執行。
對於清單的消費者，我們有個非常簡單的/Api/Listing/Bots端點供您使用。 它包含了我們擁有的所有資料，但不包含作為MatchActively功能一部分的使用者物品庫。
若您同意顯示於我們的清單中，即如上所述，啟用SteamTradeMatcher且不拒絕PublicListing，我們將在我們的伺服器上臨時儲存一些您的Steam帳號詳細資料，用以提供所需功能。
公開資訊（Steam向所有相關者公開的）包括：
- 您的Steam ID（64位元形式，用於生成連結）
- 您的暱稱（用於顯示）
- 您的頭像（雜湊值，用於顯示）
半公開資訊（Steam向所有符合清單需求相關者公開的）包括：
- 您的物品庫（使其他人可以對您的物品使用
MatchActively）。
私人資訊（提供功能所需的特定資料）包括：
- 您的交易權杖（使非您好友的帳號能向您發送交易提案）
- 您的
MatchableTypes設定（用於顯示及匹配） - 您的
MatchEverything設定（用於顯示及匹配） - 您的
MaxTradeHoldDuration設定（使其他人知道您是否願意接受他們的交易）
MatchActively設定是SteamTradeMatcher的主動版本，包含Bot發送交易給其他使用者的交互式匹配。 它可以單獨運作，亦可結合SteamTradeMatcher設定一起運作。 這個功能需要設定LicenseID，因為它使用了第三方伺服器及付費資源來運作。
為了使用這個選項，您需要滿足一系列的需求。 您至少應保證帳號不受限制、啟用ASF雙重驗證，並在MatchableTypes中設定至少一種有效類型，例如交換卡片。
若您滿足了上述需求，ASF將會定期與我們的公開的ASF STM清單通訊，以主動匹配當前可用的Bot。
匹配將在ASF啟動後約1個小時後開始，並且每8個小時重複一次（如果需要）。 During matching, ASF bot will fetch its own inventory, then communicate with our server with it to find all possible MatchableTypes matches from other, currently available bots. 由於直接與我們的伺服器通訊，這個過程只需一個請求，我們就可以立即了解是否有任何可用的Bot能夠提供我們感興趣的東西⸺如果找到匹配物品，ASF將自動發送並確認交易提案。
這個模組應是透明的。 匹配將在ASF啟動後約1個小時後開始，並且每8個小時重複一次（如果需要）。 MatchActively feature is aimed to be used as a long-run, periodical measure to ensure that we're actively heading towards sets completion, but without a short-term time and resources pressure that would happen if this was offered only as a command. 這個模組的目標使用者是主要帳號及「用於存放物品的」備用帳號，但亦可被任何未設定成MatchEverything的Bot使用。
ASF會盡力將使用該選項產生的請求量及壓力降至最低，同時盡可能提高匹配效率。 匹配Bot及組織整個流程的演算法是ASF的實作細節，並且可以依據回饋、實際情形及未來的想法而改變。
當前版本的演算法會使ASF優先考慮Any標籤的Bot，特別是那些擁有更多種遊戲物品的Bot。 當用完Any Bot時，ASF將會依據相同的多樣性規則改為考慮Fair Bot。 ASF將至少嘗試匹配一次每個可用的Bot，以保證我們不會錯過可能的徽章套卡進度。
MatchActively會考慮您使用交易指令tbadd加入黑名單的Bot帳號，且不會嘗試匹配它們。 這能用來告訴ASF它不該匹配哪些Bot，即使它們可能有重複物品能提供我們使用。
ASF是也仍是免費且開源的，它是在2015年10月專案開始時建立的。 我們的程式也完全是非商業性的，我們不會從對其的貢獻、建置或發布的檔案中獲取任何收益。 在過去7年多的時間裡，ASF得到了巨大的發展，且在每個月的穩定版本中仍不斷地改進與增強，這主要由一個人⸺JustArchi⸺來完成的，無償付出。 我們唯一的資金來源來自於使用者的非強制性捐贈。
在很長的一段時間內，直到2022年10月，MatchActively功能一直是ASF核心的一部分，來提供所有人使用。 In October 2022, Valve, the company behind Steam, has put very severe rate limits on fetching inventories of other bots - which rendered previous functionality entirely broken, with no solution available. 因此，該功能必須從5.4.1.0版本的ASF核心中刪除。
MatchActively作為官方ItemsMatcher外掛程式的一部分涅槃重生，該外掛程式進一步增強了ASF的交換卡片主動匹配功能。 恢復MatchActively功能需要我們大量的工作來建立ASF後端，這是代管在伺服器上的全新服務，加入了超過一千個用於解析物品庫的代理節點，而所有的這些都是為了讓ASF用戶端能像以前一樣使用MatchActively。 因為涉及的工作量過大，且所用資源並不是免費的，需要我們每月付款（網域、伺服器、網路代理），我們決定只向我們的贊助者提供此功能，也就是說，那些已在每個月支援ASF專案的人。 我們的目標並不是從中獲利，而是支付本功能相關的月費⸺這就是為什麼我們基本上免費提供它，但我們仍需為此收取一點費用的原因，因為我們無法自掏腰包支付數百美元，只是為了讓您可以使用它。 我們希望您能夠理解。
ItemsMatcher在JustArchi的GitHub上作為$5美元或以上贊助階級的一部分提供。 只需成為$5美元（或更高）階級的贊助者，然後閱讀組態設定章節，以獲得並填寫LicenseID。
授權碼允許您向伺服器傳送有限數量的請求。 $5美元的階級允許您為一個帳號使用MatchActively，這應該適合大多數人。 $10美元的階級允許您在三個帳號上使用它。 若您需要更多資源，請聯絡我們。
