工作区、Git 与改动

工作目录与会话工作区的区别、Diff 视图算什么、整仓提交,以及工件预览。

  • 工作目录:每个会话有自己的工作目录,Klaus 的文件操作和命令默认就在这里发生。一个会话也可以同时挂多个根目录(多根工作区),常用的组合可以存成工作区方案下次直接套用(方案内部按 id 管理,改名不会把旧方案弄丢)。
  • 注意这里有两个不同的「工作区」,容易混:一个是上面说的工作目录(你的项目),另一个是每条会话自己的那个文件夹(~/.klaus/sessions/<会话 id>/)。工作区面板和工件预览看的是后者:只能读写这个文件夹(加上你上传的文件缓存)里的东西,其他路径一律答「超出预览范围」。所以它不是一个可以绕过权限伸到项目树里的口子。
  • 排除列表:文件索引会跳过排除列表里的路径(依赖目录、构建产物这类)。搜不到本应存在的文件时先看这个列表。
  • Git:客户端自己只管三件事——列分支、切/建分支、对还不是仓库的目录执行初始化。更复杂的 Git 操作由 Klaus 用命令完成,走正常的权限确认。
  • Diff 视图:它算的是这个仓库目前相对 HEAD 的全部未提交改动(包括未跟踪的新文件),所以你自己手改的东西也会出现在里面,它不是「只属于 Klaus 的改动」的清单。改动文件超过 500 个时只给总体统计不展开逐个文件,逐文件那一栏最多列 50 个。
  • 提交是整仓提交:先 git add -A 再 commit,没有「只提交这几个文件」这个选项。所以提交前先在 Diff 里看一眼里面是不是多了你不想带上的东西。提交信息可以让 Klaus 读着 diff 写一句,空信息会被拒。
  • 仓库处于半途的 merge / rebase / cherry-pick / revert 状态时,Diff 和提交都直接拒——不会在一个没收尾的合并上再压一次提交。先把那个状态收尾。
  • 工件:Klaus 生成的网页、图片、文档在右侧面板直接预览,可切源码/预览,也可单独开窗口或在 Finder 里定位。