Skip to content

v3.1.0

Choose a tag to compare

@Zoroaaa Zoroaaa released this 04 Nov 06:33

Added - 团队共享工作空间 🖥️

本次版本核心亮点:团队协作从「资源挂载」模式升级为完整的共享工作空间(Workspace),新增邀请机制、活动流、团队自有文件、存储配额等能力。


核心新功能(一):团队邀请机制

  • 邀请链接系统:

    • 管理员可创建邀请链接,支持设置角色(member/guest)、有效期(1-30天)、欢迎语
    • 支持指定邮箱邀请(可追踪受邀人)
    • 生成短码分享链接(如 /invite/code/ABC123)
    • 邀请状态管理:pending → accepted / expired / revoked
    • 邀请接受页面(/accept-invite),未登录用户也可查看邀请详情
  • 邀请记录查看:

    • 新增 GET /api/teams/:id/invites/all 端点,支持 ?status= 状态筛选
    • 所有团队成员可查看邀请记录(含接受者信息、时间等详情)
    • TeamInviteRecords 组件:状态 Tab 切换 / 统计信息 / 管理员可撤销待定邀请
    • 集成至团队详情页「邀请记录」Tab
  • 邀请 API(9 个端点):

方法 路径 功能
GET /api/invite/:token 查询邀请详情
GET /api/invite/code/:code 通过短码查询
POST /api/invite/:token/accept 接受邀请(需登录)
POST /api/teams/:id/invites 创建邀请链接
GET /api/teams/:id/invites 列出待定邀请
DELETE /api/teams/:id/invites/:inviteId 撤销邀请
POST /api/teams/:id/invites/:token/accept API内接受邀请

核心新功能(二):团队工作区文件系统

  • 团队自有文件:

    • files 表新增 team_id 字段,支持文件直接归属团队
    • 工作区内可直接新建文件夹、上传文件
    • 文件路径前缀 /teams/{teamId}/,与个人文件隔离
  • 挂载资源增强:

    • team_resources 表新增 target_folder_id,支持将资源挂载到指定子目录
    • 挂载时自动创建团队级 file_permissions(默认 read)
    • 卸载时同步清理关联权限记录
  • 工作区文件浏览 API:

方法 路径 功能
GET /api/teams/:id/workspace/files 获取挂载资源文件列表
GET /api/teams/:id/workspace/all-files 获取全部文件(挂载+自有)
POST /api/teams/:id/workspace/folder 在工作区新建文件夹

核心新功能(三):团队活动流

  • 活动记录系统:
    • 新增 team_activities 表,记录团队内所有关键操作
    • 自动记录:团队创建/设置变更、成员加入/离开/角色变更、文件挂载/卸载/上传
    • 活动时间线 API:支持分页、按团队/用户/动作类型筛选
方法 路径 功能
GET /api/teams/:id/activities 获取团队活动时间线

核心新功能(四):团队存储配额

  • 存储管理:
    • teams 表新增 storage_quota(默认 5GB)和 storage_used 字段
    • 创建团队时可配置存储配额(50MB ~ 1TB)
    • 支持 default_member_role 配置新成员默认角色
    • 存储统计 API:聚合团队自有文件 + 挂载资源大小
方法 路径 功能
GET /api/teams/:id/storage 获取团队存储统计

核心新功能(五):前端工作区完整 UI

  • TeamWorkspace 组件重构(+900 行):

    • 双视图模式:列表视图 / 网格视图切换
    • 文件排序:按名称/大小/日期升降序
    • 分页浏览:可配置每页数量
    • 权限标识:每个文件显示当前用户的权限级别 Badge
    • 挂载区分:挂载资源显示「挂载」标签(琥珀色)
    • 上传进度条:实时显示多文件上传进度
    • 右键菜单:预览/下载/重命名/卸载(挂载资源)/删除(自有文件)
    • 双击文件夹进入、双击文件预览
    • 多选批量操作:全选/批量下载/批量删除
    • Tab 切换:「文件」|「活动」
  • TeamInviteDialog:邀请创建对话框(角色/邮箱/有效期/消息配置)

  • TeamInviteRecords:邀请记录管理组件(状态筛选/详情展示/撤销操作)

  • TeamActivityFeed:活动流时间线展示组件

  • TeamStorageBar:团队存储空间使用量可视化条

  • AcceptInvite 页面:独立的邀请接受落地页(支持路由懒加载)

Improved - 权限系统增强 🔐

  • 缓存粒度优化

    • 缓存 Key 从 perm:{fileId}:{userId} 升级为 perm:{fileId}:{userId}:{requiredLevel}
    • 不同权限级别独立缓存,避免权限升级后旧缓存返回错误结果
  • KV 缓存清理分页

    • invalidatePermissionCacheForUser() 支持 KV list 分页遍历
    • 解决大量权限缓存时单次 list 无法删除完全的问题
  • 安全边界加固

    • batchGrantPermissions / batchRevokePermissions 增加操作者所有者校验
    • grantWithRoleTemplate 增加所有者验证,防止非所有者越权授权
    • 成员/组移除时自动失效目标用户权限缓存
    • 团队删除时级联清理 team 维度权限记录并失效缓存
  • Bug 修复

    • setFolderAccessLevel 修复未写入 access_level 字段的 bug
    • inheritParentPermissions 补充 teamId 字段传递
    • checkFilePermission 移除冗余的 fallback 分支,统一走 resolveEffectivePermission
    • listPermissionRequests 返回准确的 total 计数值(替代 items.length)

Changed - AI 模块优化 🤖

  • 工具集精简

    • 移除 copy_file 工具(与 v2.6.0 移除复制功能保持一致)
    • 新增 batch_move / batch_delete 到 WRITE_TOOLS 集合
    • grant_permission 工具支持通过 targetEmail 参数查找用户授权
  • 代码质量提升

    • estimateTokens() 从 agentEngine.ts / ragEngine.ts 提取至 ai/utils.ts 统一导出
    • WorkersAI adapter 修复 tools 参数格式(stripNestedObjectArrays 处理)
    • generateImageTags() 增加 mimeType 校验,防止非图片文件被错误处理
    • extractThinkingContent() 正则优化为非贪婪匹配
    • hasThinkingTags() 正则简化
    • vectorIndex 日志格式统一(对象展开)
  • 配置调整

    • ai.agent.max_context_tokens sortOrder 从 21 调整为 17
    • modelGateway 日志增加 isActive 状态输出
    • features.ts shouldIndexFile 移除 fileSize 参数(不做大小限制)

Changed - 文件管理与体验优化 📁

  • 回收站页面增强

    • 新增分页支持(每页 50 条)
    • 替换原生 confirm() 为 MobileDialog 组件(移动端友好)
    • 清空回收站/永久删除均使用确认对话框
  • 标签管理页面

    • 代码格式化改进,提升可读性和维护性
  • 团队列表增强

    • 返回字段扩展:description, userRole, isOwner, createdAt, updatedAt
    • 成员信息补充 name + email(原仅 email)
  • 其他优化

    • dedup.ts 去重逻辑增强(+89 行)
    • fileService.ts restoreFile 路径前缀提取优化
    • upload_tasks 表补充 team_id 字段支持团队上传任务
    • 多个前端组件交互细节优化

Fixed - Bug 修复 🛠️

  • 邀请服务修复 (routes/invitations.ts):修正邀请处理逻辑中的参数传递问题
  • 工作区目录过滤修复 (teamService.ts → getTeamFiles):挂载资源查询原使用 files.parentId(物理父目录)过滤位置,完全忽略了 team_resources.target_folder_id(用户选择的逻辑挂载位置)。修复后:根目录只显示 targetFolderId IS NULL 的资源,子文件夹只显示 targetFolderId = 当前文件夹ID 的资源

Database Changes

新增迁移文件(5 个):

迁移文件 用途
101_team_v2.sql teams表扩展(配额/角色) + team_invitations + team_activities
102_team_files.sql files表新增 team_id
103_upload_tasks_team_id.sql upload_tasks表新增 team_id
104_team_resources_target_folder.sql team_resources新增 target_folder_id
105_access_level.sql files表新增 access_level

Schema 变更汇总:

表名 变更类型 字段/说明
teams ALTER +storage_quota, +storage_used, +default_member_role
files ALTER +team_id, +access_level
upload_tasks ALTER +team_id
team_resources ALTER +target_folder_id
team_invitations CREATE 邀请链接表(token/code/email/role/status等)
team_activities CREATE 活动流表(action/resource_type/details)

New Files

后端(3 个新文件):

apps/api/
├── migrations/
│   ├── 101_team_v2.sql                        # 团队V2迁移(邀请+活动+配额)
│   ├── 102_team_files.sql                     # 团队文件字段
│   ├── 103_upload_tasks_team_id.sql           # 上传任务团队ID
│   ├── 104_team_resources_target_folder.sql   # 挂载目标文件夹
│   └── 105_access_level.sql                   # 访问级别字段
└── src/
    ├── lib/
    │   ├── inviteService.ts                    # 邀请服务(创建/接受/撤销/短码)
    │   └── teamActivityService.ts              # 团队活动记录服务
    └── routes/
        └── invitations.ts                      # 邀请路由(公开+受保护)

前端(5 个新文件):

apps/web/src/
├── pages/AcceptInvite.tsx                       # 邀请接受页面
└── components/teams/
    ├── TeamInviteDialog.tsx                     # 邀请创建对话框
    ├── TeamInviteRecords.tsx                    # 邀请记录管理组件
    ├── TeamActivityFeed.tsx                     # 活动流组件
    └── TeamStorageBar.tsx                       # 存储空间展示条

Modified Files(核心改造)

后端(7 个文件大幅修改):

文件 改动量 说明
src/lib/teamService.ts +500 行 工作区文件/存储统计/活动记录/权限同步/列表增强
src/routes/teams.ts +350 行 8个新端点(工作区/邀请/活动/存储/文件夹/全文件)
src/lib/permissionService.ts ±200 行 安全加固/缓存优化/bug修复
src/lib/permissionResolver.ts +30 行 缓存key维度升级/KV分页清理
src/db/schema.ts +24 行 新增表定义+字段
src/index.ts +3 行 注册邀请路由
src/routes/files.ts +15 行 团队维度文件查询支持

前端(10 个文件大幅修改):

文件 改动量 说明
components/teams/TeamWorkspace.tsx +900 行 完整工作区UI重构
components/teams/TeamDetail.tsx +100 行 详情页增强
components/teams/TeamList.tsx +150 行 列表页增强
components/teams/TeamResourceMountDialog.tsx +240 行 支持选择目标文件夹
components/teams/TeamMemberDialog.tsx +50 行 成员信息增强(name+email)
pages/Teams.tsx +170 行 团队页增强
pages/Trash.tsx +70 行 分页+确认对话框
pages/Tags.tsx +150 行 格式化改进
services/collab.ts +80 行 团队API扩展
App.tsx / LazyComponents.tsx +30 行 路由注册(AcceptInvite)

API Endpoints Summary

团队工作区 API(9 个新端点):

方法 路径 功能
GET /api/teams/:id/workspace/files 工作区文件列表(挂载)
GET /api/teams/:id/workspace/all-files 全部文件(挂载+自有)
POST /api/teams/:id/workspace/folder 新建文件夹
GET /api/teams/:id/activities 活动时间线
GET /api/teams/:id/storage 存储统计
POST /api/teams/:id/invites 创建邀请链接
GET /api/teams/:id/invites 待定邀请列表(管理员)
GET /api/teams/:id/invites/all 全部邀请记录(可状态筛选)
DELETE /api/teams/:id/invites/:inviteId 撤销邀请

邀请公开 API(3 个端点):

方法 路径 功能
GET /api/invite/:token 查询邀请详情
GET /api/invite/code/:code 短码查询
POST /api/invite/:token/accept 接受邀请

现有 API 扩展:

端点 扩展内容
POST /api/teams +storageQuota, +defaultMemberRole 参数
PUT /api/teams/:id 支持更新 storageQuota / defaultMemberRole
GET /api/teams/:id/members 返回 name + email(原仅 userEmail)
POST /api/teams/:id/resources +targetFolderId 参数(挂载到子目录)