workbuddy安装脚本报“syntax error”等错，主因是shell解释器不兼容bash特有语法。需确认shebang与实际解释器一致，强制用/bin/bash执行，修复posix兼容性，转换crlf换行符，并确保bash版本≥4.0。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在执行WorkBuddy安装脚本时遇到“syntax error near unexpected token”或“unexpected EOF”等报错，极可能因系统默认Shell解释器不兼容脚本中使用的bash特有语法（如[[ ]]、数组、source增强用法）所致。以下是解决此问题的步骤：
一、确认当前Shell解释器类型与实际调用路径
安装脚本首行的shebang（如#!/bin/bash）声明了预期解释器，但若系统将/bin/sh指向dash、ash或旧版sh，则会忽略bash扩展语法，直接报错。需验证脚本实际运行环境是否与声明一致。
1、打开终端，执行echo $SHELL查看当前登录Shell路径。
2、运行ls -l /bin/sh，确认其真实指向（例如/bin/dash或/bin/bash）。
3、检查WorkBuddy安装脚本首行：使用head -n1 /path/to/workbuddy-install.sh读取shebang内容。
4、手动以声明解释器运行脚本：若首行为#!/bin/bash，则执行/bin/bash /path/to/workbuddy-install.sh；若为#!/bin/sh，则执行/bin/sh /path/to/workbuddy-install.sh，对比是否仍报错。
二、强制使用bash解释器执行安装脚本
绕过系统默认/bin/sh限制，确保脚本在完整bash环境中解析，可避免所有bash专属语法被误判为错误。
1、进入安装脚本所在目录，执行chmod +x workbuddy-install.sh确保可执行权限。
2、直接调用bash解释器运行：/bin/bash ./workbuddy-install.sh。
3、若脚本内含相对路径引用（如./helper.sh），需同步确保被调用脚本也使用/bin/bash显式执行，或统一修改其shebang为#!/bin/bash。
4、Windows Subsystem for Linux（WSL）用户需额外确认发行版默认Shell：执行cat /etc/passwd | grep $(whoami)，检查末字段是否为/bin/bash，否则用chsh -s /bin/bash切换。
三、校验并修复脚本POSIX兼容性
若需在严格POSIX环境（如嵌入式设备、部分Linux容器）中运行，应移除bash独占语法，改用通用sh语法，确保脚本在任何POSIX-compliant Shell下均可执行。
1、使用bash -n workbuddy-install.sh进行静态语法检查，定位未闭合引号、括号或关键字缺失位置。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、将所有[[ ]]条件判断替换为[ ]，例如if [[ $var == "ok" ]]改为if [ "$var" = "ok" ]，注意=在[ ]中为标准字符串比较符。
3、删除脚本中bash数组（arr=(a b c)）、关联数组（declare -A map）、source的扩展参数（如source file.sh 2>/dev/null）等非POSIX特性。
4、使用shellcheck workbuddy-install.sh工具扫描全部潜在兼容性问题，并依据提示逐项修正。
四、检查脚本换行符格式与编码一致性
脚本在Windows编辑器中保存后可能携带CRLF（\r\n）换行符，导致sh解释器将\r视为命令字符，引发“command not found”或“invalid option”类错误，尤其在shebang行末尾出现\r时会直接失效。
1、执行file workbuddy-install.sh，若输出含CRLF line terminators，即确认存在Windows换行符。
2、运行dos2unix workbuddy-install.sh转换为LF格式（如未安装dos2unix，可用sed -i 's/\r$//' workbuddy-install.sh替代）。
3、用hexdump -C workbuddy-install.sh | head -5检查前几行十六进制，确认0a（LF）存在且无0d 0a（CRLF）序列。
4、重新设置可执行权限：chmod +x workbuddy-install.sh，再尝试执行。
五、验证系统bash版本是否满足WorkBuddy最低要求
WorkBuddy安装脚本可能依赖bash 4.0+版本特性（如mapfile、declare -g全局变量），低版本bash（如CentOS 6默认bash 3.2）将无法解析部分语法结构。
1、执行/bin/bash --version获取当前bash主版本号。
2、确认输出版本≥ 4.0；若低于该版本，需升级bash或使用更高版本解释器路径（如/usr/local/bin/bash）。
3、若系统无root权限，可下载bash源码编译至用户目录：./configure --prefix=$HOME/local && make && make install，随后用$HOME/local/bin/bash ./workbuddy-install.sh运行。
4、验证新版bash功能：执行$HOME/local/bin/bash -c 'mapfile -t arr ，输出<code>b即表示mapfile可用。
