wot-ui-cli 1.1.0 发布:支持 OpenCode、Antigravity,wot-ui 图标迁移不再靠猜
大家好,我是不如摸鱼去,wot-ui 的发起人,欢迎来到我的 AI Coding 分享专栏。
@wot-ui/cli 1.1.0 已于 2026 年 8 月 19 日正式发布。这次新增 OpenCode 和 Antigravity 接入,支持的 AI 编程客户端增至 6 个;open-wot 仓库 skills 补齐 295 个 v1 图标的人工审核数据,离线组件知识也同步到了 wot-ui 2.3.2。
本次没有明确的 breaking changes,已经在使用 1.0.6 的项目可以直接升级。
- * *
AI 客户端从 4 个增加到 6 个
1.1.0 新增 OpenCode 和 Antigravity,目前支持:
| 客户端 | client id | 项目配置 | |
|---|---|---|---|
| Claude Code | `claude` | `.mcp.json` |
| Cursor | `cursor` | `.cursor/mcp.json` | |
|---|---|---|---|
| VS Code | `vscode` | `.vscode/mcp.json` |
| Codex | `codex` | `.codex/config.toml` | |
|---|---|---|---|
| OpenCode | `opencode` | `opencode.json` / `opencode.jsonc` |
| Antigravity | `antigravity` | `.agents/mcp_config.json` |
|---|
接入方式还是熟悉的两条命令:
wot agent init --client opencode
wot agent doctor --client opencode
wot agent init --client antigravity
wot agent doctor --client antigravity
多个客户端也可以一次处理:
wot agent init --client all
wot agent doctor --client all --timeout 30000
OpenCode 支持项目级和用户级配置。CLI 会识别 opencode.json[c]、.opencode/opencode.json[c] 和 ~/.config/opencode/opencode.json,保留原有配置与 JSONC 注释,并检查 MCP 注册、审批状态和工具权限过滤。
Antigravity 的项目配置是 .agents/mcp_config.json,用户配置是 ~/.gemini/config/mcp_config.json。CLI 会检查 disabled 和 disabledTools;由于客户端没有稳定的非交互式状态命令,doctor 会提示你在 Antigravity 内运行 /mcp 做最后确认。
Agent 接入仍由 MCP Server、wot-ui-v2 Skill 和 Instructions 组成。OpenCode 与 Antigravity 都会复用 .agents/skills/wot-ui-v2 和根目录 AGENTS.md,Antigravity 1.20.5 及以上版本可以读取项目规则。
MCP Server 提供 8 个工具:wot_status、wot_list、wot_info、wot_doc、wot_demo、wot_token、wot_changelog 和 wot_lint。
- * *
295 个 v1 图标完成逐项审核
v1 升 v2 时,图标不能只看名字猜。比如 add 可以换成 plus,但还有不少图标在新版中没有合适的直接对应项。
这次 open-wot 仓库内的 migrate-v1-to-v2 Skill 新增 icons.json 和完整迁移流程,审核范围为 wot-ui v1.14.0 到 v2.3.2:
| 审核结果 | 数量 | ||
|---|---|---|---|
| v1 图标总数 | 295 |
| 有推荐映射 | 194 | ||
|---|---|---|---|
| 其中同名 | 50 |
| 其中改名 | 144 | ||
|---|---|---|---|
| 没有合适的直接对应项 | 101 |
| 待审核 | 0 |
|---|
常见改名包括:
| v1 | v2 | v1 | v2 |
|---|---|---|---|
| `add` | `plus` | `add-circle` | `plus-circle` |
| `decrease` | `minus` | `arrow-left` | `left` |
|---|---|---|---|
| `search` | `search-line` | `more` | `more-vertical` |
| `picture` | `image` | `eye-close` | `eye-invisible` |
|---|---|---|---|
| `setting` | `settings` | `help` | `question` |
| `fullsreen` | `fullscreen` |
|---|
映射表不是全局替换脚本。迁移时还要检查:
- `
` 的 `name` - `icon`、`iconClass`、`activeIcon`、`inactiveIcon`
- `prefixIcon`、`suffixIcon`
- 对象配置和动态绑定中的图标值
有推荐映射的静态图标可以按表处理;noMatch、动态值和自定义图标需要人工判断。替换后也要回归大小写、业务语义和视觉效果。
> migrate-v1-to-v2 是 open-wot 仓库内的迁移 Skill 和配套资产,不在 @wot-ui/cli 1.1.0 的 npm 默认发布文件中。wot agent init 默认安装的仍然是 wot-ui-v2 Skill。
- * *
离线知识同步到 wot-ui 2.3.2
1.1.0 新增 data/v2.3.1.json 和 data/v2.3.2.json,每份包含 90 个组件。2.3 alias 从 2.3.0 更新到 2.3.2,data/v2.json 也同步到了最新版。
wot info Button --version 2.3.2
wot demo Button --version 2.3.2
wot token Button --version 2.3.2
wot changelog --version 2.3.2
这些数据随 npm 包安装。CLI 和 MCP 无需在线文档 API 或密钥,也能查询与版本匹配的组件 API、Demo、Token 和 Changelog。
- * *
其他更新
官网更换了 Logo,支持恢复默认主题色和锚点平滑滚动,并接入百度统计。beta 版本现在使用 npm beta dist-tag,不会占用 latest。
仓库还新增了 Bug、Feature Issue 模板和 PR 模板,并补充 npm keywords 与 funding 信息。
从 v1.0.6 到 v1.1.0 共 14 个 commits、45 个文件发生变化。对比中的 42,781 行新增主要来自离线数据快照,不代表功能代码膨胀了四万多行。
- * *
升级与接入
需要 Node.js 20 或更高版本。
npm install -g @wot-ui/cli@latest
wot agent init --client
wot agent doctor --client
支持 claude、cursor、vscode、codex、opencode、antigravity 和 all。
想先确认会修改哪些文件,可以使用:
wot agent init --client opencode --dry-run
完整文档已经更新到官网:cli.wot-ui.cn/
少猜一个 API,少错一个图标,省下来的时间就可以安心摸鱼了。
相关资源
- Open Wot 官网:cli.wot-ui.cn/
- `@wot-ui/cli` 1.1.0:www.npmjs.com/package/@wo…
- GitHub Release:github.com/wot-ui/open…
- 版本对比:github.com/wot-ui/open…
- Open Wot GitHub:github.com/wot-ui/open…
13 订阅
16 篇文章
Open Wot 1.0.5 发布:让 AI 接入 wot-ui,只需要两条命令
Aitishiku.com