palace-diagram

Palace Diagram

从知识图谱生成 Mermaid 和 ASCII 图表，展示宫殿结构、实体关系、突触连接和层级分配。

状态：已接入。通过 /palace diagram <palace-id> [--type map|ascii|entity|heatmap] 调用，它会使用 Skill(memory-palace:palace-diagram)。渲染器位于 memory_palace.palace_renderer.PalaceRenderer；如需直接通过程序访问，请参阅下方的用法 部分。

适用场景

• 创建或迁移后检查宫殿结构
• 了解知识拓扑和连接
• 识别强弱突触（热力图）
• 查看实体关系和三元组
• 获取可内嵌显示的 ASCII 概览

不适用场景

• 创建宫殿：使用 memory-palace-architect
• 搜索知识：使用 knowledge-locator
• 代码架构图：使用 cartograph

图表类型

类型	格式	描述
宫殿地图	Mermaid 流程图	房间作为子图，实体作为节点，突触作为边
实体图	Mermaid 流程图	单个实体的连接和三元组
突触热力图	Mermaid 流程图	按强度设置边的样式（粗线＝强，点线＝弱）
ASCII 概览	文本	使用框线字符绘制宫殿布局，并显示实体数量

工作流

1. 识别宫殿：按 ID 或名称识别
2. 选择图表类型：根据要查看的内容选择
3. 生成图表：使用 PalaceRenderer
4. 渲染：通过 Mermaid Chart MCP 渲染（Mermaid 图），或直接内嵌显示（ASCII 图）

用法

宫殿地图

from memory_palace.knowledge_graph import KnowledgeGraph
from memory_palace.palace_renderer import PalaceRenderer

graph = KnowledgeGraph("path/to/knowledge_graph.db")
renderer = PalaceRenderer(graph)
mermaid = renderer.palace_map("palace_id")

然后使用生成的 Mermaid 字符串调用 mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram。

ASCII 概览

ascii_art = renderer.ascii_overview("palace_id")
print(ascii_art)

实体图

mermaid = renderer.entity_graph("entity_id")

突触热力图

mermaid = renderer.synapse_heatmap("palace_id")

边样式

强度	样式	含义
>= 0.7	==>（粗线）	强连接
>= 0.4	-->（普通）	中等连接
< 0.4	-.->（点线）	弱连接

集成

适用于：

• memory-palace-architect：宫殿创建后进行可视化
• knowledge-locator：将搜索结果显示为图
• graph-analyzer：根据层级调整节点大小

完成标准

• 使用 PalaceRenderer 生成四种图表类型（宫殿地图、实体图、突触热力图、ASCII 概览）中的至少一种，且未出现 Python 异常
• 将 Mermaid 图表传递给 mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram，并成功渲染
• ASCII 概览使用框线字符显示房间及每个房间中的实体数量
• 突触边样式符合强度阈值：强度 ≥ 0.7 时使用 ==>，≥ 0.4 时使用 -->，< 0.4 时使用 -.->
• 如果知识图谱中不存在所请求的宫殿 ID，则报告错误并指出已搜索的宫殿 ID