创建愿望清单
愿望清单功能让你可以定义「推荐物品 + 模组组合」，匹配的物品会在卡片上显示 👍 标记。你可以自己创建清单，也可以导入社区分享的清单。
快速开始
- 前往 设置 → 愿望清单 页面
- 通过以下任一方式导入清单：
- URL 导入：输入清单原始文本 URL
- 上传文件：选择
.txt文件 - 粘贴文本：直接粘贴清单内容
- 导入后，匹配的物品会在配装页面显示 👍 图标
文件格式
愿望清单是纯文本文件（.txt），每行一条规则。
标题和描述（必填）
在文件开头添加标题和描述，这两个字段是必填的，导入时会校验：
title:My God Rolls
description:...
注意：标题和描述应放在文件前几行，不要放在底部。缺少标题或描述的清单将无法导入。
可选元数据
以下字段可选，放在文件头部：
version:1.0.0
author:username
author_url:https://github.com/username
update_url:https://raw.githubusercontent.com/.../wishlist-primary.txt
update_url:https://mirror.example.com/.../wishlist-backup.txt
| 字段 | 说明 |
|---|---|
version: | 版本号，便于追踪更新 |
author: | 作者名称 |
author_url: | 作者网站链接 |
update_url: | 更新链接（可多行，作为备用源） |
update_url:可以出现多次，系统会按顺序尝试每个链接，直到成功更新。
规则格式
每条规则使用 wishlist: 前缀，一行一条：
wishlist:item=<物品ID>&perks=<词条ID1>,<词条ID2>&mods=basic.<模组ID1>,advanced.<模组ID2>
参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
item | 物品 ID（武器、船甲等） | idA |
perks | 词条 ID 列表，逗号分隔（可选） | perkA,perkB |
mods | 模组 ID 列表，逗号分隔（可选） | basic.mobA,advanced.mobB,special.mobB |
模组类型
mods的参数设定，由<模组类型>.<模组id>组成，有些模组具有前置性，因此配装需要以实际配装，否则可能出现不匹配模组类型搭配不可组合模组
| 参数 | 说明 | 例子 |
|---|---|---|
| basic | 基本 | basic.mobA |
| advanced | 高级 | advanced.mobB |
| special | 特殊 | special.mobC |
基础示例
wishlist:item=culverin5&perks=paerksA&mods=basic.mobA
这条规则表示：当 culverin5（5级长管炮）搭配词条 paerksA（词条）,模组mobA（基础模组mobA）时，标记为推荐。
仅匹配物品（不指定模组）
如果只想标记某个物品，不需要匹配特定模组组合：
wishlist:item=culverin5
注释
普通注释
以 // 开头的行是注释，会被解析器忽略：
// 这是一条注释
分隔线
--- 也会被忽略，可用于分隔不同类别的规则：
---
备注（Notes）
行内备注
在规则行末尾添加 #notes: 来附加备注信息：
wishlist:item=culverin5&perks=perkA,perkB#notes:注释内容
块备注（Block Notes）
使用 //notes: 为随后的一组规则添加统一备注：
//notes: 此处统一注释，以下愿望推荐都显示此注释
wishlist:item=culverin5&perks=direPiercing,rapidReload,firepower
wishlist:item=culverin5&perks=pierce,rapidReload,firepower
wishlist:item=culverin4&perks=direPiercing,rapidReload
以上三条规则都会继承「此处统一注释，以下愿望推荐都显示此注释」备注。
块备注在遇到下一个
//notes:或不可识别的行时自动关闭。
标签（Tags）
可以在备注中用 tags: 为规则添加标签，用于分类筛选：
//notes: 注释内容 tags:pvp,pve
wishlist:item=culverin5
标签支持逗号分隔多个值，常用标签包括：
| 标签 | 说明 |
|---|---|
pve | 适用于 PvE 内容 |
pvp | 适用于 PvP 内容 |
tank | 坦克/防御向 |
support | 支援/辅助向 |
dps | 输出 |
完整示例文件
此愿望清单演示，并非可用
title:我的配装
description:描述内容
version:1.0.0
author:UserName
author_url:https://github.com/username
//notes: 配装A tags:pve
wishlist:item=culverin5&perks=direPiercing
wishlist:item=culverin5&perks=pierce,rapidReload,firepower
wishlist:item=culverin4&perks=direPiercing,rapidReload
//notes: 配装B tags:pvp,pve
wishlist:item=demicannon5&perks=direPiercing,damage,firepower
wishlist:item=demicannon5&perks=brute,damage,firepower
wishlist:item=demicannon4&perks=direPiercing,damage
---
//notes: 配装C tags:pve,tank
wishlist:item=ironHusk5&perks=reinforcer,antiBlast,insulator
wishlist:item=ironHusk5&perks=reinforcer,douser,sealant
查找物品和模组 ID
物品 ID 和模组 ID 来源于项目的数据包 glow-prow-data，对应翻译数据在glow-prow-data-language。
完整的 ID 列表请查阅项目数据文件
glow-prow-data/src/data/items.json和modifications.json。
管理愿望清单
在 设置 → 愿望清单 页面，你可以：
- 启用/禁用：每个清单都有独立开关，禁用后该清单的规则不参与匹配
- 更新：如果清单包含
update_url，可点击「更新」按钮从远程拉取最新版本 - 导出：将清单导出为
.txt文件 - 删除：删除单个清单
- 批量操作：全部启用 / 全部禁用 / 清空所有
每张卡片还会显示：版本号、作者（可点击跳转作者网站）、去重数量、最近更新时间。
去重
导入时系统会自动检测并移除重复规则（相同物品 + 相同模组组合视为重复），卡片将显示去除了多少条重复规则。
物品来源提示
匹配的物品卡片上的 👍 图标支持悬停查看来源，显示匹配到哪个清单以及推荐备注。
分享你的愿望清单
创建好清单后，你可以：
- 将
.txt文件上传到 GitHub 仓库或 Gist - 获取原始文件链接（Raw URL）
- 分享该链接给其他玩家，他们可以通过 URL 导入