# 纺织品制单

**Repository Path**: daimaru/textile-documentation

## 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-09-09
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 纺织品制单 (textile-documentation)

为上海东贸外销制作的制单系统：本地 Skill + 企业微信长连接机器人。

## 组成

| 组件 | 用途 |
|---|---|
| **`textile-export-docs/`** | WorkBuddy Skill。解析码单 + PI/PO，调 `build_docs.py` 生成 INV/DPL xlsx |
| **`wecom制单机器人/bot_ws/`** | **★ 推荐**：企业微信长连接 daemon（wecom-aibot-python-sdk）。多轮对话原生支持，xlsx 直接 msgtype=file 回传 |
| **`wecom制单机器人/wecom-cli-bot/`** | 备选：WorkBuddy connector 集成（wecom-cli）。每条消息触发新 agent session，无多轮状态 |
| **`wecom制单机器人/app.py`** | 旧版 Flask URL 回调（备查，不再推荐） |

**两个部署版本都调同一份 `bot_dispatcher.make_xlsx()`，输出与 WorkBuddy 窗口直接调用 skill 字节级一致。**

## 客户模板（Skill 内置）

- **classic**：Classic Fashion Apparel Industry（约旦 / AQABA / Times New Roman / HS 6004104000），INV + DPL。
- **hwear**：H WEAR LIMITED（香港 / CHITTAGONG / Arial / 仅 INV，每次询问是否需要 DPL）。
- **tainan**（50486A 起）：台湾台南企业 Tainan Enterprises 下单、货发印尼（PT. AMB 收货 / JAKARTA 港）。**独立版式**：无 HS 列、描述区 STYLE#/Composition/Cuttable Width+Weight、每色带 METRES 换算行、可带 PPSY 打样行（计入 TOTAL）、DPL 用跨表公式 `=INV!B6` 等引用、TO 块带 TAX ID 行、INV 表头有浅黄底纹（indexed=43）、DPL 表格薄边框。

## 安装

### 1. WorkBuddy Skill（本地使用）

```bash
cp -r textile-export-docs ~/.workbuddy/skills/
```

### 2. 企业微信机器人（★ 推荐 bot_ws 长连接 daemon）

```bash
# 服务器
git clone https://gitee.com/daimaru/textile-documentation.git
cd textile-documentation/wecom制单机器人

# 装依赖（含 wecom-aibot-sdk，国内加阿里云镜像）
pip install -r bot_ws/requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

# 把 skill 副本放到 WorkBuddy skills 目录（daemon 通过 sys.path 引用）
cp -r ../textile-export-docs ~/.workbuddy/skills/

# 配凭证（先在企微后台把机器人切到「长连接」拿 Bot ID/Secret）
cp bot_ws/config.example.json bot_ws/config.json
# 编辑 bot_ws/config.json 填 BOT_ID + SECRET

# 启动
cd bot_ws
python bot_ws.py
# → "长连接认证成功，纺织品制单机器人上线"
```

### 3. 备选：wecom-cli 集成模式

如果你已用 WorkBuddy connector（wecom-cli），且不想另起 daemon：

```bash
npm install -g @wecom/cli
wecom-cli auth init --noninteractive   # 用朱祎俊的企微扫码
cp -r ../textile-export-docs ~/.workbuddy/skills/
```

注意：wecom-cli 在本机一次只能绑一个 bot，归类机器人要继续用得换机器。

## 目录结构

```
textile-documentation/
├── README.md                          # 本文件
├── textile-export-docs/               # WorkBuddy Skill
│   ├── SKILL.md
│   ├── assets/stamp.png
│   ├── references/
│   │   ├── config-schema.md
│   │   └── templates.md
│   └── scripts/
│       ├── parse_madan.py
│       └── build_docs.py
└── wecom制单机器人/                   # 机器人项目
    ├── README.md                      # 架构总览
    ├── bot_ws/                        # ★ 推荐：长连接 daemon
    │   ├── bot_ws.py
    │   ├── session.py
    │   ├── aibot_upload.py
    │   ├── config.example.json
    │   ├── requirements.txt
    │   └── README.md
    ├── wecom-cli-bot/                 # 备选：WorkBuddy 集成
    │   ├── bot_dispatcher.py
    │   ├── bot_persona.md
    │   ├── README.md
    │   └── DEPLOY.md
    ├── app.py                          # 旧版 Flask URL 回调（备查）
    ├── 制单.py                        # 制单编排（两个版本共用）
    ├── media.py / doc_parser.py / wxbiz_crypt.py  # 旧版支撑代码
    ├── config.example.json             # 现在是 BOT_ID + SECRET
    ├── requirements.txt
    └── textile-export-docs/             # 旧版内置 skill 副本（wecom-cli-bot 用）
```

## 关键规则（来自实战）

- **多 sheet 必问**：码单 xlsx 含 ≥2 sheet 时，agent 必须先 AskUserQuestion 问取值范围
- **NW/GW 逐卷累加**：不用理论 GSM 重算，码单写了多少就是多少
- **sheet 命名陷阱**：`Sheet1` / `Sheet2` / `.` 不一定是隐藏/留样，可能是正常出货页
- **颜色名映射**：码单中文 → PO 官方英文（HWEAR 8 位代码 / TAINAN 6 位代码）

## 部署包

`D:\纺织品制单\_analysis\wecom制单机器人_部署包.zip` — 23 文件 / 132 KB，含两个版本全套代码 + skill 副本。