提交新工具

了解如何提交您的新工具。

🎉 欢迎贡献新工具！

感谢您对二次元工具箱的关注！我们热烈欢迎开发者为项目贡献新的实用工具。 无论是文本处理、开发辅助、数据转换还是日常实用工具，都可以加入我们的工具库。

📋 开发规范

技术要求

  • • PHP 7.4+：使用现代 PHP 语法和特性
  • • TailwindCSS：统一的样式框架，确保界面一致性
  • • 响应式设计：支持桌面端和移动端访问
  • • 安全编码：所有用户输入必须使用 htmlspecialchars() 处理

安全要求（重要）

  • • 必须使用 htmlspecialchars()：处理所有用户输入和输出
  • • 输入验证：验证所有表单数据的格式和长度
  • • 错误处理：使用 try-catch 捕获异常
  • • 文件安全：如涉及文件操作，必须验证文件类型和路径

代码结构

  • • $tool_info：工具基本信息配置
  • • render_tool()：主渲染函数，处理页面逻辑
  • • handle_submission()：表单处理函数，返回标准格式
  • • render_form()：界面渲染函数

用户体验

  • • 清晰的错误提示：友好的错误信息和处理建议
  • • 保留用户输入：表单提交后保持用户输入内容
  • • 使用说明：提供工具使用方法和示例
  • • 即时反馈：操作结果的及时显示

🛠️ 开发步骤

1

查看模板文件

从下方示例代码开始开发

2

配置工具信息

修改 $tool_info 数组

$tool_info = [
  'name' => '您的工具名称',
  'description' => '工具功能描述',
  'category' => '工具类别',
  'version' => '0.0.1'
];
3

实现核心功能

在 handle_submission() 函数中编写工具逻辑，确保使用 htmlspecialchars() 处理所有输入

4

设计用户界面

使用 TailwindCSS 创建美观且响应式的界面

5

测试和优化

全面测试工具功能，确保安全性和稳定性

🔒 安全编码示例

<?php
function handle_submission() {
    // 1. 获取并清理输入
    $input = trim($_POST['input'] ?? '');
    
    // 2. 输入验证
    if (empty($input)) {
        return ['success' => false, 'message' => '请输入内容'];
    }
    
    // 3. 长度限制
    if (strlen($input) > 10000) {
        return ['success' => false, 'message' => '输入内容过长'];
    }
    
    try {
        // 4. 处理逻辑（示例：文本转大写）
        $result = strtoupper($input);
        
        // 5. 安全输出（重要！）
        $safe_result = htmlspecialchars($result);
        
        return [
            'success' => true,
            'message' => '处理成功！',
            'data' => $safe_result
        ];
    } catch (Exception $e) {
        return ['success' => false, 'message' => '处理失败：' . htmlspecialchars($e->getMessage())];
    }
}

function render_form() {
    ?>
    <form method="POST" class="space-y-6">
        <div>
            <label for="input" class="block text-sm font-medium text-gray-700 mb-2">
                输入内容
            </label>
            <textarea 
                id="input" 
                name="input" 
                class="w-full px-3 py-2 border border-gray-300 rounded-md"
                placeholder="请输入内容..."
            ><?php echo isset($_POST['input']) ? htmlspecialchars($_POST['input']) : ''; ?></textarea>
        </div>
        <button type="submit" class="bg-blue-600 text-white px-4 py-2 rounded">
            处理
        </button>
    </form>
    <?php
}
?>

📂 工具类别

开发工具

JSON格式化、URL编码、Base64等

文本工具

文本统计、格式转换、编码检测

安全工具

哈希生成、密码工具、加密解密

时间工具

时间戳转换、日期计算、时区转换

图像工具

图片压缩、格式转换、尺寸调整

其他工具

实用小工具、计算器、转换器

📤 提交方式

开发完成后，请通过邮箱提交您的工具文件：

邮箱提交

点击下方按钮自动打开邮件客户端

📧 发送邮件

提交内容包括：

  • 工具的 PHP 文件
  • 工具名称和描述
  • 使用说明（如有特殊要求）
  • 您的联系方式

⚠️ 重要注意事项

法律合规

  • • 确保工具不涉及版权问题
  • • 遵循开源协议和社区规范
  • • 不得包含恶意代码或后门
  • • 不得收集用户隐私信息

质量要求

  • • 工具应该免费且有实用价值
  • • 提供必要的使用说明
  • • 确保代码安全无漏洞
  • • 界面美观且易于使用

🔍 审核流程

1
收到提交后，我们会在 1-3 个工作日内进行初步审核
2
检查代码安全性、功能完整性和用户体验
3
如有问题会通过邮件反馈，通过审核后会集成到工具箱
4
工具上线后会在页面中显示贡献者信息（如需要）