快速上手

用一个真实项目走完一遍:建项目、派活、批计划、看 diff、提交。

这一页用一个真实的改动走完整条链路。假设你已经装好桌面端并登录,见在 macOS 上安装在 Windows 上安装

一、为项目目录建一个项目

侧栏点「项目」,选一个真实的工作目录。项目是为一个工作目录建立的容器,项目内的会话围绕真实文件和命令展开;不挂项目的普通对话单独管理。

会话的工作目录决定了 Klaus 的文件操作和命令默认在哪里发生,所以这一步选对目录比什么都重要。

二、把目标说清楚,让它先出计划

在输入框里描述你要的结果,而不是让它做某一步。复杂任务 Klaus 会先探索代码再写出计划,界面上出现 Plan 横幅——这时候它还没有写入权限,你批准之后才会真的改文件。

计划不对就直接说哪里不对,它会改计划再给你看。需求本身还没定的活可以先开规格模式,那种模式下它只和你写规格文档,见规格模式

三、动手时按权限卡片放行

执行写文件、运行命令这类动作前会弹权限卡片,可以允许一次、本次会话允许或始终允许。重复确认太烦就去「设置 → 预授权规则」预先配好放行与拒绝的规则,见计划模式与权限确认

四、在 Diff 视图核对改动

右侧的 Diff 视图算的是这个仓库目前相对 HEAD 的全部未提交改动,包括未跟踪的新文件,也包括你自己手改的东西。所以它是「现在这个仓库跟 HEAD 差了什么」,不是「Klaus 改了什么」。

先看文件级统计定位范围,再展开单个文件看具体行。

五、提交

在 Diff 视图提交。提交是整仓提交:先全量暂存再 commit,没有只提交部分文件的选项,所以提交前先在 Diff 里确认没有多带东西。提交信息可以让 Klaus 读着 diff 写一句。

接下来

  • 一件事要跨很多轮才做完,给会话挂一个「目标」让它自我审计终态,见目标与侧任务
  • 想让改动落在独立分支上互不干扰,用并行工作树,见并行工作树
  • 要它按时间自己跑起来,见定时任务
  • 想教它一套你自己的做法,见技能