collabdocchat 2.0.0 → 2.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "collabdocchat",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "开源的实时协作文档聊天平台 - 集成任务管理、多人文档编辑、智能点名功能",
   "main": "./server/index.js",
   "type": "module",

package/scripts/generate-docs.js

@@ -0,0 +1,448 @@
+#!/usr/bin/env node
+
+/**
+ * 文档生成脚本
+ * 批量生成项目文档大纲
+ */
+
+import { writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const docsDir = join(__dirname, '../docs');
+
+// 文档模板
+const documents = [
+  {
+    filename: '03-basic-tutorial.md',
+    title: '基础教程',
+    content: `# 基础教程
+
+## 🎯 学习目标
+
+通过本教程，您将学会：
+- ✅ 创建和管理群组
+- ✅ 发送和接收消息
+- ✅ 创建和编辑文档
+- ✅ 管理任务
+- ✅ 使用知识库
+
+## 📝 第一步：登录系统
+
+1. 打开浏览器访问 http://localhost:5174
+2. 使用默认管理员账号登录：
+   - 用户名: \`admin\`
+   - 密码: \`admin123\`
+3. 成功登录后进入仪表板
+
+## 👥 第二步：创建群组
+
+1. 点击侧边栏的"我的群组"
+2. 点击"创建群组"按钮
+3. 填写群组信息：
+   - 群组名称：例如"项目团队"
+   - 群组描述：例如"项目协作群组"
+4. 点击"创建"完成
+
+## 💬 第三步：发送消息
+
+1. 选择刚创建的群组
+2. 点击"群聊"菜单
+3. 在输入框输入消息
+4. 点击"发送"或按 Enter 键
+
+### 高级功能
+- **@提及**: 输入 @ 后选择成员
+- **表情包**: 点击笑脸图标选择表情
+- **消息撤回**: 2分钟内可撤回消息
+
+## 📄 第四步：创建文档
+
+1. 点击"共享文档"菜单
+2. 点击"新建文档"按钮
+3. 填写文档信息：
+   - 标题：例如"项目计划"
+   - 内容：使用富文本编辑器编写
+4. 选择权限：只读或可编辑
+5. 点击"保存"
+
+## 📋 第五步：创建任务
+
+1. 点击"我的任务"菜单
+2. 点击"创建任务"按钮（管理员）
+3. 填写任务信息：
+   - 标题：例如"完成需求文档"
+   - 描述：详细说明
+   - 分配给：选择成员
+   - 截止日期：设置期限
+4. 点击"创建"
+
+## 📚 第六步：使用知识库
+
+1. 点击"知识库"菜单
+2. 点击"新建文档"按钮
+3. 填写文档信息：
+   - 标题：例如"API 使用指南"
+   - 分类：例如"技术文档"
+   - 标签：例如"API, 教程"
+   - 内容：使用富文本编辑器
+4. 选择权限：私有/群组/公开
+5. 点击"发布"或"保存草稿"
+
+## 🎨 第七步：自定义主题
+
+1. 点击"设置"菜单
+2. 选择"主题设置"
+3. 选择预设主题或创建自定义主题
+4. 实时预览效果
+5. 点击"应用"保存
+
+## 🤖 第八步：使用 AI 助手
+
+1. 在群聊中点击"AI"按钮
+2. 选择 AI 功能：
+   - 智能回复
+   - 内容总结
+   - 语法检查
+   - 翻译
+3. 输入内容获取 AI 建议
+
+## ✅ 完成！
+
+恭喜！您已经掌握了 CollabDocChat 的基本使用方法。
+
+**下一步**: 查看 [用户手册](./04-user-guide.md) 了解更多高级功能
+`
+  },
+  {
+    filename: '04-user-guide.md',
+    title: '用户手册',
+    content: `# 用户手册
+
+## 📖 完整功能指南
+
+本手册详细介绍 CollabDocChat 的所有用户功能。
+
+## 目录
+
+1. [账号管理](#账号管理)
+2. [群组功能](#群组功能)
+3. [聊天功能](#聊天功能)
+4. [文档协作](#文档协作)
+5. [任务管理](#任务管理)
+6. [知识库](#知识库)
+7. [文件共享](#文件共享)
+8. [搜索功能](#搜索功能)
+9. [个性化设置](#个性化设置)
+
+## 账号管理
+
+### 注册账号
+1. 访问登录页面
+2. 点击"注册"按钮
+3. 填写用户名、密码、邮箱
+4. 点击"注册"完成
+
+### 修改密码
+1. 进入"设置"页面
+2. 选择"账号设置"
+3. 输入旧密码和新密码
+4. 点击"保存"
+
+### 个人资料
+- 修改头像
+- 更新个人信息
+- 设置通知偏好
+
+## 群组功能
+
+### 创建群组
+- 填写群组名称和描述
+- 添加初始成员
+- 设置群组权限
+
+### 加入群组
+- 浏览所有群组
+- 点击"加入"按钮
+- 等待管理员审批（如需要）
+
+### 退出群组
+- 进入群组设置
+- 点击"退出群组"
+- 确认操作
+
+## 聊天功能
+
+### 发送消息
+- 文本消息
+- 表情包
+- @提及成员
+- 回复消息
+
+### 消息管理
+- 撤回消息（2分钟内）
+- 删除消息
+- 标记已读
+
+### 高级功能
+- 消息搜索
+- 聊天记录导出
+- 消息通知设置
+
+## 文档协作
+
+### 创建文档
+- 使用富文本编辑器
+- 设置文档权限
+- 添加协作者
+
+### 编辑文档
+- 实时协作编辑
+- 查看其他用户光标
+- 自动保存
+
+### 版本管理
+- 查看历史版本
+- 恢复旧版本
+- 比较版本差异
+
+## 任务管理
+
+### 查看任务
+- 我的任务列表
+- 任务状态筛选
+- 任务详情查看
+
+### 更新任务
+- 更改任务状态
+- 添加任务备注
+- 上传附件
+
+### 投票任务
+- 查看投票选项
+- 提交投票
+- 查看投票结果（管理员）
+
+## 知识库
+
+### 浏览知识库
+- 按分类浏览
+- 按标签筛选
+- 搜索文档
+
+### 创建文档
+- 填写标题和内容
+- 设置分类和标签
+- 选择权限级别
+
+### 互动功能
+- 点赞文档
+- 收藏文档
+- 添加评论
+
+## 文件共享
+
+### 上传文件
+- 选择文件
+- 添加描述
+- 上传到群组
+
+### 下载文件
+- 浏览文件列表
+- 点击下载按钮
+- 保存到本地
+
+### 文件管理
+- 查看文件详情
+- 删除自己的文件
+- 文件预览
+
+## 搜索功能
+
+### 全局搜索
+- 搜索消息
+- 搜索文档
+- 搜索任务
+
+### 高级搜索
+- 按时间筛选
+- 按类型筛选
+- 按作者筛选
+
+## 个性化设置
+
+### 主题设置
+- 选择预设主题
+- 创建自定义主题
+- 导入导出主题
+
+### 通知设置
+- 桌面通知
+- 邮件通知
+- 消息提醒
+
+### 隐私设置
+- 在线状态显示
+- 个人资料可见性
+- 消息已读回执
+
+---
+
+**提示**: 遇到问题？查看 [常见问题](./06-faq.md) 或 [故障排查](./19-troubleshooting.md)
+`
+  },
+  {
+    filename: '05-admin-guide.md',
+    title: '管理员手册',
+    content: `# 管理员手册
+
+## 👨‍💼 管理员功能指南
+
+本手册介绍管理员专属功能和管理操作。
+
+## 目录
+
+1. [用户管理](#用户管理)
+2. [群组管理](#群组管理)
+3. [权限管理](#权限管理)
+4. [内容审核](#内容审核)
+5. [系统监控](#系统监控)
+6. [数据备份](#数据备份)
+
+## 用户管理
+
+### 查看所有用户
+- 用户列表
+- 用户详情
+- 活动统计
+
+### 用户操作
+- 禁用/启用用户
+- 重置密码
+- 修改用户角色
+
+### 批量操作
+- 批量导入用户
+- 批量删除用户
+- 批量修改权限
+
+## 群组管理
+
+### 群组设置
+- 修改群组信息
+- 管理成员
+- 设置群组权限
+
+### 成员管理
+- 添加成员
+- 移除成员
+- 设置管理员
+
+### 禁言管理
+- 全体禁言
+- 个人禁言
+- 禁言时长设置
+
+### 随机点名
+- 设置点名人数
+- 执行随机点名
+- 查看点名记录
+
+## 权限管理
+
+### 角色权限
+- 管理员权限
+- 普通用户权限
+- 自定义角色
+
+### 资源权限
+- 文档权限
+- 任务权限
+- 文件权限
+
+### 权限审计
+- 查看权限变更
+- 权限使用统计
+- 异常权限检测
+
+## 内容审核
+
+### 消息审核
+- 查看所有消息
+- 删除不当消息
+- 清除聊天记录
+
+### 文档审核
+- 审核待发布文档
+- 删除违规文档
+- 文档归档
+
+### 任务审核
+- 审核任务创建
+- 修改任务状态
+- 删除任务
+
+## 系统监控
+
+### 操作审计
+- 查看审计日志
+- 用户活动统计
+- 系统操作记录
+
+### 性能监控
+- 服务器状态
+- 数据库性能
+- API 响应时间
+
+### 错误日志
+- 查看错误日志
+- 错误统计分析
+- 错误告警设置
+
+## 数据备份
+
+### 手动备份
+- 创建备份
+- 下载备份文件
+- 恢复备份
+
+### 自动备份
+- 设置备份计划
+- 备份保留策略
+- 备份存储位置
+
+### 数据导出
+- 导出用户数据
+- 导出群组数据
+- 导出聊天记录
+
+---
+
+**注意**: 管理员操作会被记录在审计日志中，请谨慎操作。
+`
+  }
+];
+
+// 生成文档
+console.log('📝 开始生成文档...\n');
+
+documents.forEach(doc => {
+  const filePath = join(docsDir, doc.filename);
+  try {
+    writeFileSync(filePath, doc.content, 'utf-8');
+    console.log(`✅ 已生成: ${doc.filename}`);
+  } catch (error) {
+    console.error(`❌ 生成失败: ${doc.filename}`, error.message);
+  }
+});
+
+console.log('\n🎉 文档生成完成！');
+console.log('\n📚 已生成的文档:');
+documents.forEach(doc => {
+  console.log(`   - ${doc.title} (${doc.filename})`);
+});
+
+console.log('\n💡 提示: 查看 KNOWLEDGE_BASE.md 了解完整文档结构');
+

package/server/websocket/index.js

@@ -18,6 +18,10 @@ export const setupWebSocket = (wss) => {
           case 'auth':
             handleAuth(ws, data);
             break;
+          case 'ping':
+            // 响应心跳
+            ws.send(JSON.stringify({ type: 'pong', timestamp: Date.now() }));
+            break;
           case 'join_group':
             await handleJoinGroup(ws, data);
             break;