ttrpg-tools/src/doc-entries/journal-player.md

tag	icon	title	description	syntax	props
journal-player	🎲	玩家指南	作为玩家加入 GM 的会话，查看消息、提交表单、参与互动。	通过 GM 发送的邀请链接加入	name type desc 加入方式 — 点击邀请链接自动加入，或手动输入名字和角色 name type desc 查看消息 — 实时查看 GM 和其他玩家的消息 name type desc 提交表单 — 填写 GM 发送的动态表单并提交

加入会话

有两种方式加入 GM 的会话：

通过邀请链接（推荐）

GM 会发送一个包含 ?session=xxx&player=你的名字&autojoin=1 的链接。 点击链接即可自动加入，无需手动输入任何信息。

手动加入

1. 点击顶部导航栏的 📋 按钮打开 Journal 面板
2. 输入你的名字
3. 选择"玩家"角色
4. 点击"加入"

查看消息

连接成功后，你可以在面板中看到：

• GM 发送的叙述消息
• 掷骰结果
• 其他玩家的消息
• 动态表单

消息实时更新，无需刷新页面。

填写表单

当 GM 发送动态表单时：

1. 表单会显示在消息流中
2. 根据表单类型填写（文本、选择、复选框等）
3. 点击提交按钮发送你的回答

GM 可以看到所有玩家的提交结果。

角色标识

• 你的名字旁会显示蓝色"player"标签
• 观察者显示灰色"observer"标签
• GM 不显示角色标签

注意事项

• 玩家无法创建或切换会话
• 玩家无法撤回消息
• 断开连接后重新加入会保留之前的消息记录