协作空间功能使用指南


什么是笔COOL协作空间?

协作空间是 笔COOL平台 为教学场景多人团队协作提供的,用于组织和隔离不同的项目或团队的功能。每个空间都能独立管理所属成员与作品。

空间内的资源所有权归组织,而非个人。因此即使作品创建人退出空间,其作品仍会保留在空间中。

主要特点

  • 子账号管理 - 支持教育机构和团队创建子账号,统一管理成员。例如由老师为学生批量提供账号,免去学生自行注册登录的环节
  • 多人实时协作 - 支持多人同时编辑同一代码项目,实时同步,自动解决冲突
  • 分组批量管理 - 按班级/项目组分组,批量分配权限
  • 权限精细管理 - 三级权限控制,满足不同角色的访问需求

权限体系

笔 COOL 提供三级权限控制,满足不同角色的使用需求。

权限 功能描述 适用人群
管理员 完整管理权限 老师、团队负责人
可编辑 编辑代码内容 学生、开发人员
可查看 仅查看和运行 访客、评审人员

权限继承规则:

  • 文件夹级别授予权限 → 自动应用到该文件夹下的所有项目
    • 例如,如果你在父级文件夹获得了编辑权限,通常也能编辑其下的所有项目,除非它们设置了独立的权限。
  • 项目级别授予权限 → 仅影响该特定项目

空间资源文件

协作空间拥有独立的资源库,用于存放团队共享的图片、素材等文件。

  • 空间所有 — 资源归属于空间,不会因为成员退出而丢失
  • 项目共享 — 空间内任何项目都可以直接使用资源库中的素材
  • 人员共享 — 所有成员在项目中自由选用

进入空间设置 → "资源文件"即可管理。


详细功能说明

以下操作需在登录状态下进行

一、空间管理

1.1 创建与编辑空间


二、子用户管理

2.1 创建单个子用户

2.2 批量导入子用户


三、分组管理

3.1 使用分组分配权限

  • 快速授权:一次操作,授权多人
  • 🔄 自动同步:新增成员自动继承权限
  • 📋 易于管理:修改分组权限,所有人更新

四、实时协作功能

4.1 多人实时编辑

  • 👥 多人同时编辑:无限制人数,同时修改代码
  • 实时同步:毫秒级延迟,立即看到队友修改
  • 🔄 自动冲突解决:基于 CRDT 算法,无需担心冲突
  • 🎨 彩色光标:每位用户有独特颜色标识

常见问题

Q1: 学生可以看到其他学生吗?

A:

  • 可以。只要处于同一个项目中,学生就能看到当前项目里的所有其他协作者

Q2: 多人同时编辑会冲突吗?

A: 不会。系统采用 CRDT 算法,自动合并多个人的修改,无需担心冲突问题。

Q3: 协作者可以邀请其他人吗?

A:

  • 只有管理员权限可以邀请/添加协作者
  • 编辑者和查看者无此权限

Q4: 如何批量添加学生到项目?

A:

  1. 进入项目"协作者管理"
  2. 点击"批量添加"
  3. 选择分组(如"第一小组")
  4. 统一设置权限
  5. 该分组所有学生自动获得权限

Q5: 什么是外部协作者?

A:

  • 笔COOL的正式注册用户,也可参与空间的项目协作
  • 无需通过子账号管理
  • 适合已在笔COOL上正式注册的用户直接作为协作者加入空间

场景应用

🎓 场景一:编程课程教学

适用场景: 网页开发课程

老师端功能

1. 创建班级空间

1. 进入"我的空间"页面
2. 点击"+ 创建工作空间"
3. 填写:"2026级 高二 TypeScript 基础班"
4. 描述:"TypeScript 编程语言基础课程"

2. 批量创建学生账号

1. 进入空间 → "子用户管理"
2. 点击"批量导入"
3. 下载 Excel 模板
4. 填写学生信息(学号、姓名)
5. 上传文件,系统自动创建账号

3. 按小组分组

1. 进入"分组管理"
2. 创建分组:
   - 第一小组
   - 第二小组
   - 第三小组
3. 将学生分配到对应小组

4. 布置作业项目

1. 在空间内创建"作业"文件夹
2. 创建作业项目:
   - 作业 1:Hello World
   - 作业 2:简易计算器
   - 作业 3:学生管理系统
3. 设置默认权限为学生为编辑者

5. 批量分配项目权限

1. 进入作业项目的"协作者管理"
2. 选择"按分组添加"
3. 勾选所有学生分组
4. 设置权限为"编辑者"
5. 完成批量授权

6. 作业批改与反馈

1. 查看学生提交的作业
2. 直接在代码中标注问题
3. 提供修改建议
4. 学生看到反馈后修改

学生端体验

登录学生账号:

1. 使用老师分配的账号登录
2. 进入班级空间
3. 查看所有作业项目
4. 开始编写代码

协作学习:

- 与小组成员共同完成项目
- 实时看到队友的编辑
- 互相学习代码技巧
- 分组讨论,协同编程

提交作业:

1. 完成作业项目
2. 运行测试确保正确
3. 老师可在空间中查看作业并批注
4. 根据反馈修改完善

🎓 场景二:编程竞赛/黑客松

适用场景: 算法竞赛、黑客松活动、编程比赛

组织者端功能

1. 创建竞赛空间

空间名称:"2026 全国大学生网页设计大赛"
分组设置:
- 参赛队伍 A
- 参赛队伍 B
- 参赛队伍 C
...

2. 创建参赛队伍分组

每个队伍作为一个分组:
- 队伍 A 组:3 名队员
- 队伍 B 组:3 名队员
- 队伍 C 组:3 名队员

3. 发布竞赛题目

1. 创建题目文件夹
2. 为每个题目创建项目:
   - 题目 1:快速排序实现
   - 题目 2:最短路径算法
   - 题目 3:背包问题

4. 分配题目权限

策略选择:
- 所有队伍共享题目(查看者权限)
- 或题目独立(各队伍编辑者权限)
- 或按阶段开放权限

5. 实时监控比赛进度

查看功能:
- 各队伍代码编写进度
- 实时看到学生代码
- 提供技术支持

参赛者体验

组队协作:

1. 队员登录各自账号
2. 加入同一队伍分组
3. 访问竞赛题目项目
4. 多人同时编写代码

🎓 场景三:在线辅导/私教课

适用场景: 一对一辅导、小班教学、远程指导

老师端功能:

1. 创建教学空间

空间名称:"小明 TypeScript 辅导"
子用户:小明(学生)
权限:学生为编辑者

2. 创建练习项目

项目示例:
- TypeScript 基础练习
- 爬虫项目练习
- 数据分析练习

3. 实时协作教学

1. 同时打开项目
2. 老师实时指导
3. 学生边听边写
4. 即时反馈和修改

4. 作业布置与批改

1. 创建作业项目
2. 学生独立完成
3. 老师查看代码
4. 标注问题并提供建议
5. 学生根据反馈修改

🤝 场景四:小组作业/团队作业

适用场景: 学校小组作业、培训机构团队练习、学习小组

小组长功能

1. 创建小组空间

空间名称:"小组作业 - 天气应用"
成员:
- 组长(管理员)
- 组员 1(编辑者)
- 组员 2(编辑者)
- 组员 3(编辑者)

2. 组织项目协作

1. 创建项目"天气应用"
2. 分配任务:
   - 组员 1:UI 设计
   - 组员 2:API 接口
   - 组员 3:逻辑实现
3. 实时监控进度

组员体验

协作开发:

1. 登录账号加入小组
2. 访问项目空间
3. 与组员实时协作
4. 看到每个人的进度
5. 互相帮助解决问题

感谢您使用笔 COOL 协作空间!祝教学/协作愉快! 🚀