Spherewright 0.3.3 — Gameplay Mode Compatibility

Spherewright v0.3.3 — Gameplay Mode Compatibility

中文

v0.3.3 是从不可变 v0.3.2 tag 制作的兼容性补丁。和平模式存档的沙盒状态和资源倍率仍会如实报告，但不再阻止已有的普通 MCP 动作、授权导入、计划重启恢复或飞行检查点恢复。本版本不开放沙盒工具，也不注入物品、能量、科技或设备缓冲。

同时增加了中英文 Mod README、可直接发给 Agent 的简短提示词、新档/旧档使用流程和双模型黑盒验收链接。包内 AGENT-PLAYBOOK.md 也从开局绕障扩展到会话入口、幂等/超时、能量与采集接近、施工/产线验收、保存和飞行恢复。

安装与使用

• Thunderstore Mod Manager / r2modman：安装 Arcueid_77-Spherewright，依赖为 xiaoye97-BepInEx-5.4.17。
• 手动安装：下载 Spherewright-0.3.3-win-x64.zip，关闭游戏后按Release 安装/升级/回滚说明操作。
• Spherewright 默认只读；操作游戏需设置 Safety.AllowWrites=true。导入玩家手动载入的旧档还需 Safety.AllowUserSaveImport=true，并在预检后的后续消息中明确确认；原档不会被覆盖。

验证

• 本机实机：新建非沙盒 1×、导入非沙盒 100×、导入沙盒 1× 三个和平单人世界，均以正常机制完成采集、手搓、科研、首座电塔施工和正常保存；两个外部原档保持不变。
• 自动回归：158/158（Bridge.Core 120、Contracts 15、MCP 23）。
• 完整 Release 构建：0 warning / 0 error。两种包体的 manifest、文件哈希、MCP initialize/tools/resources 和 playbook 内容检查通过。
• 源码提交：f0cd11105957ae63cb4b45fd5756b0a42508857f（sourceDirty=false）。

已知限制

支持范围为 Windows x64、DSP 0.10.34.28529、BepInEx 5.4.17、单人和平模式。不保证黑雾/战斗、多人或 Nebula、任意第三方 Mod 或跨恒星曲速自动化。Harvest 的内部自动接近尚未具有 Move 的短窗看门狗；着陆舱或密集设备附近应按 playbook 先用短切向 waypoint 绕行。本发布声明本机实机证据，不声称完成了独立异机验证。

English

v0.3.3 is a compatibility patch built from the immutable v0.3.2 tag. Sandbox state and resource multiplier remain visible evidence for peaceful saves, but no longer block the existing ordinary MCP actions, authorized import, planned restart, or flight-checkpoint recovery. This release does not expose sandbox tools or inject items, energy, technologies, or device buffers.

It also adds a bilingual Mod README, a short copy-paste prompt for Agents, new-world and existing-save instructions, and the two-model black-box comparison. The packaged AGENT-PLAYBOOK.md now covers session entry, idempotency and host timeouts, energy and harvest approach, construction and production-line proof, saves, and flight recovery in addition to opening obstacle escape.

Install and use

• Thunderstore Mod Manager / r2modman: install Arcueid_77-Spherewright; its dependency is xiaoye97-BepInEx-5.4.17.
• Manual install: download Spherewright-0.3.3-win-x64.zip, close the game, and follow the release installation, upgrade, and rollback guide.
• Spherewright starts read-only. Set Safety.AllowWrites=true for gameplay actions. Importing a player-loaded save additionally requires Safety.AllowUserSaveImport=true and explicit confirmation in a later message after prepare; the original save is never overwritten.

Validation

• Local live runs covered a fresh non-sandbox 1× world, an imported non-sandbox 100× world, and an imported sandbox 1× world, all peaceful and single-player. Each used ordinary mechanics for harvesting, handcrafting, research, first Tesla-tower construction, and normal saving; both external originals remained unchanged.
• Automated regression: 158/158 (Bridge.Core 120, Contracts 15, MCP 23).
• Full Release build: 0 warnings / 0 errors. Both packages passed manifest, file-hash, MCP initialize/tools/resources, and packaged-playbook checks.
• Source commit: f0cd11105957ae63cb4b45fd5756b0a42508857f (sourceDirty=false).

Known limitations

The supported scope is Windows x64, DSP 0.10.34.28529, BepInEx 5.4.17, and peaceful single-player. Dark Fog/combat, multiplayer or Nebula, arbitrary third-party Mods, and cross-star warp automation are not guaranteed. Harvest's internal automatic approach does not yet share Move's short-window watchdog; near the landing capsule or dense buildings, follow the playbook and take a short tangent waypoint first. This release claims the documented local live evidence, not a separate cross-computer run.

Assets

• Spherewright-0.3.3-win-x64.zip
  SHA-256: c818b0c6f5656c01dfcf263e49000b2197f95094379521c6d3523b2507bbe1ef
• Spherewright-0.3.3-thunderstore.zip
  SHA-256: 5272d6a1c489b4fb8f3fad75fd729c919627137a4f4c30a676cd71da36844be2

Spherewright 0.3.2 — New World Naming and Opening Recovery

What changed

• New Agent-created worlds now use Spherewright_New_*; imported player-save copies remain Spherewright_Imported_*.
• Legacy Spherewright_M0_* saves remain compatible with exact protected resume. Ownership never depends on a filename prefix.
• Adds a packaged and MCP-discoverable opening-movement playbook for bounded recovery from landing-base and local-obstacle stalls.
• Move stall results now include structured failure and recovery fields instead of relying on message text alone.
• Documents the supported new-world and explicitly confirmed player-save import flows.

Validation

• Release-package integrity test passed: product 0.3.2, MCP 0.3.2.0, 50 tools, one MCP resource, 233 manifest files.
• Local clean-package live validation passed from a fresh peaceful, non-sandbox, 1× world with no repository or prior gameplay ledger available to the Agent.
• The Agent progressed from landing through powered iron/copper mining, smelting, automatic magnetic-coil and circuit-board production, and sustained automatic Electromagnetic Matrix output into storage.
• In the frozen-input acceptance window, dedicated output storage grew 67 → 88 → 106; the normal milestone save completed and read back as owned, saved, and healthy.
• A second independent Luna Max validation is still running and is not counted as completed evidence in this release.
• Cross-computer live validation of the explicitly confirmed save-import flow remains outstanding.

Supported scope

Windows x64; Dyson Sphere Program 0.10.34.28529; BepInEx 5.4.17.0; single-player, peaceful, non-sandbox, 1× resources.

Dark Fog/combat, sandbox, multiplayer/Nebula, non-1× resources, broad third-party Mod compatibility, arbitrary save picking, and arbitrary save-name loading are not guaranteed.

Download integrity

Spherewright-0.3.2-win-x64.zip

SHA-256: 144add858a16becd17cd8b842108e9c3397d5e9b04700e05db0f967e8e890260

Spherewright 0.3.1 — Authorized Save Import

Spherewright 0.3.1 is a validation prerelease that backports one narrowly scoped compatibility feature onto the immutable v0.3.0 Logistics Towers baseline: an explicit, conversation-confirmed handoff for a save the player has already loaded manually.

What changed

• Adds spherewright_prepare_save_import and spherewright_commit_save_import.
• Prepare has no game or save side effect. It binds the exact restricted process/session/revision/GameData instance and returns the disclosure the Agent must show before asking the user.
• Commit is allowed only after a subsequent explicit confirmation in the conversation and both boundary acknowledgements. It consumes a short-lived, single-use plan and uses DSP's normal save API to create a new high-entropy Spherewright-owned copy.
• The original save is never accepted by the public API, enumerated, actively loaded, overwritten, renamed, deleted, returned, or logged.
• The new per-save journal starts at the import boundary with incomplete historical coverage; it never fabricates earlier first-item, technology, or upgrade events.
• Adds the separate Safety.AllowUserSaveImport=false opt-in. Safety.AllowWrites=true is also required.
• No v0.4 Overseer feature is included in this backport.

Release validation

• Source commit: 33a733f4b4d07d3d916946426b4e4905c60e4954, directly based on annotated tag v0.3.0 (a52ff440b47830f2f3a06a5ae97c7ff11bd15833).
• Full Release solution build against DSP 0.10.34.28529: 0 warnings, 0 errors.
• 127 tests passed: 15 Contracts, 92 Bridge.Core, and 20 MCP.
• The self-contained Windows package reports product 0.3.1, MCP server 0.3.1.0, protocol 2025-06-18, and 50 tools.
• Package extraction, all 232 manifest entries, MCP initialize, and tools/list passed an independent smoke test; sourceDirty=false.
• ZIP SHA-256: b05eabb20928e98850f6792ea001149fd2e30c92082994e6d9c43254e611cdcf.

Cross-computer validation still required

No live save import was executed while producing this build. It is deliberately marked prerelease so the project owner can test it on another computer. The live test should prove all three boundaries: the original save header remains unchanged, the new owned copy can be normally saved and resumed, and manually re-entering the original returns to restricted/unowned state. Please keep an independent backup of the original save for this first validation.

Install and use

The package targets Windows x64, Dyson Sphere Program 0.10.34.28529, and BepInEx 5.4.17.0. Close DSP, verify the attached SHA-256 sidecar, extract the ZIP, and follow INSTALL.md or the repository installation guide. The self-contained MCP executable does not require the repository or a .NET SDK.

For import testing, set both Safety.AllowWrites=true and Safety.AllowUserSaveImport=true, then restart DSP. Manually load the intended peaceful, non-sandbox, 1× save. The Agent must prepare the exact restricted session, show the returned disclosure, ask you in the conversation, and wait for your next explicit confirmation before committing. There is no hotkey, authorization code, save picker, or arbitrary save-load API.

Spherewright remains experimental. Broad game-version, third-party Mod, multiplayer, combat, and non-Windows compatibility are not guaranteed.

Spherewright 0.3.0 — Logistics Towers

Spherewright 0.3.0 delivers the Logistics Towers milestone.

Highlights:

• Authenticated current-user-only Bridge and a 48-tool MCP surface for structured observation and bounded normal-game actions.
• Two-phase, idempotent logistics-station configuration and conservation-checked fleet transfers.
• Live-validated planetary drone delivery and same-star interstellar vessel delivery of titanium and silicon.
• Native checkpointed interplanetary flight with bounded recovery and retired checkpoints after successful covering saves.
• Per-save durable gameplay journal, protected exact-owned-world restart, and Windows Core CI.
• Self-contained Windows x64 MCP executable plus verified Plugin installer; no source checkout or .NET SDK required for users.

Release validation:

• 119 tests passed (14 Contracts, 86 Core, 19 MCP).
• Full DSP solution build: 0 warnings, 0 errors.
• Final 228-file runtime payload matched the clean package byte-for-byte after installation.
• Wrong-token rejection, live Plugin 0.3.0 handshake, installed MCP 0.3.0.0 live call, normal close, protected same-save resume, and automatic covering save all passed.

Validated against Dyson Sphere Program 0.10.34.28529, BepInEx 5.4.17.0, Windows x64, peaceful non-sandbox 1x resources. This is still experimental and has no broad compatibility guarantee.

Verify the ZIP with the attached SHA-256 sidecar before installation. See INSTALL.md inside the archive or the repository installation guide.