Mirasim 文档

第 16 章

Skills、MCP 与工具

管理 skills、MCP 服务与连接器,查看本机命令行工具,开启 Computer Use 操作浏览器和应用。

Skills

skill 是一份命名的、可复用的说明,例如测试怎么跑、部署流程是什么。任务需要时智能体会自行加载。

在输入区输入 /,会列出你的 skills 和智能体的内置命令。安装时可选全局作用域(各处可用)或工作区作用域,后者保存在 <工作区>/.mirasim 下。

管理 skills
mirasim ui-cli --port 4970 skill list                       # workspace + global
mirasim ui-cli --port 4970 skill install --source https://github.com/o/r --scope global
mirasim ui-cli --port 4970 skill create --name run-our-tests --scope workspace
mirasim ui-cli --port 4970 skill update --name run-our-tests
mirasim ui-cli --port 4970 skill remove --name run-our-tests

MCP 服务

MCP 服务可以是本机命令或一个地址,可带环境变量。添加后,它的工具与内置工具并列可用。服务分全局和工作区两种作用域;列表里同时显示 Mirasim 管理的服务和智能体自带的服务。

添加、启停与探活
mirasim ui-cli --port 4970 mcp list
mirasim ui-cli --port 4970 mcp add --name gh \
  --command npx --arg -y --arg @some/mcp-server --scope global
mirasim ui-cli --port 4970 mcp toggle --name gh --enabled false
mirasim ui-cli --port 4970 mcp health --name gh     # live handshake probe

连接器

连接器是基于 MCP 的一份精选目录。安装后配置凭据或选择远端运行,再按智能体分别启用。可以对照真实服务校验连接器,令牌过期后可重新完成 OAuth 授权。

连接器的生命周期
mirasim ui-cli --port 4970 connectors list
mirasim ui-cli --port 4970 connectors install SOME_ID --mode remote --secret KEY=value
mirasim ui-cli --port 4970 connectors enable SOME_ID --agent claude
mirasim ui-cli --port 4970 connectors validate SOME_ID    # records tool count / error
mirasim ui-cli --port 4970 connectors auth SOME_ID        # (re)start OAuth, prints the URL
mirasim ui-cli --port 4970 connectors search "issue tracker"   # the official registry

连接器搜索也会查询官方 MCP 注册表。

本机已安装的命令行工具

Mirasim 会列出 PATH 上常见的开发命令行工具,例如 git、gh、docker,并显示各自是否已登录。

已安装与已登录的情况
mirasim ui-cli --port 4970 cli-tools    # dev CLIs on PATH + auth state
mirasim ui-cli --port 4970 clis         # agent CLIs: version / latest / update available

Computer Use

Computer Use 是一个工具,由当前会话的智能体调用,调用跟随你的会话,包括该会话的模型与账号。

打开设置 → Computer Use 并启用功能,默认关闭。开启你需要的连接,然后在会话里描述任务,例如检查页面或填写表单。

浏览器连接

内嵌浏览器
操作本机桌面工作台里的浏览器页面,包括端口与 HTML 预览,无需扩展或外部浏览器。没有本地桌面壳的主机会显示此连接不可用。
独立浏览器
操作使用独立数据目录的 Chrome 或 Chromium。点击「管理」可设置浏览器路径、数据目录,以及可选的「复制你的登录」;复制的是所选 Chrome 配置的一次性快照。
浏览器扩展
通过 Browser Bridge 操作你正在使用的浏览器,沿用已有登录状态。「管理」里显示连接状态和安装步骤;在浏览器扩展页开启开发者模式,加载 ~/.mirasim/gui/extension 目录即可安装。

三种连接可同时启用,各自保留浏览器状态与登录信息;复制登录只影响独立浏览器。智能体在每次调用时选择使用哪种连接。

macOS 应用

启用「macOS 应用」,点击「管理」检查权限。「辅助功能」用于读取控件和操作应用;「屏幕录制」用于截图和操作预览。按面板提示前往 macOS 系统设置授权,返回 Mirasim 后会重新检测。

智能体操作「始终允许的应用」名单以外的应用时,会话里会请求授权,允许后只对当前任务有效。要不再询问某个应用,在设置 → Computer Use →「始终允许的应用」中添加,之后也可在这里移除。

Electron 应用

Computer Use 也可以操作开放了渲染进程调试端口的 Electron 应用。先为目标应用开启调试端口,再把连接地址告诉会话里的智能体。

操作预览

开启「操作预览」可以观看智能体正在操作的浏览器或应用,预览只读。关闭预览只是隐藏画面,会话仍会继续工作;停止任务请使用单独的停止控件,或停止会话轮次。

查看并启用 Computer Use
mirasim ui-cli --port 4970 computer-use
mirasim ui-cli --port 4970 config set computerUse.guiAgentEnabled=true

这一页有错或缺了什么? 告诉我们