CoPaw 文档与源码速查

回答 安装、配置、行为原理 类问题时，先 按关键词归类，再按下表 打开 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/命令注册相关的模块（按需检索）