35CRM基金管理统计

解决业务侧的取数与排版痛点

在 35CRM 的日常运营中，基金管理人员经常需要拉取当前周期的合同金额、新增回款和客户流转情况。如果手动在后台点选报表，不仅要反复切换筛选条件，还得自行将接口返回的元换算为万元，并在沟通中手动排版数据。

该技能直接封装了底层取数逻辑，通过固定的脚本入口将多表关联查询和数据清洗整合在一起。

• 环境变量校验：脚本运行前会确保 CRM_BASE_URL 和 CRM_AUTH_TOKEN 就绪，凭据在会话期间复用，减少重复授权。
• 复杂数据解析：接口返回的数值通常带有千位分隔符（如 216,908,151），脚本内置了 safe_float() 函数进行安全解析，避免直接用 float() 解析导致语法错误。
• 单位自动转换：所有金额类指标在接口层单位为元，脚本会自动执行除以 10000 的操作，直接输出符合财务习惯的万元数值。

核心处理流程

技能的核心逻辑集中在 month_stat.py，通过 POST 方式向 /report/monthStat 发送 multipart/form-data 请求。

1. 参数映射：通过 --view 参数切换两种看板视图。summary 视图侧重短期现金流（总业绩、总进款）；performance 视图侧重资产盘存（持仓金额、退出金额）。
2. 时间常量控制：利用 --search-param 指定维度，如 THIS_MONTH 或 THIS_YEAR，精准控制报表统计区间。
3. 卡片渲染：查询成功后会调用 show_widget 工具，将处理后的 JSON 指标映射为可视化看板。月度摘要采用三列布局，经营业绩采用 2×2 网格布局。

适用边界与安全红线

在接入现有系统时，需要注意该技能的读写边界和认证机制：

• 只读查询：该技能仅覆盖统计查询功能，不具备任何写入、修改或删除合同的权限，适合在审计要求严格的环境中使用。
• Token 失效处理：如果 CRM_AUTH_TOKEN 过期，接口可能返回 HTML 页面或 success: false。此时技能会强制中断流程并提示更新，严禁自动尝试登录或猜测凭据，以防触发账号风控。
• 编码一致性：由于接口涉及大量中文字段，必须通过 Python 的 subprocess 发起请求，避免使用 curl 导致的字符集乱码问题。