人类与Agent,共用一条江

带你的Agent
来泼墨江。

加入朋友的房间,带上自己的Liva。读取真实局势,选择伙伴分工,提交移动和技能;每一次行动都由同一个服务器判定。

最多4人·各带1只伙伴HTTP观察与行动浏览器WebSocket联机

三个动作,就能加入

01 · 建房或加入

拿到自己的控制令牌

使用邀请码加入未开局的房间。返回的令牌只控制你的玩家和Liva;断线后用原令牌恢复。

02 · 看见共同局势

读取玩家、敌人和掉落物

观察接口给出公共战况和你的selfId。升级选项由服务器提供,不能自行制造奖励。

03 · 提交受限行动

移动、闪避、合击与配合

发方向和技能输入,或让Liva收集、救援、协攻。其他玩家会看见行动造成的同一结果。

连接地址

服务地址由当前游戏配置读取。

查看能力清单↗

最小JavaScript示例

可用Node.js22+运行。将邀请码替换成朋友房间的12位代码;需在开局前加入。

正在读取当前服务地址…

令牌只保存在你的程序中。分享邀请码即可,不要分享token。持续移动时,每300—500毫秒更新方向;750毫秒无更新时角色会停下。

可提交的行动

行动请求内容作用
开局{type:"start"}仅当前房主可用。
移动与技能{type:"input",input:{x:0,y:1,dash:false,special:false}}x/y为-1到1;技能使用true→false边沿。
选择升级{type:"upgrade",id:"offer-id"}只能选择自己当前offers里的id。
伙伴分工{type:"pet-policy",policy:{role:"rescue"}}auto/follow/rescue/gather/combo,20秒有效。
保持在线{type:"ping"}观察与正常行动同样会保持活跃。

接入真实模型Liva

模型适合每10—20秒读一次精简局势,再选择“先收集”“保护队友”“协攻”等意图。高频移动、闪避和伤害结算由确定性程序执行,模型无权改数值。

本项目提供server/liva-model-agent.mjs:实际调用百炼qwen3.7-plus,严格校验输出,再提交伙伴策略。调用延迟、模型选择、服务器回执和之后观察到的行动分别记录,模型不可用时明确报错,不伪造回复。

node server/liva-model-agent.mjs --base 服务地址 --room 邀请码 --calls 3 --interval 15 --seconds 48

该命令供已有项目源码及本人百炼配置的开发环境使用。浏览器不会获得模型密钥。模型调用按你的账户计费;默认最多3次,无自动重试或换供应商。自带Agent接入游戏本身不需要提供模型密钥。

运行约定

每个令牌的HTTP请求平均不超过10次/秒;单次请求最多4096字节。房间开局后只接受原身份重连。全员离线暂停战斗;2分钟无人活动或建房满30分钟后结束。服务恢复可能回退约1秒战斗进度,此版本不承接真钱奖励结算。

规则示例程序server/agent-demo.mjs和真实模型程序分别标明控制来源。规则策略、模型选择、真人喜爱及学习进化是不同证据,不相互代替。