本页内容

插件与能力管理

记忆、联网搜索、子代理和手机访问等能力通过插件提供。在设置中选择需要的插件,再按会话调整工具与参数,让每项工作使用合适的能力。

从 Settings → Plugins 开始

桌面端打开 Settings → Plugins;终端可用 /config 打开配置页,再进入 Plugins。 插件目录区分随产品分发的官方插件与本机安装的用户插件。点开卡片查看配置、加载状态,以及插件声明的运行条件和操作。

官方插件已随 Mica 分发,无需逐个下载。常驻会话宿主会监听 plugins-state.json:空闲时对齐插件启停状态; 正在运行的轮次不会被打断,变更在该轮结束后或下一轮开始前对齐。mica exec 等一次性宿主在装配时读取状态。 新增用户插件目录不会单凭目录变化触发同步;可以启动新宿主装配。常驻宿主在启停名单变化时也会重新扫描用户插件。 配置页“重新加载”刷新目录信息,不能视为已重启运行中的宿主。 普通设置在保存后由插件后续读取,具体取决于插件何时读取该项设置。

表单改动停下后自动保存,先留意字段校验与保存状态。目录卡片区分“已停用”“已加载”“已跳过”和“尚未加载”;启停状态与宿主完成同步之间可能有短暂延迟。

区分插件、默认能力与会话设置

调整位置影响范围适合做什么
Settings → Plugins插件是否加载,以及插件参数的默认值。停用整项功能,配置搜索地址、记忆整理或插件模型。
Settings → CapabilitiesTools、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;例如:

JSON
{
  "searxngUrl": "http://127.0.0.1:8080",
  "defaultCount": "5"
}

实例未启动、未开放 JSON 格式或网络不可达时,搜索会返回错误,并在插件健康状态中显示原因。 内置 web_fetch 负责读取具体 URL,不依赖 SearXNG。

插件使用哪个模型

自动命名、压缩摘要、记忆整理和提交说明等功能可能发起额外模型请求。声明了模型接口的插件会显示“复用当前会话模型”开关,通常默认开启;以插件详情中的实际设置为准。 复用时使用当前会话选择的服务与模型,没有会话的一次性插件操作使用全局模型配置。

关闭复用后,可以为插件填写独立的接口地址、Key、协议与模型,例如为摘要选择另一项服务。 使用“测试连接”确认接口可达;它会发送一次最小模型请求。支持按会话配置的模型字段,也可在会话设置中覆盖或恢复默认。

独立接口失败时,通用模型接口会尝试用当前会话模型重发,并在健康状态显示降级原因;成功降级后会继续使用该模型,直到相关配置发生变化。 会话中的插件模型调用可在 Stats 按来源查看。模型选择、输入内容与服务计费都会影响实际开销。

安装用户插件

将完整插件目录放入 ~/.mica/plugins/;设置 MICA_HOME 后改为 $MICA_HOME/plugins/。 按插件作者说明准备依赖,再刷新插件目录并启动新的宿主。典型结构如下:

TEXT
~/.mica/plugins/
└── my-workflow/
    ├── plugin.json
    ├── index.mjs
    └── skills/
        └── review/
            └── SKILL.md

plugin.json 声明插件身份、入口、设置与所需能力,入口为默认导出 setup(ctx) 的 JavaScript 模块。 用户插件建议分发可运行的 .js 或 .mjs 入口;没有清单的目录或单独散落的脚本不会被识别。运行时会给用户插件 ID 加上 user. 前缀。

插件可以一起提供工具、命令、提示词和 Skills。Skill 是模型按需读取的工作指南,MCP 是连接外部工具服务的协议,它们都可以单独配置,不必为了添加一份 Skill 或一个 MCP 服务编写插件。 文件位置与示例见 Skills、MCP 与角色。

插件没有生效时

  1. 确认插件已启用且宿主已完成同步;检查当前会话是否关闭了相关工具、Skill 或 MCP 服务。
  2. 在插件详情查看加载状态与宿主。显示“已跳过”时先阅读缺少的能力;例如依赖桌面宿主的插件会在 TUI 中跳过。
  3. 区分“尚未加载”、加载失败与运行报错。没有加载记录时不能据此判断插件是否工作,先在目标宿主打开会话再检查。
  4. 检查设置校验、模型连接和外部服务;有“运行条件”的插件还要检查系统权限与依赖。

Computer Use 需要把权限授予运行 Mica 桌面端的应用,修改后重启该应用。其他平台不会注册它的桌面操作 Skill。 运行条件的探测依赖桌面宿主,普通浏览器中的配置页不一定能提供同样的系统检查。

需要继续定位时,插件详情会提供跳过或错误原因;加载记录位于 $MICA_HOME/plugin-status.json,插件设置位于 $MICA_HOME/plugin-settings/。 Harness Review 适合复盘运行记录中的重复调用、失败与重试;其候选需要人工判断,不会自动修改指令、工具或记忆,也不替你执行评测。

文档随项目持续更新编辑此页