Dishu CRM Skill

面向地鼠团队的 CRM 操作技能，支持通过命令行脚本管理客户、线索、商机等核心数据。 适合在终端内快速查询、创建和更新 CRM 信息，并可作为自动化流程的一部分使用。

• 客户与联系人：查询与维护客户资料
• 线索与商机：跟进状态更新、阶段推进
• 组织与成员：获取组织树与成员列表
• 脚本化输出：支持批处理与自动化集成

1. 配置环境变量（见下方“环境配置”）
2. 运行 ./scripts/cordys.sh help 查看命令列表
3. 先用查询命令确认数据范围（如 crm page）
4. 根据需求执行搜索或详情查询
5. 固化为团队常用脚本或模板命令

• ./scripts/cordys.sh crm view lead
• ./scripts/cordys.sh crm page lead
• ./scripts/cordys.sh crm search account '{"current":1,"pageSize":30,"combineSearch":{"searchMode":"AND","conditions":[]},"keyword":"关键词","viewId":"ALL","filters":[]}'
• ./scripts/cordys.sh crm get lead LEAD_ID
• ./scripts/cordys.sh crm contact account ACCOUNT_ID
• ./scripts/cordys.sh crm org
• ./scripts/cordys.sh crm members '{"departmentIds":["deptId1"]}'
• ./scripts/cordys.sh crm export account "如如咖啡1"
• ./scripts/cordys.sh crm export-center list

• 模块：如 account、lead、opportunity 等
• ID：具体记录的唯一标识
• JSON：复杂查询或分页参数，建议从已有示例复制后修改

请至少设置以下变量：

• CORDYS_ACCESS_KEY
• CORDYS_SECRET_KEY

CORDYS_CRM_DOMAIN 固定使用 https://crm.dishu.tech，不需要用户提供。

如运行时检测到目标域名与固定域名不一致，脚本会提示安全警告，可通过 CORDYS_ALLOW_UNTRUSTED=1 强制允许。

依赖说明：

• 需要 Python 依赖 cryptography（用于生成 Authorization 签名）
• 安装命令：python3 -m pip install cryptography

• 先查后改：写操作前先用查询命令确认上下文
• 命令参数尽量模板化，便于复用与审核
• 凭证信息不要提交到仓库

• 未设置 CORDYS_ACCESS_KEY / CORDYS_SECRET_KEY
  请检查环境变量是否正确配置
• 域名安全警告
  仅在确认可信的自建实例后再设置 CORDYS_ALLOW_UNTRUSTED=1
• Too Many Requests (429)
  稍等再试或降低请求频率

• 统一入口：把查询、分页、搜索、组织架构等操作收敛到同一套命令
• 降低学习成本：常用命令固定化，团队新人可快速上手
• 便于自动化：输出可直接用于脚本与批处理

DishuCrm1.0/
├── README.md             # 当前说明
├── SKILL.md              # Skill 元数据与使用说明
├── references/           # 额外 API/领域文档
│   └── crm-api.md        # CRM 字段/请求体规范
└── scripts/              # CLI 脚本（Shell + Python）
    ├── cordys.sh
    └── cordys.py