

MeshClip Kit · 功能说明(项目已冻结)
通常不需要手工路由器端口映射,通过现有 Tailscale 网络连接批准对端,避免另建中继服务。
当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,AI 不再用这套脚本配对端、查连通。冻结前的情况:10 月 11 日 13:33 主机这一端的网络检查通过,那次 ping 到了批准的对端电脑;这只证明能联系到那台电脑,不证明两台已配对,也不证明剪贴板或文件已经传到。Tailscale 本身是独立安装的软件,项目冻结不说明它已卸载或停用;它现在的状态这次没查。
项目快照核对于 2026-10-11(北京时间),运行情况依据当天 13:33 的主机自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库(已归档,只读)

MeshClip Kit · 功能说明(项目已冻结)
通常不需要手工路由器端口映射,通过现有 Tailscale 网络连接批准对端,避免另建中继服务。
当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,AI 不再用这套脚本配对端、查连通。冻结前的情况:10 月 11 日 13:33 主机这一端的网络检查通过,那次 ping 到了批准的对端电脑;这只证明能联系到那台电脑,不证明两台已配对,也不证明剪贴板或文件已经传到。Tailscale 本身是独立安装的软件,项目冻结不说明它已卸载或停用;它现在的状态这次没查。
项目快照核对于 2026-10-11(北京时间),运行情况依据当天 13:33 的主机自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库(已归档,只读)


用途与实际影响(冻结前)
跨子网时 KDE 广播发现可能找不到另一台电脑。明确对端地址能让 KDE 主动探测;组网故障和应用配对仍要分开判断。
冻结前可以说:“帮我确认这两台已登记的电脑能不能联系到,先不要传文件。”AI核对选中的两台设备和它们的连接地址,再检查指定连接;交回哪一端可达、哪一段失败和依据。能联系到电脑还不代表剪贴板或文件传输已成功。项目冻结后,AI 不再从这个项目的脚本做这件事。
得到准确对端地址及连通性诊断,供后续配置使用;ping成功不是剪贴板和文件验收。

用途与实际影响(冻结前)
跨子网时 KDE 广播发现可能找不到另一台电脑。明确对端地址能让 KDE 主动探测;组网故障和应用配对仍要分开判断。
冻结前可以说:“帮我确认这两台已登记的电脑能不能联系到,先不要传文件。”AI核对选中的两台设备和它们的连接地址,再检查指定连接;交回哪一端可达、哪一段失败和依据。能联系到电脑还不代表剪贴板或文件传输已成功。项目冻结后,AI 不再从这个项目的脚本做这件事。
得到准确对端地址及连通性诊断,供后续配置使用;ping成功不是剪贴板和文件验收。

两台指定电脑都已加入同一 Tailscale 网络并在线,诊断确认能找到对方;文件传输和 KDE 配对仍另验。
有多台可能的电脑却没指定目标,或对端离线时停止自动选择,请本人确认要连哪台。
Tailscale 未运行或本人尚未通过官方网页登录时,先完成这一步,不尝试绕过身份。项目冻结、本机副本删掉后,这套诊断在这台电脑上已经没有可直接运行的入口。

两台指定电脑都已加入同一 Tailscale 网络并在线,诊断确认能找到对方;文件传输和 KDE 配对仍另验。
有多台可能的电脑却没指定目标,或对端离线时停止自动选择,请本人确认要连哪台。
Tailscale 未运行或本人尚未通过官方网页登录时,先完成这一步,不尝试绕过身份。项目冻结、本机副本删掉后,这套诊断在这台电脑上已经没有可直接运行的入口。

两台电脑开始的方式不一样。常开的主机运行 scripts/install-windows.ps1 做完整部署;按需打开的副机先用 scripts/recover.ps1 -AsJson 查有没有上次没收完尾的改动,再用 scripts/deploy-on-demand.ps1 按核准的提交号(Git 里标记某个版本的 40 位编号)部署,先加 -WhatIf(只预览、不真改)看一遍。两端都经官方浏览器登录 Tailscale,再各自运行 scripts/configure-peer.ps1 -Peer 指定准确对端,用 scripts/doctor.ps1 查可达性。(这是冻结前的入口;现在本机仓库副本已删,这些脚本只在 GitHub 归档仓库里留着,AI 不再从这里开始。)
- 要互连的两台 Windows 电脑:一台常开的主机,一台按需打开的副机
- 本人通过官方浏览器完成 Tailnet 登录


两台电脑开始的方式不一样。常开的主机运行 scripts/install-windows.ps1 做完整部署;按需打开的副机先用 scripts/recover.ps1 -AsJson 查有没有上次没收完尾的改动,再用 scripts/deploy-on-demand.ps1 按核准的提交号(Git 里标记某个版本的 40 位编号)部署,先加 -WhatIf(只预览、不真改)看一遍。两端都经官方浏览器登录 Tailscale,再各自运行 scripts/configure-peer.ps1 -Peer 指定准确对端,用 scripts/doctor.ps1 查可达性。(这是冻结前的入口;现在本机仓库副本已删,这些脚本只在 GitHub 归档仓库里留着,AI 不再从这里开始。)
- 要互连的两台 Windows 电脑:一台常开的主机,一台按需打开的副机
- 本人通过官方浏览器完成 Tailnet 登录


这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日 13:33 主机网络层检查通过;同一次 KDE 应用状态读不出,另算

- Get-MeshClipTailscaleStatus 安全解析 tailscale status --json 输出。
- Resolve-MeshClipApprovedWindowsPeer 校验对端状态、系统类型与唯一性。
- ConvertTo-MeshClipRedactedAddress 给地址打码:IPv4 只留第一段、后面写成 x.x.x,IPv6 只留第一段,无效地址整段隐藏;这是固定截断,不是哈希(把内容换算成一串摘要码)。


这里保留实现、关键条件、精确入口、历史记录和验证结果。
10 月 11 日 13:33 主机网络层检查通过;同一次 KDE 应用状态读不出,另算

- Get-MeshClipTailscaleStatus 安全解析 tailscale status --json 输出。
- Resolve-MeshClipApprovedWindowsPeer 校验对端状态、系统类型与唯一性。
- ConvertTo-MeshClipRedactedAddress 给地址打码:IPv4 只留第一段、后面写成 x.x.x,IPv6 只留第一段,无效地址整段隐藏;这是固定截断,不是哈希(把内容换算成一串摘要码)。





| 名词 | 意思 |
|---|---|
| Tailnet(Tailscale 虚拟网络) | Tailscale 账户下的所有授权设备组成的专属点对点加密网状网络。 |
| Run Unattended(无人值守) | Tailscale 无人值守服务模式,无需用户手动打开客户端界面即可在后台自启保持在线。 |

跨网络加密隧道与单对端安全发现



跨网络加密隧道与单对端安全发现

解决什么
若 Tailscale 未登录、处于 Shields Up 模式,或存在多个同名/离线设备导致无法安全辨别目标,脚本拒绝盲目猜测并终止执行。


- 对端设备关机或离线: Resolve-MeshClipApprovedWindowsPeer 抛出错误拒绝继续,提示开启对端电脑。
- Tailscale 开启了 shields-up: doctor 诊断标记 FAIL 并提示关闭入站拦截以允许 KDE Connect 流量进入。

解决什么
若 Tailscale 未登录、处于 Shields Up 模式,或存在多个同名/离线设备导致无法安全辨别目标,脚本拒绝盲目猜测并终止执行。


- 对端设备关机或离线: Resolve-MeshClipApprovedWindowsPeer 抛出错误拒绝继续,提示开启对端电脑。
- Tailscale 开启了 shields-up: doctor 诊断标记 FAIL 并提示关闭入站拦截以允许 KDE Connect 流量进入。

scripts\Tailscale 状态与对端解析核心逻辑MeshClip.Common.psm1
scripts\对端配置入口脚本configure-peer.ps1
tests\地址脱敏与对端解析单元测试MeshClip.Common.Tests.ps1
- 当前测试源码覆盖精确名称匹配、离线/非 Windows 拒绝、多对端歧义与地址打码;这次没有重新运行测试,9 月 8 日那次 66 项历史回归保留原日期。
- 10 月 11 日 13:33 主机自检:Tailscale 1.104.1 服务自动运行、本机在线、无人值守开启、入站拦截(shields-up)关闭、唯一批准对端和 ping 当次通过;同一次读不出 KDE 应用状态(记为未知),不能据此说两台已配对或能传。
为KDE对端配置提供明确的网络地址和可达证据,不替代应用层确认。

scripts\Tailscale 状态与对端解析核心逻辑MeshClip.Common.psm1
scripts\对端配置入口脚本configure-peer.ps1
tests\地址脱敏与对端解析单元测试MeshClip.Common.Tests.ps1
- 当前测试源码覆盖精确名称匹配、离线/非 Windows 拒绝、多对端歧义与地址打码;这次没有重新运行测试,9 月 8 日那次 66 项历史回归保留原日期。
- 10 月 11 日 13:33 主机自检:Tailscale 1.104.1 服务自动运行、本机在线、无人值守开启、入站拦截(shields-up)关闭、唯一批准对端和 ping 当次通过;同一次读不出 KDE 应用状态(记为未知),不能据此说两台已配对或能传。
为KDE对端配置提供明确的网络地址和可达证据,不替代应用层确认。
复制 AI 续作说明
项目:Tailscale 专用组网与端点精准解析;仓库:wlyaaaaa/meshclip-kit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








