Merge pull request #8 from OldCoderIsMe/v0.1.4

V0.1.4 Solar System 手势渲染 + 客户端摄像头权限修复

Author: OldCoderIsMe

README.md

@@ -61,6 +61,7 @@
 | 📱 **二维码生成器** | 文本/URL 转二维码，可配置尺寸（200-500px），支持下载二维码图片 |
 | 🔄 **文本差异对比** | 按行/按字符对比，高亮显示新增/删除/未改变的内容，显示统计信息 |
 | 📅 **年度倒计时** | 年度进度可视化，显示当前年份进度百分比、剩余天数，支持点阵进度展示（仅 macOS 桌面应用） |
+| 🪐 **Solar System** | 摄像头手部关键点追踪，手势控制视角并实时渲染太阳系背景（Web/Electron 可用；浏览器需 HTTPS 或 localhost 才能访问摄像头） |
 
 ## 技术栈
 
@@ -142,9 +143,19 @@ devtools-extension/
 1. **隐私安全**：所有计算都在本地浏览器中完成，不会上传任何数据到服务器
 2. **数据存储**：扩展使用 Chrome Storage API，数据仅存储在本地
 3. **权限说明**：扩展只需要 `storage` 权限，用于本地数据存储
+4. **摄像头说明（Solar System）**：
+   - **浏览器**：仅在 **HTTPS** 或 **localhost** 环境可调用摄像头（浏览器安全策略）
+   - **macOS 客户端**：首次使用可能触发系统摄像头权限弹窗，请在系统设置中允许
 
 ## 版本历史
 
+### v0.1.4
+
+- ✨ 新增 **Solar System**：MediaPipe 手部关键点追踪 + Three.js 太阳系实时渲染（Web/Electron）
+- 🔒 Electron 客户端增加 `media` 权限显式处理（摄像头调用更可控）
+- 🛠️ 修复类型检查并补齐依赖：`three` / `@mediapipe/tasks-vision` / `@types/three`
+- 📦 mac 打包脚本优化：按架构（x64/arm64）构建并禁用自动发布
+
 ### v0.1.2 - 客户端快捷指令版本 🚀
 
 #### ✨ 新增功能

docs/CHROME_EXTENSION_DEPLOY.md

@@ -27,7 +27,7 @@ npm run package
 这会自动：
 1. ✅ 构建项目（`npm run build`）
 2. ✅ 生成图标（从 brand-icon.png 生成 16x16, 48x48, 128x128）
-3. ✅ 创建 ZIP 包（`devtools-suite-v0.1.0.zip`）
+3. ✅ 创建 ZIP 包（例如：`devtools-suite-v0.1.4.zip`，以 `package.json` 的 version 为准）
 
 ### 快速发布步骤
 
@@ -89,7 +89,7 @@ npm run package
 这会自动完成：
 1. 构建项目
 2. 生成图标
-3. 创建 ZIP 包（`devtools-suite-v0.1.0.zip`）
+3. 创建 ZIP 包（例如：`devtools-suite-v0.1.4.zip`，以 `package.json` 的 version 为准）
 
 ### 方法二：手动打包
 
@@ -101,7 +101,7 @@ npm run build
 cd dist
 
 # 3. 创建 ZIP（Mac/Linux）
-zip -r ../devtools-suite-v0.1.0.zip . -x "*/README.md" -x "*/.gitkeep" -x "*/.DS_Store"
+zip -r ../devtools-suite-v0.1.4.zip . -x "*/README.md" -x "*/.gitkeep" -x "*/.DS_Store"
 
 # Windows 用户可以使用图形界面压缩 dist 文件夹内的所有文件
 ```
@@ -134,7 +134,7 @@ zip -r ../devtools-suite-v0.1.0.zip . -x "*/README.md" -x "*/.gitkeep" -x "*/.DS
 ### 步骤 2：上传 ZIP 文件
 
 1. 点击"**选择文件**"或拖拽文件
-2. 选择：`devtools-suite-v0.1.0.zip`
+2. 选择：`devtools-suite-v0.1.4.zip`（以实际打包生成的文件名为准）
 3. 等待上传完成（可能需要几分钟）
 
 ### 步骤 3：验证上传

docs/INSTALL.md

@@ -34,7 +34,7 @@
 
 ```bash
 # 对于 DMG 文件
-xattr -cr "/path/to/DevTools Suite-0.1.2.dmg"
+xattr -cr "/path/to/DevTools Suite-0.1.4.dmg"
 
 # 对于已安装的应用
 xattr -cr "/Applications/DevTools Suite.app"
@@ -57,6 +57,7 @@ sudo spctl --master-enable
 1. 打开应用后，如果提示需要权限：
    - 点击"打开系统偏好设置"
    - 在"隐私与安全性"中授予相应权限
+   - 如果使用 **Solar System**，请允许 **摄像头** 权限
 
 2. 应用启动后，可以使用以下快捷键：
    - `Cmd+K` 或 `Cmd+Space` - 打开快速搜索

electron/README.md

@@ -37,8 +37,14 @@ npm run electron:build:mac
 ```
 
 这将生成：
-- `release/DevTools Suite-0.1.0.dmg` - macOS 安装包
-- `release/DevTools Suite-0.1.0-mac.zip` - macOS 压缩包
+- `release/DevTools Suite-0.1.4.dmg` - macOS 安装包（x64）
+- `release/DevTools Suite-0.1.4-arm64.dmg` - macOS 安装包（arm64）
+- `release/DevTools Suite-0.1.4-mac.zip` - macOS 压缩包（x64）
+- `release/DevTools Suite-0.1.4-arm64-mac.zip` - macOS 压缩包（arm64）
+
+说明：
+- 脚本会按架构顺序构建（避免 DMG 并发挂载冲突）
+- 默认禁用自动发布（`--publish never`）
 
 ### 仅打包（不生成安装包）
 
@@ -124,6 +130,7 @@ electron/
 - ✅ 窗口管理（最小化、最大化、关闭）
 - ✅ 安全隔离（contextIsolation）
 - ✅ 自动更新支持（可配置）
+- ✅ 摄像头交互（Solar System）：在 Electron 客户端中可通过 `getUserMedia` 调用摄像头并进行手势交互（需要系统授权）
 
 ## 故障排除
 

electron/main.js

@@ -1,4 +1,4 @@
-const { app, BrowserWindow, Menu, shell, screen, globalShortcut, ipcMain, Tray, nativeImage, dialog, crashReporter } = require('electron');
+const { app, BrowserWindow, Menu, shell, screen, globalShortcut, ipcMain, Tray, nativeImage, dialog, crashReporter, session, systemPreferences } = require('electron');
 const path = require('path');
 const settings = require('./settings');
 const fileOperations = require('./fileOperations');
@@ -441,6 +441,29 @@ function registerIpcHandlers() {
     }
   });
 
+  // 摄像头权限（macOS）
+  ipcMain.handle('media:getCameraStatus', () => {
+    try {
+      if (process.platform !== 'darwin') return 'not_supported';
+      return systemPreferences.getMediaAccessStatus('camera');
+    } catch (e) {
+      return 'unknown';
+    }
+  });
+
+  ipcMain.handle('media:askForCameraAccess', async () => {
+    try {
+      if (process.platform !== 'darwin') return false;
+      const status = systemPreferences.getMediaAccessStatus('camera');
+      if (status === 'granted') return true;
+      // 会触发系统弹窗（若已拒绝通常会直接返回 false）
+      const ok = await systemPreferences.askForMediaAccess('camera');
+      return !!ok;
+    } catch (e) {
+      return false;
+    }
+  });
+
   // 获取窗口是否可见
   ipcMain.handle('quick-search:isVisible', () => {
     return quickSearchWindow && !quickSearchWindow.isDestroyed() && quickSearchWindow.isVisible();
@@ -890,6 +913,26 @@ app.whenReady().then(() => {
       app.setAsDefaultProtocolClient('devtools-suite');
     }
   }
+
+  // 摄像头/麦克风权限（用于 getUserMedia）
+  // Electron 默认会自动放行权限请求，显式处理更可控
+  try {
+    session.defaultSession.setPermissionRequestHandler((webContents, permission, callback, details) => {
+      if (permission !== 'media') return callback(false);
+
+      const requestingUrl = details?.requestingUrl || webContents.getURL() || '';
+      const allow =
+        requestingUrl.startsWith('file://') ||
+        requestingUrl.startsWith('http://localhost:') ||
+        requestingUrl.startsWith('http://127.0.0.1:') ||
+        requestingUrl.startsWith('https://localhost:') ||
+        requestingUrl.startsWith('https://127.0.0.1:');
+
+      callback(allow);
+    });
+  } catch (e) {
+    console.warn('[Electron] 设置媒体权限处理失败:', e?.message || e);
+  }
 
   createWindow();
   createMenu();

electron/preload.js

@@ -8,6 +8,11 @@ contextBridge.exposeInMainWorld('electron', {
     chrome: process.versions.chrome,
     electron: process.versions.electron,
   },
+  // 媒体权限（仅 Electron / macOS）
+  media: {
+    getCameraStatus: () => ipcRenderer.invoke('media:getCameraStatus'),
+    askForCameraAccess: () => ipcRenderer.invoke('media:askForCameraAccess'),
+  },
   // 快速搜索相关 IPC
   quickSearch: {
     close: () => ipcRenderer.invoke('quick-search:close'),

manifest.json

@@ -2,7 +2,7 @@
     "manifest_version": 3,
     "name": "DevTools Suite",
     "description": "常用开发小工具集合：URL、MD5、时间戳等（本地计算，不上传数据）",
-    "version": "0.1.1",
+    "version": "0.1.4",
     "homepage_url": "https://github.com/OldCoderIsMe/devtools-extension",
     "action": {
       "default_popup": "index.html",