ItemsMatcherPlugin zh TW
ItemsMatcherPlugin是ASF官方的外掛程式，使用ASF STM名單來擴充ASF的功能。 特別是這包含了RemoteCommunication中的PublicListing，及TradingPreferences中的MatchActively。 ASF發行版本附隨了ItemsMatcherPlugin，因此能夠立即使用。
顧名思義，公開名單是當前可供使用的ASF STM Bot的名單。 它位於我們的網站上進行自動管理，並作為一項公共服務，提供使用MatchActively的ASF使用者及手動比對的ASF與非ASF使用者使用。
如果要被列在名單中，您需要滿足一系列的需求。 在最低情形下，您必須在PublicListing中允許PublicListing（預設設定）、在TradingPreferences中啟用SteamTradeMatcher、在隱私設定中公開您的物品庫、帳號不受限制，且啟用ASF雙重驗證。 額外需求包含了至少啟用15天的雙重驗證、5天以內未更改密碼、沒有任何帳號限制，例如功能限制、商業行為封鎖或交易封鎖等。 當然，您需要至少擁有一件符合MatchableTypes的物品，例如交換卡片。 除此之外，考量到會造成過重的負擔，我們不接受擁有超過500000物品的Bot。我們建議您遇到這種情形時，將您的物品庫拆分至數個帳號中。
雖然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中設定至少一項有效的類型，例如交換卡片。 額外需求包含了至少啟用15天的雙重驗證、5天以內未更改密碼、沒有任何帳號限制，例如功能限制、商業行為封鎖或交易封鎖等。
若您滿足了上述需求，ASF將會定期與我們的ASF STM公開名單通訊，以主動比對當前可用的Bot。
在比對期間，ASF Bot將會提取自己的物品庫，然後與我們的伺服器通訊，來從其他當前可用的Bot中找到所有可能的MatchableTypes比對。 由於直接與我們的伺服器通訊，這個過程只需一個請求，我們就可以立即了解是否有任何可用的Bot能夠提供我們感興趣的東西⸺如果找到比對物品，ASF將自動發送並確認交易提案。
本模組是透明的。 比對將在ASF啟動後約1個小時後開始，並且每8個小時重複一次（如果需要）。 MatchActively功能旨在作為一種長期的、定期的措施，用來確保我們積極朝著收集完整套的目標邁進。不過不是24小時都在執行ASF的使用者，也可以考慮使用match指令。 這個模組的目標使用者是主要帳號及「用於存放物品的」備用帳號，但亦可被任何未設定成MatchEverything的Bot使用。 除此之外，考量到會造成過重的負擔，我們不接受擁有超過500000物品的Bot。我們建議您遇到這種情形時，將您的物品庫拆分至數個帳號中。
ASF會盡力將使用該選項產生的請求量及壓力降至最低，同時盡可能提高比對效率。 比對Bot及組織整個流程的演算法是ASF的實作細節，並且可以依據回饋、實際情形及未來的想法而改變。
當前版本的演算法會使ASF優先考慮Any標籤的Bot，特別是那些擁有更多種遊戲物品的Bot。 當用完Any Bot時，ASF將會依據相同的多樣性規則改為考慮Fair Bot。 ASF將至少嘗試比對一次每個可用的Bot，以保證我們不會錯過可以獲得的徽章套卡進度。
MatchActively會考慮您使用tbadd指令加入交易黑名單的Bot帳號，且不會嘗試去比對它們。 這能用來告訴ASF它不該比對哪些Bot，即使它們可能有重複物品能提供我們使用。
ASF也會盡力使交易提案順利完成。 在下一輪比對中（通常在6小時內），ASF將會取消任何尚未被接受的交易提案，降低對方的Steam ID優先級，並在之後會優先選擇更活躍的Bot。 儘管如此，如果低優先級的Bot是具有我們所需的比對項目的最後一個Bot，我們仍會（再次）嘗試比對他們。
ASF是也仍是免費且開源的，如同在2015年10月專案建立時所確立的那樣。 ItemsMatcher外掛程式的原始碼與MatchActively在我們的儲存庫中提供，且ASF完全屬於非商業性程式，我們不會從對它的貢獻、組建或發布中獲取任何利益。 在過去7年多的時間裡，ASF得到了巨大的發展，且在每個月的穩定版本中仍不斷地改進與增強，這主要由一個人⸺JustArchi⸺來完成的，無償付出。 我們唯一的資金來源來自於使用者的非強制性捐贈。
在很長的一段時間內，直到2022年10月前，MatchActively功能一直是ASF核心的一部分，來提供所有人使用。 在2022年10月時，Steam背後的公司，Valve，對提取其他Bot的物品庫設定了非常嚴格的速率限制，使得原先的功能完全崩潰，且沒有任何可行的解決方案。 因此，由於該功能已完全失效且無法修復，作為過時功能，已從ASF核心中移除。
MatchActively作為官方ItemsMatcher外掛程式的一部分涅槃重生，該外掛程式進一步增強了ASF的交換卡片主動比對功能。 恢復MatchActively功能需要我們大量的工作來建立ASF後端，這是代管在伺服器上的全新服務，加入了超過一百個用於解析物品庫的付費代理節點，而所有的這些都是為了讓ASF用戶端能像以前一樣使用MatchActively。 因為涉及的工作量過大，且所用資源並不是免費的，需要我們每月付款（網域、伺服器、網路代理），我們決定只向我們的贊助者提供此功能，也就是說，那些已在每個月支援ASF專案的人。感謝他們，我們才能夠使用並提供這些付費資源。
我們的目標並不是從中獲利，而是支付本功能相關的月費⸺這就是為什麼我們基本上算是無償提供它，但仍需為此收取一點費用的原因。我們無法每個月都自掏腰包支付數百美元，而卻只是為了讓您可以使用它。 我們並不是真的在當商品討論售價，而是因為Valve把這些成本強加於我們之上，而我們的另一種選擇，是根本完全不提供這項功能。如果您出於任何原因，無法認為我們外掛程式的使用條款是合理的，您也可以選擇完全不使用本功能。
不論如何，我們了解不是每個人都支持MatchActively，但我們希望您仍能理解為什麼我們無法免費提供它。
ItemsMatcher在JustArchi的GitHub上作為每月$5美元或以上贊助階級的一部分提供。 您也可以成為一次性贊助者，但在這種情形下，授權的有效期限只有一個月（可以再次贊助來延期）。 只要成為$5美元（或更高）階級的贊助者後，閱讀組態設定章節，以獲得並填寫LicenseID。 之後，您只需在您要啟用的Bot的TradingPreferences中啟用MatchActively即可。
授權碼允許您向伺服器傳送有限數量的請求。 $5美元的階級允許您為一個Bot帳號使用MatchActively（每天4次請求），且每增加$5美元，就能多使用兩個Bot帳號（每天多8次請求）。 舉例來說，若您想要在三個帳號上使用它，就必需使用$10美元或以上的階級。
