桌面剪貼簿與本機系統雙向同步：autocutsel 對齊 X11 與 VNC

README.md

@@ -56,6 +56,11 @@ OpenCode 在啟動時安裝，並重設使用者層級設定為預設值。
   所以固定分頁裡永遠有 1 個可用的圖形終端機視窗（使用者自己另開的终端機不受影響）。
 - 容器內沒有 systemd-logind session，因此會自動停用 `lxpolkit` 與 `light-locker`
   autostart，避免桌面啟動時跳出「No session for pid …」的 Error 對話框。
+- **剪貼簿同步**：桌面右上角有「剪貼簿同步：開／關」按鈕。開啟時，桌面裡的
+  CLIPBOARD／PRIMARY 會與瀏覽器所在系統的剪貼簿雙向同步；在桌面內按 Ctrl+V
+  （或 Cmd+V）會先把本機剪貼簿送進 X11 再貼上。底層由 `autocutsel` 將 x11vnc
+  使用的 CUT_BUFFER0 與 X11 selection 對齊，xterm 也設定為選取即同步 CLIPBOARD。
+  瀏覽器基於安全限制，頁面需要保持在前景；若系統阻擋寫入，點一下桌面會重試。
 - 瀏覽器是透過 `/vnc` WebSocket 橋接到同一個桌面，所有裝置看到完全相同、可同時操作的
   LXDE 畫面；關掉瀏覽器分頁不會終止桌面，重新整理或重新連線都會接回原畫面。
 - 這個分頁是固定的：按它的 `×` 不會刪除分頁，而是重新啟動一份新的桌面

app.py

@@ -1179,7 +1179,7 @@ DESKTOP_GEOMETRY = os.environ.get("DESKTOP_GEOMETRY", "1440x900x24")
 DESKTOP_VNC_PORT = int(os.environ.get("DESKTOP_VNC_PORT", "5900"))
 DESKTOP_NOVNC_ROOT = os.environ.get("DESKTOP_NOVNC_ROOT", "/usr/share/novnc")
 DESKTOP_LOG = "/tmp/webterm-desktop.log"
-DESKTOP_APT_PACKAGES = "xvfb x11vnc lxde-core xterm novnc x11-utils"
+DESKTOP_APT_PACKAGES = "xvfb x11vnc lxde-core xterm novnc x11-utils autocutsel"
 DESKTOP_TERM_TITLE = "共用終端機"
 DESKTOP_WATCHDOG = None
 
@@ -1215,17 +1215,106 @@ html,body{width:100%;height:100%;overflow:hidden;background:#000;font-family:'Se
 #retry{pointer-events:auto;display:none;border:1px solid #ffffff33;background:#2d2d2d;color:#ddd;
        border-radius:4px;padding:4px 9px;cursor:pointer;font-size:12px}
 #retry:hover{background:#3c3c3c;color:#fff}
+#clip{pointer-events:auto;border:1px solid #ffffff33;background:#2d2d2d;color:#ddd;
+      border-radius:4px;padding:4px 9px;cursor:pointer;font-size:12px;white-space:nowrap}
+#clip:hover{background:#3c3c3c;color:#fff}
+#clip.off{opacity:.55}
 </style>
 </head>
 <body>
 <div id="screen" tabindex="0"></div>
-<div id="bar"><span id="dot"></span><span id="msg">正在連線到共用桌面…</span><button id="retry" type="button">重新連線</button></div>
+<div id="bar"><span id="dot"></span><span id="msg">正在連線到共用桌面…</span><button id="retry" type="button">重新連線</button><button id="clip" type="button" title="與瀏覽器所在系統的剪貼簿雙向同步（頁面需保持在前景）">剪貼簿同步</button></div>
 <script type="module">
 const screenEl = document.getElementById('screen');
 const dot = document.getElementById('dot');
 const msg = document.getElementById('msg');
 const retry = document.getElementById('retry');
+const clipBtn = document.getElementById('clip');
 let rfb = null, delay = 800, disposed = false, connecting = false;
+let clipSync = localStorage.getItem('webtermClipboardSync') !== 'off';
+let lastRemoteClip = '';
+let pendingRemoteClip = '';
+
+function updateClipBtn() {
+  clipBtn.textContent = clipSync ? '剪貼簿同步：開' : '剪貼簿同步：關';
+  clipBtn.classList.toggle('off', !clipSync);
+  clipBtn.title = clipSync
+    ? '已與本機系統剪貼簿雙向同步；關閉請按一下（頁面需保持在前景）'
+    : '目前不同步；按一下開啟（會把本機剪貼簿帶進桌面）';
+}
+updateClipBtn();
+
+function writeLocalClipboard(text) {
+  if (!clipSync || !text) return Promise.resolve(false);
+  const done = ok => {
+    if (ok) {
+      clipBtn.title = '已同步到本機剪貼簿；關閉同步請按一下';
+    } else {
+      clipBtn.title = '瀏覽器暫不允許寫入剪貼簿；點一下桌面或按 Ctrl+V 再試';
+    }
+    return ok;
+  };
+  if (navigator.clipboard && navigator.clipboard.writeText) {
+    return navigator.clipboard.writeText(text).then(() => done(true)).catch(() => {
+      pendingRemoteClip = text;
+      return done(false);
+    });
+  }
+  try {
+    const ta = document.createElement('textarea');
+    ta.value = text;
+    ta.style.cssText = 'position:fixed;left:-9999px;top:0;opacity:0';
+    document.body.appendChild(ta);
+    ta.select();
+    const ok = document.execCommand('copy');
+    ta.remove();
+    if (!ok) pendingRemoteClip = text;
+    return Promise.resolve(done(ok));
+  } catch (e) {
+    pendingRemoteClip = text;
+    return Promise.resolve(false);
+  }
+}
+
+async function flushPendingClipboard() {
+  if (!clipSync || !pendingRemoteClip) return;
+  const text = pendingRemoteClip;
+  if (await writeLocalClipboard(text) && pendingRemoteClip === text) {
+    pendingRemoteClip = '';
+  }
+}
+
+async function pullLocalClipboard() {
+  if (!rfb || !clipSync || !navigator.clipboard || !navigator.clipboard.readText) return;
+  try {
+    const text = await navigator.clipboard.readText();
+    if (text) {
+      rfb.clipboardPasteFrom(text);
+      lastRemoteClip = text;
+    }
+  } catch (e) { /* 使用者未授權讀取剪貼簿，維持原內容 */ }
+}
+
+async function pasteIntoDesktop(withShift) {
+  if (!rfb) return;
+  try {
+    if (navigator.clipboard && navigator.clipboard.readText) {
+      const text = await navigator.clipboard.readText();
+      if (text) {
+        rfb.clipboardPasteFrom(text);
+        lastRemoteClip = text;
+        await new Promise(resolve => setTimeout(resolve, 60));
+      }
+    }
+  } catch (e) { /* 讀不到本機剪貼簿就沿用桌面原本的內容 */ }
+  if (!rfb) return;
+  rfb.sendKey(0xffe3, "ControlLeft", true);
+  if (withShift) rfb.sendKey(0xffe1, "ShiftLeft", true);
+  rfb.sendKey(0x76, "KeyV", true);
+  rfb.sendKey(0x76, "KeyV", false);
+  if (withShift) rfb.sendKey(0xffe1, "ShiftLeft", false);
+  rfb.sendKey(0xffe3, "ControlLeft", false);
+}
 
 function setState(state, text) {
   dot.className = state;
@@ -1282,6 +1371,14 @@ async function connect() {
       connecting = false;
       setState('bad', '桌面驗證失敗：' + ((e.detail && e.detail.reason) || ''));
     });
+    client.addEventListener('clipboard', e => {
+      if (rfb !== client) return;
+      const text = String((e.detail && e.detail.text) || '');
+      if (!text) return;
+      lastRemoteClip = text;
+      pendingRemoteClip = text;
+      if (clipSync) writeLocalClipboard(text);
+    });
   } catch (err) {
     connecting = false;
     setState('bad', '無法載入桌面用戶端：' + err.message);
@@ -1289,6 +1386,44 @@ async function connect() {
   }
 }
 
+clipBtn.onclick = async e => {
+  e.stopPropagation();
+  clipSync = !clipSync;
+  localStorage.setItem('webtermClipboardSync', clipSync ? 'on' : 'off');
+  updateClipBtn();
+  if (clipSync) {
+    if (rfb) rfb.focus();
+    await pullLocalClipboard();
+    await flushPendingClipboard();
+  }
+};
+
+screenEl.addEventListener('keydown', e => {
+  if (!clipSync || !rfb) return;
+  const key = (e.key || '').toLowerCase();
+  if (key !== 'v' || e.altKey || !(e.ctrlKey || e.metaKey)) return;
+  e.preventDefault();
+  e.stopImmediatePropagation();
+  pasteIntoDesktop(e.shiftKey);
+}, true);
+
+document.addEventListener('paste', e => {
+  if (!clipSync || !rfb) return;
+  const target = e.target;
+  if (target && (target.tagName === 'INPUT' || target.tagName === 'TEXTAREA' || target.isContentEditable)) return;
+  const text = e.clipboardData && e.clipboardData.getData('text/plain');
+  if (!text) return;
+  e.preventDefault();
+  rfb.clipboardPasteFrom(text);
+});
+
+document.addEventListener('pointerdown', () => { flushPendingClipboard(); }, true);
+document.addEventListener('keydown', () => { flushPendingClipboard(); }, true);
+window.addEventListener('focus', () => { flushPendingClipboard(); });
+document.addEventListener('visibilitychange', () => {
+  if (!document.hidden) flushPendingClipboard();
+});
+
 retry.onclick = () => { delay = 800; connect(); };
 screenEl.addEventListener('click', () => { if (rfb) rfb.focus(); });
 window.addEventListener('beforeunload', () => {
@@ -1323,7 +1458,7 @@ class DesktopManager:
 
     def __init__(self):
         self._lock = asyncio.Lock()
-        self.pids = {"xvfb": None, "session": None, "vnc": None, "term": None}
+        self.pids = {"xvfb": None, "session": None, "vnc": None, "term": None, "clip": []}
         self.started_at = 0.0
         self.last_error = ""
         self._logf = None
@@ -1472,6 +1607,26 @@ class DesktopManager:
                 pids.append(pid)
         return pids
 
+    def _scan_clip(self):
+        """找 autocutsel：把 x11vnc 使用的 CUT_BUFFER0 與 CLIPBOARD/PRIMARY 雙向同步。"""
+        pids = []
+        try:
+            entries = os.listdir("/proc")
+        except OSError:
+            return pids
+        for entry in entries:
+            if not entry.isdigit():
+                continue
+            pid = int(entry)
+            if pid == os.getpid():
+                continue
+            cmd = self._cmdline(pid)
+            if not cmd or "autocutsel" not in cmd.lower():
+                continue
+            if DESKTOP_DISPLAY in cmd or self._has_display(pid):
+                pids.append(pid)
+        return pids
+
     def _term_binary(self):
         return shutil.which("xterm") or shutil.which("lxterminal")
 
@@ -1566,14 +1721,18 @@ class DesktopManager:
 
     def _stop_all(self):
         xvfb, vnc, session = self._scan()
-        pids = set(xvfb) | set(vnc) | set(session) | set(self._scan_terms())
-        pids |= {p for p in self.pids.values() if p}
+        pids = set(xvfb) | set(vnc) | set(session) | set(self._scan_terms()) | set(self._scan_clip())
+        for value in self.pids.values():
+            if isinstance(value, (list, tuple, set)):
+                pids |= set(value)
+            elif value:
+                pids.add(value)
         if pids:
             self._log(f"停止桌面程序：{sorted(pids)}")
             self._kill_pids(pids, signal.SIGTERM)
             time.sleep(0.5)
             self._kill_pids(pids, signal.SIGKILL)
-        self.pids = {"xvfb": None, "session": None, "vnc": None, "term": None}
+        self.pids = {"xvfb": None, "session": None, "vnc": None, "term": None, "clip": []}
 
     def _clean_display_files(self):
         num = DESKTOP_DISPLAY.lstrip(":") or "99"
@@ -1593,9 +1752,17 @@ class DesktopManager:
         required = ["xvfb", "session", "vnc"]
         if self._term_binary():
             required.append("term")
+        if shutil.which("autocutsel"):
+            required.append("clip")
+
+        def alive(value):
+            if isinstance(value, (list, tuple, set)):
+                return bool(value) and all(self._pid_alive(p) for p in value)
+            return self._pid_alive(value)
+
         return (
             _desktop_port_open()
-            and all(self._pid_alive(self.pids[k]) for k in required)
+            and all(alive(self.pids[k]) for k in required)
             and os.path.exists(self._display_socket())
         )
 
@@ -1694,6 +1861,7 @@ class DesktopManager:
         if name == "xterm":
             argv = [binary, "-u8", "-fa", "DejaVu Sans Mono", "-fs", "11",
                     "-geometry", "110x32+50+50",
+                    "-xrm", "XTerm*selectToClipboard: true",
                     "-T", self.TERM_TITLE, "-e", "bash", "--login"]
         else:
             argv = [binary, "--title=" + self.TERM_TITLE, "-e", "bash --login"]
@@ -1715,6 +1883,32 @@ class DesktopManager:
         self._log(self.last_error, logging.WARNING)
         return False
 
+    async def _start_clipboard(self) -> bool:
+        """啟動 autocutsel，讓 VNC 的 CUT_BUFFER0 與 X11 的 CLIPBOARD/PRIMARY 同步。"""
+        binary = shutil.which("autocutsel")
+        if not binary:
+            self.pids["clip"] = []
+            self._log("找不到 autocutsel，X11 剪貼簿同步停用", logging.WARNING)
+            return True
+        pids = []
+        for selection in ("CLIPBOARD", "PRIMARY"):
+            try:
+                proc = self._spawn(
+                    [binary, "-selection", selection, "-cutbuffer", "0"],
+                    env=self._env(),
+                )
+                pids.append(proc.pid)
+            except OSError as exc:
+                self._log(f"autocutsel {selection} 啟動失敗：{exc}", logging.WARNING)
+        await asyncio.sleep(0.5)
+        alive = [pid for pid in pids if self._pid_alive(pid)]
+        self.pids["clip"] = alive
+        if alive:
+            self._log("X11 剪貼簿同步就緒（CLIPBOARD + PRIMARY ↔ CUT_BUFFER0）")
+        else:
+            self._log("autocutsel 未能啟動，X11 剪貼簿同步停用", logging.WARNING)
+        return True
+
     async def _full_restart(self) -> bool:
         await asyncio.to_thread(self._stop_all)
         self._clean_display_files()
@@ -1724,6 +1918,7 @@ class DesktopManager:
             return False
         if not await self._start_vnc():
             return False
+        await self._start_clipboard()
         await self._start_term()
         await asyncio.to_thread(self._suppress_session_popups)
         self.started_at = time.time()
@@ -1807,6 +2002,17 @@ class DesktopManager:
             else:
                 self.pids["term"] = None
 
+            clips = await asyncio.to_thread(self._scan_clip)
+            if len(clips) > 2:
+                self._kill_pids(clips[2:], signal.SIGKILL)
+                clips = clips[:2]
+            if len(clips) == 2 and all(self._pid_alive(p) for p in clips):
+                self.pids["clip"] = clips
+            else:
+                if clips:
+                    self._kill_pids(clips, signal.SIGKILL)
+                await self._start_clipboard()
+
             if not self._healthy():
                 self.last_error = "桌面元件存在但健康檢查未通過"
                 return False

packages.txt

@@ -36,3 +36,4 @@ fonts-ipafont-gothic
 fonts-wqy-zenhei
 fonts-tlwg-loma-otf
 fonts-freefont-ttf
+autocutsel