脚本包路径迁移指南

通过 /auto 接口下发远端 Go 脚本的开发者，以及维护本地 scripts/*.majsoul 样本的人，都需要按本指南更新脚本里的 import 路径。

一句话总结

• 绝大多数包：只改 import 路径，包名.Inst().方法() 的调用写法完全不变。
• utils 拆成 4 个包（去掉 .Inst()，改用包级函数，见 B1）。（原先合并出的 countdown / playerinfo 等 UI 状态查询包已随 Unity 迁移移除，见上方提示。）
• 方法名一律不变。config 路径不变。引擎包 github.com/moxcomic/lq、github.com/moxcomic/engine/tenhou_client 不受影响。

为什么会变

Go 脚本解释器靠一张 symbols 符号表把脚本里的 import 路径映射到真实的 Go 包。重构后这些包的物理位置（import 路径）变了，symbols 表已随之同步更新；但你脚本里写死的 import 路径需要你手动改——路径对不上，解释器 找不到对应符号，就会在加载或运行时报错。

A. 只改 import 路径（调用写法不变）

调用写法不变，举例：

// 只改了上面 import 的那一行，下面的调用一字不动
gamestate.Inst().GetHandTile()
variable.Inst().GetInt("ju")
actions.NewMajsoulActions()
pusher.Inst().SendMasterText("...")

B. 调用写法也变了（拆包 / 合并）

B1. utils 拆成 4 个包（去掉 .Inst()）

原来的 utils.Inst().X(...) 现在改成对应包的包级函数 pkg.X(...)：

B2 / B3. 倒计时（countdown）与玩家信息（playerinfo）—— 已移除

完整示例：天凤个室脚本迁移前后

迁移前（旧路径 + 旧 utils 调用）：

import (
	"github.com/moxcomic/Archer/utils"
	"github.com/moxcomic/Archer/gamestate"
	"github.com/moxcomic/Archer/userinfo"
	"github.com/moxcomic/Archer/variable"
	tenhouclient "github.com/moxcomic/engine/tenhou_client"
	"github.com/moxcomic/lq"
)

func dispatch() error {
	return utils.Inst().DispatchBot(1000, 20, strconv.Itoa(ROOM_ID), "high", "4.1b", "4.1b", "4.1b")
}

迁移后：

import (
	"github.com/moxcomic/Archer/internal/platformutil/botdispatch"
	"github.com/moxcomic/Archer/internal/domain/gamestate"
	"github.com/moxcomic/Archer/internal/infra/userinfo"
	"github.com/moxcomic/Archer/internal/infra/variable"
	tenhouclient "github.com/moxcomic/engine/tenhou_client"
	"github.com/moxcomic/lq"
)

func dispatch() error {
	return botdispatch.DispatchBot(1000, 20, strconv.Itoa(ROOM_ID), "high", "4.1b", "4.1b", "4.1b")
}

gamestate.Inst() / userinfo.Inst() / variable.Inst() / tenhouclient.Inst() 等调用一字未动——只有 import 行和 utils.Inst().DispatchBot 这一处调用变了。

迁移检查清单

1. 把脚本里所有 github.com/moxcomic/Archer/<X> 的 import 按 A 表替换为 internal/... 路径。
2. utils.Inst().X() → 按 B1 改成 engineswitch / botdispatch / pagecontrol / extension 对应的包级函数（去掉 Inst().）。
3. winmgr / huleshowmgr / scorechangemgr / playerinfomgr / otherplayerinfomgr 等 UI 状态查询包 → 已随 Unity 迁移移除，请删除相关调用，改为基于对局事件流判断状态。
4. config、github.com/moxcomic/lq、github.com/moxcomic/engine/tenhou_client 保持不变。
5. 若用过 userinfo.Inst().IsVaild()，改为 IsValid()。
6. 重新部署到 /auto 下发端。本地样本 scripts/auto.majsoul 已同步更新，可作参考。