Spherewright

English · 中文

English

Spherewright connects an external Agent to Dyson Sphere Program through MCP. This Windows x64 package contains Spherewright 0.4.0: a BepInEx Plugin, matching self-contained Spherewright.Mcp.exe, and the Agent playbook. End users need no source checkout or .NET SDK.

Version and support

This 0.4 package targets DSP 0.10.35.29151 and BepInEx 5.4.17. Its exact source commit and payload hashes are recorded in spherewright-manifest.json; keep every component from that build together. Historical production-acceptance source 2a7a98d1932c404e3a7abc2c11233d9c0b8780d9 passed its declared 29145 local manual/Thunderstore-layout installation, runtime, same-version recovery and continuous-supply acceptance. See the validation summary and native compatibility reports. Evidence applies only to its stated source, native version and scope.

Supported gameplay is single-player peaceful mode. Sandbox/resource-multiplier settings are reported without adding sandbox actions. Actual 0.4 live evidence is limited to one owned non-sandbox 1× local world; v0.3.3's broader local import examples retain their historical scope. A separate Mod Manager/r2modman profile, another computer, installation transaction-crash recovery, Dark Fog/combat, multiplayer/Nebula and broad third-party Mod compatibility are unvalidated.

Install and connect

1. Install the selected Spherewright package and its declared BepInEx dependency in your chosen profile; use a trusted release or reviewed local archive.
2. Launch the selected modded profile once to create configuration and the protected runtime descriptor.
3. Locate BepInEx/plugins/Arcueid_77-Spherewright/Spherewright.Mcp.exe in that profile and register it as a local stdio MCP server.
4. Never pass a descriptor, token or save identity on the command line. Keep Plugin and MCP from the same build.
5. Default mode is observation-only. Enable Safety.AllowWrites=true for intended structured actions, then restart DSP normally. Never overwrite loaded DLLs.

New, imported and owned worlds

For a new world, leave DSP at the idle menu and prepare the ordinary new-game flow: peaceful, non-sandbox, 1× Spherewright_New_*. Read the opening playbook before moving.

To import a player-loaded supported peaceful save, additionally enable Safety.AllowUserSaveImport=true, restart and manually load it. Prepare import, review the disclosure, then explicitly confirm in a later message. Commit creates and verifies an independent Spherewright_Imported_* copy through normal saving; the original is unchanged and Journal history begins at import.

To resume an owned primary, use its exact protected ticket, identity and durable Journal from the idle menu. Same-version resume is the default. Disclosed migration/expired recovery needs later explicit confirmation. Reauthorization durably consumes its ticket before native loading; normal Journal-bound default resume consumes it after native adoption and confirmed Journal continuity. Reconcile failed/interrupted accepted actions without rekeying or replaying.

Agent use and limits

Read spherewright://agent/playbooks/opening-movement-v1 before acting. A useful request is: “Read the current state and playbook, explain the next bounded phase, and execute only actions already authorized for that phase. Reconcile every accepted action and save according to the declared rules.”

Observation and planning do not grant write authority. No item/energy/technology injection, instant construction, teleportation, direct buffer editing, arbitrary save picker or autonomous expansion loop is provided. Interstellar flight/logistics remains future work.

Installation · Releases · Source/issues · Fixed Lab evidence. MIT licensed.

中文

Spherewright 通过 MCP 将外部 Agent 接入**《戴森球计划》**。此 Windows x64 包包含 Spherewright 0.4.0：BepInEx Plugin、配套自包含 Spherewright.Mcp.exe 及 Agent 指南。用户不需要源码或 .NET SDK。

版本与支持范围

此 0.4 包面向 DSP 0.10.35.29151 和 BepInEx 5.4.17。准确源码提交与 payload hash 记录在 spherewright-manifest.json，全部组件须来自该同一构建。历史生产验收源码 2a7a98d1932c404e3a7abc2c11233d9c0b8780d9 已通过规定的 29145 本机手动/Thunderstore 布局安装、运行、同版本恢复和连续供给验收，见验收摘要及原生兼容报告。证据只适用于声明的源码、原生版本和范围。

支持单人和平模式。沙盒和资源倍率会被报告，不增加沙盒动作。0.4 实机证据限于一个 owned、非沙盒、1× 本机世界；v0.3.3 较广的本机导入示例保留历史范围。独立 Mod Manager/r2modman profile、另一台计算机、安装事务崩溃恢复、黑雾战斗、多人/Nebula 和广泛第三方 Mod 兼容尚未验证。

安装与连接

1. 在选定 profile 安装对应 Spherewright 包及其声明的 BepInEx 依赖，使用可信发行或已审核本地包。
2. 从选定 modded profile 启动一次游戏，生成配置与受保护运行时描述文件。
3. 在该 profile 找到 BepInEx/plugins/Arcueid_77-Spherewright/Spherewright.Mcp.exe，注册为本地 stdio MCP 服务。
4. 不在命令行传入描述文件、token 或存档身份。Plugin 与 MCP 必须来自同一构建。
5. 默认仅观察。准备授权结构化动作时启用 Safety.AllowWrites=true，再正常重启 DSP。不要覆盖已加载 DLL。

新档、导入与 owned 世界

新档时让 DSP 停在空闲菜单，准备正常新建流程：和平、非沙盒、1× 的 Spherewright_New_* 世界。首次移动前阅读开局指南。

导入玩家已载入的受支持和平存档时，另行启用 Safety.AllowUserSaveImport=true，重启并手动载入。prepare 后阅读披露，并在后续消息明确确认。commit 通过正常保存创建并核验独立 Spherewright_Imported_* 副本，原档不变，Journal 从导入开始。

恢复 owned 主档时，在空闲菜单使用精确受保护票据、身份和 durable Journal。默认同版本恢复。已披露迁移或过期恢复须后续明确确认。重新授权在原生加载前持久消费票据；正常 Journal 绑定的默认恢复在原生接管并确认 Journal 连续性后消费。失败或中断的 accepted action 核原结果，不换键或重放。

Agent 使用与限制

操作前阅读 spherewright://agent/playbooks/opening-movement-v1。可向 Agent 要求：“读取当前状态和指南，说明下一个有限阶段，只执行该阶段已授权动作，核销每个 accepted action，并按声明规则保存。”

观察和规划不授予写入权限。不提供物品/能量/科技注入、瞬间施工、传送、直接缓冲编辑、任意选档或自主扩产。实际跨恒星航行与物流属于后续工作。

安装 · 发行 · 源码与反馈 · 固定 Lab 证据。使用 MIT 许可。

0.4.0

English · 中文

English

• Bounded multi-planet production, power, logistics and research summaries; native 600-tick measurements, runtime theoretical capacity, utilization and root-cause classification.
• Same-/cross-planet upstream tracing, privacy-allowlisted Overseer bundles and protected per-save logistics-progress windows.
• Runtime-recipe Foundry material drafts with shared-input demand, machine/base-power budgets, explicit external supplies/byproducts and non-executable site/dependency previews.
• Finite native blueprint construction/cancel/fresh continuation with per-object progress, ordinary materials/drones and explicit transport/cost/dependency composition.
• Supported same-family manufacturing-assembler and Mk.I→Mk.II basic-sorter upgrades. Belt/advanced stacking-sorter upgrades are outside the subset.
• Governor pre-execution declarations and continuous game-tick observations; no autonomous expansion.
• Durable Journal-bound tickets and exact owned-primary migration pairs, including 29131 → 29145 v6 disclosure. Reauthorization requires later explicit confirmation and durable ticket consumption before loading; normal Journal-bound default resume consumes after native adoption and confirmed continuity. Compatibility maintenance adds only expired-primary 29145 → 29151, its fifth durable transition and proved completed-history retention; source-specific runtime evidence remains separate from frozen production acceptance.

Historical production-acceptance source is 2a7a98d1932c404e3a7abc2c11233d9c0b8780d9, native 0.10.35.29145. Local three-stage construction with genuine mid-plan recovery, final automatic supplies/kit, both frozen package-layout installation/runtime/recovery checks and a same-session 36060-tick joint-supply window passed their declared scopes. Historical blueprint/Governor results remain separate proofs. See the production validation and native compatibility reports; those results apply only to their cited source and scope.

Separate Mod Manager profiles, another computer, installation transaction-crash recovery and a true stationary-carrier-600-tick positive live branch remain unverified. Dark Fog/combat, multiplayer/Nebula and broad third-party compatibility are outside validation; actual interstellar flight/logistics is future work.

中文

• 有界多行星生产、供电、物流和科研摘要；原生 600-tick 测量、运行时理论容量、利用率及根因分类。
• 同星球与跨星球上游追踪、隐私白名单 Overseer 诊断包及逐存档受保护物流进度窗口。
• 基于运行时配方的 Foundry 材料草案，覆盖共享输入需求、设备/基础功率预算、明确外供/副产物和不可执行场地/依赖预览。
• 有限原生蓝图施工、取消和 fresh 续建，保留逐对象进度、普通材料/无人机及明确运输、成本和依赖组合。
• 支持同族制造台及 Mk.I→Mk.II 基础分拣器升级；传送带和高级堆叠分拣器升级不在子集内。
• Governor 执行前声明及连续游戏 tick 观察，不自主扩产。
• durable Journal 绑定票据及精确 owned 主档迁移对，包括 29131 → 29145 v6 披露；重新授权要求后续明确确认及加载前持久消费票据，正常 Journal 绑定的默认恢复在原生接管并确认连续性后消费。兼容维护仅新增过期主档 29145 → 29151、第五次持久转换及已证明的完成历史保留；逐源码的实机证据与冻结生产验收分别记录。

历史生产验收源码为 2a7a98d1932c404e3a7abc2c11233d9c0b8780d9，原生版本为 0.10.35.29145。本机三级施工与真正中途恢复、最终自动供给/套件、两份冻结包布局的安装运行恢复及同 session 连续 36060-tick 联合供给窗均在声明范围通过。旧蓝图/Governor 结果仍是独立证明，见生产验收及原生兼容报告；这些结果仅适用于各自引用的源码和范围。

独立 Mod Manager profile、另一台计算机、安装事务崩溃恢复及真正 stationary-carrier-600-tick 实机阳性分支仍未验证。黑雾战斗、多人/Nebula 和广泛第三方兼容不在验收范围；实际跨恒星航行及物流属于后续工作。