claude-share 房间面板 /room 完全手册:Timeline、Changes 与旁路 Chat 一次讲清

原创2026-10-31 12:02:441,737 阅读

claude-share 房间面板 /room 完全手册:Timeline、Changes 与旁路 Chat 一次讲清

claude-share 是一个为 Claude Code 提供多人协作会话的开源插件:你只需分享一条链接,队友就能在自己的 Claude Code 里加入同一个会话,实时看到相同的回复、工具调用和预览。当多人挤进一个会话后,"谁问了什么、改了什么、聊了什么"就变得难以为继——这正是房间面板 /room 要解决的问题。本文带你把 Room 面板里的 Timeline、Changes 与旁路 Chat 三个核心页面一次讲清。

claude-share 房间面板 Shared Sessions 协作会话演示界面

如何打开 /room 房间面板

房间面板是 claude-share 插件内置的"会话中控台",两种打开方式:

  • 桌面端 / 终端按钮:在提示框上方点击 Room;
  • 命令:直接输入 /room。

在终端里它以一个对话框呈现,页面按数字就近切换(1 People、2 Chat、3 Timeline……),Tab 与方向键在页面内移动,Enter 选中,Esc 关闭。页面顶部先展示会话本身(Live 状态、谁在场、分享链接),下面才是各功能页:

页面 作用
People 谁在场、每个人在做什么,以及邀请队友入口
Chat 旁路聊天,Claude 永远读不到这里
Timeline 每个 prompt 一根色条,一眼看全会话节奏
Changes Claude 改过的每个文件 + 完整 diff
Shown Claude 展示给房间的文件、页面和预览
Settings 权限策略与每个人的个性化偏好

每个人在房间里都有专属颜色,头像、名字、聊天消息、Timeline 色条共用同一色,跨页面都能对上号。页面代码位于 plugin/hooks/register.tsx,页面说明详见 docs/guide.md。

Timeline 页面:一眼看懂"谁问了多久"

Timeline 是 Room 面板里最直观的页面,回答三个问题:谁提的、问了什么、花了多久。

色条即历史

  • 每个 prompt 渲染为一根竖条,颜色就是提问者的颜色;
  • 条的高度等于耗时:越长越慢,正在运行的轮次会显示 running;
  • 默认绘制最近 60 个轮次,下方再以文字列出最近 12 轮的"谁 + 内容 + 耗时"。

三种交互姿势

  1. 悬停:把指针放在某根色条上,读取该轮提问者的名字与完整 prompt(截断至 200 字符);
  2. 点击 / Enter:直接滚动主转录到对应的 prompt 位置;
  3. ← / → 方向键:逐轮漫游,Home / End 跳到最早 / 最新一轮。

界面还会贴心标注当前轮是否是"最长一轮",帮你快速定位性能瓶颈。Timeline 的渲染逻辑在 plugin/hooks/timeline.tsx 中,每一根条的高度由耗时取对数缩放而来,因此 3 秒的快轮与 30 分钟的长任务可以同屏共存。

Changes 页面:每个文件的 diff 与"改动归属"

多人会话里最常被追问的是:"这行代码是谁让 Claude 改的?" Changes 页面就是为此而生:

  • 文件列表:Claude 改过的每个文件一行,左侧色条标明"是谁的 prompt 触发了这次修改",右侧显示 +新增 / −删除 行数;
  • 全房间汇总:页面顶部汇总所有文件的总增删行数;
  • 内嵌 diff:点击任一文件,下方即用 Claude Code 引擎自带的语法高亮器打开完整 unified diff,并标注 "for 谁"。

Changes 页只在会话确实产生过文件改动时才出现(没有改动则整页隐藏),diff 解析工具位于 plugin/hooks/room.ts,页面渲染见 plugin/hooks/register.tsx。

💡 协作评审时,建议把 Changes 页面当作"多人 PR 视图":谁的贡献一目了然,diff 直接可看,省去来回翻转录。

旁路 Chat:Claude 永远读不到的房间频道

Chat 页是 claude-share 的一个巧妙设计:一条与主转录完全隔离的旁路聊天。

  • Claude 不参与:输入框提示语就是 Message everyone (Claude doesn't read this)——这里说的每句话都不会进入模型上下文,不会触发任何 turn;
  • 活动流合一:进出房间、批准 / 拒绝工具调用(✓ / ✕)、发起 prompt(❯)等事件与聊天消息按时间线混排,最近 30 条;
  • @提及:在 prompt 或聊天里 @名字 会触发对方的桌面通知与提示音,并把对方的输入框聚焦准备回复;
  • 未读角标:Chat 页签在有未读消息时显示数字与红点提示。

典型用法:让 Claude 跑长任务时,队友们在 Chat 里讨论"接下来测哪个模块",互不干扰主会话,也不会污染上下文。

People 与 Settings:掌控感来自这两页

People 页面:谁在场、谁在忙

  • 列出所有在线 / 离线成员,hover 某位成员可查看其插件版本与身份,并一键 @提及;
  • 实时显示"Claude 正在为谁工作"以及"谁在等待宿主批准工具调用";
  • 底部 This session 统计卡:Turns(轮次数)、Tool calls(工具调用数)、Files changed(改动文件与增删行)、Longest turn(最长一轮耗时),见 plugin/hooks/register.tsx;
  • 宿主在此直接 邀请团队成员进房(/invite <name>),被邀请人会在自己屏幕上弹出让 Join 的卡片。

Settings 页面:宿主规则 + 个人偏好

宿主对全房间生效的策略:

设置项 选项
Teammates can 允许队友向 Claude 提问 / 只能旁观和聊天
Ask me before 除项目内只读外都先问我 / 每个工具都问 / 都不问
What Claude shows 展示内容发给所有人 / 仅宿主自己保留

个人偏好:提示音(提及 / 自己的轮次 / 成员进出)、语音播报、状态行、预览打开方式(Claude 浏览器 / 自己的浏览器 / 独立窗口)、工具调用展示方式(终端中分组折叠或逐条展示)、插件自动更新开关等。

常见问题 FAQ

Q1:为什么 Chat 里说的话 Claude 不知道? Chat 是独立事件流,只发给房间里的"人",不进入 prompt 队列,因此不会消耗任何模型调用——这也是 claude-share 强调的旁路设计。

Q2:Guest(加入者)能编辑文件吗? 能,但所有编辑、命令执行和网络访问默认都会先向宿主发起批准请求,未获批准的调用会被拒绝。Guest 看到的所有工具卡片只是宿主侧结果的"回放",不在本机执行。

Q3:/room 和 /who 有什么区别? /who 是轻量问答,直接在转录里输出一张"谁在场、在做什么"的卡片;/room 打开完整面板,包含本页介绍的全部内容。

结语

/room 把 claude-share 从"能分享"升级为"看得清":Timeline 让你按人按时间复盘会话,Changes 把每次文件改动钉死到具体提问者,Chat 提供一条 Claude 读不到的安全沟通通道。配合 People 的实时状态与 Settings 的权限策略,多人共用一个 Claude Code 会话从此不再是黑箱。更多细节可查阅 docs/guide.md 与 docs/rules/rooms.md。

登录后查看全文
claude-share