Muse 的运行外壳：Go 后端 + 系统 WebView + 类型安全 IPC（MyGo）。
Electron 版已移除，native/ 是唯一主进程实现。前端（../app/src）经
src/platform/mygoBridge.ts 桥接到 window.muse API，业务代码不感知外壳差异。
native/
├── main.go 窗口、原生菜单（含快捷键）、生命周期、外部「打开方式」
├── services/
│ ├── state.go 应用级共享状态 + 全部 Go→前端事件
│ ├── files.go 文件/对话框/最近文件/草稿/目录与文档监听
│ ├── ai.go OpenAI 兼容流式对话 + Brave 搜索
│ ├── export.go 图片 assets/、PDF（win.PrintToPDF）、HTML 导出
│ └── appsvc.go 脏标记/关窗确认/打开路径握手
├── embed/dist pnpm build:web 的产物，go:embed 内嵌进二进制（gitignore）
└── mygo.config.ts 供 mygo build 打包分发用（dmg/签名/公证/自动更新）
pnpm dev # 一键：并行起 vite dev server(:5173) + go run（推荐）
# 或分开跑：
pnpm dev:web # 终端 1：vite dev server :5173
pnpm dev:go # 终端 2：MYGO_DEV_URL=http://localhost:5173 go run -C native .前端改动走 vite HMR 即时生效；Go 改动重启 pnpm dev:go。
- Go 侧：
pnpm dev所在终端直接看日志（[muse] ...），改代码后重启dev:go即重编译 - 前端：
pnpm dev时用菜单「视图 > 开发者工具」（⌥⌘I）打开 Web Inspector， Console / Elements / Network 都在；跑已构建的二进制时加MUSE_DEVTOOLS=1：MUSE_DEVTOOLS=1 ./native/Muse - 菜单接线自动化：
MUSE_DEBUG_MENU=1启动，5 秒后程序化触发「文件 > 新建」并打印结果， 用来验证 NSMenuItem → Go 回调链路；也可以指定任意菜单项，例如MUSE_DEBUG_MENU=视图:开发者工具（这条会顺带打印IsDevToolsOpened） - 断言式调试：
pnpm test:e2e（见下），页面里的 DOM / IPC 断言跑一遍出清单
pnpm build # = build:go：构建前端产物并产出 native/Muse 单二进制（约 18MB，含前端）
pnpm build:web # 仅前端（native/embed/dist）
pnpm build:go # 同上，产出单二进制（CGO_ENABLED=0 + -ldflags="-s -w"）需要调试符号时直接 go build -o Muse .（约 23MB）。
mygo build（dmg/签名/公证/自动更新）尚未配置。
pnpm test:e2e # 构建后启动（MUSE_E2E=1），断言结果打在 stdout
node scripts/e2e-muse.mjs --no-build # 用现有二进制直接跑native/e2e.go 在 MUSE_E2E=1 时把用户数据（含「文档」目录）指向一次性临时目录，
页面加载完成后注入 native/e2e/assertions.js（当前 51 项断言：块手柄菜单 / 表格 /
源代码模式 / 数学块 / 聚焦模式等），以 0/1 退出。需要图形界面（会短暂弹出窗口），
不适合无头 CI。
- 中文 IME 在 WKWebView 的表现需实测（ProseMirror 在 WebKit 有已知 composition 差异）
- 拖拽打开文件：桥按文件名匹配原生 onFileDrop 的路径，两事件时序未验证
- 文件树排序：Go 按字节序（原 Electron 按 localeCompare(zh-CN) 拼音）
- 文件树 / 打开文件夹等对话框链路尚无自动化（e2e 目前不覆盖，需要可注入的选目录夹具）