GKD项目中文规则组创建异常分析与解决方案

问题背景

在GKD项目1.10.0-beta4版本中，用户尝试创建本地订阅规则组时，当输入包含中文、英文或特殊字符的规则组名称时，系统会抛出JSON解析异常。这一现象不仅影响了中文用户的使用体验，也反映出项目在输入验证和错误处理机制上存在优化空间。

技术分析

异常触发机制

系统抛出的错误信息"非法JSON: Unexpected Char"表明，应用程序内部将用户输入直接作为JSON字符串进行解析，而实际上：

1. 对于纯中文输入（如"酷狗音乐"），解析器在首字符处就遇到了非JSON标准字符
2. 对于纯空格输入，系统识别到意外的结束符(EOP)
3. 即使是纯英文输入，由于缺少必要的JSON结构标记，同样会导致解析失败

根本原因

深入分析发现，这不是简单的字符编码问题，而是功能设计上的误解：

1. 输入预期不匹配：系统实际需要的是完整的规则组JSON结构，而非简单的名称字符串
2. 文档说明缺失：界面未明确提示所需的输入格式标准
3. 验证机制不足：缺少输入内容的预校验环节

解决方案

正确输入格式

用户应当输入完整的规则组JSON结构，例如：

{
  "key": 10086,
  "name": "酷狗音乐规则组",
  "enable": true,
  "rules": []
}

其中各字段含义：

• key：规则组唯一标识（数字）
• name：规则组显示名称（支持中文）
• enable：是否启用该规则组
• rules：具体规则数组

开发者建议

对于项目维护者，可考虑以下优化方向：

1. 界面改进：

   • 在输入框添加格式示例和字段说明
   • 实现语法高亮和实时校验

2. 功能增强：

   • 提供简易模式（先输入名称，再生成基础结构）
   • 添加模板选择功能

3. 错误处理：

   • 对常见错误给出更友好的提示
   • 记录详细的错误日志

用户实践指南

对于终端用户，建议：

1. 准备阶段：

   • 提前规划好规则组的key和名称
   • 准备必要的截图URL（如有）

2. 输入技巧：

   • 使用支持JSON格式的编辑器编写
   • 先构建最小可用结构，再逐步完善

3. 调试方法：

   • 使用在线JSON验证工具检查语法
   • 从简单示例开始，逐步增加复杂度

总结

GKD项目中规则组的创建过程需要用户提供完整JSON结构这一设计，虽然提供了高度灵活性，但也对用户的技术水平提出了要求。通过理解正确的输入格式和遵循最佳实践，用户可以顺利创建包含中文名称的规则组。同时，这也为项目未来的用户体验优化提供了明确的方向。