CRM 项目管理

参考文档索引

第一步：收集凭据（每次对话开始时）

尚未获取凭据时，使用 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  n  --token 

验证成功输出 JSON：{"success": true, "token": "...", "base_url": "..."}

凭据在当前会话中复用，不要重复询问。

常见操作速查

脚本工具

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 project 
  --limit 25

crm_form_submit.py — 通用表单提交（使用 Token）

# 仅查看模板
python scripts/crm_form_submit.py 
  --base-url https://xxx 
  --token xxx 
  --view-id ProjectAdd 
  --template-only

# 提交新增
python scripts/crm_form_submit.py 
  --base-url https://xxx 
  --token xxx 
  --view-id ProjectAdd 
  --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