claude-share 房间面板 /room 完全手册:Timeline、Changes 与旁路 Chat 一次讲清
claude-share 房间面板 /room 完全手册:Timeline、Changes 与旁路 Chat 一次讲清
claude-share 是一个为 Claude Code 提供多人协作会话的开源插件:你只需分享一条链接,队友就能在自己的 Claude Code 里加入同一个会话,实时看到相同的回复、工具调用和预览。当多人挤进一个会话后,"谁问了什么、改了什么、聊了什么"就变得难以为继——这正是房间面板 /room 要解决的问题。本文带你把 Room 面板里的 Timeline、Changes 与旁路 Chat 三个核心页面一次讲清。
如何打开 /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 轮的"谁 + 内容 + 耗时"。
三种交互姿势
- 悬停:把指针放在某根色条上,读取该轮提问者的名字与完整 prompt(截断至 200 字符);
- 点击 / Enter:直接滚动主转录到对应的 prompt 位置;
- ← / → 方向键:逐轮漫游,
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。
