AI 助手
PeekShell 的 AI Agent 设计原则是:模型可以提议;是否自动执行由你选择的执行模式决定。默认是「手动确认」,命令不会在未批准时写入远端。
执行模式
右侧 Assist 面板顶部可切换三种模式(选择会记住)。每条提议命令都会带上风险等级(低 / 中 / 高);本地启发式还会抬升明显危险的命令(如 rm -rf、写 /etc),避免模型低估风险。
| 模式 | 行为 | 适用场景 |
|---|---|---|
| 手动确认(默认) | 无论风险高低,每条命令都要你点「执行」或在终端按 y 才跑 | 生产机、不熟悉的环境、最稳妥的日常使用 |
| 自主决策 | 低风险只读类命令自动执行;中 / 高风险仍需你确认 | 想加快排查(ls、df、journalctl 等),同时守住改状态与破坏性操作 |
| 自动执行 | 提议出的命令一律自动执行,不再逐条确认 | 仅限可信的开发 / 测试机;生产环境不建议 |
补充说明:
- 手动确认:完整的「提议 → 确认 → 执行」闭环,与产品默认安全策略一致。
- 自主决策:在「效率」和「安全」之间折中——低风险可省掉确认点击;中高风险与手动确认相同。
- 自动执行:最快,但误提议也会立刻落地;切换前请确认当前主机可承受误操作。
未连接主机时,三种模式都只会展示建议命令,不会在远端执行。
工作闭环
- 收集上下文:主机信息、当前工作目录、最近终端输出、你的问题
- 模型返回结构化结果:说明文字 + 待执行命令列表(含风险等级)
- 按当前执行模式决定:自动执行,或在 UI / 终端内由你同意 / 拒绝后再执行
- 在当前 SSH 会话执行,捕获输出
- 将结果回灌模型,决定结束或继续提议(需确认的命令每一轮仍要批准)
安全规则
- 默认模式为手动确认,禁止未经批准的自动执行
- 高危命令会通过本地规则抬升为高风险;在「自主决策」下仍需确认,「手动确认」下始终需确认
- API Key 仅存本地;支持 OpenAI 兼容接口(含本地 Ollama 等)
- 提议与执行应写入本地审计日志(随版本完善)
提问入口
右侧 Assist 面板
配置就绪后,可在右侧 AI 面板用自然语言提问,例如「检查 nginx 错误日志」。
终端内对话
也可直接在 SSH 终端中与 AI 对话(不打开右侧面板):
- Ctrl+I(可在终端设置中修改):进入 / 退出 AI 输入模式,出现
AI>提示符后直接输入并回车 - 中 / 日 / 韩文字开头:在普通 shell 下输入以汉字、假名或韩文开头的一行并回车,会自动进入 AI 并发送该行(例如
检查磁盘) - AI 模式下的 Linux 命令:若输入像 shell 命令(如
ls、cd /tmp、git status、带|/>的管道重定向),会直接在远端执行,执行后仍留在 AI 模式;界面保留AI> /path# ls,只显示命令输出,并隐藏 shell 回显与user@host:~#提示符。AI>后会显示当前路径(来自 PS1 或cd跟踪),例如AI> /home#。路径参数支持 Tab 补全(按当前目录列远端文件/文件夹,cd只补全目录) - Agent 自动/确认执行:结果以「PeekShell Agent」块回显到终端;执行后不会再刷一行远端 PS1,对话继续停在
AI>;若命令含cd,路径提示会同步更新 - 一轮对话结束后也会留在
AI>,可继续提问或敲命令;仅 Esc / Ctrl+I / Ctrl+C 退出 AI(退出时再刷新远端提示符) - 流式回复写在终端本地;若有待确认命令,按 y 执行、n 拒绝、Esc 取消全部
- 普通 shell 下 ASCII 命令仍走远端;若需执行中文路径,可用
./脚本.sh等 ASCII 前缀 - 文件树同步:终端当前工作目录变化时(PS1 /
cd),下方 Entries 目录树会自动展开并选中对应路径(预览有未保存修改时跳过,以免打断编辑)
英文自然语言请用 Ctrl+I 显式进入,避免与 shell 命令混淆。Tab 在 AI 模式下用于路径补全(与 Ctrl+I 切换模式互不冲突)。