基数转换计算器 - 脚本说明文档

📋 脚本概述

基数转换计算器是一个功能强大的Web应用程序，专门用于在不同数字基数之间进行转换。该脚本基于kuai格式开发，提供了友好的Web界面，支持2-36进制的任意基数转换，包括整数和小数的转换功能。

🌟 主要特性

核心功能

• 多基数支持: 支持2-36进制的任意基数转换
• 小数转换: 不仅支持整数，还支持小数点数字的转换
• 实时转换: 输入数字后自动进行转换预览
• 步骤说明: 详细显示转换过程和计算步骤
• 转换历史: 自动保存最近10次转换记录
• 一键复制: 支持转换结果的快速复制

用户界面特性

• 现代化设计: 采用渐变色彩和圆角设计，界面美观
• 响应式布局: 适配不同屏幕尺寸，支持移动端访问
• 交互友好: 包含悬停效果、点击反馈等交互元素
• 快速转换: 提供常用转换的快捷按钮

🚀 使用方法

启动步骤

1. 配置参数

   • 服务端口: 设置HTTP服务器监听端口（默认：12001）
   • 自动打开浏览器: 选择是否启动后自动打开浏览器（默认：开启）

2. 启动脚本

   • 点击"开始转换"按钮启动服务
   • 系统会显示访问地址和端口信息
   • 如果开启了自动打开浏览器，会自动跳转到应用页面

3. 使用转换功能

   • 在"输入数字"框中输入要转换的数字
   • 选择源基数（当前数字的基数）
   • 选择目标基数（要转换到的基数）
   • 系统会自动显示转换结果和步骤

功能操作

基本转换

• 输入数字：支持整数和小数，如 123、10.5、ff.8
• 选择基数：从下拉菜单中选择2-36进制
• 查看结果：转换结果会实时显示在结果区域

快速转换

• 使用预设的快速转换按钮：
  • 二进制→十进制
  • 十进制→十六进制
  • 十六进制→二进制
  • 十进制→八进制

结果操作

• 复制结果: 点击结果旁的📋按钮复制转换结果
• 查看步骤: 在步骤区域查看详细的转换过程
• 历史记录: 查看最近的转换历史，也可以复制历史结果

🔧 技术实现

核心架构

• 后端: 使用Python标准库的http.server模块
• 前端: 纯HTML+CSS+JavaScript，无外部依赖
• 数据处理: 自定义的BaseNConverter类处理所有转换逻辑

转换算法

1. 输入验证: 检查数字在指定基数下的有效性
2. 十进制转换: 将源基数数字转换为十进制
3. 目标转换: 将十进制数字转换为目标基数
4. 步骤记录: 记录每步转换过程供用户查看

API接口

• GET/POST /api/convert: 转换API
  • 参数：number（数字）、source_base（源基数）、target_base（目标基数）
  • 返回：转换结果、步骤说明、成功状态

⚙️ 参数说明

启动参数

参数名	类型	默认值	说明
server_port	整数输入	12001	HTTP服务器监听端口号
auto_open_browser	开关	True	启动后是否自动打开浏览器

基数规则

基数范围	使用字符	示例
2-10进制	数字 0-9	二进制：1010，十进制：123
11-36进制	数字 0-9 + 字母 a-z	十六进制：ff，三十六进制：zz

📱 界面说明

主要区域

1. 标题区域: 显示应用名称和描述
2. 转换输入区: 数字输入框和基数选择器
3. 转换按钮区: 开始转换按钮
4. 结果显示区: 转换结果和复制按钮
5. 步骤说明区: 详细的转换步骤
6. 快速转换区: 常用转换的快捷按钮
7. 历史记录区: 最近的转换历史

交互特性

• 实时转换: 输入数字后自动转换（500ms防抖）
• 错误提示: 输入无效数字时显示错误信息
• 成功反馈: 复制操作有视觉反馈
• 历史管理: 自动保存历史，支持清空操作

⚠️ 注意事项

使用限制

• 端口范围: 建议使用12001-65535范围内的端口
• 基数范围: 仅支持2-36进制，不支持1进制或超过36进制
• 小数精度: 小数转换精度限制为10位小数
• 历史数量: 最多保存10条转换历史记录

常见问题

1. 端口被占用: 如果指定端口被占用，请更换其他端口
2. 浏览器兼容: 建议使用现代浏览器以获得最佳体验
3. 复制功能: 在非HTTPS环境下可能需要手动选择复制
4. 输入格式: 确保输入的数字符合源基数的字符规范

性能优化

• 防抖处理: 输入时使用防抖避免频繁转换
• 本地存储: 历史记录保存在浏览器本地存储中
• 轻量设计: 前端无外部依赖，加载速度快

🎯 适用场景

教育用途

• 计算机科学教学中的进制转换演示
• 学生练习不同进制之间的转换
• 理解进制转换的具体步骤和原理

开发工作

• 程序员进行进制转换计算
• 调试时查看不同进制的数值表示
• 数据格式转换和验证

日常计算

• 二进制、八进制、十六进制之间的快速转换
• 特殊基数的数值计算
• 数学学习和研究

📝 更新日志

当前版本特性

• ✅ 支持2-36进制转换
• ✅ 整数和小数转换
• ✅ 实时转换预览
• ✅ 转换步骤说明
• ✅ 转换历史记录
• ✅ 一键复制功能
• ✅ 响应式设计
• ✅ 快速转换按钮

技术规格

• Python版本: 3.11.0
• 操作系统: Windows 11
• 依赖包: webbrowser（标准库）
• 文件结构: 单文件应用，包含完整的HTML/CSS/JS

🆘 故障排除

常见错误及解决方案

1. "Address already in use"

   • 原因：指定端口已被其他程序占用
   • 解决：更换其他端口号（如12002、12003等）

2. "Invalid number format"

   • 原因：输入的数字包含无效字符
   • 解决：检查输入的数字是否符合源基数规范

3. 浏览器无法访问

   • 原因：防火墙阻拦或服务未启动
   • 解决：检查防火墙设置，确认服务器启动成功

4. 复制功能不工作

   • 原因：浏览器安全限制
   • 解决：使用现代浏览器或手动选择文本复制

---

开发说明: 本脚本遵循kuai格式规范，可被kuai客户端解析为友好的启动界面。所有功能集成在单个Python文件中，便于部署和使用。