gitsavvy命令灰显或报错，是因为sublime未识别git上下文：必须通过file→open folder打开含.git的最外层项目目录，确保git cli可用且sublime能继承shell path，git_path配置须为正确格式并重启生效。
GitSavvy 不是“点开就能用”的 Git 图形界面，它严格复刻命令行行为——装对、配对、开对目录，三者缺一不可，否则所有命令都灰显或报 No git repository found。
为什么 Git: Status 始终灰显或报错？
不是插件没装好，是 Sublime 没识别到 Git 上下文。GitSavvy 只在满足全部条件时才激活命令：
- 必须通过 File → Open Folder… 打开**含
.git/目录的最外层项目文件夹**（不能双击单个文件，也不能打开子目录如src/） - 终端中能正常运行
git --version（验证 Git CLI 真实可用） - Sublime 启动方式要能继承 shell PATH；macOS GUI 双击启动常失效，建议从终端执行
open -a "Sublime Text"
若仍灰显，按 Ctrl+Shift+P 输入 GitSavvy: Status —— 报错即说明前两项至少有一项失败，别查快捷键绑定。
git_path 配置写错就卡 loading
GitSavvy 默认不读系统 PATH，尤其 macOS GUI 或 Windows PATH 注册异常时必崩。手动填路径是对的，但字段名和格式极易出错：
Pilot Digital Twin Setup
下载
部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
- 配置入口：Preferences → Package Settings → GitSavvy → Settings（注意是 GitSavvy，不是 Git）
- 必须用
"git_path"字段（不是"git_binary"或"git_command"），且值为对象而非字符串 - Windows 示例：
"git_path": {"windows": "C:\Program Files\Git\bin\git.exe"}（双反斜杠） - macOS Homebrew 安装示例：
"git_path": {"osx": "/opt/homebrew/bin/git"}（不是/usr/bin/git） - 改完保存后，必须重启 Sublime Text，否则设置不生效
执行 git: push 报 “no upstream branch” 怎么办？
这不是错误，是首次推送 feature 分支的正常现象。GitSavvy 不自动设 upstream，它原样复刻 git push 行为：
- 确保已在目标分支（如
feature/login-ui）上，且已提交过至少一次 - 按
Ctrl+Shift+P输入git: push→ 选 Push current branch - 若弹出提示说
no upstream，直接回车确认 —— GitSavvy 会自动补上--set-upstream origin <branch></branch> - 之后再用普通
git: push就能一键推了
状态面板里按 a 没反应、文件不显示？
GitSavvy 的状态视图默认只列出「有变更」的文件，刚 clone 完仓库却没改任何东西，面板就是空的——这正常，不是 bug：
- 按
Ctrl+Shift+G（Win/Linux）或Cmd+Shift+G（macOS）打开状态面板后，光标必须落在某文件名上才能触发a（add）、u（unstage）、c（commit）等快捷键 - 想暂存整行修改而非整个文件？先按
s进入行级暂存模式，再用方向键选中变更块，回车确认 - 灰色文件 = 未暂存，绿色 = 已暂存；但颜色依赖主题，Monokai 下可能不明显，建议开启
diff_view_word_wrap提升可读性 - 按
a没反应？检查是否误开了 Caps Lock —— GitSavvy 快捷键区分大小写，A和a是两个操作
最容易被忽略的是：GitSavvy 的 commit 界面是临时 buffer，输完必须按 Ctrl+Enter（Win/Linux）或 Cmd+Enter（macOS）才算确认，点关闭或切 tab 就丢弃全部内容。
