Skip to content

feat(plugin): 把 signflow_token 纳入受控插件名单 - #2101

Merged
Lance0174 merged 6 commits into
devfrom
feat/signflow-token-gate
Nov 21, 2026
Merged

Lance0174 merged 6 commits into
devfrom
feat/signflow-token-gate

Conversation

@Lance0174

@Lance0174 Lance0174 commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

摘要

  • 把 signflow_token 加入受控插件名单,未解锁神秘入口时同样不进市场、不可安装。
  • manager.enable 补上第三处门禁:未解锁时启用被拒;已安装并启用的存量、开机恢复、重载后的级联恢复都不受影响。
  • 用例从 3 条扩到 8 条,覆盖隐藏 / 安装拒绝 / 启用拒绝 / 存量存活 / 重启恢复 / 级联恢复。

关联

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 passed
  • pytest tests/api → 53 passed
  • pytest tests/core tests/models → 215 passed, 3 subtests passed
  • ruff check / ruff format --check / compileall → 通过
  • scripts/changelog.py check → 通过(碎片 changelog.d/feat-signflow-token-gate.change.md)
  • 前端零改动:受控插件未解锁时按钮本就不可点(_vis_enable 保持原状),文案层面留待后续统一处理
  • 已同步 origin/dev 至 49b65df3b 后再建分支

SignFlow 的 Token 获取插件按发行名登记,未解锁神秘入口时同样不进市场、不可安装。
@Lance0174 Lance0174 added the skip-changelog 本 PR 没有用户可见改动,不需要 changelog.d 碎片 label Nov 21, 2026

Copy link
Copy Markdown
Contributor

总体结论:可以合并

这次把真名填对就好,不用再养一套判断。SignFlow 的包声明里,发行包叫 signflow-token,宿主拿来识别它的是 signflow_token。这次改的名单填的是后者,所以没解锁时,市场里看不到它,安装请求也会被后端拒掉。新用例把这两个行为都守住了,解锁后也仍能在市场看到它。

这个结论只覆盖市场和安装。#2074 里说的「使用时也要解锁」,留给插件接入时单独验,不算在这次补名单里。

名字对上了,这只可以过。dot酱

神秘入口门禁补上第三处:manager.enable 在「已启用早退」之后拦截受控插件,
已安装并启用的存量走早退、开机恢复与重载级联各自放行,跨日失效或手动锁定
都不会让在用插件掉线。测试覆盖启用被拒、解锁后放行、存量存活、重启恢复、
级联恢复五个分支。
@github-actions github-actions Bot added 模块: 设置 按更新日志碎片自动设置 类型: 变更 按更新日志碎片自动设置 labels Nov 21, 2026
@Lance0174

Copy link
Copy Markdown
Contributor Author

按「安装要校验、已安装已启用不受影响、未安装且未通过校验看不到也启用不了」把第三处门禁补上了,说明一下落点和判据。

为什么这次动 manager.enable。 上一版只有市场可见(_market_visible)和安装预检(on_install)两道闸,插件装上之后就没有任何拦点了——未解锁状态下直接提交 info.enable 触发器是能把它启起来的。所以门禁插在 _is_enabled 早退之后:

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})

四条条件的用意,逐条对应「存量不能受影响」这条:

  • .不在名单里 → 直接放行,普通插件不受影响;
  • ctx != RELOAD_CASCADE → 重载后恢复下游时 enabled 已被写成 False(manager.py:1034-1035),不豁免的话连带插件会掉线;
  • not record.info.enabled → 开机恢复走 enable(ctx=NORMAL),此时 state 还是 DISABLED,只有 info.enabled 能证明「上次是用户主动启用的」,否则锁定状态下重启就恢复不了;
  • 位置本身 → 已启用(含 RELOAD 语境下的 RELOADING)的请求走上一行的早退,跨日失效或手动锁定都不会把在用插件打成 FAULT_RUNTIME。

关于你上一轮划出去的那半句。 你写「#2074 里说的『使用时也要解锁』,留给插件接入时单独验」。这次和需求方对齐后,口径定为入口校验 + 装后放行:一旦装上并启用,解锁状态怎么变都不再干扰它(这是需求方明确的第二条要求——已安装已启用的用户不受影响)。所以「使用时校验」这件事落在了启用这一刻,不是落在每次端点调用上。如果你认为端点侧还需要别的形态,我再补。

测试从 3 条扩到 9 条,后 6 条全是守「存量不受影响」的:存量锁回后早退不报错、开机恢复可启用、运行期故障后可重新启用、级联恢复被放行。

  • pytest tests/api/test_plugin_restricted.py → 9 passed
  • pytest tests/api → 53 passed
  • pytest tests/core tests/models → 215 passed, 3 subtests passed
  • ruff check / ruff format --check / compileall / scripts/changelog.py check → 通过
  • 前端零改动(_vis_enable 保持原状,未解锁时按钮本就点不动)

碎片补齐了:changelog.d/feat-signflow-token-gate.change.md,project: settings、分类 change——神秘入口是 v5.6.2 的既有功能,这次是加严限制。

Copy link
Copy Markdown
Contributor

总体结论:修改后合并

谢谢你把「已经启用的用户不受影响」说清楚了。平时重启和顺利重载都能保住这个承诺,但有个故障恢复的岔路还会把老用户当成第一次来。

已经启用的 SignFlow Token 如果在依赖插件重载时没能恢复,失败分支会把「用户原本开着它」也清掉。等故障排除,用户回插件中心点「启用」,新校验就会要求重新解锁。现有故障用例先手工把启用标记设成了 True,没经过这段会清掉标记的代码。

建议失败时照样记故障,只保留这次重载前已启用的意图;从未启用和用户主动停用的插件照旧走门禁。回归用例也从真实的依赖重载失败走起,最后确认老用户能重新启用。

别让一次重载把老用户认成新人。dot酱

依赖插件重载时若下游没能恢复,原先会顺手把 enabled 清成 False,
等于把「用户原本开着它」当成「从没启用过」。故障排除后老用户回插件
中心点启用,受控插件就会因为当日未解锁而再次被门禁拦下。

改为在重载正常路径末尾按实际拆卸树补回启用意图:恢复失败的节点留在
故障态、被跳过的子树留在禁停态,状态不动,只补 enabled。从未启用和
用户主动停用的插件不进这棵树,仍照旧走门禁。

回归用例从真实的依赖重载失败走起,覆盖「故障后锁定状态仍能重新启用」。
@Lance0174

Copy link
Copy Markdown
Contributor Author

@jinghero 这条按你说的改了。

改法

reload() 里把「补启用意图」从失败分支收口到正常路径末尾,按实际拆卸树 tear 递归补 enabled:

  • 恢复失败的节点:只写 state=FAULT_RUNTIME + last_error,不碰 enabled;被跳过的子树同样只留在禁停态。
  • 重载收尾统一走 keep_enable_intent(tear),只补 enabled=True,状态一个字不改。
  • 从未启用、用户主动停用的插件不进这棵树,照旧走门禁。

所以老用户看到的是「故障,已启用,可点停用」,点停用会走 disable 正常清意图;故障排除后点启用不再要解锁。

回归用例

  • 新增 tests/core/test_plugin_cascade.py::test_reload_restore_failure_keeps_enable_intent_for_restricted_plugin:从真实的依赖重载失败走起(cascade_a 重载 → signflow_token 恢复时 on_enable 抛错),断言 tear={"signflow_token":{}}、restore={}、故障态、enabled 仍为 True;再把解锁状态翻成未解锁、故障开关关掉,enable 一次能起来。不再手工设 enabled=True。
  • test_reload_restore_failure_skips_branch_and_continues_other_branches 两条断言改成 enabled is True(失败分支与被跳过子树),语义变了所以断言跟着变。
  • tests/api/test_plugin_restricted.py 补一条反向用例:从未启用过的受控插件进故障态,启用仍要解锁(故障态不等于「用户要它开着」);原来那条改由真实的启用意图来源支撑,注释指到上面的级联用例。

验证

项 结果
tests/core/test_plugin_cascade.py 8 passed
tests/api/test_plugin_restricted.py 10 passed
tests/api tests/models 56 passed(3 subtests)
tests/core 215 passed(206.83s)
ruff check / format --check / compileall / changelog.py check 全部通过
前端 零改动

提交 35966daae。

@Lance0174

Copy link
Copy Markdown
Contributor Author

CI 9/9 全绿(pytest ubuntu/windows、格式检查、构建未签名 Windows 验证包、uv.lock 一致、删除他人代码检查、碎片与版本号检查、同步碎片标签、sync),mergeStateStatus 已回 CLEAN,head 仍是 35966daae。

这边没有其他待改项,等你看这版的判据是否合意。

Copy link
Copy Markdown
Contributor

总体结论:修改后合并

上轮那条已经修到了:依赖重载成功、只有下游恢复失败时,SignFlow Token 还记得用户原本开着它,故障排除后可以直接启用。新测试也确实走了这条路。

还差两处收尾。第一处是「想关也关不掉」。现在故障或暂未恢复的插件会保留「下次启动还要开」的设置,但插件中心的停用按钮只给正常运行的插件,后端也不会替故障或禁停项清掉这个设置。用户想先让它安静待着,重启时宿主却还会尝试拉起来。对这类记录,显式「停用」只要取消下次启动,不必再跑一次插件收尾。

第二处是「想留却留不住」。如果依赖自己重载失败,就到不了恢复下游设置的那一步。建议把已拆下游的原设置也保留在失败路径;直接重载故障插件时也别用「当前正在运行吗」代替「用户原本想开吗」。这样真想关的人能关,等修好再用的人也不用被当成首次启用。

开和关都得听用户的。dot酱

停用按钮此前只对正常运行中的插件出现,后端对故障与禁停记录也直接空返回,
不清启用意图:用户先让出错的插件安静待着做不到,重启时宿主仍会尝试拉起。
现在这类记录的显式停用只取消下次启动的意图,不再跑一遍插件收尾。

重载把「当前在跑」当成「用户想开」:故障记录重载后会被抹成从没启用过,
受控插件因此要再解锁一次;依赖重载失败时又会跳过恢复下游意图的那一步。
改为分别判断在跑与想开,并在失败路径同样还回已拆下游的启用意图。
@Lance0174

Copy link
Copy Markdown
Contributor Author

已按第三轮两条意见改完,commit 6b7b62317。

一、想关也关不掉

disable() 原来在这四种状态下直接空返回:DISABLED / FAULT_LOAD / FAULT_RUNTIME / UNLOADED。于是「停用」这个动作对故障插件根本不存在,enabled 那份启用意图留在记录里,initialize() 下次启动照样按它去拉起。

  • app/core/plugin/manager.py disable():这四种状态先做一次「只取消意图」的收尾——若 info.enabled 为真就置假、提交、发 capabilities_changed 与 PLUGIN_CAPABILITIES_UPDATED,然后返回。没有可拆的实例,也就没有插件收尾要跑;_plugin_cls is None 的报错相应移到这之后,让它只拦「不带实例的正常态」。
  • _assert_allowed 把 disable 加进 FAULT_LOAD 与 FAULT_RUNTIME 的白名单,否则上面那段根本走不到。
  • app/models/config/plugin.py _vis_disable:state == ENABLED or info.enabled 都可停用。前端 pluginToggleChecked 本来就先看 disable 提示能不能点、再看 enable 提示、最后才退回 enabled,所以这一处改完,插件中心自己就会把「意图还开着但眼下没跑」的记录显示成可停用,前端不用动。

二、想留却留不住

  • reload() 原来一句 was_enabled = record.info.state == PluginState.ENABLED:「在跑」和「想开」被当成同一件事。现在拆成 was_running(决定要不要先拆实例)与 want_enabled = was_running or record.info.enabled(决定拆完要不要重新拉起、收尾写哪种稳态)。故障记录重载后不会再被抹成「从没启用过」,受控插件也就不会被再问一次解锁。
  • 依赖自己重载失败时走的是 except 分支,keep_enable_intent(tear) 在正常路径的 restore_cascade 之后,那条路到不了,被拆下游写下的 enabled=False 就没人还。现在失败路径在 _fail_branch 之后、重抛之前同样补一次 keep_enable_intent(tear)(contextlib.suppress 包住,不让它盖掉原始异常)。

验证

新增三条用例,都用真实依赖树:

用例 固定的事
test_disable_on_faulty_record_only_cancels_next_start 故障记录停用后 enabled 为假、state 仍是 FAULT_RUNTIME、插件钩子没有第二次被调用
test_reload_failure_keeps_enable_intent_of_torn_down_downstream 依赖源码被改成启动即抛错后重载上层,下层留在 DISABLED 但 enabled 仍为真
test_disable_button_stays_available_for_intent_left_on_faulty_record 故障 + 意图开着 → 停用可点;故障 + 意图已取消 → 停用不可点

每条都做过反向验证:把对应实现逐个注坏,用例分别在断言处失败,还原后复跑通过——说明它们真的咬得住,不是陪着代码走一遍。

pytest tests/core 218 passed、tests/api 55 passed、tests/models 通过;ruff check / format / compileall 与碎片检查均通过。另外 tests/api/test_mcp_schema.py::test_full_application_recursive_schema_guards 在与 tests/models 同跑时偶尔撞到 MCP 子进程 10 秒超时,单独跑、stash 掉本次改动后单独跑、以及整套复跑都通过,判断是既有的偶发边界,与本改动无关,这里一并说明。

存量用户不受影响:解锁状态与已启用的记录照旧跑,跨日锁回也不会被停用——这一层上一轮已经固定过,本轮没有改动它的判据。

@jinghero 麻烦再审一眼。

@Lance0174

Copy link
Copy Markdown
Contributor Author

CI 9/9 全绿(pytest ubuntu 1m52s / windows 3m51s / 格式检查 1m49s / 构建验证包 2m32s / 其余四项 9–20s),mergeable=MERGEABLE。等复审。

Copy link
Copy Markdown
Contributor

总体结论:修改后合并

故障插件现在能手动关掉,直接重载也会记住用户原本想不想开。这两处可以收了。还差一个边角:重载拆到一半就失败时,已经停下来的插件怎么办?

往下拆时,最下面的插件可以先顺利停下,清掉下次启动的设置;如果接着停中间那层时出错,最外层还没收到这条分支的名单,失败收尾就补不回最下面那项。等故障排除,它不会随应用启动;对已经启用过的受控插件,手动开还会被当成首次启用。

重载只是暂时停一下。建议这条路径只改运行状态,不写掉「下次还要开」的设置,只有用户真正点停用才清。补一条拆到一半失败的测试即可,不用再给事后补名单加一层兜底。

临时停一下,不等于用户说关掉。dot酱

重载往下拆到一半失败时,最下层可能已经停稳并清掉了「下次还要开」的设置,
但它不在父层拿到的名单里,失败收尾补不回来:故障排除后它不会随应用启动,
已启用过的受控插件手动开还会被当成首次启用。

改成拆解语境只改运行状态,只有用户真的点停用才写掉启用意图;事后补名单的
兜底也一并去掉。补一条拆到一半失败的回归用例。
@Lance0174

Copy link
Copy Markdown
Contributor Author

按这条改完,commit 1630fef18。

改法

disable() 收尾里原本是 if ctx in {NORMAL, RELOAD_CASCADE}: ... enabled = False——重载拆下游用的正是 RELOAD_CASCADE,于是「临时停一下」和「用户点停用」写成同一个动作。现在拆开:

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

上一轮那个「事后补名单」的 keep_enable_intent(tear) 一并删掉了(正常路径与失败路径两处调用都删)。既然拆解本身不再写掉意图,就没有需要还的账;这样「拆到一半失败」这种名单不全的情况也不必再兜——它根本不会欠。

回归用例

新加 test_reload_teardown_failure_keeps_enable_intent_of_already_stopped_branch:三层链 cascade_a → cascade_b → signflow_token,让中间层收尾时抛错(夹具新增 fail_disable 开关,在 on_disable 里注入)。

这样最下层是「顺利停稳、清过设置、返回给中间层、而中间层抛错」的那一支——最外层拿到的 tear 里没有它,正是您说的边角。断言:

  • signflow_token 停在 DISABLED;
  • signflow_token.info.enabled 仍为真;
  • 把中间层恢复、并把解锁桩切成「当日未解锁」后,enable 照样成功——证明它没被当成首次启用。

反向验证:把 if ctx == LifecycleContext.NORMAL 注回成 {NORMAL, RELOAD_CASCADE},这条用例在 assert records["signflow_token"].info.enabled 处失败(AssertionError: assert False,tests/core/test_plugin_cascade.py:307);同一注坏还连带打挂了另外三条(说明这处原来确实是有意为之的分支),还原后全过。

验证

tests/core 219 passed(172s)、tests/api + tests/models 56 passed + 3 subtests、ruff check / format 干净、碎片检查通过。相对 dev 的 diff 反而小了:先前那套 keep_enable_intent 净减 14 行。

@jinghero 再看一眼。

Copy link
Copy Markdown
Contributor

总体结论:可以合并

这一版把问题修在了写设置的地方:重载临时停插件,只改运行状态;明确停用才清掉下次启动的设置。中间那层就算先出错,也不用指望外层拿到一份完整名单来补救。新用例确实走了下层已经停好、中间层才报错这条路,最后确认原先开着的插件还能恢复。也核对了插件中心的开关:故障时用户仍能明确停用,首次启用仍要解锁。

这回临时放手和真正关掉分开了。dot酱

@Lance0174

Copy link
Copy Markdown
Contributor Author

CI 9/9 全绿(pytest ubuntu 2m35s / windows 3m56s / 格式检查 1m29s / 构建包 2m21s / 其余四项 9–19s)。等复审。

@Lance0174
Lance0174 merged commit fecc70a into dev Nov 21, 2026
9 checks passed
github-actions Bot added a commit that referenced this pull request Nov 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-changelog 本 PR 没有用户可见改动,不需要 changelog.d 碎片 模块: 设置 按更新日志碎片自动设置 类型: 变更 按更新日志碎片自动设置

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants