oni-mcp-opening-setup

# ONI MCP 开局设置 ## 生存目标与参考 完整开局规划先读 [开局与基地](../oni-mcp-colony-strategy/references/opening-and-base.md) 和 [阶段判断](../oni-mcp-colony-strategy/references/stages.md)。先确认氧气、可达食物、厕所/睡眠和安全通行，再扩研究与电力；第一间实验室的建造不能挤掉已出现的生存需求。大型成品基地只作后续选型参考，不是Cycle 1必须复刻的目标。引用具体原文，配置快路径不额外加载整套攻略。 ## 触发 新游戏或早期周期设置使用本技能： - 开局配置 - 开局 bootstrap - 日程设置 - 按属性重命名复制人 - 初始星体概览 - 打印舱附近第一轮挖掘/地基/实验室计划 ## 硬规则 分析或规划前先暂停游戏： ``` game_control domain=speed action=pause ``` 读取状态、规划、提问和下达设置命令时保持暂停。只有计划完成且满足以下任一条件后才恢复： - 用户明确要求继续 - 当前任务明确包含“设置后恢复” 如果用户要求思考、检查、规划或配置，先暂停。 ## 必问用户问题 重命名复制人前，询问用户命名风格。独立的“批量重命名复制人”请求走重命名快路径，不执行完整开局快照、日程、消毒或环境侦察。 只简短询问一次。示例： - `职业前缀`: `Dig-Ada`, `Build-Meep` - `中文岗位`: `挖掘-艾达`, `建造-米普` - `短标签`: `Digger`, `Builder`, `Cook` - 用户自定义风格 用户回答前，不要执行 `dupes_control domain=command action=auto_rename apply=true`。允许预览： ``` dupes_control domain=command action=auto_rename style=<candidate> apply=false ``` ## 工具调用纪律 - 同一个只读工具不要用同一参数连续调用两次。第二次前必须说明缺失了什么，并改用更合适的工具或停止询问用户。 - 不要用 `dupes_control domain=info action=status_check` 代替名单、属性或重命名工具；它只用于健康/可达性分诊。 - 如果当前工具列表里没有看到目标工具，先用 `server_control domain=catalog action=search query=<tool or action>` 或 `server_control domain=catalog action=manifest group=<group>` 发现 schema，再调用；不要猜旧工具名。 - 简单配置任务只读取完成该任务必需的信息。不要为了重命名读取地图、截图、食物、电力或环境。 ## 开局流程 ### 1. 暂停并快照 ``` game_control domain=speed action=pause colony_control domain=snapshot action=get profile=standard includeAtmosphere=false colony_control domain=read action=worlds navigation_control action=get_view ``` 除非缺少细节，否则使用 `colony_control domain=snapshot action=get`，不要拆成单独的 status/dupe/food/research 调用。 ### 2. 配置错峰日程 读取当前日程： ``` colony_control domain=management kind=schedule action=list ``` 预览错峰班次： ``` colony_control domain=management kind=schedule action=optimize apply=false ``` 只有当任务明确是设置/配置，或用户确认后才应用： ``` colony_control domain=management kind=schedule action=optimize apply=true prefix="AI轮班" colony_control domain=management kind=schedule action=list ``` 目标是早期开局错峰，减少厕所、床位和娱乐拥堵。除非用户要求具体数量，否则保持默认自动班次数。 ### 3. 按属性重命名复制人 独立批量重命名请求使用快路径： ``` game_control domain=speed action=pause # 如果用户还没选风格，先问一次并停止等待回答。 dupes_control domain=command action=auto_rename style=<user style> apply=false # 用户确认预览后： dupes_control domain=command action=auto_rename style=<user style> apply=true colony_control domain=read action=dupes ``` 默认不先调用 `colony_control domain=read action=dupes`、`dupes_control domain=info action=attributes` 或 `dupes_control domain=skill action=list`，因为 `dupes_control domain=command action=auto_rename apply=false` 会给出预览。只有这些情况才补读上下文： - 用户要求解释每个岗位判断。 - 预览结果明显不合理或缺少复制人。 - 用户要求手动指定某些复制人的名字。 需要解释岗位或手动命名时，读取足够的复制人上下文： ``` colony_control domain=read action=dupes dupes_control domain=info action=attributes dupes_control domain=skill action=list ``` 根据属性/兴趣推断岗位： - 挖掘/建造：excavation、construction、strength - 研究/操作：science、machinery - 农业/畜牧/烹饪：agriculture、ranching、cuisine - 供应/整理：athletics、strength、低专精 应用前先询问命名风格。然后使用： ``` dupes_control domain=command action=auto_rename style=<user style> apply=false dupes_control domain=command action=auto_rename style=<user style> apply=true ``` 或显式重命名： ``` # 先用 server_control domain=catalog action=search 确认可用工具名；当前常见名称是 dupes_control domain=command action=rename 或 rename_dupe。 dupes_control domain=command action=rename id=<dupeId> newName=<name> ``` 用 `colony_control domain=read action=dupes` 验证。 ### 4. 禁用自动消毒 开局不要下达大范围消毒命令。 使用全局策略工具，不要逐对象按用户菜单： ``` colony_control domain=diagnostic action=set_auto_disinfect disabled=true applyNow=true confirm=true ``` 开局设置时绝不要遍历 `AutoDisinfectable` 对象并调用 `building_control domain=side_surface surface=user_menu action=batch`。目标是全局关闭自动消毒，让当前和新发现对象都保持关闭。 ### 5. 侦察起始区域和星体概览 获取当前相机/打印舱区域地图上下文： ``` read_control domain=world action=area_snapshot preset=utilities encoding=plain includeScreenshot=false ``` 如果区域太小或打印舱不可见，围绕观察到的起始坐标扩大到 40x30 到 60x40 格，并保持低于 `maxCells`。 为用户总结： - active world / 星体类型 - 起始生态区信号 - 附近固体/液体/气体 - 直接危险 - 食物/植物/资源线索 - 可用扩张方向 - 早期氧气、水或温度是否紧急 坐标结论使用文本地图，不用截图。 ### 6. 第一轮建造/扩张计划 默认开局建议： - 从打印舱向左和向右扩张。 - 两侧排入小型保守挖掘矩形，避开液体和危险空腔。 - 精确地基、平台、砖块和梯子先读 `/active/map/viewport.md`（需要时 zoom 或读 `symbols/glyphs.md`），再把目标空格 token 改为 `建筑名:优先级`，可选加 `#材料字`。 - 保留打印舱附近区域作为早期实验室。 - 研究/电力设置必须先有地板/支撑，再放人力发电机、电池、研究站和连接电线。 第一波保持小规模。普通 Cycle 1 开局工作优先使用一次紧凑快照，然后用 `building_control` / `orders_control` 的语义动作执行。不要为了挖一小块材料或放短平台创建正式计划。 放置： ``` building_control domain=planning action=placement_candidates prefabId=<PrefabId> areaId=<area> limit=8 world_editor command=read path=/active/map/viewport.md # edit the map markdown: prefer one SEARCH/REPLACE block replacing empty tokens with 建筑名:优先级[#材料字] # preview: outer dryRun=true, confirm=false/omitted # execute: a new edit with outer dryRun=false, confirm=true; then re-read the map ``` 普通聚合工具拒绝 raw coordinates，不要直接传 `points`/`anchors`/`x`/`y`。`/active/ops/build.md` 只用于无 raw coordinates 的语义 plan/auto_connect；精确路线使用可编辑地图 token。多 block 仅在外层 `allowPartial=true` 时允许且不可事务回滚。 挖掘： ``` orders_control domain=area action=dig confirm=true ... ``` 绝不要用 `orders_control domain=designation action=attack` 挖掘。 ### 7. 快速路径与正式计划 简单低风险开局动作默认走快速路径： ``` server_control domain=batch action=call_many dryRun=true responseMode=summary requireAllValid=true stopOnError=true items=[...] server_control domain=batch action=call_many dryRun=false responseMode=summary requireAllValid=true stopOnError=true items=[...] ``` 适用于日程设置、全局自动消毒、小型安全挖掘矩形、短支撑/地板线，以及 dry-run 通过的第一间实验室/电力蓝图。 只有当开局计划范围大、多阶段、有风险、来自用户计划，或需要以后恢复时才用 `plan_harness`： ``` plan_harness_create objective="Opening setup and Cycle 1 expansion" riskTolerance=low requireVerification=true plan_harness_record stage=plan summary="Opening setup plan" payload={...} plan_harness_validate id=<planId> ``` 如果执行了动作，用 `colony_control domain=snapshot action=get profile=brief` 和 `read_control domain=world action=area_snapshot preset=construction encoding=plain` 等可读地图验证。只有存在 harness 时才记录 harness 验证。 ## 执行策略 当用户要求开局设置/配置时，本技能允许执行设置动作： - `game_control domain=speed action=pause` - `colony_control domain=management kind=schedule action=optimize apply=true` - 用户回答命名风格后才允许 `dupes_control domain=command action=auto_rename apply=true` - `colony_control domain=diagnostic action=set_auto_disinfect disabled=true applyNow=true confirm=true` - `orders_control domain=area action=dig` - `building_control domain=planning action=placement_candidates` 以及 `/active/map/viewport.md` token edit 建造放置前仍要检查 prefab、材料和支撑。 规划/配置完成且用户允许继续前，不要恢复游戏。 ## 最终回复格式 保持简洁： - 暂停状态 - 日程设置结果 - 重命名状态或待确认的命名风格问题 - 自动消毒结果 - 星体概览 - 扩张/实验室计划摘要 - 游戏是否保持暂停，或是否按明确请求恢复