技能介绍

在构建 CRM 相关自动化脚本时，最棘手的不是单个接口的调用，而是认证、编码与请求方式的叠加。Uniproud CRM 的接口要求先通过登录换取 authToken 和 JSESSIONID，密码在程序内完成加密，意味着脚本里不能直接拼原始凭据发请求。Windows 环境下中文参数还会导致编码错乱，而 multipart/form-data 接口用 urllib.request 提交会直接返回 500。这些细节如果不处理，很容易在联调阶段反复踩坑。

技能如何工作

该技能将 Uniproud CRM 的 API 按业务模块拆分到 references 目录，每个模块对应一份文档，明确字段说明、枚举值和调用方式。认证部分通过 AskUserQuestion 一次性收集 base_url、userId、email、password，登录后从 data.authToken 取 token，从响应头 Set-Cookie 取会话 ID，并把 data.id 作为当前员工的 emp_id 保存下来。后续调用客户、跟进、商机、日程等接口时，脚本会带上这些凭据。

脚本工具与文档索引

scripts/generate_reports.py 负责日报、周报和月报的自动生成，把分散的跟进记录汇总成结构化内容。配套文档里，base.md 解释了 Windows 编码问题和请求方式的约束，security.md 列出了安全规范和交互风格，enums.md 提供了时间常量、dbType、操作符等公共枚举。report-workflow.md 则描述了报告生成的具体步骤。

适用边界

技能不负责客户数据的业务逻辑校验，也不自动执行日程提醒或商机推进。它只保证接口调用层能正确完成认证、传参和取值。遇到中文参数时必须走 Python 脚本，multipart/form-data 必须用 curl --data-binary @- 发起，否则请求会失败。适用范围集中在 Uniproud CRM 的查询、创建、跟进和报告生成场景，不涉及其他 CRM 平台。