iframe ↔ 宿主消息协议（postMessage 层）

iframe goods 与父窗口通信的唯一消息层。RPC 语义见 bridge-ipc.md，注册协议见 goods-protocol.md。实测来源: core/shell-rpc.js bootRpcForwarder() + goods/* 源码。新增消息类型须在此登记。

上行（iframe → parent.postMessage）

type	字段	用途	接收端
`qqq-rpc`	`{qood, method, id, params}`	通用 RPC 调用 bridge 方法。method=`store.get/set/getLocal/setLocal` 特殊路由到全局/项目 SQLite；其余按 `.` 拆解直达 `window.qqqideBridge`；`params.__spread=true` 时 args 数组解包为多参数	shell-rpc.js
`qqq-key`	`{accel, scope}`	快捷键转发（key-hook 分发 Q/W/Space/1/2 等）	core/key-hook.js
`qqq-file-open`	`{path}`	打开文件到左编辑组（预览）	shell-rpc.js → CustomEvent → tab-manager
`qqq-file-open-right`	`{path, readOnly?, search?}`	打开到右编辑组	shell-rpc.js → qqqTabs.openFileInRightGroup
`qqq-editor-refresh`	`{path, content}`	实时刷新已打开编辑器内容（chat.txt 等）	shell-rpc.js → qqqEditor.refreshLiveContent
`qqq-command`	`{cmd, url?}`	通用命令，gaea-host 分发（含 workbench.view.explorer 等）	shell-rpc.js → CustomEvent → gaea-host.js
`qqq-sfx`	`{name}`	统一音频机器音效请求（父窗口 300ms 去重 + 语义映射）	shell-rpc.js → bridge.audio.play。语义表见 audio-api.md
`qqq-ai-attach`	`{path, isDir}`	文件喂给焦点 AI 面板（编辑框 📎 chip）	ai-panel/panel-send.js
`qqq-floor-indicator`	`{action: show\	hide, html, panel}`	跨面板豆腐块渲染（贴面板 sash 边缘 + 1/2/q/w 按键标记）	shell-rpc.js
`qqqide-theme-request`	—	请求父窗口推送当前主题	core/qqqide-theme.js