Repository navigation
Description
本 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)
:73559pluginEntries(data, key)本是「取插件标识字符串列表」的读辅助:
if (Array.isArray(v2)) return v2.filter((x) => typeof x === "string");
if (v2 !== null && typeof v2 === "object") return Object.keys(v2);对象形态条目在这一步就按类型被丢掉(plugins 若写成对象映射,则只剩键名)。
applyOpencodePluginEntry把这份有损结果当成了写回内容:
:73693const kept = plugins.filter((p2) => !ours.includes(p2));write()定义在:73694-73697;调用点:73699write([...kept, OPENCODE_NPM_ENTRY]);- 输出
plugin present的早退分支(:73702)在write()之后,所以即使billion-context已存在,配置也已经被重写。
⇒ 整个数组被重写,非字符串条目必然丢失。重写只作用于本次写入的那个键(pickPluginKey,:73539-73541);remove 会同时看 plugin 与 plugins 两个键(:73542)。
-
opencodeRemove同一模式::73795const entries = pluginEntries(data, key);→:73798const remaining = entries.filter((p2) => p2 !== OPENCODE_NPM_ENTRY && p2 !== dir);→:73828写回。 -
加重因素:
writeOpencodeConfig(:73607)对合法 JSON 走JSON.stringify(data, null, 2)整份重写(:73615-73623),注释与排版一并被规范化;只有 JSONC(JSON.parse失败)路径才用applyEdits保形(:73625-73629)。 -
安全网不足:
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
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 收到,已按审核流程先查证:在当前 master(v0.1.124,含 #995 single-writer guard)上逐行复核了
src/plugin-install.ts,问题属实,且比你报告的版本又新增了一处同样的调用点(#995 的pluginUpdateopencode 分支也在用同一个有损读取):pluginEntries(data, key)(src/plugin-install.ts:738)读取时就把非字符串条目过滤掉(对象形态直接丢,map 形态只剩 keys);applyOpencodePluginEntry()(:917)和opencodeRemove()(:1054)把这个有损列表当写回内容,并且 "plugin present" 的提前返回发生在write()之后——所以即使条目早已存在,文件仍被重写一遍;backupOnce(:69)只在首次写入留一份.bili-bak,之后永不刷新。修复方向与你建议的一致,正在实现:install/remove 只增删 bili 自己的条目(字符串或
{package}都能识别为"自己的"),其余条目原样保留(类型、options、顺序);条目已是规范形态时完全不碰文件(不重排、不重写);替换/移除条目时输出明确告警;.bili-bak保持"安装前状态"语义不变(remove 依赖它恢复 compaction),另加带时间戳的可刷新快照;补上你说的回归测试(含{package, options}条目在 install/remove 后字节级不变的断言)。完成后在本线程贴 PR 链接。ranxianglei commentedon Sep 19, 2026
Confirmed on master (incl. #995) — all five findings reproduce exactly as reported, including the remove path deleting the whole
pluginskey when only object entries would remain (remaining.length === 0counted strings only). Thanks for the precise line-level analysis.Fix delivered in #1005:
{package, options}) and map-formpluginssurvive verbatim in form and position; only bili's own entries are added/removed.bili-bakre-snapshots on every write whose pre-write bytes differ from bili's own last output (.bili-lastsidecar hash) — user edits refresh the backup, bili's consecutive writes do not, so install→upgrade→remove still restores your pre-installcompactionvaluePre-flight: typecheck ✅ · 1965 tests pass ✅ · build ✅. Riding the v0.1.125 release together with #995.
Merge pull request #1005 from ranxianglei/2026-09-19_opencode-plugin-…
fix: opencode plugin install/remove preserves foreign entries verbatim (
fix: update lane re-pins the opencode entry to the resolved npm latest (
fix: update lane re-pins the opencode entry to the resolved npm latest (
fix: update lane re-pins the opencode entry to the resolved npm latest (