Windows MySQL Python 命令桥接

问题

在 Windows 上做 MySQL 相关开发时，很多人已经习惯了 Linux 风格的 mysql -h host -P port -u user -p 这套命令行参数。但 Windows 平台的官方发行包未必提供开箱即用的 mysql.exe，或者版本、权限管理起来比较麻烦。项目又依赖 PyMySQL，于是出现了一种典型场景：希望在终端里保留熟悉的 MySQL 命令行手感，但不想引入一个重客户端，也不想再手动处理依赖和 PATH。

技能如何工作

mysql-python-shim 的目标很明确：做一个轻量桥接脚本，把 mysql 风格的参数翻译成 PyMySQL 调用。

• 核心脚本：scripts/mysql_py.py 负责解析 -h、-P、-u、-p、-D、-e 等常见参数，并与 MySQL 服务器建立连接。
• 安装与同步：scripts/install_or_sync.py 将桥接脚本同步到当前用户的 .local\bin 目录，并确保该目录已加入 Windows 用户 PATH。
• 依赖自举：如果当前 Python 环境无法 import pymysql，脚本会尝试自动安装该依赖，减少手动配置步骤。
• 交互提示：直接运行 mysql 时，会先依次提示输入 Host、Port、User、Database、Password，然后进入 SQL 交互提示符；已有连接信息时，则用显式参数直接测试连接。

适用边界

这个 shim 是面向命令行手感的轻量客户端，不是 Oracle 官方 mysql.exe 的完整替代品。它不做客户端侧的完整功能集合，比如客户端命令选项、SSL 证书管理、多语句批处理行为等，都可能与官方工具存在差异。遇到复杂运维场景，仍建议使用官方客户端。

另外，分发的 skill 包中不包含 .cmd、.bat 等可能被平台拦截的脚本，安装过程会在用户本地动态生成 mysql.cmd，以保证跨环境兼容。

一句话总结

如果你在 Windows 上想用熟悉的 MySQL 命令行参数访问 PyMySQL，又不想维护一个完整的客户端，这个 skill 是一个值得放进工具链的最小实现。