前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在構建智能體時，處理數學計算或系統建模是常見需求。隊列論是系統性能評估的基礎，但手動計算或編寫模擬代碼較爲繁瑣。xby-mm1-simulation 作爲一個 Model Context Protocol (MCP) 服務器，提供了直接在 DSH 環境中調用隊列模擬和理論計算的能力，能夠幫助開發者快速評估系統吞吐量與延遲。

插件介紹¶

該插件由 xby-skill 維護，是一個開源的 MCP 服務器。它專注於 M/M/1 和 M/M/c 隊列系統的模擬與分析，提供了一套完整的工具集，用於參數驗證、理論指標計算、離散事件模擬以及結果對比。

核心功能¶

插件提供以下主要工具函數：

1. set_xby_apikey
   在聊天中設置 API 密鑰，該密鑰會自動持久化保存，重啓 DSH 進程後依然有效。

2. validate_config
   檢查 M/M/1 配置參數的有效性及系統穩定性。
   - 參數：arrival_rate (λ)、service_rate (μ)、simulation_time。
   - 返回：包含 valid (布爾值)、errors (錯誤列表)、warnings (警告列表) 和 utilization (利用率) 的字典。

3. calculate_metrics
   使用精確公式計算 M/M/1 理論性能指標。
   - 參數：arrival_rate (λ)、service_rate (μ)。
   - 返回：包含利用率、平均隊列長度、平均系統內人數、平均等待時間、平均系統時間的字典。
   - 異常：當系統不穩定（λ >= μ）時，會拋出 ValueError。

4. run_simulation
   使用 SimPy 執行 M/M/1 隊列模擬。
   - 參數：arrival_rate、service_rate、simulation_time、random_seed。
   - 返回：包含模擬指標、理論指標、對比分析及配置信息的字典。

5. compare_results
   將模擬結果與理論值進行比較分析。
   - 參數：模擬指標、arrival_rate、service_rate。
   - 返回：包含逐項對比、平均絕對誤差百分比、最大誤差百分比、是否在 10% 範圍內及準確度等級。

6. recommend_parameters
   爲指定利用率推薦模擬參數。
   - 參數：target_utilization (默認 0.7)、service_rate、min_customers。
   - 返回：推薦的參數配置及預期指標。

安裝與配置¶

在使用前，需要通過以下命令安裝插件：

dsh plugin --profile web add github:xby_skill/xby-mm1-simulation

安裝完成後，需在對話中調用 set_xby_apikey 工具，填入從小笨羊官網獲取的 API 密鑰。

注意事項¶

• 系統穩定性檢查：調用 calculate_metrics 時，如果輸入的到達率大於或等於服務率（λ >= μ），系統視爲不穩定，函數會拋出 ValueError。
• 權限範圍：DSH 插件以當前進程的權限運行，安裝前應檢查源代碼與許可證（MIT）。
• 依賴項：模擬功能依賴 SimPy 庫。

結語¶

xby-mm1-simulation 爲 DSH 智能體提供了標準化的隊列系統分析能力。通過理論計算與離散事件模擬的結合，開發者可以更直觀地評估系統性能。完整源碼及文檔可參考：GitHub 倉庫。