perf(starmap): WebUI/GUI 星图卡顿修复 + 抽出共享「布局数学」单一源

## 症状与实测

WebUI 星图建图阻塞主线程 9339ms、draw calls 7514；GUI 建图 2466ms、
draw calls 3477。两者在空闲时仍在空转渲染。

## WebUI（internal/plugins/webui/dashboard.js）

- 力导向布局 O(n²) 两两互斥改**网格近邻**，并移入 **Web Worker**
  ⇒ 建图阻塞 **9339ms → 57ms**
- 每节点光晕 3753 个 draw call → 1 个 InstancedMesh
- 边 966 → 4 个 LineSegments
- 空闲帧跳过 + 星空时间驱动
- 结果：draw calls **7514 → 3760**，空闲阻塞 **99% → 3%**

## GUI（cmd/gui/renderer/app.js）

- draw calls **3477 → 1809**，建图 **2466ms → 943ms**
- 首屏可见性守卫（GUI 默认 chat 视图，星图不该在后台初始化）
- 空闲 12fps → 0.2fps

修 GUI 两个自引 bug：
  1. 抄 WebUI 的 `starmapMorphSet`（GUI 实际用 `state.starmapGrown`）⇒
     每帧 ReferenceError、星图 0 帧；
  2. `camKey` 读 `starmapCam.position` 无守卫（`switchChatPanel` 同步调
     `starmapAnimate` 时 cam 为 nil）。**同一缺陷 WebUI 也存在，两处均已补守卫。**

## 共享源（方案 A：只共享「布局数学」这一层）

新增 `shared/starmap/layout.js`（3 个纯函数，零 DOM/全局引用）+
生成器 `tools/starmap-sync.mjs` + 门禁 `make check-starmap-shared`（已进
make test）。三处（共享源 / dashboard.js / app.js）的标记块必须逐字节相同。

**为何只共享这一层**（实测依据）：web 星图 54 个函数、gui 24 个，两者同名
函数逐字节相同数为 **0**。GUI 有设备桥/computer use/托盘/自有面板，WebUI 有
侧栏页签体系 —— 共享受众完全不同的 UI 代码是错的，能安全共享的只有布局数学。

**为何用生成器而非运行时加载**：GUI 用 file:// （main.js 的 loadFile），可能
离线；让其拉服务端 dashboard.js 会把「星图能否初始化」绑到网络与登录态上。

**为何 GUI 不用 Web Worker**：file:// 下外链与 Blob Worker 实测都能跑，但不把
「星图能否初始化」押在打包环境的 Worker 行为上。

## 判据

- `cmd/gui/starmap-perf.test.mjs`（21 条，接入 npm test）
- 扩充 `internal/plugins/webui/starmap_perf_test.go`（同源判据 +
  checkStarmapSharedBlock）
- 变异 M1/M2/M3 全部报红

## 附带

cmd/gui/renderer/app.js 同时含上一提交的 GUI `system` 事件消费（协议修复），
因同文件交织未再拆分，见提交 fix(clients)。

Makefile

@@ -1,4 +1,4 @@
-.PHONY: test-gui all build build-plain build-cli build-gui clean install test run build-static build-linux-arm64 lint fmt sync-client-versions check-client-versions csrc csrc-test csrc-lint csrc-abi csrc-headers csrc-sanitize csrc-cross csrc-fuzz check-csrc check-csrc-full
+.PHONY: test-gui all build build-plain build-cli build-gui clean install test run build-static build-linux-arm64 lint fmt sync-client-versions check-client-versions check-starmap-shared check-client-protocol csrc csrc-test csrc-lint csrc-abi csrc-headers csrc-sanitize csrc-cross csrc-fuzz check-csrc check-csrc-full
 # HOMED_TAGS 默认带 onnxruntime：发行版**默认启用**本地向量空间（与
 # deploy/packaging/build.sh 保持一致）。
 #
@@ -368,6 +368,8 @@ test:
 	 $(MAKE) csrc-test || rc=$$?; \
 	 $(MAKE) check-csrc || rc=$$?; \
 	 $(MAKE) check-codec-cgo-only || rc=$$?; \
+	 $(MAKE) check-starmap-shared || rc=$$?; \
+	 $(MAKE) check-client-protocol || rc=$$?; \
 	 exit $$rc
 
 # check-codec-cgo-only：钉死「编解码层完全 C 化」这一决定。
@@ -415,6 +417,29 @@ sync-client-versions:
 check-client-versions:
 	@bash deploy/scripts/sync-client-versions.sh --check
 
+# check-starmap-shared：钉住 WebUI 与 GUI 的星图布局**同源**。
+#
+# 为何需要：两份客户端内联脚本里的布局代码曾是手抄副本，已经因此出过两次事故：
+#   ① WebUI 修好 O(n²)→网格法，GUI 那份没跟着改（换客户端卡顿原样存在）
+#   ② 抄空闲帧跳过时抄了 WebUI 独有的 starmapMorphSet，GUI 实际用
+#      state.starmapGrown ⇒ 渲染循环每帧 ReferenceError、星图 0 帧
+# 现在唯一事实源在 shared/starmap/，由 tools/starmap-sync.mjs 写进两处标记块。
+# 本目标校验「两处标记块 == 共享源」；手改任一副本会立刻红。
+sync-starmap:
+	@node tools/starmap-sync.mjs
+
+check-starmap-shared:
+	@node tools/starmap-sync.mjs --check
+
+# check-client-protocol：客户端↔核心的协议一致性门禁。
+#
+# 为何单列一个显式目标（虽然这些用例在 go test ./... 里也会跑）：
+# 它们是**跨客户端契约**判据，改协议时最该被单独、反复地跑。2026-10-13 的
+# 协议审计查出四处静默不一致（幽灵类型 agent_error、system 发了没人收、
+# CLI 缺 stage、设备桥静默丢弃 push），全部靠这类判据才能防复发。
+check-client-protocol:
+	@$(GO) test -count=1 -run 'TestSSESubTypesAreRealEventTypes|TestEveryPublishedEventHasAnOutwardPath|TestClientsRecognizeServerEventTypes|TestNoPhantomFrameTypes|TestStageFrameFieldsMatchServer|TestDeviceBridgeOpCoverage|TestSseWhitelistParsesToExpectedSet' ./internal/plugins/webui/
+
 # lint-full：在 vet 之外跑 golangci-lint（阈值见 .golangci.yml，起步 warn-only）。
 # 未安装时给出可执行的安装提示与跳过原因，而不是静默成功。
 .PHONY: lint-full