

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 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库(已归档,只读)

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 不再从这里开始。)
- 批准互连的对端电脑
- 发现宽泛旧规则时是否接受预览后的定向禁用


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


这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 20 日早上主机精确入站检查通过,非项目宽泛规则检查失败(另有宽泛放行指向 KDE Connect,未处理);副机规则这次没查

- Get-MeshClipKdeFirewallAudit读取指向可信kdeconnectd.exe的入站规则和过滤条件。
- Disable-MeshClipBroadKdeFirewallRules禁用明确冲突规则并记录。
- New-MeshClipFirewallRules创建TCP/UDP两条精确过滤规则;事务失败按记录回滚。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 20 日早上主机精确入站检查通过,非项目宽泛规则检查失败(另有宽泛放行指向 KDE Connect,未处理);副机规则这次没查

- Get-MeshClipKdeFirewallAudit读取指向可信kdeconnectd.exe的入站规则和过滤条件。
- Disable-MeshClipBroadKdeFirewallRules禁用明确冲突规则并记录。
- New-MeshClipFirewallRules创建TCP/UDP两条精确过滤规则;事务失败按记录回滚。

- scripts/MeshClip.Transaction.ps1在集成效果前持久记录带类型恢复步骤;失败和硬中断保留待恢复。recover.ps1默认只预览,Apply反向核对实际资源再恢复;外来改动不覆盖,未完成记录不能被新安装/configure覆写。软件包与KDE配对身份不在该集成事务范围。


- scripts/MeshClip.Transaction.ps1在集成效果前持久记录带类型恢复步骤;失败和硬中断保留待恢复。recover.ps1默认只预览,Apply反向核对实际资源再恢复;外来改动不覆盖,未完成记录不能被新安装/configure覆写。软件包与KDE配对身份不在该集成事务范围。



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

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



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

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


- 存在不限来源、或地址/端口/接口过滤不精确的非项目 KDE 入站放行: 脚本立即 fail-closed 终止,提示使用 -DisableBroadKdeFirewallRules 参数进行受控加固;哪怕看起来很窄,只要还生效就挡住最终验收。
- 运行缺乏管理员权限: Test-MeshClipAdministrator 检查失败并抛出提权提示,不破坏性部分写入。
- 安装或配置中断、回滚未完成: 保留原操作记录,先只读恢复预览;按记录处理仍匹配的资源,外来修改继续待协调,不删除标记伪造通过。

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


- 存在不限来源、或地址/端口/接口过滤不精确的非项目 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。








