若workbuddy启动提示端口被占用，需先从日志确认端口号（如8080），再用lsof -i :8080查pid，kill -9 pid释放端口；若不可终止，则修改配置换用备用端口（如8081）并重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试部署WorkBuddy服务，但启动时提示端口被占用，则可能是该端口已被其他进程占用。以下是使用lsof命令定位并释放冲突端口的具体操作步骤：
一、确认被占用的端口号
WorkBuddy默认可能使用如8080、3000或8000等常见端口，错误信息中通常会明确指出具体端口号。请先从日志中提取出被占用的端口号，例如8080，该数字是后续所有操作的关键输入。
二、使用lsof查找占用端口的进程
lsof命令可列出当前系统中打开的文件及网络连接，通过指定端口可精准定位占用进程。需确保当前用户具有足够权限执行该命令，否则可能无法显示全部结果。
1、在终端中输入命令：lsof -i :8080（将8080替换为实际冲突端口号）。
2、观察输出结果中的PID列，记录第一行非标题行的进程ID（例如显示为12345）。
3、若提示command not found，请先安装lsof：运行sudo apt install lsof（Ubuntu/Debian）或sudo yum install lsof（CentOS/RHEL）。
三、终止占用端口的进程
获取PID后，可通过kill命令强制结束对应进程，从而释放端口。此操作不可逆，需确认该进程非关键系统服务。
1、执行终止命令：kill -9 12345（将12345替换为上一步查得的实际PID）。
2、再次运行lsof -i :8080验证是否无输出，若无任何返回即表示端口已释放。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
3、如遇权限拒绝提示，请在命令前添加sudo，即sudo kill -9 12345。
四、改用备用端口重新部署
若无法终止占用进程（如其属于系统守护进程），可调整WorkBuddy配置以使用其他未被占用的端口，避免直接冲突。
1、编辑WorkBuddy的配置文件（如.env或config.yml），将端口字段修改为8081等未使用端口。
2、保存文件后，重启WorkBuddy服务：npm start或yarn start（依项目实际启动方式而定）。
3、通过浏览器访问http://localhost:8081确认服务正常响应。
五、批量检查多个常用端口占用状态
当不确定具体冲突端口，或需排查一组预设端口（如3000–3010）时，可使用循环结合lsof进行快速扫描。
1、在终端中执行以下命令：for port in {3000..3010}; do echo "Port $port:"; lsof -ti:$port 2>/dev/null && echo " occupied"; done。
2、观察输出中带有“occupied”标记的端口，即为当前被占用端口。
3、对其中任一被占端口，重复步骤二和步骤三完成释放。
