Skip to content

[Bug] bili plugin install/remove opencode 会静默删除 plugins 数组里的对象形态条目({package, options} 一起丢) #1002

Closed

Description

@milk2715093695

本 issue 由 AI 生成(opencode 智能体),证据来自本机隔离环境实测与源码定位;提交与复现由账号本人确认。
This issue was drafted by AI (opencode agent). All evidence comes from a local reproduction and source reading.

现象

bili plugin install opencode(以及 bili plugin remove opencode)会把 opencode 配置里 plugins 数组中的对象形态条目整条删除,options 一起丢失;字符串条目正常保留。

最要命的是没有任何告警,甚至当 bili 自己那一条已存在时,输出还是 plugin present,用户完全看不出配置被改写了。

实际环境观测:plugins 从多条被改成 2 条,其中对象形态条目(含各自 options、含插件专有配置项)消失,字符串条目还在。下次启动时这些插件只是静默不加载,不报错、不提示。

JSONC 配置也一样:注释和尾逗号会被保留,对象条目照丢(见下 §根因 4)。

复现步骤

隔离 XDG 目录,最小配置(示例名与值均为占位):

{
  "plugins": [
    "example-plugin@latest",
    { "package": "./plugin-a", "options": { "endpoint": "https://example.invalid", "topic": "example", "events": { "on-idle": true } } },
    { "package": "./plugin-b", "options": { "map": { "/a": "/b" }, "limit": 14 } },
    "billion-context"
  ],
  "compaction": { "auto": false }
}
XDG_CONFIG_HOME=…/config XDG_DATA_HOME=…/data XDG_STATE_HOME=…/state XDG_CACHE_HOME=…/cache \
  BILI_CLIENT_BIN=<path>/opencode2 bili plugin install opencode

实际结果(实测):

opencode: installed -> …/config/opencode/opencode.json (mcp.bili not written …; plugin present; compaction.auto already disabled)

plugins =
[
 "example-plugin@latest",
 "billion-context"
]

两个对象条目(含 options)全部消失;输出里只有 plugin present。

紧接着 bili plugin remove opencode:

opencode: removed from …/opencode.json (plugin removed (billion-context); compaction restored from backup)

{ "plugins": [ "example-plugin@latest" ], "compaction": { "auto": false } }

对象条目同样没有回来(第二次运行也还是有损重写)。

期望:install/remove 只改动 bili 自己那一条;其余条目按原样(原类型、原 options、原顺序)保留;若确有条目被移除,输出明确告警。

根因定位(v0.1.122,dist/index.js)

  1. :73559 pluginEntries(data, key) 本是「取插件标识字符串列表」的读辅助:
if (Array.isArray(v2)) return v2.filter((x) => typeof x === "string");
if (v2 !== null && typeof v2 === "object") return Object.keys(v2);

对象形态条目在这一步就按类型被丢掉(plugins 若写成对象映射,则只剩键名)。

  1. applyOpencodePluginEntry 把这份有损结果当成了写回内容:
  • :73693 const kept = plugins.filter((p2) => !ours.includes(p2));
  • write() 定义在 :73694-73697;调用点 :73699 write([...kept, OPENCODE_NPM_ENTRY]);
  • 输出 plugin present 的早退分支(:73702)在 write() 之后,所以即使 billion-context 已存在,配置也已经被重写。

⇒ 整个数组被重写,非字符串条目必然丢失。重写只作用于本次写入的那个键(pickPluginKey,:73539-73541);remove 会同时看 plugin 与 plugins 两个键(:73542)。

  1. opencodeRemove 同一模式::73795 const entries = pluginEntries(data, key); → :73798 const remaining = entries.filter((p2) => p2 !== OPENCODE_NPM_ENTRY && p2 !== dir); → :73828 写回。

  2. 加重因素:writeOpencodeConfig(:73607)对合法 JSON 走 JSON.stringify(data, null, 2) 整份重写(:73615-73623),注释与排版一并被规范化;只有 JSONC(JSON.parse 失败)路径才用 applyEdits 保形(:73625-73629)。

  3. 安全网不足:backupOnce(:73057-73061)只在 opencode.json.bili-bak 不存在时生成一次,此后永不刷新(调用点 writeOpencodeConfig 内 :73610)⇒ 第二次安装时用户拿到的是过期备份。

影响面

  • 任何使用对象形态插件条目({ package, options })的用户,在跑一次 install/remove 后这些插件会静默不再加载;options 是插件专有配置的唯一来源(例如服务端点、订阅主题、事件开关、路径映射这类值),随条目一起丢失后只能靠备份手抄回来。
  • 触发路径:bili plugin install opencode、bili plugin remove opencode(--with-mcp 同路径)。
  • 日常自动升级不触发(只覆盖包目录,不写用户配置),所以问题是「手工装/卸那一下」才会踩。
  • 与 AGENTS.md §7.3 第一条相悖(原文:Never silently clobber or drop user config. Any read-modify-write on user config needs a parse-state guard; reject malformed input loudly (HTTP 400/409) instead of merging into defaults or dropping fields.)。本次正是「read-modify-write 没有 parse-state 保护、静默丢字段」。

修复建议

  • install/remove 在原始 JSON 上只增删自己那一条,不要拿 pluginEntries() 的返回值回写;或让 pluginEntries 保留未知条目并按原位写回。
  • 保留条目原类型与原位置(含 options),顺序稳定。
  • 有条目被移除时输出告警(可参考 stripLegacyOpencodeAcp 的 notes 写法)。
  • backupOnce 建议改为带时间戳、可刷新(或改写前后各留一份)。
  • 顺带:新增回归测试覆盖「配置里含 { package, options } 条目时 install/remove 后其它条目逐字节不变」。

环境

  • Bili Version: 0.1.122(/opt/homebrew/lib/node_modules/billion-context,npm 安装形态)
  • Opencode Version: v2.0.9(BILI_CLIENT_BIN=…/opencode2,写入 plugins 键)
  • OS: macOS arm64

附录

  • 复现环境为隔离 XDG 目录,未触碰真实配置;上文的插件名与配置值均为占位示例。
  • 同环境下 bili plugin list opencode 对 npm 裸名形态能正确显示 installed,因此本 issue 只针对写路径。

Activity

  1. ranxianglei commented on Sep 19, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 收到,已按审核流程先查证:在当前 master(v0.1.124,含 #995 single-writer guard)上逐行复核了 src/plugin-install.ts,问题属实,且比你报告的版本又新增了一处同样的调用点(#995 的 pluginUpdate opencode 分支也在用同一个有损读取):

    • pluginEntries(data, key)(src/plugin-install.ts:738)读取时就把非字符串条目过滤掉(对象形态直接丢,map 形态只剩 keys);
    • applyOpencodePluginEntry()(:917)和 opencodeRemove()(:1054)把这个有损列表当写回内容,并且 "plugin present" 的提前返回发生在 write() 之后——所以即使条目早已存在,文件仍被重写一遍;
    • 加重因素也属实:严格 JSON 目标是整文件 stringify 重写(:826-828),backupOnce(:69)只在首次写入留一份 .bili-bak,之后永不刷新。

    修复方向与你建议的一致,正在实现:install/remove 只增删 bili 自己的条目(字符串或 {package} 都能识别为"自己的"),其余条目原样保留(类型、options、顺序);条目已是规范形态时完全不碰文件(不重排、不重写);替换/移除条目时输出明确告警;.bili-bak 保持"安装前状态"语义不变(remove 依赖它恢复 compaction),另加带时间戳的可刷新快照;补上你说的回归测试(含 {package, options} 条目在 install/remove 后字节级不变的断言)。完成后在本线程贴 PR 链接。

  2. ranxianglei commented on Sep 19, 2026

    @ranxianglei
    Owner

    Confirmed on master (incl. #995) — all five findings reproduce exactly as reported, including the remove path deleting the whole plugins key when only object entries would remain (remaining.length === 0 counted strings only). Thanks for the precise line-level analysis.

    Fix delivered in #1005:

    • install/remove now operate on the raw plugin value — object entries ({package, options}) and map-form plugins survive verbatim in form and position; only bili's own entries are added/removed
    • "plugin present" short-circuits before any write, so an idempotent install leaves the file byte-identical
    • the key is deleted on remove only when nothing raw survives
    • .bili-bak re-snapshots on every write whose pre-write bytes differ from bili's own last output (.bili-last sidecar hash) — user edits refresh the backup, bili's consecutive writes do not, so install→upgrade→remove still restores your pre-install compaction value

    Pre-flight: typecheck ✅ · 1965 tests pass ✅ · build ✅. Riding the v0.1.125 release together with #995.

  3. added a commit that references this issue on Sep 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions