用途:当仓库存在 .xit/ 目录(含父目录),或用户明确要求使用 xit 时,用 xit 替代 git 执行版本控制操作。若仓库不是 xit 仓库且用户未要求,则不应强行使用。
主要能力:提供类 Git 的意图映射。status 用 xit status --cli;工作区 diff 用 xit diff --cli;已暂存 diff 用 xit diff-added --cli;log 用 xit log --cli。暂存用 xit add <path>,取消暂存用 xit unadd <path>,恢复工作区用 xit restore <path>,停止跟踪但保留文件用 xit untrack <path>,删除并停止跟踪用 xit rm <path>,提交用 xit commit -m "msg"。分支用 xit branch list/add/rm,切换用 xit switch,合并用 xit merge,拣选用 xit cherry-pick。重置语义:xit reset 类似 --mixed,xit reset-dir 类似 --hard,xit reset-add 类似 --soft。远程用 xit remote add|rm|list,拉取需先 xit fetch 再 xit merge refs/remotes/<remote>/<branch>,推送用 xit push <remote> <branch>。
使用方式:先确认 xit 可用(command -v xit),缺失则请用户安装,不要用 git 伪造。确认处于 xit 仓库可用 xit status --cli。始终使用 --cli,不要运行裸 xit(会启动 TUI),避免 TUI 入口如 xit config,改用 xit config list|add|rm。不确定时查看 xit <cmd> --help。合并或拣选冲突时,在工作区解决后 xit add 并 xit diff-added --cli,再 --continue;放弃用 --abort。
限制与注意:pull 未实现。执行 xit rm、xit restore、xit reset-dir 或强制推送/删除远程分支前需用户明确确认。不要在 .xit 仓库内运行 git,除非用户明确要求。命令缺失时查看帮助并说明限制。补丁式合并可用 xit patch on|off|all 控制。