# 西行云途小程序 - 全流程自动化产出报告

**项目名称**: 西行云途（版权脱敏架空云途世界观）  
**执行时间**: 2026-07-07  
**执行模式**: 全自动批量处理，5大任务模块并行生成  

---

## 一、产出物清单

### 任务1：文本脱敏改写（3个文件 + 1个敏感词库）

| 文件 | 路径 | 内容 |
|------|------|------|
| 徒步站点文案 | `output_text/desensitized/hiking_stations.md` | 6站徒步路线（云唐城→分界岭→亥乡→浊涧→赤焰谷→灵山梵台），每站含地理描述、打卡任务、小故事、���物介绍 |
| 闯关战斗剧情 | `output_text/desensitized/battle_story.md` | 10关原创剧情（云雾迷径→封石重压→...→梵台净阶），含BOSS描述、通关条件、剧情对话 |
| AI灵宠伴读对话 | `output_text/desensitized/ai_pet_dialogue.md` | 4款灵宠（小石灵/月绒兔/文甲龟/云羽雀）各含性格设定、伴读对话10条、问答模板5条、战斗台词5条 |
| 敏感词过滤库 | `config/sensitive_word_filter.txt` | 62个IP黑名单词及变体，用于聊天/弹幕实时校验 |

### 任务2：美术资源规范（1个文档）

| 文件 | 路径 | 内容 |
|------|------|------|
| 美术规范文档 | `output_art/美术规范文档.md` | 6大模块：角色规范（5角色色卡HEX+双形态）、场景规范（6站点+视差参数）、战斗特效（7种元素灵怪）、表情包规范（16款）、UI规范（双模式色板）、灵宠换装（4款×3-4套皮肤） |

### 任务3：数据库SQL（1个脚本）

| 文件 | 路径 | 内容 |
|------|------|------|
| 云途档案建表SQL | `database/云途档案建表.sql` | 8张表（用户档案/徒步/战斗/PK/灵宠/积分/兑换码/弹幕）、27个索引、唯一16位档案ID主键、无微信字段、每日自动备份事件、11条示例INSERT |

### 任务4：前端功能配置（6个JSON）

| 文件 | 路径 | 内容 |
|------|------|------|
| 徒步主页面 | `frontend/config/map_page.json` | 6站点路线、小人跟随、打卡逻辑、自动漫游、灵宠双形态悬浮 |
| 战斗+PK | `frontend/config/battle_pk.json` | 6关闯关BOSS、师徒4人+1灵宠阵型、灵宠buff、1v1/5v5匹配、积分规则 |
| 弹幕+聊天 | `frontend/config/chat_barrage.json` | 弹幕配置、仙途勋值消耗、三级敏感词拦截、12个布艺表情、限流 |
| AI灵宠NPC | `frontend/config/ai_pet.json` | 4款灵宠双形态、AI伴读、问答交互、双增益buff、8款皮肤、对话模板 |
| 积分商城 | `frontend/config/shop_exchange.json` | 双积分商城（7+7商品）、兑换码核销、抵扣券、礼包有效期 |
| 档案存档 | `frontend/config/archive_save.json` | 二维码登录、三层存档、时光轴、海报导出、AES-256加密、7天回滚 |

### 任务5：兑换码生成器（1个脚本）

| 文件 | 路径 | 内容 |
|------|------|------|
| 兑换码批量生成工具 | `tool/兑换码批量生成工具.py` | ExchangeCodeGenerator类、三前缀(XIANTU/FANYAN/YOULI)、Excel+CSV+SQL三格式导出、argparse命令行、防重复去重 |

---

## 二、版权脱敏合规

### 脱敏映射（全项目统一调用）

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

### 合规校验结果

- ✅ 所有产出内容（文案/美术/SQL/JSON/工具）均无IP黑名单词
- ✅ 敏感词库文件本身含黑名单词（用于实时过滤，功能正确）
- ✅ 美术规范强制非写实布艺Q版，禁止写实/原版IP元素
- ✅ JSON格式全部合法（6/6通过 `json.loads` 校验）
- ✅ SQL语法正确（8表+27索引+外键+备份事件）

---

## 三、部署信息

### 服务器部署（sa.oio.net.cn）

所有产出物已部署到服务器 `173.254.205.132` 的 `/opt/oio-project/frontend/yuntu/` 目录，通过 HTTPS 可访问：

| 访问地址 | 说明 |
|----------|------|
| `https://sa.oio.net.cn/yuntu/output_art/美术规范文档.md` | 美术规范 |
| `https://sa.oio.net.cn/yuntu/database/云途档案建表.sql` | SQL脚本 |
| `https://sa.oio.net.cn/yuntu/frontend/config/*.json` | 6个前端配置 |
| `https://sa.oio.net.cn/yuntu/tool/兑换码批量生成工具.py` | 兑换码生成器 |
| `https://sa.oio.net.cn/yuntu/config/sensitive_word_filter.txt` | 敏感词库 |

### Gitee仓库推送

| 项目 | 信息 |
|------|------|
| 仓库地址 | https://gitee.com/wwfcyq/code.git |
| 分支 | master |
| 最新commit | `da3f137` feat: 新增西行云途小程序全流程自动化产出物 |
| 仓库内路径 | `yuntu/` 目录下 |

### 兑换码生成器使用示例

```bash
# 生成三类各100个兑换码
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}'
```

---

## 四、项目文件结构

```
xixing-yuntu/
├── config/
│   └── sensitive_word_filter.txt      # 62个敏感词过滤库
├── database/
│   └── 云途档案建表.sql                # 8表+27索引+备份事件
├── frontend/config/
│   ├── map_page.json                  # 徒步主页面
│   ├── battle_pk.json                 # 战斗+PK
│   ├── chat_barrage.json              # 弹幕+聊天
│   ├── ai_pet.json                    # AI灵宠NPC
│   ├── shop_exchange.json             # 积分商城+兑换码
│   └── archive_save.json              # 档案存档系统
├── output_art/
│   └── 美术规范文档.md                  # 6大模块美术规范
├── output_text/desensitized/
│   ├── hiking_stations.md             # 6站徒步文案
│   ├── battle_story.md                # 10关战斗剧情
│   └── ai_pet_dialogue.md             # 4款灵宠AI对话库
└── tool/
    └── 兑换码批量生成工具.py             # 三前缀兑换码生成器
```

**共计 13 个文件，全部版权脱敏合规，已部署到 sa.oio.net.cn 并推送到 gitee 仓库。**