精确对端防火墙与宽泛规则防御
现在
冻结 · 快照核对 10 月 11 日
截至 10 月 11 日

MeshClip Kit · 功能说明(项目已冻结)

能够说清本项目开放给谁、通过哪个接口和程序,并可逆撤销自己的配置。

当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,AI 不再用它改防火墙。冻结前最后的情况:10 月 20 日早上(7:34—7:43 之间)主机只读自检,两条项目规则仍合规,但“别的规则有没有放行 KDE Connect”这一项失败:主机上另有不属于本项目、不限来源的入站放行指向 KDE Connect。何时、被哪个安装程序或谁加回来的没查到;当时只发现、没修,到冻结也没处理。这些宽泛规则和项目自己的两条规则现在还在不在,归档后没查,是 Unknown;副机规则那次也没查。

项目快照核对于 2026-10-20(北京时间),运行情况依据当天早上 7:34—7:43 之间的主机只读自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库(已归档,只读)

精确对端防火墙与宽泛规则防御
现在
冻结 · 快照核对 10 月 11 日
截至 10 月 11 日

MeshClip Kit · 功能说明(项目已冻结)

能够说清本项目开放给谁、通过哪个接口和程序,并可逆撤销自己的配置。

当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,AI 不再用它改防火墙。冻结前最后的情况:10 月 20 日早上(7:34—7:43 之间)主机只读自检,两条项目规则仍合规,但“别的规则有没有放行 KDE Connect”这一项失败:主机上另有不属于本项目、不限来源的入站放行指向 KDE Connect。何时、被哪个安装程序或谁加回来的没查到;当时只发现、没修,到冻结也没处理。这些宽泛规则和项目自己的两条规则现在还在不在,归档后没查,是 Unknown;副机规则那次也没查。

项目快照核对于 2026-10-20(北京时间),运行情况依据当天早上 7:34—7:43 之间的主机只读自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库(已归档,只读)

这项功能怎样使用

用途与实际影响(冻结前)

为什么需要它

只添加两条窄规则仍可能被旧宽规则抵消,所以必须同时核对现有KDE规则。变更保留原状态,以便撤销项目时恢复。

举个实际例子

冻结前可以说:“我只想让这两台电脑互传,别向别的设备开放。”AI先列出这次连接实际需要的规则和允许设备,展示调整范围;按授权处理后分别检查允许的电脑和其他设备,配对与真实传输另行确认。项目冻结后,AI 不再按这套脚本改规则;要收紧这台电脑上 KDE Connect 的放行,得本人另说。

最后我会得到什么

KDE流量的项目规则明确限定批准对端;本机其他应用与整个Windows防火墙不属于该结论。

这项功能怎样使用

用途与实际影响(冻结前)

为什么需要它

只添加两条窄规则仍可能被旧宽规则抵消,所以必须同时核对现有KDE规则。变更保留原状态,以便撤销项目时恢复。

举个实际例子

冻结前可以说:“我只想让这两台电脑互传,别向别的设备开放。”AI先列出这次连接实际需要的规则和允许设备,展示调整范围;按授权处理后分别检查允许的电脑和其他设备,配对与真实传输另行确认。项目冻结后,AI 不再按这套脚本改规则;要收紧这台电脑上 KDE Connect 的放行,得本人另说。

最后我会得到什么

KDE流量的项目规则明确限定批准对端;本机其他应用与整个Windows防火墙不属于该结论。

结果怎么看
正常时

只允许已批准的电脑进入 KDE Connect 所需范围,原有宽泛规则也已核对。

发现问题时

发现其他宽泛规则时先停止,展示将禁用哪些规则并等待本人明确选择。10 月 20 日早上就是这种情况,到冻结也没等来处理。

入口不可用或证据不足时

修改需要管理员权限;只读检查若无法看全规则,就报告未知,不把缺证据当安全通过。项目冻结、本机副本删掉后,这套检查在这台电脑上已经没有可直接运行的入口。

结果怎么看
正常时

只允许已批准的电脑进入 KDE Connect 所需范围,原有宽泛规则也已核对。

发现问题时

发现其他宽泛规则时先停止,展示将禁用哪些规则并等待本人明确选择。10 月 20 日早上就是这种情况,到冻结也没等来处理。

入口不可用或证据不足时

修改需要管理员权限;只读检查若无法看全规则,就报告未知,不把缺证据当安全通过。项目冻结、本机副本删掉后,这套检查在这台电脑上已经没有可直接运行的入口。

从哪里开始

在两台电脑分别运行 scripts/configure-peer.ps1 -Peer 指定已核实的对端;遇到宽泛旧规则先用 -WhatIf 预览,再明确允许禁用。(这是冻结前的入口;现在本机仓库副本已删,这些脚本只在 GitHub 归档仓库里留着,AI 不再从这里开始。)

需要准备什么
  • 批准互连的对端电脑
  • 发现宽泛旧规则时是否接受预览后的定向禁用
从开始到拿到结果
1检查已有规则
逐端核对对端地址、程序及现有入站规则;冲突先停止。
2只加精确通路
明确同意后禁用相关宽泛规则并写入限定端口、协议、程序和接口的新规则。
3回读或回滚
两端分别回读规则;失败尝试恢复本轮改动,doctor 报告未完成事务。
从哪里开始

在两台电脑分别运行 scripts/configure-peer.ps1 -Peer 指定已核实的对端;遇到宽泛旧规则先用 -WhatIf 预览,再明确允许禁用。(这是冻结前的入口;现在本机仓库副本已删,这些脚本只在 GitHub 归档仓库里留着,AI 不再从这里开始。)

需要准备什么
  • 批准互连的对端电脑
  • 发现宽泛旧规则时是否接受预览后的定向禁用
从开始到拿到结果
1检查已有规则
逐端核对对端地址、程序及现有入站规则;冲突先停止。
2只加精确通路
明确同意后禁用相关宽泛规则并写入限定端口、协议、程序和接口的新规则。
3回读或回滚
两端分别回读规则;失败尝试恢复本轮改动,doctor 报告未完成事务。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

10 月 20 日早上主机精确入站检查通过,非项目宽泛规则检查失败(另有宽泛放行指向 KDE Connect,未处理);副机规则这次没查

关键规则与设计选择
1
规则同时约束协议、端口、程序、接口与单对端地址,不把0.0.0.0监听地址等同于防火墙远程放行范围。
2
宽泛非项目规则只在显式选项下禁用,不删除,保留恢复记录。
3
卸载核对资源是否仍由本项目拥有且未变化,变化资源保留并报告。
当前怎样实现
  • Get-MeshClipKdeFirewallAudit读取指向可信kdeconnectd.exe的入站规则和过滤条件。
  • Disable-MeshClipBroadKdeFirewallRules禁用明确冲突规则并记录。
  • New-MeshClipFirewallRules创建TCP/UDP两条精确过滤规则;事务失败按记录回滚。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

10 月 20 日早上主机精确入站检查通过,非项目宽泛规则检查失败(另有宽泛放行指向 KDE Connect,未处理);副机规则这次没查

关键规则与设计选择
1
规则同时约束协议、端口、程序、接口与单对端地址,不把0.0.0.0监听地址等同于防火墙远程放行范围。
2
宽泛非项目规则只在显式选项下禁用,不删除,保留恢复记录。
3
卸载核对资源是否仍由本项目拥有且未变化,变化资源保留并报告。
当前怎样实现
  • Get-MeshClipKdeFirewallAudit读取指向可信kdeconnectd.exe的入站规则和过滤条件。
  • Disable-MeshClipBroadKdeFirewallRules禁用明确冲突规则并记录。
  • New-MeshClipFirewallRules创建TCP/UDP两条精确过滤规则;事务失败按记录回滚。
技术实现与依据(二)
1
解析批准对端和可信daemon路径,读取当前规则。
2
发现冲突时停止;显式选项下先预览,再执行可逆禁用。
3
保存本机状态并添加精确TCP/UDP规则。
4
回读规则;失败按原记录回滚,未完成事务由doctor报告。
  • scripts/MeshClip.Transaction.ps1在集成效果前持久记录带类型恢复步骤;失败和硬中断保留待恢复。recover.ps1默认只预览,Apply反向核对实际资源再恢复;外来改动不覆盖,未完成记录不能被新安装/configure覆写。软件包与KDE配对身份不在该集成事务范围。
执行流程
技术实现与依据(二)
1
解析批准对端和可信daemon路径,读取当前规则。
2
发现冲突时停止;显式选项下先预览,再执行可逆禁用。
3
保存本机状态并添加精确TCP/UDP规则。
4
回读规则;失败按原记录回滚,未完成事务由doctor报告。
  • scripts/MeshClip.Transaction.ps1在集成效果前持久记录带类型恢复步骤;失败和硬中断保留待恢复。recover.ps1默认只预览,Apply反向核对实际资源再恢复;外来改动不覆盖,未完成记录不能被新安装/configure覆写。软件包与KDE配对身份不在该集成事务范围。
执行流程
名词和入口
本模块用到的名词
名词意思
fail-closed(失败阻断)当安全检测发现异常或潜在漏洞时,系统默认选择关闭或拒绝执行,而非冒险放行。
端口收敛将开放监听的服务端口通过防火墙策略收缩到最小必需网络接口与最小授信客户端 IP 集合。
专业定义

将 KDE 入站限定到选定对端,冲突规则可逆处理

名词和入口
本模块用到的名词
名词意思
fail-closed(失败阻断)
意思:
当安全检测发现异常或潜在漏洞时,系统默认选择关闭或拒绝执行,而非冒险放行。
端口收敛
意思:
将开放监听的服务端口通过防火墙策略收缩到最小必需网络接口与最小授信客户端 IP 集合。
专业定义

将 KDE 入站限定到选定对端,冲突规则可逆处理

出问题时

解决什么

若缺少 Windows 管理员提权,无法写入防火墙规则;若用户未明确授权加固且存在宽泛规则,脚本安全拒绝推进。

边界
  • 只处理本项目KDE规则与明确识别的冲突规则,不代替全机网络策略。
  • 卸载不自动删除第三方程序,已变化资源不强行覆盖。
失败与恢复
  • 存在不限来源、或地址/端口/接口过滤不精确的非项目 KDE 入站放行: 脚本立即 fail-closed 终止,提示使用 -DisableBroadKdeFirewallRules 参数进行受控加固;哪怕看起来很窄,只要还生效就挡住最终验收。
  • 运行缺乏管理员权限: Test-MeshClipAdministrator 检查失败并抛出提权提示,不破坏性部分写入。
  • 安装或配置中断、回滚未完成: 保留原操作记录,先只读恢复预览;按记录处理仍匹配的资源,外来修改继续待协调,不删除标记伪造通过。
出问题时

解决什么

若缺少 Windows 管理员提权,无法写入防火墙规则;若用户未明确授权加固且存在宽泛规则,脚本安全拒绝推进。

边界
  • 只处理本项目KDE规则与明确识别的冲突规则,不代替全机网络策略。
  • 卸载不自动删除第三方程序,已变化资源不强行覆盖。
失败与恢复
  • 存在不限来源、或地址/端口/接口过滤不精确的非项目 KDE 入站放行: 脚本立即 fail-closed 终止,提示使用 -DisableBroadKdeFirewallRules 参数进行受控加固;哪怕看起来很窄,只要还生效就挡住最终验收。
  • 运行缺乏管理员权限: Test-MeshClipAdministrator 检查失败并抛出提权提示,不破坏性部分写入。
  • 安装或配置中断、回滚未完成: 保留原操作记录,先只读恢复预览;按记录处理仍匹配的资源,外来修改继续待协调,不删除标记伪造通过。
依据与来源
真实入口
  • scripts\configure-peer.ps1防火墙加固与规则创建入口
  • scripts\uninstall.ps1规则清理与历史宽泛规则可逆恢复
  • tests\MeshClip.Common.Tests.ps1防火墙过滤契约等价性测试
如何验证
  • 当前测试源码覆盖防火墙规则名哈希确定性、精准过滤契约与多余地址排除断言;这次没有重新运行测试。
  • 10 月 20 日早上(7:34—7:43 之间)主机 doctor.ps1 -AsJson 只读检查,22 项为 20 PASS / 1 FAIL / 1 WARN:Exact-peer firewall 为 PASS;Unmanaged KDE firewall 为 FAIL(Broad non-project inbound allow rules target KDE Connect,即有不属于本项目的宽泛入站放行指向 KDE Connect);KDE peer availability 为 WARN(此刻没有已配对且可达的设备)。10 月 11 日 13:33 那次两项防火墙检查都是 PASS,宽泛规则何时重新出现没取证。不代表副机规则或真实传输也已核过;这次没有运行 Disable 选项。
与其他模块的关系

让KDE网络访问范围与批准对端一致,配对仍由KDE及用户负责。

依据与来源
真实入口
  • scripts\configure-peer.ps1防火墙加固与规则创建入口
  • scripts\uninstall.ps1规则清理与历史宽泛规则可逆恢复
  • tests\MeshClip.Common.Tests.ps1防火墙过滤契约等价性测试
如何验证
  • 当前测试源码覆盖防火墙规则名哈希确定性、精准过滤契约与多余地址排除断言;这次没有重新运行测试。
  • 10 月 20 日早上(7:34—7:43 之间)主机 doctor.ps1 -AsJson 只读检查,22 项为 20 PASS / 1 FAIL / 1 WARN:Exact-peer firewall 为 PASS;Unmanaged KDE firewall 为 FAIL(Broad non-project inbound allow rules target KDE Connect,即有不属于本项目的宽泛入站放行指向 KDE Connect);KDE peer availability 为 WARN(此刻没有已配对且可达的设备)。10 月 11 日 13:33 那次两项防火墙检查都是 PASS,宽泛规则何时重新出现没取证。不代表副机规则或真实传输也已核过;这次没有运行 Disable 选项。
与其他模块的关系

让KDE网络访问范围与批准对端一致,配对仍由KDE及用户负责。

复制 AI 续作说明

项目:精确对端防火墙与宽泛规则防御;仓库:wlyaaaaa/meshclip-kit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。