# 西行云途 · 小程序全自动产出平台

> 由 WorkBuddy AI 工程自动化工具批量生成的「西行云途」小程序全套产出物。
> **版权脱敏版本**：全部内容已架空处理，角色/地点/积分均已替换为原创设定，美术风格为布艺Q版娃娃 + 抽象水墨非写实，禁止原版西游 IP 元素。

## 部署地址

- **门户首页**：https://sa.oio.net.cn/yuntu/
- **源码仓库**：https://gitee.com/wwfcyq/code.git → `yuntu/` 目录

## 项目结构

```
yuntu/
├── index.html                      # 门户首页（访问 https://sa.oio.net.cn/yuntu/ 入口）
├── deploy.sh                       # 一键部署脚本
├── README.md                       # 本文件
├── 项目总报告.md                    # 完整产出清单与脱敏映射表
├── config/
│   └── sensitive_word_filter.txt   # 62个敏感词过滤库（聊天/弹幕实时校验）
├── database/
│   └── 云途档案建表.sql            # 8张表SQL（唯一档案ID/无微信字段/27索引/自动备份）
├── frontend/config/
│   ├── map_page.json               # 徒步主页面配置（6站路线+灵宠跟随）
│   ├── battle_pk.json              # 战斗+1v1/5v5在线PK配置
│   ├── chat_barrage.json           # 弹幕+师徒聊天区配置（含敏感词拦截）
│   ├── ai_pet.json                 # 4款AI拟人灵宠NPC配置
│   ├── shop_exchange.json          # 双积分商城+兑换码核销配置
│   └── archive_save.json           # 云端档案系统+三层存档配置
├── output_art/
│   └── 美术规范文档.md             # 6大模块美术规范（角色/场景/战斗/表情包/UI/灵宠换装）
├── output_text/desensitized/
│   ├── hiking_stations.md          # 6站徒步站点文案
│   ├── battle_story.md             # 10关闯关战斗剧情
│   └── ai_pet_dialogue.md          # 4款灵宠AI伴读对话库
└── tool/
    └── 兑换码批量生成工具.py         # 兑换码批量生成器（XIANTU/FANYAN/YOULI）
```

## 一键部署

将全部文件部署到远程服务器（默认 `173.254.205.132`）：

```bash
# 使用默认服务器和内置密码
./deploy.sh

# 自定义服务器IP和密码
./deploy.sh 1.2.3.4 YourSshPassword

# 通过环境变量传密码
SERVER_PASS=YourSshPassword ./deploy.sh 1.2.3.4
```

脚本会自动：打包项目 → 上传服务器 → 解压到 `/opt/oio-project/frontend/yuntu/` → 设置权限 → 验证访问。

> 前置依赖：本地需安装 `sshpass`（脚本会自动尝试安装）。

## 兑换码生成器使用

```bash
cd tool

# 三类各生成100个兑换码（Excel+CSV+SQL三格式）
python3 兑换码批量生成工具.py --type all --count 100 --output ./output

# 仅生成仙途勋礼包50个，有效期30天，单ID限领2次
python3 兑换码批量生成工具.py --type XIANTU --count 50 --days 30 --per-id-limit 2 --stock 500

# 生成积分抵扣券，自定义奖励内容
python3 兑换码批量生成工具.py --type YOULI --count 20 --reward '{"积分抵扣": 200}'
```

参数说明：`--type`（XIANTU/FANYAN/YOULI/all）、`--count`、`--days`（有效期天数）、`--per-id-limit`（单ID限领）、`--stock`（全局库存）、`--reward`（JSON奖励）、`--output`（输出目录）。

## 版权脱敏映射

| 类别 | 原词 → 脱敏词 |
|------|--------------|
| 角色 | 唐僧→玄清行者、孙悟空→石明小石、猪八戒→亥悟、沙悟净→尘净、白龙马→沧龙驹 |
| 灵宠 | 玉面灵猴→小石灵、云间玉兔→月绒兔、墨纹灵龟→文甲龟、金翅灵雀→云羽雀 |
| 地点 | 长安→云唐城、两界山→分界岭、高老庄→亥乡、流沙河→浊涧、火焰山→赤焰谷、大雷音寺→灵山梵台 |
| 积分 | 仙勋分→仙途勋值、经书分→梵言书卷值 |
| 兑换码 | XUN→XIANTU、JING→FANYAN、DUI→YOULI |

## 合规说明

- 所有产出内容已通过敏感词校验，不含任何原版西游 IP 元素
- 美术规范强制非写实布艺Q版风格，禁止写实/影视复刻
- 敏感词过滤库（62词）用于运行时聊天/弹幕实时拦截