跳到主要内容

第一次对话

这是在真实文件夹里的第一轮会话。若还没安装 KnoxCoder,先看 安装。若输入框没有模型,先看 登录与模型。

1. 打开文件夹​

文件 → 打开文件夹…(或工作区)。Knox Agent 把 当前活动编辑器文件 所在文件夹当作主根:shell、git、构建和相对路径都在那里跑。搜索、glob、AGENTS.md、hooks、自定义 Agent 仍覆盖多根工作区里的所有文件夹。

没有文件夹的窗口也能聊天,但 Agent 没有被允许修改的树。打开你真正要改的项目。

细节见 打开文件夹。

2. 打开 Knox​

  • 点活动栏里的 Knox 图标,或
  • ⌘L / Ctrl+L — 聚焦对话,把当前选区加入上下文并清空输入框
  • ⌘⇧L / Ctrl+Shift+L — 加入上下文但不清空

面板是原生侧边栏:上面是记录,下面是输入框,权限条在输入框上。

3. 选择模型​

用输入框上的 模型选择器。KnoxStudio 或 OpenRouter OAuth 之后,目录来自该账号。自备密钥则只看到你加过的模型。

可选:设置 knoxchat.fallbackModel(是模型 标题,不是 id),在反复出现瞬时流失败(429、5xx、网络)后换第二个模型。留空表示永不切换。

4. 看权限条​

新会话会选一种模式:

模式读取改文件Shell
Ask自动先问你先问你
Edits自动自动先问你
Auto自动自动自动
  • Knox 已经用过 的文件夹,或 git remote 在 knoxchat.trustedGitRemotes 里的,新会话从 Auto 开始。
  • 全新克隆(该文件夹没有过 Knox 会话,remote 也未加入白名单)从 Ask 开始,权限条上有一行提示。
  • knoxchat.permissionDefault(auto / ask / edits)覆盖上述启发式。你为该文件夹保存过的模式仍然优先。

在权限条上切换 Ask / Edits / Auto,或按 Shift+Tab。完整表格见 权限模式。

Plan 是输入框上另一个开关,不是第四种权限。Plan 里 Knox 只能读、搜索、问你、写清单。写入、shell、PTY、QEMU 会回复 “leave Plan mode to execute。” Execute plan 在 同一会话 切回 Agent。执行时仍遵守 Ask / Edits / Auto。细节见 Plan 模式。

破坏性命令(git push --force、git reset --hard、git clean -fd、chmod -R、裸设备写入、curl | sh、find -delete 等)在 所有 模式下都会被拦住,除非你在 Agent 策略里允许该命令。

不信任的仓库请留在 Ask 或 Edits。

5. 先发只读问题​

试一个不需要写入的问题:

这个仓库构建的是什么?入口在哪?

你应该看到:

  • 已分类项目上的 Turn Context(打开的文件、git 状态、诊断)
  • 读取和搜索的工具卡片
  • 正常的助手回复

输入框上的 NN% 是上下文占用。大约 75% 时 Knox 会压缩历史。

Connection problem, retrying (n/4) 表示瞬时流失败。失败两次后,若设置了 knoxchat.fallbackModel 会改用它。限流 / 密钥无效 / 找不到模型会弹出 Retry 和 Open settings。

6. 再做一个小修改​

切到 Edits(若已信任该文件夹也可保持 Auto)。只要求一处小改动:

在 main 函数上方加一行注释说明它做什么。不要改行为。

预期:

  1. 改文件前有一个 检查点(不依赖 git;之后用 Knox: View Checkpoints 还原)。
  2. 出现编辑工具卡片。流式文件卡片会显示 CheckPoint 的 +N / −N 行数。
  3. 若模式弹出菜单里开了 Review edits,文件修改先留在内存,直到你逐个应用或丢弃。Shell 仍然打真实磁盘,不是暂存树。细节见 审阅编辑。
  4. 发生写入后,可能会跑诊断或你的校验命令(应用树用 LSP;systems / Rust 配置用 make / cargo check)。配置表见 Agent 配置。

若想在编辑器里改当前选区而不是侧边栏,按 ⌘I / Ctrl+I。2.2 里幽灵文字行内补全是 关 的(没有 FIM 模型)。细节见 行内编辑(Cmd+I)。

7. 停止、撤销、下一会话​

  • 输入框上的 Cancel(macOS 上界面显示 ⌘⌫)停止当前生成。
  • Knox: Undo Last Assistant Operation 还原上次编辑前的检查点。
  • Knox: New Conversation 开新会话。历史在 Knox: View History。

第一天的对话不需要 recipes、hooks 或自定义 Agent。那些之后再讲。

第一天常用命令​

命令面板作用
Knox: Open Knox Settings分组搜索 knoxchat.*
Knox: SettingsAgent 设置层(模型、Agent 开关)
Knox: View MemoryMemory Brain
Knox: View Checkpoints还原 / Checkpoint Graph
Knox: Show Jev Log套件判定(从不发送文件内容)

在输入框输入 /instructions 可查看加载了哪些 AGENTS.md / 规则 / skills 以及占用多少 token。仓库还没有 AGENTS.md 时,/init 会写一份(覆盖需 --force)。

接下来​