# 泰茂 AI 设计工作室客户使用说明

## 这是什么

这是部署在 Windows 电脑上的本地 AI 设计工作台，面向鞋子、服装、箱包外贸设计场景。

可以用于：

- 上传客户款式图、鞋底图、商标图。
- 生成产品设计图、模特效果图和多轮优化结果。
- 继续生成其他配色方案。
- 下载图片或导出 A4 目录册。
- 管理员统一管理员工账号、模型配置、鞋底资源包和授权状态。

## 安装方式

1. 解压客户包到本地目录。
2. 如果未安装 Node.js，先运行 `install-node.bat`。
3. 双击 `start-prod-lan.bat` 启动局域网服务。
4. 本机打开 `http://localhost:3010`。
5. 局域网其他电脑打开 `http://部署电脑IP:3010`。

如果只是本机调试，可以运行 `start.bat`。

## 默认管理员账号

- 账号：`admin`
- 密码：`admin@123`

首次登录后，请到管理员控制台修改管理员密码。

## 管理员要做什么

管理员登录后建议按顺序完成：

1. 激活授权码。
2. 修改管理员密码。
3. 配置文本模型和图片模型 API。
4. 创建员工账号。
5. 给员工分配可用模型配置。
6. 如有鞋底资源包，导入鞋底资源包。

### 管理员端 AGNES 配置说明

如果你准备把 AGNES 作为备用模型供应商使用，可在管理员端新增一条模型配置。

推荐填写方式：

- 文本 Provider：`AGNES`
- 图片 Provider：`AGNES`
- 文本 Base URL：`https://apihub.agnes-ai.com/v1`
- 图片 Base URL：`https://apihub.agnes-ai.com/v1`
- 文本模型：`agnes-2.0-flash`
- 图片模型：`agnes-image-2.1-flash`

说明：

- AGNES 按 OpenAI 兼容协议接入。
- 文本链路支持图文理解，可用于参考图、鞋底图、商标图分析。
- 图片链路支持文生图和图生图。
- 如果客户没有自有 AGNES Key，不要在交付包里预置密钥，请由客户或管理员自行填写。

## 员工怎么使用

1. 登录员工账号。
2. 进入工作区。
3. 选择品类、年龄段、国家和生成模式。
4. 上传客户款式图。
5. 如果是鞋子，可以上传鞋底图，或从已导入的鞋底图库中选择鞋底。
6. 填写设计方向、配色建议、目标市场、材质、价格带等信息。
7. 点击开始生成。
8. 结果出来后，可以继续优化、生成其他配色、生成模特效果、下载图片或导出目录册。

## 鞋底资源包怎么用

鞋底资源包是单独发放的 ZIP 文件，不需要放进主程序包里。

管理员导入方法：

1. 管理员登录系统。
2. 找到“鞋底资源包”区域。
3. 选择收到的鞋底资源 ZIP。
4. 点击导入。
5. 导入成功后，员工在鞋子设计工作区即可浏览、搜索和选择鞋底。

导入规则：

- 相同 ZIP 会识别为重复包，不会反复导入。
- 新版本资源包会追加保存，不会删除旧版本。
- 原图长期保留。
- 系统会自动生成 WebP 预览图和缩略图，减少图片加载压力。
- 鞋底图库不走 3 个月临时清理规则，会长期保存在部署机的 `data/catalog/sole` 目录。

更详细的资源包制作和维护说明见：`docs/SOLE-CATALOG-PACKAGE-GUIDE.md`。

## 更新方式

收到新的客户包 ZIP 后，不要删除原部署目录，直接按下面方式更新：

1. 双击当前部署目录里的 `update-from-package.bat`。
2. 在弹窗中选择新的客户包 ZIP。
3. 脚本会覆盖程序文件。
4. `.env`、`data`、授权状态和已导入鞋底资源会尽量保留。

一般更新后不需要重新配置 API，也不需要重新激活授权。

## 试用规则

未激活时：

- 试用 5 天。
- 每天 5 次。
- 只开放 1 个工作区。

试用状态绑定部署机器。即使删除目录重新解压，同一台机器的试用状态也不会重置。

## 常见问题

### 页面打不开

先确认：

- 服务是否已经启动。
- 是否运行了 `start-prod-lan.bat`。
- 局域网电脑访问地址是否使用部署电脑真实 IP。
- 端口是否被占用，脚本会自动提示可用端口。

### 上传后无法生成

通常是：

- 没有上传参考图。
- 模型配置未分配给员工。
- API Base URL、API Key 或模型名不匹配。
- 中转站图片链路响应超时或返回 502。

### 试用结束后怎么办

联系激活：

- 微信：`Puretimi`
- 邮箱：`1154413@qq.com`

## 附带文档

- `DELIVERY-CHECKLIST-CUST.MD`
- `ACTIVATION-GUIDE-CUST.MD`
- `PRICING-TIERS-CUST.MD`
- `QUOTATION-TEMPLATE-CUST.MD`
- `UPDATE-GUIDE-CUST.MD`
- `docs/AGNES-SETUP-GUIDE-CUST.md`
- `docs/AGNES-WECHAT-QUICKSTART-CUST.md`
- `docs/SOLE-CATALOG-PACKAGE-GUIDE.md`
