@wot-ui/cli 0.0.1-beta.3 → 0.0.1-beta.6

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-PRESENT Wot UI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,13 +1,20 @@
-# @wot-ui/cli
+# open-wot
 
-`@wot-ui/cli` 是面向 wot-ui 的命令行工具包，提供组件知识查询、项目分析、MCP Server 与离线数据提取能力。
+open-wot 是 wot-ui 的 AI 工具链仓库，当前对外发布的核心包为 `@wot-ui/cli`。它提供命令行工具、MCP Server、离线组件知识库与数据提取脚本，用于把 wot-ui v2 的组件知识接入编辑器、AI Agent 和本地工程分析流程。
 
-## 能力概览
+## 仓库定位
 
-- 组件查询：`list`、`info`、`doc`、`demo`、`token`、`changelog`
+- 面向 wot-ui v2 的组件知识查询工具
+- 面向本地项目的组件使用分析与 lint 工具
+- 面向 AI 客户端的 MCP stdio 服务
+- 面向仓库维护者的数据提取与同步工作流
+
+## 核心能力
+
+- 组件知识查询：`list`、`info`、`doc`、`demo`、`token`、`changelog`
 - 项目分析：`doctor`、`usage`、`lint`
-- MCP 集成：`wot mcp`
-- 数据提取：从 `wot-ui/wot-ui` 源码生成 `data/v2.json`
+- MCP Server：`wot mcp`
+- 元数据提取：从 `wot-ui/wot-ui` 源码生成本地 `v2.json`
 
 ## 安装
 
@@ -15,37 +22,49 @@
 npm install -g @wot-ui/cli
 ```
 
-## 常用命令
+安装完成后可直接使用 `wot` 命令。
+
+如果你在仓库内本地调试，推荐直接运行源码入口，而不是依赖全局命令：
+
+```bash
+pnpm exec tsx src/index.ts list
+```
+
+## 快速开始
 
 ```bash
 wot list
 wot info Button
-wot doc Button
 wot demo Button basic
+wot doc Button
 wot token Button
 wot changelog
-wot doctor ./my-app
-wot usage ./my-app
-wot lint ./my-app
+wot doctor ./my-project
+wot usage ./my-project
+wot lint ./my-project
 wot mcp
 ```
 
 ## 命令说明
 
-- `wot list`：列出所有可用组件
-- `wot info <Component>`：查看组件基础信息
+### 组件知识
+
+- `wot list`：列出可用的 wot-ui 组件
+- `wot info <Component>`：查看组件 props、events、slots、CSS 变量
 - `wot doc <Component>`：输出组件 markdown 文档
-- `wot demo <Component> [name]`：查看示例列表或示例源码
-- `wot token [Component]`：查看 CSS 变量与默认值
+- `wot demo <Component> [name]`：查看 demo 列表或指定 demo 源码
+- `wot token [Component]`：查看组件 CSS 变量与默认值
 - `wot changelog [version] [component]`：查看版本更新记录
-- `wot doctor [dir]`：检查工程环境与依赖
-- `wot usage [dir]`：统计 `.vue` 中的 `wd-*` 使用情况
-- `wot lint [dir]`：运行 wot-ui 相关规则检查
-- `wot mcp`：启动 MCP stdio Server
 
-## 输出格式
+### 项目分析
+
+- `wot doctor [dir]`：检查项目依赖、运行环境与基础集成情况
+- `wot usage [dir]`：统计 `.vue` 文件中的 `wd-*` 使用情况
+- `wot lint [dir]`：检查未知组件、空按钮等规则
 
-部分命令支持：
+### 通用参数
+
+多数查询命令支持以下参数：
 
 - `--format text`
 - `--format json`
@@ -53,41 +72,120 @@ wot mcp
 - `--lang en`
 - `--version v2`
 
-## 提取数据
+## MCP 集成
+
+将以下配置加入支持 MCP 的客户端：
+
+```json
+{
+  "mcpServers": {
+    "wot-ui": {
+      "command": "wot",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+当前 MCP Server 提供以下 tools：
+
+- `wot_list`
+- `wot_info`
+- `wot_doc`
+- `wot_demo`
+- `wot_token`
+- `wot_changelog`
+- `wot_lint`
+
+## 数据来源
+
+当前版本聚焦 `wot-ui v2`。仓库内的离线数据来自 `wot-ui/wot-ui` 源码，主要提取自：
+
+- `docs/component/*.md`
+- `docs/guide/changelog.md`
+- `src/uni_modules/wot-ui/components/*/index.scss`
+
+重新生成本地数据有两种方式。
 
 使用本地已有的 wot-ui 仓库：
 
 ```bash
-pnpm extract --wot-dir ../wot-ui --output ./data/v2.json
+pnpm extract:cli --wot-dir ../wot-ui --output data/v2.json
 ```
 
-如果希望直接克隆上游仓库并提取，建议在仓库根目录执行：
+直接克隆最新的 wot-ui 仓库并提取：
 
 ```bash
 pnpm extract:clone
 ```
 
-提取脚本会输出当前处理阶段，包括数据源路径、扫描到的组件文档数量、解析结果与文件写入位置。
+## 开发本仓库
+
+当前根目录就是主发布包，核心源码位于 `src`，离线数据位于 `data`，提取脚本位于 `scripts`。
 
-## 开发调试
+### 环境要求
 
-在 `packages/cli` 内开发时，最方便的方式是直接运行源码：
+- Node.js `>= 20`
+- pnpm `10.x`
+
+### 安装依赖
+
+```bash
+pnpm install
+```
+
+### 常用开发命令
 
 ```bash
-pnpm --filter @wot-ui/cli exec tsx src/index.ts list
-pnpm --filter @wot-ui/cli exec tsx src/index.ts mcp
+pnpm lint
+pnpm test:all
+pnpm build:all
+pnpm typecheck:all
+pnpm build:cli
+pnpm test:cli
+pnpm typecheck:cli
 ```
 
-构建与测试命令：
+### 本地调试 CLI
+
+直接运行源码入口最方便：
 
 ```bash
-pnpm --filter @wot-ui/cli build
-pnpm --filter @wot-ui/cli test
-pnpm --filter @wot-ui/cli typecheck
+pnpm exec tsx src/index.ts list
+pnpm exec tsx src/index.ts info Button
 ```
 
+如果要调试构建产物：
+
+```bash
+pnpm build:cli
+node dist/index.mjs list
+```
+
+### 本地调试 MCP
+
+```bash
+pnpm exec tsx src/index.ts mcp
+```
+
+MCP 走 stdio，终端无交互输出属于正常现象。若要查看 tools 与 prompts 的调用过程，建议配合 MCP Inspector 或编辑器内置 MCP 客户端调试。
+
+## 自动化流程
+
+- `.github/workflows/ci.yml`：执行主包的 lint、typecheck、build、test
+- `.github/workflows/release.yml`：在 `v*` tag 上通过 reusable workflow 发布 `@wot-ui/cli`
+- `.github/workflows/sync.yml`：拉取上游 `wot-ui/wot-ui`，提取最新元数据，并自动创建同步 PR
+
 ## 当前边界
 
 - 当前仅支持 `wot-ui v2`
-- `usage` 和 `lint` 当前聚焦 `.vue` 文件
-- CSS 变量优先从组件 SCSS 源码提取
+- `usage` 与 `lint` 当前聚焦 `.vue` 文件中的 `<wd-*>` 标签及相关 import
+- 提取脚本优先从 SCSS 源码解析 CSS 变量，并在必要时回退到 markdown 表格
+
+## 相关文档
+
+- [CONTRIBUTING.md](CONTRIBUTING.md)：贡献与开发流程
+
+## License
+
+[MIT](./LICENSE) License © wot-ui

package/dist/index.mjs

@@ -1,10 +1,22 @@
 #!/usr/bin/env node
-import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent, t as analyzeUsage } from "./scanner-BFHnD5iE.mjs";
+import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent, s as version, t as analyzeUsage } from "./scanner-D0vLA-5K.mjs";
 import process from "node:process";
 import { Command } from "commander";
 import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 
+//#region src/utils/output.ts
+function writeStdout(message) {
+	process.stdout.write(message);
+}
+function writeLine(message = "") {
+	writeStdout(`${message}\n`);
+}
+function writeJson(value) {
+	writeLine(JSON.stringify(value, null, 2));
+}
+
+//#endregion
 //#region src/commands/shared.ts
 function addQueryOptions(command) {
 	return command.option("--format <format>", "output format: text, json, markdown", "text").option("--lang <lang>", "output language: zh, en", "zh").option("--version <version>", "target wot-ui version");
@@ -17,10 +29,10 @@ function normalizeQueryOptions(options) {
 	};
 }
 function printError(message, format) {
-	if (format === "json") console.log(JSON.stringify({
+	if (format === "json") writeJson({
 		error: true,
 		message
-	}, null, 2));
+	});
 	else console.error(message);
 }
 function getComponentLabel(component, lang) {
@@ -55,16 +67,15 @@ function registerChangelogCommand(program) {
 				return versionMatches && componentMatches;
 			});
 			if (query.format === "json") {
-				console.log(JSON.stringify({ entries }, null, 2));
+				writeJson({ entries });
 				return;
 			}
-			const lines = entries.flatMap((entry) => [
+			writeLine(entries.flatMap((entry) => [
 				`${entry.version}${entry.date ? ` (${entry.date})` : ""}`,
 				entry.summary,
 				...entry.highlights.map((item) => `- ${item}`),
 				""
-			]);
-			console.log(lines.join("\n").trim());
+			]).join("\n").trim());
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to load changelog", query.format);
 			process.exitCode = 1;
@@ -87,13 +98,13 @@ function registerDemoCommand(program) {
 			const demos = component.demos ?? [];
 			if (!demoName) {
 				if (query.format === "json") {
-					console.log(JSON.stringify({
+					writeJson({
 						component: component.name,
 						demos
-					}, null, 2));
+					});
 					return;
 				}
-				console.log(demos.map((demo$1) => `- ${demo$1.name}: ${demo$1.title}`).join("\n"));
+				writeLine(demos.map((demo$1) => `- ${demo$1.name}: ${demo$1.title}`).join("\n"));
 				return;
 			}
 			const demo = demos.find((item) => item.name.toLowerCase() === demoName.toLowerCase());
@@ -103,13 +114,13 @@ function registerDemoCommand(program) {
 				return;
 			}
 			if (query.format === "json") {
-				console.log(JSON.stringify({
+				writeJson({
 					component: component.name,
 					demo
-				}, null, 2));
+				});
 				return;
 			}
-			console.log(demo.code);
+			writeLine(demo.code);
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to load demo", query.format);
 			process.exitCode = 1;
@@ -130,13 +141,13 @@ function registerDocCommand(program) {
 				return;
 			}
 			if (query.format === "json") {
-				console.log(JSON.stringify({
+				writeJson({
 					name: component.name,
 					doc: component.doc
-				}, null, 2));
+				});
 				return;
 			}
-			console.log(component.doc);
+			writeLine(component.doc);
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to load documentation", query.format);
 			process.exitCode = 1;
@@ -156,8 +167,8 @@ function getDependencyVersion(pkg, name) {
 }
 function detectWotDependency(pkg) {
 	for (const name of ["wot-design-uni", "wot-ui"]) {
-		const version = getDependencyVersion(pkg, name);
-		if (version) return `${name}@${version}`;
+		const version$1 = getDependencyVersion(pkg, name);
+		if (version$1) return `${name}@${version$1}`;
 	}
 	if (pkg?.dependencies) {
 		const scoped = Object.keys(pkg.dependencies).find((name) => name.includes("wot"));
@@ -218,11 +229,10 @@ function registerDoctorCommand(program) {
 		try {
 			const report = diagnoseProject(resolve(dir));
 			if (query.format === "json") {
-				console.log(JSON.stringify(report, null, 2));
+				writeJson(report);
 				return;
 			}
-			const lines = [`Directory: ${report.dir}`, ...report.checks.map((check) => `${check.status.toUpperCase()} ${check.name}: ${check.message}${check.suggestion ? ` | ${check.suggestion}` : ""}`)];
-			console.log(lines.join("\n"));
+			writeLine([`Directory: ${report.dir}`, ...report.checks.map((check) => `${check.status.toUpperCase()} ${check.name}: ${check.message}${check.suggestion ? ` | ${check.suggestion}` : ""}`)].join("\n"));
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to diagnose project", query.format);
 			process.exitCode = 1;
@@ -243,10 +253,10 @@ function registerInfoCommand(program) {
 				return;
 			}
 			if (query.format === "json") {
-				console.log(JSON.stringify(component, null, 2));
+				writeJson(component);
 				return;
 			}
-			const lines = [
+			writeLine([
 				`${getComponentLabel(component, query.lang)} (${component.tag})`,
 				getComponentDescription(component, query.lang),
 				"",
@@ -264,8 +274,7 @@ function registerInfoCommand(program) {
 					const defaultValue = cssVar.defaultValue ?? cssVar.token;
 					return `- ${cssVar.name}${defaultValue ? ` = ${defaultValue}` : ""}: ${cssVar.description}`;
 				})
-			];
-			console.log(lines.join("\n"));
+			].join("\n"));
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to load component info", query.format);
 			process.exitCode = 1;
@@ -281,15 +290,14 @@ function registerLintCommand(program) {
 		try {
 			const report = lintProject(resolve(dir), query.version);
 			if (query.format === "json") {
-				console.log(JSON.stringify(report, null, 2));
+				writeJson(report);
 				return;
 			}
 			if (!report.issues.length) {
-				console.log(`No lint issues found. Scanned files: ${report.scannedFiles}`);
+				writeLine(`No lint issues found. Scanned files: ${report.scannedFiles}`);
 				return;
 			}
-			const lines = [`Scanned files: ${report.scannedFiles}`, ...report.issues.map((issue) => `${issue.severity.toUpperCase()} ${issue.file}:${issue.line} [${issue.rule}] ${issue.message}`)];
-			console.log(lines.join("\n"));
+			writeLine([`Scanned files: ${report.scannedFiles}`, ...report.issues.map((issue) => `${issue.severity.toUpperCase()} ${issue.file}:${issue.line} [${issue.rule}] ${issue.message}`)].join("\n"));
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to lint project", query.format);
 			process.exitCode = 1;
@@ -305,11 +313,10 @@ function registerListCommand(program) {
 		try {
 			const components = listComponents(query.version);
 			if (query.format === "json") {
-				console.log(JSON.stringify({ components }, null, 2));
+				writeJson({ components });
 				return;
 			}
-			const lines = components.map((component) => `- ${getComponentLabel(component, query.lang)} (${component.tag}): ${getComponentDescription(component, query.lang)}`);
-			console.log(lines.join("\n"));
+			writeLine(components.map((component) => `- ${getComponentLabel(component, query.lang)} (${component.tag}): ${getComponentDescription(component, query.lang)}`).join("\n"));
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to list components", query.format);
 			process.exitCode = 1;
@@ -321,7 +328,7 @@ function registerListCommand(program) {
 //#region src/commands/mcp.ts
 function registerMcpCommand(program) {
 	program.command("mcp").description("Start the wot-ui MCP server").action(async () => {
-		const { startMcpServer } = await import("./server-HjZltXBO.mjs");
+		const { startMcpServer } = await import("./server-BWgY0XHJ.mjs");
 		await startMcpServer();
 	});
 }
@@ -333,11 +340,10 @@ function registerTokenCommand(program) {
 		const query = normalizeQueryOptions(options);
 		try {
 			if (!componentName) {
-				const tokens = listComponents(query.version).flatMap((component$1) => component$1.cssVars.map((cssVar) => ({
+				writeJson(listComponents(query.version).flatMap((component$1) => component$1.cssVars.map((cssVar) => ({
 					component: component$1.name,
 					...cssVar
-				})));
-				console.log(JSON.stringify(tokens, null, 2));
+				}))));
 				return;
 			}
 			const component = findComponent(componentName, query.version);
@@ -347,17 +353,16 @@ function registerTokenCommand(program) {
 				return;
 			}
 			if (query.format === "json") {
-				console.log(JSON.stringify({
+				writeJson({
 					name: component.name,
 					cssVars: formatCssVars(component.cssVars)
-				}, null, 2));
+				});
 				return;
 			}
-			const lines = [component.name, ...component.cssVars.map((cssVar) => {
+			writeLine([component.name, ...component.cssVars.map((cssVar) => {
 				const defaultValue = cssVar.defaultValue ?? cssVar.token;
 				return `- ${cssVar.name}${defaultValue ? ` = ${defaultValue}` : ""}: ${cssVar.description}`;
-			})];
-			console.log(lines.join("\n"));
+			})].join("\n"));
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to query CSS variables", query.format);
 			process.exitCode = 1;
@@ -373,7 +378,7 @@ function registerUsageCommand(program) {
 		try {
 			const report = analyzeUsage(resolve(dir), query.version);
 			if (query.format === "json") {
-				console.log(JSON.stringify(report, null, 2));
+				writeJson(report);
 				return;
 			}
 			const lines = [
@@ -382,7 +387,7 @@ function registerUsageCommand(program) {
 				...report.components.map((component) => `- ${component.name} (${component.tag}): ${component.count} in ${component.files.join(", ")}`)
 			];
 			if (report.imports.length) lines.push("", "Imports:", ...report.imports.map((item) => `- ${item}`));
-			console.log(lines.join("\n"));
+			writeLine(lines.join("\n"));
 		} catch (error) {
 			printError(error instanceof Error ? error.message : "Failed to analyze project usage", query.format);
 			process.exitCode = 1;
@@ -394,7 +399,7 @@ function registerUsageCommand(program) {
 //#region src/app.ts
 function createCliProgram() {
 	const program = new Command();
-	program.name("wot").description("wot-ui AI toolkit CLI").version("0.0.0");
+	program.name("wot").description("wot-ui AI toolkit CLI").version(version);
 	registerListCommand(program);
 	registerInfoCommand(program);
 	registerDocCommand(program);

package/dist/{scanner-BFHnD5iE.mjs → scanner-D0vLA-5K.mjs}

@@ -4,6 +4,10 @@ import { fileURLToPath } from "node:url";
 import { gunzipSync } from "node:zlib";
 import { parse } from "@vue/compiler-sfc";
 
+//#region package.json
+var version = "0.0.1-beta.6";
+
+//#endregion
 //#region src/data/loader.ts
 const currentDir = dirname(fileURLToPath(import.meta.url));
 function resolveDataDir() {
@@ -48,15 +52,15 @@ function resolveVersion(requested) {
 
 //#endregion
 //#region src/data/metadata.ts
-function loadResolvedMetadata(version) {
-	return loadMetadataFile(resolveVersion(version));
+function loadResolvedMetadata(version$1) {
+	return loadMetadataFile(resolveVersion(version$1));
 }
-function listComponents(version) {
-	return loadResolvedMetadata(version).components;
+function listComponents(version$1) {
+	return loadResolvedMetadata(version$1).components;
 }
-function findComponent(name, version) {
+function findComponent(name, version$1) {
 	const normalized = name.trim().toLowerCase();
-	return listComponents(version).find((component) => component.name.toLowerCase() === normalized || component.tag.toLowerCase() === normalized);
+	return listComponents(version$1).find((component) => component.name.toLowerCase() === normalized || component.tag.toLowerCase() === normalized);
 }
 
 //#endregion
@@ -114,10 +118,10 @@ function collectImports(scriptContent) {
 	for (const match of scriptContent.matchAll(IMPORT_RE)) if (match[1]) imports.add(match[1]);
 	return [...imports];
 }
-function analyzeUsage(targetDir, version) {
+function analyzeUsage(targetDir, version$1) {
 	const dir = resolve(targetDir);
 	const files = walkFiles(dir, [".vue"]);
-	const knownByTag = new Map(listComponents(version).map((component) => [component.tag.toLowerCase(), component]));
+	const knownByTag = new Map(listComponents(version$1).map((component) => [component.tag.toLowerCase(), component]));
 	const usageMap = /* @__PURE__ */ new Map();
 	const imports = /* @__PURE__ */ new Set();
 	for (const file of files) {
@@ -148,7 +152,7 @@ function analyzeUsage(targetDir, version) {
 		imports: [...imports].sort()
 	};
 }
-function lintProject(targetDir, version) {
+function lintProject(targetDir, version$1) {
 	const dir = resolve(targetDir);
 	const files = walkFiles(dir, [".vue"]);
 	const issues = [];
@@ -157,7 +161,7 @@ function lintProject(targetDir, version) {
 		for (const match of template.matchAll(TAG_RE)) {
 			const tag = match[1]?.toLowerCase();
 			if (!tag) continue;
-			if (!findComponent(tag, version)) issues.push({
+			if (!findComponent(tag, version$1)) issues.push({
 				file: safeRelative(dir, file),
 				line: getLineNumber(template, match.index ?? 0),
 				rule: "unknown-component",
@@ -175,7 +179,7 @@ function lintProject(targetDir, version) {
 				severity: "warning",
 				message: "wd-button should include visible text content or an icon attribute."
 			});
-			const component = findComponent("wd-button", version);
+			const component = findComponent("wd-button", version$1);
 			for (const prop of component?.props ?? []) {
 				if (!prop.deprecated) continue;
 				if (!(/* @__PURE__ */ new RegExp(`\\b${prop.name}\\b`)).test(attrs)) continue;
@@ -196,4 +200,4 @@ function lintProject(targetDir, version) {
 }
 
 //#endregion
-export { resolveVersion as a, listComponents as i, lintProject as n, loadMetadataFile as o, findComponent as r, analyzeUsage as t };
+export { resolveVersion as a, listComponents as i, lintProject as n, loadMetadataFile as o, findComponent as r, version as s, analyzeUsage as t };

package/dist/{server-HjZltXBO.mjs → server-BWgY0XHJ.mjs}

@@ -1,4 +1,4 @@
-import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent } from "./scanner-BFHnD5iE.mjs";
+import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent, s as version } from "./scanner-D0vLA-5K.mjs";
 import process from "node:process";
 import { McpServer, StdioServerTransport } from "@modelcontextprotocol/server";
 import * as z from "zod/v4";
@@ -31,10 +31,10 @@ function registerMcpTools(server) {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, async ({ version }) => {
+	}, async ({ version: version$1 }) => {
 		return { content: [{
 			type: "text",
-			text: jsonText({ components: listComponents(version) })
+			text: jsonText({ components: listComponents(version$1) })
 		}] };
 	});
 	server.registerTool("wot_info", {
@@ -49,8 +49,8 @@ function registerMcpTools(server) {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, async ({ component, version }) => {
-		const result = findComponent(component, version);
+	}, async ({ component, version: version$1 }) => {
+		const result = findComponent(component, version$1);
 		if (!result) return {
 			isError: true,
 			content: [{
@@ -75,8 +75,8 @@ function registerMcpTools(server) {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, async ({ component, version }) => {
-		const result = findComponent(component, version);
+	}, async ({ component, version: version$1 }) => {
+		const result = findComponent(component, version$1);
 		if (!result?.doc) return {
 			isError: true,
 			content: [{
@@ -102,8 +102,8 @@ function registerMcpTools(server) {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, async ({ component, demo, version }) => {
-		const result = findComponent(component, version);
+	}, async ({ component, demo, version: version$1 }) => {
+		const result = findComponent(component, version$1);
 		if (!result) return {
 			isError: true,
 			content: [{
@@ -140,15 +140,15 @@ function registerMcpTools(server) {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, async ({ component, version }) => {
+	}, async ({ component, version: version$1 }) => {
 		if (!component) return { content: [{
 			type: "text",
-			text: jsonText({ components: listComponents(version).map((item) => ({
+			text: jsonText({ components: listComponents(version$1).map((item) => ({
 				name: item.name,
 				cssVars: item.cssVars
 			})) })
 		}] };
-		const result = findComponent(component, version);
+		const result = findComponent(component, version$1);
 		if (!result) return {
 			isError: true,
 			content: [{
@@ -176,11 +176,11 @@ function registerMcpTools(server) {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, async ({ version, component }) => {
+	}, async ({ version: version$1, component }) => {
 		return { content: [{
 			type: "text",
-			text: jsonText({ entries: (loadMetadataFile(resolveVersion(version)).changelog ?? []).filter((entry) => {
-				const versionMatches = version ? entry.version === version || `v${entry.version}` === version : true;
+			text: jsonText({ entries: (loadMetadataFile(resolveVersion(version$1)).changelog ?? []).filter((entry) => {
+				const versionMatches = version$1 ? entry.version === version$1 || `v${entry.version}` === version$1 : true;
 				const componentMatches = component ? (entry.components ?? []).some((item) => item.toLowerCase() === component.toLowerCase()) : true;
 				return versionMatches && componentMatches;
 			}) })
@@ -198,10 +198,10 @@ function registerMcpTools(server) {
 			idempotentHint: true,
 			openWorldHint: true
 		}
-	}, async ({ dir, version }) => {
+	}, async ({ dir, version: version$1 }) => {
 		return { content: [{
 			type: "text",
-			text: jsonText(lintProject(dir ?? process.cwd(), version))
+			text: jsonText(lintProject(dir ?? process.cwd(), version$1))
 		}] };
 	});
 }
@@ -211,7 +211,7 @@ function registerMcpTools(server) {
 async function startMcpServer() {
 	const server = new McpServer({
 		name: "wot-ui",
-		version: "0.0.0"
+		version
 	}, {
 		instructions: "Use wot-ui component tools before generating UI code. Only wot-ui v2 metadata is available in this server.",
 		capabilities: { logging: {} }

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "@wot-ui/cli",
   "type": "module",
-  "version": "0.0.1-beta.3",
-  "description": "CLI, MCP and skills toolkit for wot-ui",
+  "version": "0.0.1-beta.6",
+  "description": "面向 wot-ui 的 CLI、MCP 与数据提取工具集",
   "license": "MIT",
+  "funding": "https://github.com/sponsors/antfu",
   "homepage": "https://github.com/wot-ui/open-wot#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wot-ui/open-wot.git"
   },
   "bugs": "https://github.com/wot-ui/open-wot/issues",
+  "keywords": [],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
@@ -18,32 +25,57 @@
   },
   "files": [
     "data",
-    "dist",
-    "skills"
+    "dist"
   ],
   "engines": {
     "node": ">=20.0.0"
   },
+  "dependencies": {
+    "@cfworker/json-schema": "^4.1.1",
+    "@modelcontextprotocol/server": "^2.0.0-alpha.2",
+    "@vue/compiler-sfc": "^3.5.13",
+    "commander": "^14.0.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.6.1",
+    "@antfu/ni": "^28.0.0",
+    "@antfu/utils": "^9.3.0",
+    "@types/node": "^25.0.1",
+    "bumpp": "^10.3.2",
+    "eslint": "^9.39.2",
+    "lint-staged": "^16.2.7",
+    "publint": "^0.3.16",
+    "simple-git-hooks": "^2.13.1",
+    "tinyexec": "^1.0.2",
+    "tsdown": "^0.17.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15",
+    "vitest-package-exports": "^0.1.1",
+    "yaml": "^2.8.2"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
     "extract": "tsx scripts/extract.ts",
+    "extract:cli": "pnpm extract",
+    "extract:clone": "rm -rf /tmp/open-wot-wot-ui && git clone --depth 1 https://github.com/wot-ui/wot-ui.git /tmp/open-wot-wot-ui && pnpm extract --wot-dir /tmp/open-wot-wot-ui --output data/v2.json",
+    "lint": "eslint",
+    "release": "bumpp",
+    "start": "tsx src/index.ts",
     "test": "vitest run",
+    "test:all": "pnpm test",
+    "test:cli": "pnpm test",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@cfworker/json-schema": "catalog:cli",
-    "@modelcontextprotocol/server": "catalog:cli",
-    "@vue/compiler-sfc": "catalog:cli",
-    "commander": "catalog:cli",
-    "zod": "catalog:cli"
-  },
-  "devDependencies": {
-    "@types/node": "catalog:types",
-    "tsdown": "catalog:cli",
-    "tsx": "catalog:cli",
-    "typescript": "catalog:cli",
-    "vitest": "catalog:testing"
+    "typecheck": "tsc --noEmit",
+    "typecheck:all": "pnpm typecheck",
+    "typecheck:cli": "pnpm typecheck"
   }
-}
+}

package/README.zh-CN.md

@@ -1,74 +0,0 @@
-# @wot-ui/cli
-
-面向 wot-ui 的 CLI、MCP 与 Skills 工具集。
-
-## 能力概览
-
-- 组件知识查询：`list`、`info`、`doc`、`demo`、`token`、`changelog`
-- 本地项目分析：`doctor`、`usage`、`lint`
-- 通过 `wot mcp` 启动 MCP stdio 服务
-- 通过提取脚本从 wot-ui 源码生成离线元数据
-
-## 安装
-
-```bash
-npm install -g @wot-ui/cli
-```
-
-## 命令示例
-
-```bash
-wot list
-wot info Button
-wot doc Button
-wot demo Button basic
-wot token Button
-wot changelog
-wot doctor ./my-app
-wot usage ./my-app
-wot lint ./my-app
-wot mcp
-```
-
-## 命令说明
-
-- `wot list`：列出可用组件
-- `wot info <Component>`：查看组件详情
-- `wot doc <Component>`：输出组件 markdown 文档
-- `wot demo <Component> [name]`：查看 demo 列表或示例源码
-- `wot token [Component]`：查看 CSS 变量与默认值
-- `wot changelog [version] [component]`：查看更新记录
-- `wot doctor [dir]`：检查工程依赖与环境
-- `wot usage [dir]`：统计 `.vue` 中的 `wd-*` 使用情况
-- `wot lint [dir]`：执行 wot-ui 相关规则检查
-- `wot mcp`：启动 MCP stdio Server
-
-## 提取命令
-
-使用本地已有的 wot-ui 仓库：
-
-```bash
-pnpm extract --wot-dir ../wot-ui --output ./data/v2.json
-```
-
-直接克隆上游仓库并提取：
-
-```bash
-pnpm extract:clone
-```
-
-## 开发调试
-
-```bash
-pnpm --filter @wot-ui/cli exec tsx src/index.ts list
-pnpm --filter @wot-ui/cli exec tsx src/index.ts mcp
-pnpm --filter @wot-ui/cli build
-pnpm --filter @wot-ui/cli test
-pnpm --filter @wot-ui/cli typecheck
-```
-
-## 当前边界
-
-- 当前只支持 wot-ui v2
-- `usage` 和 `lint` 当前只聚焦 `.vue` 文件
-- CSS 变量优先从组件 SCSS 源码提取

package/skills/wot-ui/SKILL.md

@@ -1,18 +0,0 @@
----
-name: wot-ui
-description: Query wot-ui component knowledge before generating or refactoring UI code.
-summary: Query wot-ui component knowledge before generating code.
----
-
-Use the local `wot` CLI before generating or refactoring wot-ui based code.
-
-Recommended workflow:
-1. Run `wot list` to find the target component.
-2. Run `wot info <Component>` to inspect props, events, slots, and CSS variables.
-3. Run `wot doc <Component>` when you need the markdown documentation.
-4. Run `wot token <Component>` when theme customization is involved.
-
-Current limitations:
-- Only wot-ui v2 is supported.
-- Bundled data is still a seed dataset until `pnpm extract` is run against the full wot-ui source repository.
-- `usage` and `lint` currently focus on `.vue` files.