返回目錄

agent-stardew

精選清單收錄維護狀態: 活躍

rottenpen/agent-stardew

星露谷農場小助手:Jev 自主遊玩、dsh 外掛、獨立 CLI 與 SMAPI Mod

前往 GitHub
$ dsh plugin add agent-stardew

15

星數

2

Fork

TypeScript

語言

MIT

授權條款

2026-09-19

建立於

2026-09-20

最近推送

MIT、TypeScript 的 dsh 外掛 + SMAPI Mod + 獨立 CLI,把星露谷的觀察與動作交給 Jev 自主控制迴圈,聊天內建執行面板與 stardew skill。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-20

授權條款

MIT

01它能幫你完成什麼?

  • 把一個農務目標交給 Jev,讓它自己把活做完

    一次自主執行:控制器持續選擇並執行下一步,右側面板同步顯示季節日曆、農場時鐘、體力條、背包欄位與農場日誌

    想讓 DeepSeek Harness 裡的 Agent 代做日常農務、同時看得清每一步決策的星露谷玩家

  • 在 dsh 聊天裡替複雜目標做階段規劃

    分階段執行:Jev 逐段跑完,階段結果與受阻證據自動回到原聊天,後續階段共用預算

    在 dsh 之上搭配聊天模型做規劃的使用者(例如種 5 顆防風草、澆水、回屋睡覺)

  • 確認農務到底完成了沒,而不是聽 Agent 自己說

    依遊戲狀態驗收完成條件(作物 ID 24、數量 1、是否澆水),通過才是「已核驗完成」,自由目標結束只會提示「待你複核」

    需要證據才能認定一次執行結束的使用者

02如何將外掛接入 DeepSeek Harness?

先決條件

  • Node.js 22+,以及倉庫指定的 pnpm 版本
  • 相容的 dsh——README 說明目前驗證的是 `0.1.5-rc.1`
  • 只在體驗真實遊戲時需要:星露谷本體、SMAPI 與 .NET 6 SDK(編譯基準為 macOS、Stardew Valley 1.6.15、SMAPI 4.5.2)

安裝步驟

  1. 01

    安裝相依套件:`corepack enable`,接著 `pnpm install --frozen-lockfile`

  2. 02

    在專案 `.env` 填入 `OPENROUTER_API_KEY`,再用 `pnpm start --mock --jev` 啟動模擬農場(想要獨立環境可先 `pnpm run setup --mock`,再 `pnpm dev --mock`,會在 `work/dsh/` 建一套 dsh)

  3. 03

    從瀏覽器自動開啟的登入入口進入;之後可用 `pnpm open` 重新開啟,換瀏覽器或無痕視窗時用 `pnpm open --print` 取得新的登入連結

  4. 04

    在 dsh 聊天右上角點「農場小助手」展開右側面板,點「觀察」,輸入目標,再點「開始農活」

  5. 05

    體驗真實遊戲:先正常存檔並離開遊戲,再執行 `pnpm start --jev`——它會建置、備份並安裝 Mod,然後啟動 SMAPI 與 dsh;自訂安裝路徑加 `--game-path "/…/Contents/MacOS"`

驗證整合成功

  • `pnpm check`——型別檢查、建置、協定、CLI 與模擬農務測試;README 說明這項基礎檢查不需要遊戲與模型金鑰
  • `pnpm test:dsh`——實際跑一遍 dsh 工具註冊器、建置產物、CLI 子程序與取消流程,不呼叫模型

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

原生 dsh 外掛:dsh 外掛負責 Jev 自主控制迴圈與聊天內的執行面板,遊戲觀察與動作則由 SMAPI Mod 和獨立 CLI 提供。

  • dsh 聊天內的農場執行面板

    Mod 與 CLI 提供的遊戲觀察→右側面板顯示季節日曆、農場時鐘、體力條、背包欄位與農場日誌,並提供暫停、繼續、停止與決策詳情

    暫停 Agent 不會暫停遊戲時間
  • Jev 自主控制迴圈

    自主執行、動態候選、單步執行、暫停/繼續/停止、執行紀錄與結果核驗

    執行紀錄保留在本機
  • 複雜目標的階段規劃

    依階段執行,階段結果與受阻證據回到發起任務的聊天

    後續階段與前面階段共用預算
  • 隨附 `stardew` skill

    安裝 dsh 外掛時自動註冊,免另外安裝;涵蓋簡單目標啟動、複雜目標分階段、暫停與接手、證據複核與受阻處理

  • 免遊戲、免模型金鑰的模擬農場

    `pnpm start --mock --jev` 或 `pnpm dev --mock`→附 dsh Web UI 的模擬農場,結果明確標記為 `mock`

04適合誰?何時不該用?

適合

  • 想讓 DeepSeek Harness 裡的 Agent 代做日常農務、同時看得清每一步決策的星露谷玩家
  • 在 dsh 之上搭配聊天模型做規劃的使用者(例如種 5 顆防風草、澆水、回屋睡覺)
  • 需要證據才能認定一次執行結束的使用者

不適合

  • 目前是可操作的開發版:完整真實遊戲農務與自主補能力驗收仍未完成,不能當成成品能力承諾。
  • Mod 以 macOS、Stardew Valley 1.6.15、SMAPI 4.5.2 為編譯基準,需要 .NET 6 SDK,安裝 Mod 時必須關閉遊戲;目前只打通探索、移動、農務、場景互動與對話,商店購買、容器取放等仍缺基礎介面。
  • Jev 自主遊玩透過專案 `.env` 的 `OPENROUTER_API_KEY` 呼叫模型,聊天入口的模型另行設定;只用面板則不需要設定聊天模型。

05相容性、維護與安全提醒

  • 目前是可操作的開發版:完整真實遊戲農務與自主補能力驗收仍未完成,不能當成成品能力承諾。
  • Mod 以 macOS、Stardew Valley 1.6.15、SMAPI 4.5.2 為編譯基準,需要 .NET 6 SDK,安裝 Mod 時必須關閉遊戲;目前只打通探索、移動、農務、場景互動與對話,商店購買、容器取放等仍缺基礎介面。
  • Jev 自主遊玩透過專案 `.env` 的 `OPENROUTER_API_KEY` 呼叫模型,聊天入口的模型另行設定;只用面板則不需要設定聊天模型。
  • 非官方社群專案:星露谷本體與 SMAPI 需自行安裝,倉庫不散布遊戲、資源或存檔;實機驗證使用專用存檔與備份,不會拿既有存檔做破壞性測試。
2026-09-192026-09-20作者未說明

MIT · 開發版(尚無正式 release,最後推送 2026-09-20)

06常見問題

沒裝遊戲可以先試嗎?

可以。README 的起步方式是 `pnpm start --mock --jev` 啟動模擬農場,並說明基礎檢查不需要遊戲與模型金鑰;模擬結果會明確標記為 `mock`。要真的玩遊戲則需安裝星露谷、SMAPI 與 .NET 6 SDK,並在安裝 Mod 前正常離開遊戲。

需要設定哪個模型?

分三處:Jev 自主遊玩讀專案 `.env` 的 `OPENROUTER_API_KEY`;聊天入口的模型另外設定;只點面板的話完全不需要聊天模型,點「觀察」、輸入目標、點「開始農活」即可。

執行面板怎麼開啟?

在 dsh 聊天右上角點「農場小助手」就會展開右側面板;任務卡片裡的「查看農場」開啟同一個面板,也能依 README 提供的位址直接用瀏覽器打開。登入入口可用 `pnpm open` 重新開啟,連結過期或服務中斷時用 `pnpm open --print` 取得新連結。

怎麼判斷一次農務真的做完了?

在「任務設定與完成條件」填條件,例如作物 ID `24`、數量 `1`、勾選澆水,控制器會依遊戲狀態驗收:符合條件才是「已核驗完成」,自由目標結束只會是「待你複核」,不能當成已核驗。另外暫停 Agent 不會暫停遊戲時間。

這是官方星露谷工具嗎?

不是。它是 MIT 授權的非官方社群專案,遊戲本體與 SMAPI 需自行準備,倉庫不散布遊戲、資源或使用者存檔。而且目前仍是可操作的開發版、沒有正式 release:完整真實遊戲農務與自主補能力驗收仍在進行中。

08資料與來源

  • 作者聲明github.comd1f8934351a0…

    基于 Jev 的星露谷 Agent。SMAPI Mod 与独立 CLI 提供游戏观察和动作,dsh 插件承载自主控制循环与运行面板。用户给一次目标,Jev 持续选择并执行下一步。

  • 作者聲明github.comd1f8934351a0…

    在 dsh 聊天右上角点击“农场小助手”,即可展开右侧面板;任务卡片中的“查看农场”打开同一个面板。

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。