本技能的详细文档已按模块拆分到 references 目录:
| 模块 | 文件 | 说明 |
|---|---|---|
| ------ | ------ | ------ |
| 认证登录 | authentication.md | 登录接口、认证流程、凭据获取 |
| 基础工具 | base.md | Windows 编码问题、工具函数、请求方式 |
| 客户管理 | customer.md | 查询/创建客户、客户字段说明 |
| 客户跟进 | customer-follow.md | 查询/创建跟进、跟进字段说明、组合工作流 |
| 商机管理 | sale-chance.md | 查询商机、商机字段说明 |
| 日程管理 | schedule.md | 查询/创建日程、日程枚举值 |
| 报告生成 | report-workflow.md | 日报/周报/月报自动生成工作流 |
| 枚举参考 | enums.md | 公共枚举值(时间常量、dbType、操作符) |
| 安全注意 | security.md | 安全规范、注意事项、交互风格 |
使用 AskUserQuestion 工具一次性收集凭据参数:
AskUserQuestion({
questions: [
{ header: "平台地址", question: "CRM 平台的 base_url 是什么?", options: [{ label: "在下方输入平台地址", description: "在下方输入平台地址" }] },
{ header: "userId", question: "登录企业账号是什么?", options: [{ label: "在下方输入企业账号", description: "在下方输入企业账号" }] },
{ header: "email", question: "登录账号是什么?", options: [{ label: "在下方输入账号", description: "在下方输入账号" }] },
{ header: "密码", question: "登录密码是什么?", options: [{ label: "在下方输入密码", description: "在下方输入密码" }], inputType: "password" },
]
})
| 参数 | 说明 | 示例 |
|---|---|---|
| ------ | ------ | ------ |
base_url | 平台地址 | https://your-domain.com |
userId | 用户账号 | your_user_id |
email | 登录邮箱 | your_email |
password | 登录密码(原始明文,程序自动处理加密) | your_password |
| 字段 | 来源 | 说明 |
|---|---|---|
| ----- | ------ | ------ |
authToken | data.authToken | 接口鉴权 token |
JSESSIONID | 响应头 Set-Cookie | 会话 ID |
emp_id | data.id | 当前登录用户的员工 ID |
⚠️ Windows 中文编码问题:所有包含中文的请求必须通过 Python 脚本执行,详见 base.md。
⚠️ 请求方式:multipart/form-data 接口必须使用 curl --data-binary @-,urllib.request 会返回 500。
scripts/generate_reports.py — 日报/周报/月报自动生成脚本共 1 个版本