用途
该技能用于 Pipecat Context Hub 插件的安装与配置。适用前提是用户明确请求插件、Context Hub 或 Pipecat/Cloud CLI 的安装配置。它先判断请求范围：完整插件安装包含构建/部署工具链；仅检索的安装只需要 PCH。插件安装或单纯询问本身不构成安装依赖或创建索引的授权。
主要能力
- 环境检查：识别执行环境与选定客户端，用无害命令确认本机 shell/文件访问能力，并记录运行时与索引是否在任务间持久化。
- CLI 探测：通过 Explore 的 CLI 检索路径检查
pipecat context-hub或独立pipecat-context-hub的已安装帮助与 JSON 状态，记录版本、索引路径、条目数、刷新日期、框架固定版本、已索引框架版本及覆盖缺口。 - 只读预检批处理：一次性检查本机执行、PCH 命令/状态、
pipecat --version、pipecat init --help，以及 Cloud 场景所需的只读帮助与组织元数据，统一报告结果，不拆成多次审批提示。 - 安装与升级：沿用可用的现有安装；需要新装时使用
uv tool install "pipecat-ai[cli]" --with pipecatcloud（含 Cloud 扩展），若所选发行版未捆绑 PCH 则追加--with pipecat-ai-context-hub；仅本地构建场景可安装独立 PCH 包uv tool install pipecat-ai-context-hub。升级须保留既有的所有扩展与版本约束，仅经一次明确批准后执行。 - 初始索引：仅在索引目录不存在或确认为空且未初始化时，用已验证的 PCH 前缀执行
refresh，遵循已配置的框架固定版本；不得添加--force、--reset-index或--prune；失败时保留部分状态并报告受限错误，不自动重试或清理。 - Cloud 账号：仅 Cloud/完整插件场景需要。通过打包的
scripts/safe_cloud_metadata.py包装器以--kind organizations执行只读组织列表命令来检查登录状态，包装器要求 CLI 与包装器使用同一 Python 环境并接受绝对路径的可执行文件。交互登录由用户在自己终端运行pipecat cloud auth login；无头/CI 场景按 PAT 指南通过环境安全机密提供PIPECAT_TOKEN，不支持auth use-pat时使用其隐藏提示。 - 验证与交接：用 PCH 命令检查状态，执行只读
search-docs "TTS + STT"再查状态，要求两个概念均有命中且索引/版本溯源不变；无需注册 MCP 或重启进程。
使用方式
由用户明确请求触发，通过对话确定所需能力（Explore / Build / Deploy），然后按「检查并提议—获批执行变更—验证交接」的顺序进行。安装、索引等变更需一次覆盖完整变更集的批准；凭证、项目写入和部署属于单独的审批项。
适用场景
- 希望用 PCH 检索 Pipecat 框架文档（Explore）。
- 需要 Pipecat CLI 的
init能力（Build）。 - 需要带 Cloud 扩展的 CLI 并已登录 Pipecat Cloud 账号（Deploy）。
限制
- 首次索引会下载模型和源码仓库，可能耗时数分钟。
- 索引操作要求 POSIX 主机并支持描述符相对、无重解析点的文件系统；Windows 仅限包/路径冒烟测试，不得在其上执行 refresh、serve 或对已有索引的语义查询。
- 本仓库目前要求 Python 3.11 或以上。
- 不配置桌面 MCP 客户端，不部署远程 MCP 服务，不访问提供商密钥，不创建 Cloud 部署或启动 agent 会话。
- 不收集密码，不自动化账户/账单变更。
- 不得把令牌粘贴到聊天、放入 argv 或跨主机复制桌面认证文件。
- 不选择或要求特定审批模式；审批行为由宿主/工作区控制。