@quicktvui/ai 1.0.0 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quicktvui/ai",
-  "version": "1.0.0",
+  "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) {
+if (
+  projectRoot === __dirname ||
+  projectRoot === path.join(__dirname, "..", "..")
+) {
   process.exit(0);
 }
 
@@ -19,6 +22,9 @@ console.log("\n🚀 [@quicktvui/ai] 开始为您注入 QuickTVUI 专属 AI 规
 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 currentBackupDir = path.join(backupBaseDir, `backup_${timestamp}`);
 
 function copyDirectorySync(src, dest) {
   if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
@@ -35,27 +41,80 @@ function copyDirectorySync(src, dest) {
 }
 
 try {
-  // 1. 拷贝规则
+  const rootItems = fs.readdirSync(rulesDir);
+  let backupNeeded = false;
+
+  // 1. 检查并备份现有配置
+  rootItems.forEach((item) => {
+    const targetPath = path.join(projectRoot, item);
+    if (fs.existsSync(targetPath)) {
+      if (!backupNeeded) {
+        if (!fs.existsSync(currentBackupDir))
+          fs.mkdirSync(currentBackupDir, { recursive: true });
+        backupNeeded = true;
+      }
+      const backupPath = path.join(currentBackupDir, item);
+      if (fs.lstatSync(targetPath).isDirectory()) {
+        copyDirectorySync(targetPath, backupPath);
+      } else {
+        fs.copyFileSync(targetPath, backupPath);
+      }
+    }
+  });
+
+  if (backupNeeded) {
+    console.log(
+      `📦 已检测到现有 AI 配置文件，已备份至: .quicktvui-ai-backup/backup_${timestamp}`,
+    );
+  }
+
+  // 2. 注入新规则
   copyDirectorySync(rulesDir, projectRoot);
   console.log("🎉 [@quicktvui/ai] AI 规范注入成功！");
 
-  // 2. 尝试 Git Add
-  const gitDir = path.join(projectRoot, ".git");
-  if (fs.existsSync(gitDir)) {
-    console.log("📦 正在将配置文件添加到 Git 暂存区...");
-    const rootItems = fs.readdirSync(rulesDir);
-    rootItems.forEach((item) => {
-      try {
-        execSync(`git add "${item}"`, { cwd: projectRoot, stdio: "ignore" });
-      } catch (e) {}
-    });
-    console.log("✅ 自动 git add 完成。");
-  } else {
-    console.log("ℹ️ 未检测到 Git 仓库，跳过自动 git add。");
+  // 3. 更新 .gitignore
+  const gitignorePath = path.join(projectRoot, ".gitignore");
+  let gitignoreContent = "";
+  if (fs.existsSync(gitignorePath)) {
+    gitignoreContent = fs.readFileSync(gitignorePath, "utf8");
+  }
+
+  const itemsToIgnore = [
+    ".quicktvui-ai-backup",
+    ...rootItems.map((item) =>
+      item === ".github" ? ".github/copilot-instructions.md" : item,
+    ),
+  ];
+
+  let updatedGitignore = gitignoreContent;
+  let hasChanges = false;
+
+  const sectionHeader = "# QuickTVUI AI Rules";
+  if (!updatedGitignore.includes(sectionHeader)) {
+    updatedGitignore +=
+      (updatedGitignore.length > 0 && !updatedGitignore.endsWith("\n")
+        ? "\n"
+        : "") + `\n${sectionHeader}\n`;
+    hasChanges = true;
+  }
+
+  itemsToIgnore.forEach((item) => {
+    const regex = new RegExp(`^${item.replace(/\./g, "\\.")}$`, "m");
+    if (!regex.test(updatedGitignore)) {
+      if (!updatedGitignore.endsWith("\n")) updatedGitignore += "\n";
+      updatedGitignore += `${item}\n`;
+      hasChanges = true;
+    }
+  });
+
+  if (hasChanges) {
+    fs.writeFileSync(gitignorePath, updatedGitignore);
+    console.log("✅ 已更新 .gitignore，排除 AI 配置文件。");
   }
 } catch (err) {
   console.error(`❌ 注入失败: ${err.message}`);
 }
+
 console.log(
   "\n🤖 您的项目现已全面兼容 Cursor, Windsurf, Cline 等 AI 助手！开发愉快！\n",
 );

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`