前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在构建智能体时，处理数学计算或系统建模是常见需求。队列论是系统性能评估的基础，但手动计算或编写模拟代码较为繁琐。xby-mm1-simulation 作为一个 Model Context Protocol (MCP) 服务器，提供了直接在 DSH 环境中调用队列模拟和理论计算的能力，能够帮助开发者快速评估系统吞吐量与延迟。
插件介绍¶
该插件由 xby-skill 维护，是一个开源的 MCP 服务器。它专注于 M/M/1 和 M/M/c 队列系统的模拟与分析，提供了一套完整的工具集，用于参数验证、理论指标计算、离散事件模拟以及结果对比。
核心功能¶
插件提供以下主要工具函数：
-
set_xby_apikey
在聊天中设置 API 密钥，该密钥会自动持久化保存，重启 DSH 进程后依然有效。 -
validate_config
检查 M/M/1 配置参数的有效性及系统稳定性。
- 参数：arrival_rate(λ)、service_rate(μ)、simulation_time。
- 返回：包含valid(布尔值)、errors(错误列表)、warnings(警告列表) 和utilization(利用率) 的字典。 -
calculate_metrics
使用精确公式计算 M/M/1 理论性能指标。
- 参数：arrival_rate(λ)、service_rate(μ)。
- 返回：包含利用率、平均队列长度、平均系统内人数、平均等待时间、平均系统时间的字典。
- 异常：当系统不稳定（λ >= μ）时，会抛出ValueError。 -
run_simulation
使用 SimPy 执行 M/M/1 队列模拟。
- 参数：arrival_rate、service_rate、simulation_time、random_seed。
- 返回：包含模拟指标、理论指标、对比分析及配置信息的字典。 -
compare_results
将模拟结果与理论值进行比较分析。
- 参数：模拟指标、arrival_rate、service_rate。
- 返回：包含逐项对比、平均绝对误差百分比、最大误差百分比、是否在 10% 范围内及准确度等级。 -
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 仓库。
