🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › CordysCRM
🦀 ClawHub

CordysCRM

by @fit2-zhao

Cordys CRM CLI 指令映射技能，支持将自然语言高效转换为标准 `cordys crm` 命令，具备意图识别、模块匹配、参数补全及分页与全量查询处理能力，输出简洁稳定、无歧义。

Versionv1.0.4
Downloads878
#crypto#can-make-purchases#requires-sensitive-credentials#clawhub
TERMINAL
clawhub install cordys-crm

📖 About This Skill

name: cordys-crm description: Cordys CRM CLI 指令映射技能，支持将自然语言高效转换为标准 cordys crm 命令，具备意图识别、模块匹配、参数补全及分页与全量查询处理能力，输出简洁稳定、无歧义。 environment: required: - CORDYS_ACCESS_KEY - CORDYS_SECRET_KEY - CORDYS_CRM_DOMAIN optional: [] security: requiresSecrets: true sensitiveEnvironment: true externalNetworkAccess: true notes: 此技能需要访问Cordys CRM API，使用X-Access-Key和X-Secret-Key进行身份验证。请确保只向可信的CORDYS_CRM_DOMAIN发送请求。

Cordys CRM CLI 使用说明

Cordys CRM CLI 指令映射技能，本技能用于将自然语言需求精准转换为可执行的 cordys crm 标准命令，确保输出稳定、可预测、无歧义。 【核心能力】

- 自动识别用户意图（列表 / 搜索 / 详情 / 跟进 / 原始接口） - 自动识别模块（lead / account / opportunity / contract 等） - 自动补全 JSON 参数 - 自动构造 filters / sort / combineSearch - 自动补充分页默认值 - 支持“查询全部/全部导出/拉全量”等语义下的自动翻页拉取 - 支持二级模块（如 contract/payment-plan,pool/account,pool/lead）

安装

clawdhub install cordys-crm

环境变量（必须）

此技能需要以下环境变量才能正常工作。这些变量可以通过两种方式提供：

1. 系统环境变量：直接设置在当前shell环境中 2. .env文件：在技能目录中创建.env文件（注意：此文件包含敏感信息，不应提交到版本控制）

必需变量

# 访问 Cordys CRM API 的必要信息：
CORDYS_ACCESS_KEY=你的 Access Key
CORDYS_SECRET_KEY=你的 Secret Key
CORDYS_CRM_DOMAIN=https://your-cordys-domain

安全注意事项

  • .env文件中的凭证是高度敏感的，应妥善保管
  • 建议使用环境变量而非.env文件，以避免凭证泄露
  • 定期轮换API密钥
  • 确保CORDYS_CRM_DOMAIN指向可信的Cordys CRM实例

    • ⚠️ 安全警告

    此技能需要敏感的环境变量（API密钥和域名）。请注意以下安全事项：

    1. 凭证安全：CORDYS_ACCESS_KEY 和 CORDYS_SECRET_KEY 是敏感凭证，请妥善保管 2. 域名验证：确保 CORDYS_CRM_DOMAIN 指向可信的Cordys CRM实例 3. 网络请求：此技能会向指定的域名发送HTTP请求，包含您的API凭证 4. raw命令风险：使用 cordys.sh raw 命令时，脚本会将您的凭证发送到指定的URL。请勿向不受信任的域名发送请求 5. 环境隔离：建议在受控环境中使用此技能，避免凭证泄露

    建议仅在信任的Cordys CRM实例上使用此技能，并定期轮换API密钥。

    CLI 版本选择

    本项目提供两个版本 CLI：

    | 版本 | 推荐程度 | 说明 | |--------------------------|----|----| | Shell 版本 cordys.sh | 推荐 | 无需 Python，执行更轻量 | | Python 版本 cordys.py | 备用 | 需要 Python3 + requests |

    目录结构里，scripts/ 目录存放这两个 CLI 实现，标准化排列为： 

    scripts/
├── cordys.sh       # 优先的 Shell 可执行脚本
└── cordys.py    # 不支持 Shell 时可选择 Python 实现

    默认优先使用 Shell 版本。

    Python 版本仅在以下情况使用：

  • 系统不支持 Bash
  • Windows 环境
  • Shell CLI 不可用

    • 基本流程

    1. 明确意图：列出/搜索/获取/跟进。 2. 指定目标模块（如 lead、opportunity）。 3. 根据需求补充关键词、过滤条件、排序或分页参数。 4. 确认是否需要 JSON body（如 search、follow plan、raw）。 5. 说明期望的输出形式（简短摘要/全部字段/只要某字段）。

    指令映射（常用）

    | 场景 | 建议命令 | 备注 | |----------|---------------------------------------------------|--------------------------------------------------------| | 列表或分页查看 | cordys.sh crm page ["keyword"] | 若用户只提关键词，会自动构造 {keyword:..., current:1, pageSize:30} | | 全局搜索 | cordys.sh crm search | 需 combineSearch、filters、sort，可补全默认值 | | 详情 | cordys.sh crm get | 直接拉取记录 | | 跟进计划或记录 | cordys.sh crm follow plan 或 record | body 应包含 sourceId，计划还需要 status/myPlan | | 原始接口 | cordys raw [] | 用于自定义端点或二级模块，如 /contract/payment-plan |

    常用示例

    # 分页查询线索列表（默认分页参数）
cordys.sh crm page lead

    分页查询商机列表（默认分页参数）
    
cordys.sh crm page opportunity

    分页查询客户列表（默认分页参数）
    
cordys.sh crm page account
    分页列表（带关键词）
    
cordys.sh crm page lead "测试"
    搜索（完整 JSON）
    
cordys.sh crm search opportunity '{"current":1,"pageSize":30,"combineSearch":{"searchMode":"AND","conditions":[]},"keyword":"电力","filters":[]}'
    跟进计划
    
cordys.sh crm follow plan account '{"sourceId":"123","current":1,"pageSize":10,"status":"UNFINISHED","myPlan":false}'
    获取组织架构
    
cordys.sh crm org
    查询产品
    
cordys.sh crm product "测试产品"
    获取联系人
    
cordys.sh crm contact account "927627065163785"

    二级模块支持

    Cordys CRM 部分资源属于二级模块。

    例如：

    
 #查询回款计划的分页列表，支持传入关键词/JSON body，实际上调用的是 POST /contract/payment-plan/page。
 cordys.sh crm page contract/payment-plan
 
 #查询发票的分页列表，通过 POST /invoice/page 获取，每个条件都可以通过 filters 精细控制。
 cordys.sh crm page invoice 
 
 #检索工商抬头列表，同样支持关键词/filters。
 cordys.sh crm page contract/business-title 
 
 #查看回款记录列表，可结合关键词、filters 或 viewId 进行精细筛选。
 cordys.sh crm page contract/payment-record 
 
 # 查看线索池中的线索，可结合关键词、filters 或 viewId 进行精细筛选，必填属性是 poolId 通过 lead-pool 接口获取。
 cordys.sh crm page pool/lead '{"current":1,"pageSize":30,"sort":{},"combineSearch":{"searchMode":"AND","conditions":[]},"keyword":"","poolId":"必填项，通过 lead-pool API 获取","viewId":"ALL","filters":[]}'
 
 #查看线索池中的线索，可结合关键词、filters 或 viewId 进行精细筛选，必填属性是 poolId 通过 account-pool 接口获取。
 cordys.sh crm page pool/account '{"current":1,"pageSize":30,"sort":{},"combineSearch":{"searchMode":"AND","conditions":[]},"keyword":"","poolId":"必填项，通过 account-pool API 获取","viewId":"ALL","filters":[]}'

    深度 API 调用

    查看字段

    cordys.sh raw GET /settings/fields?module=account

    复杂过滤示例：

    cordys.sh crm search opportunity '{"filters":[{"field":"Stage","operator":"equals","value":"Closed Won"}]}'

    分页查询交互优化

    为了避免分页查询的交互断层，优先执行一次识别出的指令并返回结果： 1. 分页控制：默认 current=1、pageSize=30，根据响应判断是否有多页，如果有则提示用户是否要翻下一页。 2. 字段与输出范围：默认全部字段、摘要、特定字段组合。 3. 默认格式：表格或列表形式展示，除非用户特别说明要 JSON 或其他格式。

    高级技巧

  • 搜索命令需要完整 JSON，若用户只给关键词或简单条件，可自动补齐 current=1、pageSize=30、combineSearch={...}。
  • 过滤器格式为 {"field":"字段","operator":"equals","value":"值"}，排序格式为 {"field":"desc"}。
  • 支持二级模块（例如 contract/payment-plan、contract/payment-record），CLI 命令形式仍为 cordys.sh crm page 。
  • cordys.sh raw 可以按原始 GET/POST 访问 /settings/fields、/contract/business-title 等非标准接口。

    • 助手判断意图的提示词

  • “列表”/“分页查看”：映射到 page 指令；可补上关键词或 filters
  • “查询全部”/“全部数据”/“拉全量”/“查完所有页”：自动补充上翻页参数，并根据响应提示用户是否继续翻页
  • “搜索”/“筛选”：使用 search，补齐 JSON body
  • “查看详情”：用 get + 决定的 ID
  • “跟进”：「跟进计划」→ follow plan，「跟进记录」→ follow record

    • 日志与异常

  • CLI 默认读取 .env，也可通过前置环境变量覆盖。
  • 若返回 code 非 100200，要记录 message 并向用户说明。
  • 若返回 401 或 403，提示用户检查认证信息。

    • 问题反馈

    如有任何问题或建议，请通过以下方式联系我们：
  • GitHub Issues: https://github.com/1Panel-dev/CordysCRM-skills/issues