Usora

宿主使用指南

在 Codex、CodeBuddy 和手动 MCP 环境中安装、调用与排查 Usora。

Usora 当前提供 Codex 与 CodeBuddy 原生适配。安装后请打开新 task,再让宿主发现新的 MCP tools。

安装插件

选择你的宿主环境:

添加 marketplace 后安装 foundry:

codex plugin marketplace add https://github.com/LuoMingxiang/usora.git
codex plugin add usora@foundry

Codex 通过 plugins/foundry/.codex-plugin/plugin.json 加载插件,并从插件根目录的 .mcp.json 解析 bundled MCP server。

常用调用

Initialize my Usora
Show Usora status
Capture this session into Usora
Show recent Candidates
Show recent Skills

故障排查

如果工具仍显示旧版本,刷新或重启宿主并开启新 task。

如果 UI 报 upgrade failed,但插件详情页版本已更新、缓存目录存在、新 task 能看到预期 tools,通常是宿主 reload 失败,不是 Usora 数据损坏。

On this page