association-path-analysis

Files (6)

• SKILL.md
• graph_query.md · references/
• path.md · references/
• router_card.json
• association_path_wrapper.py · scripts/
• test_association_path.sh · scripts/

SKILL.md (first lines)

# association-path-analysis

## 这个 skill 是做什么的

这个 skill 用于分析**两个号码之间的关联路径**，支持两层分析：

1. **direct_call_analysis**  
   基于电话网络原始通话边图，按**有向图**分析号码 A 是否能沿着通话方向到达号码 B。

2. **composite_analysis**  
   把三类关系联合起来做复合路径分析：
   - `call`（通话关系）
   - `shared_device`（共享设备关系）
   - `common_counterparty`（共同对端关系）

它不只是看“有没有通话路径”，而是分析两个号码在当前标准图数据内是否存在**多关系混合连接**。它不负责判断跨省同一真实实体，也不应替代 `dataset-quality-and-linkability-diagnostic` 的跨省可联动性诊断。

---

## 实际调用脚本

脚本位置：

`/mnt/skills/custom/phone-network-analysis/association-path-analysis/scripts/association_path_wrapper.py`

---

## 适合回答什么问题

当用户的问题属于下面这些类型时，优先使用本 skill：

- 帮我看这两个号码有没有关系
- 这两个号码之间怎么连起来的
- 这两个号码有没有间接联系
- 中间桥接号码是谁
- 除了通话关系以外，它们有没有设备共用或者共同对端
- 请做复合路径分析
- 两个号码是否通过共同设备或共同对端连起来
- 给我 Top-K 候选路径
- 给我桥接点排序和下一步调查建议

---

## 默认数据源

### 通话边图
- `/mnt/datasets/phone-network/processed/unified/call_edges.csv`

字段：
- `src_user_id`
- `dst_counterparty_id`

### 号码-设备图
- `/mnt/datasets/phone-network/processed/graph_views/unified/edges_phone_imei.parquet`

字段：
- `user_id`
- `imei`

---

## 默认行为

### 通话路径
默认按**有向图**分析，也就是优先保留真实通话方向：
- `src_user_id -> dst_counterparty_id`

### 复合路径
默认联合启用三类关系：
- `call`
- `shared_device`
- `common_counterparty`

---

## 参数说明

- `--phone-a`：号码 A
- `--phone-b`：号码 B
- `--analysis-mode`：
  - `direct_call`：只做有向通话路径分析
  - `composite`：只做复合关系路径分析
  - `both`：同时做直接配对信号 + 有向通话路径 + 复合路径分析
- `--max-hops`：复合路径搜索最大跳数
- `--top-k`：返回候选路径数量
- `--per-relation-limit`：每类关系最大扩展数
- `--max-expand-nodes`：复合搜索最大扩展节点数
- `--min-common-counterparty`：建立共同对端关系边的最低共同对端数
- `--directed-call`：是否按有向通话图分析（默认开启）

---

## 前端首测推荐参数

首次测试建议优先使用：

- `analysis_mode=both`
- `max_hops=3`
- `top_k=1`
- `per_relation_limit=20`
- `max_expand_nodes=500`
- `min_common_counterparty=2`

如果第一轮稳定返回，再逐步放宽到：

- `top_k=3`
- `per_relation_limit=30`
- `max_expand_nodes=800`

不建议首次直接请求 Top-3 候选路径、桥接点全量排序和超大范围复合搜索。

---

## 推荐输出内容

前端分析建议固定输出以下结构：

1. 直接配对信号
   - A 是否直接打给 B

From bettercallfan/deerflow, MIT.

More from bettercallfan/deerflow