# 动作预演参考库:Agent 自动接入 这份说明供助手执行。用户只负责在本人 BI 官方授权页确认;不要求用户下载包、解压、编辑配置、发送密码或复制令牌。 ## 自动安装 1. 检查本机 Python 3.10+ 与 Node.js 20+。优先复用 Agent 或系统已安装的运行时;缺少时从 Python/Node 官方来源安装。不要改变用户其他模型或代理配置。 2. 从本说明同一 HTTPS 站点下载 `install.py` 和 `release.json` 到本机临时目录,核对 `release.json.installer.sha256` 后执行。下载使用 Node fetch,或为 Python urllib 设置程序标识 `User-Agent: MotionLibrary-Agent-Setup/1.0`(默认 Python-urllib 标识会被分发站拒绝)。下载和执行由助手完成,不交给用户操作。 3. 执行:`python install.py --client CLIENT --mode MODE`。 CLIENT 对应页面所选:`codex`、`workbuddy`、`claude-code`、`claude-desktop`、`openclaw` 或 `other`;MODE 是 `mcp` 或 `cli`(小写)。`python` 替换为实际 Python 绝对路径;如 Node 不在 PATH,传 `--node` 绝对路径。已安装 opscli 的 Python 可通过 `--ops-python` 指定。 4. 安装器自动下载并校验3个文件;Node MCP 依赖已经打包,不需要 npm install。优先复用官方 opscli,缺少时自动安装到本程序的隔离环境。所有资产仍只保存在 BI 新版服务器;公开分发站没有资产和凭据。 5. 本人未授权时,安装器发起 `opscli auth login` 官方 Device Flow。在用户可见的浏览器打开它实际返回的官方授权链接,让用户本人确认,继续等待安装器;不复用他人的凭据,也不读取浏览器 Cookie。遇到超时或拒绝停止轮询并说明,不重复发起多个登录。 ## 自动配置客户端 - Codex:安装器调用原生 `codex mcp add` 注册 `motion_cloud`;保留其余配置,并备份原配置文件。 - WorkBuddy:合并当前用户 `~/.workbuddy/mcp.json` 中的 `mcpServers.motion_cloud`;尊重 `WORKBUDDY_CONFIG_DIR`,保留其他服务。现有文件不能解析时由助手检查 JSONC,不覆盖整个文件。 - Claude Code:调用原生 `claude mcp add-json --scope user`。已有同名配置时查看并更新这一项,不删除其他服务。 - Claude Desktop:合并当前系统的 `claude_desktop_config.json` 中这一项,保留其余设置。 - OpenClaw/其他 Agent:安装器返回标准 `mcpServers` 配置及 `agent_action_required`;由当前助手查客户端的正式 MCP 支持及原生配置方式完成注册。不能因安装文件存在就报告连接完成;客户端不支持时如实说明。不要猜配置路径。 - CLI 模式:不注册 MCP;安装器返回 `node`、`script`、`python`,助手使用返回的绝对路径执行 search/inspect/resolve/export/download。调用时仅设置 `MOTION_OPS_PYTHON` 为返回的 Python,不填写任何用户令牌。 客户端如要求信任或重启,告诉用户具体的一次确认动作,不擅自跳过安全提示。 ## 接入验收 安装结果必须 `verified=true`;MCP 注册必须 `registration.status=configured`(或助手已完成返回的待处理动作)。用所选客户端列出工具,再调用 `motion_search` 检索“环绕”;确认结果来自该 BI 应用,不是旧 Supabase 或私人库。当前会话不能热加载新工具时,先用 MCP SDK 真实握手检查桥接器,再准确告知需要重新打开客户端。 普通成员只读;管理员才可创建、上传或发布资产。Agent 先完成提示词并思考是否需要参考;需要时检索、核验、固定版本、导出和校验下载,再用自己授权的画布账号添加参考输入。缺口明确返回,不为凑参考改写原提示词。本次安装不授权付费生成。 ## 认证与排错 `BI_LOGIN_REQUIRED`:执行本人官方 opscli 授权后重试同一安装命令。`BI_APP_ACCESS_FAILED`:确认该 BI 账号有网站访问权限,不能换管理员账号绕过。`NODE_20_REQUIRED`:助手安装或指定合适的官方 Node.js。`OPS_INSTALL_FAILED`:核对官方 PyPI 可达性与 Python 环境,不切到来源不明的安装包。 本机 MCP 桥接与直接填 URL 的远程 OAuth MCP 不同。BI 网关仍保护网站;本流程用本人官方身份自动通过网关,不提供匿名或共用管理员账号的访问。