🆕 BettaFish 一键部署工具包 v2.0 - 使用指南

Categories: Tech 2025-11-16

工具作者: LION CC（codecodex.ai）

工具版本: v2.1.0 支持平台: Windows / macOS / Linux 部署时间: 5-10 分钟

📑 目录

• ✨ v2.0 新特性
• 📦 获取工具包
• 🔑 准备 API 密钥
• 🪟 Windows 使用
• 🍎 macOS 使用
• 🐧 Linux 使用
• 📋 工具包内容
• 🎯 部署成功后
• ❓ 常见问题
• 🔗 相关资源

✨ v2.0 新特性

• ✅ 一键部署 - 双击运行，自动完成所有配置
• ✅ 智能修复 - Windows fix-all 工具自动诊断 9 大类问题
• ✅ 跨平台菜单 - 统一的交互式菜单体验
• ✅ 零技术门槛 - 无需手动编辑配置文件

📦 获取工具包

GitHub 下载

git clone https://github.com/Jascenn/deployment-scripts-hub.git
cd deployment-scripts-hub/bettafish

通过社群获取

🎁 福利: 扫描下方二维码加入 codecodex.ai 社群，获取工具包 + 技术支持 + VibeCoding API 优惠

微信扫码添加技术助手，备注：BettaFish工具包

🔑 准备 API 密钥

部署前需要准备 AI API 密钥：

推荐：VibeCoding API

• 官网: https://vibecodingapi.ai
• 格式: sk-xxxxxxxxxxxxx
• 🎁 通过社群注册可获优惠

其他选择：OpenAI、Claude、Gemini 等兼容 API

可选 API（增强搜索功能）：

• Tavily API: https://tavily.com
• Bocha API: https://bocha.ai

🪟 Windows 使用

快速开始

1. 进入 deployment-scripts-hub/bettafish/Windows 文件夹
2. 双击 menu.bat
3. 输入 1 选择部署
4. 按提示输入 API 密钥
5. 等待完成（约 5-10 分钟）

菜单选项

1) 部署/更新 BettaFish   - 首次使用选这个
2) 系统诊断             - 查看系统状态
3) 智能修复 (fix-all)   - 出问题时用这个
4) 启动服务
5) 停止服务
6) 查看日志

快捷方式

• 快速部署: 双击 deploy.bat
• 智能修复: 双击 fix-all.bat（自动修复 9 类常见问题）

🍎 macOS 使用

快速开始

# 1. 进入目录
cd deployment-scripts-hub/bettafish/Linux_macOS

# 2. 启动菜单
./menu.sh

# 3. 选择 1 进行部署
# 4. 按提示输入 API 密钥

直接部署

./docker-deploy.sh

🐧 Linux 使用

快速开始

# 1. 进入目录
cd deployment-scripts-hub/bettafish/Linux_macOS

# 2. 启动菜单
./menu.sh

# 或直接部署
./docker-deploy.sh

📋 工具包内容

Windows 工具

• menu.bat - 交互式菜单
• deploy.bat - 快速部署
• fix-all.bat - 智能修复（9类诊断）
• docker-deploy.bat - 完整部署流程

macOS/Linux 工具

• menu.sh - 交互式菜单
• docker-deploy.sh - 一键部署
• diagnose.sh - 系统诊断
• docker-cleanup.sh - Docker 清理

🎯 部署成功后

1. 浏览器访问: http://localhost:5001
2. 首次使用需配置 AI 模型（已自动填入 API）
3. 开始对话，体验 AI 助手功能

提示: 支持多种 AI 模型切换，可在界面中随时更换

❓ 常见问题

Q1: 需要什么前置条件？

A:

• Docker Desktop（Windows/macOS）或 Docker Engine（Linux）
• API 密钥（VibeCoding 或其他）

Q2: Windows 脚本显示乱码怎么办？

A: 双击 fix-all.bat 自动修复

Q3: Docker 未启动怎么办？

A:

• Windows/macOS: 启动 Docker Desktop 或运行 fix-all.bat
• Linux: sudo systemctl start docker

Q4: 部署后如何访问？

A: 浏览器打开 http://localhost:5001

Q5: 如何更新？

A: 重新运行部署脚本（会保留配置）

Q6: 与 LionCC API 配置指南 有什么区别？

A:

• 配置指南（11-07）: 手动配置，适合技术用户
• 工具包（本文）: 自动化部署，适合所有用户

🔗 相关资源

• BettaFish 项目: https://github.com/666ghj/BettaFish
• 部署工具包: https://github.com/Jascenn/deployment-scripts-hub
• VibeCoding API: https://vibecodingapi.ai
• 配置详解: 部署工具包详细文档

🎉 开始使用

Windows: 双击 menu.bat macOS/Linux: 运行 ./menu.sh

有问题？扫描上方二维码加入技术社群获取支持

更新日志:

• 2025-11-16: v2.1.0 发布
  • 支持 Windows/macOS/Linux
  • 新增 fix-all 智能修复工具
  • 新增交互式菜单系统
  • 完全自动化部署流程