水滴信用科创能力评估报告（STI 报告）

概述

基于水滴信用 MCP sti / data_query / data_risk 工具集，使用 scripts/generate_html.py 变量驱动生成器输出含仪表盘（SVG gauge）、雷达图（SVG radar）、行业排名等可视化的标准化 STI 评估报告。

MCP 依赖与配置

前置检查

执行本技能前，须确认以下水滴信用 MCP 服务均已配置：

检查方法：调用 mcp_sti_evaluate_sti_capability 确认返回 status_code: 1。若失败须提示用户配置 MCP。

MCP 配置方法

{
  "mcpServers": {
    "shuidi_data": {
      "url": "https://data.shuidi.cn/mcp?pname=${SHUIDI_MCP_PNAME}&pkey=${SHUIDI_MCP_PKEY}"
    },
    "shuidi_risk": {
      "url": "https://risk.data.shuidi.cn/mcp?pname=${SHUIDI_MCP_PNAME}&pkey=${SHUIDI_MCP_PKEY}"
    },
    "shuidi_qc": {
      "url": "https://qc.data.shuidi.cn/mcp?pname=${SHUIDI_MCP_PNAME}&pkey=${SHUIDI_MCP_PKEY}"
    },
    "shuidi_sti": {
      "url": "https://sti.data.shuidi.cn/mcp?pname=${SHUIDI_MCP_PNAME}&pkey=${SHUIDI_MCP_PKEY}"
    },
    "shuidi_bid": {
      "url": "https://bid.data.shuidi.cn/mcp/?pname=${SHUIDI_MCP_PNAME}&pkey=${SHUIDI_MCP_PKEY}"
    }
  }
}

获取凭证：访问 水滴信用开放平台 申请 SHUIDI_MCP_PNAME 和 SHUIDI_MCP_PKEY。注入环境变量：

export SHUIDI_MCP_PNAME="your_project_name"
export SHUIDI_MCP_PKEY="your_project_key"

配置路径：~/.hermes/profiles/<profile>/mcp.json 或 ~/.hermes/config.yaml 的 mcp 字段。

依赖缺失处理

STI 报告对 MCP 依赖分级：
- 核心（缺一不可）：shuidi_sti、shuidi_data——缺失任一将导致科创评分和工商数据空白，报告无法生成
- 可选：shuidi_risk——缺失时风险维度标注「数据不可获取」，不影响核心报告生成

四轮执行模式

第一轮：数据采集（4 批并行）

首批（核心）：mcp_sti_evaluate_sti_capability、mcp_data_query_get_company_info、mcp_data_query_get_company_introduction

次批（股权人员）：mcp_data_query_get_company_partner、_investment、_employee、_controller

第三批（风险/资质/融资）：mcp_data_query_search_tax_credit、get_taxpayer_info、search_company_risk、get_company_honor、get_company_cert、mcp_sti_search_honor、mcp_data_query_search_funding_record

第四批（STI 分项）：mcp_sti_get_sti_invest_score、_output_score、_quality_score、_influence_score、_develop_score、mcp_sti_search_patent、_software_copyright、_trademark、_standard

详细工具覆盖与字段映射见 references/mcp-tools-directory.md、references/data-population-guide.md。

第二轮：报告生成（变量驱动）

🔴 使用 scripts/generate_html.py 变量驱动生成器，禁止复制旧模板后 sed 替换。

1. 将 MCP 查询结果填入脚本的数据字典区（COMPANY / STI / RANKINGS / SHAREHOLDERS / CONTROLLER / INVESTMENTS / MANAGEMENT / TAX / RISK / HONORS / CERTS / FUNDING / 五维度 STI_*）
2. 运行生成器：python3 scripts/generate_html.py <output_dir>
3. PDF：WHTML(filename='report.html').write_pdf('report.pdf', font_config=FontConfiguration())

第三轮：验证

强制执行（详见 references/pitfalls.md）：

# div 嵌套验证
python3 scripts/verify_nesting.py <output_dir>/report.html

# 表格闭合验证
grep -c '</table>' report.html  # 必须 = grep -c '<table' 数

# 仪表盘 SVG 验证
grep 'stroke-dashoffset' gauge_*.svg  # 必须 = 314.15
grep 'transform="rotate' gauge_*.svg   # 必须为空

pymupdf 检查关键页面：确保评级表在 1.3 节内、第二章无表格泄漏。

报告结构

样式规范

SVG 图表关键公式

仪表盘（Gauge）

• 弧线公式：dasharray = math.pi * 100 * score / 100（非 180/360 减半——已验证正确值为 π×100×s/100）
• 弧线起始点：stroke-dashoffset = 314.15（π×100），定位 9 点钟 = 左红起点
• 禁止 rotate：objectBoundingBox 渐变随旋转翻转；用 dashoffset 替代
• 指针公式：rotation = -90 + score * 1.8（覆盖 180° 弧）

雷达图（Radar）

• viewBox="-30 -25 460 450"，标签因子 1.10，防截断
• 无外框矩形（五边形顶点直接连目标分值点）
• 满分基准线用浅色虚线

等级徽章

• width: 55px（非 40px），避免 AAA 被裁切
• 9 级评级表：AAA(95-100) / AA(85-94) / A(75-84) / BBB(65-74) / BB(60-64) / B(50-59) / CCC(40-49) / CC(30-39) / C(0-29)
• A 行不设背景高亮

关键陷阱

详细诊断与修复见 references/pitfalls.md。

验证清单

• [ ] 4 批 MCP 调用全部完成，数据填入数据字典
• [ ] f-string CSS 花括号全量转义
• [ ] 仪表盘：dashoffset=314.15，无 rotate，指针公式 -90+s*1.8
• [ ] 雷达图：viewBox 正确，无外框矩形
• [ ] 等级徽章 width=55px
• [ ] </table> 数 = <table 数
• [ ] .page div 零嵌套（verify_nesting.py 通过）
• [ ] 章间无 break-after 残留
• [ ] build_html() 返回前变量残留替换安全网
• [ ] PDF > 200KB（字体嵌入正常），< 700KB
• [ ] pymupdf 确认评级表在 1.3 节内，Ch2 无表格泄漏