用途：Portfolio Dashboard 用于跨多个建筑项目聚合与分析数据，提供组合层面的可见性，跟踪 KPI、识别趋势、比较项目绩效，并支持战略资源分配决策。
主要能力：定义 ProjectStatus（规划、进行、暂停、完成、取消）与 HealthStatus（绿、黄、红、灰）状态；ProjectMetrics 汇聚合同额、完成百分比、进度、成本（预算、实际、预测、CPI、SPI）、安全（可记录事故、总工时、TRIR）、质量（缺陷、返工成本）与风险（风险分、关键风险）等指标，并按阈值自动判定项目健康度。PortfolioSummary 汇总项目总数、活跃项目数、合同总额、预算、实际成本、预测成本、加权平均 CPI/SPI、按预算与进度达标百分比、组合 TRIR、事故总数、健康分布与成本/进度趋势。
使用方式：通过 add_project 添加或更新单个项目，用 import_projects 从数据批量导入并计算派生指标（成本偏差、进度偏差天数、TRIR）。调用 calculate_portfolio_summary 获取组合汇总，compare_projects 按指定指标（如 cpi、spi、percent_complete、cost_variance、trir、risk_score）比较项目并给出均值、最优与最差，get_projects_at_risk 返回需关注项目，get_top_risks 返回组合级最高风险，forecast_cash_needs 按剩余工作线性预测未来若干月现金需求。save_snapshot 保存当前状态用于趋势分析，generate_report 输出 Markdown 格式的组合仪表盘报告，包含执行摘要、绩效指标、健康分布、需关注项目表与 CPI 比较表。
适用场景：建筑企业或项目组合管理团队进行多项目集中监控、高层汇报与资源调配。
限制：资料未提供安装命令、部署要求、价格或平台支持等细节；健康判定阈值与预测逻辑为代码中固定实现，实际结果取决于导入数据质量。