# 会话日志 > **人类可读的讲故事的降价日志。** 会话日志是捕捉游戏叙述的**动态文档**。与技术事件日志不同，会话是供用户、未来的法学硕士升温背景以及任何想要了解发生了什么的人阅读的。 > [!重要] 会话日志**不是仅附加的！** 它们是随着时间的推移而增长和改进的动态文档。随着新信息的出现，您可以而且应该追溯性地改进它们。 ** ** ## 📍 会议现场默认的会话文件是角色目录中的**`SESSION.md`**：字符/ ├── 真人/唐霍普金斯/ │ ├── 字符.yml │ └── SESSION.md ← 默认会话日志 ├── 虚构/唐娜伞菌/ │ ├── 字符.yml │ └── SESSION.md ← 默认会话日志 └── 动物/猴掌/ ├── 字符.yml └── SESSION.md ← 默认会话日志 ### 命名会话您可以创建多个带有描述性后缀的会话文件：会话文件 |目的 ---|--- `SESSION.md` |默认值 — 主会话日志 `SESSION-day1-exploration.md` |特定日期或主题 `SESSION-fluxx-marathon.md` |命名冒险弧 `SESSION-debug-investigation.md` |调试会话 **命令：** `START SESSION [name]` — 创建带有可选后缀的新会话文件。 ** ** ## 📝 写出好的会话 ### 黄金法则 **会话是供人类阅读的。** 将它们写成故事，而不是日志。 ### 结构与轮廓使用“

”标签创建**可折叠部分**： * 显示需要阅读的叙述（打开） * 隐藏技术数据和调试（已关闭） * 将相关内容分组到逻辑部分 * 允许读者按需深入挖掘 <详情公开>

🌟 章节标题 - 描述性副标题

叙述内容就到这里。这是读者首先看到的。 <详情公开>

📂 技术细节：YAML 的更改是什么样的

````yaml # YAML 数据岛状态改变：文件：./CHARACTER.yml 变化：[地点、库存] ### 轮廓图案图案|何时使用 |状态 ---|---|--- `<详细信息公开>` |叙事章节——始终显示| **开放** `<详细信息公开>` |技术细节——默认隐藏 | **关闭** 嵌套`<详细信息打开>` |叙述中的数据|混合 ### 摘要行 `

` 是叙述的一部分！将其写为标题：

第5回合

文件操作

🌟第5回合：说出愿望——Palm的化身

📂 文件创建：具有 32 个 Mind Mirror 维度的 CHARACTER.yml

### 在节标题中使用表情符号在叙述部分添加表情符号**文件夹图标**之后：表情符号 |含义 ---|--- 📂 |技术/折叠部分 🌟 |重大里程碑 🎭 |角色转变 🗺️ |探索/旅行 💬 |对话/对话 🎰 |游戏/随机性 🐕 🐱 🐵 |动物角色部分 ⚡ |光速模拟 ** ** ## 📊 会话索引 **在每个会话的顶部保留一个索引！** 在追加时追溯更新它。 <详情公开>

⭐ 会议亮点和索引

### 📚 会话索引（内部链接） **第一天——愿望** - [🌿 LOOK AROUND](#-look-around) — 第一印象 - [第 1 回合：与 Marieke 交谈](#turn-1-talk-to-marieke) — 幸运菌株 - [第 7 回合：愿望已说出](#turn-7-the-wish-is-spoken) — 🌟 Palm 的化身 **第 2 天 — Fluxx 马拉松** - [🎰 33 Turns of Gezelligheid](#33-turns-of-gezelligheid) — 光速演示 ### 🏠 关键地点（外部链接） |地点 |描述 | |----------|-------------| | [棕榈角](../../../pub/stage/palm-nook/) |猴子的家| | [酒吧](../../../pub/) |主要地点 | ### 索引规则 1. **内部链接**使用锚语法：`[Title](#anchor-name)` 2. **外部链接**使用相对路径：`[File](../../../path/file.yml)` 3. **追溯更新** — 每次追加都是改进索引的机会 4. **按日/弧分组**——自然的叙事划分 ** ** ## 🔗 慷慨链接 **链接吸引人们进入存储库！**提到的每个文件、角色、房间和技能都应该是一个链接。 ### 链接一切帕姆写了一篇关于成为一只猴子的文章。 [Palm](../../animals/monkey-palm/) 写了一篇文章 ([palm-on-being-palm.md](../../../pub/stage/palm-nook/study/palm-on-being-palm.md)) 关于成为一只猴子。 ### 使用相关文件的表 ### 文件已创建 |文件|描述 | |------|-------------| | [字符.yml](./字符.yml) |灵魂档案| | [外观.yml](./外观.yml) |物理描述| | [→ 完整目录](../../animals/monkey-palm/) |完整人物| ### 相关技能 |技能|目的| |--------|---------| | [化身]($技能/化身/) |角色创建协议 | | [光速]($技能/光速/) |多智能体模拟 | > **YAML 与 Markdown 中的路径变量：** 在 YAML 文件中使用 `$SKILLS/` （运行时解析）。在 Markdown 中使用相对路径进行 GitHub 渲染。 ** ** ## 📈 桌子讲故事表格非常适合： * **总结行动** — 回合、结果、统计数据 * **显示状态** — 库存、关系、位置 * **列出文件** — 创建、编辑、链接的内容 * **角色名单** - 谁在场，他们的状态 ## 目前状态 |人物 |地点 |状态 | |------------|----------|--------| | [唐](../../real-people/don-hopkins/) |酒吧/ |活跃| | [棕榈](../../动物/猴棕榈/) |舞台/棕榈角/ |写作 | | [饼干](../../动物/狗饼干/) |跟随唐 |摆动| ## 会话统计 |公制|价值| |--------|--------| |转 | 33 | 33 |遇到的NPC| 15 | 15 |建立的关系 | 12 | 12 |黄金花费| 31 | ### 折叠大桌子 <详情公开>

📂 完整库存（47 件商品）

|项目 |地点 |价值| |------|----------|--------| | ... | ... | ... | ** ** ## 🔄 追溯改进 **会话是动态文档。** 每次添加时： 1. **更新索引** - 添加新部分，修复锚点 2. **添加缺失的链接** — 文件路径、角色名称 3. **改进摘要** — 使其更具描述性 4. **填写上下文** - 当您了解更多内容时，对前面的部分进行注释 5. **修复损坏的链接** - 路径随着文件移动而改变 ### 忍者编辑鼓励小的追溯改进： * 纠正错别字 * 添加指向新创建文件的链接 * 改进章节摘要 * 更新索引 ** ** ## 📋 YAML 数据岛将结构化数据嵌入到围栏代码块中以实现机器可读性： <详情公开>

📂 状态变化：将玩家从开始/移动到衣帽间/

````yaml 状态改变：文件：./CHARACTER.yml 变化： player.location: "coatroom/" # 是: "start/" 文件：../../../ADVENTURE.yml 变化： player.location: "coatroom/" # 镜像更新 ### 数据岛最佳实践实践|原因 ---|--- 使用 `# comments` |解释为什么，而不仅仅是解释什么缩写长数据|显示结构，而不是一切包含文件路径 |链接到实际文件解释关系 | “镜像更新”、“规范来源” ** ** ## 🆚 会话日志与事件日志会话日志 (SESSION.md) |事件日志 (events.yml) ---|--- **人类可读** |机器可读 **叙事风格** |结构化数据动态文档（可编辑）|仅追加可折叠轮廓| YAML 事件供阅读 |用于调试/审计在角色目录中 |在 `.agent/` 或冒险根目录中 **创建事件日志**： * 技术调试 * 仅附加审计跟踪 * 机器可解析的历史记录 **创建会话日志**： * 面向用户的叙述 * GitHub浏览 * 环境变暖 * 讲故事 ** ** ## 🌟 示例：黄金标准会议这些会议展示了最佳实践： ### 唐·霍普金斯的马拉松比赛 [**examples/adventure-4/characters/real-people/don-hopkins/sessions/marathon-session.md**]() 超过 7000 条线路，跨越 5 天的冒险之旅。演示： * 大量使用可折叠部分 * 综合指数位于顶部 * 大量链接到文件和技能 * 菜单、统计数据和名单表 * 光速模拟成绩单 * 技术细节隐藏在折叠部分 ### 唐娜毒菌的会议 [**examples/adventure-4/characters/fictional/donna-toadstool/SESSION.md**]() 完整的人物塑造叙事。演示： * 包含零件的目录 * 字符转换文档 * 文件操作说明 * 附有技术参考 * 叙述和数据清晰分离 ** ** ## 🎯 快速参考 ### 开始一个新部分 --- <详情公开>

🌟转N：标题-描述性副标题

对发生的事情进行叙述性描述。 <详情公开>

📂 技术：底层发生了什么变化

````yaml 变化： - 文件：路径/to/file.yml 字段：值 ### 每次追加的清单 * 使用新部分更新了顶部索引 * 添加了所有提到的文件的链接 * 将角色名称链接到他们的目录 * 适当使用可折叠部分 * 写出描述性摘要行 * 包含相关表格 * 修复了发现的任何损坏的链接 ** ** ## 缠绕性 Session-log 是 [play-learn-lift]() 的 PLAY 阶段 — 捕获一切。图LR SL[📜 会话日志] -->|PLAY 阶段| PLL[🎮 玩耍-学习-提升] SL -->|曲目| R[🚪房间] SL -->|曲目| TC[🎴卡] SL -->|监控者| SR[🔧自我修复] AP[⚔️冒险]-->|LOG.md是| SL DB[🔧 调试] -->|记录到| SL CH[👤 字符] -->|SESSION.md 是| SL ** ** ## 配合 ### 姐妹技能技能|关系 ---|--- [字符/]() |会话文件位于字符目录中 [冒险/]() | Adventure LOG.md 遵循会话日志模式 [play-learn-lift/]() |会话日志是 PLAY 捕获阶段 [总结/]() |会话日志太长时压缩 [自我修复/]() |监控会话日志完整性 [调试/]() |调试会话记录在此处 ### 协议符号符号|链接 ---|--- `会话日志` | [PROTOCOLS.yml]() “叙事第一” |为人类而写 `链接慷慨` |每个文件都是一个链接 ### 内核 * [kernel/event-logging-protocol.md]() — 技术事件格式 * [schemas/event-schema.yml]() — YAML 块架构 ### 导航方向 |目的地 ---|--- ⬆️ 向上 | [技能/]() ⬆️⬆️根| [项目根目录]() 🎮 姐姐 | [play-learn-lift/]() 👤姐姐| [字符/]()

会话日志

包含技能