Quest 数据管理系统 - 记忆文件
1. 项目概述
本项目是一个基于 Markdown 和 CSV 的游戏任务数据管理系统,用于管理游戏中的各种任务数据。
1.1 核心功能
- 数据建模: 使用 Markdown 文档定义字段规范和校验规则
- 数据存储: 使用 CSV 文件存储任务数据
- 数据校验: 自动验证数据完整性和格式正确性
- 数据索引: 支持按多种字段进行快速查询
1.2 项目结构
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 |
解锁条件表达式 |