# octopusQRCode

**Repository Path**: github-9819409/octopus-qrcode

## Basic Information

- **Project Name**: octopusQRCode
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 章鱼二维码（Octopus QRCode）

浏览器二维码插件：生成二维码与识别二维码。基于 WXT + React + TypeScript 构建，支持 Chrome / Edge / Firefox。

## 功能

### 生成二维码

- 自定义内容：支持从剪贴板读取文本自动填充
- 自定义样式：前景色/背景色、尺寸、边距、纠错等级
- 批量生成：按行拆分内容批量生成
- 导出：单张 PNG 下载、批量打包 ZIP 下载

### 识别二维码

- 上传图片识别：支持批量上传
- 从剪贴板识别：读取剪贴板图片并解析
- 截图识别：捕获当前标签页可视区域并解析
- 相机识别：调用摄像头实时识别（不同浏览器权限策略可能不同）

### 右键菜单唤起

- 页面右键菜单“章鱼二维码：生成/识别”
- 如果有选中文本，会作为二维码内容预填充，并以独立弹窗形式打开

## 技术栈

- 框架：WXT、React 19、TypeScript
- UI：Ant Design 5、TailwindCSS
- 二维码：qrcode（生成）、jsqr（识别）

## 开发

### 安装依赖

```bash
pnpm i
```

### 启动开发（自动拉起浏览器）

```bash
pnpm dev
```

Firefox：

```bash
pnpm dev:firefox
```

说明：

- 本项目在 [wxt.config.ts](file:///e:/pluginForBrowser/octopusQRCode/wxt.config.ts) 中为 Windows 尝试自动定位 Chrome/Edge 可执行文件；若未能自动拉起，可通过环境变量 `CHROME_PATH` / `EDGE_PATH` 指定路径

## 构建与打包

### 构建（自定义脚本，适用于 Chrome MV3）

```bash
pnpm build
```

输出目录：

- `.output/chrome-mv3`
- `.output/chrome-mv3-dev`

可在 Chrome/Edge 的扩展管理页加载上述目录作为“已解压的扩展程序”。

### 构建/打包（WXT 官方流程）

```bash
pnpm build:wxt
pnpm zip
```

Firefox：

```bash
pnpm build:firefox
pnpm zip:firefox
```

## 目录结构

- [entrypoints/popup](file:///e:/pluginForBrowser/octopusQRCode/entrypoints/popup)：弹窗 UI（生成/识别的主要界面）
- [entrypoints/background.ts](file:///e:/pluginForBrowser/octopusQRCode/entrypoints/background.ts)：后台脚本（右键菜单、截图消息处理）
- [public/icon](file:///e:/pluginForBrowser/octopusQRCode/public/icon)：插件图标
- [types](file:///e:/pluginForBrowser/octopusQRCode/types)：类型声明

## 权限说明

以 [wxt.config.ts](file:///e:/pluginForBrowser/octopusQRCode/wxt.config.ts) 的 manifest 配置为准，主要包括：

- storage：保存用户设置
- contextMenus：右键菜单入口
- activeTab / tabs：截图识别（捕获可视区域）与相关能力
- clipboardRead / clipboardWrite：剪贴板读取/写入
- downloads：下载导出文件（不同构建方式可能策略不同）
- camera（仅 Firefox 条件启用）：相机识别

## 需求文档

详见 [requirementDocument.md](file:///e:/pluginForBrowser/octopusQRCode/requirementDocument.md)。