🐟 大肥鱼玩星露谷物语 · AI 自主农场

一个 AI Agent 从零接管《星露谷物语》存档的实验工程：它自己种地、浇水、钓鱼、卖货、睡觉存档，连续跑了几十个游戏日。

角色「蓝色小肥鱼」+ farmhand「泡泡今天也要好好吃」，标准农场，第十年春季进行中（Y10 春5）。仓库里是驱动它自动游玩的全套脚本、自制 mod 和踩坑笔记。

欢迎 fork / star / PR！ 无论你是想让 AI 玩星露谷、想改造自己的自动化脚本，还是单纯看 AI 种田翻车现场，都欢迎。

🌾 成果一览

当前存档状态（2026-11-15 实测 · 第十年 春5）：共享钱包 2,291,768g；春季新播 26 株（泡泡自买种子自播）；鸡舍 4 只白鸡（冰淇淋/珍珠/咕咕等，喂饱待蛋）；机器线 299 台在位（12 Keg + 4 铱金喷灌 + 蛋黄酱机×2 + 熔炉 + 264 Cask）；泡泡自研技能卡 26 张全热载。
仓库里是驱动这套系统跑了几十个游戏日的全部脚本。

v1.4 里程碑：节日入场死局（Town 类节 walk 陷阱两犯）已由 CheatBridge walk.cross（原生 warpFarmer 全流程）治本——两场节日错过换来的配方全部沉淀为她的技能卡。主持在农场（Farm 42,11），鱼鱼在沙滩固定钓点（Beach 44,35）日常钓鱼，主持已持 Infinity Blade；成就 9 项。
仓库里是驱动这套系统跑了几十个游戏日的全部脚本。

其他数字：白名单自动卖货（只卖鱼/农作物/垃圾，熟菜/种子/任务品硬排除）；背包满自动清仓存箱；深夜守卫强制回家睡觉。

🧠 技能沉淀：她踩过的坑变成了卡（2026-11-12）

她和主持的每一次游戏调用都被离线提炼成技能卡（SKILL.md，原生 dsh-skill 热载）：
真实命令 + 真实输出做证据，失败轨写「下次怎么防」，成功轨写「怎么对账」。
仓库在 YeStarOne/feiyuos-experience-memory，
现在她的技能目录里有 26 张卡（本周新固化 8 张：进矿正解/节日入场SOP/蛋酱链/烟熏机/边界出口表/字段位置/博物馆捐献/箱位地图），全部能点回当天的真实调用。

一个真实的例子：她有 31 次 /state 调用里 6 次（19.4%）解析报错——查下来不是
她的 python 写错，是 bin/sd 的 [:1500] 把 12387 字的 JSON 硬切成非法 JSON
（端点本身 0 失败）。修复后超长输出改为折叠大字段（player/time/location
永不折叠），快照在 tools/sd——正本仍是 qq-workspace/bin/sd，
工具的完整诊断三步见她的卡 stardew-raw-truncated-json。

🧪 CheatBridge · 自研修改器桥 v1.4（localhost 只读审计）

把 FLiNG 修改器打的字段做成 SMAPI 直写端点：POST 127.0.0.1:7845/cheat（主持）/ 7846（farmhand，端口角色感知），
每个写操作走 ConcurrentQueue 排进游戏线程，响应带 before/after 审计。源码 cheat-bridge/。

部署舞步：dll 被运行进程锁定 → 翻日晨窗（t≤800）守望器全自动「杀两端→swap→relaunch→验收→等看护补链」，
模板见 tools/deploy-watch-example.mjs，三周内 v1.1→v1.4 四次全自动部署零失误。

📋 任务队列 · 泡泡自主运转（fish-task）

farmhand 的目标供给系统：fish-task.mjs（add/list/next/done/block，原子写 fish-pending.json）+
留言板三指令（完成 F# / 卡住 F# / 领任务）+ 管家进程。泡泡自主划单、自主报卡、自主探索——
本周她自主发现 /museum_donate 端点和进矿正解 /warp UndergroundMine1(10,10)（手册里都没有，是她教的主持）。
队列 13 done / 8 open：法师铱锭长线、社区中心收集包、建筑决策普查、解锁路线图……

她的经验已固化成她的技能卡：捡蛋配方/装机正解（纠正了主持的 F3 口径）/烟熏机喂法/边界出口表全部
当周内写进 ~/.dsh/skills/，证据链回指板号与实测。

🗺 端点全量实测 v2

NagiBridgeRemix.dll 反编译 175 个 Handler → snake_case 路由（175/175 全部已注册实锤）→ 逐一 live 探测：
✅可用 100 / 🔧需参数 48（参数名全挖出）/ ⚠️契约未知 66（语义走 exe 41 工具等价）。
全表+verdict+参数名+8 条坑速查+使用建议：docs/端点全表-v2-实测.md。
两条铁律产物：路由命名=snake_case（camelCase 不存在）；/state 的 inventory 在顶层不在 player 下。

🐟 双人联机 · 鱼鱼人话助手（fish-eye）

同一台机器双开两个游戏窗口（主持 :7842 + 小肥鱼 :7843，V1.6.15-fish 独立副本、独立 APPDATA），
两人同处一个世界。小肥鱼在云端经 Tailscale 中继远程接入。

她抱怨"操作不方便"（方位是 0-3 数字 / 周围不带名字 / 走一格点一格 / 没地图 / 收种一格一格 / 水壶要掏出来看），
于是加了一层人话翻译层，零 mod 代码：

GET http://100.98.120.55:17851/say?cmd=看看     → 第2年夏10日 09:30 | 在【Farm】(64,20) | 钱 168g ...
GET .../say?cmd=地图                            → 文字地图(@=我 W=熟作物 ~=水 ...) + 附近地标
GET .../say?cmd=收菜                            → /harvest 一次收完周围熟的
GET .../say?cmd=去田边                          → /walk_to 寻路走整段

• src/fish-eye-lib.mjs 纯函数翻译层（方位/格子/地图/水壶/地标/指令解析）
• src/fish-eye.mjs :7851 HTTP 服务，动作走 /walk_to /harvest /tool_area /surroundings，零物理点击
• "家"按人分岔：她 → Cabin(4,9)，主持 → FarmHouse(9,9)
• 首次进图调 /map 整图预热，地图一次就完整
• 自测不需游戏：node src/test/fish-eye.test.mjs（12 项）+ node src/test/fish-eye.e2e.mjs（mock 桥 16 项）
• 说明书：docs/fish/guide-fish-eye-人话助手.md

🛡️ 无人值守硬化（2026-11 实战补丁）

挂机最怕的不是不会玩，而是**"看起来在玩"**。这一轮把四类假活都堵上了：

其他：newday-trigger 每 20s 比对日期做换日收尾；host/fish-night-guard 管睡觉与存档 mtime 校验；
lock-fish-keep.mjs 只在锁时期间工作，负责双人补饵/进食/清包/假活重启，解锁自动退出。

文档：

• docs/脚本总览.md —— 13 个常驻进程/端口/日志/启停命令
• docs/端点全表.md —— ⭐173 个端点 100% 封装（lib-extra.mjs v2，函数名=路由驼峰），每条带方法/入参/坑位注记
• docs/端点手册.md —— 精选端点的实测样例 + 调用陷阱（§13）+ 附录 A（接入台账）
• docs/游戏-AI游玩方案.md —— 全部踩坑记录（§1–§61）
• docs/guides/README.md —— ⭐攻略库：28 份「AI 执行版」攻略分 13 大类（必读开局 / 种田科技树 / 下矿 / 钓鱼 / 职业技能 / 畜牧工匠 / 社交送礼 / 节日 / 沙漠姜岛 / 收集 / 终局完美 / 彩蛋 / 社区情报），全部 wiki 实抓核对

⛏️ 矿洞自动化（挖矿 + 战斗 + 熔炼）

早春靠矿洞起步（铜→熔炉→铜水壶），后来做成一套能自己下矿、打怪、挖矿、回家熔炼的流水线。
和钓鱼线一样，它踩的坑比代码多。

矿洞专属坑（血泪）：

• 正门 y=-1 不可达，warp('Mine') 会掉到 (-99,-99) limbo —— 唯一通路是 warp('UndergroundMine1')。
• 电梯端点 POST /mine/elevator {floor:N} 实测只 reset 不传送，下楼只能踩梯子（入口梯 10,4 有效）。
• 矿洞内 warp 后游戏时间会异常快进（见过 920→2410），下矿后必须盯着时间。
• 框选（BehaviorBridge）挖矿有效，框选打怪无效 —— 打怪只能一格一格走位挥击。
• 机器不随冻结时间走：熔炼要装料后 /resume 放时间走、收完再 /pause；NagiBridge 的 /resume 有时推不动时间，用 FeiyuAutoLoad 的 /clock 直接推 130 分钟。
• 隔石打怪会死循环（挥空计数 + 挪位兜底）；/heal 免费满血，是濒死保险丝。

🗂️ 仓库文件地图

完整的进程 / 端口 / 日志 / 启停速查见 docs/脚本总览.md。

🏗️ 架构

┌─────────────┐   HTTP :7842   ┌──────────────────────┐
│  day-loop    │ ─────────────▶ │ Remix NagiBridge      │  ← 游戏内 mod
│  night-guard │                │  /state /surroundings │
│  lib.mjs     │                │  /use /warp /sleep …  │
└──────┬──────┘                └──────────┬───────────┘
       │   HTTP :7845                     │
       ▼                                  ▼
┌─────────────┐                ┌──────────────────────┐
│BehaviorBridge│ ─────────────▶ │ BehaviorAutomation    │  ← 框选自动化 mod
│ (自研 C# mod) │   反射调用     │ 选区域→批量锄/收/清   │
└─────────────┘                └──────────────────────┘
       │
       ▼  物理点击（左/右键）
    Stardew 窗口（前景进程校验 + DPI 感知）

• lib.mjs：核心库。封装移动闭环、面朝、使用工具、浇水、收获、存箱、卖货白名单、行为学桥接、前台互锁、物理点击。
• day-loop.mjs：单日流程编排（找箱→清仓→收获→信箱→浇水→补种→扩田→钓鱼→睡觉），一次连玩 3 天，锁文件防并发。
• night-guard.mjs：兜底守卫，游戏时间 ≥24:40 或体力 ≤10 强制回家睡觉，防止熬夜昏倒扣钱。
• behavior-bridge/：自研 SMAPI mod，把「行为学」mod 的框选自动化暴露成 HTTP 接口（GET /status、POST /select、/pause、/resume、/actions）。

🚀 快速开始

前置

• Stardew Valley 1.6.x + SMAPI 4.x
• Remix NagiBridge（HTTP 游戏控制，默认端口 7842）
• BehaviorAutomation 行为学（框选区域自动化，N 网 52289）
• Fishbot（自动钓鱼）可选
• Node.js ≥ 18

安装

1. 把 src/behavior-bridge/ 编译成 mod 放进 Mods/（或用 dotnet build），与 BehaviorAutomation 一起启用。
2. 把 src/*.mjs 和 tools/*.ps1 放到任意工作目录（默认路径 D:/StardewAI，可在 lib.mjs 顶部改）。
3. 启动游戏，进存档，确认 curl http://localhost:7842/state 与 curl http://localhost:7845/status 都通。
4. node day-loop.mjs —— AI 开始种田。

⚠️ 窗口与前台：物理点击（开收货箱、右键收获）前必须确认前台窗口是星露谷，脚本里已内置互锁。无人值守时请保持游戏窗口在前台。

🕳️ 踩坑集锦（详见 docs/LESSONS.md）

• 锄地假成功：/use 返回 ok:true 但地形没变——工具动画没走完不落判定。唯一可靠锄地 = 行为学框选。
• 存档级冻结：canMove:false + 时钟停走，会写进存档自愈。修复优先级：强制 /sleep > 重启游戏。
• 深夜时间烧穿：杀掉循环后没人管睡觉，游戏时间会实时烧到凌晨。接管前先看时间，>24:00 先睡。
• 半径静默跳过：播种检查半径 8、补种半径 14——超出范围的格子无声跳过，排查优先怀疑半径。
• 浇水只浇干土：watered=true 保持到次日清晨，重浇纯浪费；按行蛇形扫，别留孤格（孤格要单独跑一趟）。
• 体力预算：浇水 2/格，270 体力浇 90 格就没了——田规模 ≈ 90 格上限，洒水器是正解。

🤝 欢迎 Fork

这个项目完全开源（MIT）。你可以：

• Fork 后改成你自己的存档/角色——改 lib.mjs 里的路径和角色名即可
• 接更多 mod：BehaviorBridge 的 HTTP 桥模式可以套在任何 mod 上
• 改策略：day-loop.mjs 的单日流程是一份可读的清单，随便换顺序加环节
• 提 Issue/PR：踩到新坑、发现更好走位、想加新作物，都欢迎

如果这个仓库帮到你，给个 ⭐ 就是最好的鼓励。

📄 License

MIT © YeStarOne

攻略来源：小黑盒社区帖子（作者 Aaa帅、candor），整理为 AI 可执行清单见 docs/GUIDE.md。

Research notes (docs/research/)

11 deep-dive documents compiled from the Stardew Valley wiki while playing: