配置管理

配置管理允许你保存、切换和分享参数调试配置，是调试器的核心组织功能。

预设（Profile）概念

预设是一组参数配置的集合，包含：

• 参数列表（类名.参数名）
• 每个参数的注入值
• 每个参数的锁定状态

为什么需要多预设？

场景	预设示例
调试战斗逻辑	监听 BattleUsers、BattleChatState
分析大厅数据	监听 RemoteUserData、userIdToData
测试特定功能	只监听 inBattle、userTeam
插件开发	监听插件依赖的参数

打开配置管理

方式一：点击顶部预设名称

┌─────────────────────────────────────────────────────┐
│ 🎛️ 当前编辑：默认设定                    [🔘 ON]   │
│     ↑ 点击这里                                        │
└─────────────────────────────────────────────────────┘

方式二：通过配置管理按钮（如果有）

配置管理界面

┌─────────────────────────────────────────────────────┐
│ 配置管理                                            │
├─────────────────────────────────────────────────────┤
│ [📥 导入]  [➕ 新建]                               │
├─────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ 默认设定 [正在编辑]                   [🔘 ON]   │ │
│ │ 作者: 匿名 | 参数: 5 个              [✏️][📤][🗑️]│ │
│ └─────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ PVE配置                                         │ │
│ │ 作者: Findor | 参数: 12 个           [🔘 OFF]  │ │
│ │                                   [✏️][📤][🗑️]│ │
│ └─────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 测试预设                                        │ │
│ │ 作者: 测试员 | 参数: 3 个            [🔘 OFF]  │ │
│ │                                   [✏️][📤][🗑️]│ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘

预设操作

新建预设

1. 点击 ➕ 新建 按钮
2. 填写预设名称（必填）和作者（可选）
3. 点击「创建」
4. 新预设会自动切换为当前编辑状态

切换预设

• 点击任意预设卡片即可切换
• 当前编辑的预设会有蓝色边框和「正在编辑」标记
• 切换后，主面板会立即显示该预设的参数列表

启用/禁用预设

点击预设卡片右侧的开关：

开关状态	效果
ON（绿色）	该预设的参数会生效（锁定状态的参数会注入）
OFF（灰色）	该预设的所有参数都不会注入

冲突处理：

当启用一个预设时，如果与其他已启用的预设存在相同参数，系统会提示冲突：

⚠️ 无法启用预设！
检测到同名参数冲突：
与 [默认设定] 冲突:
BattleUsers.ranks
BattleUsers.uids

解决冲突：

• 禁用冲突的预设
• 或修改参数避免重复

编辑预设信息

点击 ✏️ 图标 修改：

• 预设名称
• 作者信息

导出预设

点击 📤 图标，可选择：

方式	说明
复制到剪贴板	将预设配置复制为 JSON
保存为文件	下载为 .json 文件

导出格式示例：

{
  "name": "默认设定",
  "author": "匿名",
  "targets": {
    "BattleUsers.uids": { "val": "", "active": true },
    "BattleUsers.ranks": { "val": "[15, 30, 45]", "active": true },
    "State.inBattle": { "val": "", "active": false }
  }
}

删除预设

点击 🗑️ 图标 删除预设。

⚠️ 至少需要保留一个预设，最后一个无法删除。

导入预设

点击 📥 导入 按钮，可选择：

方式	步骤
从剪贴板解析	1. 复制 JSON 配置 2. 点击「从剪贴板解析」 3. 确认导入
选择本地文件	1. 点击「选择本地文件」 2. 选择 .json 文件 3. 确认导入

导入后会自动创建新预设并切换过去。

参数管理

在预设中，你可以：

操作	说明
添加参数	在搜索页添加
移除参数	点击参数卡片右侧的 🗑️ 图标
修改注入值	在输入框中直接编辑
启用/禁用注入	点击锁头图标

参数的所有修改会自动保存，无需手动保存。

实战示例

示例1：创建战斗调试预设

1. 新建预设「战斗调试」
2. 添加参数：
   • BattleUsers.uids（监听玩家列表）
   • BattleUsers.ranks（监听等级）
   • BattleChatState.messages（监听聊天）
   • State.inBattle（监听战斗状态）
3. 保持锁定状态为解锁（只监听不修改）
4. 启用该预设

示例2：创建测试注入预设

1. 新建预设「测试注入」
2. 添加参数并设置注入值：
   • State.userTeam → TEAM_RED
   • BattleUsers.ranks → [99, 99, 99]
3. 锁定所有参数
4. 禁用其他预设，只启用本预设

示例3：备份配置

1. 打开配置管理
2. 点击当前预设的 📤 导出
3. 选择「保存为文件」
4. 将 .json 文件保存到云盘或本地

示例4：分享配置（需遵守保密规定）

1. 导出预设为 JSON 文件
2. 在群内分享（仅限核心群，1.9.0+ 配置禁止外传）
3. 其他人导入即可使用

配置存储

预设配置保存在浏览器的 localStorage 和 GM_setValue 中：

存储位置	说明
localStorage	主存储，持久化
GM_setValue	Tampermonkey 存储，跨浏览器同步（部分支持）

配置不会因刷新或关闭浏览器而丢失。

可能丢失配置的情况：

• 清除浏览器数据
• 重装系统
• 更换浏览器

建议定期导出重要预设。

常见问题

问：预设启用了但参数没生效？

答： 检查：

1. 参数的锁头图标是否为 🔒 锁定状态
2. 输入框是否包含有效值
3. 预设开关是否为 ON（绿色）
4. 是否被其他预设冲突覆盖

问：导入预设失败？

答： 可能原因：

原因	解决
JSON 格式错误	验证 JSON 语法
缺少必要字段	确保包含 name、targets
文件损坏	重新导出

问：不同预设之间的参数会互相影响吗？

答：

• 如果只启用一个预设，不会互相影响
• 如果启用多个预设，相同参数会被后启用的预设覆盖（并提示冲突）
• 建议不同用途的预设不要同时启用

问：预设数量有上限吗？

答： 没有硬性上限，但过多预设会影响面板加载速度。建议定期清理不再使用的预设。

下一步

• 学习 变量调试 的详细用法
• 了解 插件开发 扩展功能
• 查看 API 文档 进行二次开发