社保夯实率计算器

企业社保业务中，"社保夯实率"是衡量实缴基数与工资是否匹配的核心指标。客户发来员工社保数据后，人工计算耗时且容易出错：需要逐人核对基数与工资的差距，还要结合各城市缴费基数上下限判断差异是否合法。业务周报、月报和客户合规诊断都依赖这些数据，但手工处理难以快速定位问题员工。

核心能力

该技能围绕 scripts/calculate.py 脚本，提供四类输出：

• 多维度夯实率：人数夯实率（实缴基数 ≥ 工资×80% 的人数占比）、金额夯实率（Σ实缴基数 / Σ工资 × 100%）、个人夯实率均值
• 问题员工清单：标注低于 80% 红线的员工，以及差额超过 20% 的员工，按差额降序排列
• 城市维度分解：分城市对比夯实率，便于定位区域性偏差
• 合规性提示：结合各城市基数上下限，区分"法定封顶"与"人为低报"

工作流程

第一步：接收数据。 支持 .xlsx / .xls Excel 文件、.csv 文件、Tab 或逗号分隔的表格文本，以及聊天消息中粘贴的表格。数据至少包含三列：

• 城市（别名：地区、city、社保城市、缴纳城市、所在城市）
• 实缴基数（别名：实际基数、实际缴费基数、缴费基数、社保基数、actual_base）
• 工资（别名：应发工资、税前工资、月薪、申报工资、salary、应缴基数）

可选列包括姓名、身份证号，用于标识员工。若数据是聊天消息中的表格文本，先写入临时文件再执行脚本。

第二步：运行计算。 将数据传递给 scripts/calculate.py，脚本输出结构化文本报告。首次处理 Excel 文件需安装 openpyxl 依赖。

第三步：解读输出。 报告包含总体概况（员工总数、工资总额、实缴基数总额、总差额）、多维度夯实率、问题员工清单、合规提醒及各城市汇总。

业务规则与边界

• 标准夯实率为 100%，即理想情况下实缴基数等于工资；当前实操底线是 80%，低于此线的员工需重点关注。
• 城市基数上下限会自然导致夯实率 ≠ 100%。工资超过当地上限时，实缴基数被封顶，夯实率偏低属于合法情形，脚本会注明"法定封顶"。
• 差额比例 > 20% 的员工，无论是否合规都会被标注，以便客户了解整体偏差情况。
• 城市基数上下限数据内置在脚本的 CITY_LIMITS 字典中，同时维护在 references/city_limits.md，已收录 35+ 个主要城市 2025-2026 年度数据。如需更新城市数据，需同时修改这两个位置。