AI 助手
NyaTerm 内置 AI 助手面板，可以从终端上下文、选中文本、文件操作或手动输入发起请求。它支持两种工作模式：Ask 和 Agent。
工作模式
Ask 模式
Ask 是默认模式，适合单次问答：
- 生成命令
- 解释终端输出
- 分析错误
- 从选中文本推导修复命令
AI 返回的命令以结构化卡片展示，带有风险等级标注。
Agent 模式
Agent 模式允许 AI 自主执行多步操作。它使用 ReAct 循环：观察终端输出 → 决定下一步命令 → 执行 → 再次观察，直到任务完成或达到步数上限。
Agent 模式的特点：
- 需要一个活跃的终端会话
- 每一步命令都会显示执行状态（运行中、已完成、失败、超时、需要审批、被安全策略阻止）
- 可在 设置 → AI → Agent Settings 中配置最大步数和单步超时
- 可通过
Terminal Output Lines控制 AI 执行命令时在终端中内联展示多少行输出 - 高风险命令仍然需要人工审批后才能执行
会话管理
AI 助手支持多会话管理：
- 新建对话：每次新建对话会创建独立的上下文
- 历史记录：按时间分组（今天、昨天、最近 7 天、更早）浏览历史对话
- 搜索历史：模糊搜索历史对话内容
- 删除会话：清理不需要的历史记录
会话提及
在输入框中输入 @ 可以提及其他终端会话，将它们的上下文引入当前 AI 对话。这在需要跨会话分析或对比时很有用。
命令卡片与风险控制
AI 返回的命令以结构化卡片展示，包含：
- 命令文本
- 风险等级（低 / 中 / 高 / 严重）
- 执行按钮或审批按钮
- 保存为快捷命令的选项
风险等级
| 等级 | 含义 | 默认行为 |
|---|---|---|
| 低风险 | 只读或信息查询类命令 | 可自动执行 |
| 中风险 | 修改文件或配置 | 取决于设置 |
| 高风险 | 删除、权限变更等 | 需要审批 |
| 严重 | chmod、chown、rm -rf 等破坏性操作 | 需要确认文本输入 |
在 设置 → AI 中可以配置：
- 允许自动执行的最高风险等级
- 是否开启风险检查
- 是否允许把生成命令保存为快捷命令
安全替代建议
当 AI 检测到高风险命令时，可能会同时提供更安全的替代命令供选择。
最近输出与终端内联输出
AI 助手不仅能处理选中文本，也可以直接围绕“刚刚发生了什么”来工作。
- 在终端右键菜单中使用 解释最近输出，可以把当前会话最近的终端输出直接发送给 AI
- 在 Agent 模式下，AI 执行命令时会捕获命令执行事件，并把摘要后的输出以内联片段形式反馈到终端工作流附近
Terminal Output Lines决定这类终端内联反馈最多展示多少行；设为0则关闭
推理内容
如果使用的模型支持推理通道（如 DeepSeek R1、QwQ 等），AI 助手会在回复中展示推理过程。推理内容默认折叠，可以展 开查看 AI 的思考链路。
Provider 与模型配置
在 设置 → AI 中管理 provider 和模型：
Provider 配置
- 支持内置 provider（OpenAI、Anthropic、Google、DeepSeek 等）
- 支持自定义 OpenAI Compatible provider
- 每个 provider 需要配置 API Key 和可选的 Base URL
模型管理
- 从 provider 拉取可用模型列表
- 按 provider 分组显示
- 可单独启用 / 禁用每个模型
- 选择默认模型
其他设置
- 上下文行数：发送给 AI 的终端输出行数上限
- 请求超时：单次 AI 请求的超时时间
- 记录历史：是否保存 AI 对话历史
- 敏感信息脱敏：发送前对敏感内容做处理
从终端和文件浏览器唤起
AI 助手不只能从面板手动输入，还可以从以下入口唤起：
终端右键菜单
- 解释最近输出：将当前会话最近的终端输出发送给 AI
- 解释选中内容：对选中的日志、报错或片段做解释
- 分析错误：把错误上下文交给 AI 生成修复建议
- 修复选中内容：从选中报错推导下一步命令
- 生成命令：告诉 AI 你想完成什么
文件浏览器右键菜单
对 SFTP 文件浏览器中的文件，可以通过右键菜单将文件内容发送给 AI 进行分析（受文件大小限制，可在设置中调整上限）。
错误自动检测
当终端输出中检测到错误模式时，AI 助手会提示可以自动分析该错误。