前言¶
星露谷模組 Blind Whale Farmer 在本機開 MCP 服務,把畫面轉成文字狀態,再靠工具調用讓模型種田、出貨、睡覺。若只在 profile 裏全局掛 MCP 客戶端,每個 DSH 會話都會塞進四十多個遊戲工具和長說明,普通聊天、寫代碼的上下文會被佔滿。DeepSeek Harness 按會話預設和插件拆分能力;dsh-stardew-blind-whale-farmer 負責把遊玩上限、攻略、連接方式收進插件配置頁,並和模組 config.json 雙向同步。下面介紹它解決什麼問題、怎麼裝、怎麼用。
這是什麼¶
dsh-stardew-blind-whale-farmer(npm 包名,當前版本 0.5.0,MIT)是維護者 Darianliu23 爲 大肥魚種白飯 Blind Whale Farmer 寫的 DSH 插件。它不能單獨代替遊戲模組:你需要先用 SMAPI 安裝倉庫裏的 BlindWhaleFarmer 模組,遊戲運行後纔會在本機 http://127.0.0.1:18080/mcp 暴露 MCP(端口可在模組 config.json 的 McpPort 修改)。插件做的是在 DSH 側連上這條 MCP、可選註冊「大肥魚種白飯」會話預設或精簡入口工具,並把你在 DSH 裏改的遊玩參數與攻略推回遊戲。
SkillHub 目錄分類爲工作流;GitHub 倉庫見 Darianliu23/dsh-stardew-blind-whale-farmer。
核心功能¶
配置同步¶
插件約每 15 秒向模組 /settings 詢問當前設置版本;與 DSH 側不一致時推送。改完配置點保存,十幾秒內生效,無需重啓遊戲;模組也會寫回 Mods/BlindWhaleFarmer/config.json,不開 DSH 時仍按文件生效。遊戲未啓動時不推送,啓動後自動補推。
可在 DSH 左側邊欄「插件」→ dsh-stardew-blind-whale-farmer → 組件名旁「配置 ›」調整(分組爲遊玩 / 攻略 / 會話與連接),包括但不限於:
| 設置 | 默認 | 說明 |
|---|---|---|
| 每次玩幾個遊戲日 | 0(不限) | 睡一覺算一天,到上限後遊戲動作被拒絕,AI 停下彙報 |
| 每次玩多少分鐘 | 0(不限) | 現實分鐘,到上限先回家睡覺存檔再停 |
| 思考時凍結時間 | 開 | 與模組 McpFreezeTime 對應 |
| 空閒多少秒算不玩了 | 120 | 對應 McpIdleSeconds |
| 順手採集範圍 | 1 | 對應 ForageRadius |
| 額外要求 | 空 | 對應 ExtraInstructions |
| 攻略文件 | guide/攻略.md |
相對 Mods/BlindWhaleFarmer |
| 攻略·攻略 / 釣魚 / 採礦 / 節日 | 模組自帶 | 文本框修改會優先於磁盤文件推給遊戲 |
| 端口 | 18080 | 與 McpPort 一致 |
兩種接入會話的方式(默認均關閉)¶
「大肥魚種白飯」會話預設:打開後註冊預設(默認名「大肥魚種白飯」,基礎預設 standard)。只有新建會話並在發第一條消息前選中該預設的會話纔會加載 get_state 等全套工具與規則;其他會話不佔星露谷上下文。已開聊的會話不能換預設(DSH 會報 agent-preset/locked),要玩請新建會話。長期筆記由模組 AI 寫入,會出現在 get_state 開頭,新會話可接續。
stardew 入口工具:在所有會話(含老會話)只多一個 stardew 工具。AI 先 {"action":"help"} 再按需 {"action":"動作名","args":{...}};攻略用 {"action":"get_guide"}。與預設可同時開啓;專門開會話玩時預設體驗更完整。
模型壞回覆自動續玩¶
默認開啓:若本輪調用過星露谷工具、最後一條回覆是未解析成功的壞工具調用、且會話正常結束,空閒後會自動發「接着玩」(agent.followup)。連續自動續玩默認最多 3 次,中間有一次遊戲動作成功則重新計數。
依賴與實現¶
插件通過 cordis.patch.yml 注入 DSH,配置 UI 來自自帶的 lib/client.js(非 DSH 自動生成表單)。依賴 @deepseek-ai/schemastery(package.json 中爲 3.18.4)。修改 lib/index.js 裏 Config 後需運行 npm run build:client regenerate 配置卡片。
安裝與啓用¶
前置:遊戲模組¶
DSH 插件不包含 SMAPI 模組本體。按 Blind Whale Farmer 倉庫 README 安裝 SMAPI 與 BlindWhaleFarmer(Release 解壓到 Mods,或 Windows 下 build.ps1 / install.ps1)。內置 DeepSeek 玩法需在模組 config.json 填 ApiKey 或設環境變量 DEEPSEEK_API_KEY;僅用 DSH + 本插件時,消耗的是 DSH 所用模型的額度,不必在模組裏寫 DeepSeek Key。
安裝 DSH 插件¶
DSH 桌面版與網頁版使用不同 profile(<DSH_HOME>/profiles/desktop 與 profiles/web),每個要用的 profile 各裝一次。
在 DSH 插件頁面使用官方給出的標識安裝(只會裝 lib/、cordis.patch.yml 等,不會把模組源碼裝進 DSH):
github:Darianliu23/dsh-stardew-blind-whale-farmer
裝好或升級插件後重啓一次 DSH,配置入口才會出現。文檔明確建議:不要再在 profile 的 cordis.patch.yml 裏全局掛 @deepseek-ai/dsh-mcp-client 連星露谷,否則每個會話都會帶上游戲工具。
本地 link 開發安裝步驟見倉庫 docs/dsh-plugin.md。
典型用法¶
- SMAPI 啓動星露谷並讀檔(建議備份或新檔;AI 睡覺會存檔)。SMAPI 控制台應出現 MCP 已啓動(默認
http://127.0.0.1:18080/mcp)。若窗口失焦會暫停,需在設置裏關閉「窗口不活動時暫停」以便後臺跑。 - 在 DSH 插件配置裏打開「大肥魚種白飯」預設或「stardew 入口工具」,保存並等待同步到模組。
- 預設方式:新建會話,在第一條消息前選擇「大肥魚種白飯」,然後例如讓 AI 先
get_state,再安排當日農活與睡覺。 - 入口工具方式:在已有會話中讓 AI 調用
stardew,例如先{"action":"help"},再轉發具體動作。 - 遊戲中 F7 可接管 / 交還 AI;內置 F8 AI 與 MCP 客戶端不能同時操作(內置 AI 運行時 MCP 會提示先停 F8)。長動作(釣魚、下礦)單次最長約 15 分鐘,插件側單個動作最長等待默認 16 分鐘。
模組側調試命令(SMAPI 控制台)包括 dsai_state(只看文字狀態、不調 API)、dsai_do 手動執行工具等;完整行動記錄在 Mods/BlindWhaleFarmer/logs/transcript-*.log。
適用場景與注意¶
適合誰:已經在用 Blind Whale Farmer、希望用 DSH 統一模型與額度、並要把「玩幾遊戲日 / 幾分鐘、攻略、凍結時間」集中在 DSH 裏改的人;也適合不想換預設、只在某個老會話裏偶爾用 stardew 入口玩一局的人。
權限與安全:插件隨當前 DSH 進程權限運行,會向本機遊戲端口發 HTTP;安裝前請閱讀倉庫源碼與 MIT 許可證,自行評估是否信任維護者與網絡暴露面(MCP 僅監聽 127.0.0.1)。
生態說明:DeepSeek Harness 社區插件目錄在 SkillHub,與 DeepSeek / 幻方無官方從屬關係。
限制(來自模組 README,插件不消除這些):例如戰鬥策略較樸素、傳說魚低等級成功率低、內置 AI 與 MCP 互斥等;費用上內置 DeepSeek 每步約 10k~14k 輸入 token 量級,以官網定價與 dsai_tokens 爲準。
結尾¶
dsh-stardew-blind-whale-farmer 把星露谷 blind-whale 模組的 MCP 玩法收進 DSH 插件模型:配置可推送、會話可隔離、可選自動續玩。目錄頁:SkillHub 插件頁;源碼與模組說明:GitHub 倉庫。