大家好,我是不如摸鱼去,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 |
接入方式还是熟悉的两条命令:
bash
wot agent init --client opencode
wot agent doctor --client opencode
wot agent init --client antigravity
wot agent doctor --client antigravity
多个客户端也可以一次处理:
bash
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 |

映射表不是全局替换脚本。迁移时还要检查:
<wd-icon>的nameicon、iconClass、activeIcon、inactiveIconprefixIcon、suffixIcon- 对象配置和动态绑定中的图标值
有推荐映射的静态图标可以按表处理;noMatch、动态值和自定义图标需要人工判断。替换后也要回归大小写、业务语义和视觉效果。
migrate-v1-to-v2是 open-wot 仓库内的迁移 Skill 和配套资产,不在@wot-ui/cli1.1.0 的 npm 默认发布文件中。wot agent init默认安装的仍然是wot-ui-v2Skill。
离线知识同步到 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 也同步到了最新版。
bash
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 或更高版本。
bash
npm install -g @wot-ui/cli@latest
wot agent init --client <client>
wot agent doctor --client <client>
<client> 支持 claude、cursor、vscode、codex、opencode、antigravity 和 all。
想先确认会修改哪些文件,可以使用:
bash
wot agent init --client opencode --dry-run
完整文档已经更新到官网:cli.wot-ui.cn/
少猜一个 API,少错一个图标,省下来的时间就可以安心摸鱼了。
相关资源
- Open Wot 官网:cli.wot-ui.cn/
@wot-ui/cli1.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...