collabdocchat 1.2.7 → 1.2.9

package/README.md

@@ -226,6 +226,20 @@ npm run serve
 
 ## 📝 更新日志
 
+### v1.2.8 (2026-01-26) - 当前版本
+- 🔧 修复 devDependencies 安装问题
+- ✨ 自动检测并安装缺失的依赖
+- 🛡️ 添加端口占用检测
+- 📚 优化 postinstall 脚本，不再自动启动服务
+- 💡 改进错误提示和用户引导
+
+### v1.2.7 (2026-01-26)
+- 📚 添加详细的 INSTALLATION.md 安装指南
+- 📝 添加 CONTRIBUTING.md 贡献指南
+
+### v1.2.6 (2026-01-26)
+- 📝 更新版本日志
+
 ### v1.2.5 (2026-01-26)
 - 🔧 修复 Windows 下 CLI 启动问题
 - 📚 优化安装和使用说明

package/USAGE.md

@@ -0,0 +1,296 @@
+# 使用说明
+
+## 🚀 推荐的安装和使用流程
+
+### 步骤 1: 安装包
+
+```bash
+# 在您想要的目录下安装
+npm install collabdocchat
+```
+
+### 步骤 2: 进入目录
+
+```bash
+cd node_modules/collabdocchat
+```
+
+### 步骤 3: 启动应用
+
+```bash
+npm start
+```
+
+**首次启动时**，系统会自动：
+- 检测并安装缺失的依赖
+- 检查端口是否可用
+- 启动服务器和客户端
+- 自动打开浏览器
+
+## ⚠️ 常见问题解决
+
+### 问题 1: 端口被占用
+
+如果看到错误：`Error: listen EADDRINUSE: address already in use :::3000`
+
+**解决方案：**
+
+#### Windows:
+```cmd
+# 查找占用端口的进程
+netstat -ano | findstr :3000
+
+# 结束进程（替换 <PID> 为实际的进程ID）
+taskkill /PID <PID> /F
+```
+
+#### Mac/Linux:
+```bash
+# 查找并结束进程
+lsof -ti:3000 | xargs kill -9
+```
+
+或者使用项目提供的停止脚本：
+```bash
+npm run stop
+```
+
+### 问题 2: vite 命令找不到
+
+如果看到错误：`'vite' 不是内部或外部命令`
+
+**原因：** 开发依赖未安装
+
+**解决方案：**
+```bash
+# 在 collabdocchat 目录下运行
+npm install
+```
+
+v1.2.8 及以上版本会在启动时自动检测并安装缺失的依赖。
+
+### 问题 3: MongoDB 连接失败
+
+如果看到错误：`MongoNetworkError: connect ECONNREFUSED`
+
+**解决方案：**
+
+1. **确保 MongoDB 已安装**
+   - 下载地址: https://www.mongodb.com/try/download/community
+
+2. **启动 MongoDB 服务**
+
+   **Windows:**
+   ```cmd
+   net start MongoDB
+   ```
+
+   **Mac:**
+   ```bash
+   brew services start mongodb-community
+   ```
+
+   **Linux:**
+   ```bash
+   sudo systemctl start mongod
+   ```
+
+3. **验证 MongoDB 运行**
+   ```bash
+   # 连接到 MongoDB
+   mongosh
+   # 或旧版本
+   mongo
+   ```
+
+## 📋 完整的使用流程示例
+
+### Windows 用户
+
+```cmd
+# 1. 创建项目目录
+mkdir my-collab-app
+cd my-collab-app
+
+# 2. 安装包
+npm install collabdocchat
+
+# 3. 进入目录
+cd node_modules\collabdocchat
+
+# 4. 确保 MongoDB 运行
+net start MongoDB
+
+# 5. 启动应用
+npm start
+```
+
+### Mac/Linux 用户
+
+```bash
+# 1. 创建项目目录
+mkdir my-collab-app
+cd my-collab-app
+
+# 2. 安装包
+npm install collabdocchat
+
+# 3. 进入目录
+cd node_modules/collabdocchat
+
+# 4. 确保 MongoDB 运行
+brew services start mongodb-community  # Mac
+# 或
+sudo systemctl start mongod  # Linux
+
+# 5. 启动应用
+npm start
+```
+
+## 🎯 访问应用
+
+启动成功后，浏览器会自动打开：
+
+- **客户端界面**: http://localhost:5173
+- **服务器 API**: http://localhost:3000
+
+### 默认管理员账号
+
+- **用户名**: `admin`
+- **密码**: `admin123`
+
+⚠️ **重要**: 首次登录后请立即修改密码！
+
+## 🛑 停止应用
+
+### 方法 1: 使用快捷键
+在运行应用的终端窗口按 `Ctrl + C`
+
+### 方法 2: 使用停止脚本
+```bash
+npm run stop
+```
+
+### 方法 3: 手动结束进程
+
+**Windows:**
+```cmd
+taskkill /F /IM node.exe
+```
+
+**Mac/Linux:**
+```bash
+pkill -f node
+```
+
+## 🔧 配置说明
+
+### 修改端口
+
+编辑 `.env` 文件：
+
+```env
+# 修改服务器端口
+PORT=3000
+
+# MongoDB 连接
+MONGODB_URI=mongodb://localhost:27017/collabdocchat
+
+# JWT 密钥（生产环境务必修改）
+JWT_SECRET=your-secret-key-here
+```
+
+### 修改管理员账号
+
+编辑 `.env` 文件：
+
+```env
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=your-secure-password
+ADMIN_EMAIL=admin@yourdomain.com
+```
+
+删除数据库后重新启动，将使用新的管理员信息。
+
+## 📊 开发模式
+
+如果您想进行开发或调试：
+
+```bash
+# 开发模式（支持热重载）
+npm run dev
+```
+
+特点：
+- 服务器自动重启（nodemon）
+- 前端热重载（Vite HMR）
+- 自动打开浏览器
+
+## 🔍 检查安装
+
+### 验证 Node.js
+```bash
+node --version
+# 应该 >= 16.0.0
+```
+
+### 验证 npm
+```bash
+npm --version
+# 应该 >= 7.0.0
+```
+
+### 验证 MongoDB
+```bash
+mongod --version
+# 应该 >= 4.4
+```
+
+## 📞 获取帮助
+
+如果遇到其他问题：
+
+1. 查看 [INSTALLATION.md](./INSTALLATION.md) - 详细安装指南
+2. 查看 [README.md](./README.md) - 完整文档
+3. 访问 [GitHub Issues](https://github.com/shijinghao/collabdocchat/issues)
+4. 提交新的 Issue 描述您的问题
+
+## 💡 最佳实践
+
+1. **定期更新**
+   ```bash
+   npm update collabdocchat
+   ```
+
+2. **备份数据**
+   ```bash
+   mongodump --db collabdocchat --out ./backup
+   ```
+
+3. **使用 PM2 管理进程**（生产环境）
+   ```bash
+   npm install -g pm2
+   pm2 start server/index.js --name collabdocchat
+   pm2 startup
+   pm2 save
+   ```
+
+4. **配置反向代理**（生产环境）
+   使用 Nginx 或 Apache 作为反向代理
+
+5. **启用 HTTPS**（生产环境）
+   使用 Let's Encrypt 获取免费 SSL 证书
+
+## 🎉 开始使用
+
+现在您可以：
+
+- ✅ 创建新文档
+- ✅ 邀请团队成员
+- ✅ 实时协作编辑
+- ✅ 使用聊天功能
+- ✅ 管理任务
+- ✅ 上传文件
+
+祝您使用愉快！🚀
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "collabdocchat",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "开源的实时协作文档聊天平台 - 集成任务管理、多人文档编辑、智能点名功能",
   "main": "./server/index.js",
   "type": "module",
@@ -22,7 +22,8 @@
     "install-and-start.sh",
     "QUICK_START.md",
     "INSTALLATION.md",
-    "CONTRIBUTING.md"
+    "CONTRIBUTING.md",
+    "USAGE.md"
   ],
   "keywords": [
     "collaboration",

package/scripts/postinstall.js

@@ -1,186 +1,57 @@
-import { spawn } from 'child_process';
-import { platform } from 'os';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
-import { writeFileSync, existsSync, readFileSync } from 'fs';
+import { writeFileSync, existsSync } from 'fs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const rootDir = join(__dirname, '..');
 
-const PORT = process.env.PORT || 3000;
-const CLIENT_PORT = 5173;
-const CLIENT_URL = `http://localhost:${CLIENT_PORT}`;
-const pidFile = join(rootDir, '.collabdocchat.pid');
-const isWindows = platform() === 'win32';
-
-// 保存 PID 到文件
-function savePid(pid) {
-  try {
-    let pids = [];
-    if (existsSync(pidFile)) {
-      const content = readFileSync(pidFile, 'utf-8');
-      pids = content.trim().split('\n').filter(Boolean);
-    }
-    if (!pids.includes(pid.toString())) {
-      pids.push(pid.toString());
-      writeFileSync(pidFile, pids.join('\n') + '\n');
-    }
-  } catch (error) {
-    // 忽略错误
-  }
-}
-
-// 打开浏览器的函数
-function openBrowser(url) {
-  const platformName = platform();
-  let command;
-  let args;
-
-  switch (platformName) {
-    case 'win32':
-      command = 'cmd';
-      args = ['/c', 'start', url];
-      break;
-    case 'darwin':
-      command = 'open';
-      args = [url];
-      break;
-    default:
-      command = 'xdg-open';
-      args = [url];
-  }
-
-  const browser = spawn(command, args, { stdio: 'ignore', detached: true });
-  browser.unref();
-}
-
-// 检查服务器是否就绪
-function waitForServer(url, maxAttempts = 30, delay = 1000) {
-  return new Promise((resolve, reject) => {
-    let attempts = 0;
-    const urlObj = new URL(url);
-    
-    const check = () => {
-      attempts++;
-      
-      const req = http.get({
-        hostname: urlObj.hostname,
-        port: urlObj.port,
-        path: urlObj.pathname,
-        timeout: 1000
-      }, (res) => {
-        if (res.statusCode === 200) {
-          resolve();
-          return;
-        }
-        if (attempts < maxAttempts) {
-          setTimeout(check, delay);
-        } else {
-          reject(new Error('服务器启动超时'));
-        }
-      });
-
-      req.on('error', () => {
-        if (attempts < maxAttempts) {
-          setTimeout(check, delay);
-        } else {
-          reject(new Error('服务器启动超时'));
-        }
-      });
-
-      req.on('timeout', () => {
-        req.destroy();
-        if (attempts < maxAttempts) {
-          setTimeout(check, delay);
-        } else {
-          reject(new Error('服务器启动超时'));
-        }
-      });
-    };
-
-    check();
-  });
-}
-
-// 启动服务器
-function startServer() {
-  console.log('\n🚀 正在启动 CollabDocChat 服务器...');
-  const server = spawn('node', ['server/index.js'], {
-    cwd: rootDir,
-    stdio: 'inherit',
-    detached: true,
-    windowsHide: true
-  });
-
-  // 保存服务器进程 PID
-  if (server.pid) {
-    savePid(server.pid);
-  }
-
-  server.unref();
-  return server;
-}
-
-// 启动客户端
-function startClient() {
-  console.log('🎨 正在启动客户端...');
-  const client = spawn(isWindows ? 'npm.cmd' : 'npm', ['run', 'client'], {
-    cwd: rootDir,
-    stdio: 'inherit',
-    detached: true,
-    windowsHide: true
-  });
-
-  // 保存客户端进程 PID（注意：npm 会启动子进程，这里保存的是 npm 进程的 PID）
-  if (client.pid) {
-    savePid(client.pid);
-  }
-
-  client.unref();
-  return client;
-}
-
-// 主函数 - 完全异步，不阻塞
-function main() {
-  console.log('\n📦 CollabDocChat 安装完成！');
-  console.log('🚀 正在后台启动应用...\n');
-
-  // 立即启动服务器（不等待）
-  try {
-    const server = startServer();
-  } catch (error) {
-    // 静默处理
-  }
+// 创建默认 .env 文件
+function createEnvFile() {
+  const envPath = join(rootDir, '.env');
   
-  // 立即启动客户端（不等待）
-  try {
-    const client = startClient();
-  } catch (error) {
-    // 静默处理
-  }
-
-  // 延迟打开浏览器，给服务器启动时间
-  setTimeout(() => {
+  if (!existsSync(envPath)) {
+    const envContent = `# 服务器配置
+PORT=3000
+NODE_ENV=development
+
+# MongoDB 配置
+MONGODB_URI=mongodb://localhost:27017/collabdocchat
+
+# JWT 配置
+JWT_SECRET=your-secret-key-change-this-in-production-${Date.now()}
+JWT_EXPIRES_IN=7d
+
+# 管理员账号（首次启动时创建）
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=admin123
+ADMIN_EMAIL=admin@example.com
+`;
+    
     try {
-      console.log(`\n🌐 正在打开浏览器: ${CLIENT_URL}`);
-      openBrowser(CLIENT_URL);
-      console.log('\n✅ 应用正在启动中，浏览器已打开。');
-      console.log('   如果页面未加载，请稍等片刻后刷新页面。');
-      console.log('\n💡 提示：服务器和客户端正在后台运行');
-      console.log('   要停止服务，运行: cd node_modules/collabdocchat && npm run stop');
+      writeFileSync(envPath, envContent);
+      console.log('✅ 已创建默认配置文件 .env');
     } catch (error) {
-      // 静默处理
+      console.log('⚠️  无法创建 .env 文件，请手动创建');
     }
-  }, 8000);
+  }
 }
 
-// 立即执行
-main();
-
-// 延迟退出，给输出时间显示
-// 但不会阻塞太久
-setTimeout(() => {
-  process.exit(0);
-}, 2000);
-
+console.log('\n🎉 CollabDocChat 安装成功！\n');
+console.log('📦 开源的实时协作文档聊天平台\n');
+
+// 创建配置文件
+createEnvFile();
+
+console.log('\n📖 快速开始：\n');
+console.log('   1. 确保 MongoDB 已安装并运行');
+console.log('   2. 安装开发依赖: npm install');
+console.log('   3. 启动应用: npm start');
+console.log('\n💡 更多信息：');
+console.log('   • 查看 README.md 了解详细说明');
+console.log('   • 查看 INSTALLATION.md 了解安装指南');
+console.log('   • 默认管理员账号: admin / admin123');
+console.log('\n🔗 文档链接：');
+console.log('   • GitHub: https://github.com/shijinghao/collabdocchat');
+console.log('   • npm: https://www.npmjs.com/package/collabdocchat');
+console.log('\n');

package/scripts/start-app.js

@@ -1,8 +1,9 @@
-import { spawn } from 'child_process';
+import { spawn, exec } from 'child_process';
 import { platform } from 'os';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import http from 'http';
+import { existsSync } from 'fs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -11,29 +12,92 @@ const rootDir = join(__dirname, '..');
 const PORT = process.env.PORT || 3000;
 const CLIENT_PORT = 5173;
 const CLIENT_URL = `http://localhost:${CLIENT_PORT}`;
+const isWindows = platform() === 'win32';
+
+// 检查 devDependencies 是否已安装
+function checkDevDependencies() {
+  const vitePath = join(rootDir, 'node_modules', 'vite');
+  return existsSync(vitePath);
+}
+
+// 安装 devDependencies
+function installDevDependencies() {
+  return new Promise((resolve, reject) => {
+    console.log('📦 正在安装开发依赖...\n');
+    
+    const npmCmd = isWindows ? 'npm.cmd' : 'npm';
+    const install = spawn(npmCmd, ['install'], {
+      cwd: rootDir,
+      stdio: 'inherit',
+      shell: true
+    });
+
+    install.on('close', (code) => {
+      if (code === 0) {
+        console.log('\n✅ 依赖安装完成\n');
+        resolve();
+      } else {
+        reject(new Error(`依赖安装失败，退出码: ${code}`));
+      }
+    });
+
+    install.on('error', (error) => {
+      reject(error);
+    });
+  });
+}
+
+// 检查端口是否被占用
+function checkPort(port) {
+  return new Promise((resolve) => {
+    const server = http.createServer();
+    
+    server.once('error', (err) => {
+      if (err.code === 'EADDRINUSE') {
+        resolve(false); // 端口被占用
+      } else {
+        resolve(true);
+      }
+    });
+
+    server.once('listening', () => {
+      server.close();
+      resolve(true); // 端口可用
+    });
+
+    server.listen(port);
+  });
+}
 
 // 打开浏览器的函数
 function openBrowser(url) {
-  const platformName = platform();
-  let command;
-  let args;
-
-  switch (platformName) {
-    case 'win32':
-      command = 'cmd';
-      args = ['/c', 'start', url];
-      break;
-    case 'darwin':
-      command = 'open';
-      args = [url];
-      break;
-    default:
-      command = 'xdg-open';
-      args = [url];
-  }
+  try {
+    const platformName = platform();
+    let command, args;
+
+    switch (platformName) {
+      case 'win32':
+        command = 'cmd';
+        args = ['/c', 'start', '""', url];
+        break;
+      case 'darwin':
+        command = 'open';
+        args = [url];
+        break;
+      default:
+        command = 'xdg-open';
+        args = [url];
+    }
 
-  const browser = spawn(command, args, { stdio: 'ignore', detached: true });
-  browser.unref();
+    const browser = spawn(command, args, { 
+      stdio: 'ignore', 
+      detached: true,
+      shell: true 
+    });
+    browser.unref();
+  } catch (error) {
+    console.log(`⚠️  无法自动打开浏览器，请手动访问: ${url}`);
+  }
 }
 
 // 检查服务器是否就绪
@@ -48,23 +112,13 @@ function waitForServer(url, maxAttempts = 30, delay = 1000) {
       const req = http.get({
         hostname: urlObj.hostname,
         port: urlObj.port,
-        path: urlObj.pathname,
+        path: '/',
         timeout: 1000
       }, (res) => {
-        if (res.statusCode === 200) {
-          resolve();
-          return;
-        }
-        // 继续等待
-        if (attempts < maxAttempts) {
-          setTimeout(check, delay);
-        } else {
-          reject(new Error('服务器启动超时'));
-        }
+        resolve();
       });
 
       req.on('error', () => {
-        // 服务器未就绪，继续等待
         if (attempts < maxAttempts) {
           setTimeout(check, delay);
         } else {
@@ -98,10 +152,11 @@ function startServer() {
   return server;
 }
 
-// 启动客户端（如果使用 Vite）
+// 启动客户端
 function startClient() {
-  console.log('🎨 正在启动客户端...');
-  const client = spawn('npm', ['run', 'client'], {
+  console.log('🎨 正在启动客户端...\n');
+  const npmCmd = isWindows ? 'npm.cmd' : 'npm';
+  const client = spawn(npmCmd, ['run', 'client'], {
     cwd: rootDir,
     stdio: 'inherit',
     shell: true
@@ -114,12 +169,36 @@ function startClient() {
 async function main() {
   console.log('📦 CollabDocChat 正在启动...\n');
 
+  // 检查端口
+  const portAvailable = await checkPort(PORT);
+  if (!portAvailable) {
+    console.error(`❌ 错误：端口 ${PORT} 已被占用`);
+    console.error('\n💡 解决方案：');
+    console.error('   1. 停止占用端口的进程: npm run stop');
+    console.error('   2. 或修改 .env 文件中的 PORT 配置');
+    console.error('   3. Windows: netstat -ano | findstr :3000');
+    console.error('      然后: taskkill /PID <进程ID> /F\n');
+    process.exit(1);
+  }
+
+  // 检查并安装 devDependencies
+  if (!checkDevDependencies()) {
+    console.log('⚠️  检测到缺少开发依赖\n');
+    try {
+      await installDevDependencies();
+    } catch (error) {
+      console.error('❌ 依赖安装失败:', error.message);
+      console.error('\n💡 请手动运行: npm install\n');
+      process.exit(1);
+    }
+  }
+
   // 启动服务器
   const server = startServer();
 
   // 等待服务器就绪
   try {
-    await waitForServer(`http://localhost:${PORT}/health`, 30, 1000);
+    await waitForServer(`http://localhost:${PORT}`, 30, 1000);
     console.log(`✅ 服务器已就绪: http://localhost:${PORT}\n`);
   } catch (error) {
     console.error('❌ 服务器启动失败:', error.message);
@@ -135,12 +214,17 @@ async function main() {
       await waitForServer(CLIENT_URL, 20, 500);
       console.log(`\n🌐 正在打开浏览器: ${CLIENT_URL}`);
       openBrowser(CLIENT_URL);
+      console.log('\n✅ 应用启动成功！');
+      console.log('\n💡 提示：');
+      console.log('   • 服务器: http://localhost:3000');
+      console.log('   • 客户端: http://localhost:5173');
+      console.log('   • 默认账号: admin / admin123');
+      console.log('\n⚠️  按 Ctrl+C 停止服务\n');
     } catch (error) {
       console.log(`\n⚠️  客户端可能还在启动中，请手动访问: ${CLIENT_URL}`);
-      // 即使检查失败也尝试打开浏览器
       openBrowser(CLIENT_URL);
     }
-  }, 2000);
+  }, 3000);
 
   // 处理退出信号
   process.on('SIGINT', () => {
@@ -161,4 +245,3 @@ main().catch(error => {
   console.error('❌ 启动失败:', error);
   process.exit(1);
 });
-

package/INSTALLATION.md

@@ -1,345 +0,0 @@
-# CollabDocChat 安装指南
-
-## 📦 安装方式
-
-### 方式一：本地安装（推荐）
-
-这是最简单且最可靠的安装方式：
-
-```bash
-# 1. 创建项目目录
-mkdir my-collab-project
-cd my-collab-project
-
-# 2. 初始化 npm 项目
-npm init -y
-
-# 3. 安装 CollabDocChat
-npm install collabdocchat
-
-# 4. 进入安装目录
-cd node_modules/collabdocchat
-
-# 5. 启动应用
-npm start
-```
-
-### 方式二：克隆仓库
-
-适合开发者和需要自定义的用户：
-
-```bash
-# 1. 克隆项目
-git clone https://github.com/shijinghao/collabdocchat.git
-cd collabdocchat
-
-# 2. 安装依赖
-npm install
-
-# 3. 启动应用
-npm start
-```
-
-### 方式三：使用安装脚本
-
-#### Windows 用户
-
-1. 下载 `install-and-start.bat`
-2. 双击运行或在命令行中执行：
-```cmd
-install-and-start.bat
-```
-
-#### Linux/Mac 用户
-
-1. 下载 `install-and-start.sh`
-2. 添加执行权限并运行：
-```bash
-chmod +x install-and-start.sh
-./install-and-start.sh
-```
-
-## 🔧 环境要求
-
-### 必需软件
-
-1. **Node.js** (>= 16.0.0)
-   - 下载地址: https://nodejs.org/
-   - 验证安装: `node --version`
-
-2. **npm** (>= 7.0.0)
-   - 通常随 Node.js 一起安装
-   - 验证安装: `npm --version`
-
-3. **MongoDB** (>= 4.4)
-   - 下载地址: https://www.mongodb.com/try/download/community
-   - 验证安装: `mongod --version`
-
-### MongoDB 安装指南
-
-#### Windows
-
-1. 下载 MongoDB Community Server
-2. 运行安装程序，选择"Complete"安装
-3. 安装 MongoDB Compass (可选的图形界面)
-4. 启动 MongoDB 服务：
-```cmd
-net start MongoDB
-```
-
-#### Mac (使用 Homebrew)
-
-```bash
-# 安装 MongoDB
-brew tap mongodb/brew
-brew install mongodb-community
-
-# 启动 MongoDB
-brew services start mongodb-community
-```
-
-#### Linux (Ubuntu/Debian)
-
-```bash
-# 导入公钥
-wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
-
-# 添加源
-echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
-
-# 安装
-sudo apt-get update
-sudo apt-get install -y mongodb-org
-
-# 启动服务
-sudo systemctl start mongod
-sudo systemctl enable mongod
-```
-
-## ⚙️ 配置
-
-### 首次运行
-
-首次运行时，应用会自动创建配置文件。您也可以手动创建 `.env` 文件：
-
-```env
-# 服务器配置
-PORT=3000
-NODE_ENV=development
-
-# MongoDB 配置
-MONGODB_URI=mongodb://localhost:27017/collabdocchat
-
-# JWT 配置
-JWT_SECRET=your-secret-key-change-this-in-production
-JWT_EXPIRES_IN=7d
-
-# 管理员账号（首次启动时创建）
-ADMIN_USERNAME=admin
-ADMIN_PASSWORD=admin123
-ADMIN_EMAIL=admin@example.com
-```
-
-### 配置说明
-
-- **PORT**: 服务器端口，默认 3000
-- **MONGODB_URI**: MongoDB 连接字符串
-- **JWT_SECRET**: JWT 密钥，生产环境请务必修改
-- **JWT_EXPIRES_IN**: Token 过期时间
-- **ADMIN_USERNAME/PASSWORD**: 默认管理员账号
-
-## 🚀 启动应用
-
-### 开发模式
-
-```bash
-npm run dev
-```
-
-特点：
-- 自动重启服务器
-- 热重载前端
-- 自动打开浏览器
-
-### 生产模式
-
-```bash
-npm start
-```
-
-### 快速启动
-
-```bash
-npm run quick-start
-```
-
-自动配置并启动应用。
-
-## 🔍 验证安装
-
-### 1. 检查服务器
-
-访问: http://localhost:3000
-
-应该看到登录页面。
-
-### 2. 检查客户端
-
-访问: http://localhost:5173
-
-应该看到应用界面。
-
-### 3. 登录测试
-
-使用默认管理员账号登录：
-- 用户名: `admin`
-- 密码: `admin123`
-
-## ❌ 常见问题
-
-### 问题 1: MongoDB 连接失败
-
-**错误信息**: `MongoNetworkError: connect ECONNREFUSED`
-
-**解决方案**:
-1. 确认 MongoDB 服务已启动
-2. 检查 `.env` 中的 `MONGODB_URI` 配置
-3. 验证 MongoDB 端口 (默认 27017)
-
-```bash
-# Windows
-net start MongoDB
-
-# Mac
-brew services start mongodb-community
-
-# Linux
-sudo systemctl start mongod
-```
-
-### 问题 2: 端口被占用
-
-**错误信息**: `Error: listen EADDRINUSE: address already in use :::3000`
-
-**解决方案**:
-1. 更改 `.env` 中的 `PORT` 配置
-2. 或者停止占用端口的进程
-
-```bash
-# Windows - 查找并结束进程
-netstat -ano | findstr :3000
-taskkill /PID <进程ID> /F
-
-# Mac/Linux
-lsof -ti:3000 | xargs kill -9
-```
-
-### 问题 3: npm 依赖安装失败
-
-**解决方案**:
-```bash
-# 清除缓存
-npm cache clean --force
-
-# 删除 node_modules
-rm -rf node_modules package-lock.json
-
-# 重新安装
-npm install
-```
-
-### 问题 4: Node.js 版本过低
-
-**错误信息**: `Error: The engine "node" is incompatible`
-
-**解决方案**:
-升级 Node.js 到 16.0.0 或更高版本。
-
-## 🛑 停止应用
-
-### 方法一：使用脚本
-
-```bash
-npm run stop
-```
-
-### 方法二：手动停止
-
-在运行应用的终端按 `Ctrl + C`
-
-### 方法三：结束进程
-
-```bash
-# Windows
-taskkill /F /IM node.exe
-
-# Mac/Linux
-pkill -f node
-```
-
-## 📊 性能优化
-
-### 生产环境建议
-
-1. **使用 PM2 管理进程**:
-```bash
-npm install -g pm2
-pm2 start server/index.js --name collabdocchat
-pm2 startup
-pm2 save
-```
-
-2. **配置反向代理** (Nginx):
-```nginx
-server {
-    listen 80;
-    server_name your-domain.com;
-
-    location / {
-        proxy_pass http://localhost:3000;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection 'upgrade';
-        proxy_set_header Host $host;
-        proxy_cache_bypass $http_upgrade;
-    }
-}
-```
-
-3. **启用 MongoDB 认证**:
-```javascript
-// .env
-MONGODB_URI=mongodb://username:password@localhost:27017/collabdocchat?authSource=admin
-```
-
-## 🔐 安全建议
-
-1. **修改默认管理员密码**
-2. **使用强 JWT 密钥**
-3. **启用 HTTPS**
-4. **配置防火墙规则**
-5. **定期更新依赖包**
-
-```bash
-npm audit
-npm audit fix
-```
-
-## 📞 获取帮助
-
-如果遇到问题：
-
-1. 查看 [GitHub Issues](https://github.com/shijinghao/collabdocchat/issues)
-2. 阅读 [完整文档](https://github.com/shijinghao/collabdocchat#readme)
-3. 提交新的 Issue
-
-## 🎉 安装成功！
-
-现在您可以：
-- 创建文档并邀请团队成员协作
-- 使用实时聊天功能
-- 管理任务和项目
-- 探索更多功能
-
-祝您使用愉快！🚀
-