本技能是 Muxy 扩展的样式与行为指导层,目标是让扩展与原生 Muxy 表面难以区分:匹配主题、匹配尺寸。API 与 manifest 机制需另读参考文档,入口为 https://muxy.app/llms.txt,在任意文档 URL 后加 /plain 可取原始 Markdown。
工程形态:Muxy 扩展是 npm + Vite 项目,源码在 src/,vite build 产出 dist/,Muxy 优先读取 dist/。manifest 是 package.json 中的 muxy 对象,路径可为构建输出内的任意相对路径。开发时通过 Extensions 弹窗的 Load Unpacked 指向任意文件夹。注意 build 脚本必须把 package.json 复制进 dist/,否则发布时校验/安装会失败,可用 "build": "vite build && node scripts/copy-manifest.mjs"。
界面选取:跨项目概览用 homeView;项目工作区内展示用 UI 页面(tab/panel/popover);替代左侧栏的常驻导航用 sidebar;需持久响应事件或协调多 webview 才用 background.js;一次性逻辑用 runScript;自定义 HTML 弹窗用 muxy.modal.openWebview,优先由 background.js 打开。不要用隐藏 tab 跑逻辑。
主题:一律用 var(--muxy-…) CSS 变量,禁止硬编码十六进制颜色;变量已自动适配明暗,不要嗅探配色方案;--muxy-accent 是唯一饱和色,需节制使用,其上文字用 --muxy-accent-foreground。JS/Canvas 绘色需在 muxy.onThemeChange 中重绘。
尺寸:按 Muxy 基础尺度取值(间距 2/4/6/8/10/12/16/20/24/32;字号 10/11/12/13/14/16;图标 12–14px 权重 600;圆角 4/6/8/10),并随界面缩放设置变化。顶栏高度须用 --muxy-topbar-height,不可硬编码,保持 box-sizing: content-box。
行为与 API:遵循最小权限,按需声明。远端 SSH 工作区下 exec、git、worktree 均作用于远端。用 muxy.git 而非 shell 调用 git;用 muxy.gh.user() 取当前 GitHub 用户;用 muxy.projects/workspaces 写动词管理项目与工作区(delete 不可逆且每次确认);用 muxy.files 做沙箱内文件操作;用 muxy.storage 持久化状态;用 muxy.dialog.prompt/pickFolder 取值或选目录。扩展最多并发 32 条命令。以上均为资料所述机制,价格、平台与效果等未提供。