session-palace-builder

会话宫殿构建器

为长时间对话和复杂项目构建临时的、特定于会话的记忆宫殿。在对话中断时保留上下文，并支持有条理地积累信息。

简介

会话宫殿是轻量级的临时记忆结构，能够：

• 为长时间对话保留上下文
• 记录决策及其理由
• 以空间化方式组织项目产物
• 在对话中断后恢复上下文
• 支持协作收集信息

快速开始

构建命令

```bash

运行构建

make build

清理并重新构建

make clean && make build ```

测试

```bash

运行测试

make test

运行测试并显示详细输出

make test VERBOSE=1 ```

**验证：**运行 make test，确认插件门禁通过。

适用场景

• 需要保留上下文的长时间对话
• 包含相互关联组件的复杂多步骤项目
• 需要在多次交互间管理状态的工作流
• 随时间积累信息的协作会话
• 包含大量发现的代码审查或调试会话

不适用场景

• 需要永久性知识结构
  • 使用 memory-palace-architect
• 搜索现有知识
  • 使用 knowledge-locator
• 需要永久性知识结构
  • 使用 memory-palace-architect
• 搜索现有知识
  • 使用 knowledge-locator

会话宫殿模板

模板	用途	主要区域
工作坊	活跃开发	工作台、工具、材料
图书馆	研究与分析	书架、阅览室、档案室
议事厅	决策	圆桌、证据墙、投票板
天文台	探索与发现	望远镜、星图、日志
锻造室	实施任务	铁砧、冷却架、成品

信息类别

将会话内容整理到以下标准区域：

• 对话 - 对话串和关键交流
• 决策 - 已做出的选择及其理由
• 代码 - 代码片段和技术产物
• 研究 - 发现和参考资料
• 需求 - 规格和约束
• 进度 - 已完成的里程碑
• 问题 - 阻碍和挑战
• 后续步骤 - 待处理事项

核心工作流

1. 分析上下文 - 评估会话范围和复杂程度
2. 设计宫殿 - 选择模板和布局
3. 组织状态 - 以空间化方式整理信息
4. 构建导航 - 创建快捷访问方式
5. 测试集成 - 验证上下文保留情况

会话生命周期

Create → Populate → Navigate → Export/Archive
   ↑         ↓          ↓
   └─── Checkpoint ←────┘

**验证：**运行带有 --help 标志的命令，以确认其可用性。

清晰度检查点

会话宫殿会悄然退化：每个 Populate 步骤都可能增加歧义，直到 Export 时才显现，而那时已无法恢复丢失的状态。MMPO（arXiv:2605.30159，第 3 节）将此视为采用子轨迹密集奖励的理由：在每次状态转换时检查中间质量，而不只是关注最终结果。

在上述生命周期中的每个 Checkpoint 箭头处（以及任何 Export/Archive 之前），针对当前宫殿状态运行双探针检查：

Skill(memory-palace:memory-clarity-probe)

探针会返回一份 Clarity Assessment，其中包含进度/差距判定和一项 Recommendation：

建议	检查点处的操作
Proceed	宫殿状态清晰；继续会话
Expand memory	继续之前，将差距探针的未解决事项添加到宫殿中
Regenerate	将会话标记为有歧义：进度探针给出了不确定的回答，因此在更多工作落到当前状态房间之前，重建该房间

关键在于在检查点而非导出时标记：及早发现有歧义的宫殿，只需重建一个房间；到导出时才发现，则会损失整个会话。

如果未安装 memory-clarity-probe，请直接提出两个锚定问题（进度：已完成什么，任务处于什么状态；差距：还剩哪些具体事项），并应用同一张表。

详细资源

• 模板详情：参见 modules/templates.md
• 状态管理：参见 modules/templates.md
• 导出模式：参见 modules/templates.md

集成

• memory-palace-architect - 将重要概念导出到永久宫殿
• knowledge-locator - 搜索会话内容
• digital-garden-cultivator - 用会话洞见播种花园
• memory-clarity-probe - 在会话检查点进行双探针清晰度检查

退出标准

• 在填充任何状态之前，先使用模板和空间布局创建会话宫殿
• 在每次 Checkpoint 状态转换处以及 Export/Archive 之前运行双探针清晰度检查，而不只是会话结束时
• 对返回 Expand memory 或 Regenerate 的检查点采取相应操作（添加差距事项或重建当前状态房间），再让更多工作落到该状态上，并标记有歧义的会话
• 导出的概念通过 memory-palace-architect 往返写入永久宫殿