zh-CN/about_PSAITerminal.help.txt
|
主题 about_PSAITerminal 简要说明 运行在 PowerShell 里的 AI 助手：用自然语言提问或描述任务，AI 提议的每条命令都要你确认后才执行。 平台 仅限 Windows：Windows PowerShell 5.1（x64/x86）和 PowerShell 7.4 及以上。 开始使用 输入 ai 回车打开设置，在“模型配置”中新增模型。 输入 ai mode Auto 切换到推荐的 Auto 模式（新安装默认是 Off）。 任何模式下都可以用 ai <内容> 显式交给 AI。 模式 Auto 能直接执行的 PowerShell 命令原样执行；自然语言、拼错的命令和语法错误交给 AI。 AI 所有输入都交给 AI，包括合法命令和未写完的代码。 Off 普通 PowerShell。 Auto 不猜你是想咨询还是想操作，由模型决定直接回答还是提议命令。 未写完的代码在 Auto 和 Off 下保持原生续行。以命令名开头的英文句子（如 where is ...） 会被当作命令执行，这时用 F2 交给 AI。 执行确认 每条提议的命令都会显示目的、完整命令和本地计算的风险： [Y] 执行 [A] 本会话总是允许 <命令名> [E] 放入命令行编辑 [N] 拒绝 Y 执行。低、中风险直接回车即为 Y；高风险没有默认项，并要求再确认一次。 A 执行，并在本次 PowerShell 会话内对同名命令免确认。高风险不提供此选项。 E 不执行，把命令放进下一次的输入行，由你修改后自己回车。 N 拒绝。可以附一句话告诉 AI 怎么改；直接回车则取消任务。 命令在当前会话中执行，目录、变量和函数都会保留。输出交回模型，模型继续下一步或用一两句话结束。 单个任务最多执行 12 条命令（Set-PSAITerminalOption -MaxAgentSteps 可调）。 风险等级 风险由本地规则计算，不采信模型的判断。 Low 查询类（Get-*、Test-*、Select-* 等）、cd、ipconfig、ping、whoami、git status/log/diff。 High 删除、停止、卸载、清空类命令，rm、del、taskkill、Invoke-Expression、下载后执行、 嵌套 cmd/powershell，注册表、服务、磁盘操作，git clean、git reset --hard、强制推送。 Medium 其余命令，包括写文件、安装、启动程序和未知命令。 会话中重新绑定的别名和覆盖内置命令的函数，按实际目标重新分级。 免确认列表 Set-PSAITerminalOption -AutoApprove 'Get-*', 'git status' 匹配的中低风险命令不再询问；高风险命令始终需要确认。 git、npm、dotnet 等工具按“工具 子命令”匹配；含重定向、赋值或 .NET 调用的命令总是询问。 失败诊断 Auto 和 AI 模式下命令失败后会提示“命令失败 · 按 F7 诊断修复”。按 F7，AI 先说明原因再提议 修正命令，同样需要你确认。不会自动调用模型。 快捷键 F2 把当前输入交给 AI。 F3 把当前输入按 PowerShell 执行。 F6 在 Off、AI、Auto 之间切换。 F7 上一条命令失败时诊断并修复；成功时解释它做了什么。 部分笔记本需要同时按 Fn。运行 Get-PSAIIntegrationStatus 可以确认快捷键是否启用。 模型 可选择 OpenAI、Anthropic、Google Gemini、DeepSeek、本机服务（Ollama、LM Studio）或其他 OpenAI 兼容服务。除 Anthropic 外都使用 OpenAI 兼容接口；地址已含版本段（/v1、/api/v3 等）时原样使用， 否则自动补 /v1。本机地址可以不填 API Key。 API Key 保存在 Windows 凭据管理器中，不写入 JSON 配置。 常用命令 ai help | ai clear | ai new <名称> | ai mode Off|AI|Auto Get-PSAIModel、Select-PSAIModel、Test-PSAIModel Get-PSAISession、New-PSAISession、Clear-PSAISession Get-PSAITerminalOption、Set-PSAITerminalOption Test-PSAIConfiguration、Get-PSAIIntegrationStatus Uninstall-PSAITerminal [-PurgeUserData] 安全说明 命令以当前用户权限在当前会话中执行，不是沙箱。 风险等级和目的说明只是辅助，确认前请看完整命令。 含有会被脱敏规则改写的密钥字面量的命令会被拒绝，请改用变量或凭据引用。 卸载 Uninstall-PSAITerminal 删除模块和 Profile 自动加载区块，保留配置和凭据。-PurgeUserData 同时删除 已确认的配置、会话，以及配置中模型对应的 PSAITerminal/Model/<名称> 凭据。 两个卸载入口都会先检查路径和归属。已加载的 DLL 无法删除时，关闭终端后在 pwsh -NoProfile 中 运行 Uninstall-PSAITerminal.ps1。 |