UXC Facade 是一个围绕 UXC 构建的技能,用途是把 MCP、OpenAPI、GraphQL、gRPC、JSON-RPC 等接口封装成一个稳定的 JSON 命令行门面(facade),供代理或自动化脚本以固定命令名调用。UXC 在此只承担协议适配器角色,不应被当作第二个服务运行时,因为 UXC 只能证明传输成功,无法验证是哪一个服务实例作答。
主要能力与责任划分 每个门面涉及三方,必须使用固定名称:原生宿主(以原生方式注册服务器的客户端或宿主,如 Cursor、Claude Code、Codex、浏览器)、归属技能(负责端点身份、认证边界、恢复策略、安全输出与最终验收的服务专属技能)、二进制所有者(唯一负责安装和更新固定版本 uxc 二进制的技能,可以是归属技能或指定的共享所有者)。原生宿主可对需要宿主原生工具的服务保持权威,也可在经实测的共享门面成为归属技能默认路径时退为显式兼容通道。UXC 成功仅代表传输证明,不代表任务验收。
使用方式 当用户调用 /uxc-facade 但未指定目标时,应返回未填写的契约,不得安装 UXC、创建链接、导入配置或修改文件,直到有具体目标进入范围。契约需列出归属技能、原生宿主角色、协议与主机、就绪操作、允许的就绪输出、固定链接名、二进制所有者、安装根目录、版本与官方来源、摘要或包锁证明、认证所有者、共享可变状态、互斥键、空闲 TTL、任务验收动作与原生兼容验收。若无法命名安全的就绪操作或任务验收动作,则门面尚不可自动化。涉及 Chrome DevTools、CDP、list_pages 等任务应转交 chrome-dev-mcp,本方法仅作为其通用 UXC 设计层。
是否值得建立门面 当满足至少一个条件时使用:重复的代理或自动化调用需要单一稳定命令名与 JSON 信封;MCP stdio 子进程开销大且经实测会话复用有价值;多种受支持协议需要相同的发现与调用流程;安装来源、链接归属与脱敏就绪检查需要显式契约。以下情况跳过:一次性 API 调用可直接由 UXC 执行;原生宿主注册已解决完整任务且无 CLI 消费者;接口没有可用模式或发现面;需要完整 SDK 以支持流式、回调或协议专属特性。
构建与校验 先定义契约,再固定版本、安装并建立链接。二进制安装根目录只能隔离二进制本身,守护进程套接字、模式缓存与凭据位于 $HOME/.uxc,由机器上所有 UXC 版本共享,UXC 不提供按所有者隔离的守护进程目录(资料称在 0.17.0 上验证,升级后需重新检查 uxc daemon --help)。因此每个用户只固定一个 UXC 版本,由二进制所有者命名,消费者只能校验版本与摘要,不得安装、替换或更新。链接与就绪辅助保留在各归属技能中,二进制安装器留在二进制所有者处。执行前须用 uxc link --help 核对每个参数。官方安装命令示例(切勿传 --no-verify): curl -fsSL https://raw.githubusercontent.com/holon-run/uxc/main/scripts/install.sh | bash -s -- -v vX.Y.Z -d "<install-root>" 以 Rust 工具链为来源策略时可改用:cargo install uxc --version X.Y.Z --root "<install-root>"。随后用 uxc daemon status 确认 version_mismatch=false,先发现再链接:uxc "<host>" -h、uxc "<host>" <operation> -h,再用 uxc link <link-name> "<host-or-stdio-command>" --skill <owner-skill> 创建固定链接,可加 --daemon-exclusive、--daemon-idle-ttl、--force 等旗标。--daemon-idle-ttl 0 会禁用空闲回收;--force 仅用于契约确已变化的链接替换,不得用于幂等。已有 MCP 配置可用 uxc config import mcp --dry-run 预览导入。原生 Windows 不受 UXC 支持,应记为 UNVERIFIED。
资料还提供一段 zsh 所有权门禁脚本,检查二进制是否为符号链接、所有者文件、摘要、版本,以及链接是否非 UXC 命令、归属是否匹配;未通过前门面保持 UNVERIFIED。复用只能基于实测元数据证明,不能用耗时判断,可通过 uxc daemon status、uxc daemon sessions 观察 mcp_reuse_hits 与 mcp_stdio_sessions。结果按 FACADE_READY、TRANSPORT_READY、SESSION_REUSED、TASK_ACCEPTANCE、NATIVE_COMPAT 分层报告,未证实的层标记 UNVERIFIED 并给出下一步动作,不得合并成笼统成功。仅返回有限状态字段,丢弃 URL、标题、正文、凭据、Cookie、令牌与原始工具负载,除非用户明确请求其中的安全数据。
适用场景与限制 适用于需要统一协议发现与调用、复用昂贵 MCP 会话、显式管理安装来源与就绪检查的自动化集成。限制包括:UXC 无法验证服务实例;共享守护进程状态要求严格控制版本;流式或回调需完整 SDK;原生 Windows 不支持;具体收费、价格与效果资料未提供。