# 插件

**Repository Path**: xiaoruan168/plugin

## Basic Information

- **Project Name**: 插件
- **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-04-22
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 自动发货工具

批量自动处理 kt-wms.tcl.com 上的发货操作。

## 功能

- 上传 Excel 文件，自动读取 A 列订单号（自动去重）
- 逐单自动执行：填写订单号 → 回车查询 → 等待数据加载 → 全选 → 勾选拣货确认 → 一键发货
- 支持暂停 / 继续 / 跳过当前 / 停止
- 失败订单自动记录，支持一键重试
- 日志持久化，关闭 Popup 后不丢失
- 页面内浮窗实时显示当前进度

## 技术栈

- [WXT](https://wxt.dev/) — 浏览器扩展开发框架
- Vue 3 — Popup 界面
- TypeScript
- SheetJS (xlsx) — Excel 解析

## 开发

```bash
# 安装依赖
pnpm install

# 开发模式（Chrome）
pnpm dev

# 开发模式（Firefox）
pnpm dev:firefox

# 构建
pnpm build

# 打包 zip
pnpm zip
```

## 项目结构

```
entrypoints/
  background.ts    — 后台脚本，任务调度与状态管理
  content.ts       — 内容脚本，DOM 操作与页面浮窗
  injected.ts      — Main World 脚本，处理 jQuery 事件触发
  popup/           — Popup 弹窗界面 (Vue 3)
utils/
  messaging.ts     — 消息类型定义
  popup-state.ts   — Popup 状态持久化
  excel-parser.ts  — Excel 文件解析
  logger.ts        — 日志存储
docs/
  DESIGN.md        — 设计文档
```

## 使用说明

1. 在 Chrome 中加载扩展
2. 打开 kt-wms.tcl.com 目标发货页面
3. 点击扩展图标，上传包含订单号的 Excel 文件
4. 点击"开始处理"
5. 处理过程中可暂停、跳过、停止
6. 失败订单可点击"重试"按钮重新处理

## 权限说明

| 权限 | 用途 |
|------|------|
| `activeTab` | 访问当前标签页，与 Content Script 通信 |
| `storage` | 存储日志和状态数据 |