Skip to content

OpenCode Piggy v0.2.0

Latest

Choose a tag to compare

@github-actions github-actions released this 29 Oct 19:15

中文

[0.2.0] - 2026-10-30

Features

  • 第三方 agent 工作事件接口已转正,插件以正式版发布到 npm latest,安装目标为 opencode-piggy@latest。
  • 跟进官方 dsh-piggy 0.37.2-rc.5(桌面外壳 0.6.8-rc.3),优先发现统一的 piggy/work-endpoint 目录。
  • Linux 游戏发现遵循绝对路径的 XDG_DATA_HOME,默认使用 ~/.local/share/piggy/work-endpoint。Windows 和 macOS 分别使用 %APPDATA%/piggy/work-endpoint 和 ~/Library/Application Support/piggy/work-endpoint。

Design Rationale

  • 游戏数据目录由官方桌面外壳管理;插件跟随其默认位置,不迁移游戏数据或插件队列。
  • 工作事件协议仍为 v1,事件格式、稳定 ID、提交确认与七天离线窗口保持不变。

Notes & Caveats

  • 从 @next 或固定 RC 版本升级时,先移除旧安装目标,再添加 opencode-piggy@latest;插件队列保留。
  • 新目录没有发现文件时,仍依次回退到旧配置目录下的 dsh-piggy/work-endpoint 和 dsh-piggy-desktop/work-endpoint。
  • gameDirectory 和 PIGGY_USERDATA 保持优先;显式指向旧目录的配置需要随游戏实际位置更新。启动游戏时仍需 --work-events。

安装

opencode plugin add opencode-piggy@latest

离线归档

下载任一压缩包并解压,将 OpenCode 配置中插件项的 package 指向解压后 package/ 目录的绝对路径。

游戏要求与配置方法见 README。


English

[0.2.0] - 2026-10-30

Features

  • With the third-party agent work-event API now stable, the plugin ships as a stable release on npm latest, installed as opencode-piggy@latest.
  • Follow official dsh-piggy 0.37.2-rc.5 (desktop shell 0.6.8-rc.3), discovering the unified piggy/work-endpoint directory first.
  • Linux game discovery follows an absolute XDG_DATA_HOME, defaulting to ~/.local/share/piggy/work-endpoint. Windows and macOS use %APPDATA%/piggy/work-endpoint and ~/Library/Application Support/piggy/work-endpoint, respectively.

Design Rationale

  • The official desktop shell manages game data paths; the plugin follows its defaults without migrating game data or the plugin queue.
  • The work-event protocol remains v1, so event payloads, stable IDs, commit acknowledgements and the seven-day offline window stay unchanged.

Notes & Caveats

  • To upgrade from @next or a pinned RC, remove the old install target before adding opencode-piggy@latest; the plugin queue is preserved.
  • If the new directory has no discovery file, discovery still falls back to dsh-piggy/work-endpoint and then dsh-piggy-desktop/work-endpoint under the old configuration root.
  • gameDirectory and PIGGY_USERDATA keep taking priority; update explicit paths that still point to an old directory when the game moves. Start the game with --work-events as before.

Install

opencode plugin add opencode-piggy@latest

Offline archives

Extract either archive and set the plugin entry’s package in your OpenCode configuration to the absolute path of the extracted package/ directory.

See the README for game requirements and configuration.