Shell/Bash脚本自动补全需四步：一、VSCode中配置files.associations映射.sh等后缀为shellscript；二、安装bash-completion并启用；三、用codex completion生成CLI补全脚本；四、Chat中显式声明Bash上下文及约束条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 时发现 Shell 或 Bash 脚本未获得预期的自动补全效果，则可能是由于当前环境未启用对应语言支持或未正确配置补全触发机制。以下是实现 Shell/Bash 脚本自动补全的具体操作路径：
一、启用 VSCode 中的 CodeBuddy Shell 补全支持
CodeBuddy 插件默认支持主流编程语言，但 Shell 脚本需手动激活语法识别与补全能力，以确保 .sh 文件能被正确解析并触发 AI 补全。
1、打开 VSCode 设置（Ctrl+, 或 Cmd+,）。
2、在搜索框中输入 files.associations，点击“在 settings.json 中编辑”。
3、在 JSON 配置中添加以下映射规则：
"*.sh": "shellscript",
"*.bash": "shellscript",
"*.zsh": "shellscript"
4、保存文件后，重新打开任意 .sh 文件，确认右下角状态栏显示 Shell Script 语言模式。
二、安装并加载 bash-completion 系统级补全脚本
CodeBuddy 本身不替代 shell 内置的 Tab 补全机制，但可与系统级 bash-completion 协同工作；启用该组件后，CodeBuddy 在生成或编辑命令行片段时能更准确理解上下文语义。
1、在终端中执行 sudo apt update && sudo apt install bash-completion（Ubuntu/Debian）。
2、检查 ~/.bashrc 是否已包含以下两行（若无则追加）：
if [ -f /etc/bash_completion ] && ! shopt -oq posix; then
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
. /etc/bash_completion
fi
3、运行 source ~/.bashrc 激活补全规则。
三、通过 Codex Shell 补全增强 CLI 命令智能提示
Codex 是与 CodeBuddy 同源的 CLI 工具链，其 completion 子命令可为任意自定义脚本生成语义感知型补全脚本，使 CodeBuddy 在分析管道命令（如 git log | codebuddy “分析提交”）时具备更精准的参数推断能力。
1、执行 codex completion bash > ~/.codex-completion.bash 生成补全脚本。
2、在 ~/.bashrc 中追加：source ~/.codex-completion.bash。
3、运行 source ~/.bashrc 并新开终端验证，输入 codex --
四、在 CodeBuddy Chat 中显式声明 Shell 上下文
CodeBuddy 的自然语言交互依赖明确的语境提示；若未指明目标脚本类型，模型可能默认采用通用编程逻辑而非 Shell 特定语法（如变量展开、$() 执行、IFS 行为等）。
1、在 CodeBuddy 侧边栏 Chat 输入框中，首句明确指定语言环境：
请基于 Bash 4.4 语法，为以下需求生成可执行脚本：备份指定目录并按日期归档
2、粘贴已有代码片段（如有），并标注关键约束条件：
要求：使用标准 POSIX 变量，避免数组；兼容 dash；输出日志到 ./backup.log
3、发送后等待响应，生成结果将严格遵循 Shell 词法与展开规则。
