MCP 對每種檔案能做什麼

一句話：這篇是完整對照表——MCP 對每一種副檔名能讀、能寫、只能走欄位級工具，還是完全不能碰。

軸線換了

這篇以前是在比「寫作工作室的書」跟「劇本工作室的書」。4.0 起那個問法不成立了：只有一個寫作工作室，劇本是檔案樹裡的 .script 檔，一集一檔。

決定 MCP 能做什麼的，不再是書屬於哪個工作室，而是你要動的那個檔是什麼型別。

完整對照

副檔名	讀	整檔寫（write_file / edit_file / append_to_file）	怎麼改
.md .markdown .txt	✅	✅	直接寫
.map 關係圖	✅	❌	update_relationship_map
.beats 節拍看板	✅	❌	update_beat_board
.timeline 年表	✅	❌	update_timeline
.script 劇本	✅	❌	update_script
.geomap 世界地圖	✅	❌	update_world_map
.character .location	✅	❌	沒有 AI 路徑
.json .yaml .yml	✅	❌	沒有 AI 路徑
.png .jpg .jpeg .gif .pdf	✅	❌	沒有 AI 路徑
其他副檔名（.csv、沒有副檔名⋯）	✅	✅	直接寫

最後那一列是刻意的：作者會在書裡放各種參考檔，為了保護沒人結構化過的型別而擋掉它們，等於為了防範而弄壞真實的工作。

權威答案是 get_capabilities，不是這張表。它回的是這台伺服器實際執行的那份契約，見指南與寫作技能。

三種型別，三種行為

散文檔（.md / .markdown / .txt）：read_file、edit_file、write_file、create_file、append_to_file、delete_file 全部可用。實務上優先用 edit_file——作者可能正在改同一個檔，而一次找不到錨點的編輯會明確失敗，整檔覆寫則會安靜地蓋掉他剛打的字。

五種結構化檔：write_file、edit_file、append_to_file 一律被拒，改走一次一個操作的欄位級工具。兩個例外要記住：create_file 建得出來（但你送的內容會被忽略，伺服器產一份空骨架），delete_file 也刪得掉（刪除不看型別政策，只看方案）。寫入與刪除都屬於訂閱方案。詳見結構化編輯工具。

完全不可寫的：.character 與 .location 由 Slima 自己的編輯器擁有格式；.json / .yaml 是設定與資料；媒體檔不用解釋。讀得到，寫不了，也沒有欄位級的替代路徑。

字數怎麼算

這件事跟型別綁在一起，值得單獨講一句：

• .md / .markdown / .txt：照散文算字
• .script：算場景裡的字，而且會進作者的每日字數與連勝
• .map / .beats / .timeline / .geomap：一律算 0

所以 AI 幫作者整理一張關係圖，不會在他的字數上留下假的成績。

不分型別的工具

有一整組工具是對「書」而不是對「檔」的，不受上面那張表影響：list_books、get_book、get_book_structure、get_writing_stats、search_content、semantic_search、筆記、評論，以及教學那一組。

其中有幾支在某些檔案上行為不同，見哪些工具在特定檔案上會不一樣。

create_book 只建寫作的書

MCP 建出來的一律是寫作工作室的書。舊的劇本工作室不再開新作品，所以那邊本來也沒有新書可建；4.0 要寫劇本是在書裡按右鍵「新增劇本」，開出一個 .script 檔。

如果你手上還有一本舊的劇本工作室書

舊書打得開，也還能用 MCP 讀。但它走的是另一套規則——那套規則跟上面的檔型表無關，是按路徑判斷的：

動作	舊的劇本工作室書
讀任何檔案	✅ 包含 series.json、*.character、*.scene
寫／改／刪	⚠️ 只能在 .script_studio/planning/ 底下
結構化檔案（series.json、season.json、episode.json、*.character、*.location、*.scene、*.storyline、*.note）	❌ 透過 MCP 唯讀
.script_studio/planning/.initialized	❌ 唯讀（前端的初始化標記）
search_content	⚠️ 預設排除上面那些結構化檔案，要加 include_structured: true
analyze_chapter	❌ 整本書不支援

寫到允許範圍外會拿到 400 INVALID_PATH。單一本書的精確規則可以直接問：讀 slima://books/{book_token}/schema 這個資源，見用 schema resource 查精確權限。

get_book 對這種書會自己印出一段寫入限制說明，所以動手之前先叫 AI 呼叫它，是最快的確認方式。

相關

• Docs：結構化編輯工具
• Docs：結構化檔案的保護
• Docs：哪些工具在特定檔案上會不一樣
• Docs：檔案操作工具
• Docs：用 schema resource 查精確權限
• Docs：稿件與參考資料