

MeshClip Kit · 功能说明(项目已冻结)
说明谁来配对、谁来传输、谁来核验,避免把安装完成当成文件已经送达。
当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,现在不再作为两台电脑之间的现役服务来维护。冻结前的情况:9 月 29 日 01:25 两个方向的文字复制粘贴有真实实测记录;文件互传和完整双机验收到冻结也没有记录。10 月 20 日早上主机只读自检读出了 KDE 的设备状态:那时没有已配对、连得上的设备(记为提醒),所以冻结前最后能不能互相粘贴不能算数;对面那台电脑本身在线、ping 得通。归档后两台上的 KDE Connect 还开不开、配对还在不在,没查,是 Unknown。
项目快照核对于 2026-10-20(北京时间),运行情况依据当天早上 7:34—7:43 之间的主机只读自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库(已归档,只读)

MeshClip Kit · 功能说明(项目已冻结)
说明谁来配对、谁来传输、谁来核验,避免把安装完成当成文件已经送达。
当前情况:这是双机剪贴板冻结前的一项功能。项目已列入冻结名单(停用留档),GitHub 仓库 10 月 21 日归档、本机副本已删,现在不再作为两台电脑之间的现役服务来维护。冻结前的情况:9 月 29 日 01:25 两个方向的文字复制粘贴有真实实测记录;文件互传和完整双机验收到冻结也没有记录。10 月 20 日早上主机只读自检读出了 KDE 的设备状态:那时没有已配对、连得上的设备(记为提醒),所以冻结前最后能不能互相粘贴不能算数;对面那台电脑本身在线、ping 得通。归档后两台上的 KDE Connect 还开不开、配对还在不在,没查,是 Unknown。
项目快照核对于 2026-10-20(北京时间),运行情况依据当天早上 7:34—7:43 之间的主机只读自检;10 月 21 日归档后没有再查。具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库(已归档,只读)


网络在线、设备可见、人工配对、插件启用和实际收到内容是不同条件。明确区分后,才能知道复制没到时该查哪一步。
冻结前可以说:“把这份测试文件发到另一台电脑。”两端先亲自确认 KDE 配对;接收完成后分别比较文件内容是否一致。两台互相复制文字在 9 月 29 日实测过,文件互传到冻结也没有实测记录。项目冻结后,AI 不再按这套流程配对、试传或排障。
两端配置和人工配对完成后可使用KDE的在线文字与文件通道;每次重要传输的结果需要真实接收证据。这是冻结前的设计结果,不代表现在两台之间还开着这条通道。
两端已配对且在线,文字在另一台能粘贴,文件确实收到;重要文件再核对内容一致。
看到设备却无法传输时,分别检查配对、插件、对端在线和当前连接。
任一端未登录、离线或没配对时,不能按正常流程共享。项目冻结后,这一层出问题 AI 也不再去修。

网络在线、设备可见、人工配对、插件启用和实际收到内容是不同条件。明确区分后,才能知道复制没到时该查哪一步。
冻结前可以说:“把这份测试文件发到另一台电脑。”两端先亲自确认 KDE 配对;接收完成后分别比较文件内容是否一致。两台互相复制文字在 9 月 29 日实测过,文件互传到冻结也没有实测记录。项目冻结后,AI 不再按这套流程配对、试传或排障。
两端配置和人工配对完成后可使用KDE的在线文字与文件通道;每次重要传输的结果需要真实接收证据。这是冻结前的设计结果,不代表现在两台之间还开着这条通道。
两端已配对且在线,文字在另一台能粘贴,文件确实收到;重要文件再核对内容一致。
看到设备却无法传输时,分别检查配对、插件、对端在线和当前连接。
任一端未登录、离线或没配对时,不能按正常流程共享。项目冻结后,这一层出问题 AI 也不再去修。

先完成两端 Tailscale 与精确防火墙配置,再在两台 KDE Connect 界面核对设备并手工接受配对。(这是冻结前的做法;现在本机仓库副本已删,AI 不再从这里开始配置。)
- 要配对的两台电脑
- 两端分别确认配对
- 用于试传的生成样本(验收脚本造的虚构文字和文件,不用真实密码)


先完成两端 Tailscale 与精确防火墙配置,再在两台 KDE Connect 界面核对设备并手工接受配对。(这是冻结前的做法;现在本机仓库副本已删,AI 不再从这里开始配置。)
- 要配对的两台电脑
- 两端分别确认配对
- 用于试传的生成样本(验收脚本造的虚构文字和文件,不用真实密码)


这里保留实现、关键条件、精确入口、历史记录和验证结果。
9 月 29 日双向文字实测通过;10 月 20 日早上主机自检:没有已配对且可达的 KDE 设备(WARN),文件互传未实测

- Write-MeshClipKdeConfigChange保留编码/注释,变更前备份,异常可回滚。
- Repair-MeshClipLegacyDuplicateGeneralLines只接受已知旧版重复形态,其余歧义拒绝。
- 文件发送属于KDE原生能力;Get-MeshClipFileHashSafe用于项目内部资源比对,传输验收依文档在两端人工运行Get-FileHash。
- acceptance.ps1 为每个方向各生成 100 条不重复的非秘密标记;文件默认只生成 1 MiB,加 -SizesMiB 1,100,1024 才生成 1 MiB、100 MiB、1024 MiB 三种。RecordClipboard 只收和生成标记对得上的观察,没给延迟就记为空;VerifyFile 核对另一路径上的接收副本,只证明长度和 SHA-256 一致。配对、重启恢复和不回环这三项要真实观察后用 RecordCheck 记下;Summary 不自动签发业务 PASS。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
9 月 29 日双向文字实测通过;10 月 20 日早上主机自检:没有已配对且可达的 KDE 设备(WARN),文件互传未实测

- Write-MeshClipKdeConfigChange保留编码/注释,变更前备份,异常可回滚。
- Repair-MeshClipLegacyDuplicateGeneralLines只接受已知旧版重复形态,其余歧义拒绝。
- 文件发送属于KDE原生能力;Get-MeshClipFileHashSafe用于项目内部资源比对,传输验收依文档在两端人工运行Get-FileHash。
- acceptance.ps1 为每个方向各生成 100 条不重复的非秘密标记;文件默认只生成 1 MiB,加 -SizesMiB 1,100,1024 才生成 1 MiB、100 MiB、1024 MiB 三种。RecordClipboard 只收和生成标记对得上的观察,没给延迟就记为空;VerifyFile 核对另一路径上的接收副本,只证明长度和 SHA-256 一致。配对、重启恢复和不回环这三项要真实观察后用 RecordCheck 记下;Summary 不自动签发业务 PASS。




| 名词 | 意思 |
|---|---|
| customDevices | KDE Connect 的静态对端 IP 清单配置项,用于在无法使用 UDP 广播时主动探测目标。 |
| 在线尽力而为(Best-effort) | 在两端均在线时以最优路径及时交付数据,但不保证离线持久化存储或严格时序编排。 |

双向人工配对核验与尽力而为传输边界



双向人工配对核验与尽力而为传输边界

解决什么
设备可ping通但未配对时仍不能正常传输;中断后要重新发送,不承诺断点续传。


- 设备在线但配对待核对: doctor保留人工确认提示,不自动替用户接受配对。
- 读不出 KDE 设备状态: doctor 记为未知(Unknown),设备数留空,不当成零台设备,也不当成对端已关机;要确认就去两端 KDE 界面看。
- 文件传输中断: 重新发送,并在接收完成后比较哈希。

解决什么
设备可ping通但未配对时仍不能正常传输;中断后要重新发送,不承诺断点续传。


- 设备在线但配对待核对: doctor保留人工确认提示,不自动替用户接受配对。
- 读不出 KDE 设备状态: doctor 记为未知(Unknown),设备数留空,不当成零台设备,也不当成对端已关机;要确认就去两端 KDE 界面看。
- 文件传输中断: 重新发送,并在接收完成后比较哈希。

scripts\customDevices 读写、配置备份与修复MeshClip.Common.psm1
docs\一致性定义与成功准则规范PRODUCT.md
tests\配置读写与多行 UTF-8 保持测试MeshClip.Common.Tests.ps1
- 9 月 8 日那次 66 项历史回归含配置保留、旧版修复和 14 个设备计数情形;这 14 个是用模拟的 KDE 命令输出跑出来的,不是 14 次双机实测。当前源码有 85 个测试定义(参数化展开约 96 个用例),这次没有重新运行。
- 9 月 29 日 01:25 两个方向的普通文字复制粘贴有真实实测记录(来自当时的修复记录,之后没有再测)。9 月 14 日只读设备汇总已知 1 台、可用 1 台(Known=1、Available=1),9 月 8 日一次 --refresh 后可用数为 0,都只是当时的历史;10 月 11 日 13:33 读 KDE 设备状态失败,记为未知;10 月 20 日早上(7:34—7:43 之间)doctor 的 KDE peer availability 为 WARN:No paired and reachable KDE Connect device is currently available(此刻没有已配对且可达的设备)。副机按需运行状态和配对身份这次没查。
这一层才是用户真正复制和发送的位置,结果不能由底层网络或脚本测试代替。

scripts\customDevices 读写、配置备份与修复MeshClip.Common.psm1
docs\一致性定义与成功准则规范PRODUCT.md
tests\配置读写与多行 UTF-8 保持测试MeshClip.Common.Tests.ps1
- 9 月 8 日那次 66 项历史回归含配置保留、旧版修复和 14 个设备计数情形;这 14 个是用模拟的 KDE 命令输出跑出来的,不是 14 次双机实测。当前源码有 85 个测试定义(参数化展开约 96 个用例),这次没有重新运行。
- 9 月 29 日 01:25 两个方向的普通文字复制粘贴有真实实测记录(来自当时的修复记录,之后没有再测)。9 月 14 日只读设备汇总已知 1 台、可用 1 台(Known=1、Available=1),9 月 8 日一次 --refresh 后可用数为 0,都只是当时的历史;10 月 11 日 13:33 读 KDE 设备状态失败,记为未知;10 月 20 日早上(7:34—7:43 之间)doctor 的 KDE peer availability 为 WARN:No paired and reachable KDE Connect device is currently available(此刻没有已配对且可达的设备)。副机按需运行状态和配对身份这次没查。
这一层才是用户真正复制和发送的位置,结果不能由底层网络或脚本测试代替。
复制 AI 续作说明
项目:KDE Connect 授信配对与文本文件流转;仓库:wlyaaaaa/meshclip-kit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。





