讓 AI 看見關係圖

一句話：這篇教你用 view_relationship_map，讓外部 AI 工具真的「看見」你的關係圖，而不是讀一堆節點 id。

這解決什麼問題

.map 是一張畫布。它的原始檔裡是節點 id、像素座標、群組成員清單——對人來說難讀，對 AI 來說也一樣難用。用 read_file 打開一張關係圖，AI 拿到的是一團 JSON，然後它得自己從座標反推「誰畫在誰旁邊」。

view_relationship_map 換一條路：伺服器把圖畫出來，回一張 PNG，外加一段可讀的摘要。

view_relationship_map({
  "book_token": "bk_...",
  "path": "世界觀/人物關係圖.map"
})

摘要永遠在圖前面，這是刻意的

回覆一定先給文字摘要，圖排在後面。原因很實際：有些 MCP 客戶端會把圖片區塊丟掉。 目前有些遠端連接器就會。如果只回一張圖，在那些地方等於回了一個空的回合。

摘要裡有三樣東西：

• 每一個節點——角色、地點、勢力，圖上有的都在
• 每一條關係，寫成一行一句的形式（沈硯 —師徒→ 顧遂）
• 每一個群組框，以及它裡面有誰

所以就算圖沒顯示出來，AI 還是知道這張圖在講什麼。而在會顯示圖片的客戶端裡，它兩樣都拿到：整體佈局用看的，細節用讀的。

四種你會遇到的回覆

回覆	意思	下一步
摘要 ＋ 一張 PNG	正常	—
摘要 ＋ 一句「伺服器這次畫不出圖」	圖沒渲染成功，摘要照常	照摘要繼續做事就好
一句「這是團隊的機密技能檔，內容不對這條連線開放」	團隊設定刻意擋住的	不要想別的辦法讀它，那些路都是關的而且有紀錄
一句「這份團隊技能檔今天的讀取額度用完了」	額度限制，不是檔案空的	晚一點再試

.map 現在可以改了

實務上它跟 update_relationship_map 是一組的：先 view_relationship_map 看懂現在長什麼樣、拿到節點 id，再用 update_relationship_map 動手。詳見結構化編輯工具。

什麼時候別用它

• 要備份或搬到別的地方：那是匯出，在 app 裡做，見匯出與分享關係圖。
• 只想知道有哪些角色：get_book_structure 看 Characters/ 資料夾更快，也不必渲圖。
• .geomap 世界地圖：這支工具只吃 .map。世界地圖用 read_file，它會把三張地形網格換成一句說明。

相關

• Docs：關係圖
• Docs：把關係圖當白板用
• Docs：匯出與分享關係圖
• Docs：結構化編輯工具