使用手冊 › Slima MCP › slima-mcp 版本怎麼運作

slima-mcp 版本怎麼運作

最後更新 2026 年 9 月 9 日 · 閱讀約 7 分鐘

一句話：這篇說明 slima-mcp 的版號是怎麼運作的——伺服器不會擋舊版，舊版只是少一些工具可以呼叫，以及怎麼確認你在跑哪一版。

現在的版本

slima-mcp 0.3.0，2026-09-09 發布。上一版 0.2.0 是 2026-04-24，中間隔了四個多月，所以「差一個小版號」在這裡其實是差很多。

0.2.0 有的是書本、檔案與 Beta Reader 那三組工具。0.3.0 補上的是：

結構化編輯工具（update_beat_board / update_timeline / update_script / update_relationship_map / update_world_map）
教學那一組（get_capabilities / list_guides / load_guide / list_writing_skills / load_writing_skill）
筆記與評論、semantic_search
view_relationship_map
get_reader_test（收一份等太久、還沒寫完的 Beta Reader 報告）

伺服器怎麼看你的版本

每一次呼叫，client 都會在 User-Agent 裡帶上自己的版號。伺服器拿它跟兩個門檻比：

門檻	現在是	意思
建議版本	0.3.0	低於這個會被提醒升級，但照樣能用
硬性下限	0.1.0	低於這個才會被擋。這條線留給安全性或破壞性變更

所以伺服器不會因為你版本舊就拒絕服務。舊 client 的工具照樣呼叫得動，它只是少了幾支工具可以呼叫——伺服器沒有藏東西，是那些工具在你手上那份套件裡根本不存在。

版本偏舊的時候有兩個訊號：

每一個回應都會多一個 X-Slima-MCP-Upgrade-Hint 標頭，寫著目前建議的版本與你的版本
錯誤訊息會多接一段升級說明

0.3.0 這一版為什麼值得升

4.0 的伺服器對 .map、.beats、.timeline、.script、.geomap 關掉了整檔寫入，而 0.2.0 沒有那些 update_* 工具。兩條路同時不通 ⇒ 跑 0.2.0 的外部 AI 完全改不動這五種檔。

難處在於，使用者看到的不是「請升級」，而是工具一直失敗。所以這一次的升級提示不只是建議，它是在解釋為什麼突然改不動了。

怎麼知道自己在跑哪一版

用 claude.ai、ChatGPT 這類網頁連接器：不必查，也不必做任何事。遠端伺服器一直是最新的，下一次對話就是新版。

本機（Claude Desktop、Cursor、Gemini CLI、VS Code）：

# 你實際會跑到的那一版
npx -y slima-mcp@0 --version

# npm 上最新是哪一版
npm view slima-mcp version

# 有沒有殘留的全域安裝（這是最常見的元凶）
npm ls -g slima-mcp

前兩個數字不一樣，就是有東西把你釘在舊版。

怎麼升

用 npx 的設定：先把全域安裝清掉，再重開 client。

npm uninstall -g slima-mcp

這一步不是整理環境，是必要步驟。npx pkg@<範圍> 會拿 PATH 上現成的套件來滿足這個範圍，根本不去問 npm。2026-09-09 實測（全域是 0.2.0、npm 上是 0.3.0）：

指令	實際跑到
`npx -y slima-mcp@0`	0.2.0 — 用了全域那份
`npx -y slima-mcp`	0.2.0 — 一樣
`npx -y slima-mcp@latest`	0.3.0 — dist-tag 會強迫去問 registry
`npx -y [email protected]`	0.3.0 — 全域那份滿足不了指定的新版號

所以留著舊的全域安裝，會讓 npx 那個寫法永遠停在舊版，而伺服器會一直提醒你升級。

⚠️ 每一個可能裝過的地方都要查。全域安裝會跟著 Node 版本管理環境、也跟著作業系統各存一份——WSL 上很常見的情況是 nvm 底下一份、Windows 的 AppData/Roaming/npm 底下又一份，版號不同，而只有其中一份在你的 MCP client 真正用到的 PATH 上。

要繼續用全域安裝：那就自己記得定期跑一次。

npm install -g slima-mcp@latest

為什麼設定裡寫 `@0` 而不是 `@latest`

那是另一個題目，跟主版號的破壞性變更有關：為什麼用 slima-mcp@0。從全域安裝搬到 npx 的完整步驟在從全域安裝遷移。