能力市场：发现与分享智能组件
你可以在 Pipora 里搭建 Agent、编排工作流、配置工具。但很多常见能力并不需要每次从零开始。
如果已有「自动整理周报」的工作流、「分析 Excel 表格」的工具组合，或「润色中文文章」的 Agent，你可以直接获取、安装并按需调整。
在 Pipora 里，集中发现和安装这些组件的地方就是能力市场（Marketplace）。
能力市场是什么
能力市场是一个共享与获取能力包的地方：
- 发布者把自己搭好的工作流、Agent、工具、技能等打包上传，供他人使用
- 使用者按类型浏览或搜索，找到需要的组件，一键安装到本地
每一个「能力包」都是一组经过整理的智能组件，可能包含：
| 组件类型 | 能帮你做什么 |
|---|---|
| 工作流（Workflow） | 自动执行多步骤任务，比如「每天早上检查邮箱、生成摘要、发给团队」 |
| Agent | 专职智能助手，比如「合同审核员」「数据分析师」 |
| 工具（Tool） | 执行具体操作，比如「读取 PDF」「调用搜索引擎」「发送通知」 |
| 评分器（Scorer） | 给 Agent 的表现自动打分，帮助持续优化 |
| 技能（Skill） | 教 Agent 掌握特定领域的知识和方法 |
| 脚本（Script） | 处理数据的自定义逻辑 |
每个包都有独立的介绍、使用说明和环境要求，便于你在安装前判断是否适合当前场景。
为什么要用能力市场
复用已有组件，减少重复搭建
很多常见需求其实已经被社区解决过了：
- 想要一个能自动整理会议纪要的 Agent？市场里可能已经有人分享过了
- 需要一套处理发票图片并录入表格的工作流？可以直接安装现成组件
- 想给自己的 Agent 增加「读取网页」的能力？找到一个工具包，一键装上就能用
按需取用，不必全盘接受
你不需要安装整个包。如果某个包里只有一个工具是你想要的，只装那一个就好。系统会自动帮你把这个工具依赖的同包内其他组件一起装好，确保它能正常运行，但不会乱装不需要的东西。
本地运行，隐私可控
和市场上的云端服务不同，从能力市场安装的所有组件都在你的本地电脑上运行。数据不会上传到别人的服务器，隐私完全由你掌控。
如何发现需要的组件
按类型浏览
进入市场后，你可以选择只看某一类组件：
- 只看「工作流」，找一找有没有适合自己业务场景的自动化流程
- 只看「Agent」，挑选几个专职助手试用
- 只看「工具」，为自己的 Agent 扩充技能库
搜索
如果你已经知道自己需要什么，可以直接搜索关键词。比如输入「邮件」，就能找到所有和邮件相关的能力包。
查看详情
点击任意一个能力包，你会看到：
- 功能介绍：这个包能做什么、适合什么场景
- 包含组件：包里有哪些工作流、Agent、工具等
- 作者信息：谁创建了这个包
- 环境要求：运行前需要准备什么（比如是否需要特定软件、是否需要配置密钥）
- 安全提示：安装前系统会告诉你这个包会访问哪些资源、有哪些潜在风险
如何安装
安装单个组件
如果你只需要包里的某一个工具或 Agent，可以单独安装它。系统会自动分析这个组件依赖了同包内的哪些其他组件，并把它们一起装好，确保它能正常工作。
举个例子：你安装了一个「生成周报」的工作流，它内部需要用到同包里的「读取邮件」工具和「数据分析」Agent。系统会自动把这两个也装上，你不用手动一个个找。
安装整个包
如果你觉得整个包都有用，也可以选择一次性安装包里的所有组件。
跨包依赖怎么办？
有时候，你安装的组件可能引用了另一个包里的东西。这种情况下，系统不会自动帮你下载那个包（防止不知不觉装上一大堆你不想要的东西），而是会明确提示你：「这个组件需要另一个包里的某某组件，请先安装那个包」。你可以自己决定是否去安装。
安装前会发生什么
在真正安装之前，Pipora 会先完成两类检查：
1. 环境检查
系统会读取能力包的说明，检查你的电脑是否满足运行条件。比如是否需要安装 Python、是否需要配置某个密钥、某个软件是否在环境变量中。
检查结果会展示给你：
- ✅ 已满足的条件
- ⚠️ 缺失的条件，以及安装建议
注意：第一版不会自动帮你安装系统软件，只会告诉你缺什么、怎么装。
2. 安全审查
系统会用本地 Agent 审查这个包的安全性，生成一份简明报告，告诉你：
- 风险等级：低 / 中 / 高 / 严重
- 这个包会做什么：比如读取本地文件、调用外部网络服务等
- 需要注意什么：比如包含会执行本地命令的脚本
- 安装建议：推荐安装 / 谨慎安装 / 不建议安装
你可以在清楚了解风险后再决定是否继续安装。
安装过程
确认无误后，点击安装，系统会把组件下载到本地的一个独立目录里。每个包都有自己独立的文件夹，不同包之间的文件互不干扰，你不用担心装了这个包会覆盖那个包的文件。
安装完成后，系统会记录你装了什么。你可能需要重启一下本地服务，新组件就能用了。
如何更新
能力包的作者可能会持续改进和修复问题。Pipora 会自动检测你安装过的包是否有新版本。
发现有更新时，系统会提示你。确认升级后，它会：
- 重新下载最新版本的组件
- 自动备份你当前的旧版本（万一新版本有问题，可以找回旧的）
- 覆盖安装你之前选中的那些组件
升级是可控的：系统不会悄悄自动升级，必须由你确认后才执行。
如何卸载
卸载单个组件
如果你不再需要某个工具或 Agent，可以单独卸载它。系统会先检查有没有其他已安装的组件还在依赖它，如果有，会阻止卸载并告诉你「某某工作流还在用这个工具，请先处理」。这样可以避免你一不小心把别人正在用的东西删了。
卸载整个包
如果你决定不再使用某个包，也可以整包卸载。系统同样会检查依赖关系，只删除那些没有被其他包引用的组件；如果被别的包还在用，会保留并告诉你原因。
如何分享自己的组件
如果你搭出了一套好用的能力，也可以打包分享给别人。
分享前，你需要准备两样东西：
- 包描述信息：包括包的名字、简介、作者、包含哪些组件、每个组件的用途
- 使用说明（README）：介绍这个包是做什么的、怎么用，以及运行它需要满足哪些环境条件
系统会扫描你的目录，自动识别出哪些文件是工作流、哪些是 Agent、哪些是工具等。你只需要补充好展示名称和描述，确认无误后就可以上传。
上传后的包会进入公共存储，其他人就能在市场里搜索和安装了。
第一版能力市场的边界
为了让体验简单可靠，第一版能力市场有意控制了一些复杂度。以下功能暂时还没有：
- 付费购买：目前所有包都是免费分享、免费使用
- 多版本并存：每个包只保留最新版本，没有历史版本切换
- 自动安装系统依赖：环境检查只会提示你缺什么，不会自动帮你装 Python、FFmpeg 等系统软件
- 沙箱隔离：组件在你的本地环境运行，和你自己搭建的组件运行环境一致
- 自动升级：检测到更新后会提醒你，但不会后台自动升级
这些限制让第一版的能力市场保持轻量和可预期。随着社区的发展，未来会逐步丰富。
一句话总结
能力市场 = 共享 + 发现 + 安全安装。它让个人和团队搭建的智能组件可以被复用和流通：你可以获取别人分享的能力，也可以把自己配置好的 Agent 和工作流分享出去。组件在本地运行，安装前有安全审查，升级时有自动备份，卸载时有依赖保护。