# Quest 数据管理系统 - 记忆文件

## 1. 项目概述

本项目是一个基于 Markdown 和 CSV 的游戏任务数据管理系统，用于管理游戏中的各种任务数据。

### 1.1 核心功能

- **数据建模**: 使用 Markdown 文档定义字段规范和校验规则
- **数据存储**: 使用 CSV 文件存储任务数据
- **数据校验**: 自动验证数据完整性和格式正确性
- **数据索引**: 支持按多种字段进行快速查询

### 1.2 项目结构

```
f:\表格/
├── quest_schema.md          # 数据建模文档
├── data_validator.py        # 数据校验器
├── data_indexer.py          # 数据索引系统
├── update_main_quest_rewards.py  # 主线任务奖励更新脚本
├── fix_achievement_desc.py  # 成就数据修复脚本
├── csv_output/              # CSV 数据文件目录
│   └── quest.csv            # 任务数据文件
└── memories/                # 记忆文件目录
    └── system_memory.md     # 系统记忆文件
```

## 2. 当前数据统计

### 2.1 任务分类统计

| 分类ID | 分类名称  | 记录数 |
| ---- | ----- | --- |
| 1    | 主线任务  | 115 |
| 2    | 日常任务  | 9   |
| 3    | 通行证任务 | 60  |
| 4    | 修炼任务  | 15  |
| 5    | 周常任务  | 13  |
| 6    | 公会任务  | 0   |
| 7    | 委托任务  | 0   |
| 8    | 称号任务  | 0   |
| 9    | 成就任务  | 65  |
| 10   | 七日任务  | 0   |

### 2.2 总计

- **任务总数**: 277 条
- **数据文件**: `csv_output/quest.csv`
- **最后更新**: 2026-05-28

## 3. 核心字段映射

### 3.1 Category（任务类型）

| 值 | 描述    | ID格式        |
| - | ----- | ----------- |
| 1 | 主线任务  | 10001-10115 |
| 2 | 日常任务  | 20001-20009 |
| 3 | 通行证任务 | 30001-30060 |
| 4 | 修炼任务  | 40001-40015 |
| 5 | 周常任务  | 50001-50013 |
| 9 | 成就任务  | 90001-90065 |

### 3.2 Type（行为类型）- 普通任务

| 值  | 描述     | 单位    |
| -- | ------ | ----- |
| 1  | 招募     | 次     |
| 2  | 英雄升级   | 次     |
| 3  | 英雄升阶   | 次     |
| 4  | 主角升级   | 次     |
| 5  | 装备升级   | 次     |
| 6  | 通过     | 关主线关卡 |
| 7  | 击败     | 波敌人   |
| 8  | 商店购买   | 次     |
| 9  | 消耗     | 金币    |
| 10 | 消耗     | 勾玉    |
| 11 | 登录     | 天     |
| 12 | 开      | 次宝箱   |
| 13 | 挑战     | 次副本   |
| 14 | 挑战     | 次竞技场  |
| 15 | 获得     | 个英雄   |
| 16 | 领取     | 次游历奖励 |
| 17 | 世界频道发言 | 次     |

### 3.3 Type（行为类型）- 成就任务

| 值  | 描述      | 单位    |
| -- | ------- | ----- |
| 1  | 累计招募    | 次     |
| 2  | 英雄累计升级  | 次     |
| 3  | 英雄累计升阶  | 次     |
| 4  | 主角累计升级  | 次     |
| 5  | 装备累计升级  | 次     |
| 6  | 累计通关    | 关主线关卡 |
| 7  | 累计通关    | 波敌人   |
| 8  | 商店累计消费  | 次     |
| 9  | 累计消耗    | 金币    |
| 10 | 累计消耗    | 钻石    |
| 11 | 累计登录    | 天     |
| 12 | 无       | -     |
| 13 | 累计挑战副本  | 次     |
| 14 | 累计挑战竞技场 | 次     |
| 15 | 累计获得    | 位英雄   |
| 16 | 累计领取    | 次挂机奖励 |
| 17 | 累计消耗    | 秒     |
| 18 | 累计点赞好友  | 次     |
| 19 | 累计英雄委托  | 次     |
| 20 | 累计击败    | 个敌人   |
| 21 | 战力达到    | 万     |
| 22 | 主角到达    | 阶     |
| 23 | 累计委托    | 次     |

## 4. 奖励系统配置

### 4.1 主线任务奖励增长规则

| 奖励ID           | 初始值  | 增长机制         | 最后值（预测） |
| -------------- | ---- | ------------ | ------- |
| item\_10000001 | 2400 | 随机增长 400-450 | \~50000 |
| item\_10000002 | 50   | 固定增长 50      | 5750    |

### 4.2 Score（任务积分）映射

| Category | Score |
| -------- | ----- |
| 2（日常）    | 20    |
| 5（周常）    | 20    |
| 6（公会）    | 20    |
| 10（七日）   | 20    |
| 9（成就）    | 25    |
| 其他       | 0     |

## 5. 系统规则

### 5.1 ID 生成规则

- 格式: `category * 10000 + 序号`
- 序号从 0001 开始连续递增
- 示例: 10001, 10002, 10003...

### 5.2 Next 字段规则

- category=1（主线）: 可填写后续任务ID或0
- category≠1: 必须填写0

### 5.3 Desc 字段规则

- 必须以中文句号"。"结尾
- 格式: `类型描述 + 数值(格式化) + 单位 + 。`
- 数值 >= 1亿: X亿
- 数值 >= 1万: X万
- 数值 < 1万: 原值

## 6. 操作历史

### 6.1 最近操作记录

| 时间         | 操作     | 描述                      |
| ---------- | ------ | ----------------------- |
| 2026-05-14 | 奖励配置更新 | 更新主线任务奖励增长机制            |
| 2026-05-14 | 成就规则更新 | 添加category=9的特殊type映射规则 |
| 2026-05-14 | 数据修复   | 修复65条成就数据的desc字段        |
| 2026-05-14 | 字段规范更新 | 添加score字段取值规则           |
| 2026-05-14 | 字段规范更新 | 添加next字段填写规则            |

### 6.2 脚本工具列表

| 脚本名称                           | 功能       |
| ------------------------------ | -------- |
| `data_validator.py`            | 数据校验工具   |
| `data_indexer.py`              | 数据索引工具   |
| `update_main_quest_rewards.py` | 主线任务奖励更新 |
| `fix_achievement_desc.py`      | 成就desc修复 |

## 7. 数据索引

### 7.1 索引字段

- **idx\_id**: 主键索引（任务唯一标识）
- **idx\_category**: 分类索引（按任务类型检索）
- **idx\_type**: 类型索引（按行为类型检索）

### 7.2 查询示例

- 按ID查询: `SELECT * FROM quest WHERE id = ?`
- 按分类查询: `SELECT * FROM quest WHERE category = ?`
- 按类型查询: `SELECT * FROM quest WHERE type = ?`

## 8. 扩展计划

### 8.1 待扩展表格

| 表格名              | 用途      | 优先级 |
| ---------------- | ------- | --- |
| quest\_progress  | 玩家任务进度  | 高   |
| quest\_group     | 任务组/任务链 | 中   |
| quest\_condition | 任务解锁条件  | 中   |

### 8.2 未来扩展字段

| 字段名               | 类型       | 用途      |
| ----------------- | -------- | ------- |
| start\_time       | datetime | 任务开始时间  |
| end\_time         | datetime | 任务结束时间  |
| repeat\_type      | int      | 重复类型    |
| unlock\_condition | string   | 解锁条件表达式 |