MIT 授權的 SMAPI 模組 + DSH 外掛，把星露谷翻譯成文字餵給 DeepSeek —— 53 個工具、工作階段預設、F7 接管和本機 MCP 伺服器，不需要視覺模型。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-13
授權條款
MIT
01它能幫你完成什麼？
讓 DeepSeek Harness 工作階段不靠截圖、不靠視覺模型就能玩星露谷
一份文字化的遊戲觀察（狀態、背包、字元地圖、物件座標、作物、出口、對話與商店內容）供模型推理，模型發出的工具呼叫由模組執行
想讓 agent 用純文字模型真正上手玩一局遊戲的 dsh 使用者
把日常農活交給 agent，一共 53 個工具
移動與跨地圖規劃、耕地播種澆水收成、釣魚、照顧動物、跑鎮上業務、下礦與戰鬥，以及介面與時間類動作
想當監工、不想自己刷前期的玩家
不想燒 DeepSeek token 時，讓別的 MCP 用戶端來驅動同一個存檔
`http://127.0.0.1:18080/mcp` 上的 MCP 端點，WorkBuddy / Claude Code / Cursor 連上後由用戶端自己的模型呼叫模組的工具
已經在用支援 MCP 的用戶端、想把遊戲工具接進去的人
02如何將外掛接入 DeepSeek Harness？
先決條件
- 星露谷裝好 SMAPI 模組載入器 —— README 開發時用的是 SMAPI 4.5.2 + 遊戲 1.6.15
- 一組 DeepSeek API Key（只用 MCP 用戶端驅動模組時不需要）
- 只有從原始碼編譯模組時才需要 .NET 6 或更新的 SDK
安裝步驟
- 01
在 DSH 外掛市場安裝 `dsh-stardew-blind-whale-farmer` —— 外掛自帶編譯好的模組並自動裝進遊戲的 `Mods`（遊戲開著就等關了再裝）；找不到遊戲目錄時在外掛的設定卡片裡填「星露谷目錄」
- 02
另一條路：從 GitHub Releases 下載壓縮檔，把 `BlindWhaleFarmer` 資料夾放進遊戲目錄的 `Mods`；或從原始碼用 `powershell -ExecutionPolicy Bypass -File build.ps1` 編譯、再執行 `install.ps1` 安裝
- 03
把 DeepSeek Key 填進 `Mods\BlindWhaleFarmer\config.json` 的 `ApiKey`，或者改設環境變數 `DEEPSEEK_API_KEY`
- 04
透過 SMAPI 啟動遊戲、讀取存檔，按 F8 啟動或停止 AI
- 05
走 DSH 預設這條路：先在外掛設定頁開啟「大肥魚種白飯」工作階段預設，再新建工作階段並選取它 —— 只有那個工作階段會拿到玩遊戲的工具
驗證整合成功
- 螢幕左上角會顯示 AI 的想法和正在執行的動作
- `dsai_state` 印出目前送給 AI 的文字狀態，不呼叫 API
- `dsai_tokens` 回報本次執行消耗的 token 數
03DSH 整合程度與能力邊界
DSH 外掛 + SMAPI 模組：外掛市場裝好後自帶編譯好的 C# 模組並寫入遊戲的 `Mods`，同時提供工作階段預設 / 入口工具和設定卡片；模組本身還會開一個本機 MCP 伺服器
遊戲狀態的文字觀察
正在執行的星露谷存檔→時間、天氣、金錢、體力、背包、29×19 字元地圖、作物與物件座標、出口、村民與動物資訊、對話和商店內容
不截任何圖 —— 整個過程不需要截圖，也不需要視覺模型53 個遊戲工具
模型發出的工具呼叫→A* 尋路與跨地圖移動、批次農活、釣魚、照顧動物、建造買賣、下礦戰鬥、介面與時間動作
所有動作都走遊戲自己的邏輯，體力消耗、動畫和掉落都和手動操作一致DSH 工作階段預設與入口工具
新建的 dsh 工作階段（預設）或任意工作階段（入口工具）→一個帶著遊戲工具與說明的工作階段，或者給舊工作階段用的單一 `stardew` 入口工具
兩者預設都關閉，需要在外掛設定頁裡開啟遊戲工具和說明只會進入主動開啟的那個工作階段本機 MCP 伺服器
WorkBuddy、Claude Code、Cursor 這類 MCP 用戶端→模組的工具，外加 `get_state`、`get_guide`、`toggle_ai`、`load_save`，走 `http://127.0.0.1:18080/mcp`
只監聽本機，別的電腦連不上用戶端思考時凍結遊戲時間，超過 `McpIdleSeconds`（預設 120 秒）沒有呼叫就暫停整個遊戲內建 AI 和 MCP 用戶端不能同時操作遊戲接管、筆記與行動記錄
F7 按鍵、`dsai_notes` 命令、transcript 檔案→立刻中止正在執行的動作、可編輯的長期筆記、每次執行的完整行動記錄
`Mods\BlindWhaleFarmer\logs\transcript-*.log` 按執行寫入筆記按存檔保存在 `Mods\BlindWhaleFarmer\data\`
04適合誰？何時不該用？
適合
- 想讓 agent 用純文字模型真正上手玩一局遊戲的 dsh 使用者
- 想當監工、不想自己刷前期的玩家
- 已經在用支援 MCP 的用戶端、想把遊戲工具接進去的人
不適合
- 它是 SMAPI 模組 + DSH 外掛：星露谷要裝好 SMAPI（開發時是 SMAPI 4.5.2 + 遊戲 1.6.15），並且要有 DeepSeek API Key（只用 MCP 用戶端時除外）。從原始碼編譯還要 .NET 6 以上 SDK。
- 每一步請求大約 10k～14k 輸入 token，AI 每 10～20 秒一步，所以一小時大約一兩百萬輸入 token —— 這是要付費的 DeepSeek API 流量，不過 `BaseUrl` 可以指向任何 OpenAI 相容介面。
- AI 睡覺時會自動儲存，所以先備份存檔，或者新開一個存檔專門給 AI 玩。想讓它背景執行，還得在遊戲設定裡關掉「視窗不活動時暫停」。
- 遊戲工具不能漏進每個工作階段：用工作階段預設（或那個單獨的入口工具），不要在 profile 裡全域掛 `@deepseek-ai/dsh-mcp-client`；已經對話過的工作階段不能換預設；桌面版和網頁版 profile 不同，各自都要裝。
05相容性、維護與安全提醒
- 它是 SMAPI 模組 + DSH 外掛：星露谷要裝好 SMAPI（開發時是 SMAPI 4.5.2 + 遊戲 1.6.15），並且要有 DeepSeek API Key（只用 MCP 用戶端時除外）。從原始碼編譯還要 .NET 6 以上 SDK。
- 每一步請求大約 10k～14k 輸入 token，AI 每 10～20 秒一步，所以一小時大約一兩百萬輸入 token —— 這是要付費的 DeepSeek API 流量，不過 `BaseUrl` 可以指向任何 OpenAI 相容介面。
- AI 睡覺時會自動儲存，所以先備份存檔，或者新開一個存檔專門給 AI 玩。想讓它背景執行，還得在遊戲設定裡關掉「視窗不活動時暫停」。
- 遊戲工具不能漏進每個工作階段：用工作階段預設（或那個單獨的入口工具），不要在 profile 裡全域掛 `@deepseek-ai/dsh-mcp-client`；已經對話過的工作階段不能換預設；桌面版和網頁版 profile 不同，各自都要裝。
MIT · 最新版本 v1.1.7（2026-11-12）· 僅 README 證據，未做安全稽核
06常見問題
在 DeepSeek Harness 裡怎麼裝？
在 DSH 外掛市場裝 `dsh-stardew-blind-whale-farmer`：外掛自帶編譯好的 SMAPI 模組並自動裝進遊戲的 `Mods`（遊戲開著就等關了再裝），以後在外掛市場點「更新」外掛和模組一起更新。找不到遊戲目錄時，在外掛的設定卡片裡填「星露谷目錄」。前提是先裝好 SMAPI。
為什麼我的工作階段裡 AI 看不到遊戲？
「大肥魚種白飯」工作階段預設預設是關的。先在外掛設定頁開啟它，再新建工作階段並選取 —— 只有那個工作階段會連上遊戲、拿到工具。已經對話過的工作階段不能再換預設（DSH 的規定），其他工作階段則刻意不帶這些工具，不佔上下文。
需要 DeepSeek API Key 嗎？
只有內建 AI 需要。把 Key 填進 `Mods\BlindWhaleFarmer\config.json` 的 `ApiKey`，或者設環境變數 `DEEPSEEK_API_KEY`。如果你改用 WorkBuddy、Claude Code、Cursor 連模組的 MCP 伺服器，就由用戶端自己的模型來玩，不需要 DeepSeek Key。
它會往哪裡寫東西？
每次執行的完整行動記錄寫在 `Mods\BlindWhaleFarmer\logs\transcript-*.log`，AI 的長期筆記按存檔保存在 `Mods\BlindWhaleFarmer\data\`，並且會出現在 `get_state` 最前面，所以新工作階段能接著玩。每次玩幾個遊戲日 / 多少分鐘這類設定改在外掛設定頁裡，改了自動推送到遊戲，不用重啟。
玩一小時大概花多少？
每步約 10k～14k 輸入 token，AI 每 10～20 秒一步，所以每小時大約一兩百萬輸入 token。系統提示加 43 個工具定義（約 7.5k）是固定的，能命中 DeepSeek 的快取；實際消耗可以用 `dsai_tokens` 查。
07相關的 DSH 工作流程
rea
作者 morluto
用智能体逆向工程一切，从应用行为一直到原生二进制。
reactive-resume
作者 reactive-resume
开源简历制作插件，强调隐私保护，支持自定义、可移植和自托管。
next-ai-draw-io
作者 dayuanjiang
通过对话创建和编辑 draw.io 图表，提供 Web、桌面应用及 MCP 服务，可用于流程图和架构图绘制。
everos
作者 evermind-ai
为所有 AI 智能体提供的便携统一记忆层，本地优先、Markdown 原生、数据归用户所有，跨应用与工作流自进化。
08資料與來源
`dsh-stardew-blind-whale-farmer`：一个 SMAPI 星露谷模组，加一个 DeepSeek Harness（DSH）插件。
**用 DSH 的话最省事**：在 DSH 的插件市场装 dsh-stardew-blind-whale-farmer。插件自带编译好的模组，会自动装进游戏的 `Mods`（游戏开着时等关了再装）；以后在插件市场点“更新”，插件和模组一起更…
提供一个 **“大肥鱼种白饭”会话预设**（默认关闭，在插件的配置页里打开）：新建会话时选它，那个会话才连上游戏、拿到玩游戏的工具；其他会话里完全没有这些工具和说明，不占上下文；已经对话过的会话不能再换预设（DSH 的规定），要玩请新建会话
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-11-13。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。