@wot-ui/cli 1.0.4 → 1.0.5-beta.1

package/dist/{server-Cbs8eIrc.mjs → server-B4R7zC43.mjs}

@@ -1,4 +1,4 @@
-import { a as findComponent, d as resolveVersion, f as loadMetadataFile, i as lintProject, m as version, n as getCliUpdateStatus, o as listComponents, p as name } from "./update-check-DlG1c3ZB.mjs";
+import { _ as version, c as toComponentSummary, g as name, h as loadMetadataFile, i as lintProject, l as toDemoSummary, m as resolveVersion, n as getCliUpdateStatus, o as findComponent, s as listComponents } from "./update-check-YZ9xD4u9.mjs";
 import process from "node:process";
 import { McpServer, StdioServerTransport } from "@modelcontextprotocol/server";
 import * as z from "zod/v4";
@@ -22,6 +22,9 @@ const WOT_PAGE_GENERATOR_PROMPT = [
 function jsonText(value) {
 	return JSON.stringify(value, null, 2);
 }
+function compactJsonText(value) {
+	return JSON.stringify(value);
+}
 function registerMcpTools(server, options = {}) {
 	server.registerTool("wot_status", {
 		description: "Get wot-ui MCP server and CLI update status.",
@@ -61,7 +64,7 @@ function registerMcpTools(server, options = {}) {
 	}, async ({ version: version$1 }) => {
 		return { content: [{
 			type: "text",
-			text: jsonText({ components: listComponents(version$1) })
+			text: compactJsonText({ components: listComponents(version$1).map(toComponentSummary) })
 		}] };
 	});
 	server.registerTool("wot_info", {
@@ -140,7 +143,7 @@ function registerMcpTools(server, options = {}) {
 		};
 		if (!demo) return { content: [{
 			type: "text",
-			text: jsonText({ demos: result.demos ?? [] })
+			text: jsonText({ demos: (result.demos ?? []).map(toDemoSummary) })
 		}] };
 		const matched = result.demos?.find((item) => item.name.toLowerCase() === demo.toLowerCase());
 		if (!matched) return {

package/dist/{update-check-DlG1c3ZB.mjs → update-check-YZ9xD4u9.mjs}

@@ -2,13 +2,13 @@ import process from "node:process";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
 import { gunzipSync } from "node:zlib";
 import { parse } from "@vue/compiler-sfc";
-import { homedir } from "node:os";
 
 //#region package.json
 var name = "@wot-ui/cli";
-var version = "1.0.4";
+var version = "1.0.5-beta.1";
 
 //#endregion
 //#region src/data/loader.ts
@@ -201,6 +201,37 @@ function loadResolvedMetadata(version$1) {
 function listComponents(version$1) {
 	return loadResolvedMetadata(version$1).components;
 }
+function filterComponents(components, keyword) {
+	const normalized = keyword?.trim().toLowerCase();
+	if (!normalized) return components;
+	return components.filter((component) => {
+		return [
+			component.name,
+			component.nameZh,
+			component.tag,
+			component.category,
+			component.description,
+			component.descriptionZh
+		].some((value) => value.toLowerCase().includes(normalized));
+	});
+}
+function toComponentSummary(component) {
+	return {
+		name: component.name,
+		nameZh: component.nameZh,
+		tag: component.tag,
+		category: component.category,
+		description: component.descriptionZh || component.description,
+		since: component.since
+	};
+}
+function toDemoSummary(demo) {
+	return {
+		name: demo.name,
+		title: demo.title,
+		description: demo.description
+	};
+}
 function findComponent(name$1, version$1) {
 	const normalized = name$1.trim().toLowerCase();
 	return listComponents(version$1).find((component) => component.name.toLowerCase() === normalized || component.tag.toLowerCase() === normalized);
@@ -544,4 +575,4 @@ function writeCache(cacheFile, cache) {
 }
 
 //#endregion
-export { findComponent as a, formatStatusLabel as c, resolveVersion as d, loadMetadataFile as f, lintProject as i, writeStderrLine as l, version as m, getCliUpdateStatus as n, listComponents as o, name as p, analyzeUsage as r, formatLogMessage as s, checkForCliUpdate as t, detectVersion as u };
+export { version as _, filterComponents as a, toComponentSummary as c, formatStatusLabel as d, writeStderrLine as f, name as g, loadMetadataFile as h, lintProject as i, toDemoSummary as l, resolveVersion as m, getCliUpdateStatus as n, findComponent as o, detectVersion as p, analyzeUsage as r, listComponents as s, checkForCliUpdate as t, formatLogMessage as u };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wot-ui/cli",
   "type": "module",
-  "version": "1.0.4",
+  "version": "1.0.5-beta.1",
   "description": "面向 wot-ui 的 CLI、MCP 与数据提取工具集",
   "license": "MIT",
   "funding": "https://github.com/sponsors/antfu",
@@ -25,7 +25,9 @@
   },
   "files": [
     "data",
-    "dist"
+    "dist",
+    "skills/wot-ui-cli",
+    "skills/wot-ui-v2"
   ],
   "engines": {
     "node": ">=20.0.0"
@@ -35,6 +37,8 @@
     "@modelcontextprotocol/server": "2.0.0-alpha.2",
     "@vue/compiler-sfc": "^3.5.13",
     "commander": "^14.0.0",
+    "jsonc-parser": "^3.3.1",
+    "smol-toml": "^1.7.0",
     "zod": "^4.1.12"
   },
   "devDependencies": {

package/skills/wot-ui-cli/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: wot-ui-cli
+description: '回答、使用、调试 @wot-ui/cli 时使用。关键词：wot、@wot-ui/cli、CLI、MCP、doctor、usage、lint、list、info、doc、demo、token、changelog、extract、wot mcp。适用于命令查询、参数说明、MCP 接入、本地调试、数据提取与 open-wot 仓库维护。'
+argument-hint: '命令名、参数、MCP 场景、调试问题或数据提取需求'
+---
+
+# Wot UI CLI Skill
+
+这个 skill 用于让 Agent 在处理 `@wot-ui/cli` 本身相关的问题时，优先基于本仓库 README 与实际命令能力回答，而不是把它误当成纯组件库文档。
+
+## 适用场景
+
+- 用户询问 `wot` 命令怎么用。
+- 用户需要区分 `list`、`info`、`doc`、`demo`、`token`、`changelog`、`doctor`、`usage`、`lint`、`mcp`、`extract` 的用途。
+- 用户要接入 MCP Server，或需要 `wot mcp` 的配置与调试方法。
+- 用户要在本仓库中调试 `@wot-ui/cli`、验证构建产物、重新提取数据。
+- 用户的问题本质上是 open-wot 仓库维护问题，而不是单纯的 wot-ui 组件使用问题。
+
+## 适用范围
+
+- 关注对象是 `@wot-ui/cli` 这个工具包，以及仓库 `open-wot` 的开发维护流程。
+- 重点覆盖命令能力、通用参数、MCP、离线数据来源、提取流程、本地调试和发布包边界。
+- 如果任务是生成 `wd-*` 页面代码、解释组件 props 或给出主题定制方案，应优先使用 `wot-ui-v2` skill。
+
+## 推荐流程
+
+1. 先确认用户是在问 CLI 工具本身，还是在借 CLI 查询组件知识。
+2. 如果是命令使用问题，优先按命令类别回答：组件知识、项目分析、MCP、数据提取、仓库开发。
+3. 如果是仓库维护问题，优先给出本仓库里的实际调试命令，而不是泛泛而谈。
+4. 如果涉及组件内容本身，可引导或切换到 `wot-ui-v2` skill。
+
+## 命令分组
+
+### 组件知识查询
+
+- `wot list`
+- `wot info <Component>`
+- `wot doc <Component>`
+- `wot demo <Component> [name]`
+- `wot token [Component]`
+- `wot changelog [version] [component]`
+
+### 项目分析
+
+- `wot doctor [dir]`
+- `wot usage [dir]`
+- `wot lint [dir]`
+
+### MCP
+
+- `wot mcp`
+
+### 数据提取与仓库维护
+
+- `pnpm extract:cli --wot-dir ../wot-ui --output data/v2.json`
+- `pnpm extract:clone`
+- `pnpm exec tsx src/index.ts <command>`
+- `pnpm build`
+- `node dist/index.mjs <command>`
+
+## 工作规则
+
+- 包名是 `@wot-ui/cli`，实际可执行命令是 `wot`。
+- 回答命令问题时，优先用仓库 README 中已承诺的行为和参数，不臆造未声明子命令。
+- 回答本地调试问题时，优先给源码入口：`pnpm exec tsx src/index.ts ...`。
+- 回答构建产物问题时，再给 `node dist/index.mjs ...`。
+- 回答 MCP 问题时，要说明 `wot mcp` 走 stdio，终端无交互输出通常是正常现象。
+- 回答提取逻辑问题时，要说明数据主要来自上游 `wot-ui/wot-ui` 的 markdown 与 SCSS 源码。
+- 当用户问的是组件知识但入口是 CLI，也要保留“这是通过 CLI 查询组件知识”这一层语义。
+
+## 参考资料
+
+- [Wot UI CLI 概览](./references/overview.md)

package/skills/wot-ui-cli/references/overview.md

@@ -0,0 +1,215 @@
+# Wot UI CLI Overview
+
+本文件根据本仓库 README 整理，目标是让 Agent 快速理解 `@wot-ui/cli` 的能力边界、命令分组、MCP 接入方式、开发调试路径与数据来源。
+
+## Package Identity
+
+- 包名：`@wot-ui/cli`
+- 仓库：open-wot
+- 可执行命令：`wot`
+- 核心定位：wot-ui 的 AI 工具链仓库，提供 CLI、MCP Server、离线组件知识库与数据提取脚本。
+
+## Repository Positioning
+
+- 面向 wot-ui v2 的组件知识查询工具。
+- 面向本地项目的组件使用分析与 lint 工具。
+- 面向 AI 客户端的 MCP stdio 服务。
+- 面向仓库维护者的数据提取与同步工作流。
+
+## Core Capabilities
+
+### Component Knowledge
+
+- `list`：列出可用组件。
+- `info <Component>`：查看 props、events、slots、CSS 变量。
+- `doc <Component>`：输出组件 markdown 文档。
+- `demo <Component> [name]`：查看 demo 列表或指定 demo 源码。
+- `token [Component]`：查看组件 CSS 变量与默认值。
+- `changelog [version] [component]`：查看版本更新记录。
+
+### Project Analysis
+
+- `doctor [dir]`：检查项目依赖、运行环境与基础集成情况。
+- `usage [dir]`：统计 `.vue` 文件中的 `wd-*` 使用情况。
+- `lint [dir]`：检查未知组件、空按钮等规则。
+
+### MCP Server
+
+- `mcp`：启动 MCP stdio server。
+
+## Typical User Flows
+
+### Query Component Knowledge Through CLI
+
+常用顺序：
+
+1. `wot list`
+2. `wot info Button`
+3. `wot demo Button basic`
+4. `wot doc Button`
+5. `wot token Button`
+
+### Analyze A Local Project
+
+常用顺序：
+
+1. `wot doctor ./my-project`
+2. `wot usage ./my-project`
+3. `wot lint ./my-project`
+
+### Run MCP In A Client
+
+推荐自动接入：
+
+```bash
+wot agent init --client cursor
+wot agent status --client cursor
+wot agent doctor --client cursor
+```
+
+只管理 MCP 时使用：
+
+```bash
+wot mcp init --client cursor
+wot mcp print --client cursor
+wot mcp status --client cursor
+wot mcp doctor --client cursor
+wot mcp remove --client cursor
+```
+
+所有写操作支持 `--dry-run`；Agent 或 CI 非交互执行时显式传入 `--yes`。
+
+典型配置：
+
+```json
+{
+  "mcpServers": {
+    "wot-ui": {
+      "command": "npx",
+      "args": ["-y", "@wot-ui/cli", "mcp"]
+    }
+  }
+}
+```
+
+当前 README 明确列出的 MCP tools 有：
+
+- `wot_list`
+- `wot_info`
+- `wot_doc`
+- `wot_demo`
+- `wot_token`
+- `wot_changelog`
+- `wot_lint`
+
+## Common Flags
+
+多数查询命令支持：
+
+- `--format text`
+- `--format json`
+- `--version v2`
+
+## Install And Run
+
+### Global Install
+
+```bash
+npm install -g @wot-ui/cli
+```
+
+安装后直接用 `wot`。
+
+### Source Mode In This Repo
+
+```bash
+pnpm exec tsx src/index.ts list
+pnpm exec tsx src/index.ts info Button
+pnpm exec tsx src/index.ts mcp
+```
+
+适合本地调试源码，不依赖全局安装。
+
+### Built Artifact Mode
+
+```bash
+pnpm build
+node dist/index.mjs list
+```
+
+适合验证构建产物行为。
+
+## MCP Operational Notes
+
+- `wot mcp` 走 stdio。
+- 终端里没有交互输出通常是正常现象。
+- 若要调试 tool 与 prompt 调用过程，建议配合 MCP Inspector 或编辑器内置 MCP 客户端。
+
+## Data Source And Extraction
+
+当前版本聚焦 `wot-ui v2`。
+
+离线数据主要提取自上游 `wot-ui/wot-ui` 的：
+
+- `docs/component/*.md`
+- `docs/guide/changelog.md`
+- `src/uni_modules/wot-ui/components/*/index.scss`
+
+重新生成数据有两种方式：
+
+### Use A Local Wot UI Repo
+
+```bash
+pnpm extract:cli --wot-dir ../wot-ui --output data/v2.json
+```
+
+### Clone Latest Upstream And Extract
+
+```bash
+pnpm extract:clone
+```
+
+## Repo Layout
+
+- `src`：CLI、MCP 与项目分析源码。
+- `data`：离线组件元数据。
+- `scripts`：提取脚本。
+- `skills`：面向 Agent 的技能说明。
+- `test`：根包测试。
+
+## Local Development Commands
+
+### Environment
+
+- Node.js `>= 20`
+- pnpm `10.x`
+
+### Install
+
+```bash
+pnpm install
+```
+
+### Common Validation
+
+```bash
+pnpm lint
+pnpm test:all
+pnpm build:all
+pnpm typecheck:all
+```
+
+### Package-Level Commands
+
+```bash
+pnpm build
+pnpm test
+pnpm typecheck
+```
+
+## Agent Guidance
+
+- 如果用户问的是命令怎么用，按“命令组 + 示例命令 + 输出用途”来回答。
+- 如果用户问的是仓库维护或调试，优先给本仓库中的真实命令和目录。
+- 如果用户问的是组件本身怎么写页面，不要停留在 CLI 层，应切换到 `wot-ui-v2` skill。
+- 不要把 `wot` 命令和 `@wot-ui/ui` 组件库 API 混为一谈。

package/skills/wot-ui-v2/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: wot-ui-v2
+description: '回答、生成、重构、排查 wot-ui v2 相关代码时使用。关键词：wot-ui、uni-app、Vue3、wd-、ConfigProvider、useToast、useDialog、Form、Popup、theme、llms-full。适用于组件选型、API 查询、示例页面生成、主题定制、常见坑排查。'
+argument-hint: '组件名、页面场景、问题描述或主题定制需求'
+---
+
+# Wot UI V2 Skill
+
+这个 skill 用于让 Agent 在处理 wot-ui v2 相关任务时，优先采用组件库既有能力、遵守 uni-app 场景限制，并结合本仓库提供的 `wot` CLI 查询离线知识。
+
+## 适用场景
+
+- 用户询问某个 `wd-*` 组件的基础用法、属性、事件、插槽或样式变量。
+- 需要生成或重构 `uni-app + Vue 3 + TypeScript` 的 wot-ui 页面或组件代码。
+- 需要在 `ConfigProvider`、主题变量、暗黑模式、国际化、反馈类 hooks、表单等场景下给出正确做法。
+- 需要排查文档中常见的 `Toast`、`Dialog`、`Popup`、`Tabs`、`Slider`、样式覆盖问题。
+- 用户只是泛化地提到主题定制，但还没有明确要求按“单文件主题 SCSS + App.vue 只 `@use`”的结构生成时。
+
+## 推荐流程
+
+1. 先用本仓库 CLI 或 MCP 工具查组件知识。
+2. 再根据项目实际安装方式决定导入路径与集成方式。
+3. 优先复用现成的 `wd-*` 组件、hooks、主题变量与组合模式，不要退化成原生标签堆砌。
+4. 如果问题涉及约束或坑位，再查阅 [参考知识](./references/overview.md)。
+5. 如果用户明确要求生成 `src/themes/styles/{主题名}.scss` 单文件主题，并把挂载逻辑收进主题文件，优先切换到 `create-wot-ui-theme` skill。
+
+## 查询顺序
+
+1. `wot list` 找组件名。
+2. `wot info <Component>` 看 props、events、slots、CSS 变量。
+3. `wot demo <Component>` 看 demo 名称或具体 demo 代码。
+4. `wot doc <Component>` 看完整 markdown 文档。
+5. `wot token <Component>` 看主题变量。
+
+## 工作规则
+
+- 默认把 wot-ui 视为 `uni-app + Vue 3 + TypeScript` 组件库。
+- 写页面时优先输出 `script setup` 风格。
+- 反馈类能力如 `useToast`、`useDialog`、`useNotify`、`useImagePreview`、`useVideoPreview`，除了 hook 调用外，通常还需要页面内显式声明对应组件实例。
+- 文档里经常出现 `@/uni_modules/wot-ui` 导入路径；如果用户项目采用 npm 安装，应切换成 `@wot-ui/ui`。
+- 主题定制优先走 `ConfigProvider` 和 CSS 变量，不优先建议深度覆盖内部类名。
+- 生成代码时尽量沿用组件库文档里的命名和交互模式，例如 `v-model:visible`、`before-confirm`、`confirm`、`change`、`custom-class`、`custom-style`。
+
+## 参考资料
+
+- [Wot UI V2 概览](./references/overview.md)

package/skills/wot-ui-v2/references/overview.md

@@ -0,0 +1,85 @@
+# Wot UI V2 Overview
+
+本文件根据 wot-ui v2 的 `llms-full.txt` 与本仓库现有 CLI 工作流提炼，目标是帮助 Agent 快速掌握适合生成代码与回答问题的高价值知识，而不是逐字复制官方文档。
+
+## Product Positioning
+
+- Wot UI v2 是面向 `uni-app` 的 `Vue 3 + TypeScript` 组件库。
+- 覆盖微信小程序、支付宝小程序、钉钉小程序、H5、APP 等平台。
+- 组件命名统一为 `wd-*`。
+- 组件库强调 AI 友好、主题定制、暗黑模式、国际化与跨端一致性。
+
+## Installation And Integration
+
+- npm 安装：`pnpm add @wot-ui/ui`
+- 使用前需要安装 `sass`。
+- `uni_modules` 安装模式天然支持 easycom 自动引入。
+- npm 安装模式通常需要配置 vite resolver 或 easycom。
+- CLI 项目在 npm 模式下可在 `tsconfig.json` 中加入 `@wot-ui/ui/global` 以增强全局组件类型提示。
+
+## Import Rules
+
+- npm 安装项目：组合式函数、类型和工具优先从 `@wot-ui/ui` 导入。
+- `uni_modules` 安装项目：文档中的 `@/uni_modules/wot-ui` 路径通常可直接使用。
+- 官方文档示例很多基于 `uni_modules` 路径，回答时要按用户项目实际安装方式转换。
+
+## High Value Conventions
+
+- 反馈类组件不能依赖全局挂载。页面内通常需要显式写出 `wd-toast`、`wd-dialog`、`wd-notify`、`wd-image-preview`、`wd-video-preview` 等实例。
+- `useToast`、`useDialog`、`useNotify`、`useQueue` 等 hooks 基于 `provide/inject`，应在 `setup` 中调用。
+- 页面内如果存在多个 `wd-dialog` 或 `wd-toast`，需要通过 `selector` 区分，否则可能出现实例冲突或重复弹出。
+- 自定义组件中如果要覆盖 wot-ui 内部样式，小程序环境通常需要把组件配置为 `styleIsolation: 'shared'`。
+- 在 `Popup`、`ActionSheet`、`DropDownItem` 等延迟渲染弹层里使用 `Slider`、`Tabs` 等依赖尺寸计算的组件时，打开后应调用实例方法重新初始化，例如 `initSlider()` 或 `updateLineStyle()`。
+
+## Theme And Styling
+
+- 主题定制优先走 CSS 变量。
+- Design Token 分三层：基础变量、语义变量、组件变量。
+- 局部或全局主题可通过 `wd-config-provider` 的 `theme` 和 `theme-vars` 控制。
+- 深色模式通过 `wd-config-provider theme="dark"` 开启。
+- 更推荐覆盖语义变量或组件变量，不推荐优先依赖深层 class 选择器覆盖。
+
+## Common UI Patterns
+
+- 表单场景优先组合 `wd-form`、`wd-form-item`、`wd-input`、`wd-textarea`、`wd-picker`、`wd-calendar`、`wd-select-picker`。
+- 弹层类场景优先使用 `wd-popup`、`wd-dialog`、`wd-action-sheet`、`wd-tooltip`、`wd-popover`。
+- 反馈类场景优先使用 `useToast`、`useDialog`、`useNotify`，不要直接手写临时弹层。
+- 列表和展示类场景优先考虑 `wd-cell`、`wd-card`、`wd-tag`、`wd-badge`、`wd-empty`、`wd-loadmore`、`wd-skeleton`。
+- 导航与布局类场景优先考虑 `wd-navbar`、`wd-tabs`、`wd-tabbar`、`wd-sidebar`、`wd-row`、`wd-col`、`wd-gap`。
+
+## Interaction Patterns
+
+- 大量组件采用 `v-model` 或 `v-model:visible` 控制状态。
+- 表单和选择类组件普遍提供 `confirm`、`change`、`close` 等事件。
+- 反馈组件常通过 hook 返回方法对象，例如 `toast.success()`、`dialog.confirm()`。
+- `Popover`、`Tooltip`、`SwipeAction` 等场景常与 `useQueue().closeOutside()` 配合，实现点击外部关闭。
+
+## Component Selection Hints
+
+- 需要主操作按钮时用 `wd-button`，不要先写原生 `button`。
+- 需要列表入口、设置页、表单容器时优先用 `wd-cell` 和 `wd-cell-group`。
+- 需要轻量提示时优先用 `useToast`；需要确认交互时优先用 `useDialog`。
+- 需要单选或多选弹层时优先用 `wd-select-picker`、`wd-picker`、`wd-cascader`。
+- 需要统一主题或暗黑模式时优先用 `wd-config-provider`。
+
+## Common Pitfalls
+
+- `Toast`、`Dialog` 等函数式调用没有效果，先检查页面里是否声明了对应组件实例。
+- 同一个页面里多个无 `selector` 的反馈组件可能相互干扰。
+- npm 模式使用国际化时，开发态可能需要在 Vite 的 `optimizeDeps.exclude` 中排除 `@wot-ui/ui`。
+- 文档里的导入路径和项目实际安装方式不一致时，回答要主动修正。
+- 在弹层中直接渲染依赖尺寸测量的组件时，初始化时机往往比 API 本身更关键。
+
+## AI Response Heuristics
+
+- 回答基础用法时，优先给最小可运行模板，再补充常用 props。
+- 生成页面时，优先给完整的 `template + script setup + style` 结构。
+- 如果项目已使用 wot-ui，不要建议换用其他 UI 库。
+- 如果 wot-ui 已有现成组件，就不要用原生结构重复造轮子。
+- 如果用户只问某个组件，优先给该组件最常见 3 到 5 个用法，不要把整份文档全部展开。
+
+## Repo-Specific Workflow
+
+- 在本仓库中，优先使用 `wot list`、`wot info`、`wot doc`、`wot demo`、`wot token` 获取组件知识。
+- 当仓库数据与线上文档不一致时，以用户目标为准，并明确指出仓库离线数据可能需要重新提取。
+- 若要补数据或修提取逻辑，关注 `scripts/extract.ts`、`data/v2.json`、`src/data/*` 与相应命令实现。