Skip to content

AI 助手

PeekShell 的 AI Agent 设计原则是:模型可以提议;是否自动执行由你选择的执行模式决定。默认是「手动确认」,命令不会在未批准时写入远端。

执行模式

右侧 Assist 面板顶部可切换三种模式(选择会记住)。每条提议命令都会带上风险等级(低 / 中 / 高);本地启发式还会抬升明显危险的命令(如 rm -rf、写 /etc),避免模型低估风险。

模式行为适用场景
手动确认(默认)无论风险高低,每条命令都要你点「执行」或在终端按 y 才跑生产机、不熟悉的环境、最稳妥的日常使用
自主决策低风险只读类命令自动执行;中 / 高风险仍需你确认想加快排查(lsdfjournalctl 等),同时守住改状态与破坏性操作
自动执行提议出的命令一律自动执行,不再逐条确认仅限可信的开发 / 测试机;生产环境不建议

补充说明:

  • 手动确认:完整的「提议 → 确认 → 执行」闭环,与产品默认安全策略一致。
  • 自主决策:在「效率」和「安全」之间折中——低风险可省掉确认点击;中高风险与手动确认相同。
  • 自动执行:最快,但误提议也会立刻落地;切换前请确认当前主机可承受误操作。

未连接主机时,三种模式都只会展示建议命令,不会在远端执行。

工作闭环

  1. 收集上下文:主机信息、当前工作目录、最近终端输出、你的问题
  2. 模型返回结构化结果:说明文字 + 待执行命令列表(含风险等级)
  3. 按当前执行模式决定:自动执行,或在 UI / 终端内由你同意 / 拒绝后再执行
  4. 在当前 SSH 会话执行,捕获输出
  5. 将结果回灌模型,决定结束或继续提议(需确认的命令每一轮仍要批准)

安全规则

  • 默认模式为手动确认,禁止未经批准的自动执行
  • 高危命令会通过本地规则抬升为高风险;在「自主决策」下仍需确认,「手动确认」下始终需确认
  • API Key 仅存本地;支持 OpenAI 兼容接口(含本地 Ollama 等)
  • 提议与执行应写入本地审计日志(随版本完善)

提问入口

右侧 Assist 面板

配置就绪后,可在右侧 AI 面板用自然语言提问,例如「检查 nginx 错误日志」。

终端内对话

也可直接在 SSH 终端中与 AI 对话(不打开右侧面板):

  1. Ctrl+I(可在终端设置中修改):进入 / 退出 AI 输入模式,出现 AI> 提示符后直接输入并回车
  2. 中 / 日 / 韩文字开头:在普通 shell 下输入以汉字、假名或韩文开头的一行并回车,会自动进入 AI 并发送该行(例如 检查磁盘
  3. AI 模式下的 Linux 命令:若输入像 shell 命令(如 lscd /tmpgit status、带 |/> 的管道重定向),会直接在远端执行,执行后仍留在 AI 模式;界面保留 AI> /path# ls,只显示命令输出,并隐藏 shell 回显与 user@host:~# 提示符。AI> 后会显示当前路径(来自 PS1 或 cd 跟踪),例如 AI> /home#。路径参数支持 Tab 补全(按当前目录列远端文件/文件夹,cd 只补全目录)
  4. Agent 自动/确认执行:结果以「PeekShell Agent」块回显到终端;执行后不会再刷一行远端 PS1,对话继续停在 AI>;若命令含 cd,路径提示会同步更新
  5. 一轮对话结束后也会留在 AI>,可继续提问或敲命令;仅 Esc / Ctrl+I / Ctrl+C 退出 AI(退出时再刷新远端提示符)
  6. 流式回复写在终端本地;若有待确认命令,按 y 执行、n 拒绝、Esc 取消全部
  7. 普通 shell 下 ASCII 命令仍走远端;若需执行中文路径,可用 ./脚本.sh 等 ASCII 前缀
  8. 文件树同步:终端当前工作目录变化时(PS1 / cd),下方 Entries 目录树会自动展开并选中对应路径(预览有未保存修改时跳过,以免打断编辑)

英文自然语言请用 Ctrl+I 显式进入,避免与 shell 命令混淆。Tab 在 AI 模式下用于路径补全(与 Ctrl+I 切换模式互不冲突)。