npm - cicy-desktop - Versions diffs - 2.1.93 → 2.1.95 - Mend

cicy-desktop 2.1.93 → 2.1.95

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/package.json +6 -6
package/src/backends/homepage-preload.js +12 -0
package/src/backends/homepage-react/assets/index-C7gQsfPP.js +365 -0
package/src/backends/homepage-react/index.html +1 -1
package/src/backends/sidecar-ipc.js +60 -0
package/src/main.js +19 -1
package/src/sidecar/docker.js +33 -21
package/src/utils/context-menu-options.js +8 -6
package/workers/render/src/App.jsx +222 -1
package/src/backends/homepage-react/assets/index-5vDVCGqD.js +0 -365

package/src/backends/homepage-react/index.html CHANGED Viewed

@@ -6,7 +6,7 @@
   <link rel="icon" type="image/svg+xml" href="./favicon.svg" />
   <link rel="icon" type="image/png" sizes="256x256" href="./favicon-256.png" />
   <title>CiCy Desktop</title>
-  <script type="module" crossorigin src="./assets/index-5vDVCGqD.js"></script>
+  <script type="module" crossorigin src="./assets/index-C7gQsfPP.js"></script>
   <link rel="stylesheet" crossorigin href="./assets/index-CKpaMBKz.css">
 </head>
 <body>

package/src/backends/sidecar-ipc.js CHANGED Viewed

@@ -13,10 +13,21 @@
 // along with src/sidecar/installer.js and src/sidecar/wsl.js.)
 const { ipcMain } = require("electron");
+const path = require("path");
 const sidecar = require("../sidecar/cicy-code");
 const docker = require("../sidecar/docker");
 const PORT = Number(process.env.CICY_CODE_PORT || 8008);
+// Docker-版 cicy-code: a SECOND, optional instance that runs inside Docker on
+// :8009 (its own container + volume), alongside the native local daemon on
+// :8008. The homepage "Docker cicy-code" card owns its lifecycle; if Docker
+// Desktop is missing the card installs it first (installer downloads to the
+// user's Desktop).
+const APP_PORT = Number(process.env.CICY_DOCKER_APP_PORT || 8009);
+const APP_CONTAINER = process.env.CICY_DOCKER_APP_CONTAINER || "cicy-code-docker";
+const APP_VOLUME = process.env.CICY_DOCKER_APP_VOLUME || "cicy-ai-docker-data";
 let registered = false;
 function register({ sidecarLogPath } = {}) {
@@ -80,6 +91,55 @@ function register({ sidecarLogPath } = {}) {
     }
   });
+  // ---- Docker-版 cicy-code on :8009 (homepage "Docker cicy-code" card) ----
+  // Status: is Docker Desktop installed, and is the :8009 container healthy?
+  // platform tells the card to render only on Windows.
+  ipcMain.handle("docker:app-status", async () => {
+    try {
+      const installed = await docker.dockerOk();
+      const running = await docker.probeHealth(APP_PORT);
+      return { installed, running, port: APP_PORT, platform: process.platform };
+    } catch (e) {
+      return { installed: false, running: false, port: APP_PORT, platform: process.platform, error: e.message };
+    }
+  });
+  // One-click bootstrap of the Docker-版 instance: install Docker Desktop if
+  // missing (installer → user's Desktop), load the image, start the :8009
+  // container (its own name/volume), wait for health. Streams phase/progress on
+  // 'docker:app-progress' so the card's modal mirrors the cicy-code 升级 modal.
+  ipcMain.handle("docker:app-bootstrap", async (e) => {
+    if (process.platform !== "win32") return { ok: false, error: "Docker cicy-code is Windows-only" };
+    try {
+      const installDest = path.join(docker.desktopDir(), "Docker Desktop Installer.exe");
+      const result = await docker.bootstrap({
+        port: APP_PORT, container: APP_CONTAINER, volume: APP_VOLUME, installDest,
+        onProgress: (ev) => { try { e.sender.send("docker:app-progress", ev); } catch {} },
+      });
+      // Healthy → register :8009 as a (custom) team so the card's "打开" reuses
+      // the token-injected open/reload flow. addTeam dedups by host:port.
+      if (result && result.ok) {
+        try {
+          const lt = require("./local-teams");
+          const tok = await docker.readContainerToken(APP_PORT);
+          await lt.addTeam({
+            base_url: `http://127.0.0.1:${APP_PORT}`, name: "Docker cicy-code",
+            ...(tok ? { api_token: tok } : {}),
+          });
+        } catch { /* best-effort — the container itself is up */ }
+      }
+      return result;
+    } catch (err) {
+      return { ok: false, error: err.message };
+    }
+  });
+  // Stop + remove the :8009 Docker container (card's "停止").
+  ipcMain.handle("docker:app-stop", async () => {
+    try { await docker.stop({ container: APP_CONTAINER }); return { ok: true }; }
+    catch (e) { return { ok: false, error: e.message }; }
+  });
   // Start (or reuse) the cicy-code daemon. probeExisting inside start() reuses
   // a healthy :8008; otherwise it spawns `npx cicy-code` / the Docker container.
   ipcMain.handle("sidecar:start", async () => {

package/src/main.js CHANGED Viewed

@@ -20,7 +20,25 @@ const appUpdater = require("./app-updater");
 // and guests fell back to the OS-native menu; this unifies them and adds 重新加载
 // + 切换开发者工具 + 检查元素 everywhere (see utils/context-menu-options.js).
 const { attachContextMenu } = require("./utils/context-menu-options");
-electronApp.on("web-contents-created", (_e, wc) => attachContextMenu(wc));
+electronApp.on("web-contents-created", (_e, wc) => {
+  attachContextMenu(wc);
+  // Ctrl/Cmd+C inside a <webview> guest: on Windows the application menu's
+  // role:"copy" accelerator doesn't reach the focused guest, so a selection
+  // couldn't be copied with the keyboard (right-click 复制 is fixed separately via
+  // attachContextMenu). Wire copy directly on the guest. COPY-ONLY and WITHOUT
+  // preventDefault, so the gotty terminal's Ctrl+C=SIGINT and any web app's own
+  // copy handler still fire; wc.copy() is a no-op when there's no selection.
+  try {
+    if (wc.getType && wc.getType() === "webview") {
+      wc.on("before-input-event", (_ev, input) => {
+        if (input.type === "keyDown" && (input.control || input.meta) &&
+            !input.alt && !input.shift && (input.key === "c" || input.key === "C")) {
+          try { wc.copy(); } catch (_) {}
+        }
+      });
+    }
+  } catch (_) {}
+});
 // Setup Electron flags IMMEDIATELY after require
 electronApp.commandLine.appendSwitch("ignore-certificate-errors");

package/src/sidecar/docker.js CHANGED Viewed

@@ -252,16 +252,25 @@ async function checkStatus() {
   return { installed, imagePresent: installed ? await imagePresent() : false };
 }
+// Resolve the user's Desktop folder (主人指令: docker-desktop.exe 下到 Desktop).
+// %USERPROFILE%\Desktop is the canonical location; OneDrive redirection is rare
+// on the target machines and the file is only a transient installer anyway.
+function desktopDir() {
+  return path.join(process.env["USERPROFILE"] || os.homedir(), "Desktop");
+}
 // Start the container. Returns a sidecar child token { docker:true, container,
 // id } or null when Docker isn't ready (homepage guides the user to install
-// Docker Desktop).
-async function start({ port = 8008 } = {}) {
+// Docker Desktop). `container`/`volume` are parameterized so a SECOND instance
+// (the Docker-版 cicy-code on :8009) can run alongside the native local one
+// without a name/volume collision.
+async function start({ port = 8008, container = CONTAINER, volume = VOLUME } = {}) {
   // Something already serves a healthy cicy-code on :port (a legacy-named
   // container auto-revived by `--restart unless-stopped`, a manual run…).
   // Adopt it — `docker run` would just lose the port-bind fight.
   if (await probeHealth(port)) {
     console.log(`[docker-sidecar] :${port} already healthy — adopting existing instance`);
-    return { docker: true, container: CONTAINER, adopted: true };
+    return { docker: true, container, adopted: true };
   }
   if (!(await dockerOk())) {
     console.warn("[docker-sidecar] Docker not available — homepage will guide install");
@@ -272,12 +281,12 @@ async function start({ port = 8008 } = {}) {
     catch (e) { console.warn(`[docker-sidecar] image load failed: ${e.message}`); return null; }
   }
   // Replace any stale container of the same name.
-  try { await run(["rm", "-f", CONTAINER]); } catch {}
+  try { await run(["rm", "-f", container]); } catch {}
   const args = [
-    "run", "-d", "--name", CONTAINER, "--restart", "unless-stopped",
+    "run", "-d", "--name", container, "--restart", "unless-stopped",
     "-p", `${port}:8008`,
-    "-v", `${VOLUME}:/home/cicy/cicy-ai`,
+    "-v", `${volume}:/home/cicy/cicy-ai`,
   ];
   for (const k of PASS_ENV) {
     if (process.env[k]) args.push("-e", `${k}=${process.env[k]}`);
@@ -286,28 +295,31 @@ async function start({ port = 8008 } = {}) {
   const { stdout } = await run(args, { timeout: 60000 });
   const id = stdout.trim().slice(0, 12);
-  console.log(`[docker-sidecar] started container ${CONTAINER} (${id}) on :${port}`);
-  return { docker: true, container: CONTAINER, id };
+  console.log(`[docker-sidecar] started container ${container} (${id}) on :${port}`);
+  return { docker: true, container, id };
 }
-async function stop() {
-  try { await run(["rm", "-f", CONTAINER]); } catch {}
+async function stop({ container = CONTAINER } = {}) {
+  try { await run(["rm", "-f", container]); } catch {}
 }
 // Download + run the Docker Desktop installer (Windows). The installer needs
 // admin → Windows shows a UAC prompt the user accepts; first run may want a
 // reboot. We download (skip/resume aware) then launch silent and return.
-async function installDocker({ emit } = {}) {
+// `dest` defaults to tmp (the legacy local-team path); the Docker-版 card passes
+// the Desktop folder so the user can see/keep the installer (主人指令).
+async function installDocker({ emit, dest } = {}) {
   const e = emit || (() => {});
-  const dest = path.join(os.tmpdir(), "DockerDesktopInstaller.exe");
+  const target = dest || path.join(os.tmpdir(), "DockerDesktopInstaller.exe");
+  try { fs.mkdirSync(path.dirname(target), { recursive: true }); } catch {}
   e({ phase: "install-docker", status: "running", message: "下载 Docker Desktop 安装包…", progress: 0 });
-  await ensureDownloaded(DOCKER_DESKTOP_URL, dest, DOCKER_DESKTOP_MIRROR, {
+  await ensureDownloaded(DOCKER_DESKTOP_URL, target, DOCKER_DESKTOP_MIRROR, {
     emit, phase: "install-docker", label: "下载 Docker Desktop",
   });
   e({ phase: "install-docker", status: "running", message: "安装 Docker Desktop（请在弹出的授权框点「是」，装完可能需重启）…" });
   await new Promise((resolve) => {
     try {
-      const child = spawn(dest, ["install", "--quiet", "--accept-license"], {
+      const child = spawn(target, ["install", "--quiet", "--accept-license"], {
         windowsHide: false, detached: true, stdio: "ignore",
       });
       child.on("error", () => resolve());
@@ -321,7 +333,7 @@ async function installDocker({ emit } = {}) {
 // start the container → wait for :8008. Every step CHECKS first and SKIPS if
 // already done, emits coarse phase events + byte progress, and the downloads
 // resume. Safe to call again after a failure — it picks up where it left off.
-async function bootstrap({ onProgress, port = 8008 } = {}) {
+async function bootstrap({ onProgress, port = 8008, container = CONTAINER, volume = VOLUME, installDest } = {}) {
   const emit = (ev) => { try { onProgress && onProgress(ev); } catch {} };
   // 1) Docker present?
@@ -339,7 +351,7 @@ async function bootstrap({ onProgress, port = 8008 } = {}) {
     }
     emit({ phase: "install-docker", status: "done", message: "Docker 就绪" });
   } else {
-    await installDocker({ emit });
+    await installDocker({ emit, dest: installDest });
     emit({ phase: "install-docker", status: "running", message: "等待 Docker 启动（如需授权/重启，完成后会自动继续）…" });
     const up = await waitUntil(dockerOk, { totalMs: 900000, everyMs: 6000 });
     if (!up) {
@@ -369,7 +381,7 @@ async function bootstrap({ onProgress, port = 8008 } = {}) {
   } else {
     emit({ phase: "container", status: "running", message: "启动 cicy-code 容器…" });
     let child = null;
-    try { child = await start({ port }); }
+    try { child = await start({ port, container, volume }); }
     catch (e) { emit({ phase: "container", status: "error", message: `容器启动失败：${e.message}` }); return { ok: false, reason: "container_start_failed" }; }
     if (!child) {
       emit({ phase: "container", status: "error", message: "容器启动失败" });
@@ -378,15 +390,15 @@ async function bootstrap({ onProgress, port = 8008 } = {}) {
   }
   // 4) Health
-  emit({ phase: "health", status: "running", message: "等待本地团队就绪…" });
+  emit({ phase: "health", status: "running", message: "等待容器就绪…" });
   const healthy = await waitUntil(() => probeHealth(port), { totalMs: 120000, everyMs: 3000 });
-  emit({ phase: "done", status: healthy ? "done" : "error", message: healthy ? "本地团队已就绪 🎉" : "容器起来了但 :8008 还没响应,稍等或点重试" });
-  return { ok: healthy, container: CONTAINER };
+  emit({ phase: "done", status: healthy ? "done" : "error", message: healthy ? "Docker cicy-code 已就绪 🎉" : `容器起来了但 :${port} 还没响应,稍等或点重试` });
+  return { ok: healthy, container };
 }
 module.exports = {
   start, stop, checkStatus, loadImage, imagePresent, dockerOk, installDocker,
-  bootstrap, probeHealth, readContainerToken,
+  bootstrap, probeHealth, readContainerToken, dockerDesktopExe, desktopDir,
   // platform-agnostic download/retry primitives, reused by native.js
   ensureDownloaded, withRetry, waitUntil, run,
 };

package/src/utils/context-menu-options.js CHANGED Viewed

@@ -58,17 +58,19 @@ const OPTIONS = {
   },
 };
-// Attach the menu to the host window + BrowserView tabs only. <webview> guests
-// are EXCLUDED on purpose: they carry their OWN custom context menu (e.g.
-// cicy-code's WebFrame / the gotty terminal), and an ecm native menu would cover
-// it. Idempotent via __cicyCtxMenu so the web-contents-created hook + the
-// tab-browser's per-tab call never double-pop.
+// Attach the menu to the host window, BrowserView tabs AND <webview> guests, so
+// right-click → 复制/粘贴 works on EVERY surface. Webviews used to be excluded on
+// the assumption they carry their own copy menu, but on Windows that left
+// selections uncopyable: the app menu's Ctrl+C / role:"copy" doesn't reach the
+// focused <webview> guest, and no own-menu filled the gap. Giving guests the ecm
+// 复制/粘贴 menu fixes copy cross-platform. Idempotent via __cicyCtxMenu so the
+// web-contents-created hook + the tab-browser's per-tab call never double-pop.
 function attachContextMenu(wc) {
   try {
     if (!wc || (wc.isDestroyed && wc.isDestroyed())) return;
     if (wc.__cicyCtxMenu) return;
     const t = wc.getType && wc.getType();
-    if (t !== "window" && t !== "browserView") return; // skip <webview> + others
+    if (t !== "window" && t !== "browserView" && t !== "webview") return; // host + tabs + <webview>
     wc.__cicyCtxMenu = true;
     contextMenu({ ...OPTIONS, window: wc });
   } catch (e) {}

package/workers/render/src/App.jsx CHANGED Viewed

@@ -625,11 +625,16 @@ export default function App() {
   // Logged in: unified tabs + cards grid on the left, full-height webview
   // drawer on the right.
+  // The Docker-版 cicy-code on :8009 has its own dedicated <DockerCard> (right of
+  // the local card), so pull it out of the generic node list — else it'd ALSO
+  // render as a 自定义 card (the bootstrap registers it as a team for the
+  // token-injected 打开/刷新 flow).
+  const dockerTeam = (localTeams || []).find((t) => isDockerApp(t.base_url)) || null;
   // Split the cicyDesktopNodes list into 本地 (the localhost:8008 sidecar the
   // desktop owns — full lifecycle) vs 自定义 (deeplink-added nodes, usually
   // remote — probe-only, no restart/stop/update, just 打开).
   const localList  = (localTeams || []).filter((t) => isLocalSidecar(t.base_url));
-  const customList = (localTeams || []).filter((t) => !isLocalSidecar(t.base_url));
+  const customList = (localTeams || []).filter((t) => !isLocalSidecar(t.base_url) && !isDockerApp(t.base_url));
   const localCount = localList.length;
   const customCount = customList.length;
   // /api/teams returns ALL of this owner's teams — including kind=local ones
@@ -721,6 +726,13 @@ export default function App() {
               </button>
             </div>
           )}
+          {showLocal && (
+            <DockerCard
+              dockerTeam={dockerTeam}
+              onOpen={(id) => { if (id) openLocalTeam(id); else window.cicy?.tabs?.open?.("http://127.0.0.1:8009", "Docker cicy-code"); }}
+              onRefresh={fetchLocalTeams}
+            />
+          )}
           {showCustom && customList.map((t) => (
             <LocalTeamCard key={"custom:" + t.id} team={t} onOpen={() => openLocalTeam(t.id)} onRename={renameLocalTeam} onRefresh={fetchLocalTeams} />
           ))}
@@ -748,6 +760,7 @@ export default function App() {
       </div>{/* /.shell__left */}
       <ToastHost />
       <UpdateDrawerHost />
+      <DockerInstallDrawerHost />
     </div>
   );
 }
@@ -1412,6 +1425,204 @@ function DockerSetup({ onReady }) {
   );
 }
+// ── Docker install drawer: streams the Docker-版 cicy-code setup (装 Docker→
+// 加载镜像→启动容器→就绪), mirroring the cicy-code 升级 drawer. The bootstrap
+// emits {phase,status,message,progress} on 'docker:app-progress'; the card tees
+// those here via dockerDrawer.push. Single global instance at shell root.
+const dockerDrawerListeners = new Set();
+let dockerDrawerLogSeq = 0;
+let dockerDrawerState = null; // null = closed
+function emitDockerDrawer() { dockerDrawerListeners.forEach((l) => l(dockerDrawerState)); }
+const dockerDrawer = {
+  open({ onRetry } = {}) {
+    dockerDrawerState = { status: "running", phase: "install-docker", logs: [], onRetry: onRetry || null, lastAt: Date.now() };
+    emitDockerDrawer();
+  },
+  push(ev = {}) {
+    if (!dockerDrawerState) return;
+    const phase = ev.phase === "health" ? "container" : (ev.phase || dockerDrawerState.phase);
+    const line = { id: ++dockerDrawerLogSeq, t: clockHHMMSS(), phase, status: ev.status || "running", message: ev.message || "", progress: ev.progress };
+    dockerDrawerState = { ...dockerDrawerState, phase, logs: [...dockerDrawerState.logs, line], lastAt: Date.now() };
+    emitDockerDrawer();
+  },
+  finish({ ok, message } = {}) {
+    if (!dockerDrawerState) return;
+    const status = ok ? "done" : "error";
+    const line = { id: ++dockerDrawerLogSeq, t: clockHHMMSS(), phase: "done", status, message: message || (ok ? "完成" : "失败") };
+    dockerDrawerState = { ...dockerDrawerState, status, phase: "done", logs: [...dockerDrawerState.logs, line], lastAt: Date.now() };
+    emitDockerDrawer();
+  },
+  close() { dockerDrawerState = null; emitDockerDrawer(); },
+};
+const DOCKER_PHASES = [["install-docker", "装 Docker"], ["image", "加载镜像"], ["container", "启动容器"], ["done", "完成"]];
+const DOCKER_BADGE = { "install-docker": "Docker", image: "镜像", container: "容器", health: "容器", done: "完成" };
+function DockerInstallDrawerHost() {
+  const [st, setSt] = useState(dockerDrawerState);
+  useEffect(() => { dockerDrawerListeners.add(setSt); return () => { dockerDrawerListeners.delete(setSt); }; }, []);
+  const logRef = useRef(null);
+  useEffect(() => { const el = logRef.current; if (el) el.scrollTop = el.scrollHeight; }, [st?.logs?.length]);
+  if (!st) return null;
+  const running = st.status === "running";
+  const phaseIdx = DOCKER_PHASES.findIndex(([k]) => k === st.phase);
+  return (
+    <div className="drawer-scrim" data-id="DockerDrawer-scrim" onClick={() => { if (!running) dockerDrawer.close(); }}>
+      <div className="drawer" data-id="DockerDrawer" data-status={st.status} onClick={(e) => e.stopPropagation()}>
+        <div className="drawer__head">
+          <div className="drawer__title">
+            <span className={`drawer__spark drawer__spark--${st.status}`}>
+              {running ? <Spinner /> : st.status === "done" ? "✓" : "!"}
+            </span>
+            <div>
+              <div className="drawer__h">{tr("docker.setupTitle", "安装 Docker cicy-code")}</div>
+              <div className="drawer__sub">127.0.0.1:8009</div>
+            </div>
+          </div>
+          <button type="button" className="drawer__x" data-id="DockerDrawer-close" disabled={running} title={running ? tr("docker.busy", "进行中") : tr("common.close", "关闭")} onClick={() => dockerDrawer.close()} aria-label="close">×</button>
+        </div>
+        <div className="drawer__steps" data-id="DockerDrawer-steps">
+          {DOCKER_PHASES.map(([k, label], i) => {
+            const done = st.status === "done" || (phaseIdx >= 0 && i < phaseIdx);
+            const active = i === phaseIdx && running;
+            const err = st.status === "error" && i === phaseIdx;
+            return (
+              <div key={k} className={`drawer__step${active ? " is-active" : ""}${done ? " is-done" : ""}${err ? " is-error" : ""}`}>
+                <span className="drawer__step-dot">{done ? "✓" : err ? "!" : i + 1}</span>
+                <span className="drawer__step-label">{label}</span>
+                {i < DOCKER_PHASES.length - 1 && <span className="drawer__step-bar" />}
+              </div>
+            );
+          })}
+        </div>
+        <div className="drawer__log" data-id="DockerDrawer-log" ref={logRef}>
+          {st.logs.length === 0
+            ? <div className="drawer__log-empty">{tr("docker.preparing", "准备中…")}</div>
+            : st.logs.map((l) => (
+              <div key={l.id} className="drawer__line" data-status={l.status}>
+                <span className="drawer__t">{l.t}</span>
+                <span className={`drawer__badge drawer__badge--${l.phase}`}>{DOCKER_BADGE[l.phase] || l.phase}</span>
+                <span className="drawer__linemsg">{l.message}{Number.isFinite(l.progress) ? ` ${l.progress}%` : ""}</span>
+              </div>
+            ))}
+        </div>
+        <div className="drawer__foot">
+          {running ? (
+            <>
+              <span className="drawer__foot-status">{tr("docker.installing2", "安装进行中…")}</span>
+              <button type="button" className="drawer__btn" data-id="DockerDrawer-background" onClick={() => dockerDrawer.close()}>{tr("docker.background", "在后台继续")}</button>
+            </>
+          ) : st.status === "error" ? (
+            <>
+              <span className="drawer__foot-status is-error">{tr("docker.failed", "安装失败")}</span>
+              {st.onRetry && <button type="button" className="drawer__btn is-accent" data-id="DockerDrawer-retry" onClick={() => st.onRetry()}>{tr("common.retry", "重试")}</button>}
+              <button type="button" className="drawer__btn" data-id="DockerDrawer-dismiss" onClick={() => dockerDrawer.close()}>{tr("common.close", "关闭")}</button>
+            </>
+          ) : (
+            <>
+              <span className="drawer__foot-status is-done">{tr("docker.ready", "已就绪")}</span>
+              <button type="button" className="drawer__btn is-accent" data-id="DockerDrawer-finish" onClick={() => dockerDrawer.close()}>{tr("common.done", "完成")}</button>
+            </>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+}
+// Docker-版 cicy-code card (Windows only): a SECOND cicy-code instance running
+// in Docker on :8009, alongside the native local daemon (:8008). If Docker
+// Desktop is missing, the install flow downloads its installer to the user's
+// Desktop and runs it (主人指令), streaming progress through the drawer above.
+function DockerCard({ dockerTeam, onOpen, onRefresh }) {
+  const [status, setStatus] = useState(null);
+  const [busy, setBusy] = useState(false);
+  const DOCKER_BLUE = "#2496ed";
+  const checkStatus = useCallback(async () => {
+    try { setStatus(await window.cicy?.docker?.appStatus?.()); }
+    catch (e) { console.warn("[DockerCard]", e); }
+  }, []);
+  useEffect(() => { checkStatus(); }, [checkStatus]);
+  const runBootstrap = useCallback(async () => {
+    setBusy(true);
+    dockerDrawer.open({ onRetry: runBootstrap });
+    const unsub = window.cicy?.docker?.onAppProgress?.((ev) => dockerDrawer.push(ev));
+    try {
+      const r = await window.cicy?.docker?.appBootstrap?.();
+      dockerDrawer.finish({ ok: !!r?.ok, message: r?.ok ? tr("docker.ready", "Docker cicy-code 已就绪") : (r?.error || tr("docker.failed", "安装失败")) });
+      if (r?.ok) onRefresh?.();
+    } catch (e) {
+      dockerDrawer.finish({ ok: false, message: e.message });
+    } finally {
+      try { unsub && unsub(); } catch {}
+      setBusy(false);
+      checkStatus();
+    }
+  }, [checkStatus, onRefresh]);
+  // Render only on Windows. window.cicy.platform is sync, so we can decide
+  // immediately without waiting on the async appStatus probe.
+  const platform = window.cicy?.platform || status?.platform;
+  if (platform !== "win32") return null;
+  const running = !!status?.running || dockerTeam?.status === "running";
+  const installed = !!status?.installed;
+  const tone = running ? "ok" : installed ? "warn" : "off";
+  const stateText = running
+    ? tr("docker.running", "运行中 · :8009")
+    : installed
+      ? tr("docker.notRunning", "未启动 · 点「启动」")
+      : tr("docker.notInstalled", "Docker Desktop 未安装");
+  const ctaLabel = busy
+    ? tr("docker.working", "处理中…")
+    : running
+      ? tr("localTeams.open", "打开")
+      : installed
+        ? tr("docker.start", "启动")
+        : tr("docker.install", "下载安装");
+  const onCta = () => {
+    if (busy) return;
+    if (running) { onOpen?.(dockerTeam?.id); return; }
+    runBootstrap();
+  };
+  return (
+    <div data-id="DockerCard" className={`bcard bcard--docker${running ? " bcard--online" : ""}`}>
+      <div className="bcard__accent" style={{ background: DOCKER_BLUE }} />
+      <div className="bcard__top">
+        <div className="bcard__pill" style={{ color: DOCKER_BLUE }}>
+          <span className="bcard__dot" data-tone={tone} />
+          <svg style={{ width: 18, height: 18 }} viewBox="0 0 24 24" fill="currentColor" aria-hidden>
+            <path d="M21.81 10.25c-.06-.05-.67-.51-1.95-.51-.34 0-.68.03-1.01.09-.25-1.69-1.64-2.51-1.7-2.55l-.34-.2-.22.32a4.5 4.5 0 0 0-.59 1.4c-.23.94-.09 1.83.39 2.59-.58.32-1.51.4-1.7.41H2.62a.61.61 0 0 0-.61.61 9.32 9.32 0 0 0 .57 3.35 4.9 4.9 0 0 0 1.95 2.53c.92.52 2.42.82 4.12.82.77 0 1.54-.07 2.3-.21a9.6 9.6 0 0 0 3-1.09 8.3 8.3 0 0 0 2.05-1.68c.98-1.11 1.56-2.35 1.99-3.45h.17c1.36 0 2.2-.55 2.66-1l.13-.16zM4.7 11.33h1.78a.16.16 0 0 0 .16-.16V9.58a.16.16 0 0 0-.16-.16H4.7a.16.16 0 0 0-.16.16v1.59c0 .09.07.16.16.16m2.46 0h1.78a.16.16 0 0 0 .16-.16V9.58a.16.16 0 0 0-.16-.16H7.16a.16.16 0 0 0-.16.16v1.59c0 .09.07.16.16.16m2.5 0h1.78a.16.16 0 0 0 .16-.16V9.58a.16.16 0 0 0-.16-.16H9.66a.16.16 0 0 0-.16.16v1.59c0 .09.07.16.16.16m2.47 0h1.78a.16.16 0 0 0 .16-.16V9.58a.16.16 0 0 0-.16-.16h-1.78a.16.16 0 0 0-.16.16v1.59c0 .09.07.16.16.16M7.16 9.06h1.78a.16.16 0 0 0 .16-.16V7.31a.16.16 0 0 0-.16-.16H7.16a.16.16 0 0 0-.16.16v1.59c0 .09.07.16.16.16m2.5 0h1.78a.16.16 0 0 0 .16-.16V7.31a.16.16 0 0 0-.16-.16H9.66a.16.16 0 0 0-.16.16v1.59c0 .09.07.16.16.16m2.47 0h1.78a.16.16 0 0 0 .16-.16V7.31a.16.16 0 0 0-.16-.16h-1.78a.16.16 0 0 0-.16.16v1.59c0 .09.07.16.16.16" />
+          </svg>
+        </div>
+      </div>
+      <div className="bcard__body">
+        <h3 className="bcard__name">{tr("docker.title", "Docker cicy-code")}</h3>
+        <div className="bcard__host">http://127.0.0.1:8009</div>
+        <div className="bcard__meta" style={{ fontSize: 12, color: "#8b949e" }}>{stateText}</div>
+      </div>
+      <button
+        type="button"
+        className="bcard__cta"
+        data-id="DockerCard-cta"
+        disabled={busy}
+        onClick={onCta}
+        style={!running ? { background: DOCKER_BLUE, color: "white" } : undefined}
+      >
+        {busy ? <Spinner /> : <ArrowIcon />}
+        <span>{ctaLabel}</span>
+      </button>
+    </div>
+  );
+}
 function LocalTeamCard({ team, onOpen, onRename, onRefresh }) {
   const statusInfo = LOCAL_STATUS[team.status] || LOCAL_STATUS.error;
   const tone = statusInfo.tone;
@@ -1809,6 +2020,16 @@ function isLocalSidecar(baseUrl) {
   } catch { return false; }
 }
+// The Docker-版 cicy-code instance — localhost:8009. Owned by <DockerCard>, so
+// it's filtered out of the generic node lists.
+function isDockerApp(baseUrl) {
+  try {
+    const p = new URL(baseUrl);
+    const local = p.hostname === "127.0.0.1" || p.hostname === "localhost" || p.hostname === "::1";
+    return local && p.port === "8009";
+  } catch { return false; }
+}
 // Compare dotted versions: >0 if a newer than b, <0 older, 0 equal.
 function cmpVer(a, b) {
   const pa = String(a).split("."), pb = String(b).split(".");