# 使用能力

> 在「能力」页安装并管理技能、场景、MCP、插件与套装。

Canonical page: /product/abilities



侧栏 **能力**（路由 `/abilities`）是扩展入口。页面副标题含义：给 agent 加点本事——**技能、场景、MCP、插件与能力套装**。

<MediaFrame>
  <img src="/images/product/capabilities.webp" alt="Astravia 能力页，展示连接器、技能和插件列表" width="1024" height="1365" />

  <figcaption>
    「发现」用于寻找能力，「我的」用于检查已安装项、配置、权限和更新。
  </figcaption>
</MediaFrame>

## 能力类型 [#能力类型]

| 类型  | 作用                                       |
| --- | ---------------------------------------- |
| 技能  | 任务指令与工作流提示                               |
| 场景  | 预设工作方式；能力页可管理，另有独立路由 `/scenes`（不一定出现在侧栏） |
| MCP | 连接外部工具与数据源                               |
| 插件  | 扩展桌面 UI 与 Agent 能力                       |
| 套装  | 一次组织多项能力，安装时可勾选成员                        |

## 从目标选择能力类型 [#从目标选择能力类型]

| 你的目标           | 优先选择 | 原因                    |
| -------------- | ---- | --------------------- |
| 让 Agent 遵循稳定方法 | 技能   | 以指令和流程指导一次任务          |
| 预设一套工作方式和上下文   | 场景   | 适合重复进入同类工作状态          |
| 调用外部服务或数据      | MCP  | 提供结构化工具连接             |
| 扩展桌面界面、文件或消息   | 插件   | 能进入宿主 UI 和 Agent 生命周期 |
| 一次安装一组协同能力     | 套装   | 统一发现和选择成员             |

如果只是需要外部 API，不要先写桌面插件；如果只是需要稳定提示流程，也不必引入 MCP 服务。

## 发现与我的 [#发现与我的]

* **发现**：浏览可添加的能力（含推荐连接器等分组）。
* **我的**：管理已安装项：启用、停用、配置、更新、移除。

可搜索能力名称；卡片展示来源、版本、状态（如需配置、可更新、已启用）。

## 从市场或列表添加 [#从市场或列表添加]

<Steps>
  <Step>
    ### 打开详情 [#打开详情]

    在发现列表点击能力，右侧抽屉显示说明、来源、版本与权限等信息。
  </Step>

  <Step>
    ### 添加 [#添加]

    选择 **添加能力**。套装会弹出成员勾选（已安装且无需更新的成员不会重复安装）。
  </Step>

  <Step>
    ### 完成配置 [#完成配置]

    * MCP 可能要求填写凭证、或浏览器账户授权。
    * 插件安装后弹出 **启用与权限**：确认启用并逐项授权后才会生效。
  </Step>

  <Step>
    ### 在会话中验证 [#在会话中验证]

    回到会话，确认技能 / 工具 / 插件入口按预期出现。
  </Step>
</Steps>

## 添加能力菜单 [#添加能力菜单]

点击 **添加能力** 可选择：

| 方式       | 说明                                                             |
| -------- | -------------------------------------------------------------- |
| 导入技能压缩包  | 本地 zip / tar.gz / tgz                                          |
| 导入插件压缩包  | 本地 zip，根目录需含 `plugin.json`                                     |
| 添加外置仓库   | GitHub `owner/repo`，仓库需包含 `.astravia/marketplace.json`，添加后立即同步 |
| 手动添加 MCP | 配置 STDIO 或 HTTP MCP 服务                                         |

只导入可信来源。外置仓库同步失败时，应用可能保留上次可用内容并提示错误。

Astravia 官方来源（`maomaochong-ai/astravia-official-marketplace`）作为内置来源随应用提供，始终启用，不能停用或删除；自行添加的外置仓库可以随时停用或删除。

## 管理与排错 [#管理与排错]

* **停用**：保留安装，暂停使用。
* **移除**：卸载本地安装内容。
* **更新 / 重载**：有新版本或开发调试时使用。
* 同一能力标识已被其它来源占用时，不会自动覆盖，需在详情中确认来源。
* MCP 产物写入 `~/.astravia/agent/mcp.json`；技能 / 场景 / 插件分别落在 `~/.astravia/skills`、`~/.astravia/scene`、`~/.astravia/plugins` 等目录；安装索引见 `~/.astravia/abilities.json`。

需要开发插件时阅读 [插件开发](/plugins/overview/)；只连接工具服务时阅读 [MCP 连接器](/product/mcp/)。