xby-mm1-simulation

Readme

# 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 直接安装（推荐）

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

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

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

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

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



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。