技术亮点
音视频播放器开发
问题背景：M2TS、MOV 等格式浏览器原生不支持，需要后端转码。转码视频存在以下问题：无法 seek 到任意位置（不支持 Range），拖动进度条需重新加载导致长时间黑屏，时间轴与原视频不一致。
任务：实现流畅的转码视频播放体验，支持进度拖拽和续播。
行动：
- 区分原生格式与转码流：根据文件扩展名和浏览器支持情况判断是否需要后端转码
- 实现 seekOffset 起播偏移机制：转码流通过后端参数指定起始位置，前端维护偏移量计算真实播放时间
- 自定义播放控制条：转码流使用自定义控制条替代浏览器原生，实现缓冲区域可视化
- 智能跳转逻辑：检查目标位置是否在当前缓冲范围，不在时播放到缓冲末尾后再跳转，减少黑屏时间
- 缓冲历史管理：记录已加载视频片段，支持续播
- 添加 MOV 格式原生支持，优化流式播放逻辑
结果：转码视频播放流畅，支持70+视频格式，黑屏时间显著减少。
文本文件编码智能检测与预览
情境：用户上传的文本文件编码多样（GBK、UTF-8、GB2312等），直接读取会出现乱码。简单检测无法覆盖所有场景。
任务：实现高准确率的文本文件编码自动检测，确保不同编码文件都能正确预览。
行动：
- 引入jschardet库进行初步编码检测
- 实现双层验证机制：先用样本数据（8KB）测试各编码，找到最佳编码后再解码整个文件
- 智能判断：检测到非中文编码但文件可能包含中文时，尝试UTF-8和GB18030回退
- 中文字符范围校验：检查UTF-8和GBK编码范围，确保检测准确性
- 在OnlyOffice配置中添加编码字段，支持CSV文件正确打开
结果：文本文件预览成功率提升至99%以上，用户无需手动转换编码。
统一文件类型检测工具
情境：项目中多处需要文件类型判断（预览、上传、列表显示），代码分散且重复。
任务：集中管理所有文件类型检测逻辑，统一接口。
行动：
- 新建fileTypeDetector.js工具模块（225行）
- 建立70+文件格式的MIME类型映射表
- 实现FILE_TYPE_CATEGORIES分类系统（image/video/audio/text/document）
- 提供canPreview()、isFileType()等便捷函数
- 支持从文件名、文件对象、extension多方式提取类型
结果：代码复用率提升，预览和上传模块类型判断统一。
企业文件权限管理
情境：企业文件需要同时管理用户权限和部门权限，两者可独立设置，编辑模式下权限状态复杂。
任务：实现精确的权限管理，确保权限操作准确性与UI状态一致性。
行动：
- 设计用户权限与部门权限的独立管理界面
- 实现权限清空检测逻辑，编辑模式下实时检测权限变化
- 权限变更后自动重新获取并更新UI状态
- 处理权限设置错误的状态回滚
- 使用批量接口优化部门员工查询性能
- 实现部门分页功能，支持大规模组织架构
结果：权限管理更精确，状态同步问题减少90%。
OnlyOffice文档在线编辑
情境：用户需要在线编辑Office文档（Word/Excel/PPT）。
任务：集成OnlyOffice实现在线文档编辑功能。
行动：
- 集成OnlyOffice编辑器，支持Word/Excel/PPT在线编辑
- 实现自动保存机制，防止数据丢失
- 添加存储空间检测：99.9%使用率显示警告，低于100KB禁止编辑
- CSV文件编码支持，确保中文内容正确显示
结果：用户可直接在网盘中编辑Office文档，无需下载上传。
文件分享功能
情境：用户需要将文件分享给其他用户或外部人员，需快速复制分享链接。分享页面点击下载后，原分享页面需同步更新下载次数。
任务：实现安全的文件分享链路，支持一键复制分享链接和跨标签页下载同步。
行动：
- 开发分享API（src/api/share.js），支持创建/管理分享链接
- 实现分享权限控制（查看/下载/编辑）
- 分享链接有效期管理
- 集成到文件操作菜单和右键菜单
- 使用浏览器 Clipboard API（navigator.clipboard.writeText）实现一键复制分享链接和提取码
- 使用 BroadcastChannel API（跨标签页通信）实现下载事件同步：分享页面下载文件后，通过postMessage通知原分享页面更新下载次数
- 降级处理：Clipboard API不可用时使用传统方案
结果：支持企业内外部安全文件分享，一键复制提升用户体验，跨标签页下载次数实时同步。
管理端SSO单点登录
情境：用户端已登录用户需直接访问管理端，无需再次输入账号密码。
任务：实现用户端到管理端的单点登录机制。
行动：
- 设计SSO Token机制：用户端生成带时间戳的加密Token（Base64编码）
- 实现Token时效性验证（5分钟内有效）
- Token换取管理端Token：调用后端接口 /login/generate_admin_token
- 安全验证：比对服务器返回的uid与URL传入的sso_uid，确保身份一致性
- 使用独立Axios实例避免全局拦截器冲突
结果：用户可在用户端直接跳转到管理端，实现跨系统单点登录。