docs: 创建专业的项目 README 文档

详细说明:
- 添加完整的项目介绍和架构说明
- 包含 7 个 AI Agent 的详细介绍
- 添加技术栈和 Mermaid 架构图
- 完善安装和使用指南
- 添加开发指南和 Git 工作流
- 新增 Windows 快速部署文档
- 更新前端组件和启动脚本
- 添加多种环境配置文件

修改的文件:
- 新增 README.md 主文档
- 新增 doc/ 目录及部署文档
- 更新前端演示系统组件
- 添加多个启动脚本变体
- 配置文件优化

影响的功能模块:
- 项目文档体系
- 部署和启动流程
- 前端展示系统
- 环境配置管理
This commit is contained in:
Yep_Q
2025-09-14 18:53:27 +08:00
parent 750af2692a
commit 2fcaf21842
154 changed files with 113964 additions and 36 deletions

View File

@@ -99,16 +99,44 @@ stop_existing() {
setup_environment() {
print_info "正在设置环境变量..."
# 获取局域网IP地址
local lan_ip=""
if [[ "$OSTYPE" == "darwin"* ]]; then
# macOS
lan_ip=$(ifconfig | grep "inet " | grep -v 127.0.0.1 | head -1 | awk '{print $2}')
else
# Linux
lan_ip=$(hostname -I | awk '{print $1}')
fi
export N8N_DEFAULT_LOCALE=zh-CN
export N8N_SECURE_COOKIE=false
export DB_SQLITE_POOL_SIZE=5
export N8N_RUNNERS_ENABLED=true
export N8N_BLOCK_ENV_ACCESS_IN_NODE=false
export N8N_HOST=0.0.0.0
export N8N_PORT=5678
# 设置Webhook URL和Editor URL以支持局域网访问
if [ -n "$lan_ip" ]; then
export N8N_EDITOR_BASE_URL="http://${lan_ip}:5678"
export WEBHOOK_URL="http://${lan_ip}:5678"
export N8N_PROTOCOL=http
fi
# Session和Cookie配置
export N8N_SESSION_COOKIE_SAME_SITE=none
export N8N_SESSION_COOKIE_SECURE=false
print_success "环境变量已设置"
echo " - N8N_DEFAULT_LOCALE=zh-CN"
echo " - N8N_SECURE_COOKIE=false"
echo " - DB_SQLITE_POOL_SIZE=5"
echo " - N8N_HOST=0.0.0.0 (监听所有网络接口)"
echo " - N8N_PORT=5678"
if [ -n "$lan_ip" ]; then
echo " - N8N_EDITOR_BASE_URL=http://${lan_ip}:5678"
fi
echo " - Session配置已优化以支持局域网访问"
}
# 检查构建状态
@@ -166,9 +194,25 @@ start_n8n() {
# 检查是否启动成功
if curl -s http://localhost:5678 >/dev/null 2>&1; then
print_success "n8n 启动成功!"
# 获取局域网IP地址
local lan_ip=""
if [[ "$OSTYPE" == "darwin"* ]]; then
# macOS
lan_ip=$(ifconfig | grep "inet " | grep -v 127.0.0.1 | head -1 | awk '{print $2}')
else
# Linux
lan_ip=$(hostname -I | awk '{print $1}')
fi
echo
echo -e "${GREEN}========== 启动信息 ==========${NC}"
echo -e "📱 访问地址: ${BLUE}http://localhost:5678${NC}"
echo -e "📱 本地访问: ${BLUE}http://localhost:5678${NC}"
if [ -n "$lan_ip" ]; then
echo -e "🌐 局域网访问: ${BLUE}http://${lan_ip}:5678${NC}"
echo -e "📌 提示: 局域网访问请使用 ${BLUE}http://${lan_ip}:5678${NC} 完整地址"
echo -e " 避免使用 localhost 或 127.0.0.1"
fi
echo -e "🌏 界面语言: ${GREEN}中文 (zh-CN)${NC}"
echo -e "📋 进程 PID: ${YELLOW}$N8N_PID${NC}"
echo -e "📝 日志文件: ${YELLOW}$log_file${NC}"
@@ -176,6 +220,14 @@ start_n8n() {
echo
print_info "使用 Ctrl+C 停止服务"
if [ -n "$lan_ip" ]; then
echo
print_warning "局域网访问注意事项:"
echo " 1. 确保防火墙允许 5678 端口"
echo " 2. 首次访问需要创建账户"
echo " 3. 使用同一个IP地址保持登录状态"
fi
# 保持脚本运行并显示日志
trap 'print_info "正在停止 n8n..."; kill $N8N_PID 2>/dev/null; exit 0' INT
tail -f "$log_file"