无名杀选将栏武将代码不显示？

Question

在使用无名杀自定义武将时，部分用户遇到“选将栏武将代码不显示”的问题，表现为添加了合法JS代码后，武将在选择界面无法正常出现。常见原因包括：代码语法错误导致脚本加载失败、武将ID重复或命名不符合规范、未正确调用`extension.addCharacter()`方法注册武将，以及浏览器缓存未及时更新。此外，部分扩展模式下需手动启用对应扩展包。建议通过F12开发者工具查看控制台报错信息，逐项排查代码结构与注册逻辑，确保JSON格式正确且无变量未定义问题。

Answer 1

无名杀自定义武将“选将栏不显示”问题深度解析

1. 问题现象与初步定位

在使用无名杀（WuMingSha）进行自定义武将开发时，开发者常遇到添加了合法JS代码后，武将在角色选择界面无法正常显示的问题。该现象通常表现为：代码已保存、页面刷新，但目标武将未出现在选将列表中。

初步排查方向包括：

• 检查是否调用了extension.addCharacter()注册接口
• 确认浏览器控制台是否存在报错信息
• 验证扩展包是否已在游戏设置中启用

2. 常见原因分类与技术分析

从实际案例统计来看，导致此问题的根源可归纳为以下几类：

类别	具体表现	影响层级
语法错误	JSON格式错误、缺少逗号或引号不匹配	脚本加载失败
ID命名冲突	武将ID重复或包含非法字符（如空格、特殊符号）	注册被忽略
注册方法缺失	未调用extension.addCharacter()	内存未注册
缓存机制干扰	浏览器或本地存储未更新最新JS文件	旧版本运行
扩展未启用	多扩展模式下未开启对应模块	逻辑不可见

3. 深度调试流程图解

```mermaid
graph TD
    A[添加自定义武将JS代码] --> B{是否通过F12查看控制台?}
    B -- 是 --> C[检查是否有语法错误]
    B -- 否 --> D[打开开发者工具]
    D --> C
    C --> E{存在错误?}
    E -- 是 --> F[修复JS/JSON语法]
    E -- 否 --> G[检查extension.addCharacter调用]
    G --> H{正确注册?}
    H -- 否 --> I[补全注册逻辑]
    H -- 是 --> J[确认武将ID唯一且合规]
    J --> K{ID合法?}
    K -- 否 --> L[修改为小写字母+数字组合]
    K -- 是 --> M[清理浏览器缓存并重启]
    M --> N[进入游戏设置启用扩展]
    N --> O[验证武将是否出现]

4. 核心代码结构示例与规范要求

一个符合无名杀规范的武将注册代码应具备如下结构：

extension.addCharacter({
    name: 'custom_zhangfei',
    nickname: '勇猛张飞',
    sex: 'male',
    group: 'shu',
    hp: 4,
    skills: ['paoxiao'],
    skillTips: {
        paoxiao: '出牌阶段限一次，你可以弃置一张牌并指定一名其他角色，对其造成1点伤害。'
    },
    designer: 'DevTeam',
    content: `
        <p>张飞，字益德，蜀汉五虎上将之一。</p>
    `
});
    

注意事项：

• name字段必须唯一，建议采用扩展名_武将名格式
• 避免使用保留关键字作为ID（如null, undefined）
• 所有字符串需用双引号包裹，符合标准JSON语法
• 确保skills数组中的技能已预先定义

5. 高级排查手段与生产环境适配

对于资深开发者，在团队协作或CI/CD环境中部署自定义武将时，还需考虑以下因素：

1. 使用Webpack等打包工具时，需确认模块导出机制兼容无名杀插件系统
2. 在Node.js服务端预编译JS时，注意转义字符处理（如\n替换为换行）
3. 利用localStorage.debug = 'wms:*'开启无名杀内部调试日志
4. 通过game.characters全局对象手动检查注册结果
5. 编写自动化测试脚本验证addCharacter返回值
6. 监控window.onerror捕获异步加载异常
7. 使用Source Map映射压缩后的JS代码便于定位原始位置
8. 在Docker容器中模拟用户环境进行集成测试
9. 建立Git Hooks防止提交含语法错误的武将配置
10. 构建可视化管理后台实现武将动态增删