@quicktvui/ai 1.0.1 → 1.0.2

package/package.json

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

package/postinstall.js

@@ -11,7 +11,10 @@ if (!projectRoot || !fs.existsSync(projectRoot)) {
 }
 
 // 避免在包自身的开发环境中循环复制
-if (projectRoot === __dirname || projectRoot === path.join(__dirname, '..', '..')) {
+if (
+  projectRoot === __dirname ||
+  projectRoot === path.join(__dirname, "..", "..")
+) {
   process.exit(0);
 }
 
@@ -20,7 +23,7 @@ console.log(`📂 目标目录: ${projectRoot}`);
 
 const rulesDir = path.join(__dirname, "rules");
 const backupBaseDir = path.join(projectRoot, ".quicktvui-ai-backup");
-const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
 const currentBackupDir = path.join(backupBaseDir, `backup_${timestamp}`);
 
 function copyDirectorySync(src, dest) {
@@ -46,7 +49,8 @@ try {
     const targetPath = path.join(projectRoot, item);
     if (fs.existsSync(targetPath)) {
       if (!backupNeeded) {
-        if (!fs.existsSync(currentBackupDir)) fs.mkdirSync(currentBackupDir, { recursive: true });
+        if (!fs.existsSync(currentBackupDir))
+          fs.mkdirSync(currentBackupDir, { recursive: true });
         backupNeeded = true;
       }
       const backupPath = path.join(currentBackupDir, item);
@@ -59,7 +63,9 @@ try {
   });
 
   if (backupNeeded) {
-    console.log(`📦 已检测到现有 AI 配置文件，已备份至: .quicktvui-ai-backup/backup_${timestamp}`);
+    console.log(
+      `📦 已检测到现有 AI 配置文件，已备份至: .quicktvui-ai-backup/backup_${timestamp}`,
+    );
   }
 
   // 2. 注入新规则
@@ -75,7 +81,9 @@ try {
 
   const itemsToIgnore = [
     ".quicktvui-ai-backup",
-    ...rootItems.map(item => item === ".github" ? ".github/copilot-instructions.md" : item)
+    ...rootItems.map((item) =>
+      item === ".github" ? ".github/copilot-instructions.md" : item,
+    ),
   ];
 
   let updatedGitignore = gitignoreContent;
@@ -83,7 +91,10 @@ try {
 
   const sectionHeader = "# QuickTVUI AI Rules";
   if (!updatedGitignore.includes(sectionHeader)) {
-    updatedGitignore += (updatedGitignore.length > 0 && !updatedGitignore.endsWith("\n") ? "\n" : "") + `\n${sectionHeader}\n`;
+    updatedGitignore +=
+      (updatedGitignore.length > 0 && !updatedGitignore.endsWith("\n")
+        ? "\n"
+        : "") + `\n${sectionHeader}\n`;
     hasChanges = true;
   }
 
@@ -97,11 +108,10 @@ try {
   });
 
   if (hasChanges) {
-  fs.writeFileSync(gitignorePath, updatedGitignore);
-  console.log("✅ 已更新 .gitignore，排除 AI 配置文件。");
+    fs.writeFileSync(gitignorePath, updatedGitignore);
+    console.log("✅ 已更新 .gitignore，排除 AI 配置文件。");
   }
-  } catch (err) {
-
+} catch (err) {
   console.error(`❌ 注入失败: ${err.message}`);
 }
 

package/rules/.clinerules

@@ -143,6 +143,26 @@ Other CSS rules:
 <qt-list-view :clipChildren="false" :clipPadding="false" />
 ```
 
+## 🛡️ AI Sentinel: 框架问题上报机制 (Bug Reporting)
+
+当用户通过以下方式表达困惑时：
+- **关键词触发**：用户提到“问题上报”、“碰到问题”、“反馈”、“Bug 反馈”、“还是没改好”、“运行报错”、“API 报错”等。
+- **自动检测触发**：同一段代码逻辑在 3 次修复后仍然报错，或 AI 确认生成的代码符合 `.docs` 规范但无法在用户端运行。
+
+**AI 执行协议：**
+1. **脱敏诊断 (Sanitized Diagnosis)**：
+   - 提取报错日志（去除绝对路径和私密 Token）。
+   - 整理环境信息（Node 版本、package.json 中的框架版本）。
+   - 编写最小可复现 Demo 代码（Minimum Reproducible Example）。
+2. **寻求授权 (Request Consent)**：
+   - AI 必须询问：“检测到该问题可能属于 QuickTVUI 框架缺陷，我已为您准备好一份脱敏后的诊断报告，是否允许我协助您将其上报到 GitHub 官方仓库以寻求官方支持？”
+3. **提交方式 (Submission)**：
+   - 授权后，**自动打开浏览器**：AI 应尝试根据操作系统执行系统命令以自动打开 Issue 链接：
+     - macOS: `open "URL"`
+     - Linux: `xdg-open "URL"`
+     - Windows: `start "URL"`
+   - 如果自动打开失败，则展示 Issue 预填充链接引导用户点击。
+
 ### Import Sources
 - `defineComponent` from `vue` — NOT from `@vue/runtime-core`
 - Router: `useESRouter` from `@extscreen/es3-router`

package/rules/.cursorrules

@@ -143,6 +143,26 @@ Other CSS rules:
 <qt-list-view :clipChildren="false" :clipPadding="false" />
 ```
 
+## 🛡️ AI Sentinel: 框架问题上报机制 (Bug Reporting)
+
+当用户通过以下方式表达困惑时：
+- **关键词触发**：用户提到“问题上报”、“碰到问题”、“反馈”、“Bug 反馈”、“还是没改好”、“运行报错”、“API 报错”等。
+- **自动检测触发**：同一段代码逻辑在 3 次修复后仍然报错，或 AI 确认生成的代码符合 `.docs` 规范但无法在用户端运行。
+
+**AI 执行协议：**
+1. **脱敏诊断 (Sanitized Diagnosis)**：
+   - 提取报错日志（去除绝对路径和私密 Token）。
+   - 整理环境信息（Node 版本、package.json 中的框架版本）。
+   - 编写最小可复现 Demo 代码（Minimum Reproducible Example）。
+2. **寻求授权 (Request Consent)**：
+   - AI 必须询问：“检测到该问题可能属于 QuickTVUI 框架缺陷，我已为您准备好一份脱敏后的诊断报告，是否允许我协助您将其上报到 GitHub 官方仓库以寻求官方支持？”
+3. **提交方式 (Submission)**：
+   - 授权后，**自动打开浏览器**：AI 应尝试根据操作系统执行系统命令以自动打开 Issue 链接：
+     - macOS: `open "URL"`
+     - Linux: `xdg-open "URL"`
+     - Windows: `start "URL"`
+   - 如果自动打开失败，则展示 Issue 预填充链接引导用户点击。
+
 ### Import Sources
 - `defineComponent` from `vue` — NOT from `@vue/runtime-core`
 - Router: `useESRouter` from `@extscreen/es3-router`

package/rules/.windsurfrules

@@ -143,6 +143,26 @@ Other CSS rules:
 <qt-list-view :clipChildren="false" :clipPadding="false" />
 ```
 
+## 🛡️ AI Sentinel: 框架问题上报机制 (Bug Reporting)
+
+当用户通过以下方式表达困惑时：
+- **关键词触发**：用户提到“问题上报”、“碰到问题”、“反馈”、“Bug 反馈”、“还是没改好”、“运行报错”、“API 报错”等。
+- **自动检测触发**：同一段代码逻辑在 3 次修复后仍然报错，或 AI 确认生成的代码符合 `.docs` 规范但无法在用户端运行。
+
+**AI 执行协议：**
+1. **脱敏诊断 (Sanitized Diagnosis)**：
+   - 提取报错日志（去除绝对路径和私密 Token）。
+   - 整理环境信息（Node 版本、package.json 中的框架版本）。
+   - 编写最小可复现 Demo 代码（Minimum Reproducible Example）。
+2. **寻求授权 (Request Consent)**：
+   - AI 必须询问：“检测到该问题可能属于 QuickTVUI 框架缺陷，我已为您准备好一份脱敏后的诊断报告，是否允许我协助您将其上报到 GitHub 官方仓库以寻求官方支持？”
+3. **提交方式 (Submission)**：
+   - 授权后，**自动打开浏览器**：AI 应尝试根据操作系统执行系统命令以自动打开 Issue 链接：
+     - macOS: `open "URL"`
+     - Linux: `xdg-open "URL"`
+     - Windows: `start "URL"`
+   - 如果自动打开失败，则展示 Issue 预填充链接引导用户点击。
+
 ### Import Sources
 - `defineComponent` from `vue` — NOT from `@vue/runtime-core`
 - Router: `useESRouter` from `@extscreen/es3-router`

package/rules/AGENTS.md

@@ -154,6 +154,26 @@ Android clips child views outside parent bounds by default. When using `focusSca
 <qt-list-view :clipChildren="false" :clipPadding="false" />
 ```
 
+## 🛡️ AI Sentinel: 框架问题上报机制 (Bug Reporting)
+
+当用户通过以下方式表达困惑时：
+- **关键词触发**：当用户提到“问题上报”、“碰到问题”、“反馈”、“Bug 反馈”、“还是没改好”、“运行报错”、“API 报错”等。
+- **自动检测触发**：同一段代码逻辑在 3 次修复后仍然报错，或 AI 确认生成的代码符合 `.docs` 规范但无法在用户端运行。
+
+**AI 执行协议 (Execution Protocol)：**
+1. **脱敏诊断 (Sanitized Diagnosis)**：
+   - 提取报错日志（必须去除绝对路径和私密 Token/API Keys）。
+   - 整理环境信息（Node 版本、package.json 中的框架版本）。
+   - 编写最小可复现 Demo 代码（Minimum Reproducible Example）。
+2. **寻求授权 (Request Consent)**：
+   - AI 必须询问：“检测到该问题可能属于 QuickTVUI 框架缺陷，我已为您准备好一份脱敏后的诊断报告，是否允许我协助您将其上报到 GitHub 官方仓库以寻求官方支持？”
+3. **提交方式 (Submission)**：
+   - 授权后，**自动打开浏览器**：AI 应尝试根据操作系统执行系统命令以自动打开 Issue 链接：
+     - macOS: `open "URL"`
+     - Linux: `xdg-open "URL"`
+     - Windows: `start "URL"`
+   - 如果自动打开失败，则展示 Issue 预填充链接引导用户点击。
+
 ### Import Sources
 
 - `defineComponent` from `vue` — NOT from `@vue/runtime-core`

package/rules/CLAUDE.md

@@ -178,6 +178,26 @@ Android 默认裁切超出父容器边界的子元素。TV 端使用 `focusScale
 <qt-waterfall :clipChildren="false" :clipPadding="false" />
 ```
 
+## 🛡️ AI Sentinel: 框架问题上报机制 (Bug Reporting)
+
+当用户通过以下方式表达困惑时：
+- **关键词触发**：用户提到“问题上报”、“碰到问题”、“反馈”、“Bug 反馈”、“还是没改好”、“运行报错”、“API 报错”等。
+- **自动检测触发**：同一段代码逻辑在 3 次修复后仍然报错，或 AI 确认生成的代码符合 `.docs` 规范但无法在用户端运行。
+
+**AI 执行协议：**
+1. **脱敏诊断 (Sanitized Diagnosis)**：
+   - 提取报错日志（去除绝对路径和私密 Token）。
+   - 整理环境信息（Node 版本、package.json 中的框架版本）。
+   - 编写最小可复现 Demo 代码（Minimum Reproducible Example）。
+2. **寻求授权 (Request Consent)**：
+   - AI 必须询问：“检测到该问题可能属于 QuickTVUI 框架缺陷，我已为您准备好一份脱敏后的诊断报告，是否允许我协助您将其上报到 GitHub 官方仓库以寻求官方支持？”
+3. **提交方式 (Submission)**：
+   - 授权后，**自动打开浏览器**：AI 应尝试根据操作系统执行系统命令以自动打开 Issue 链接：
+     - macOS: `open "URL"`
+     - Linux: `xdg-open "URL"`
+     - Windows: `start "URL"`
+   - 如果自动打开失败，则展示 Issue 预填充链接引导用户点击。
+
 ### import 来源
 
 - `defineComponent` 从 `vue` 导入（对），不要从 `@vue/runtime-core` 导入

package/rules/GEMINI.md

@@ -159,6 +159,26 @@ Android clips child views outside parent bounds by default. When using `focusSca
 <qt-list-view :clipChildren="false" :clipPadding="false" />
 ```
 
+## 🛡️ AI Sentinel: 框架问题上报机制 (Bug Reporting)
+
+当用户通过以下方式表达困惑时：
+- **关键词触发**：用户提到“问题上报”、“碰到问题”、“反馈”、“Bug 反馈”、“还是没改好”、“运行报错”、“API 报错”等。
+- **自动检测触发**：同一段代码逻辑在 3 次修复后仍然报错，或 AI 确认生成的代码符合 `.docs` 规范但无法在用户端运行。
+
+**AI 执行协议：**
+1. **脱敏诊断 (Sanitized Diagnosis)**：
+   - 提取报错日志（去除绝对路径和私密 Token）。
+   - 整理环境信息（Node 版本、package.json 中的框架版本）。
+   - 编写最小可复现 Demo 代码（Minimum Reproducible Example）。
+2. **寻求授权 (Request Consent)**：
+   - AI 必须询问：“检测到该问题可能属于 QuickTVUI 框架缺陷，我已为您准备好一份脱敏后的诊断报告，是否允许我协助您将其上报到 GitHub 官方仓库以寻求官方支持？”
+3. **提交方式 (Submission)**：
+   - 授权后，**自动打开浏览器**：AI 应尝试根据操作系统执行系统命令以自动打开 Issue 链接：
+     - macOS: `open "URL"`
+     - Linux: `xdg-open "URL"`
+     - Windows: `start "URL"`
+   - 如果自动打开失败，则展示 Issue 预填充链接引导用户点击。
+
 ### Import Sources
 
 - `defineComponent` from `vue` (correct) — NOT from `@vue/runtime-core`