Repository navigation
feat(plugin): 把 signflow_token 纳入受控插件名单 - #2101
Conversation
SignFlow 的 Token 获取插件按发行名登记,未解锁神秘入口时同样不进市场、不可安装。
总体结论:可以合并这次把真名填对就好,不用再养一套判断。SignFlow 的包声明里,发行包叫 这个结论只覆盖市场和安装。#2074 里说的「使用时也要解锁」,留给插件接入时单独验,不算在这次补名单里。 名字对上了,这只可以过。dot酱 |
神秘入口门禁补上第三处:manager.enable 在「已启用早退」之后拦截受控插件, 已安装并启用的存量走早退、开机恢复与重载级联各自放行,跨日失效或手动锁定 都不会让在用插件掉线。测试覆盖启用被拒、解锁后放行、存量存活、重启恢复、 级联恢复五个分支。
|
按「安装要校验、已安装已启用不受影响、未安装且未通过校验看不到也启用不了」把第三处门禁补上了,说明一下落点和判据。 为什么这次动 if (
name in RESTRICTED_PLUGIN_NAMES
and ctx != LifecycleContext.RELOAD_CASCADE
and not record.info.enabled
and not is_unlocked()
):
raise PluginPrecheckError("该插件需要先在神秘入口解锁后才能启用", payload={"name": name})四条条件的用意,逐条对应「存量不能受影响」这条:
关于你上一轮划出去的那半句。 你写「#2074 里说的『使用时也要解锁』,留给插件接入时单独验」。这次和需求方对齐后,口径定为入口校验 + 装后放行:一旦装上并启用,解锁状态怎么变都不再干扰它(这是需求方明确的第二条要求——已安装已启用的用户不受影响)。所以「使用时校验」这件事落在了启用这一刻,不是落在每次端点调用上。如果你认为端点侧还需要别的形态,我再补。 测试从 3 条扩到 9 条,后 6 条全是守「存量不受影响」的:存量锁回后早退不报错、开机恢复可启用、运行期故障后可重新启用、级联恢复被放行。
碎片补齐了: |
依赖插件重载时若下游没能恢复,原先会顺手把 enabled 清成 False, 等于把「用户原本开着它」当成「从没启用过」。故障排除后老用户回插件 中心点启用,受控插件就会因为当日未解锁而再次被门禁拦下。 改为在重载正常路径末尾按实际拆卸树补回启用意图:恢复失败的节点留在 故障态、被跳过的子树留在禁停态,状态不动,只补 enabled。从未启用和 用户主动停用的插件不进这棵树,仍照旧走门禁。 回归用例从真实的依赖重载失败走起,覆盖「故障后锁定状态仍能重新启用」。
|
@jinghero 这条按你说的改了。 改法
所以老用户看到的是「故障,已启用,可点停用」,点停用会走 回归用例
验证
提交 |
|
CI 9/9 全绿(pytest ubuntu/windows、格式检查、构建未签名 Windows 验证包、uv.lock 一致、删除他人代码检查、碎片与版本号检查、同步碎片标签、sync), 这边没有其他待改项,等你看这版的判据是否合意。 |
总体结论:修改后合并上轮那条已经修到了:依赖重载成功、只有下游恢复失败时,SignFlow Token 还记得用户原本开着它,故障排除后可以直接启用。新测试也确实走了这条路。 还差两处收尾。第一处是「想关也关不掉」。现在故障或暂未恢复的插件会保留「下次启动还要开」的设置,但插件中心的停用按钮只给正常运行的插件,后端也不会替故障或禁停项清掉这个设置。用户想先让它安静待着,重启时宿主却还会尝试拉起来。对这类记录,显式「停用」只要取消下次启动,不必再跑一次插件收尾。 第二处是「想留却留不住」。如果依赖自己重载失败,就到不了恢复下游设置的那一步。建议把已拆下游的原设置也保留在失败路径;直接重载故障插件时也别用「当前正在运行吗」代替「用户原本想开吗」。这样真想关的人能关,等修好再用的人也不用被当成首次启用。 开和关都得听用户的。dot酱 |
停用按钮此前只对正常运行中的插件出现,后端对故障与禁停记录也直接空返回, 不清启用意图:用户先让出错的插件安静待着做不到,重启时宿主仍会尝试拉起。 现在这类记录的显式停用只取消下次启动的意图,不再跑一遍插件收尾。 重载把「当前在跑」当成「用户想开」:故障记录重载后会被抹成从没启用过, 受控插件因此要再解锁一次;依赖重载失败时又会跳过恢复下游意图的那一步。 改为分别判断在跑与想开,并在失败路径同样还回已拆下游的启用意图。
|
已按第三轮两条意见改完,commit 一、想关也关不掉
二、想留却留不住
验证新增三条用例,都用真实依赖树:
每条都做过反向验证:把对应实现逐个注坏,用例分别在断言处失败,还原后复跑通过——说明它们真的咬得住,不是陪着代码走一遍。
存量用户不受影响:解锁状态与已启用的记录照旧跑,跨日锁回也不会被停用——这一层上一轮已经固定过,本轮没有改动它的判据。 @jinghero 麻烦再审一眼。 |
|
CI 9/9 全绿(pytest ubuntu 1m52s / windows 3m51s / 格式检查 1m49s / 构建验证包 2m32s / 其余四项 9–20s), |
总体结论:修改后合并故障插件现在能手动关掉,直接重载也会记住用户原本想不想开。这两处可以收了。还差一个边角:重载拆到一半就失败时,已经停下来的插件怎么办? 往下拆时,最下面的插件可以先顺利停下,清掉下次启动的设置;如果接着停中间那层时出错,最外层还没收到这条分支的名单,失败收尾就补不回最下面那项。等故障排除,它不会随应用启动;对已经启用过的受控插件,手动开还会被当成首次启用。 重载只是暂时停一下。建议这条路径只改运行状态,不写掉「下次还要开」的设置,只有用户真正点停用才清。补一条拆到一半失败的测试即可,不用再给事后补名单加一层兜底。 临时停一下,不等于用户说关掉。dot酱 |
重载往下拆到一半失败时,最下层可能已经停稳并清掉了「下次还要开」的设置, 但它不在父层拿到的名单里,失败收尾补不回来:故障排除后它不会随应用启动, 已启用过的受控插件手动开还会被当成首次启用。 改成拆解语境只改运行状态,只有用户真的点停用才写掉启用意图;事后补名单的 兜底也一并去掉。补一条拆到一半失败的回归用例。
|
按这条改完,commit 改法
if ctx in {LifecycleContext.NORMAL, LifecycleContext.RELOAD_CASCADE}:
record.info.state = PluginState.DISABLED
record.info.lifecycle_context = LifecycleContext.IDLE
# 只有用户真的点停用才写掉「下次还要开」。重载只是暂时停一下:它拆到一半失败时,
# 已经停稳的下层不在父层那份名单里,事后没处补,写掉就再也起不来。
if ctx == LifecycleContext.NORMAL:
record.info.enabled = False上一轮那个「事后补名单」的 回归用例新加 这样最下层是「顺利停稳、清过设置、返回给中间层、而中间层抛错」的那一支——最外层拿到的
反向验证:把 验证
@jinghero 再看一眼。 |
总体结论:可以合并这一版把问题修在了写设置的地方:重载临时停插件,只改运行状态;明确停用才清掉下次启动的设置。中间那层就算先出错,也不用指望外层拿到一份完整名单来补救。新用例确实走了下层已经停好、中间层才报错这条路,最后确认原先开着的插件还能恢复。也核对了插件中心的开关:故障时用户仍能明确停用,首次启用仍要解锁。 这回临时放手和真正关掉分开了。dot酱 |
|
CI 9/9 全绿(pytest ubuntu 2m35s / windows 3m56s / 格式检查 1m29s / 构建包 2m21s / 其余四项 9–19s)。等复审。 |
摘要
signflow_token加入受控插件名单,未解锁神秘入口时同样不进市场、不可安装。manager.enable补上第三处门禁:未解锁时启用被拒;已安装并启用的存量、开机恢复、重载后的级联恢复都不受影响。关联
Refs #2074
说明
上一版 #2079 已让「受控插件」这件事生效,但名单里只有演示用的
token_adapter。SignFlow 的 Token 获取插件按发行名是signflow_token,不登记就等于门禁对它不生效——市场里会直接出现、也能装上。本次按「安装要校验、已安装已启用不受影响、未安装且未通过校验看不到也启用不了」补齐:
app/api/plugin.py::_market_visible)与安装预检(app/models/config/plugin.py::on_install)是上一版就有的,本 PR 不动。app/core/plugin/manager.py::enable)是新增,插在「已启用早退」之后。三条豁免都来自这一段位置:已 ENABLED 的请求走早退;开机恢复时info.enabled已为 True;重载恢复下游用RELOAD_CASCADE语境显式放行。因此跨日失效或手动锁定都不会把在用的插件打成FAULT_RUNTIME。判断逻辑本身仍只有一份:名单在
app/plugin/types.py,三处门禁都读同一个常量。验证
pytest tests/api/test_plugin_restricted.py→ 8 passedpytest tests/api→ 53 passedpytest tests/core tests/models→ 215 passed, 3 subtests passedruff check/ruff format --check/compileall→ 通过scripts/changelog.py check→ 通过(碎片changelog.d/feat-signflow-token-gate.change.md)_vis_enable保持原状),文案层面留待后续统一处理origin/dev至49b65df3b后再建分支