DOSBox-X 捕获功能文件名过滤机制优化分析

在 DOSBox-X 模拟器中，捕获功能（如截图、录像等）会使用当前 PSP（程序段前缀）内存控制块中的文件名作为基础命名。然而，当文件名包含特殊字符时，可能导致在某些操作系统（如 Windows）上无法正常创建文件。本文将深入分析该问题的技术背景、影响范围及解决方案。

问题本质

DOSBox-X 的捕获功能存在一个关键缺陷：直接从 PSP MCB 段提取文件名时，未对特殊字符进行充分过滤。当遇到包含问号（?）、方括号（[]）等 Windows 系统保留字符时，文件创建操作会失败。这种设计源于 DOS 和 Windows 文件系统命名规范的差异：

• DOS 系统允许文件名包含更多特殊字符
• Windows 系统严格限制某些字符（如 \ / : * ? " < > |）在文件名中出现

技术影响

该缺陷会导致以下具体问题：

1. 当运行某些特殊命名的 DOS 程序时，捕获功能无法生成有效文件
2. 错误文件名可能导致程序异常或功能中断
3. 跨平台兼容性问题，特别是在 Windows 系统上表现明显

解决方案设计

优化后的文件名处理机制应包含以下改进：

1. 字符过滤层：

   • 移除所有操作系统保留字符
   • 替换空格为下划线
   • 限制文件名长度

2. 默认值处理：

   • 当过滤后文件名为空时，使用默认命名规则
   • 添加时间戳保证唯一性

3. 编码处理：

   • 正确处理 OEM 到 ANSI 的字符转换
   • 处理非ASCII字符的转义

实现建议

在代码层面，建议采用以下方法：

std::string sanitize_filename(const std::string& input) {
    static const std::string forbidden_chars = "\\/:*?\"<>|";
    std::string output;
    
    for(char c : input) {
        if(forbidden_chars.find(c) == std::string::npos) {
            output += (c == ' ') ? '_' : c;
        }
    }
    
    if(output.empty()) {
        // 生成默认文件名逻辑
    }
    
    return output.substr(0, MAX_FILENAME_LENGTH);
}

兼容性考量

改进方案需要兼顾：

• 保持与原有 DOS 程序行为的兼容性
• 确保在所有宿主操作系统上正常工作
• 不破坏现有保存的文件名模式

总结

DOSBox-X 的文件名过滤机制优化是提升模拟器健壮性和跨平台兼容性的重要改进。通过实现严格的字符过滤和合理的默认值处理，可以确保捕获功能在各种环境下可靠工作。这种改进也体现了模拟器开发中需要平衡历史兼容性和现代系统要求的技术挑战。

建议用户在更新版本后测试各种边缘情况，特别是包含特殊字符的 DOS 程序文件名场景，以确保改进效果符合预期。