用途：这是 Webcmd 会话开始时的定位层，说明 webcmd 能把网站、Electron 桌面应用和外部 CLI 统一为 webcmd <site> <command> 接口，供智能体驱动而无需屏幕抓取。涉及搜索、研究、抓取 URL、收集证据时，应先加载 smart-search。
主要能力：三大支柱为适配器命令（webcmd <site> <command>）、浏览器驱动（webcmd browser *，含 open、state、click、type、select、find、extract、network）和外部 CLI 透传（webcmd gh、webcmd docker、webcmd vercel 等）。适配器策略包括 PUBLIC、COOKIE、INTERCEPT、UI、LOCAL；Electron 适配器通过 CDP 连接运行中的应用。
安装与自检：npm install -g @agentrhq/webcmd，然后 webcmd doctor。会话中先运行 webcmd --version；若缺失则提示用户安装并验证，npm 不可用或安装失败时停止并报告错误，不要安装 Node.js 或静默改用 npx。doctor 报告守护进程、运行时连接、版本与浏览器连通性，COOKIE、INTERCEPT、UI 和 browser 子命令需要它。
发现命令：运行 webcmd 查看全部功能与已装适配器；用 webcmd list -f json 作为已安装命令的唯一事实来源，并按工作流关键词过滤后再输出，避免截断导致误判缺失。回退顺序为：过滤后的完整注册表结果、plugin search、最后才允许原始 browser。
通用参数与格式：-f/--format 支持 table、yaml、json、plain、md、csv，智能体通常用 -f json；-v 开启调试日志。命令专属参数如 --limit、--tab、--filter 需查看 --help。
认证与人工接管：AUTH_REQUIRED 不算适配器失败；handoff.status 为 action_required 时须停止并等待用户完成，之后运行 verify_command 验证成功再重试。绝不请求、输入、回显、存储或自动化密码、OTP、恢复码、Cookie、会话密钥或验证码答案。
自修复与插件：适配器因站点变化失败时用 --trace retain-on-failure，最多 3 轮修复。插件用 webcmd plugin install/list/update/uninstall/create/search/catalog 管理；外部 CLI 用 webcmd external install/register/list。
限制：不要硬编码适配器列表，不要假设所有适配器都需要浏览器，不要从失败适配器静默回退到手写 fetch。已移除 webcmd explore、webcmd record 和顶层 webcmd desktop * 分组。