下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-r4wuabfo--crm-saleslead-mgmt.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-r4wuabfo/crm-saleslead-mgmt。35CRM 线索管理模块,涵盖销售线索、线索跟进两大功能。
阅读全文 (展开查看完整说明)
概述
CRM 线索管理
参考文档索引
| 分类 | 文件 | 说明 |
|---|---|---|
| 认证 | [authentication.md](references/authentication.md) | Token 认证流程、请求规范 |
| 基础 | [base.md](references/base.md) | 工具函数、编码规范 |
| 枚举 | [enums.md](references/enums.md) | 时间常量、dbType、searchCondition 通用结构 |
| 销售线索 | [sales_lead.md](references/sales_lead.md) | 查询销售线索列表、新增销售线索 |
| 线索跟进 | [sales_lead_follow.md](references/sales_lead_follow.md) | 查询线索跟进列表、新增线索跟进 |
第一步:收集凭据(每次对话开始时)
尚未获取凭据时,使用 AskUserQuestion 工具一次性收集 2 个参数:
AskUserQuestion({
questions: [
{ header: "平台地址", question: "CRM 平台的 base_url 是什么?",
options: [{ label: "在下方输入平台地址", description: "例如 https://crm.example.com" }] },
{ header: "Token", question: "API Token (PAT) 是什么?",
options: [{ label: "在下方输入 Token", description: "在下方粘贴 Token 字符串" }] },
]
})收集到凭据后,调用 scripts/crm_login.py 验证 Token 有效性:
python scripts/crm_login.py n --base-url <base_url> n --token <token>验证成功输出 JSON:{"success": true, "token": "...", "base_url": "..."}
凭据在当前会话中复用,不要重复询问。
常见操作速查
| 操作 | 接口 | 参考文档 |
|---|---|---|
| 查询销售线索列表 | POST /salesLead/list | sales_lead.md |
| 新增销售线索 | viewId=SalesLeadAdd → POST /salesLead/insert | sales_lead.md |
| 查询线索跟进列表 | POST /SalesLeadFollow/list | sales_lead_follow.md |
脚本工具
crm_login.py — 验证 Token
python scripts/crm_login.py n --base-url https://xxx n --token xxx输出:{"success": true, "token": "...", "base_url": "..."}
crm_query.py — 通用查询(使用 Token)
python scripts/crm_query.py
--base-url https://xxx
--token xxx
--module-id sales_lead
--limit 25crm_form_submit.py — 通用表单提交(使用 Token)
# 仅查看模板
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id SalesLeadAdd
--template-only
# 提交新增
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id SalesLeadAdd
--data '{"name":"测试线索"}'关键注意事项
- 中文编码:所有含中文的请求必须通过 Python 脚本执行,不能用 Bash 直接 curl(详见 base.md)
- multipart 请求:使用
curl --data-binary @-通过 subprocess 发送 - 日期格式:提交格式必须为
Y-m-d H:i:s(含时间部分),如2026-06-05 00:00:00 - 响应数据位置:解析时用
resp.get('rows') or resp.get('data') or [] - 新增操作:使用通用表单流程(
scripts/crm_form_submit.py):view/form → 解析字段 → insert