zterm-windows-dev

zterm Windows Electron 客户端与 WezTerm daemon 开发闭环，覆盖共享核心边界、packaged preload、真实 Windows CDP/source-to-DOM gate 和精确资源清理。

Zur Installation springen

Repository: Jasonzhangf/zterm
Letzte Quellaktivität: 14. Juli 2026 um 11:39
Erkannte Sprache von SKILL.md: Mehrsprachig
Sterne: 0
Forks: 0

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Zurück zur Suche Zurück zur Installation

name	zterm-windows-dev
description	zterm Windows Electron 客户端与 WezTerm daemon 开发闭环，覆盖共享核心边界、packaged preload、真实 Windows CDP/source-to-DOM gate 和精确资源清理。

zterm Windows Dev

必读

win/docs/architecture.md
win/docs/function-map.md
win/docs/windows-desktop-shell-manifest.json
win/docs/testing/windows-desktop-shell-test-design.md
win/MEMORY.md

边界

win/ 只拥有 Electron 窗口、preload、Windows 平台适配、桌面组合和打包。
复用 shared transport、sparse buffer、renderer；禁止复制 daemon、mirror、renderer、Mac IPC 或 local tmux。
daemon backend 变更仍由 daemon.windows_wezterm_backend owner 处理。

Packaged 门禁

Sandbox preload 源用 .cts，main 只加载生成的 preload.cjs。typecheck/build 不能证明 packaged preload 可加载。
connected 不等于 mirror ready。首个 buffer-sync revision 前禁止发 visible-range request，否则 daemon 会显式报 mirror not ready。
完成必须在真实 Windows packaged app 上自动证明：bridge 存在、连接无 error、输入唯一 marker、DOM rows 匹配命令和输出。
Smoke 使用固定专用 session 或唯一明确 sessionName；结束按 sessionName 清理。App/helper、CDP tunnel、SSH holder 只按明确 PID/session 关闭，禁止 broad kill。
Session discovery/create/close UI must call shared daemon control helpers. Do not fork control wire semantics in Windows UI; verify UI list and daemon final list agree after close.
Desktop pane/tab composition must use shared PaneStage, PaneTabs, and workspace-model operations. Keep one stable runtime per tab id; focus switches must not reconnect. Packaged proof records daemon attached/ready counts before and after focus switch, isolated markers in each pane, then closes one tab and proves the sibling still receives a new marker.
Windows file browser must keep provider IO in win/electron/windows-file-system.ts, UI projection in win/src/WindowsFileBrowserPanel.tsx, and preview/path policy in shared FileBrowserCore. Packaged proof opens a real Windows fixture, compares Markdown source-to-DOM, proves binary disabled, and confirms daemon session counts stay unchanged.
生成物 win/dist/、win/dist-electron/、win/out/、evidence 不进 git/MemPalace。

最小验证

pnpm --dir win run type-check
pnpm --dir win test -- --reporter dot
pnpm --dir win run build
pnpm --dir win run package

随后部署真实 Windows 包并跑 source-to-DOM marker gate；只完成本地命令不得宣称 packaged alpha 闭环。