@quicktvui/ai 1.0.9 → 1.1.1

package/README.md

@@ -37,6 +37,37 @@ yarn add @quicktvui/ai --dev
 
 ---
 
+## 🌐 可选：全局 Skills 安装（Skill Runtime）
+
+如果你使用支持 `~/.agents/skills/` 的 Agent（如部分本地 Agent 工具链），可以额外安装全局 skills：
+
+```bash
+npm install -g @quicktvui/ai-cli @quicktvui/ai-skills
+quicktvui-ai init
+quicktvui-ai doctor
+```
+
+默认会安装到：
+
+- `~/.agents/skills/quicktvui`
+
+并自动维护 Gemini 全局桥接配置：
+
+- `~/.gemini/GEMINI.md`（加入 QuickTVUI skill `@...` 引入块）
+- `~/.gemini/settings.json`（补齐 `context.fileName`）
+
+常用命令：
+
+```bash
+quicktvui-ai validate
+quicktvui-ai update
+quicktvui-ai prompt --lang zh
+```
+
+> 注意：全局 skills 不是对所有 AI 都自动生效。对仅读取项目文件的工具，仍需使用 `npm install @quicktvui/ai --save-dev` 注入项目内规则。
+
+---
+
 ## 🤖 支持的 AI 工具与配置
 
 本包一次性适配了市面上主流的 AI 编程助手，安装后会自动在项目根目录生成对应的配置文件：

package/USAGE.md

@@ -4,7 +4,7 @@
 
 ## 1. 快速上手
 
-### 第一步：安装规范包
+### 模式 A：项目内规则（兼容 Cursor/Copilot/Cline）
 
 在你的 QuickTVUI 项目（建议使用 `quicktvui-template` 创建）中安装：
 
@@ -12,16 +12,31 @@
 npm install @quicktvui/ai --save-dev
 ```
 
-### 第二步：配置并开启推荐模型
+AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAUDE.md` 等文件中的指令。
+
+### 模式 B：全局 Skills（兼容支持 `~/.agents/skills` 的 Agent）
+
+```bash
+npm install -g @quicktvui/ai-cli @quicktvui/ai-skills
+quicktvui-ai init
+quicktvui-ai doctor
+```
+
+默认安装目录：
+
+- `~/.agents/skills/quicktvui`
+
+安装后请重启或 reload AI Agent，让其重新扫描本地 skills。
+`quicktvui-ai init` 同时会自动维护 Gemini 全局桥接配置（`~/.gemini/GEMINI.md` 与 `~/.gemini/settings.json`）。
+
+### 推荐模型
 
 为了达到最佳辅助效果，请在你的 AI 工具中优先选择以下模型：
 
-- **Claude **
+- **Claude**
 - **Codex**
 - **Gemini**
 
-AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAUDE.md` 等文件中的指令。
-
 ## 2. 常见场景 AI 辅助示例
 
 ### 场景 A：创建新页面
@@ -32,7 +47,7 @@ AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAU
 ### 场景 B：API 查询
 
 **输入：** “qt-image 支持哪些属性？”
-**AI 将检索：** 它会查阅 `node_modules/@quicktvui/ai/rules/.docs/component/image.md` 并返回：`src`, `enableFade`,
+**AI 将检索：** 它会查阅 `node_modules/@quicktvui/ai/rules/.docs/zh-CN/component/image.md` 并返回：`src`, `enableFade`,
 `resizeMode` 等原生支持的属性。
 
 ### 场景 C：样式纠错
@@ -71,4 +86,4 @@ AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAU
 
 1. **重新引用规则**：告诉它：“请参考项目根目录下的 `.cursorrules` (或 `GEMINI.md`) 重新检查规范。”
 2. **强制读取文档**：告诉它：“请读取 `node_modules/@quicktvui/ai/rules/.docs/` 下的相关组件文档后再回答。”
-
+3. **检查全局技能安装**：运行 `quicktvui-ai doctor --strict`，确认 `~/.agents/skills/quicktvui` 目录和必需文件完整。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quicktvui/ai",
-  "version": "1.0.9",
+  "version": "1.1.1",
   "description": "QuickTVUI AI 开发规范与脚手架注入工具",
   "main": "index.js",
   "scripts": {

package/rules/.clinerules

@@ -13,6 +13,7 @@
         *   `quicktvui/`: Core Vue 3 UI component library implementation.
         *   `hippy/`: Android Native implementation (ViewController, UIManager).
         *   `sdk/`: ES SDK core implementation, containing Java definitions and implementations for `IEsModule` (plugins) and `IEsComponent` (components).
+        *   `hellotv/`: Complete best-practice application example, demonstrating routing, state management, and complex UI implementation.
         *   `ESPlayer*/ESVideoPlayer`: Media playback engines (Video, Audio, ADs).
         *   `ESPlayerManager`: High-level player window and playlist management.
         *   `ESRouter`: TV-optimized routing and navigation system.

package/rules/.cursorrules

@@ -13,6 +13,7 @@
         *   `quicktvui/`: Core Vue 3 UI component library implementation.
         *   `hippy/`: Android Native implementation (ViewController, UIManager).
         *   `sdk/`: ES SDK core implementation, containing Java definitions and implementations for `IEsModule` (plugins) and `IEsComponent` (components).
+        *   `hellotv/`: Complete best-practice application example, demonstrating routing, state management, and complex UI implementation.
         *   `ESPlayer*/ESVideoPlayer`: Media playback engines (Video, Audio, ADs).
         *   `ESPlayerManager`: High-level player window and playlist management.
         *   `ESRouter`: TV-optimized routing and navigation system.

package/rules/.docs/zh-CN/guide/ai/ai-assistant.md

@@ -4,7 +4,7 @@
 
 ## 1. 快速上手
 
-### 第一步：安装规范包
+### 方式 A：安装项目规范包（推荐，通用）
 
 在你的 QuickTVUI 项目（建议使用 `quicktvui-template` 创建）中安装：
 
@@ -12,7 +12,19 @@
 npm install @quicktvui/ai --save-dev
 ```
 
-### 第二步：配置并开启推荐模型
+AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAUDE.md` 等文件中的指令。
+
+### 方式 B：安装全局 Skills（可选）
+
+```bash
+npm install -g @quicktvui/ai-cli @quicktvui/ai-skills
+quicktvui-ai init
+quicktvui-ai doctor
+```
+
+默认安装目录为 `~/.agents/skills/quicktvui`。
+
+### 推荐模型
 
 为了达到最佳辅助效果，请在你的 AI 工具中优先选择以下模型：
 
@@ -20,8 +32,6 @@ npm install @quicktvui/ai --save-dev
 - **Codex**
 - **Gemini**
 
-AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAUDE.md` 等文件中的指令。
-
 ## 2. 常见场景 AI 辅助示例
 
 ### 场景 A：创建新页面
@@ -32,7 +42,7 @@ AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAU
 ### 场景 B：API 查询
 
 **输入：** “qt-image 支持哪些属性？”
-**AI 将检索：** 它会查阅 `node_modules/@quicktvui/ai/rules/.docs/component/image.md` 并返回：`src`, `enableFade`,
+**AI 将检索：** 它会查阅 `node_modules/@quicktvui/ai/rules/.docs/zh-CN/component/image.md` 并返回：`src`, `enableFade`,
 `resizeMode` 等原生支持的属性。
 
 ### 场景 C：样式纠错
@@ -71,4 +81,4 @@ AI 助手将自动读取项目根目录下的 `.cursorrules`, `GEMINI.md`, `CLAU
 
 1. **重新引用规则**：告诉它：“请参考项目根目录下的 `.cursorrules` (或 `GEMINI.md`) 重新检查规范。”
 2. **强制读取文档**：告诉它：“请读取 `node_modules/@quicktvui/ai/rules/.docs/` 下的相关组件文档后再回答。”
-
+3. **全局技能体检**：如已使用全局 skills，执行 `quicktvui-ai doctor --strict` 检查安装状态。

package/rules/.github/copilot-instructions.md

@@ -13,6 +13,7 @@
         *   `quicktvui/`: Core Vue 3 UI component library implementation.
         *   `hippy/`: Android Native implementation (ViewController, UIManager).
         *   `sdk/`: ES SDK core implementation, containing Java definitions and implementations for `IEsModule` (plugins) and `IEsComponent` (components).
+        *   `hellotv/`: Complete best-practice application example, demonstrating routing, state management, and complex UI implementation.
         *   `ESPlayer*/ESVideoPlayer`: Media playback engines (Video, Audio, ADs).
         *   `ESPlayerManager`: High-level player window and playlist management.
         *   `ESRouter`: TV-optimized routing and navigation system.

package/rules/.source/hellotv/PROJECT-README.md

@@ -0,0 +1,52 @@
+## 网络数据接入准备工作
+1. 在[build-config.ts](./src/config/build-config.ts) 中设置useMockData 为 false 使用网络数据，设置true 使用mock数据
+2. 在[build-config.ts](./src/config/build-config.ts) 中设置数据请求域名requestBaseUrl
+3. 在[RequestUrl.ts](./src/api/RequestUrl.ts) 中设置请求地址
+4. 在[request-manager.ts](./src/api/request/request-manager.ts) 中的init中初始化公共请求体，post/get方法中解析封装原始数据
+
+## Project整体目录结构
+```bash
+src
+├─App.vue 视图入口
+├─main.ts 程序入口
+├─routes.ts 路由
+├─vue.config.js 配置文件
+├─typings
+|    └shims-vue.d.ts ts识别vue配置
+├─tools 工具类
+|   ├─formatDate.ts
+|   ├─user
+|   ├─launch
+├─pages 视图
+|   ├─web
+|   ├─settings
+|   ├─search
+|   ├─introduction
+|   ├─live
+|   ├─home
+|   ├─filter
+|   ├─detail
+├─components 公共组件
+|     ├─Header.vue
+|     ├─LoadingError.vue
+|     ├─NetworkError.vue
+|     ├─bg-player.vue
+|     ├─img-text-btn-view.vue
+|     ├─qt-img-transition.vue
+|     └top-btns-view.vue
+├─config 全局配置
+|   └build-config.ts
+├─assets 资源文件
+├─api 全局api
+|  ├─GlobalApiImpl.ts 全局接口实现入口
+|  ├─IBaseApi.ts 
+|  ├─IGlobalApi.ts 接口继承类
+|  ├─RequestUrl.ts 请求地址
+|  ├─UseApi.ts
+|  ├─search 搜索api目录
+|  ├─request 
+|  ├─media
+|  ├─home 首页api目录
+|  ├─filter 筛选 api目录
+```
+

package/rules/.source/hellotv/app.d.ts

@@ -0,0 +1,11 @@
+declare module "*.jpg";
+declare module "*.png";
+declare module "*.scss";
+declare module "*.vue" {
+  import { defineComponent } from "vue";
+  const Component: ReturnType<typeof defineComponent>;
+  export default Component;
+}
+
+type NeedToTyped = any;
+declare const __DEV__: boolean;

package/rules/.source/hellotv/package.json

@@ -0,0 +1,146 @@
+{
+  "name": "@quicktvui/hellotv",
+  "appName": "hellotv",
+  "version": "1.0.5",
+  "main": "./src/main.ts",
+  "icon": "./src/assets/logo.png",
+  "private": true,
+  "scripts": {
+    "lint": "eslint -c eslint.config.mjs",
+    "dev": "tsx ./scripts/dev.ts",
+    "pack": "tsx ./scripts/pack.ts",
+    "build": "tsx ./scripts/build.ts",
+    "theme": "tsx ./build/build-flavor.ts",
+    "build-apk-debug": "tsx ./scripts/build-apk.ts Debug",
+    "build-apk-release": "tsx ./scripts/build-apk.ts Release"
+  },
+  "dependencies": {
+    "@extscreen/es3-ad-player": "1.0.9",
+    "@extscreen/es3-component": "1.0.37-beta.2",
+    "@extscreen/es3-core": "1.2.6",
+    "@extscreen/es3-player": "1.0.26",
+    "@extscreen/es3-player-manager": "1.0.46",
+    "@extscreen/es3-router": "1.2.3",
+    "@extscreen/es3-video-player": "1.0.42",
+    "@extscreen/es3-vue": "2.0.14",
+    "@extscreen/es3-vue-style-parser": "2.0.1",
+    "@quicktvui/quicktvui3": "1.2.0-beta.64",
+    "@vue/runtime-core": "^3.2.21",
+    "core-js": "^3.8.3",
+    "crypto-js": "^4.2.0",
+    "lodash": "^4.17.21",
+    "shelljs": "^0.10.0",
+    "treer": "^1.0.4",
+    "typescript": "5.6.3",
+    "vue": "^3.4.21",
+    "vue-tsc": "^2.0.11"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.12.16",
+    "@babel/eslint-parser": "^7.12.16",
+    "@babel/plugin-proposal-class-properties": "^7.10.4",
+    "@babel/plugin-proposal-decorators": "^7.10.5",
+    "@babel/plugin-proposal-nullish-coalescing-operator": "^7.10.4",
+    "@babel/plugin-proposal-object-rest-spread": "^7.5.5",
+    "@babel/plugin-proposal-optional-chaining": "^7.10.4",
+    "@babel/plugin-transform-async-to-generator": "^7.5.0",
+    "@babel/plugin-transform-runtime": "^7.11.0",
+    "@babel/polyfill": "^7.12.0",
+    "@babel/preset-env": "^7.12.0",
+    "@babel/runtime": "^7.16.0",
+    "@eslint/js": "^9.18.0",
+    "@extscreen/es3-debug-server": "0.0.6",
+    "@extscreen/es3-dynamic-import-plugin": "^0.0.5",
+    "@extscreen/es3-vue-css-loader": "^2.0.2",
+    "@hippy/hippy-hmr-plugin": "^0.1.0",
+    "@hippy/rejection-tracking-polyfill": "^1.0.0",
+    "@rollup/plugin-alias": "^3.1.9",
+    "@rollup/plugin-babel": "^5.3.1",
+    "@rollup/plugin-buble": "^0.21.3",
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-image": "^2.1.1",
+    "@rollup/plugin-node-resolve": "^15.0.2",
+    "@rollup/plugin-replace": "^5.0.2",
+    "@rollup/plugin-terser": "^0.4.3",
+    "@types/cross-spawn": "^6.0.3",
+    "@types/minimist": "^1.2.2",
+    "@types/node": "^22.13.14",
+    "@types/prompts": "^2.4.4",
+    "@vitejs/plugin-vue": "^1.9.4",
+    "@vue/cli-plugin-babel": "~5.0.0",
+    "@vue/cli-plugin-eslint": "~5.0.0",
+    "@vue/compiler-sfc": "^3.2.21",
+    "@vue/eslint-config-airbnb": "^4.0.0",
+    "@vue/tsconfig": "^0.5.1",
+    "autoprefixer": "^10.4.7",
+    "babel-eslint": "^10.0.3",
+    "babel-loader": "^8.1.0",
+    "case-sensitive-paths-webpack-plugin": "^2.2.0",
+    "clean-webpack-plugin": "^4.0.0",
+    "cliui": "^6.0.0",
+    "compressing": "^1.10.0",
+    "core-js": "^3.4.3",
+    "cross-env-os": "^7.1.1",
+    "cross-spawn": "^7.0.3",
+    "css-loader": "^7.1.2",
+    "esbuild": "^0.13.14",
+    "esbuild-loader": "^2.18.0",
+    "eslint": "9.14.0",
+    "eslint-plugin-check-file": "^2.8.0",
+    "eslint-plugin-vue": "9.31.0",
+    "eslint-webpack-plugin": "4.2.0",
+    "file-loader": "^4.3.0",
+    "globals": "^15.14.0",
+    "husky": "^9.1.7",
+    "javascript-obfuscator": "^4.1.1",
+    "kolorist": "^1.8.0",
+    "less": "^4.1.2",
+    "less-loader": "^7.1.0",
+    "lint-staged": "^16.1.2",
+    "minimist": "^1.2.8",
+    "path-to-regexp": "^1.8.0",
+    "postcss": "^8.5.4",
+    "postcss-js": "^4.0.1",
+    "postcss-loader": "^8.1.1",
+    "postcss-safe-parser": "^7.0.1",
+    "prettier": "^3.6.2",
+    "prompts": "^2.4.2",
+    "rollup-plugin-babel": "^4.4.0",
+    "rollup-plugin-buble": "^0.19.8",
+    "rollup-plugin-commonjs": "^10.1.0",
+    "rollup-plugin-dts": "^5.3.1",
+    "rollup-plugin-flow-no-whitespace": "^1.0.0",
+    "rollup-plugin-image": "^1.0.2",
+    "rollup-plugin-node-polyfills": "^0.2.1",
+    "rollup-plugin-node-resolve": "^5.2.0",
+    "rollup-plugin-postcss": "^4.0.2",
+    "rollup-plugin-replace": "^2.2.0",
+    "rollup-plugin-terser": "^7.0.0",
+    "rollup-plugin-typescript": "1.0.1",
+    "rollup-plugin-typescript2": "^0.35.0",
+    "rollup-plugin-vue": "^6.0.0",
+    "rollup-plugin-vue2": "^0.8.1",
+    "sass": "^1.22.10",
+    "sass-loader": "^16.0.3",
+    "scope-loader": "^1.0.3",
+    "signale": "^1.4.0",
+    "style-loader": "^4.0.0",
+    "tapable": "^2.2.1",
+    "terser": "^4.8.0",
+    "terser-webpack-plugin": "^5.3.9",
+    "ts-loader": "^9.4.4",
+    "ts-node": "^10.8.1",
+    "tsx": "^4.7.1",
+    "typescript-eslint": "^8.20.0",
+    "unicode-loader": "^1.0.7",
+    "url-loader": "^4.0.0",
+    "vue-loader": "^17.0.0",
+    "vue-template-compiler": "^2.6.10",
+    "webpack": "^5.88.2",
+    "webpack-asset-check-plugin": "^1.0.2",
+    "webpack-cli": "^4.7.2",
+    "webpack-node-externals": "^3.0.0",
+    "webpack-obfuscator": "^3.5.1",
+    "zx": "^8.0.1"
+  }
+}

package/rules/.source/hellotv/scripts/build-apk.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env zx
+const { exec } = require("shelljs");
+const buildType = process.argv.slice(2).join(" ");
+const cmd = process.platform.startsWith("win") ? "gradlew.bat" : "./gradlew";
+
+async function build() {
+  exec(`cd android && ${cmd} clean assemble${buildType}`, "");
+}
+
+build().catch((e) => {
+  console.error(e);
+});

package/rules/.source/hellotv/scripts/build.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env zx
+const fs = require("fs");
+const path = require("path");
+const run = require("./process");
+const { execSync } = require("child_process");
+
+async function build() {
+  // 删除 dist/android 目录
+  const androidDir = path.resolve("./dist/android/");
+  if (fs.existsSync(androidDir)) {
+    await run(`rm -rf ${androidDir}`);
+  }
+
+  // 创建 dist/android 目录
+  fs.mkdirSync(androidDir, { recursive: true });
+
+  // 删除 dist/android.zip 文件
+  const androidZipFile = path.resolve("./dist/android.zip");
+  if (fs.existsSync(androidZipFile)) {
+    await run(`rm -rf ${androidZipFile}`);
+  }
+
+  // 构建 flavor
+  await run(`tsx ./build/build-flavor.ts`);
+
+  // 打包 Android 资源
+  await run(`webpack --config ./scripts/quicktvui-webpack.android.ts`);
+
+  // 生成 Android.zip
+  execSync(`cd ${androidDir} && zip -q -r ../android.zip .`);
+}
+
+build().catch((e) => {
+  console.error(e);
+});

package/rules/.source/hellotv/scripts/dev.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env zx
+const run = require("./process");
+
+async function dev() {
+  await run(`tsx ./build/build-flavor.ts`, "");
+  // await run(`eslint -c eslint.config.mjs`, '')
+  await run(`hippy-dev -c ./scripts/quicktvui-webpack.dev.ts`, "");
+}
+
+dev().catch((e) => {
+  console.error(e);
+});

package/rules/.source/hellotv/scripts/pack.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env zx
+const compressing = require("compressing");
+const fs = require("node:fs");
+const path = require("path");
+const run = require("./process");
+
+async function pack() {
+  await run(`tsx ./build/build-flavor.ts`, "");
+  await run(`webpack --config ./scripts/quicktvui-webpack.android.ts`, "");
+  const cwd = process.cwd();
+  const dist = path.join(cwd, "./dist");
+  const android = path.join(cwd, "./dist/android");
+  const pkgFile = path.join(cwd, "./package.json");
+  const packages = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
+  const rpkPath = path.resolve(
+    dist,
+    encodeURIComponent(packages.name) + ".rpk",
+  );
+  await compressing.zip.compressDir(android, rpkPath);
+}
+
+pack().catch((e) => {
+  console.error(e);
+});

package/rules/.source/hellotv/scripts/process.ts

@@ -0,0 +1,37 @@
+const { spawn } = require("child_process");
+
+const run = (command, cwd) => {
+  return new Promise((resolve, reject) => {
+    const [cmd, ...args] = command.split(" ");
+    console.log("-----Command------>>>>>", `${cmd} args ${args}`);
+    const app = spawn(cmd, args, {
+      cwd,
+      stdio: ["inherit", "inherit", "pipe"], // Capture stderr separately
+      shell: process.platform === "win32",
+    });
+
+    let errorOutput = "";
+
+    app.stderr.on("data", (data) => {
+      errorOutput += data.toString();
+    });
+
+    const onProcessExit = () => app.kill("SIGHUP");
+
+    app.on("close", (code) => {
+      process.removeListener("exit", onProcessExit);
+      if (code === 0) {
+        resolve({});
+      } else {
+        reject(
+          new Error(
+            `Command failed. \n Command: ${command} \n Code: ${code} \n Error output: ${errorOutput}`,
+          ),
+        );
+      }
+    });
+    process.on("exit", onProcessExit);
+  });
+};
+
+module.exports = run;