memory-palace

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

🏛️ Memory Palace Skill

🏛️ 记忆宫殿技能

"The filesystem is the mind. Directories are rooms. Files are objects."
The ancient method of loci, adapted for LLMs navigating filesystems.
"文件系统即思维。目录即房间。文件即物品。"
适配LLM文件系统导航的古老位置记忆法(method of loci)。

The Technique

使用技巧

Place knowledge in locations. Navigate to remember.
Each room contains:
  • Objects (files) — artifacts to examine
  • Exits (links) — doors to other rooms
  • Atmosphere — the room's essence
将知识放置在特定位置。通过导航实现记忆
每个房间包含:
  • 物品 (文件) —— 可供查阅的内容产物
  • 出口 (链接) —— 通往其他房间的门
  • 氛围 —— 房间的核心特质

This IS the Room Skill

这就是Room Skill

Memory Palace and Room are deeply connected:
Memory PalaceRoom Skill
LocationDirectory
ObjectFile
TraversalEnter/Exit
PlacementCreate file
RecallNavigate to
Memory Palace = Room + spatial mnemonic intent
记忆宫殿与Room深度关联:
记忆宫殿Room Skill
位置目录
物品文件
遍历进入/退出
放置创建文件
回忆导航至
记忆宫殿 = Room + 空间记忆意图

Palace Structure

宫殿结构

palace/
├── ENTRY.md          # Front door (README)
├── MAP.yml           # Navigation overview
├── concepts/         # Wing: Ideas
│   ├── ROOM.md
│   ├── yaml-jazz/
│   └── play-learn-lift/
├── characters/       # Wing: Personas
│   ├── ROOM.md
│   ├── gardener/
│   └── archivist/
└── skills/           # Wing: Capabilities
    ├── ROOM.md
    └── ...
palace/
├── ENTRY.md          # Front door (README)
├── MAP.yml           # Navigation overview
├── concepts/         # Wing: Ideas
│   ├── ROOM.md
│   ├── yaml-jazz/
│   └── play-learn-lift/
├── characters/       # Wing: Personas
│   ├── ROOM.md
│   ├── gardener/
│   └── archivist/
└── skills/           # Wing: Capabilities
    ├── ROOM.md
    └── ...

Placing Knowledge

知识放置

To remember something:
  1. Choose a room — where does this belong?
  2. Create a file — the object to place
  3. Link it — connect to related objects
  4. Walk there — navigate to reinforce
yaml
undefined
如需记忆某项内容:
  1. 选择房间 —— 该内容归属的位置
  2. 创建文件 —— 要放置的物品
  3. 添加链接 —— 关联相关内容
  4. 导航访问 —— 通过访问强化记忆
yaml
undefined

palace/concepts/yaml-jazz/ROOM.yml

palace/concepts/yaml-jazz/ROOM.yml

room: name: "YAML Jazz Chamber" contains: - "jazz-principles.md" # Core ideas - "examples/" # Sub-room of examples exits: parent: "../" related: "../play-learn-lift/" atmosphere: "improvisational, semantic"
undefined
room: name: "YAML Jazz Chamber" contains: - "jazz-principles.md" # Core ideas - "examples/" # Sub-room of examples exits: parent: "../" related: "../play-learn-lift/" atmosphere: "improvisational, semantic"
undefined

Core Files

核心文件

ENTRY.md

ENTRY.md

The front door to your palace:
markdown
undefined
宫殿的正门:
markdown
undefined

Palace Name

Palace Name

Welcome

Welcome

What this palace contains and why.
What this palace contains and why.

Quick Navigation

Quick Navigation

  • Room A - Description
  • Room B - Description
  • Room A - Description
  • Room B - Description

Recent Activity

Recent Activity

  • Added X to Room A
  • Created new Room C
undefined
  • Added X to Room A
  • Created new Room C
undefined

MAP.yml

MAP.yml

Navigation structure:
yaml
palace:
  name: "Research Palace"
  created: "2025-12-30"
  
rooms:
  - name: "foundations"
    path: "foundations/"
    description: "Core concepts"
    connects_to: ["applications", "history"]
    
  - name: "applications"
    path: "applications/"
    description: "Practical uses"
    connects_to: ["foundations", "examples"]

landmarks:
  - name: "The Big Question"
    location: "foundations/core-question.md"
    importance: "Start here"
导航结构:
yaml
palace:
  name: "Research Palace"
  created: "2025-12-30"
  
rooms:
  - name: "foundations"
    path: "foundations/"
    description: "Core concepts"
    connects_to: ["applications", "history"]
    
  - name: "applications"
    path: "applications/"
    description: "Practical uses"
    connects_to: ["foundations", "examples"]

landmarks:
  - name: "The Big Question"
    location: "foundations/core-question.md"
    importance: "Start here"

ROOM.md (in each room)

ROOM.md (每个房间内)

markdown
undefined
markdown
undefined

Room Name

Room Name

What's Here

What's Here

Description of this room's contents.
Description of this room's contents.

Artifacts

Artifacts

  • artifact-1.md - Description
  • artifact-1.md - Description

Doors

Doors

  • ← Back to Entry
  • → Forward to Next Room
  • ← Back to Entry
  • → Forward to Next Room

Notes

Notes

Observations, questions, TODOs for this room.
undefined
Observations, questions, TODOs for this room.
undefined

Navigation Commands

导航指令

IntentAction
"Enter the palace"Read ENTRY.md
"Look around"ls current directory
"Go to room X"cd to room, read ROOM.md
"Examine artifact"Read the file
"Leave a note"Create/update .meta.yml
"Create new room"mkdir + create ROOM.md
"Check the map"Read MAP.yml
"Where am I?"Note current path
意图操作
"进入宫殿"读取ENTRY.md
"环顾四周"列出当前目录内容
"前往X房间"切换到对应目录, 读取ROOM.md
"查看物品"读取对应文件
"留下笔记"创建/更新.meta.yml
"创建新房间"新建目录 + 创建ROOM.md
"查看地图"读取MAP.yml
"我在哪?"记录当前路径

Lifecycle

生命周期

Create

创建

  • mkdir palace root
  • create ENTRY.md
  • create MAP.yml
  • create initial rooms
  • 新建宫殿根目录
  • 创建ENTRY.md
  • 创建MAP.yml
  • 创建初始房间

Expand

拓展

  • create new room directory
  • add ROOM.md
  • update MAP.yml
  • link from related rooms
  • 新建房间目录
  • 添加ROOM.md
  • 更新MAP.yml
  • 从相关房间添加链接

Maintain

维护

  • update MAP.yml periodically
  • add cross-references
  • archive stale rooms
  • create summaries
  • 定期更新MAP.yml
  • 添加交叉引用
  • 归档过时房间
  • 生成摘要

Archive

归档

  • move to attic/
  • note in MAP.yml
  • update links
  • 移动到attic/目录
  • 在MAP.yml中标记
  • 更新链接

Tips

小贴士

  1. Start small — Begin with 3-5 rooms, expand as needed
  2. Name meaningfully — Directory names are addresses
  3. Link generously — Cross-references aid recall
  4. Leave breadcrumbs — Update .meta.yml as you explore
  5. Maintain the map — MAP.yml is your table of contents
  6. Archive, don't delete — Move stale rooms to attic/
  1. 从小起步 —— 从3-5个房间开始, 按需拓展
  2. 命名有意义 —— 目录名就是地址
  3. 多添加链接 —— 交叉引用有助于回忆
  4. 留下面包屑 —— 探索时更新.meta.yml
  5. 维护地图 —— MAP.yml就是你的目录表
  6. 归档不删除 —— 把过时房间移动到attic/目录

Integration

集成

SkillRelationship
roomMemory Palace IS Room + spatial mnemonic intent
adventureAdventure IS Room + narrative quest framing
cardObjects placed in rooms can be cards
soul-chatPalace rooms can speak, guide visitors
summarizeCompress palace knowledge for context
技能关联关系
room记忆宫殿 = Room + 空间记忆意图
adventureAdventure = Room + 叙事任务框架
card房间内放置的物品可以是卡片
soul-chat宫殿房间可以发声, 引导访客
summarize压缩宫殿知识用作上下文