35CRM API（全功能技能）

本技能已整合所有子技能功能，提供 CRM 平台的完整 API 操作能力。

平台信息

平台名称: 互联网+AI时代平台型CRM

模块覆盖

所有模块的接口路径和 viewId 映射见 module_config.json，包含：

viewIdMap：模块名 → 新增表单 viewId
listPathMap：模块名 → 列表查询接口路径
insertPathMap：模块名 → 新增接口路径

支持的模块（31 个）

| 分类 | 模块 | |------|------| | 客户管理 | customer · customer_follow · contact | | 竞争对手 | competitor · competitor_dynamic | | 商机管理 | sale_chance · sale_chance_follow · chance_task · quotation | | 销售线索 | sales_lead · sales_lead_follow | | 合同管理 | agree_ment · agree_ment_follow | | 订单管理 | contract_order · contract_order_follow · pay_plan · invoice | | 项目管理 | project · project_task · project_follow | | 设备管理 | device_archive · device_bom | | 维保管理 | install_task · repair_task · maintain_task | | 服务管理 | customer_serve · customer_serve_feed_back · customer_complaints · customer_revisit | | 工作管理 | schedule · plan_summary |

参考文档

基础文档（通用）

| 文件 | 说明 | |------|------| | authentication.md | 登录接口、认证流程、凭据获取 | | base.md | Windows 编码、工具函数 | | enums.md | 公共枚举值（时间常量、dbType、操作符）、列表查询通用参数 | | security.md | 安全规范、注意事项、交互风格 | | report-workflow.md | 日报/周报/月报自动生成流程 | | module_config.json | 所有模块的 viewId/listPath/insertPath 映射 |

复杂模块文档（有特殊字段/枚举）

| 文件 | 说明 | |------|------| | customer.md | 客户字段说明、状态/类型枚举 | | customer-follow.md | 跟进方式、客户阶段/种类枚举 | | contact.md | 联系人类型、性别、角色枚举 | | schedule.md | 日程时间格式、关联类型枚举 | | sale-chance.md | 商机阶段枚举 | | agreement.md | 合同阶段、付款方式枚举 |

快速开始

信息收集

使用 AskUserQuestion 工具一次性收集凭据参数：

AskUserQuestion({
  questions: [
    { header: "平台地址", question: "CRM 平台的 base_url 是什么？", options: [{ label: "在下方输入平台地址", description: "例如 https://crm.example.com" }] },
    { header: "userId",   question: "登录企业账号是什么？", options: [{ label: "在下方输入企业账号", description: "在下方输入企业账号" }] },
    { header: "email",    question: "登录账号是什么？", options: [{ label: "在下方输入账号", description: "在下方输入账号" }] },
    { header: "密码",     question: "登录密码是什么？", options: [{ label: "在下方输入密码", description: "在下方输入密码" }] },
  ]
})

登录后获取的关键值

| 字段 | 来源 | 说明 | |-----|------|------| | authToken | data.authToken | 接口鉴权 token | | JSESSIONID | 响应头 Set-Cookie | 会话 ID | | emp_id | data.id | 当前登录用户的员工 ID |

脚本工具

| 脚本 | 功能 | |------|------| | scripts/crm_login.py | 登录获取 authToken + JSESSIONID + emp_id | | scripts/crm_query.py | 通用查询脚本，支持所有模块的列表查询 | | scripts/crm_form_submit.py | 通用表单提交脚本（模板缓存 → 解析 → 提交） | | scripts/generate_reports.py | 日报/周报/月报自动生成 |

命令行用法示例

# 登录
python scripts/crm_login.py \
  --base-url https://xxx \
  --user-id xxx --email xxx --password xxx

# 查询任意模块列表（module_id 从 module_config.json 获取）
python scripts/crm_query.py \
  --base-url https://xxx \
  --jsessionid xxx --auth-token xxx \
  --module-id competitor

# 新增任意模块数据（viewId 从 module_config.json 获取）
python scripts/crm_form_submit.py \
  --base-url https://xxx \
  --jsessionid xxx --auth-token xxx \
  --view-id CompetitorAdd \
  --data '{"name":"测试竞争对手"}'

# 生成日报
python scripts/generate_reports.py day \
  --base-url https://xxx \
  --user-id xxx --email xxx --password xxx

通用操作流程

查询列表

登录获取 authToken、JSESSIONID、emp_id
从 module_config.json 获取模块的 listPathMap 路径
调用 scripts/crm_query.py 或使用 crm_query.py 中的 query() 函数
通用参数见 enums.md

新增数据

登录获取凭据
从 module_config.json 获取模块的 viewIdMap 和 insertPathMap
调用 scripts/crm_form_submit.py 加载模板
提交数据

重要：技能目录规范

⚠️ 技能目录仅包含定义文件，不含任何用户数据或运行结果

所有查询结果、生成的报告、临时文件，必须保存到 workspace 或用户指定目录
禁止将任何运行输出写入 skills/crm-uniproud-api/ 及其子目录