# 蝦修修 V3 客户端

这是交付给客户使用的 Windows 桌面软件客户端。客户端只负责商品表格导入、图片生成、自动加边框、自动加水印、日志记录、断点续跑和授权验证。

客户端只做授权验证和业务处理，不包含任何授权管理后台、服务器数据库或管理员入口。卡密数据保存在授权服务器端，管理员后台是单独系统。

## 运行方式

双击：

```text
蝦修修.exe
```

首次启动需要输入管理员提供的卡密。授权服务器地址由管理员预先配置，普通用户不能直接修改。

如需切换公网授权服务器，请在授权窗口点击 `管理员解锁`，输入管理员密码后修改并保存。

## 客户端本地保存内容

客户端本地只保存：

- 当前卡密
- 本机 device_id
- 授权服务器地址（只保存当前配置，不保存卡密数据库）
- 最近一次验证结果缓存

## 授权提示

授权服务器地址配置文件：

```text
config/license_server.json
```

客户软件会请求公网授权 API，例如：

```text
https://license.yourdomain.com/api/license/activate
```

授权请求会提交 `license_key`、`device_id` 和软件 `version`。

卡密过期：

```text
当前卡密已过期，请联系管理员续费。
```

卡密禁用：

```text
当前卡密已被禁用，请联系管理员。
```

设备不匹配：

```text
当前卡密已绑定其他设备，请联系管理员处理。
```

## 主要流程

1. 选择蝦皮后台手动导出的 Excel / CSV。
2. 选择输出目录。
3. 检查字段映射。
4. 设置图片生成、模型 API、提示词、边框和水印。
5. 点击 `开始处理`。
6. 软件按表格逐行处理商品，生成最终主图和处理日志。

## V3 已取消

- 旧版主图边框识别与跳过机制
- 旧版跳过统计
- 旧版人工确认统计
- 旧版检测参数设置

## V3 保留

- Excel / CSV 导入
- 图片下载
- OpenAI Images / OpenAI 兼容中转站图片生成
- DeepSeek 文字模型接口预留
- 固定提示词和自定义提示词
- 自动加边框模板
- 自动加水印
- 日志记录
- 软件记忆功能
- 断点续跑
- 多商品 ID 重跑
- 单开、防误触、关闭确认等安全机制

## 多商品 ID 重跑

点击 `多商品重跑`，输入商品 ID。多个 ID 支持英文逗号、中文逗号或换行分隔，最多 100 个。

## 安全边界

软件不会登录蝦皮后台，不打开 seller.shopee.tw，不接管浏览器，不模拟点击，不自动上传商品图片，只读取用户手动导出的 Excel / CSV 和表格里的图片直链。
