piz

piz 解决一个问题：你知道想做什么，但记不住具体命令。用自然语言描述你的需求，piz 自动翻译成适合当前系统和 Shell 的命令。

核心功能

- 自然语言转命令 — 描述需求，得到精确命令

- 多 LLM 后端 — 支持 OpenAI、Claude、Gemini、Ollama + 12 个 OpenAI 兼容供应商（DeepSeek、硅基流动、OpenRouter、Moonshot、智谱 GLM、百度千帆、阿里 DashScope、Mistral、Together、Minimax、字节 BytePlus 等）

- 安全加固 — 三层防护：Prompt 层拒绝非命令输入、注入检测（base64 载荷、环境变量泄露、反弹 Shell、curl 配置攻击）、正则危险分级

- 危险命令检测 — 正则 + LLM 双重防护，危险命令强制二次确认，无法跳过

- 命令解释 — piz -e 'command' 逐项拆解命令含义

- 命令纠错 — piz fix 自动诊断并修复失败命令，支持自动重试（最多 3 次）

- 交互式对话 — piz chat 多轮对话模式，支持 /help、/clear、/history 命令和历史持久化

- 多候选命令 — -n 参数生成多个命令方案，自主选择最优方案

- 本地缓存 — SQLite 缓存 + TTL 过期 + LRU 淘汰 + 最大条目数限制，重复查询秒返回

- 执行历史 — piz history 查看和搜索所有执行过的命令

- Shell 集成 — piz init <shell> 生成 Shell 包装函数，使 cd/export/source 在当前 Shell 中正确生效（bash、zsh、fish、PowerShell），内置便捷别名（p、pf、pc）

- Eval 模式 — --eval 将确认后的命令输出给 Shell 包装函数执行

- Shell 补全 — 支持 bash、zsh、fish、PowerShell 自动补全

- 管道模式 — --pipe 纯命令输出，便于脚本集成

- 多语言界面 — 中文、英文，安全提示信息全面国际化

- 跨平台 — Windows (PowerShell/cmd)、macOS、Linux (bash/zsh/fish)，零侵入编码处理（不修改 chcp/OutputEncoding）

- 交互式配置 — 首次运行自动引导，内置供应商预设，无需手动编辑配置

- NO_COLOR 支持 — 尊重 NO_COLOR 环境变量

- API 容错 — 429/5xx 错误自动重试 + 指数退避