用途：swarm_predict 用于测试 Swarm Prediction 契约，模拟多模型聚合流程。它创建可配置的虚拟模型描述符，从目标字符串派生数值夹具，并通过加权聚合与一致性评分得出算术共识。该工具无状态，返回自包含结果字典；独立聚合工具也支持调用方提供的数值或分类值。
主要能力：predict 从目标派生数值并聚合；ensemble 合并 N 个合成或调用方提供的值；swarm_intelligence 在不执行模型的情况下演练虚拟模型描述符；consensus 计算一致比例与混合算术置信度。工具包括 create_prediction_swarm、aggregate_predictions、evaluate_consensus，均无副作用。
使用方式：需 Python 3.11+，在本地 OSS Agent Lab 检出中运行 pip install -e .。提供测试目标、正数 swarm 大小和 0 到 1 之间的阈值。参数包括 target、num_models（默认 5）、method（weighted_vote、majority_vote、mean，默认 weighted_vote）、threshold（默认 0.7）。CLI 示例：oss-lab run swarm_predict "BTC/USD price in 24h"，可加 --param num_models=10 --param method=majority_vote --param threshold=0.8。
输出包含 target、predictions、consensus、confidence、recommendation、swarm_id。recommendation 为 high_confidence_proceed、moderate_confidence_review 或 low_confidence_abstain。
限制：当前端到端专家不调用任何模型，结果不是预测。一致性比例与置信度是输入的算术结果，非校准预测准确率。不得用于金融、医疗、安全等重大决策。会拒绝 swarm 小于 1、空预测列表、未知方法或无效阈值。高置信度 proceed 仅为测试标签，不构成行动授权。