xby-skill/xby-mm1-simulation

xby-mm1-simulation

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

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

功能

- set_xby_apikey — 在聊天中设置 API 密钥（自动持久化，重启有效）
- validate_config — 验证 M/M/1 配置参数

检查参数有效性和系统稳定性条件。

参数：
arrival_rate：顾客到达率（λ）
service_rate：服务率（μ）
simulation_time：模拟时长

返回：
包含验证结果的字典：
- valid：布尔值
- errors：List[str]（如果有）
- warnings：List[str]（如果有）
- utilization：浮点数（如果有效）
- calculate_metrics — 计算理论 M/M/1 性能指标

使用精确公式计算稳态性能。

参数：
arrival_rate：λ（每时间单位的顾客数）
service_rate：μ（每时间单位的顾客数）

返回：
理论指标字典：
- utilization：ρ = λ/μ
- avg_queue_length：L_q = ρ²/(1-ρ)
- avg_num_in_system：L = ρ/(1-ρ)
- avg_waiting_time：W_q
- avg_system_time：W

抛出：
ValueError：如果系统不稳定（λ >= μ）
- run_simulation — 使用 SimPy 运行 M/M/1 队列模拟

执行离散事件模拟并返回性能指标。

参数：
arrival_rate：λ（每时间单位的顾客数）
service_rate：μ（每时间单位的顾客数）
simulation_time：模拟时长
random_seed：用于可复现性的随机种子

返回：
包含以下内容的字典：
- simulation_metrics：模拟值的字典
- theoretical_metrics：精确值的字典
- comparison：对比分析
- config：使用的模拟配置
- compare_results — 将模拟结果与理论值进行比较

通过将模拟结果与精确公式进行比较来分析模拟的准确性。

参数：
simulation_metrics：模拟性能指标的字典
arrival_rate：模拟中使用的 λ
service_rate：模拟中使用的 μ

返回：
对比分析，包含：
- comparisons：逐指标比较
- mean_abs_error_pct：平均误差
- max_error_pct：最大误差
- within_10pct：布尔值
- accuracy_grade：质量评估
- recommend_parameters — 为目标利用率推荐模拟参数

为给定的目标利用率水平建议合适的到达率、服务率和模拟时长。

参数：
target_utilization：期望的 ρ（默认值：0.7）
service_rate：固定的 μ（如果为 None，则建议 μ=10）
min_customers：要模拟的最小顾客数

返回：
推荐的参数和预期指标

安装

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

格式: dsh plugin --profile  add github:/
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 密钥。