
Spherewright
MCP bridge for AI agents to observe and operate Icarus through normal DSP mechanics. / 让 AI 智能体通过 MCP 按正常机制观察并操作伊卡洛斯。Spherewright
English
Spherewright connects an external Agent to Dyson Sphere Program through MCP. This Windows x64 package contains Spherewright 0.5.0, a BepInEx Plugin, the matching self-contained Spherewright.Mcp.exe and the Agent playbook.
Version and features
Supported native version is DSP 0.10.35.29151 with BepInEx 5.4.17. The exact source commit and every payload hash are recorded in spherewright-manifest.json. Install the Plugin and MCP from one build.
- Observe production, power, logistics, research and exploration-visible star systems. Plan finite routes and factories with explicit materials, energy and return reserves.
- Perform bounded ordinary interstellar travel, Native warper supply, local construction, station configuration and logistics observation through fresh prepare/commit actions.
- Inspect and configure the first-sail/carrier-rocket chain, including real flight, swarm and minimum receiving-node observations.
- Build and inspect Native building stacks and compatible host relations. Configure exact small/large warehouse layers or select the parent through its distributor. Observe per-layer stock, fluid, lab and device state.
- Reverse an empty piler-connected belt path through the Native operation and place one owned item on an empty belt with exact count/inc conservation.
- Diagnose stalled walking and request bounded tokenless short-route geometry previews. Execute each segment through a separate fresh ordinary move.
- Resume the exact owned world with durable Journal continuity, original-action reconciliation and progress protection.
The published interface exposes74 tools and1 Markdown playbook resource. Source/CI, installed modules, gameplay and package-layout evidence each retain their stated scope. Recorded local acceptance includes remote manufacturing and deliveries, normal solar-sail/rocket launches, nine selected stackable model rows with19 directed pairs, warehouse-layer filtering, real piler aggregation and save/recovery continuation. Detailed source-specific records are linked in the 0.5 review evidence and first-sail/rocket evidence.
Supported gameplay is single-player peaceful mode. Local acceptance used an owned non-sandbox1× world. Dark Fog/combat, multiplayer/Nebula, another computer, a separate Mod Manager/r2modman profile and installation transaction-crash restoration remain outside the verified scope.
Install and connect
- Install this package and its declared BepInEx dependency in the selected profile.
- Launch the modded profile once to generate configuration and the protected runtime descriptor.
- Register
BepInEx/plugins/Arcueid_77-Spherewright/Spherewright.Mcp.exeas a local stdio MCP server. - Read
spherewright://agent/playbooks/opening-movement-v1before operating. Keep descriptors, tokens and save identities in protected local storage. - The default mode provides observations. Enable
Safety.AllowWrites=truefor intended structured actions, then restart DSP normally.
A new owned world uses the normal peaceful, non-sandbox1× flow. Importing a player-loaded supported save additionally uses Safety.AllowUserSaveImport=true and explicit prepare/confirmation/commit. Import creates a separately verified owned copy through normal saving. Owned recovery binds the exact protected ticket and durable Journal. Disclosed migration and exceptional recovery retain their applicable confirmation gates.
Every write requires its fresh applicable Native plan. Keep the original accepted action ID and reconcile its terminal result before issuing dependent work. Materials, research, power, drones, game time and return reserves remain ordinary gameplay constraints. Historical failures and unknowns retain their original receipts.
Installation · Release notes · Releases · Source and issues. MIT licensed.
中文
Spherewright 通过 MCP 将外部 Agent 接入**《戴森球计划》**。此 Windows x64 包包含 Spherewright 0.5.0、BepInEx Plugin、配套自包含 Spherewright.Mcp.exe 及 Agent 指南。
版本与能力
支持 DSP 0.10.35.29151 和 BepInEx 5.4.17。准确源码提交及各程序文件校验值记录在 spherewright-manifest.json,Plugin 与 MCP 须来自同一构建。
- 观察生产、供电、物流、科研及原生探索可见恒星,按明确物料、能源及返航储备规划有限航线和工厂。
- 通过新鲜 prepare/commit 执行有限正常跨星航行、原生翘曲器补给、当地施工、物流站配置及运输观察。
- 检查和配置首帆/运载火箭链,观察真实飞行、太阳帆云及最小接收节点。
- 建造和检查原生叠放及兼容宿主。配置准确的大小仓层,或通过配送器选择父层,逐层观察库存、液体、研究站及设备状态。
- 使用原生业务操作反向空的集装机带路径,并以准确数量/增产点守恒将背包单件物品放入空带。
- 诊断行走卡住,获取有界、无令牌的短路线几何预览,每段通过独立新鲜普通移动执行。
- 以持久 Journal、原动作核销及进度保护恢复准确 owned 世界。
公开接口为74工具和1份 Markdown 指南资源。源码/CI、已加载程序、玩法与包布局证据分别适用于声明范围。本机记录涵盖外星制造运输、正常首帆/火箭发射、9种选定叠放模型及19有向组合、仓储分层筛选、真实集装机合堆和保存恢复续接。具体来源见0.5交审记录和首帆/火箭记录。
支持单人和平模式,本机验收使用 owned、非沙盒1×世界。黑雾战斗、多人/Nebula、另一台计算机、独立 Mod Manager/r2modman profile 和安装事务崩溃恢复仍在已验证范围之外。
安装与连接
- 在选定 profile 安装本包及声明的 BepInEx 依赖。
- 启动该 modded profile 一次,生成配置和受保护运行时描述文件。
- 将
BepInEx/plugins/Arcueid_77-Spherewright/Spherewright.Mcp.exe注册为本地 stdio MCP 服务。 - 操作前读取
spherewright://agent/playbooks/opening-movement-v1,将描述文件、令牌和存档身份保留于保护本地。 - 默认提供观察功能。需要结构化写入时启用
Safety.AllowWrites=true,再正常重启 DSP。
新 owned 世界沿正常和平、非沙盒1×流程创建。导入玩家已载入的受支持存档另外启用 Safety.AllowUserSaveImport=true,并沿明确的 prepare/确认/commit 流程通过正常保存创建独立核验副本。Owned 恢复绑定准确保护票据和持久 Journal,已披露版本迁移及特殊恢复保留各自确认门。
每笔写入使用新鲜、适用的原生方案。保留原接受动作 ID,先核销其终态,再执行依赖步骤。物料、科研、电力、无人机、游戏时间及返航储备均沿正常玩法约束。历史失败和 unknown 保留原回执。