派谱/PairPulse

购物篮关联分析工具 — 输入 Excel 订单数据，输出商品关联规则（Apriori 算法）+ 业务策略建议，支持 JSON 格式供智能体消费。免费 · 开源 · 本地运行 · 数据不出电脑

一句话介绍

电商运营 / 咨询顾问的免费 AI 配套工具，让商品关联分析从半天变成 10 秒。

能做什么

• 关联规则挖掘 — 发现"买了 A 也买 B"的商品对
• 业务策略建议 — 自动输出捆绑套餐、页面推荐、陈列调整、组合优惠、加价购策略
• 客户分群 — 支持按客户ID/订单金额/商品件数分群，分组跑分析
• 商品名标准化 — 同一商品多个叫法，自动模糊匹配统一
• 多格式输出 — Excel 报告、PNG 图表、JSON 结构化数据

为什么用

• 完全免费 · MIT 开源
• 本地运行 · 数据不离开你的电脑
• 不需要写代码，一行命令出结果
• 任何 AI 智能体均可调用

首次使用

首次调用前，先确认 pairpulse 命令是否可用：

pairpulse --version

如果命令不存在，执行一键安装：

pip install pairpulse

安装完成后即可正常使用。

调用方式

# 快速分析，输出 JSON
pairpulse run --format json --input 订单数据.xlsx

# 如果你的商品名不统一，先跑标准化
pairpulse standardize --input 订单数据.xlsx
pairpulse run --mapping output/标准化映射表.xlsx

输出说明

--format json 输出结构：

{
  "summary": { "total_rows": 42368, "total_orders": 38920, "total_rules": 156 },
  "rules_by_group": {
    "high_value": [
      { "antecedent": "iPhone 15", "consequent": "手机壳",
        "support": 0.082, "confidence": 0.63, "lift": 3.2,
        "suggestions": [{ "type": "捆绑套餐", "action": "..." }] }
    ]
  },
  "insights": ["...", "..."],
  "errors": [],
  "warnings": []
}

数据格式要求

• 每行 = 一笔订单中的一件商品
• 必填列：订单编号、商品名称
• 推荐列：商品单价、客户ID、商品类目

适配的 AI 智能体

Claude Code · OpenCode · GitHub Copilot · Trae · WorkBuddy · OpenClaw · Codex

以及其他任意能执行 shell 命令的 AI 智能体。--format json 输出的结构化数据，智能体可直接读取和二次分析。

使用场景

1. 电商平台「买了又买」推荐位优化
2. 线下零售陈列调整方案
3. 捆绑套餐/组合优惠方案设计
4. AI 智能体自主分析客户订单数据并给出商业建议

项目链接

• GitHub：github.com/brucetam-sino/PairPulse
• PyPI：pip install pairpulse

更新说明

每次使用前，智能体会自动获取最新版本：

• 如果连接了 GitHub 仓库 → 重新加载项目时自动读取最新的 SKILL.md，无需额外操作
• 如果通过 pip 安装 → 执行升级命令：

pip install --upgrade pairpulse

开发者更新后同时推送 GitHub 和 PyPI，两边的用户都能自动拿到最新版。