在Windows系统上部署Kouchou-AI（广听AI）的完整指南

Kouchou-AI（广听AI）是一款基于人工智能的公众意见收集与分析工具，本文将详细介绍如何在Windows操作系统上完成该项目的部署与配置。

环境准备

在开始部署前，请确保您的系统满足以下要求：

1. 操作系统：Windows 10或11（64位版本）
2. 硬件配置：
   • 至少8GB内存（推荐16GB）
   • 20GB可用磁盘空间
   • 支持虚拟化的CPU
3. 网络环境：稳定的互联网连接
4. OpenAI API密钥：需提前申请并准备

详细部署步骤

第一步：安装Docker环境

1. 获取Docker Desktop：

   • 访问Docker官网下载Windows版安装包
   • 选择稳定版本进行下载

2. 安装注意事项：

   • 安装过程中勾选"Use WSL 2 instead of Hyper-V"选项（如可用）
   • 完成安装后必须重启系统

3. 验证安装：

   • 打开命令提示符，输入docker --version检查版本信息
   • 运行docker run hello-world测试基本功能

第二步：获取Kouchou-AI项目文件

1. 下载项目包：

   • 获取最新稳定版本的项目压缩包
   • 建议解压到不含中文和特殊字符的路径中

2. 目录结构说明：

   • setup_win.bat：初始化脚本
   • start_win.bat：启动脚本
   • stop_win.bat：停止脚本
   • docker-compose.yml：容器编排配置文件

第三步：配置OpenAI API密钥

1. 密钥获取指南：

   • 登录OpenAI平台创建API密钥
   • 建议设置使用限额以防止意外消耗

2. 密钥安全注意事项：

   • 不要将密钥直接保存在脚本文件中
   • 避免在公共场合展示您的API密钥

第四步：初始化项目

1. 运行初始化脚本：

   • 双击setup_win.bat启动配置过程
   • 按提示输入有效的OpenAI API密钥

2. 初始化过程解析：

   • 脚本会自动创建必要的环境变量文件(.env)
   • 下载并构建所需的Docker镜像
   • 启动相关服务容器

第五步：访问应用界面

1. 前端界面：

   • 访问地址：http://localhost:3000
   • 功能：查看分析报告和可视化数据

2. 管理后台：

   • 访问地址：http://localhost:4000
   • 功能：系统配置和数据管理

日常使用操作

启动与停止服务

1. 标准启动流程：

   • 确保Docker Desktop正在运行
   • 执行start_win.bat脚本
   • 等待所有容器状态变为"healthy"

2. 服务停止方法：

   • 执行stop_win.bat脚本
   • 或通过Docker Desktop界面手动停止容器

API密钥更新

如需更换API密钥，请按照以下步骤操作：

1. 停止当前运行的服务
2. 重新运行setup_win.bat
3. 输入新的API密钥
4. 系统会自动重建环境

常见问题排查

Docker相关问题

1. 启动失败：

   • 检查Docker服务是否正常运行
   • 验证系统虚拟化功能是否启用

2. 资源不足：

   • 在Docker设置中调整资源分配
   • 增加内存和CPU配额

网络连接问题

1. API连接失败：

   • 检查本地网络是否正常
   • 验证OpenAI API服务状态

2. 端口冲突：

   • 确认3000和4000端口未被占用
   • 如需修改端口，可编辑docker-compose.yml文件

性能优化建议

1. 资源配置：

   • 为Docker分配至少4GB内存
   • 预留足够的CPU资源

2. 数据管理：

   • 定期清理不需要的分析结果
   • 对重要数据进行备份

3. 更新策略：

   • 定期检查项目更新
   • 获取最新功能和安全补丁

通过以上步骤，您应该已经成功在Windows系统上部署了Kouchou-AI系统。该系统可以帮助您高效地收集和分析公众意见，为决策提供数据支持。如果在使用过程中遇到任何技术问题，建议查阅详细的日志文件以获取更多诊断信息。