返回目录

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 说明这项基础检查不需要游戏和模型 Key
  • `pnpm test:dsh`——实际走一遍 dsh 工具注册器、构建产物、CLI 子进程与取消流程,不调用模型

03DSH 适配与能力边界

DSH 适配原生运行时

原生 dsh 插件:dsh 插件承载 Jev 自主控制循环与聊天内运行面板,游戏观察与动作由 SMAPI Mod 和独立 CLI 提供。

  • dsh 聊天内的农场运行面板

    Mod 与 CLI 提供的游戏观察→右侧面板展示季节日历、农场时钟、体力条、背包槽位与农场日记,并提供暂停、继续、停止与决策详情

    暂停 Agent 不会暂停游戏时间
  • Jev 自主控制循环

    自主运行、动态候选、单步执行、暂停/继续/停止、运行记录与结果核验

    运行记录留在本机
  • 复杂目标的阶段规划

    按阶段执行,阶段结果与受阻证据回到发起任务的聊天

    后续阶段与前面阶段共享预算
  • 随包 `stardew` skill

    安装 dsh 插件时自动注册,无需另装;覆盖简单目标启动、复杂目标分阶段、暂停与接管、证据复核与受阻处理

  • 免游戏、免模型 Key 的模拟农场

    `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` 启动模拟农场,并说明基础检查不需要游戏和模型 Key;模拟结果会明确标记为 `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 插件,绝不滥发。