xby-mm1-simulation

DeepSeek Harness (DSH) 的插件：队列模拟服务

一个用于M/M/1和M/M/c队列系统模拟和分析的Model Context Protocol服务器，提供全面的资源、工具和提示。

功能

• set_xby_apikey — 在聊天中设置 API 密钥（自动持久化，重启有效）
• validate_config — Validate M/M/1 configuration parameters

Checks parameter validity and system stability condition.

Args: arrival_rate: Customer arrival rate (λ) service_rate: Service rate (μ) simulation_time: Simulation duration

Returns: Dictionary with validation result: - valid: bool - errors: List[str] (if any) - warnings: List[str] (if any) - utilization: float (if valid)

• calculate_metrics — Calculate theoretical M/M/1 performance metrics

Uses exact formulas to compute steady-state performance.

Args: arrival_rate: λ (customers per time unit) service_rate: μ (customers per time unit)

Returns: Dictionary of theoretical metrics: - utilization: ρ = λ/μ - avg_queue_length: L_q = ρ²/(1-ρ) - avg_num_in_system: L = ρ/(1-ρ) - avg_waiting_time: W_q - avg_system_time: W

Raises: ValueError: If system is unstable (λ >= μ)

• run_simulation — Run M/M/1 queue simulation using SimPy

Executes discrete event simulation and returns performance metrics.

Args: arrival_rate: λ (customers per time unit) service_rate: μ (customers per time unit) simulation_time: Duration of simulation random_seed: Random seed for reproducibility

Returns: Dictionary with: - simulation_metrics: Dict of simulated values - theoretical_metrics: Dict of exact values - comparison: Comparison analysis - config: Simulation configuration used

• compare_results — Compare simulation results with theoretical values

Analyzes accuracy of simulation by comparing against exact formulas.

Args: simulation_metrics: Dictionary of simulated performance metrics arrival_rate: λ used in simulation service_rate: μ used in simulation

Returns: Comparison analysis with: - comparisons: Per-metric comparison - mean_abs_error_pct: Average error - max_error_pct: Maximum error - within_10pct: bool - accuracy_grade: Quality assessment

• recommend_parameters — Recommend simulation parameters for target utilization

Suggests appropriate arrival rate, service rate, and simulation time for a given target utilization level.

Args: target_utilization: Desired ρ (default: 0.7) service_rate: Fixed μ (if None, suggests μ=10) min_customers: Minimum customers to simulate

Returns: Recommended parameters and expected metrics

安装

方式一：从 GitHub 直接安装（推荐）

# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-mm1-simulation

方式二：从本地目录安装（开发模式）

# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-mm1-simulation

方式三：通过 cordis.patch.yml 开发调试

dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml

配置

获取 API 密钥

前往 小笨羊官网 注册并获取 API 密钥。