需配置协同后端、客户端集成及权限策略：一、部署socket.io服务并配置endpoint；二、集成sharedb与json0实现操作收敛；三、启用agent协同上下文感知；四、设置行/文件级访问控制；五、实现编辑者身份与光标可视化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Qoder中启用团队成员对同一代码文件进行实时在线编辑，需配置协同后端服务、客户端集成及权限策略。以下是实现该功能的设置方法：
一、启用Socket.io实时通信通道
Qoder默认不自动开启实时协同所需的底层长连接服务，必须手动部署并配置Socket.io服务器，以支撑操作广播与光标同步。
1、在项目根目录下新建socket-server.js文件，引入socket.io和http模块。
2、使用Node.js创建HTTP服务器实例，并将Socket.io挂载至该服务器。
3、在connection事件中初始化客户端会话ID与用户身份映射关系。
4、启动服务并监听3001端口，确保该端口未被防火墙或反向代理拦截。
5、在Qoder项目配置文件qoder.config.json中添加"collab": {"endpoint": "http://localhost:3001"}字段。
二、集成ShareDB与JSON0协议
为保障多人并发编辑时操作合并的正确性，Qoder需通过ShareDB接入JSON0 OT协议，替代简易的文本覆盖机制，实现单元格/行级粒度的操作收敛。
1、执行npm install sharedb@3.1.0 json0@0.8.0安装兼容版本依赖。
2、在前端编辑器初始化阶段，调用ShareDB.Connection连接至前述Socket.io服务端点。
3、为每个打开的源码文件创建唯一shareDoc实例，文档ID格式为file:${project_id}:${relative_path}。
4、将Quill或CodeMirror编辑器绑定到shareDoc，启用submitOperation与applyOperation钩子。
5、验证操作日志：任意客户端修改后，其他客户端应于200ms内收到op事件并完成本地更新。
三、配置Qoder Agent模式下的协同上下文感知
Qoder Agent需识别当前编辑会话是否处于多人协作环境，从而动态启用冲突检测、操作历史快照及用户标识渲染等能力。
1、在IDE中打开Qoder侧边栏，点击右上角齿轮图标进入Agent Settings。
2、勾选Enable collaborative context awareness选项。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、在Collaboration Profile中指定团队空间ID（如team-feishu-2026），该ID须与后端ShareDB命名空间一致。
4、设置Presence timeout为60秒，防止离线用户头像长时间滞留界面。
5、保存配置后重启Qoder插件，检查状态栏是否显示? Collab Active标识。
四、设置行级与文件级访问控制策略
为防止越权编辑，需在Qoder Repo Wiki中定义细粒度权限规则，并由后端中间件校验每次submitOperation请求的合法性。
1、进入项目repo-wiki/permissions.md，使用YAML语法声明权限矩阵。
2、为关键源码文件（如src/core/auth.ts）添加write: ["admin", "security-team"]限制。
3、对通用工具函数（如src/utils/string.ts）设置read: ["*"], write: ["dev-team"]。
4、运行qoder rules sync命令，将本地规则推送到Qoder云端策略中心。
5、在Socket.io服务端添加middleware，拦截所有submitOp事件并调用checkPermission(userId, docId, op.type)。
五、启用编辑者身份与光标位置可视化
实时协同体验的关键在于让用户直观感知他人正在编辑的位置，这依赖于前端渲染层对ShareDB广播数据的解析与呈现。
1、在代码编辑器组件中注入CollabCursorLayer插件，支持SVG图层叠加。
2、监听shareDoc的presence事件，获取各客户端发送的{userId, userName, avatarColor, cursorRange}数据。
3、为每位协作者生成唯一颜色标识，avatarColor必须为十六进制RGB值且不重复。
4、将cursorRange转换为编辑器坐标系中的像素位置，绘制带昵称标签的横向光标条。
5、当用户鼠标悬停于他人光标条上方时，显示浮动提示框，内容包括最后活动时间与所处Git分支。
