Skip to content

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.

端到端测试用的文件剪贴板(-tags fakeclip);CI 列出 Windows 剪贴板测试的每一条

baiyuze7d82b45bef2d
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 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@v2
with:
channel: stable
diff --git a/client-core/cmd/copysyncd/clip_default.go b/client-core/cmd/copysyncd/clip_default.go
new file mode 100644
index 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.go
new file mode 100644
index 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.go
index 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/copysyncd
new file mode 100755
index 0000000..a67ec1d
Binary files /dev/null and b/client-core/copysyncd differ
diff --git a/design/windows-client.md b/design/windows-client.md
index 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` 真实路径即可。