郑立|Dify 高级开发者关系
写于 2026 年 8 月 25 日
截至2026年8月25日,Dify的插件生态系统规模已十分庞大,仅靠一个标识和几句简单的安全声明,已无法再传递信任背书。插件市场需通过可重复的管控机制来赢得用户信赖:包括插件包内包含的内容、插件可访问的资源、经过审核的具体版本,以及当相关验证依据发生变化时的应对机制。
一则拉丁谚语告诫道:“Fide, sed cui vide”——信任,但要认清你所信任的对象。
这一准则对于开放插件生态系统而言极具实用价值:善意能够降低协作成本,且独立证据表明,这种善意具备可扩展性。
我们的目标并非承诺零风险,且从数字层面看这一目标过于理想化,从实操层面看也并不可信。我们的核心目标是让风险有迹可循:尽可能在发布前完成风险管控,必要时在发布后跟进处理,且每当插件版本发生变更时都需重新开展相关工作。
以 Dify 开发者关系团队成员的视角来看,这同样是一个社区设计层面的问题:贡献者需要快速、明确的反馈,而用户则需要能够理解的依据。 审核人员需要相应的管控机制,将人力注意力留给模糊性问题,而非耗费在重复性的溯源工作上。
目前部分管控措施已可在公开代码仓库中核验,另一些仍在持续建设和完善。明确这一边界本身也是治理的一部分:当路线图被包装成已经交付的能力,公众信任会迅速崩塌。
良好的治理始于一个看似基础的问题:我们究竟在统计什么?
2026 年 7 月 31 日的 Marketplace 快照提供了几组真实有效的数据,但它们衡量的是插件生态的不同数据面。
问题不在数字是否准确,而在于我们如何理解这些数字。
以 263 和 99 为例。263这个数值描述的是某一市场快照中的标签情况,99 描述了评审人员报告称处于积极维护状态的运营基线。前者是身份标识,后者是维护状态。两者都有明确的数据来源,将其中一项当作另一项的佐证,看似简洁便利,实则是错误的做法。
同样的原则也适用于安装量和调用量。安装记录反映插件的分发情况,调用记录反映特定时段内的实际使用情况。它们可以帮助我们观察生态的不同侧面,但无论哪一个,都不能单独回答插件是否可靠、是否具有业务价值,或者是否处于良好的维护状态。
即使指标本身选对了,还需要知道数据能够说明到什么程度。
本次调用分析覆盖2026年7月13日至8月12日期间。由于部分Pod身份信息缺失且计数器可能发生重置,其绝对统计量可能存在2至5倍左右的低估,因此,这组数据仅用于观察相对趋势、占比及排名,而不作为精确调用量的宣传依据。
理查德·费曼曾用更精妙的表述阐释了相关的控制原则:“首要原则就是绝不要自欺欺人——而你恰恰是最容易被自己愚弄的人。” 放在当前场景,它意味着很具体的原则:给出数据的同时,也要说明它的统计时点、口径和局限。 一个数字只有放回它产生的背景中,才真正具有解释力。
最直接的风险并非理论层面的假设。我们已观测到.difypkg归档文件中包含.env文件、.git 可能暴露凭证的元数据、完整虚拟环境、.DS_Store、__pycache__、日志以及平台专属二进制文件。这些内容带来的风险性并不相同。有些只是开发过程中留下的无害文件,有些却可能泄露敏感信息、夹带未经审查的可执行内容,或在解压和运行后扩大攻击面。
理想情况下,插件包里应该只有插件,而不是开发者电脑里的“全家桶”。 这句话听起来像个玩笑,但背后的问题并不轻松:插件归档最终会进入用户环境,被解压并执行。因此,包里有什么、从哪里来、执行什么,并不是代码整洁度的问题,而是供应链安全的一部分。
其他开发者生态系统也已反复佐证了这一点。
GlassWorm “玻璃蠕虫”攻击活动曾利用恶意的 VS Code 和 Open VSX 扩展进行传播,相关扩展累计下载量超过 3.5 万次。相比这次攻击被冠以什么名称,其采用的技术手段更值得关注:若对身份、包内容及行为的审查不够严格,常见的分发渠道也会成为恶意代码的传播放大器。
发现速度同样至关重要。
一款假冒的 Prettier Plus 扩展在上线约 4 小时后便被下架,其间仅产生 6 次下载和 3 次安装。影响范围之所以有限,恰恰是因为检测和响应足够及时。对安全治理而言,“未得到广泛部署”正是我们期望的结果,而非说明该管控措施毫无必要。
LottieFiles 的 npm 事件说明了另一个问题。2024 年 10 月 30 日,攻击者利用泄露的凭证发布了三个恶意版本的软件包,事件随后得到控制。项目声誉虽能辅助发现风险,但无法替代版本级验证、凭证安全保障,以及可快速限制恶意内容传播的响应流程。
这些案例的成因并不完全相同,插件包中出现的意外残留,与攻击者主动植入恶意内容,也不能混为一谈。但从治理角度看,它们首先需要的是同一套基础能力:检查包内容,识别并披露敏感行为,保留可追溯的证据,并在发现问题时能够及时介入。
安全审核不应该只是发布前的一次勾选,而应该贯穿插件从开发、提交到发布的整个过程。当前的公开实现采用了一套分层验证流程,让问题尽可能在进入 Marketplace 之前被发现。
开发者可以在提交 PR 前,通过 Dify Marketplace 工具包在本地完成初步检查。提交后,贡献模板会进一步记录作者、插件、版本、源仓库、联系方式、风险等级,以及相关的隐私和安全披露信息。
把反馈前置的目的很简单:越早发现问题,修复成本越低。
本地验证涵盖安全归档解压、包内容、密钥模式、二进制文件、包含来源、README 完整性、基于 OSV 的依赖漏洞检查,以及 Python 编译和安全模式检查等。对于金融相关的禁止行为,工具也会给出相应警告。
网络访问同样是检查的一部分。工具会检查已观测到的访问域名,并支持可选的 network.domains 声明。这一点尤其重要,因为部分 SDK 会在运行时动态构建 URL,仅依赖静态分析并不一定能够发现所有外部访问。
进入 CI 后,检查会继续进行。在公开的 dify-plugins 工作流中,pr-risk-label.yaml、pre-check-plugin.yaml、pre-check-plugin-sandbox.yaml以及upload-merged-plugin.yaml 分别提供风险标记、自动化检查、沙箱定向验证以及合并后上传管控能力。CI 会区分阻断性错误与警告,且软件包会在合并后、上传前重新完成验证。自动化机制可辅助审核人员开展工作,它并不会仅仅因为YAML显示为绿色就具备判断能力。
这套流程同时区分阻断项(Error)与警告项(Warning)。
阻断项意味着已经超出既定安全阈值,需要解决后才能继续;警告项则意味着存在需要进一步理解或人工判断的情况,但未必意味着插件本身存在恶意行为。这样的区分很重要:如果所有异常都被放行,安全规则就失去了意义;如果所有异常都被直接阻断,又会让合理但非常规的实现难以进入生态。
CI 通过并不意味着插件天然可信,而是意味着它通过了当前能够自动验证的检查。
插件上传后,工具包还支持提交扫描报告,供访问域和安全相关模块使用。这为后续的安全展示提供了基础,但这里需要明确区分已经落地的验证能力与仍在演进中的 Marketplace 机制。安全等级、评级展示及反馈机制目前仍属于持续迭代的框架范畴。
现行版本安全等级语义的演进
| |
| 已完成扫描;未发现高风险或中风险问题;依赖、权限及域名信息完整;作者信号已经验证,并经过额外复核 |
| 已完成扫描;未发现高风险问题;依赖及域名信息基本完整 |
| 存在需要关注的问题,例如过时依赖、低风险或中风险检测结果、作者身份未经验证,或扫描与域名透明度不完整 |
| 存在明确风险,例如高危漏洞、权限异常、未申报的敏感外部访问或可疑历史记录 |
| 当前版本尚未完成扫描、扫描失败,或现有证据不足以完成评级 |
这里有一个重要前提:评级属于版本,而不是插件本身。
插件每次升级后都需要重新扫描,旧版本的评级不应自动沿用到新版本。Official(官方)、Partner (合作伙伴)或 Verified (已验证)等身份信息可为决策提供支撑,但不能替代对当前包体和版本的实际验证。经确认的恶意行为或严重安全问题可绕过常规评级流程,直接进入限制、移除或人工审核环节。
在当前的安全详情设计中,评级标识被放在页面右上角,让用户在阅读详细信息之前就能快速判断当前版本的安全状态。例如,S 级使用绿色标识;C 级使用红色标识,并在安装前显示更醒目的风险警告。
依赖项列表沿用同样的结构,每个依赖都会显示包名、版本及对应状态,帮助用户快速定位可能受影响的依赖。颜色能够加快识别速度,文字、等级、包名和版本信息则负责说明风险究竟是什么。 这样,即使不依赖颜色,用户仍然能够理解评级结果,同时也为后续审核和追溯保留足够的信息。
图1 S表示“通过”;C表示“待审核”
二者均不构成担保承诺
透明度在启用前最具价值,此时用户仍可做出知情选择。在实际场景中,插件可通过三种存在本质差异的方式运行:
仅本地执行。 该插件以代码形式在本地运行时环境中运行,不会向外部服务回传或发送任何数据。
客户直连服务。由客户提供API密钥或账户,并直接选择通过插件对接外部服务商。
Dify 连接的服务。Dify 会提供凭证,或是在产品体验中集成统一托管的第三方功能。
这三种模式并不只是不同的产品标签。连接方式不同,意味着数据流向、管理责任和合同关系也可能不同。具体判断还会受到部署方式和实际数据流的影响,因此这里讨论的是一套产品治理框架,而非法律结论。
“阳光被誉为最佳消毒剂。”——路易斯·D·布兰代斯
对于插件用户而言,“阳光”意味着具体明确的信息。在启用插件前,用户应当能够查看该插件涉及的外部域名与服务,以及可能流出自身环境的数据类别:提示词、输出内容、文件、账户或工作区数据、元数据、日志以及凭证。未被列入清单的端点并不会因为其隐蔽就变得无害。
有效的信息披露还应说明数据处理的原因、存储或处理的地点、保留的时长,以及数据是否可能被用于模型训练或产品改进; 以及适用的隐私声明、DPA或服务条款。客户确认以及重大变更的可追溯记录,会将这类信息从形式化的表述转化为可落地的管控措施。
无论合同约定的角色如何划分,Dify 始终保有对系统对应部分的管控权:运行时隔离、传输安全、可强制执行的声明、审核机制,以及当行为与披露内容不符时的处置权。具体责任边界可能因场景而异,但产品设计中的安全要求不会因此消失。
插件 Marketplace 不只涉及代码的流转,也涉及使用和分发权限的流转。
这一实际链路简洁直白却极易被忽视:插件作者须拥有将插件提供给Dify的权限,Dify须拥有托管及分发该插件的权限,用户则须获得安装并使用该插件的充分权限。只要其中任一环节存在模糊地带,即便技术层面无瑕疵的安装包,也可能存在治理层面的缺陷。
开源软件贯穿于这一链条的每一个环节。其相关声明、署名要求、源代码提供义务、修改条款及再分发条件,并不会因采用了便捷的打包格式而消失。许可证就如同重力一般,无论发布清单中是否提及,都始终具备法律效力。
因此,一套成熟的治理机制需要让许可信息能够被看见和追溯,包括清晰的许可证声明、可检索的 OSS 组件信息,以及针对 Copyleft、AGPL 等相关义务的检查。同时还需明确开发者条款与传递给用户的任何许可或最终用户许可协议(EULA)之间的关联。
这些管控措施可协助审核人员提出恰当的问题,但不能代替具体场景下的法律判断。
其中一些实现方式仍处于设计和迭代阶段。例如专门的清单许可字段、许可白名单或黑名单、针对AGPL的SaaS路由、标准化终端用户许可协议以及点击即同意的确认机制,均能提升一致性。
但原则仍然与前文一致:没有产品或代码仓库证据支持的能力,就不应被描述为已经上线。 在治理问题上,明确区分“已经实现”和“计划实现”,本身就是可信度的一部分。
安全评审用于判定某个版本是否可以进入生态系统,而维护治理则负责明确版本准入后的后续安排。
为了让这一问题更易处理,我们将插件分为四个群组进行分析:官方模型类、官方非模型类、社区模型类以及社区非模型类。在同群组内进行对比,可避免让专业模型提供商与通用工具遵循相同的需求曲线来接受评判。
在每个分组内部,我们使用需求指数衡量插件的相对需求:
需求指数 = 60% 调用量百分位 + 40% 安装量百分位
在此基础上,再加入 1–5 分的关键性评分。原因很简单:使用热度和运营重要性有关,但并不是一回事。 一个调用量并不高的身份验证组件或关键数据连接器,仍然可能需要较高的维护优先级。
| |
| 队列前20%的需求,且关键等级为4及以上,或已备案的关键等级5豁免项。 |
| 优先级排名前40%且临界等级为3及以上,或任意临界等级为4及以上的插件。 |
| |
| |
此处的 P0、P1 和 P2 是维护优先级,而非项目交付阶段。更新状态会提供另一项标识:近期更新指 30 天内有更新,正常维护指更新间隔为 31–90 天,更新滞后指更新间隔超过 90 天。
预计的季度重复性维护工作量也可以进一步分为:S 级为每季度 1–2 人天,M 级为 3–5 人天,L 级为 6–10 人天。
把工作量纳入模型很重要,因为维护能力最终受实际产能约束。每季度 30、60 或 120 人日这样的数字可以用于容量规划,并非服务水平协议。没有相应人员和时间支撑的维护计划,再完整的表格也无法让它真正发生。
因此,官方维护资源应优先集中在有明确资源支持的 P0 和 P1 插件上。对于社区插件,则可以根据需求、关键程度、维护者状态和生态价值,在官方接管、联合维护、赞助支持或持续观察之间选择不同路径。其余 P2 和 Watch 插件原则上继续由社区主导,同时保留基础验证和清晰的问题上报路径,而不默认附加周期性的官方 SLO。
这样的优先级这并非对内容质量或创作归属的评判。它解决的是一个更实际的问题:当维护资源有限时,如何以一致的方式决定先处理什么。而且答案不会永远不变。随着使用情况、更新时间和生态需求变化,维护优先级也应该重新计算。治理如果不能随着证据变化而调整,很快就会失去实际作用。
当治理直面权衡取舍,而非假装这些取舍根本不存在时,它才会真正具备公信力。
每增加一项检查,都会给贡献流程增加一定成本。因此,我们尽量把验证前置到本地,让作者能够在提交 PR 前发现并修复问题,而不是等到审核和 CI 阶段再来回处理。
明确违反规则的问题应该阻断流程,模糊信号应以预警形式启动。通过影子模式、误报率观察、例外记录和逐步收紧规则,可以让自动化检查根据实际效果逐渐获得更高的执行权重,而不是一开始就对所有情况做强制判断。
安全评级或域名列表仅代表特定版本在某一时间点的可用证据,并非担保,版本发生变化后,旧的结论不能自动继承。重新扫描和明确的状态更新,是保持这些信息有效的前提。
Dify 需要提供必要的安全保障、可靠的工具和明确的问题上报路径,但同时也为社区的独立探索保留空间。我们的目标是打造一个良性的公共生态,而非一座配备了异常完备 CI 的封闭花园。
贯穿这些取舍的原则其实很简单:让安全路径易于践行,让插件状态清晰可见,让管控力度与实际依据相匹配。一旦依据发生变化,决策也应随之调整。
信任并非通过一条评论、一枚徽章或一次政策发布就能建立。它是通过持续的验证、透明的产品信号、可落实的责任归属以及公平的响应流程逐步形成的。正因如此,信任本身也是产品能力的一部分。和其他重要能力一样,它需要被验证、维护,并随着生态变化持续迭代。
本文综合使用了以下几类证据:
2026 年 7 月 31 日 Marketplace 快照,用于观察生态规模、插件分组和安装情况;
2026 年 7 月 13 日至 8 月 12 日 SaaS 调用数据,用于分析相对使用情况和维护优先级;
Dify 内部治理与维护设计资料,用于说明治理框架及维护模型;
截至 2026 年 8 月 25 日可核验的公开实现,用于区分已经落地的能力与仍在规划中的机制;
公开供应链安全事件资料,包括 GlassWorm、Prettier Plus 和 LottieFiles npm 事件,用于提供其他开发者生态中的参考案例。
需要特别说明的是,Marketplace 快照并非实时计数器,调用总量也不用于证明绝对使用规模。 本文使用这些数据的目的,是观察相对趋势、分布和优先级,而不是对精确调用量作出超出数据能力范围的推断。
注:本文阐述的是治理设计与工程实践内容,不构成法律建议、认证,亦不代表任何插件均无风险的承诺。