文档与源码速查

回答 安装、配置、行为原理 类问题时，先 按关键词归类，再按下表 打开 1～2 个最可能命中的路径 阅读，避免长时间无目的遍历。

使用步骤

1. 从用户问题中提取主题（对照下表左列或同类词）。
2. 解析 $QWENPAW_ROOT：以 which qwenpaw 得到可执行路径，若为 …/.qwenpaw/bin/qwenpaw 则源码根为其上三级目录（与 guidance skill 一致）；否则结合用户给出的安装路径判断。
3. 先解析 $DOCS_DIR（兼容多种安装方式）：执行 python3 -c "from qwenpaw.constant import DOCS_DIR; print(DOCS_DIR or '')" 2>/dev/null。若返回有效路径则直接使用；否则 fallback 到 $QWENPAW_ROOT/website/public/docs/。
4. 先读文档 $DOCS_DIR/<专题>.<语言>.md（语言取与用户一致：zh / en），仍不足再读表中 源码入口。

主题 / 关键词 → 优先文档与源码

约定

• 文档完整路径：$DOCS_DIR/<专题>.<语言>.md（无对应语言时用 .en.md 兜底）。优先使用 qwenpaw.constant 中的 DOCS_DIR，失败时 fallback 到 $QWENPAW_ROOT/website/public/docs/。
• 表中 源码入口 为起点；应用 read_file 或局部 grep 缩小到具体符号，不要一次性通读大目录 listing。

注意

• 本 skill 不替代 read_file：锁定候选路径后应立即读取并核对。
• 若某路径在本地不存在（例如未带源码的安装树），以 已安装的文档包 或用户提供的根目录为准，并明确告知依据路径。