发现、安装与启用¶
安装让宿主获得插件、CLI、方法或连接定义;启用让这些组件在适用范围可见。安装成功不说明远程服务可达,也不表示用户已经授权。
发行者交付¶
提供稳定产品标识、可信来源、精确版本/摘要、支持平台、原生安装入口、依赖、所需权限和卸载说明。本地可执行组件另声明启动、停止和健康检查;纯 Skill 不应附带无关常驻进程。
| 载体 | 获取与启用 | 单独核对 |
|---|---|---|
| CLI | 包或签名二进制,版本与帮助命令 | PATH、平台、依赖和实际执行文件 |
| 插件 | 原生目录或 marketplace 的精确制品 | 包身份、宿主启用范围、方法和连接发现 |
| 远程 MCP | 可信服务地址和原生连接配置 | 服务来源、协议支持和身份 |
| MCP App | 所连服务发布 UI 资源 | 宿主扩展能力、资源版本和沙箱 |
| DSH 桥接 | 宿主插件及浏览器扩展 | 双端版本、握手和标签绑定 |
| 独立 Skill | 方法目录或原生方法包 | 元数据、引用、资源和适用工具 |
安装流程¶
sequenceDiagram
actor U as 用户
participant H as 宿主或包管理器
participant R as 分发源
participant P as 安装制品
U->>H: 选择发行者、版本和范围
H->>R: 获取原生包与元数据
R-->>H: 精确制品与可核对身份
H->>H: 校验格式、路径、摘要和依赖
H-->>U: 展示实际权限及组件
U->>H: 按宿主规则允许安装与启用
H->>P: 在规定位置安装并发现
P-->>H: 方法、工具连接和可选 UI
H-->>U: 已安装;连接或鉴权仍需单独完成
失败恢复¶
依赖缺失、来源不可达、摘要不匹配、无启用权限和组件未发现要分别报告。失败时保留原可用制品,不靠删除用户配置或清空缓存碰运气。重新执行安装前明确是否只是刷新目录、更新包还是重新建立连接。
不要直接执行来源不明的远程脚本来缩短引导。需要本地动作时,先给出来源、具体影响和可回退步骤;安装命令与升级命令依据载体冻结的版本维护。
验收¶
声明离线运行时,安装期下载和运行期网络依赖分别列出;方法索引、UI资源、字体、模板及必要工具应能从声明的制品获得。安装后断网验收具体任务,不以页面缓存或本地stdio启动代替。人类TTY和机器模式、目录选择与OS默认根分别核验,见本地工作区。
在干净隔离环境安装,核对实际文件/包版本与新会话发现,读取离线帮助,再做受控连接。浏览器扩展、App 资源及原生方法分别验收。完成后进入连接与鉴权。