檔案操作工具(7 個)
閱讀約 4 分鐘
檔案層級的 7 個 tools——這是 MCP 真正動稿的部分。

1 · read_file
讀一個檔案。
book_token、path(譬如章節/第一章.md)- 回 file content + metadata(type、最後編輯)
2 · edit_file
替換檔案部分內容(pattern-based)。
path、old_text、new_text- 安全的 surgical edit、不會誤動其他段落
這是最常用的工具——AI 改稿用這個。
3 · write_file
完全覆寫整個檔案。
path、content- ⚠️ 整個檔案會被取代
- 用於:完全重寫一個檔案、新檔案的初始內容
4 · create_file
建新檔案。
path、content、type(manuscript / reference)- 失敗如果檔案已存在
5 · delete_file
刪檔案(進該書回收筒、不是永刪)。
path- 30 天內 可從回收筒還原
6 · append_to_file
在檔案末接續寫。
path、content- 適合:「繼續寫第三章」這種對話
7 · search_content
全文搜尋。
book_token、query、scope(chapter / book)- 回每個 match 的 path + 段落 + 行號
權限模型
Writing Studio 的書:所有 7 個工具都可寫任何路徑。
Script Studio 的書:結構化檔案唯讀(*.scene / *.character / series.json 等)。寫只能寫 .script_studio/planning/。
詳見:
自動版本
所有寫的工具(edit_file / write_file / create_file / delete_file / append_to_file)在改之前自動建立版本。
詳見:自動版本規則
相關
這篇有幫助嗎?