共享和安装智能体技能¶

Orca 可以将一个技能或一组技能放在一个未列出、可撤销的链接后面。共享的捆绑包不会出现在搜索、目录或公共索引中。任何拥有有效链接的人都可以查看并安装其内容，而无需登录，因此应将链接视为凭据。

共享技能¶

发布和链接管理需要桌面应用中的 Orca 账户。

1. 打开 技能，选择 共享技能。
2. 选择一个或多个技能。一个链接可以包含一个大型集合，例如 30 个技能。
3. 查看捆绑包名称、包含的技能和文件、脚本、可执行文件、摘要、账户以及可选的发布说明。
4. 选择 发布技能、发布捆绑包 或 发布新版本，然后复制链接。

Orca 会发布一个不可变版本。后续更改不会悄悄更改链接的当前字节；发布新版本以更新云包。

使用 设置 → 共享技能 复制或撤销有效链接。撤销会阻止新的预览和下载授权。在撤销前刚刚签发的授权最多可能保持可用五分钟，并且撤销不会移除接收者已安装的副本。

从链接安装¶

打开 Orca 技能链接会在更改任何文件之前显示预览。你也可以打开 技能，选择 从链接安装，然后粘贴 URL。

1. 验证作者和组织。
2. 查看版本、发布说明、包含的技能、脚本、可执行文件和摘要。
3. 选择所有技能或仅选择你需要的技能。
4. 选择目标机器以及全局或工作区范围。
5. 查看新增、未更改、已更新和冲突的技能，然后选择 安装 N 个技能。

支持的目标包括本地机器、配对的 Orca 运行时、WSL 和 SSH 主机。目标运行时解析其自身的主目录和工作区路径，因此文件夹工作区和远程文件系统不会借用客户端机器的路径。

Orca 保留一个规范安装副本，并将其放置在受支持的智能体可以发现的位置。当前提供方覆盖范围记录在 智能体技能提供方路径 中。

冲突、更新和回滚¶

当现有技能存在差异时，保留本地 是默认选项。只有在你明确选择丢弃后，Orca 才会替换已修改的内容。

打开 技能 → 管理安装 以查看受管技能及其不可变版本历史。安装最新版本会执行更新；选择较早的保留版本会执行回滚。两者都使用相同的受保护安装事务。如果捆绑包在不同版本之间发生变化，Orca 仅更新在该版本中仍然存在的所选技能。

中断的安装会在重启时恢复。如果 Orca 报告冲突或部分结果，请查看指定技能并重试；已完成的技能无需再次安装。

移除已安装的技能¶

使用 技能 → 管理安装 → 移除。Orca 仅移除其拥有且可以验证的副本和提供方部署位置。已修改或非自有文件会被保留并报告。丢弃已修改的内容需要单独的明确确认。

移除本地安装不会撤销其共享或删除其云包。同样，撤销或删除云数据不会触及接收者的机器。

保留和删除¶

• 上传授权在 15 分钟后过期。
• 被放弃的上传字节会在一天后从隔离区移除。
• 已发布版本没有基于年龄的自动删除。
• 删除包会先撤销其链接，然后删除未引用的对象。
• 已删除的 GCS 对象在七天软删除窗口内可由操作员恢复。
• 已安装的副本会一直保留，直到有人在每个目标机器上移除它们。

组织的法律或保留要求可以覆盖正常的回滚和删除时间。

信任和隐私¶

技能是来自其作者的代码。SKILL.md 可以更改智能体行为，包含的脚本或可执行文件可能在人员或智能体使用技能时稍后运行。Orca 会验证包，并在安装期间从不执行其内容，但你应仅从你信任的人处安装，并审查意外的脚本或可执行文件。

Orca 记录有限的操作标识符和结果。常规日志、遥测和支持包会排除技能内容、文件名、清单、本地路径、共享 URL、上传策略、下载授权、凭据和访问列表。

如果链接不再有效，请向其所有者索取有效链接。缺失、过期、已撤销和已删除的链接会故意显示相同的响应，以便 Orca 不泄露私有包的存在。