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

双缓冲是 AscendC 性能优化高频困惑点（邀测期 215 次）。根源：DataCopy 是异步 DMA，搬完立刻用 Vector 计算会读到未完成的数据。流水线 GM → MTE2 → UB → Vector → MTE3 → GM 必须显式同步。

自动同步（推荐）：TQue 的 EnQue/DeQue 自带硬件同步点——EnQue 标记就绪，DeQue 阻塞等待：

LocalTensor<half> x = inQueue.AllocTensor<half>();
DataCopy(x, gmInput[i * tileLen], tileLen);
inQueue.EnQue(x);              // 标记就绪
LocalTensor<half> xIn = inQueue.DeQue<half>();  // 阻塞等 MTE2
Adds(y, xIn, half(1.0), tileLen);
inQueue.FreeTensor(xIn);       // 用完立即释放

开启双缓冲靠 InitBuffer 的 num 参数：pipe.InitBuffer(inQueue, 2, tileLen * sizeof(half))——num=1 不开启，num=2 开启；len 不满 32 字节会自动向上补齐。一个 kernel 所有 Buffer 总数不超 64。流水排法：先 CopyIn(0) 预取，循环内 CopyIn(i+1) 与 Compute(i)、CopyOut(i) 重叠。

手动 SetFlag/WaitFlag 时机：无 TPipe/TQue、手动管 UB 时，用 HardEvent 事件对 pipe 间同步：

SetFlag<HardEvent::MTE2_V>(eventId);    // MTE2 侧标记
WaitFlag<HardEvent::MTE2_V>(eventId);   // Vector 侧等待

纪律：Set/Wait 必须同 eventID 同迭代配对，跨迭代 Set-Set 无 Wait 实测挂死（aclError:507014）；循环结束补 Wait 消费残留事件；eventID 配额有限（典型 8 个/核，与 TQue 共享）。V 内部顺序依赖（Cast→Add）用廉价 PipeBarrier<PIPE_V>，跨 pipe 可见性必须走事件。

双缓冲不生效排查：① num 仍为 1；② FreeTensor 太晚，buffer 被占住；③ CopyIn/Compute/CopyOut 三段串行没预取；④ AllocTensor 卡住=没有空闲 buffer。快速定位：临时加 PipeBarrier<PIPE_ALL>，若结果变正确即为同步问题。

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

• 检索主题: 昇腾 AscendC TQue 双缓冲流水线：EnQue/DeQue 自动同步与 SetFlag/WaitFlag 手动同步时机
• 检索关键词: [“AscendC队列 DeQue EnQue 同步”, “AscendC 双buffer 流水线 TQue InitBuffer”, “SetFlag WaitFlag 同步”]
• 内容节点: [“cannbotskills_ops_ascendcapibestpractices_references_apipipeline_enque_deque_队列同步”, “msinsight_docs_zh_userguide_sourcetuning_队列同步”, “ascendcskills_tests_data_基础api_资源管理_pipe和que框架_tpipe_initbuffer_ascendc_tque”, “ascendcskills_skills_usability_opgen_ascendoperatorguide_references_performance_setflag_waitflag_事件同步”]
• 召回情况: 3 组重放 query top10 全相关（API 最佳实践/调优指南/官方 API 文档），最高 score 0.966（SetFlag WaitFlag 事件同步）