用途：在 Multica 中排查“agent 未运行、任务未被认领、runtime 离线、工作目录或会话复用、仓库检出”等问题。先读执行链再动手，不要为测试而重启守护进程、更新运行时或随意检出仓库。
核心模型：runtime 是 agent 背后的执行目标，daemon 拥有本地 runtime 进程并从服务端认领排队任务。链路为：用户操作创建或更新 agent_task_queue 行；任务指向 agent 与 runtime；服务端经 daemon websocket 唤醒 runtime；daemon 轮询/认领任务；服务端返回任务上下文、仓库、项目资源、先前会话/工作目录提示与任务令牌；daemon 准备 workdir 并启动 provider CLI。multica repo checkout 与本地 daemon 通信，不直连 GitHub。
常用命令：multica agent get <agent-id> --output json；multica runtime list --output json；multica runtime usage <runtime-id> --output json；multica runtime activity <runtime-id> --output json；multica runtime update <runtime-id> --target-version <version> --output json；multica runtime delete <runtime-id>；multica repo checkout <url>；multica repo checkout <url> --ref <branch-or-sha>。runtime update 与 delete 为写操作，更新限于所有者或工作区 owner/admin。delete 若仍有活动 agent 绑定会拒绝，除非显式 --cascade，后者解绑 agent 并取消其排队/运行中任务；解绑保留 agent 及其指令、技能、聊天、标签、频道安装、autopilot 与任务历史，仅清空 agent.runtime_id，未绑定 runtime 的 agent 无法运行，需用 multica agent update <id> --runtime-id <runtime-id> 重新绑定。
repo checkout 需 MULTICA_DAEMON_PORT 与任务级注入的 MULTICA_TOKEN，须在活动 daemon 任务内及其 workdir 或子目录运行；本地 daemon 用活动任务注册表校验令牌并自行推导工作区/任务/agent 身份，拒绝任务外 workdir。若项目 github_repo 资源带 resource_ref.ref，checkout <url> 默认用该 ref，显式 --ref 可覆盖。
任务 CLI 边界：daemon 注入任务级 mat_ 凭据与任务本地 Multica 配置根。API 命令（issue list/get/runs）使用注入身份，不回退 Owner 配置；config show/set 仅作用于任务本地状态；auth status 省略令牌材料；daemon status 与 daemon disk-usage 报告宿主 runtime，拒绝 --profile，disk-usage 还拒绝 --all-profiles 与 --workspaces-root，其 STATUS 列留空。人类/本地命令如 login、logout、setup、workspace switch、daemon start/stop/restart、daemon logs、daemon probe-runtimes 在任务内不可用。宿主环境不应导出 MULTICA_DAEMON_PORT。更强隔离需专用 Unix 用户、容器或虚拟机。
调试顺序：是否应创建任务；受理人是 agent 还是 squad；agent 是否归档或绑定到不可用 runtime；runtime 是否在线；daemon 最近是否心跳（last_seen_at）；任务是否被认领或卡在 pending/running/等待本地目录；repo checkout 失败后先看任务/项目上下文中是否有仓库上下文，再分类。
限制：工作区仓库与项目资源不同，不要因 checkout 失败就添加项目资源；切勿为测试重启守护进程或更新运行时。进一步资料见 references/runtimes-and-repos-source-map.md。