KDE Connect 授信配对与文本文件流转
现在
冻结 · 快照核对 10 月 11 日
截至 10 月 11 日

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 Connect 授信配对与文本文件流转
现在
冻结 · 快照核对 10 月 11 日
截至 10 月 11 日

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 不再从这里开始配置。)

需要准备什么
  • 要配对的两台电脑
  • 两端分别确认配对
  • 用于试传的生成样本(验收脚本造的虚构文字和文件,不用真实密码)
从开始到拿到结果
1发现并配对
两端配置准确对端后,在 KDE 界面核对身份并分别确认信任。
2选择传输内容
用生成的非秘密文字试剪贴板,文件单独发送。两台都是我的可信电脑,“连同密码一起同步”(Including passwords)开着也可以,项目 9 月 29 日起不再要求关掉。
3核对接收
重要文件在两端比对哈希;中断的大文件须重新完整发送,不能称自动续传。
从哪里开始

先完成两端 Tailscale 与精确防火墙配置,再在两台 KDE Connect 界面核对设备并手工接受配对。(这是冻结前的做法;现在本机仓库副本已删,AI 不再从这里开始配置。)

需要准备什么
  • 要配对的两台电脑
  • 两端分别确认配对
  • 用于试传的生成样本(验收脚本造的虚构文字和文件,不用真实密码)
从开始到拿到结果
1发现并配对
两端配置准确对端后,在 KDE 界面核对身份并分别确认信任。
2选择传输内容
用生成的非秘密文字试剪贴板,文件单独发送。两台都是我的可信电脑,“连同密码一起同步”(Including passwords)开着也可以,项目 9 月 29 日起不再要求关掉。
3核对接收
重要文件在两端比对哈希;中断的大文件须重新完整发送,不能称自动续传。
技术实现与依据(一)

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

9 月 29 日双向文字实测通过;10 月 20 日早上主机自检:没有已配对且可达的 KDE 设备(WARN),文件互传未实测

关键规则与设计选择
1
脚本不静默同意配对,双方核对设备身份后确认。
2
可信设备之间同步密码是允许的:9 月 29 日起项目撤销了“必须关闭 Including passwords”的要求,doctor 也删掉了那条固定提醒;验收只用生成样本,报告里不出现真实密码。
3
纯文本在线尽力而为,不解决离线补发、同时复制排序和图像剪贴板。
4
1GB是文档测试目标(1024 MiB),不能推出协议最大文件限制,也还没有实测过。
当前怎样实现
  • 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),文件互传未实测

关键规则与设计选择
1
脚本不静默同意配对,双方核对设备身份后确认。
2
可信设备之间同步密码是允许的:9 月 29 日起项目撤销了“必须关闭 Including passwords”的要求,doctor 也删掉了那条固定提醒;验收只用生成样本,报告里不出现真实密码。
3
纯文本在线尽力而为,不解决离线补发、同时复制排序和图像剪贴板。
4
1GB是文档测试目标(1024 MiB),不能推出协议最大文件限制,也还没有实测过。
当前怎样实现
  • 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。
技术实现与依据(二)
执行流程
1
两端分别写customDevices并检查精确入站。
2
用户核对设备身份并确认KDE配对。
3
先用生成的非秘密测试文字试剪贴板;密码同步开关按本人习惯,不要求关闭。
4
重要文件接收后,两端另算SHA-256核对;本项目没有自动劫持发送路径。
技术实现与依据(二)
执行流程
1
两端分别写customDevices并检查精确入站。
2
用户核对设备身份并确认KDE配对。
3
先用生成的非秘密测试文字试剪贴板;密码同步开关按本人习惯,不要求关闭。
4
重要文件接收后,两端另算SHA-256核对;本项目没有自动劫持发送路径。
名词和入口
本模块用到的名词
名词意思
customDevicesKDE Connect 的静态对端 IP 清单配置项,用于在无法使用 UDP 广播时主动探测目标。
在线尽力而为(Best-effort)在两端均在线时以最优路径及时交付数据,但不保证离线持久化存储或严格时序编排。
专业定义

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

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

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

出问题时

解决什么

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

边界
  • 剪贴板纯文本流转不接管图像或格式化富文本(图像作为文件传输)。
  • 大文件传输不包含断点续传能力,网络中断必须重新完整发送。
  • 测试辅助只生成虚构内容,不读剪贴板历史;清理只删除本次生成且未变化的文件。文件互传、每方向 100 条连续标记、延迟和完整双机重启还没有实测记录,不把指南存在写成完成。
失败与恢复
  • 设备在线但配对待核对: doctor保留人工确认提示,不自动替用户接受配对。
  • 读不出 KDE 设备状态: doctor 记为未知(Unknown),设备数留空,不当成零台设备,也不当成对端已关机;要确认就去两端 KDE 界面看。
  • 文件传输中断: 重新发送,并在接收完成后比较哈希。
出问题时

解决什么

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

边界
  • 剪贴板纯文本流转不接管图像或格式化富文本(图像作为文件传输)。
  • 大文件传输不包含断点续传能力,网络中断必须重新完整发送。
  • 测试辅助只生成虚构内容,不读剪贴板历史;清理只删除本次生成且未变化的文件。文件互传、每方向 100 条连续标记、延迟和完整双机重启还没有实测记录,不把指南存在写成完成。
失败与恢复
  • 设备在线但配对待核对: doctor保留人工确认提示,不自动替用户接受配对。
  • 读不出 KDE 设备状态: doctor 记为未知(Unknown),设备数留空,不当成零台设备,也不当成对端已关机;要确认就去两端 KDE 界面看。
  • 文件传输中断: 重新发送,并在接收完成后比较哈希。
依据与来源
真实入口
  • scripts\MeshClip.Common.psm1customDevices 读写、配置备份与修复
  • docs\PRODUCT.md一致性定义与成功准则规范
  • tests\MeshClip.Common.Tests.ps1配置读写与多行 UTF-8 保持测试
如何验证
  • 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\MeshClip.Common.psm1customDevices 读写、配置备份与修复
  • docs\PRODUCT.md一致性定义与成功准则规范
  • tests\MeshClip.Common.Tests.ps1配置读写与多行 UTF-8 保持测试
如何验证
  • 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。