// 将用户问题中的主题、关键词映射到 QwenPaw 官方文档路径与常见源码入口，减少盲目搜索。适用于内置 QA Agent 在回答安装、配置、技能、MCP、多智能体、记忆、CLI 等问题时快速选定要读的文件。
| 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。read_file：锁定候选路径后应立即读取并核对。Use this skill when sedimenting a session into a reusable workspace skill. Triggers when the user wants to turn the current conversation, workflow, or troubleshooting path into a SKILL.md. Phrases like 'turn this into a skill', 'remember how I did X', 'save this workflow', 'make a skill from this', and any /make-skill <focus> invocation should fire this skill.
用于把当前会话沉淀为可复用的 workspace skill。当用户希望把当前对话、工作流或排错路径写成 SKILL.md 时触发。触发表达包括「把这个变成 skill」「记住我是怎么做 X 的」「保存这个工作流」「make a skill from this」以及任何 /make-skill <focus> 调用。
Use this skill only for scheduled or recurring tasks. Manage jobs with qwenpaw cron list/create/get/state/pause/resume/delete/run, and always pass --agent-id explicitly.
仅在需要未来定时执行或周期执行任务时，使用本 skill。使用 qwenpaw cron list/create/get/state/pause/resume/delete/run 管理任务，并始终显式传入 --agent-id。
Answer user questions about QwenPaw installation and configuration: first locate and read local documentation, then distill the answer; if local information is insufficient, fall back to the official website documentation.
回答用户关于 QwenPaw 安装与配置的问题：优先定位并阅读本地文档，再提炼答案；若本地信息不足，兜底访问官网文档。