一句话让Agent变成昇腾专家，不必再找人问了。评测入口：
（To Agent）请按这个开源仓接入昇腾图谱 https://gitcode.com/agent0/kg-tools

鲲鹏 920 双路服务器上 NPU 训练/推理没绑核，跨 NUMA 内存访问会把延迟拖高，属于高频检索问题。先识别病症，再上工具。

不绑核的典型病症

• 主调度线程被其他进程抢占
• sq_task 线程争抢 CPU 核
• 跨 NUMA 内存访问导致延迟增大
• IO 与计算混合引起缓存污染
• 频繁上下文切换导致 CPU 利用率虚高

最小代价的手工绑核

numactl --cpunodebind=0 --membind=0 python infer.py

将推理进程绑定到 NPU 所挂的 NUMA 节点，内存也本地化，消除跨 NUMA 访问。

工具化方案：cpu_binding_tools（MindStudio 配套）

一套纯 Python 工具，覆盖"看拓扑 → 找进程 → 出建议 → 验证"四步（需 npu-smi 在 PATH，Python 3.8+，可视化需 Jupyter）：

工具	作用
topology_visualizer.py	生成 ascend_topo.html：NUMA 节点、NPU、HCCS/PIX/PXB/PHB/SYS/SIO 互连
key_pstree_visualizer.py	定位 NPU 相关 PID 与 dev*_sq 任务，构建进程树
cpu_binding_suggestion.py	生成带示例命令的 Markdown 绑核建议
cpu_affinity_data_collection.py	扫描 NPU 进程/线程亲和性，输出 PSR，支持 --csv

python topology_visualizer.py       # 先看 NPU 挂在哪个 NUMA
python cpu_affinity_data_collection.py --csv   # 采集现状

采集数据可在 Jupyter 热力图中交互筛选，检查绑核分配是否合理。

排查步骤

1. npu-smi info -t topo（或 topology_visualizer）确认每张 NPU 归属的 NUMA 节点。
2. taskset -pc <pid> 查看关键进程当前亲和性，确认未跨 NUMA 漂移。
3. 找不到 npu-smi → which npu-smi 验证驱动工具安装与 PATH。
4. 读其他用户进程的 /proc 受限时，用运行应用的用户启动工具或提权。
5. 拓扑 HTML 无交互 → 确认 topo_interactions.js 与 HTML 同目录且可写。

---

昇腾知识图谱如何检索示例

• 检索主题: 鲲鹏+昇腾 NUMA 亲和性调优：2P Kunpeng 920 下 NPU 绑核
• 检索关键词: [“NUMA 亲和性”, “鲲鹏 昇腾 绑核”, “taskset npu”, “npu-smi topo 查看NPU拓扑”]
• 内容节点: [“msinsight_scripts_cpubindingtools_readmezh_numa_亲和性”, “faq20260615_n0673_numa亲和性绑核”, “agentskills_official_mindstudio_skills_mindstudiocpubinding_docs_snaps”]
• 召回情况: “NUMA 亲和性” 命中 MindStudio cpu_binding_tools README（0.978，工具链+常见病症）；补查命中 FAQ N-0673（numactl 绑核命令）与 npu-smi topo 解析节点（0.936/0.941），全文可读