用途：setup 是 Apache Magpie 框架的安装与配置技能，负责把框架技能安装到本机、为个人做本地配置，或让整个仓库采纳统一的插件集。
主要能力：默认走插件市场安装，每个技能家族各装一个插件，不改动仓库，更新通过 agent 的插件更新机制获取。回退方案是固定快照安装（svn-zip、git-tag、git-branch），会写入被 gitignore 的本地文件、锁文件、符号链接与 post-checkout 钩子，并支持漂移检测；local 仅用于框架自身检出仓库。
使用方式：setup 无参数或 setup install 走首次安装，幂等，已装则等同 verify；setup install method:marketplace 为默认显式写法；setup install method:svn-zip|git-tag|git-branch 为固定快照回退。setup config 只写被忽略的本地配置，setup adopt 提交仓库默认插件集，setup upgrade 刷新快照并修复符号链接，setup worktree-init 让工作树共享主检出的框架状态，setup verify 做只读健康检查，setup uninstall/unadopt 反向卸载。可用 method:、agents:、skill-families:、from:、dry-run、--purge-overrides、--no-overrides 等参数。
适用场景：需要为本机安装框架技能、为个人做本地配置、或让仓库统一采纳插件集与固定版本的团队。
限制：同一台机器只能选一种安装路径，不可把快照叠加在已工作的市场安装上；快照为只读，改动须放入 .apache-magpie-overrides/；setup、utilities 两个家族总是安装，不可选；部分子动作仅限主检出运行。安装命令、依赖与收费信息资料未提供。