用途:指导为 Bash/Docker 平台 Sindri 创建 V2 扩展。V2 扩展是 YAML 驱动的声明式配置。
主要能力:定义扩展元数据、安装方式、校验命令与可选能力(项目初始化、认证、生命周期钩子、MCP 服务器注册)。支持 mise、apt、binary、npm、script、hybrid 六种安装方式。
必要用法:扩展目录为 v2/docker/lib/extensions/{name}/,含必需的 extension.yaml,可选 mise.toml、scripts/、templates/。创建后需加入 v2/docker/lib/registry.yaml,并执行 ./v2/cli/extension-manager validate {name} 校验、./v2/cli/extension-manager install {name} 测试。相关资源:schema 位于 v2/docker/lib/schemas/extension.schema.json,分类见 categories.yaml,配置见 profiles.yaml,文档写入 docs/extensions/{NAME}.md,并更新 v2/docs/EXTENSIONS.md。
适用场景:语言运行时、开发工具、AI 工具等扩展;VisionFlow 扩展使用 vf- 前缀,仅 V2 可用。
限制:多数扩展无需 capabilities;脚本需以 #!/usr/bin/env bash 与 set -euo pipefail 开头。常见问题包括 schema 校验失败、依赖未登记、安装超时、正则转义错误。具体收费与平台支持范围暂未提供。