用途：把 Ghostty 终端配置转换为 Termy 可用的 config.txt，并输出兼容性报告，避免仅因名称相似就静默照搬键位。
主要能力：定位 Ghostty 输入文件（优先显式路径，否则检查 $XDG_CONFIG_HOME/ghostty/config.ghostty、$XDG_CONFIG_HOME/ghostty/config、~/.config/ghostty/config.ghostty、~/.config/ghostty/config 及 macOS Application Support 路径）；运行内置转换脚本；按映射策略处理精确与有损映射；内联 Ghostty 的 include；将 RRGGBB 颜色规范化为 #RRGGBB；把 [colors] 放在最后（Termy 唯一的分节头）；保留普通键与重复键位行于 [colors] 之前。
使用方式：python3 scripts/convert_ghostty_to_termy.py SOURCE --output /tmp/termy-config.txt --report /tmp/termy-compatibility.json；用 --strict 重跑做结构校验；手动映射前在 references/termy-llms-full.txt 中用 rg -n 核对目标键与取值，不要加载整个 76 KB 文件。仅在用户要求安装或替换时写入 ~/.config/termy/config.txt，否则保留现有文件。
输出契约：返回生成的配置路径或文本、精确/近似/不支持/警告条目计数、对用户重要的有损或不支持设置清单，以及校验是仅结构校验还是也由 Termy 本身执行。
限制：命名主题在颜色未显式给出前视为未解析；键位前缀、序列、文本/转义注入、全局快捷键和参数化动作在 Termy 无对应文档时视为不支持；不得臆造 Termy 动作名。报告仍含重要不支持行为时，不得称迁移完成。