侧栏 能力（路由 /abilities）是扩展入口。页面副标题含义：给 agent 加点本事——技能、场景、MCP、插件与能力套装。
能力类型
| 类型 | 作用 |
|---|---|
| 技能 | 任务指令与工作流提示 |
| 场景 | 预设工作方式；能力页可管理，另有独立路由 /scenes（不一定出现在侧栏） |
| MCP | 连接外部工具与数据源 |
| 插件 | 扩展桌面 UI 与 Agent 能力 |
| 套装 | 一次组织多项能力，安装时可勾选成员 |
从目标选择能力类型
| 你的目标 | 优先选择 | 原因 |
|---|---|---|
| 让 Agent 遵循稳定方法 | 技能 | 以指令和流程指导一次任务 |
| 预设一套工作方式和上下文 | 场景 | 适合重复进入同类工作状态 |
| 调用外部服务或数据 | MCP | 提供结构化工具连接 |
| 扩展桌面界面、文件或消息 | 插件 | 能进入宿主 UI 和 Agent 生命周期 |
| 一次安装一组协同能力 | 套装 | 统一发现和选择成员 |
如果只是需要外部 API，不要先写桌面插件；如果只是需要稳定提示流程，也不必引入 MCP 服务。
发现与我的
- 发现：浏览可添加的能力（含推荐连接器等分组）。
- 我的：管理已安装项：启用、停用、配置、更新、移除。
可搜索能力名称；卡片展示来源、版本、状态（如需配置、可更新、已启用）。
从市场或列表添加
打开详情
在发现列表点击能力，右侧抽屉显示说明、来源、版本与权限等信息。
添加
选择 添加能力。套装会弹出成员勾选（已安装且无需更新的成员不会重复安装）。
完成配置
- MCP 可能要求填写凭证、或浏览器账户授权。
- 插件安装后弹出 启用与权限：确认启用并逐项授权后才会生效。
在会话中验证
回到会话，确认技能 / 工具 / 插件入口按预期出现。
添加能力菜单
点击 添加能力 可选择：
| 方式 | 说明 |
|---|---|
| 导入技能压缩包 | 本地 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。