feat(mcp): add quarterly pyramid distribution lookup

2026-09-13 10:39:31 +08:00
parent db328c62dc
commit 7c8188df9c
8 changed files with 259 additions and 3 deletions
@@ -0,0 +1,15 @@
+# Pyramid distribution MCP
+Status: ready-for-agent
+
+按 region/delay 实时读取本季度个人 Pyramid 分布，按 >=3、1–2、0 分组。
+复用平台认证和 MCP 只读权限；缺失或非法计数不能当作零。
+验证 MCP 调用、边界值、输入/上游错误，并展示实时样例。不发布、不提交。
+
+## Comments
+
+- 已实现 get_pyramid_distribution(region, delay)，复用现有 WqClient 和 research:read。
+- 实测传日期后返回全零，日期参数语义尚未确认；最终使用已验证的无日期请求，period=platform_default，不宣称独立验证季度边界。
+- MCP 及新功能 20 项测试通过，Ruff / diff check 通过。使用内存数据库隔离认证令牌与审计，通过 MCP invoke 调用真实平台：USA/D1 已点亮0类、进行中5类、零计数11类。
+
+- 按用户新要求改为必传 current_date，自动计算完整自然季度，发送 startDate/endDate；不再使用默认周期。2026-09-13 对应 2026-07-01 至 2026-09-30。
+- 33 项测试通过（含四季度边界、跨年、闰日、日期校验），Ruff 通过。真实 MCP invoke：USA/D1 全零；GLB/D1 fundamental/risk 各3；AMR/D1 risk 为1，其余零。此前默认周期样例已被此次明确季度结果替代。