个人 CRM (dingtalk-workflow-personal-crm)

自动扫描钉钉日程、群聊和通讯录，提取联系人并维护关系热度分。
相比飞书版本，去掉邮件扫描（钉钉无邮箱），增加钉钉通讯录搜索作为联系人来源。

触发方式

"联系人管理"  "CRM"  "谁联系过我"  "多久没联系"  "联系人热度"  "关系管理"  "联系人"

热度分计算规则

总分 = 频率分 + 近期分 + 重要度分（0-100）

数据初始化

首次使用时，自动创建 aitable 数据表：

# 创建 Base
dws aitable base create --name "个人CRM" --yes -f json
# 返回 baseId，记为 <crm-base-id>

# 创建联系人主表
dws aitable table create --base-id <crm-base-id> --name "联系人" --yes -f json
# 返回 tableId，记为 <contacts-table-id>

# 创建互动记录表
dws aitable table create --base-id <crm-base-id> --name "互动记录" --yes -f json
# 返回 tableId，记为 <interactions-table-id>

# 添加业务字段（表创建后自动带一个"标题"primaryDoc字段，需额外添加业务字段）
dws aitable field create --base-id <crm-base-id> --table-id <contacts-table-id> --fields '[{"fieldName":"姓名","type":"text"},{"fieldName":"公司","type":"text"},{"fieldName":"职位","type":"text"},{"fieldName":"手机","type":"text"},{"fieldName":"userId","type":"text"},{"fieldName":"来源","type":"text"},{"fieldName":"关系类型","type":"text"},{"fieldName":"重要程度","type":"text"},{"fieldName":"热度分","type":"number"},{"fieldName":"最后联系时间","type":"date"},{"fieldName":"最后联系内容","type":"text"},{"fieldName":"备注","type":"text"}]' --yes -f json

dws aitable field create --base-id <crm-base-id> --table-id <interactions-table-id> --fields '[{"fieldName":"联系人姓名","type":"text"},{"fieldName":"联系人userId","type":"text"},{"fieldName":"互动时间","type":"date"},{"fieldName":"互动类型","type":"text"},{"fieldName":"互动摘要","type":"text"},{"fieldName":"涉及主题","type":"text"}]' --yes -f json

表1: 联系人 (contacts)

表2: 互动记录 (interactions)

工作模式

模式 1: 联系人初始化 — 从日程和通讯录导入

触发： "帮我建立个人CRM系统" / "初始化联系人管理"

工作流：

Step 1: 获取当前用户信息
└── dws contact user get-self --yes -f json

Step 2: 扫描近期日程，提取参与者
├── dws calendar event list --yes -f json → 所有日程
├── 逐个获取日程参与者:
│   dws calendar participant list --event "eventId" --yes -f json
└── 批量获取参与者详细信息（注意：contact user search 仅返回 userId 列表，需二次查询）:
    dws contact user get --ids "id1,id2,id3" --yes -f json

Step 3: 搜索群聊，提取群成员
├── dws chat search --query "关键词" --yes -f json
└── dws chat group members list --id "openConversationId" --yes -f json

Step 4: 写入联系人表
└── dws aitable record create --base-id <crm-base-id> --table-id <contacts-table-id> --records '[...]' --yes

Step 5: 计算热度分并更新
└── dws aitable record update --base-id <crm-base-id> --table-id <contacts-table-id> --records '[...]' --yes

模式 2: 互动记录导入

触发： "从日程导入互动记录" / "记录最近的联系人互动"

工作流：

Step 1: 获取指定时间范围的日程
└── dws calendar event list --yes -f json → AI 过滤时间范围

Step 2: 逐个获取日程详情和参与者
├── dws calendar event get --id "eventId" --yes -f json
└── dws calendar participant list --event "eventId" --yes -f json

Step 3: AI 为每个参与者生成互动记录
├── 互动类型：日程
├── 互动摘要：日程标题 + 描述
├── 涉及主题：AI 从日程描述中提取
└── 更新联系人的最后联系时间和热度分

Step 4: 批量写入互动记录并更新联系人
├── dws aitable record create --base-id <crm-base-id> --table-id <interactions-table-id> --records '[...]' --yes
└── dws aitable record update --base-id <crm-base-id> --table-id <contacts-table-id> --records '[...]' --yes

模式 3: 联系人查询

触发： "上个月谁联系过我？" / "XX公司的人我最后一次和谁聊过？"

工作流：

Step 1: 解析用户查询意图（按时间/公司/热度等维度）

Step 2: 查询 aitable 联系人表
└── dws aitable record query --base-id <crm-base-id> --table-id <contacts-table-id> --limit 50 --yes -f json

Step 3: AI 过滤和排序，格式化输出

查询示例：

模式 4: 超期提醒

触发： 自动执行 / "有没有需要跟进的联系人"

工作流：

Step 1: 查询所有重要程度=高或中且热度分 < 30 的联系人
└── dws aitable record query --base-id <crm-base-id> --table-id <contacts-table-id> --yes -f json

Step 2: 生成提醒列表

Step 3: 通过 DING 或群消息发送提醒
└── dws ding message send --robot-code "..." --users "manager6950" --content "N 个重要联系人需要跟进" --type "1" --yes

模式 5: 手动添加联系人

触发： "添加联系人 张三，XX公司，CTO"

工作流：

Step 1: 解析联系人信息（姓名、公司、职位等）

Step 2: 尝试在钉钉通讯录中匹配
├── dws contact user search --keyword "张三" --yes -f json
│   注意：返回格式为 {"userId":["id1","id2"]}，仅含 userId 列表，不含姓名等详细信息
│   或 dws contact user search-mobile --mobile "138..." --yes -f json
└── 如匹配到结果，用返回的 userId 获取完整信息:
    dws contact user get --ids "userId1,userId2" --yes -f json

Step 3: 如果匹配到，补充 userId 和详细信息；否则使用手动输入

Step 4: 写入联系人表
└── dws aitable record create --base-id <crm-base-id> --table-id <contacts-table-id> --records '[...]' --yes

模式 6: 热度分批量更新

触发： "更新所有联系人的热度分" / 自动定期执行

工作流：

Step 1: 查询所有联系人和互动记录
├── dws aitable record query --base-id <crm-base-id> --table-id <contacts-table-id> --limit 100 --yes -f json
└── dws aitable record query --base-id <crm-base-id> --table-id <interactions-table-id> --limit 500 --yes -f json

Step 2: AI 计算每个联系人的热度分（频率分 + 近期分 + 重要度分）

Step 3: 批量更新
└── dws aitable record update --base-id <crm-base-id> --table-id <contacts-table-id> --records '[...]' --yes

dws CLI 命令参考

获取当前用户

dws contact user get-self --yes -f json

搜索联系人

dws contact user search --keyword "张三" --yes -f json

按手机号搜索

dws contact user search-mobile --mobile "13800000000" --yes -f json

批量获取用户信息

dws contact user get --ids "user1,user2,user3" --yes -f json

搜索部门

dws contact dept search --keyword "技术部" --yes -f json

获取日程列表

dws calendar event list --yes -f json

获取日程详情

dws calendar event get --id "eventId" --yes -f json

获取日程参与者

dws calendar participant list --event "eventId" --yes -f json

搜索群聊

dws chat search --query "关键词" --yes -f json

获取群成员

dws chat group members list --id "openConversationId" --yes -f json

aitable 记录操作

# 创建联系人
dws aitable record create --base-id <crm-base-id> --table-id <contacts-table-id> --records '[{"cells":{"标题":"张三-XX科技","姓名":"张三","公司":"XX科技","重要程度":"高","热度分":65}}]' --yes -f json

# 查询联系人
dws aitable record query --base-id <crm-base-id> --table-id <contacts-table-id> --limit 50 --yes -f json

# 更新联系人
dws aitable record update --base-id <crm-base-id> --table-id <contacts-table-id> --records '[{"recordId":"rec_xxx","cells":{"热度分":75,"最后联系时间":"2026-04-06"}}]' --yes -f json

联动 Skill

注意事项

1. 所有 dws 命令必须加 --yes 标志
2. 钉钉通讯录搜索仅返回当前用户有权限查看的成员，非全量
3. 热度分更新建议每周自动执行一次（可通过 CronCreate 配置）
4. dws aitable record create/update 的 --records 参数必须是 JSON 数组格式
5. 联系人姓名可能存在通讯录和 aitable 不一致的情况，以 userId 作为唯一标识
6. 联系人搜索 contact user search 仅返回 userId 列表，不含姓名等详细信息。如需详细信息，需将返回的 userId 传入 contact user get --ids 获取完整信息
7. contact dept search 对小组织（个体户等）可能返回空结果，属正常现象

已知问题

1. contact user search 返回格式为 {"userId":["id1","id2"]} 而非完整用户信息，需二次查询 contact user get --ids 获取姓名、公司等详细信息
2. chat search 对没有匹配群聊的关键词返回空结果，属正常行为