This commit is contained in:
JA
2026-05-28 20:23:32 +08:00
commit f6c8230248
7 changed files with 402827 additions and 0 deletions

209
memories/system_memory.md Normal file
View File

@@ -0,0 +1,209 @@
# 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 | 解锁条件表达式 |