Files
b6d90cac2b feat: 重写为原生 Swift 灵动岛,修掉通知跳转与主窗口数据链路 (#4)
删掉 Tauri 版(app/),全部重写为 SwiftUI + SwiftPM(HubKit/,8.2k 行源码 +
2k 行测试,131 个测试)。核心动机是旧版"点通知跳不到对应终端"——
根因是身份链路全程用会漂移的字符串:项目名 → tmux 窗口名 → pane_title →
AppleScript 子串匹配。实测 9 个 tmux 窗口只有 2 个能和 projects.yaml 对上,
其中一个窗口名是 `2.1.173`(tmux automatic-rename 把它改成了 claude 的版本号)。

主要变化
- 会话状态直接读 ~/.claude/sessions/<PID>.json(Claude Code 自己维护的权威源),
  不再用 spinner 字符猜 busy;死进程的残留 json 用 kill(pid,0) 过滤
- 跳转改用 iTerm jobPid + 进程祖先链求交,全程只有整数 PID 和 UUID;
  bg 会话不在任何终端里,单独用稳定 job 名兜底。实测 9/9 绑定成功
- hook 从 bash 换成 Swift 的 hubctl,走 Unix socket;Hook 没运行时立即放行
- 高风险操作在岛上审批,六重防误点;拒绝是超时和异常的默认值
- 主窗口:会话 / 项目 / 用量 / 审批日志 / 设置

修掉的真实缺陷(详见 HubKit/NOTES.md)
- 超时阶梯是反的:ApprovalCoordinator 和 hubctl 读超时都是 60s,同时到期时
  hubctl 按 fail-open 放行了一条已被服务端判定拒绝的 git push --force origin main。
  改成 60/65/75/90 严格递增,并区分「连不上」(放行)与「连上但没应答」(拒绝)
- 点击全部被吞:app 是 .accessory + panel 是 .nonactivatingPanel,
  NSHostingView.acceptsFirstMouse 默认 false,每次点击都算 first mouse 被丢弃
- hitTest 假设 NSHostingView 恒为 flipped,而 isFlipped 是 final 的可读写属性
- 形态切换靠替换 rootView,导致动画不可能发生且 @State 每次归零
- 全局 leftMouseDown 监听会收到点在自己身上的点击,展开态一点就收起
- hook 进程死后审批卡不消失,且会挡住后面的请求(按 clientPid 扫描清理)
- app 读的 projects.yaml 不是脚本维护的那份,且那份被写坏成
  `projects: []` + 117 条内容,解析器静默返回 0 —— 三个页面因此全空
- 用量对 945MB/341 个 jsonl 整份读进内存,跑不完;改流式 + 增量缓存后
  7 天首扫 3.6s、命中缓存 0.22s、全量 4s
- 辅助二进制放 Contents/MacOS/ 且共用 bundle id 会被 exec 瞬间 SIGKILL
- 同一 bundle id 对应多个 .app 让存活判断和 TCC 授权互相打架

刻意的取舍
- 放弃 Liquid Glass 做岛的基底:它会跟着背景亮度双向补偿,而刘海恒为纯黑,
  两者物理上互斥。改用固定 86% 暗色基底 + 背景模糊 + 边缘高光
- 用 SwiftPM + 打包脚本而不是 .xcodeproj:手写 xcodeproj 的 XML 无法 review,
  且 SwiftPM 保住了 swift test

Co-authored-by: wuguangan <anjaihd0206@gmail.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-29 19:20:12 +08:00

64 lines
3.0 KiB
Swift
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// swift-tools-version: 6.0
import PackageDescription
// 平台底线定在 macOS 26:灵动岛依赖 Liquid Glass(.glassEffect / GlassEffectContainer),
// 这是 macOS 26 才有的 API。本项目是给这台机器用的个人工具,不需要向下兼容。
let package = Package(
name: "HubKit",
platforms: [.macOS("26.0")],
products: [
.library(name: "HubCore", targets: ["HubCore"]),
.library(name: "HubProbe", targets: ["HubProbe"]),
.library(name: "HubJump", targets: ["HubJump"]),
.library(name: "HubIPC", targets: ["HubIPC"]),
.library(name: "HubProjects", targets: ["HubProjects"]),
.library(name: "HubUI", targets: ["HubUI"]),
.executable(name: "hubprobe", targets: ["HubProbeCLI"]),
.executable(name: "hubctl", targets: ["hubctl"]),
.executable(name: "ClaudeHub", targets: ["ClaudeHubApp"]),
],
targets: [
// 纯数据模型,无副作用,不依赖任何系统调用。
.target(name: "HubCore"),
// 会话探测:读 ~/.claude/sessions/*.json、进程树、tmux 拓扑。
.target(name: "HubProbe", dependencies: ["HubCore"]),
// 跳转引擎:从 sessionId 定位并前置到具体终端 tab。
.target(name: "HubJump", dependencies: ["HubCore", "HubProbe"]),
// hook ↔ app 的 Unix socket 协议、风险分级。
// 刻意不依赖 HubProbe:hubctl 要保持极小、启动极快(每次工具调用都跑一遍)。
.target(name: "HubIPC", dependencies: ["HubCore"]),
// projects.yaml、git 状态、token 用量、终端派发。
.target(name: "HubProjects", dependencies: ["HubCore", "HubProbe"]),
// 灵动岛与主窗口的 SwiftUI 层。
.target(
name: "HubUI",
dependencies: ["HubCore", "HubProbe", "HubJump", "HubIPC", "HubProjects"]
),
// 开发期 CLI:把探测和跳转的结果打出来,便于在没有 UI 时验证。
// 目录名不能叫 hubprobe —— macOS 文件系统大小写不敏感,会和 HubProbe 撞。
.executableTarget(
name: "HubProbeCLI",
dependencies: ["HubCore", "HubProbe", "HubJump", "HubProjects"]
),
// Claude Code hook 的执行体。每次工具调用都会跑,必须小而快。
.executableTarget(name: "hubctl", dependencies: ["HubIPC"]),
// app 本体。刻意做薄:只有 @main 和窗口装配,逻辑全在 HubKit 各库里。
.executableTarget(name: "ClaudeHubApp", dependencies: ["HubUI"]),
.testTarget(name: "HubCoreTests", dependencies: ["HubCore"]),
.testTarget(name: "HubProbeTests", dependencies: ["HubProbe"]),
.testTarget(name: "HubJumpTests", dependencies: ["HubJump"]),
.testTarget(name: "HubIPCTests", dependencies: ["HubIPC"]),
.testTarget(name: "HubProjectsTests", dependencies: ["HubProjects"]),
.testTarget(name: "HubUITests", dependencies: ["HubUI"]),
]
)