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)。

internal/plugins/webui/starmap_perf_test.go

@@ -81,6 +81,17 @@ func TestStarmapNoPerFrameFullScan(t *testing.T) {
 			"固定 50 轮在大图上绝大多数轮次是在重复收敛后的状态")
 	}
 
+	// ★★ 布局代码必须**与 GUI 同源**（2026-10-13）。
+	//
+	// 为何单独钉这一条：这份布局曾在 dashboard.js 与 cmd/gui/renderer/app.js
+	// 各存一份手抄。两次真实事故都出自这个分叉：
+	//   ① WebUI 换上网格法后 GUI 那份没跟着改（换客户端卡顿原样存在）
+	//   ② 反向抄时抄了 WebUI 独有的 starmapMorphSet，GUI 用 state.starmapGrown
+	//      ⇒ 渲染循环每帧 ReferenceError、星图 0 帧
+	// 现在唯一事实源在 shared/starmap/layout.js，由 tools/starmap-sync.mjs
+	// 写进两处标记块。这里校验「本文件里的块 == 共享源」，手改会被立刻拦下。
+	checkStarmapSharedBlock(t, src)
+
 	// Worker 脚本必须存在且用同一套网格算法
 	wb, err := os.ReadFile(filepath.Join("static", "starmap-layout-worker.js"))
 	if err != nil {
@@ -127,3 +138,38 @@ func readDashboardJS(t *testing.T) string {
 	}
 	return string(b)
 }
+
+// checkStarmapSharedBlock 校验本文件里的共享块与 shared/starmap/layout.js 逐字节一致。
+//
+// 判据读宿主文件 + 共享源 + 生成器三者约定：标记块内容 = 生成器产出的那一整段。
+// 用一个薄封装调生成器（--check）比在 Go 里重算拼接规则更可靠 ——
+// 拼接规则只有一处（tools/starmap-sync.mjs），重复实现它正是「两份副本」的老毛病。
+func checkStarmapSharedBlock(t *testing.T, src string) {
+	t.Helper()
+	const begin = "// ===== BEGIN shared:starmap/layout ====="
+	const end = "// ===== END shared:starmap/layout ====="
+	b := strings.Index(src, begin)
+	e := strings.Index(src, end)
+	if b < 0 || e < 0 || e < b {
+		t.Fatalf("找不到共享块标记（%s / %s）—— 星图布局必须由 shared/starmap/layout.js 生成",
+			begin, end)
+	}
+	block := src[b : e+len(end)]
+	// 共享源必须被完整包进块里（抽首尾两段特征串判，避免把整份源码抄进断言）。
+	shared, err := os.ReadFile(filepath.Join("..", "..", "..", "shared", "starmap", "layout.js"))
+	if err != nil {
+		t.Fatalf("读共享源失败: %v", err)
+	}
+	sh := strings.TrimRight(strings.ReplaceAll(string(shared), "\r\n", "\n"), "\n")
+	// 共享源的正文（去掉首尾空行）必须逐字出现在块内。
+	body := strings.TrimSpace(sh)
+	if !strings.Contains(block, body) {
+		t.Error("本文件的星图布局块与 shared/starmap/layout.js 不一致（漂移）。\n" +
+			"     修法：node tools/starmap-sync.mjs\n" +
+			"     若是改算法，请只改 shared/starmap/layout.js，再跑同步 ——\n" +
+			"     直接改这个副本会让 WebUI 与 GUI 再次分叉（已因此出过两次事故）。")
+	}
+	if !strings.Contains(block, "generated") && !strings.Contains(block, "生成") {
+		t.Error("共享块内应带「本块由生成器产出」的提示，避免后人当普通代码手改")
+	}
+}