将用户问题中的主题、关键词映射到 CoPaw 官方文档路径与常见源码入口,减少盲目搜索。适用于内置 QA Agent 在回答安装、配置、技能、MCP、多智能体、记忆、CLI 等问题时快速选定要读的文件。
回答 安装、配置、行为原理 类问题时,先 按关键词归类,再按下表 打开 1~2 个最可能命中的路径 阅读,避免长时间无目的遍历。
$COPAW_ROOT:以 which copaw 得到可执行路径,若为 …/.copaw/bin/copaw 则源码根为其上三级目录(与 guidance skill 一致);否则结合用户给出的安装路径判断。website/public/docs/<专题>.<语言>.md(语言取与用户一致:zh / en / ru 等),仍不足再读表中 源码入口。| 主题或关键词(示例) | 优先文档(website/public/docs/) | 常见源码入口(相对 $COPAW_ROOT) |
|---|---|---|
| 安装、依赖、首次使用 | quickstart、intro | src/copaw/cli/、 |
pyproject.toml| 配置、config.json、环境变量 | config | src/copaw/config/config.py、src/copaw/constant.py |
| 技能、SKILL、skill_pool、内置技能 | skills | src/copaw/agents/skills_manager.py、src/copaw/agents/skills/ |
| MCP、插件 | mcp | src/copaw/app/routers/(按需 grep mcp) |
| 多智能体、工作区、agent、内置 QA | multi-agent | src/copaw/app/routers/agents.py、src/copaw/app/migration.py、src/copaw/constant.py(BUILTIN_QA_AGENT_ID 等) |
| 记忆、MEMORY、memory_search | memory | src/copaw/agents/memory/memory_manager.py、src/copaw/agents/tools/memory_search.py |
| 控制台、前端 | console | console/ |
| 命令行、子命令、init | cli | src/copaw/cli/(如 init_cmd.py) |
| 频道、会话 | channels | 在 src/copaw 下按 channels 关键词检索 |
| 上下文、窗口 | context | config 文档 + src/copaw/agents/ 相关逻辑 |
| 模型、API Key | models | src/copaw/config/config.py |
| 心跳、HEARTBEAT | heartbeat | 在 src/copaw 下检索 heartbeat / HEARTBEAT |
| 桌面客户端 | desktop | desktop/(若仓库中存在) |
| 安全 | security | 先读 security.<lang>.md |
| 报错、常见问题 | faq | 先 faq.<lang>.md,再针对性看源码 |
| 命令与斜杠指令 | commands | src/copaw 下与 CLI/命令注册相关的模块(按需检索) |
$COPAW_ROOT/website/public/docs/<专题>.<语言>.md(无对应语言时用 .en.md 兜底)。read_file 或局部 grep 缩小到具体符号,不要一次性通读大目录 listing。read_file:锁定候选路径后应立即读取并核对。