HeyCLI: 命令行自然语言转义与智能 Shell 命令助手

HeyCLI 是一款面向开发者、运维工程师及系统管理员的“命令行自然语言智能转换工具（Natural Language to CLI）”。它无缝内嵌于你的终端或命令行工具中，将复杂的 Bash、Zsh、Git、Docker、Kubernetes 等指令记忆负担彻底消除，只需在终端键入简单的自然语言要求，HeyCLI 即可将其瞬间翻译为准确安全的命令并可一键执行。

---

🎯 解决的核心痛点

在 Linux / macOS / Windows 控制台日常工作中，技术人员普遍面临以下痛点：

1. 复杂 Shell 语法记忆繁琐：诸如 ffmpeg 视频转码、tar 级联解压、find 组合条件等复杂参数极易记错。
2. K8s & Docker 命令行冗长：kubectl 深入排查容器日志与 POD 状态的命令过于繁琐。
3. 网页搜索频繁打断工作流：遇到不懂的 Shell 语句需要不断切出终端去搜索引擎寻找示例。
4. 高危命令盲目执行风险：直接使用未核实的命令行脚本容易导致误删磁盘或生产环境事故。

---

💡 核心功能深度剖析

1. 终端内自然语言转 Shell 命令 (NL-to-CLI Engine)

直接在命令行输入 hey "将当前目录所有 png 图片转换为 webp 格式"，HeyCLI 会自动分析环境并给出精准的 Shell 语句。

2. 多环境与工具链自动适配 (Multi-CLI Adaptive)

智能感知你的操作系统类型与安装的软件包，支持生成 Bash、Zsh、PowerShell、Git、Docker、AWS CLI 与 Kubectl 等多种常用指令。

3. 命令解析与安全提示 (Command Explanation & Dry-Run)

在生成命令的同时，HeyCLI 会逐行解释参数含义（如 -cvzf 的具体选项），并在执行前进行安全二次确认，有效防范误删事故。

4. 自定义别名与高频命令收藏 (Alias & History)

支持将高频生成的组合 Shell 语句一键归档为短别名，打造极简的个人终端极速库。

---

🖥️ 界面实况与交互架构

HeyCLI 交互实况

下图展示了 HeyCLI 在命令行终端中输入自然语言并瞬间翻译输出 Shell 语句的实况：

命令行解析与安全执行架构

graph TD
    A[开发者输入: hey "自然语言描述"] --> B[HeyCLI 引擎识别 OS 与已安装工具链]
    B --> C[大模型精准翻译生成 Shell 指令]
    C --> D[显示指令解释与风险确认 Safety Warning]
    D -- 回车确认 --> E[终端内一键执行 Shell 指令]

---

🛠️ 常用指令与指南

命令示例	作用描述	场景说明
hey "查找大于 500M 的 log 文件"	自动生成 find . -size +500M 命令	极速清理服务器磁盘
hey "把当前分支最新 commit 强推"	自动生成 git push origin HEAD --force	Git 版本管理救援
hey "查看 k8s 名字叫 app 的 pod 日志"	生成 kubectl logs -l app=app	云原生集群运维排查

---

⚙️ 进阶使用技巧 (Pro Tips)

[!TIP] 结合 alias 打造超简写交互 在 .zshrc 或 .bashrc 中配置 alias h="hey"，以后在终端只需要敲 h "压缩这个文件夹" 即可瞬间生成指令！

---

❓ 常见问题解答 (FAQ)

Q: HeyCLI 是否会在后台静默执行高危命令？

A: 绝不会。HeyCLI 默认处于“建议模式（Suggestion Mode）”，生成的命令必须由开发者按回车或输入 Y 确认后方可真正执行。

Q: 是否支持 Windows PowerShell？

A: 支持。它会自动判断运行环境，在 Windows 上输出安全的 PowerShell 或 CMD 命令。