Repository navigation
中文
[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 asopencode-piggy@latest. - Follow official dsh-piggy 0.37.2-rc.5 (desktop shell 0.6.8-rc.3), discovering the unified
piggy/work-endpointdirectory first. - Linux game discovery follows an absolute
XDG_DATA_HOME, defaulting to~/.local/share/piggy/work-endpoint. Windows and macOS use%APPDATA%/piggy/work-endpointand~/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
@nextor a pinned RC, remove the old install target before addingopencode-piggy@latest; the plugin queue is preserved. - If the new directory has no discovery file, discovery still falls back to
dsh-piggy/work-endpointand thendsh-piggy-desktop/work-endpointunder the old configuration root. gameDirectoryandPIGGY_USERDATAkeep taking priority; update explicit paths that still point to an old directory when the game moves. Start the game with--work-eventsas before.
Install
opencode plugin add opencode-piggy@latestOffline 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.