PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
端到端测试用的文件剪贴板(-tags fakeclip);CI 列出 Windows 剪贴板测试的每一条
baiyuze7d82b45bef2d
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.ymlindex 149d00b..1af91ce 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -71,6 +71,9 @@ jobs:cache-dependency-path: client-core/go.sum- run: go vet ./... ; if ($LASTEXITCODE) { exit 1 } ; go test ./...working-directory: client-core+ # 单独列出剪贴板测试的每一条:没有交互式桌面时它们会跳过,要看得出来+ - run: go test -v -count=1 -run Windows ./internal/clipboard/+ working-directory: client-core- uses: subosito/flutter-action@v2with:channel: stablediff --git a/client-core/cmd/copysyncd/clip_default.go b/client-core/cmd/copysyncd/clip_default.gonew file mode 100644index 0000000..d51927b--- /dev/null+++ b/client-core/cmd/copysyncd/clip_default.go@@ -0,0 +1,7 @@+//go:build !fakeclip++package main++import "github.com/baiyuze/copysync/client-core/internal/clipboard"++func newClipboard() clipboard.Clipboard { return clipboard.New() }diff --git a/client-core/cmd/copysyncd/clip_fake.go b/client-core/cmd/copysyncd/clip_fake.gonew file mode 100644index 0000000..78d3991--- /dev/null+++ b/client-core/cmd/copysyncd/clip_fake.go@@ -0,0 +1,105 @@+//go:build fakeclip++package main++// 端到端测试用的「文件剪贴板」,只在 -tags fakeclip 构建时编进来,正式版里没有。+//+// 让同一台电脑上的测试实例不碰真实的剪贴板:往 $COPYSYNC_FAKE_CLIPBOARD/copy.json+// 写一份内容就算「复制」了一次;本端要写剪贴板时(收到对端的内容),写到 pasted.json。+//+// {"kind": "text", "text": "…"}+// {"kind": "html", "html": "<b>…</b>", "text": "…"}+// {"kind": "image", "image": "<PNG 的 base64>"}+// {"kind": "file", "files": ["/绝对路径", …]}++import (+ "encoding/json"+ "errors"+ "os"+ "path/filepath"++ "github.com/baiyuze/copysync/client-core/internal/clipboard"+)++type fakeContent struct {+ Kind string `json:"kind"`+ Text string `json:"text,omitempty"`+ HTML string `json:"html,omitempty"`+ Image []byte `json:"image,omitempty"`+ Files []string `json:"files,omitempty"`+}++var fakeKinds = map[string]clipboard.Kind{+ "text": clipboard.KindText, "html": clipboard.KindHTML,+ "image": clipboard.KindImage, "file": clipboard.KindFile,+}++type fakeClipboard struct {+ dir string+ count int64 // 每写一次 pasted.json 加一,与 copy.json 的修改时间一起构成 ChangeCount+}++func newClipboard() clipboard.Clipboard {+ dir := os.Getenv("COPYSYNC_FAKE_CLIPBOARD")+ if dir == "" {+ panic("fakeclip 构建需要设置 COPYSYNC_FAKE_CLIPBOARD")+ }+ _ = os.MkdirAll(dir, 0o700)+ return &fakeClipboard{dir: dir}+}++func (f *fakeClipboard) read() (fakeContent, int64, error) {+ path := filepath.Join(f.dir, "copy.json")+ info, err := os.Stat(path)+ if err != nil {+ return fakeContent{}, f.count, nil // 还没「复制」过+ }+ raw, err := os.ReadFile(path)+ if err != nil {+ return fakeContent{}, 0, err+ }+ var c fakeContent+ if err := json.Unmarshal(raw, &c); err != nil {+ return fakeContent{}, 0, err+ }+ return c, info.ModTime().UnixNano() + f.count, nil+}++func (f *fakeClipboard) Peek() (clipboard.Snapshot, error) {+ c, n, err := f.read()+ if err != nil {+ return clipboard.Snapshot{}, err+ }+ return clipboard.Snapshot{ChangeCount: n, Kind: fakeKinds[c.Kind]}, nil+}++func (f *fakeClipboard) Read() (clipboard.Content, error) {+ c, _, err := f.read()+ if err != nil {+ return clipboard.Content{}, err+ }+ kind, ok := fakeKinds[c.Kind]+ if !ok {+ return clipboard.Content{}, errors.New("copy.json 里的 kind 不认识")+ }+ return clipboard.Content{Kind: kind, Text: c.Text, HTML: c.HTML, Image: c.Image, Files: c.Files}, nil+}++func (f *fakeClipboard) Write(c clipboard.Content) error {+ out := fakeContent{Text: c.Text, HTML: c.HTML, Image: c.Image, Files: c.Files}+ for name, k := range fakeKinds {+ if k == c.Kind {+ out.Kind = name+ }+ }+ raw, err := json.MarshalIndent(out, "", " ")+ if err != nil {+ return err+ }+ f.count+++ return os.WriteFile(filepath.Join(f.dir, "pasted.json"), raw, 0o600)+}++func (f *fakeClipboard) Permission() clipboard.Permission { return clipboard.PermissionNotApplicable }++func (f *fakeClipboard) OpenPermissionSettings() error { return nil }diff --git a/client-core/cmd/copysyncd/main.go b/client-core/cmd/copysyncd/main.goindex 736296f..6f01aa8 100644--- a/client-core/cmd/copysyncd/main.go+++ b/client-core/cmd/copysyncd/main.go@@ -91,7 +91,7 @@ var errAlreadyRunning = errors.New("已有后台服务在运行")// 与 daemon 的其余部分隔离开。func probeClipboard() {clipboard.InitPlatform()- cb := clipboard.New()+ cb := newClipboard()fmt.Println("授权状态:", cb.Permission())@@ -194,7 +194,7 @@ func run(dataDir string) error {clipboard.InitPlatform()loop := clipboard.NewMainLoop()watcher := clipboard.NewWatcher(clipboard.WatcherOptions{- Clipboard: clipboard.New(),+ Clipboard: newClipboard(),MainLoop: loop,OnPermission: func(p clipboard.Permission) {hub.Publish(rpc.EventPermissionChanged(permissionToProto(p)))diff --git a/client-core/copysyncd b/client-core/copysyncdnew file mode 100755index 0000000..a67ec1dBinary files /dev/null and b/client-core/copysyncd differdiff --git a/design/windows-client.md b/design/windows-client.mdindex c169885..36b856a 100644--- a/design/windows-client.md+++ b/design/windows-client.md@@ -1,6 +1,6 @@# Windows 客户端技术方案-> 状态:方案,待评审(2026-10-09)+> 状态:开发中,`windows` 分支(2026-10-09)> 目标版本:1.2.0(Mac 与 Windows 同时发布)> 相关:[多出口网络的 NAT 打洞](nat-traversal.md)@@ -87,7 +87,7 @@ copysync-cli.exe(命令行,排障用)| 带格式文本 | 注册格式 `HTML Format`(CF_HTML),解析头部偏移量取出 HTML | `HTML Format`(生成带偏移量的头部)+ `CF_UNICODETEXT` || 纯文本 | `CF_UNICODETEXT` | `CF_UNICODETEXT`(`CF_TEXT` 由系统合成) |-判型顺序与 Mac 版的 `classify` 一致:文件优先于图片,图片优先于文本。资源管理器复制文件时剪贴板里同时有文件名文本;Excel 复制单元格时同时有 HTML、图片和文本,按带格式文本处理,与 Mac 上从 Numbers 复制的行为一致。+判型顺序:文件最优先(资源管理器复制文件时剪贴板里同时有文件名文本);只有图片、没有文本时才算图片(截图、画图、浏览器里「复制图片」);Excel、Word 复制的内容同时带着一份渲染出来的图片,但有文本,按带格式文本处理。**文件粘贴不需要 COM。**占位实现的注释里写着「文件粘贴需要在 Go 里实现 COM IDataObject」,那是按延迟渲染设想的。Mac 版已经验证过延迟渲染行不通,改成了「先落盘、再写剪贴板」;Windows 也一样,收到的文件已在本地缓存里,直接给 `CF_HDROP` 真实路径即可。