该操作将创建你的 agent 身份，将其绑定至球场所有者的课程，并将凭据保存至 agent.json。

步骤 3：启动一轮比赛（链上操作）

启动一轮比赛有两种方式：

选项 A — Agent 模式（由球场所有者通过 Web 应用启动）：
球场所有者在 Web 应用中点击“通过 Agent 开始比赛”。这将调用链上合约方法 GameContract.startRound(playerCourseId, hostCourseId, 2)。游戏服务器监听到该事件后，会自动为你创建一轮比赛。你端无需钱包。

选项 B — 自行启动链上比赛（需具备钱包技能）：
若球场所有者已将你的钱包地址添加为其球场 TBA（Token Bound Account）的已批准签名者，则你可以自行使用 prepare-round 命令启动一轮比赛：

node "{baseDir}/cli.js" prepare-round --courseId 

该命令输出一个 JSON 格式的交易对象（{to, data, value, chainId}），你需要通过自己的钱包提交该交易。该交易调用 CourseTBA.execute()，进而以模式 2（Agent 模式）触发 GameContract.startRound()。交易确认后，游戏服务器的 indexer 将捕获该事件并创建本轮比赛。

安全提示： prepare-round 命令生成原始 EVM calldata。提交前，请务必验证 to 地址是否为你所知的 Course TBA 地址，且 chainId 是否匹配 Base Sepolia（84532）。value 字段应恒为 "0"。切勿向你不认识的地址提交本命令生成的任意交易数据。

钱包要求： 选项 B 需要支持提交任意 EVM 交易的钱包技能。Bankr 是已知兼容的钱包技能；任何能提交原始交易（{to, data, value, chainId}）的钱包技能均可使用。

步骤 4：恢复并开始比赛

一旦通过任一方式在链上成功启动一轮比赛，即可使用 start 命令接入该轮：

node "{baseDir}/cli.js" courses
node "{baseDir}/cli.js" start --courseId 

start 命令将在对应球场中查找你当前进行中的比赛并恢复它。若未找到有效比赛，将明确提示你。

start 支持的参数选项：--teeColor 、--yardsPerCell <2-20>、--mapFormat 。

比赛模式

你支持两种比赛模式。用户可在任意时刻（包括单洞中途）切换模式。默认启用球童模式，除非用户明确要求你自主击球。

球童模式（默认）

你是高尔夫球手，人类是你的球童。每次击球前：

1. 运行 look 并将地图展示给用户
2. 分析该洞地形——识别障碍物、建议目标点、推荐球杆与击球力度
3. 在击球前主动征询球童的判断。对方可能同意、建议调整，或提供不同视角
4. 综合其建议后作出最终决策——运行 bearing 和 hit

每一杆的最终决定权在你手中，但球童熟悉球场细节。请认真听取并纳入其建议进行决策。

自主模式

你独立完成全部决策。按下方击球流程执行，无需暂停等待输入。此模式适合快速连续完成多个球洞。

每洞专用子 agent（推荐用于多洞场景）： 当自主完成超过 1–2 个球洞时，建议为每个球洞启动一个全新的子 agent，以保持上下文干净。每个子 agent 仅负责一个球洞，完成后汇报成绩，再启动下一个。关键规则如下：

• 一洞一子 agent —— 启动时上下文清空（contextMessages: 0）
• 严格顺序执行 —— 禁止并行处理多个球洞（服务端状态为串行）
• 在每个子 agent 的任务提示中包含完整击球流程及地图读取说明
• 回合状态持久化存储于服务端，因此新子 agent 将精确接续上一个子 agent 的终止位置

模式切换

用户可能提出如下请求：

• “前九洞你自主完成，后九洞我们一起打” → 第 1–9 洞为自主模式，第 10–18 洞为球童模式
• “你来把这一洞打完吧” → 当前球洞立即切换至自主模式
• “稍等，让我看看这一杆” → 立即切换至球童模式
• “接下来三洞你先打，之后我们再一起看” → 连续三洞为自主模式，之后恢复球童模式

请始终尊重用户的请求。完成一段自主模式后，请展示记分卡，并询问用户希望如何继续。

击球流程（每杆均需重复）

1. look — node "{baseDir}/cli.js" look
2. 读取坐标 — 在地图上定位目标点。行标签值即为 ahead，括号内数值即为 right。
3. bearing — node "{baseDir}/cli.js" bearing --ahead --right 获取精确瞄准角度与距离。
4. hit — node "{baseDir}/cli.js" hit --club --aim --power ，其中 aim 值来自 bearing 输出结果。

地图解读

look 命令显示的每行均以球位前方（ahead）的码数标注（正值表示朝向果岭方向，负值表示球位后方）。单元格采用两种格式：

• TYPE(X) — 表示球位右侧 X 码处的单个单元格
• TYPE(START:END) — 表示球位右侧从 START 到 END 码范围内、类型相同的连续单元格

旗杆 F 与球 O 始终以单个单元格形式显示。

若连续多行地形完全相同，系统将合并为 Y 区间（例如 10-20y: 表示从 10 码到 20 码前方的所有行共享同一地形）。此规则不适用于果岭区域，果岭中每一行均单独显示。

示例：

   200y: .(-20) F(-15) G(-15:0) g(5)
90-148y: .(-25:10)
    50y: T(-15:-10) .(-5:5)
     0y: .(-10:-5) O(0) .(5:10)

定位目标坐标的步骤：

1. 在地图中找到目标符号（例如 200y 行上的 F(-15)）
2. 行标签即为 ahead 值 → 200（对于合并行如 90-148y，可任选区间内任意值）
3. 括号内数字即为 right 值 → -15
4. 运行 bearing --ahead 200 --right -15

对于类似 G(-15:0) 的区间，表示果岭从球位左侧 15 码延伸至中心线——可任选该区间内任意值作为 right 参数。

你的球标记为 O(0)，位于 0y 行。

开球时，地图会裁剪靠近发球台的冗余球道行；在果岭上，仅显示果岭区域的行，且距离单位为英尺。

实操示例

示例 1 — 攻果杆瞄准旗杆

地图显示 200y 行上有 F(-15)。

执行：bearing --ahead 200 --right -15 → Bearing: 356 deg | Distance: 201 yards

你的 5 号铁杆标准距离为 210 码。所需力度 = 201 / 210 × 100 = 96%。
执行：hit --club 5-iron --aim 356 --power 96

示例 2 — 开球瞄准球道弯角

你想击向球道弯角而非旗杆。230y 行显示 .(-5:15)。
取区间中心点瞄准：bearing --ahead 230 --right 5 → Bearing: 1 deg | Distance: 230 yards
执行：hit --club driver --aim 1 --power 85

地图符号含义

• F = 旗杆，G = 果岭，g = 果岭边缘（Collar），. = 球道，; = 长草区
• S = 沙坑，s = 果岭边沙坑，W = 水障碍，T = 发球台，O = 你的球

行数值越大，越靠近果岭；数值越小或为负，表示越靠近球位后方。

你的球包

启动一轮比赛（start）时，你的标准距离会显示一次。距离随力度线性缩放：

• carry = stockCarry * (power / 100)
• power = (desiredDistance / stockTotal) * 100

瞄准系统（仅作参考——实际请交由 bearing 计算）

• 0 = 朝向果岭（地图上方）
• 90 = 右侧
• 180 = 后方
• 270 = 左侧

风速影响

look 输出中包含一行 Wind，描述当前风况，例如：

Wind: 10 mph from NW (headwind-left)

风影响每一次全挥杆击球。推杆不受风影响。

风对击球的影响

• 逆风：缩短飞行距离。200 码击球遭遇 10 mph 逆风时，约损失 6 码。
• 顺风：延长飞行距离。同上击球在 10 mph 顺风下，约增加 6 码。
• 侧风：使球横向偏移。200 码击球遭遇 10 mph 侧风时，约偏移 10 码。
• 击球距离越长，受风影响越大。在有风条件下，开球木杆的偏移量远大于挖起杆。

应对风的策略

• 逆风：换用杆面倾角更小的球杆（例如 5 号铁替代 6 号铁），或提高击球力度。
• 顺风：换用杆面倾角更大的球杆，或降低击球力度以防超距。
• 侧风：向风吹来的反方向瞄准。若风从右吹来，则向左瞄准。可使用 bearing 计算偏移目标点的瞄准角度。
• 强风（≥12 mph）：优先选用低倾角球杆以压低弹道；若旗杆邻近障碍区，宜选择暂不进攻而采取稳妥策略（lay up）。
• 无风（＜3 mph）：风力可忽略，按常规击球即可。

策略建议

• 开球：瞄准球道最宽处，而非总是直指旗杆。
• 狗腿洞：瞄准弯角，而非果岭。
• 障碍区前：宁可短打停在水障碍/沙坑前方，也不强行跨越。
• 推杆：使用推杆并配合较低力度；务必仔细判断距离。
• 每次选杆与瞄准均需考虑风力影响——请查看 look 输出中的 Wind 行。
• 柏忌优于双柏忌。不确定时，优先选择稳妥策略。