zh-CN/about_PSAITerminal.help.txt
|
主题 about_PSAITerminal 简短说明 在官方 PowerShell 中使用本地 AI 问答、命令建议和多步骤 Agent。 平台 支持 Windows PowerShell 5.1（x64/x86）和 Windows 上的 PowerShell 7.4 及以上版本。 Linux 和 macOS 不受支持，相关实现已从发布代码中移除。 开始使用 输入 ai 并按 Enter，新增并选择模型。 输入 ai <问题> 并按 Enter，可在任何模式下明确询问 AI。 模式 Off Enter 始终按 PowerShell 执行。 AI 自然语言进行意图分流，合法 Shell 输入保持原执行路径。 Auto 明确的命令先执行；无法运行时把原始输入交给 AI。 界面语言 默认界面语言为 English。输入 ai，选择“语言 / Language”即可切换 English 或简体中文；语言选择会持久化。 快捷键 F2 先输入内容，不按 Enter，按 F2 强制交给 AI。 F3 先输入命令，不按 Enter，按 F3 强制按 PowerShell 执行。 F6 切换 Off、AI、Auto。 F7 解释最近一次命令及其结果。 部分笔记本需要同时按 Fn。运行 Get-PSAIIntegrationStatus 可以确认快捷键是否启用。 Windows PowerShell 5.1 不提供 PowerShell 7 专属的预测器和反馈 API；状态会显示“宿主不支持”，其他功能保持可用。 诊断 Test-PSAIConfiguration 检查安装位置、配置、凭据、接口地址、PSReadLine 和快捷键。 Test-PSAIConfiguration -Online 在本地检查之外发送一次最小模型请求。 凭据 API Key 保存在 Windows Credential Manager，不写入 JSON。 模块默认请求跨登录会话持久化；受限登录会话返回 1312 时，会安全降级为当前登录会话凭据， 不会改为明文保存。 常用命令 Get-PSAIModel Get-PSAISession Get-PSAIRun Set-PSAITerminalMode Off|AI|Auto Uninstall-PSAITerminal 安全确认 AI 生成的目的、预期和副作用可能不准确，请以确认界面显示的完整命令为准。 高风险命令不支持回车默认执行，并要求第二次明确确认。 所有风险等级都展示目的、命令、预期、副作用、回滚和本地风险六项。 批准与命令、说明、计划推进信息和 Run 修订号绑定；内容变化后必须重新批准。 编辑后撤销批准，禁用工具生成四项新说明；失败显示“无法评估”，只能重新编辑或拒绝。 回滚内容只是 AI 生成的操作建议；模块不会自动备份、撤销或恢复系统状态。 命令使用当前用户权限在当前 PowerShell 会话中执行，不是隔离沙箱。 交互可靠性（1.0.4） 咨询请求不携带工具；待澄清输入只显示本地问题，请重新输入完整需求。 单步与多步按结构化计划推进，不依赖任务关键词。末步成功直接完成，不追加模型请求。 普通步骤只显示步骤完成；如需检查产物，计划必须保留验证步骤。F7 仅主动触发时解释。 Run v2 保存计划、完成条件、步骤角色、执行结果，以及正常执行、清理恢复和重试阶段。 清理成功回到原步骤，清理失败暂停，等待 ai resume <RunId>。每条清理和重试均需批准， 且计入最大步骤数；模块不能检测全部副作用，不保证恢复成功。失败不会显示成功完成文案。 旧的已完成 Run 可以查看；旧的未完成 Run 必须重新规划和批准。结果不确定时先执行 Resolve-PSAIRun 明确确认是否执行及结果，不能自动重放。 说明 PSAITerminal 不预置模型，首次安装默认为 Off，也不会自动联网。 当前包未做 Authenticode 代码签名；手动安装时应核对官方 Release 提供的 SHA-256。 API Key 不写入 JSON 配置。Windows 使用 Credential Manager； 密钥库不可用时可显式选择仅当前会话使用。 |