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 密钥。