用途：为 Webcmd 编写新站点适配器，或为已有站点新增命令，目标是在约 30 分钟内从零上下文做到通过 webcmd browser verify。
主要能力与流程：先做范围自检（数据能否在浏览器看到、是否为 HTTP/JSON/HTML、是否需要实时推送），再用 webcmd doctor 检查桥接，读取 ~/.webcmd/sites/<site>/ 下的 endpoints.json、field-map.json 与站点记忆。随后进行站点侦察与 API 发现，候选接口必须直接验证（200 且含目标数据）。写代码前必须产出策略说明，在 PUBLIC_API、COOKIE_API、UI_SELECTOR、DOM_STATE、PAGE_FETCH、INTERCEPT 中选择，并注明契约级别与证据；优先 PUBLIC_API/COOKIE_API，UI/DOM 语义稳定时不要强行升级到内部接口。之后做字段解码、设计列、用 webcmd browser init 生成骨架并复制邻近适配器，再运行 webcmd browser verify。
必要用法：调试浏览器适配器时使用 --trace on --keep-tab true --window foreground；首次通过后立即用 --write-fixture 生成校验夹具，并收紧 patterns、notEmpty、rowCount。登录相关命令必须复用 registerSiteAuthCommands，登录行返回 action_required 与 verify_command（通常为 webcmd <site> whoami），用户确认完成并验证成功后才能重试原流程；验证码、MFA、凭据一律人工交接，适配器不得收集或输入密码。搜索类命令需设置 tags: ['search']。
限制：仅复用页面已合法获得的数据与能力，不涉及签名破解、验证码绕过、风控或访问控制绕过；适配器只依赖 @agentrhq/webcmd/registry 与 @agentrhq/webcmd/errors，不添加第三方依赖；columns 与 func 返回键必须完全一致；已知失败须抛出类型化错误，不得静默返回空数组或哨兵行。若为站点首个命令，应先与用户确认用例与命令集合，不要自行继续搭建。