qa-source-index

将用户问题中的主题、关键词映射到 QwenPaw 官方文档路径与常见源码入口，减少盲目搜索。适用于内置 QA Agent 在回答安装、配置、技能、MCP、多智能体、记忆、CLI 等问题时快速选定要读的文件。

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/agentscope-ai/QwenPaw --skill qa-source-index

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

SKILL.md

来源说明 · 只读预览

name	QA_source_index
description	将用户问题中的主题、关键词映射到 QwenPaw 官方文档路径与常见源码入口，减少盲目搜索。适用于内置 QA Agent 在回答安装、配置、技能、MCP、多智能体、记忆、CLI 等问题时快速选定要读的文件。
metadata	{"builtin_skill_version":"1.3","qwenpaw":{"emoji":"🗂️","requires":{}}}

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

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

主题或关键词（示例）	优先文档（`$DOCS_DIR/`）	常见源码入口（相对 `$QWENPAW_ROOT`）
安装、依赖、首次使用	`quickstart`、`intro`	`src/qwenpaw/cli/`、`pyproject.toml`
配置、config.json、环境变量	`config`	`src/qwenpaw/config/config.py`、`src/qwenpaw/constant.py`
技能、SKILL、skill_pool、内置技能	`skills`	`src/qwenpaw/agents/skill_system/`、`src/qwenpaw/agents/skills/`
MCP、插件	`mcp`	`src/qwenpaw/app/routers/`（按需 grep `mcp`）
多智能体、工作区、agent、内置 QA	`multi-agent`	`src/qwenpaw/app/routers/agents.py`、`src/qwenpaw/app/migration.py`、`src/qwenpaw/constant.py`（`BUILTIN_QA_AGENT_ID` 等）
记忆、MEMORY、memory_search	`memory`	`src/qwenpaw/agents/memory/memory_manager.py`、`src/qwenpaw/agents/tools/memory_search.py`
控制台、前端	`console`	`console/`
命令行、子命令、init	`cli`	`src/qwenpaw/cli/`（如 `init_cmd.py`）
频道、会话	`channels`	在 `src/qwenpaw` 下按 `channels` 关键词检索
上下文、窗口	`context`	`config` 文档 + `src/qwenpaw/agents/` 相关逻辑
模型、API Key	`models`	`src/qwenpaw/config/config.py`
心跳、HEARTBEAT	`heartbeat`	在 `src/qwenpaw` 下检索 `heartbeat` / `HEARTBEAT`
桌面客户端	`desktop`	`desktop/`（若仓库中存在）
安全	`security`	先读 `security.<lang>.md`
报错、常见问题	`faq`	先 `faq.<lang>.md`，再针对性看源码
命令与斜杠指令	`commands`	`src/qwenpaw` 下与 CLI/命令注册相关的模块（按需检索）

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