宿主使用指南
在 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@foundryCodex 通过 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 数据损坏。