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