插件与能力管理
记忆、联网搜索、子代理和手机访问等能力通过插件提供。在设置中选择需要的插件,再按会话调整工具与参数,让每项工作使用合适的能力。
从 Settings → Plugins 开始
桌面端打开 Settings → Plugins;终端可用 /config 打开配置页,再进入 Plugins。 插件目录区分随产品分发的官方插件与本机安装的用户插件。点开卡片查看配置、加载状态,以及插件声明的运行条件和操作。
官方插件已随 Mica 分发,无需逐个下载。常驻会话宿主会监听 plugins-state.json:空闲时对齐插件启停状态; 正在运行的轮次不会被打断,变更在该轮结束后或下一轮开始前对齐。mica exec 等一次性宿主在装配时读取状态。 新增用户插件目录不会单凭目录变化触发同步;可以启动新宿主装配。常驻宿主在启停名单变化时也会重新扫描用户插件。 配置页“重新加载”刷新目录信息,不能视为已重启运行中的宿主。 普通设置在保存后由插件后续读取,具体取决于插件何时读取该项设置。
表单改动停下后自动保存,先留意字段校验与保存状态。目录卡片区分“已停用”“已加载”“已跳过”和“尚未加载”;启停状态与宿主完成同步之间可能有短暂延迟。
区分插件、默认能力与会话设置
| 调整位置 | 影响范围 | 适合做什么 |
|---|---|---|
| Settings → Plugins | 插件是否加载,以及插件参数的默认值。 | 停用整项功能,配置搜索地址、记忆整理或插件模型。 |
| Settings → Capabilities | Tools、Skills、MCP servers 的默认开关。 | 为跟随默认的会话决定可用能力;已经单独定制的会话保留自己的选择。 |
桌面端会话设置;终端 /capabilities | 当前会话的能力开关。 | 为本次任务缩小工具、Skill 或 MCP 服务的可用范围。 |
| 桌面端会话设置 → 插件 | 当前会话可覆盖的插件参数。 | 为长任务调整压缩策略,或为特定会话选用不同的插件模型。 |
只有插件声明为可按会话配置的字段才会出现在会话设置中。会话只保存改过的项,其余继续跟随默认;使用“跟随默认”可移除覆盖。 能力开关也可以恢复为默认。当前轮次运行时不能提交能力切换,先等本轮结束或停止执行。
关闭某个工具只调整模型在该会话中可用的能力。若要连同插件的自动行为、命令和提示词一起停用,应在 Plugins 中停用插件,并等待当前常驻宿主完成同步。
按目的选择官方插件
以下是日常工作常用的插件。各插件所需的模型、外部服务或系统权限不同,先读详情中的条件,再按实际需要配置。
| 想完成的事 | 插件 | 使用要点 |
|---|---|---|
| 记住偏好与项目经验 | memory | 跨会话保存用户、通用与项目记忆;可配置自动整理与字符预算。 |
| 保留当前任务的目标与决策 | session-notes、todo | 笔记随会话保存;待办用于跟踪当前一轮的工作计划。 |
| 继续较长的会话 | session-compact | 主会话区右键手动压缩(侧栏会话行不放这两项):快速压缩把工具调用与结果聚合成一条占位调用(对话正文不动),模型压缩把用户与助手的对话交给模型写摘要。 |
| 查证最新信息与官方资料 | web-search | 提供搜索工具,需要可用的 SearXNG;找到链接后用 web_fetch 阅读页面。 |
| 委派探索、实现与审阅 | subagent | 提供子代理工具;委派倾向可选主动拆分或仅在明确要求时委派。 |
| 把完整任务交给另一条会话 | sidecar | 独立上下文与会话历史,主代理可继续发消息、观察和收尾。 |
| 主任务进行时问一个旁支问题 | btw | 终端提供 /btw;桌面端使用 By The Way 抽屉。 |
| 复盘 agent 的运行问题 | harness-review | 查看有证据的问题候选并导出报告;人工记录评估结论。 |
| 生成提交说明并完成 Git 提交 | commit | 提供 /commit、mica commit 与桌面提交入口,可按设置推送。 |
| 整理与导出会话 | session-rename、session-tags、session-copy | 自动命名、自定义标签(名字与颜色在 Settings → Plugins → Session Tags 的「打开标签」整页里设), 以及从桌面会话菜单复制 Markdown。 |
| 连接另一台开发机 | connections | 桌面侧栏 Connections 连接对方运行时;需要对方地址与访问条件。 |
| 从手机访问当前机器 | mobile-relay | 需要公网中转机和本机在线的 Mica 运行时,在插件详情注册并获取链接。 |
| 让模型操作 macOS 应用 | computer-use | 仅适用于 macOS 桌面端,需要辅助功能、屏幕录制与 Command Line Tools。点按钮、打字、移动鼠标这类会改动 屏幕的操作,执行前会先弹一张确认卡;截图默认覆盖所有显示器。 |
| 让 Mica 的浏览器直接是登录态 | browser-cookie-sync | 安装 Chrome 扩展后,通过本机服务自动双向同步 cookie;首次连接及离线重连才全量补漏, 不需要全磁盘访问、钥匙串授权或手动同步按钮。 |
| 把下一步变成一次点击 | quick-buttons | 模型在输入框上方放一排按钮:打开页面(默认用受控浏览器)、把一段话放进输入框、开新会话跑一段提示词、打开文件。 按钮只属于当前会话,切换对话就换一套。 |
会话笔记、记忆、压缩与三种协作方式的具体分工,见 日常开发流程。 手机与其他机器的接入步骤见 远程与手机访问。
联网搜索需要 SearXNG
Web Search 插件不会安装或托管搜索服务。先准备一个可访问的 SearXNG 实例,在该实例的 settings.yml 中通过 search.formats 启用 json 输出,再填写插件详情的“SearXNG 地址”。 本地地址只有在相同机器上确实运行了实例时才可用。
地址按“插件设置 → SEARXNG_URL 环境变量 → http://127.0.0.1:8080”解析。 也可以直接编辑 $MICA_HOME/plugin-settings/web-search.json;例如:
{
"searxngUrl": "http://127.0.0.1:8080",
"defaultCount": "5"
}实例未启动、未开放 JSON 格式或网络不可达时,搜索会返回错误,并在插件健康状态中显示原因。 内置 web_fetch 负责读取具体 URL,不依赖 SearXNG。
插件使用哪个模型
自动命名、压缩摘要、记忆整理和提交说明等功能可能发起额外模型请求。声明了模型接口的插件会显示“复用当前会话模型”开关,通常默认开启;以插件详情中的实际设置为准。 复用时使用当前会话选择的服务与模型,没有会话的一次性插件操作使用全局模型配置。
关闭复用后,可以为插件填写独立的接口地址、Key、协议与模型,例如为摘要选择另一项服务。 使用“测试连接”确认接口可达;它会发送一次最小模型请求。支持按会话配置的模型字段,也可在会话设置中覆盖或恢复默认。
独立接口失败时,通用模型接口会尝试用当前会话模型重发,并在健康状态显示降级原因;成功降级后会继续使用该模型,直到相关配置发生变化。 会话中的插件模型调用可在 Stats 按来源查看。模型选择、输入内容与服务计费都会影响实际开销。
安装用户插件
将完整插件目录放入 ~/.mica/plugins/;设置 MICA_HOME 后改为 $MICA_HOME/plugins/。 按插件作者说明准备依赖,再刷新插件目录并启动新的宿主。典型结构如下:
~/.mica/plugins/
└── my-workflow/
├── plugin.json
├── index.mjs
└── skills/
└── review/
└── SKILL.mdplugin.json 声明插件身份、入口、设置与所需能力,入口为默认导出 setup(ctx) 的 JavaScript 模块。 用户插件建议分发可运行的 .js 或 .mjs 入口;没有清单的目录或单独散落的脚本不会被识别。运行时会给用户插件 ID 加上 user. 前缀。
插件可以一起提供工具、命令、提示词和 Skills。Skill 是模型按需读取的工作指南,MCP 是连接外部工具服务的协议,它们都可以单独配置,不必为了添加一份 Skill 或一个 MCP 服务编写插件。 文件位置与示例见 Skills、MCP 与角色。
插件没有生效时
- 确认插件已启用且宿主已完成同步;检查当前会话是否关闭了相关工具、Skill 或 MCP 服务。
- 在插件详情查看加载状态与宿主。显示“已跳过”时先阅读缺少的能力;例如依赖桌面宿主的插件会在 TUI 中跳过。
- 区分“尚未加载”、加载失败与运行报错。没有加载记录时不能据此判断插件是否工作,先在目标宿主打开会话再检查。
- 检查设置校验、模型连接和外部服务;有“运行条件”的插件还要检查系统权限与依赖。
Computer Use 需要把权限授予运行 Mica 桌面端的应用,修改后重启该应用。其他平台不会注册它的桌面操作 Skill。 运行条件的探测依赖桌面宿主,普通浏览器中的配置页不一定能提供同样的系统检查。
需要继续定位时,插件详情会提供跳过或错误原因;加载记录位于 $MICA_HOME/plugin-status.json,插件设置位于 $MICA_HOME/plugin-settings/。 Harness Review 适合复盘运行记录中的重复调用、失败与重试;其候选需要人工判断,不会自动修改指令、工具或记忆,也不替你执行评测。