故障排查

建议消失时,先检查集成状态。

大多数自动补全问题来自 macOS 权限状态、尚未重载的 Shell,或需要重新注册的终端输入法。

ec doctor

完全没有建议

  • 确认 Easy Complete 正在菜单栏中运行。
  • 在「系统设置 → 隐私与安全性 → 辅助功能」中启用它。
  • 运行 exec $SHELL重载 Shell。
  • 打开新的终端窗口,输入 git npm 进行测试。
ec debug prompt-accessibility
exec $SHELL

Ghostty 或 Otty 中建议窗口不显示或位置错位

Ghostty、Otty、Kitty、WezTerm、Zed 和 Alacritty 使用随附输入法进行像素级精确的光标跟踪。请重新注册输入法,然后完全退出并重启终端。

ec integrations install input-method

找不到 ec 命令

安装程序会把 Easy Complete 命令行工具放在 ~/.local/bin。确认该目录已加入 PATH,然后启动新的 Shell 会话。

echo $PATH
command -v ec

收集诊断信息

如果内置检查仍未解决问题,请在提交 GitHub Issue 前输出集成和环境状态。分享之前先检查输出,并删除不希望公开的信息。

ec diagnostic

继续阅读