pi-shell-autocomplete

pi终端Shell命令补全扩展,支持zsh原生补全与本地AI幽灵文本

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-shell-autocomplete。
它的用途是:pi终端Shell命令补全扩展,支持zsh原生补全与本地AI幽灵文本
完整的 Skill 内容见:https://321skill.com/skills/pi-shell-autocomplete/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我补全当前输入的docker启动命令',它会结合当前目录的容器配置与历史操作记录,在输入行后方展示完整带参数的命令幽灵文本,按Tab键即可快速采纳。

对AI说:'补全我正在输入的日志查询命令',它会整合zsh原生补全规则与本地AI上下文分析,展示符合当前场景的完整grep查询命令。

介绍

日常使用终端执行Shell命令时,用户常遇到命令参数记不全、长命令拼写易出错的问题,传统补全仅能匹配历史记录或内置固定规则,无法结合当前操作上下文智能推荐,频繁查文档、翻历史会打断操作节奏,大幅降低终端操作效率。 安装完成后会自动集成到pi终端环境,默认加载zsh原生补全规则,同时本地部署的AI模型会实时分析当前输入的命令前缀、所在目录上下文、过往操作习惯,在输入行后方以浅灰色幽灵文本展示预测的完整命令,按下右箭头或Tab键即可快速采纳补全内容,全程无需联网。 适合经常在终端开展开发、运维操作的技术人员,习惯使用zsh作为默认Shell、追求终端操作效率的开发者,以及注重数据隐私、不希望本地命令数据上传至云端AI服务的用户。 使用前请确保本地已正确配置zsh运行环境,若需启用AI幽灵文本功能需提前部署好对应的本地AI运行依赖,若出现补全规则冲突,可暂时关闭AI补全仅保留zsh原生补全能力。

核心特点

它专门适配pi终端,同时整合zsh原生补全规则与本地离线AI幽灵文本能力,无需上传命令数据到云端即可获得智能补全体验,区别于仅支持规则补全或依赖云端AI的同类Shell工具。

注意事项

仅支持pi终端搭配zsh环境使用,不兼容bash、fish等其他Shell,且AI补全效果受本地部署模型的能力限制。

常见问题

使用这个补全工具需要联网吗?

zsh原生补全无需联网,AI幽灵文本功能基于本地模型运行,全程不需要联网。

支持bash、fish等其他Shell吗?

目前仅适配zsh环境,暂不支持bash、fish等其他类型的Shell。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-shell-autocomplete/raw/index.md 读取 pi-shell-autocomplete 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。