Plugins

插件核心概念 (Plugin Core Concepts)

• 插件定义 (Plugin Definition):
• 插件是可安装的单一单元 (One installable unit)。
• 它用于将配置和功能打包，实现团队间共享 (Packaging and sharing setup)。
• 安装与管理 (Installation and Management):
• 单次安装: 使用 /plugin install [组织名] [插件名] 进行安装。
• 团队市场: 创建私有市场 (/plugin marketplace add [组织名])，实现集中发现、版本跟踪和更新。
• 运行机制: 插件在用户权限下运行代码，并在匹配的工具调用上触发钩子 (Hooks)。
• 插件与系统交互 (Plugin Interaction):
• 钩子 (Hooks): 插件提供预工具使用 (pre-tool use) 和停止钩子 (stop hooks)，它们在每次工具调用时都会触发。
• 配置冲突: 插件不会覆盖现有配置，而是与现有组件并排运行。
• 命名空间 (Namespacing): 技能 (Skills)、代理 (Agents) 和命令都以插件名称命名空间，避免冲突。
• 安全与信任 (Security and Trust):
• 来源审查: 必须仅从可信来源安装插件和添加市场。
• 审查区别: 自动审查 (Automated review) 不等同于信任 (Trusted)。
• 风险提示: 插件的钩子和代理会在后台运行，用户必须仔细阅读其细节。
• 插件构建与打包 (Plugin Building and Packaging):
• 目的: 将整个 . cloud 目录打包成一个可安装的单元，取代团队间的复制粘贴。
• 包含内容: 技能、子代理、钩子、MCP 服务器配置、语言服务器协议 (LSP) 服务器等。
• 清单文件 (Manifest): 位于 . cloudplugin. json，包含名称、版本、描述和作者。
• 结构要求: 遵循与技能相同的目录结构（每个技能一个文件夹，每个子代理一个 Markdown 文件）。
• 命名规范: 名称是必需的字段；版本应像任何其他依赖一样进行版本控制。
• 插件设置 (Plugin Settings):
• 插件可以包含一个 settings. json 文件，但范围受限。
• Cloud Code 只会识别代理 (Agent) 和子代理 (Sub-agent) 的状态行键 (status line keys)。
• 代理提升: setting agent 可将插件的某个子代理提升为主要线程，并定义其系统提示、工具和限制。

Takeaways

• 插件是一个可安装的单一单元，用于打包配置和功能，实现团队间的共享。
• 插件在用户权限下运行，通过预工具使用和停止钩子（Hooks）触发，并使用命名空间避免冲突。
• 插件的安装和管理依赖于私有市场，但用户必须仅从可信来源安装，因为钩子会在后台运行。
• 插件的构建是将整个 . cloud 目录打包，并使用 . cloudplugin. json 清单文件来定义其结构和元数据。