调试工作台（magic-debug）

调试工作台是一个多角色并发调试壳：需要在同一个站点上同时调试多个角色（平台 / 商户 / 买家等）且互不顶号时用——一个窗口并排 N 个隔离面板，每个角色各自持久登录态；Claude 经壳内 内嵌 MCP 用 role 参数并发驱动任意面板，并维护可续作的调试手账。

一壳 = 一项目（N 角色 = N 隔离面板）。运行时零依赖（不调用 magic-stack，仅复用 .magic-stack/debug/ 目录名），可单独安装分发。

它的驱动技能是 magic-debug。安装与命令用法（起壳三步、驱动面板、录制流程、录 bug）见 Skills / magic-debug；本页只讲这个 APP 的产品形态与架构。

架构（一句话）

调试壳是单个 Electron 进程：既是 GUI（多角色面板），又在主进程内起内嵌 MCP（HTTP）并用 webContents 原生 API 驱动面板。无外部浏览器、无 Playwright（Playwright 与 Electron CDP 模型不兼容）。

多角色隔离

• 一窗口并排 N 个面板，每个面板绑定一个 role（英文短名，项目内唯一，后续所有工具用它定位面板）。
• 每个角色各自持久登录态，互不顶号——买家、商户、平台管理员可同时在线来回核对。
• platform 字段控制面板外壳：web（默认，PC 宽屏）或 mobile（414px 窄宽手机外壳，调 H5）。

项目管理窗口（人工启动器）

人工可执行无参 magic-debug（或 magic-debug manager）打开「项目管理」窗口，列出 / 启停 / 增删 项目，挑项目启停——此入口仅供人工，不在 skill 路径里。全局注册表在 ~/.magic-stack/magic-debug.json。

与 magic-stack 的关系

magic-stack 是另一套工具（本机 Docker 调试，见 Skills / magic-stack）， 与调试工作台相互独立——调试工作台运行时用不到它，也不需要它那套 Docker daemon 配置。两者仅 复用 .magic-stack/debug/ 目录名，无运行时耦合。