dsh-notch 0.3.1

package/tools/recording/Client.swift

@@ -0,0 +1,76 @@
+import Foundation
+
+struct RuntimeFile: Decodable {
+  var origin: String
+  var token: String
+}
+
+struct NotchOption: Decodable, Identifiable {
+  var label: String
+  var description: String?
+  var id: String { label }
+}
+
+struct NotchQuestion: Decodable, Identifiable {
+  var id: String
+  var question: String
+  var detail: String?
+  var header: String?
+  var options: [NotchOption]?
+  var multiSelect: Bool?
+}
+
+struct NotchApproval: Decodable {
+  var id: String
+  var toolName: String
+  var reason: String?
+}
+
+struct NotchAsk: Decodable {
+  var id: String
+  var questions: [NotchQuestion]
+}
+
+struct NotchLastTurn: Decodable {
+  var at: Double
+  var kind: String
+  var failed: Bool
+}
+
+struct NotchRow: Decodable, Identifiable {
+  var id: String
+  var title: String
+  var child: Bool
+  var busy: Bool
+  var unread: Bool
+  var lastTurn: NotchLastTurn?
+  var approval: NotchApproval?
+  var ask: NotchAsk?
+
+  var needsAction: Bool { approval != nil || ask != nil }
+  /// A red lamp is a finished unsuccessful turn, never a session that is still running.
+  var isFailedResult: Bool { lastTurn?.failed == true && !busy && !needsAction }
+}
+
+struct NotchSnapshot: Decodable {
+  var ok: Bool
+  var generatedAt: Double
+  var origin: String
+  var rows: [NotchRow]
+}
+
+enum NotchClientError: Error {
+  case noRuntime
+  case http(Int)
+}
+
+// Preview-only transport: no credential reads, network, or live session actions.
+final class NotchClient: @unchecked Sendable {
+  func reloadRuntime() throws { throw NotchClientError.noRuntime }
+  func status() async throws -> NotchSnapshot { throw NotchClientError.noRuntime }
+  func approve(id: String, outcome: String) async throws {}
+  @MainActor func answer(id: String, answers: [[String: Any]]) async throws {}
+  func seen(sessionId: String) async throws {}
+  func seenAll() async throws {}
+  func focus(sessionId: String) async throws {}
+}

package/tools/recording/DemoCatalog.swift

@@ -0,0 +1,174 @@
+import AppKit
+import SwiftUI
+
+final class PreviewIdleCue: @unchecked Sendable {
+  static let notification=Notification.Name("NotchRecordingIdleCue")
+  let boardID:ObjectIdentifier
+  let action:String
+  init(board:BoardModel,action:String) {boardID=ObjectIdentifier(board);self.action=action}
+}
+
+enum DemoState {case running, decision, success, failure}
+struct DemoBeat {
+  let at:Double
+  var rows:[NotchRow]? = nil
+  var action:String? = nil
+}
+struct DemoScene: Identifiable {
+  let id:String
+  let title:String
+  var englishTitle:String {DemoCatalog.english[id] ?? id}
+  let initial:[NotchRow]
+  let beats:[DemoBeat]
+  var duration:Double=7.8
+}
+
+enum DemoCatalog {
+  static let english:[String:String] = [
+    "birth-blue":"Idle → Running",
+    "birth-yellow":"Idle → Decision",
+    "one-yellow":"Running → Decision",
+    "one-return":"Decision → Running",
+    "one-green":"Running → Done",
+    "one-red":"Running → Failed",
+    "two-yellow":"Two Tasks → Decision",
+    "two-return":"Decision → Two Tasks",
+    "two-green":"Two Tasks → One Done",
+    "two-red":"Two Tasks → One Failed",
+    "one-roundtrip":"One Task · Decision & Resume",
+    "two-roundtrip":"Two Tasks · Decision & Resume",
+    "green-idle":"Done → Idle",
+    "red-idle":"Failed → Idle",
+    "green-blue":"Read Result → Keep Running",
+    "red-blue":"Read Failure → Keep Running",
+    "clear-green":"Read Result → Keep Failure",
+    "clear-red":"Read Failure → Keep Result",
+    "add-work":"One Task → Many Tasks",
+    "all-green":"More Tasks Done",
+    "all-red":"More Tasks Failed",
+    "mixed-green":"Last Task → Done",
+    "mixed-red":"Last Task → Failed",
+    "clear-all":"All Read → Idle",
+    "idle-blink":"Blink",
+    "idle-scan":"Look Around",
+    "idle-tilt":"Head Tilt",
+    "idle-nod":"Nod",
+    "idle-stretch":"Stretch",
+    "idle-hop":"Hop",
+    "idle-balance":"Balance",
+    "idle-sneeze":"Sneeze",
+    "idle-sleep":"Doze",
+    "idle-dance":"Chameleon",
+    "idle-flow":"Motion → Motion",
+    "dance-flow":"Chameleon Transitions",
+  ]
+  static func rows(_ states:[DemoState])->[NotchRow] {
+    states.enumerated().map {index,state in
+      var row=NotchRow(id:"demo-task-\(index)",title:"本地任务",child:false,busy:state == .running || state == .decision,unread:state == .success || state == .failure)
+      if state == .decision {row.approval=NotchApproval(id:"demo-approval-\(index)",toolName:"本地演示")}
+      if state == .success || state == .failure {row.lastTurn=NotchLastTurn(at:1,kind:"demo",failed:state == .failure)}
+      return row
+    }
+  }
+  static func scene(_ id:String,_ title:String,_ from:[DemoState],_ to:[DemoState],at:Double=2.3)->DemoScene {
+    DemoScene(id:id,title:title,initial:rows(from),beats:[DemoBeat(at:at,rows:rows(to))])
+  }
+  static func clear(_ id:String,_ title:String,_ from:[DemoState],index:Int)->DemoScene {
+    let source=rows(from)
+    return DemoScene(id:id,title:title,initial:source,beats:[DemoBeat(at:2.3,rows:source.filter {$0.id != "demo-task-\(index)"})])
+  }
+  static func idle(_ action:String,_ title:String)->DemoScene {
+    DemoScene(id:"idle-\(action)",title:title,initial:[],beats:[DemoBeat(at:0.65,action:action)],duration:action == "sleep" ? 10.5:9)
+  }
+  static let groups:[[DemoScene]] = [
+    [scene("birth-blue","待机 → 运行",[],[.running]),
+     scene("birth-yellow","待机 → 决策",[],[.decision]),
+     scene("one-yellow","运行 → 决策",[.running],[.decision]),
+     scene("one-return","决策 → 运行",[.decision],[.running]),
+     scene("one-green","运行 → 完成",[.running],[.success]),
+     scene("one-red","运行 → 失败",[.running],[.failure])],
+    [scene("two-yellow","两个任务 → 决策",[.running,.running],[.decision,.running]),
+     scene("two-return","决策 → 两个任务",[.decision,.running],[.running,.running]),
+     scene("two-green","两个任务 → 完成",[.running,.running],[.success,.running]),
+     scene("two-red","两个任务 → 失败",[.running,.running],[.failure,.running]),
+     DemoScene(id:"one-roundtrip",title:"一个任务 · 决策往返",initial:rows([.running]),beats:[DemoBeat(at:1.6,rows:rows([.decision])),DemoBeat(at:4.5,rows:rows([.running]))]),
+     DemoScene(id:"two-roundtrip",title:"两个任务 · 决策往返",initial:rows([.running,.running]),beats:[DemoBeat(at:1.6,rows:rows([.decision,.running])),DemoBeat(at:4.5,rows:rows([.running,.running]))])],
+    [clear("green-idle","完成 → 待机",[.success],index:0),
+     clear("red-idle","失败 → 待机",[.failure],index:0),
+     clear("green-blue","已读完成 → 继续运行",[.success,.running],index:0),
+     clear("red-blue","已读失败 → 继续运行",[.failure,.running],index:0),
+     clear("clear-green","已读完成 → 保留失败",[.success,.failure],index:0),
+     clear("clear-red","已读失败 → 保留完成",[.success,.failure],index:1)],
+    [scene("add-work","一个任务 → 多个任务",[.running],[.running,.running,.running]),
+     scene("all-green","继续完成 → 完成累积",[.success,.running],[.success,.success]),
+     scene("all-red","继续失败 → 失败累积",[.failure,.running],[.failure,.failure]),
+     scene("mixed-green","最后任务 → 完成",[.success,.failure,.running],[.success,.failure,.success]),
+     scene("mixed-red","最后任务 → 失败",[.success,.failure,.running],[.success,.failure,.failure]),
+     DemoScene(id:"clear-all",title:"全部已读 → 待机",initial:rows([.success,.failure]),beats:[DemoBeat(at:1.6,rows:rows([.success,.failure]).filter {$0.id != "demo-task-0"}),DemoBeat(at:4.1,rows:[])])],
+    [idle("blink","眨眼"),idle("scan","左右看看"),idle("tilt","歪头"),idle("nod","点头"),idle("stretch","伸懒腰"),idle("hop","蹦一蹦")],
+    [idle("balance","保持平衡"),idle("sneeze","打喷嚏"),idle("sleep","打个盹"),idle("dance","变色龙"),
+     DemoScene(id:"idle-flow",title:"动作自然衔接",initial:[],beats:[DemoBeat(at:0.65,action:"nod"),DemoBeat(at:4.4,action:"stretch")],duration:12),
+     DemoScene(id:"dance-flow",title:"彩蛋自然衔接",initial:[],beats:[DemoBeat(at:0.65,action:"dance"),DemoBeat(at:5.3,action:"scan")],duration:13)]
+  ]
+  static var all:[DemoScene] {groups.flatMap {$0}}
+}
+
+@MainActor final class DemoTile:ObservableObject,Identifiable {
+  let id=UUID()
+  let scene:DemoScene
+  let board=BoardModel()
+  init(_ scene:DemoScene) {
+    self.scene=scene;board.previewMode=true
+    apply(scene.initial);board.tickOrbitLayout(at:Date().addingTimeInterval(3))
+  }
+  func apply(_ rows:[NotchRow]) {
+    board.applySnapshot(NotchSnapshot(ok:true,generatedAt:0,origin:"offline-recording",rows:rows))
+  }
+  func apply(_ beat:DemoBeat) {
+    if let rows=beat.rows {apply(rows)}
+    if let action=beat.action {NotificationCenter.default.post(name:PreviewIdleCue.notification,object:PreviewIdleCue(board:board,action:action))}
+  }
+}
+
+@MainActor final class RecordingModel:ObservableObject {
+  @Published var tiles:[DemoTile]=[]
+  @Published var group=0
+  @Published var selected=0
+  @Published var solo=false
+  @Published var autoplay=true
+  @Published var controls=false
+  private var job:Task<Void,Never>?
+  private var epoch=0
+  var count:Int {solo ? DemoCatalog.all.count:DemoCatalog.groups.count}
+  var page:Int {solo ? selected:group}
+  var scenes:[DemoScene] {solo ? [DemoCatalog.all[selected]]:DemoCatalog.groups[group]}
+  func move(_ direction:Int) {
+    if solo {selected=(selected+direction+count)%count} else {group=(group+direction+count)%count}
+    replay()
+  }
+  func toggleLayout() {
+    if !solo {selected=group*6} else {group=selected/6}
+    solo.toggle();replay()
+  }
+  func replay() {
+    job?.cancel();epoch += 1;let token=epoch
+    job=Task { @MainActor in
+      while !Task.isCancelled,token==epoch {
+        let batch=scenes.map(DemoTile.init);tiles=batch
+        let duration=scenes.map(\.duration).max() ?? 8
+        let events=batch.flatMap {tile in tile.scene.beats.map {(tile,$0)}}.sorted {$0.1.at < $1.1.at}
+        var last=0.0
+        for (tile,beat) in events {
+          do {try await Task.sleep(for:.seconds(max(0,beat.at-last)))} catch {return}
+          guard token==epoch else {return};tile.apply(beat);last=beat.at
+        }
+        do {try await Task.sleep(for:.seconds(max(0,duration-last)))} catch {return}
+        guard token==epoch else {return}
+        if autoplay {
+          if solo {selected=(selected+1)%count} else {group=(group+1)%count}
+        }
+      }
+    }
+  }
+  func stop() {job?.cancel();job=nil;epoch += 1}
+}

package/tools/recording/README.md

@@ -0,0 +1,23 @@
+# Bilingual recording demo / 双语录屏演示
+
+Build from the current production animation sources:
+
+```sh
+npm run build:demo
+open "dist/DSH Notch Demo.app"
+```
+
+36 scenes in six groups cover idle, working, decisions and resume, success, failure, unread clearing, nine robot motions, and the chameleon easter egg. Chinese and English titles share one fixed title area. The demo uses local fixtures and a transport stub; it does not connect to DSH or use model tokens.
+
+共 6 组、36 个场景。中文在上、英文在下，仅保留状态名称。动画源与正式 helper 相同，演示仅用本地假任务驱动，不连接 DSH。
+
+| Key | Action / 操作 |
+| --- | --- |
+| ← / → | Previous / next group · 上一组 / 下一组 |
+| R | Replay · 重播 |
+| S | Grid / single scene · 并排 / 单场景 |
+| H | Show / hide controls · 显示 / 隐藏控制栏 |
+| Control + Command + F | Full screen · 全屏 |
+| Command + Q | Quit · 退出 |
+
+Disable “全部连播” to keep looping the selected group. Move the pointer away and hide the controls before recording. The regular helper and DSH can remain running.

package/tools/recording/build.sh

@@ -0,0 +1,41 @@
+#!/bin/sh
+set -eu
+repo=$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)
+export DEVELOPER_DIR="${DEVELOPER_DIR:-/Library/Developer/CommandLineTools}"
+work="$repo/.build/recording"
+mkdir -p "$work/Sources" "$repo/dist"
+python3 - "$repo" "$work" <<'PY'
+from pathlib import Path
+import shutil,sys
+repo,work=map(Path,sys.argv[1:])
+for name in ['RootView.swift','StatusOrbit.swift','IdleRobot.swift','Panel.swift','NotchMarkdown.swift']:
+    shutil.copy2(repo/'macos/Sources'/name,work/'Sources'/name)
+for name in ['DemoCatalog.swift','main.swift','Client.swift']:
+    shutil.copy2(repo/'tools/recording'/name,work/'Sources'/name)
+shutil.copytree(repo/'macos/Sources/Resources',work/'Sources/Resources',dirs_exist_ok=True)
+p=work/'Sources/IdleRobot.swift';s=p.read_text()
+old='.onAppear { presence.set(idle, director: director, animated: false) }'
+new='''.onAppear { director.automaticActions=false;presence.set(idle, director: director, animated: false) }
+    .onReceive(NotificationCenter.default.publisher(for:PreviewIdleCue.notification)) { note in
+      guard let cue=note.object as? PreviewIdleCue,cue.boardID==ObjectIdentifier(model) else {return}
+      director.automaticActions=false;director.play(cue.action)
+    }'''
+assert s.count(old)==1,'Idle playback hook changed; inspect the production source before updating this adapter.'
+p.write_text(s.replace(old,new))
+(work/'Package.swift').write_text('''// swift-tools-version: 6.0
+import PackageDescription
+let package = Package(name:"NotchDemo",platforms:[.macOS(.v14)],products:[.executable(name:"NotchDemo",targets:["NotchDemo"])],targets:[.executableTarget(name:"NotchDemo",path:"Sources",resources:[.copy("Resources/Idle")])])
+''')
+PY
+swift build --package-path "$work" -c release
+python3 - "$repo" "$work" <<'PY'
+from pathlib import Path
+import shutil,plistlib,sys
+repo,work=map(Path,sys.argv[1:]);app=repo/'dist/DSH Notch Demo.app/Contents'
+(app/'MacOS').mkdir(parents=True,exist_ok=True);(app/'Resources').mkdir(exist_ok=True)
+shutil.copy2(work/'.build/release/NotchDemo',app/'MacOS/NotchDemo')
+for bundle in (work/'.build/release').glob('*.bundle'):
+    shutil.copytree(bundle,app/'Resources'/bundle.name,dirs_exist_ok=True)
+(app/'Info.plist').write_bytes(plistlib.dumps({'CFBundleIdentifier':'local.dsh.notch.demo','CFBundleName':'DSH Notch Demo','CFBundleExecutable':'NotchDemo','CFBundlePackageType':'APPL','CFBundleShortVersionString':'0.3.0','CFBundleVersion':'3','NSHighResolutionCapable':True,'LSMinimumSystemVersion':'14.0'}))
+print(app.parent)
+PY

package/tools/recording/main.swift

@@ -0,0 +1,100 @@
+import AppKit
+import SwiftUI
+
+struct RecordingTileView:View {
+  let tile:DemoTile
+  let solo:Bool
+  @ObservedObject var board:BoardModel
+  init(tile:DemoTile,solo:Bool) {self.tile=tile;self.solo=solo;board=tile.board}
+  var body:some View {
+    GeometryReader {geo in
+      let scale:CGFloat=solo ? min(5.4,(geo.size.height-140)/110):min(2.65,(geo.size.height-104)/104)
+      VStack(spacing:0) {
+        VStack(spacing:5) {
+          Text(tile.scene.title).font(.system(size:solo ? 40:24,weight:.semibold))
+            .foregroundStyle(Color(white:0.14))
+          Text(tile.scene.englishTitle).font(.system(size:solo ? 27:17,weight:.medium))
+            .foregroundStyle(Color(white:0.34))
+        }.lineLimit(1).minimumScaleFactor(0.7)
+          .frame(height:solo ? 130:82)
+        ZStack {
+          RootView(model:board,panelSize:CGSize(width:340,height:260),restSize:CGSize(width:38,height:44))
+            .frame(width:38,height:max(44,board.orbitLayout.height+24))
+            .scaleEffect(scale).allowsHitTesting(false)
+        }.frame(maxWidth:.infinity,maxHeight:.infinity)
+      }.frame(width:geo.size.width,height:geo.size.height)
+    }
+  }
+}
+
+struct RecordingView:View {
+  @ObservedObject var model:RecordingModel
+  var body:some View {
+    GeometryReader {geo in
+      ZStack(alignment:.bottom) {
+        Color(white:0.965)
+        if model.solo {
+          if let tile=model.tiles.first {
+            RecordingTileView(tile:tile,solo:true).id(tile.id).padding(.horizontal,60).padding(.top,22).padding(.bottom,80)
+          }
+        } else {
+          VStack(spacing:16) {
+            ForEach(0..<2,id:\.self) {row in
+              HStack(spacing:26) {
+                ForEach(Array(model.tiles.dropFirst(row*3).prefix(3))) {tile in
+                  RecordingTileView(tile:tile,solo:false).id(tile.id)
+                }
+              }
+            }
+          }.padding(.horizontal,38).padding(.top,16).padding(.bottom,68)
+        }
+        HStack(spacing:18) {
+          Button {model.move(-1)} label:{Image(systemName:"chevron.left")}.keyboardShortcut(.leftArrow,modifiers:[]).help("上一组")
+          Text("\(model.page+1) / \(model.count)").monospacedDigit().foregroundStyle(.secondary)
+          Button {model.move(1)} label:{Image(systemName:"chevron.right")}.keyboardShortcut(.rightArrow,modifiers:[]).help("下一组")
+          Divider().frame(height:18)
+          Button {model.replay()} label:{Image(systemName:"arrow.counterclockwise")}.keyboardShortcut("r",modifiers:[]).help("重播")
+          Toggle("全部连播",isOn:$model.autoplay).toggleStyle(.checkbox)
+          Button {model.controls.toggle()} label:{Image(systemName:"eye.slash")}.keyboardShortcut("h",modifiers:[]).help("显示 / 隐藏控制栏")
+          Button {model.toggleLayout()} label:{Image(systemName:model.solo ? "square.grid.3x2":"rectangle")}.keyboardShortcut("s",modifiers:[]).help("并排 / 单场景")
+          Button {NSApp.keyWindow?.toggleFullScreen(nil)} label:{Image(systemName:"arrow.up.left.and.arrow.down.right")}.keyboardShortcut("f",modifiers:[.command,.control]).help("全屏")
+        }.font(.system(size:14)).buttonStyle(.plain)
+          .padding(.horizontal,22).padding(.vertical,14).background(.regularMaterial,in:Capsule())
+          .padding(.bottom,15).opacity(model.controls ? 1:0).allowsHitTesting(model.controls)
+          .animation(.easeOut(duration:0.15),value:model.controls)
+      }.onContinuousHover {phase in
+        switch phase {case .active(let p):model.controls=p.y > geo.size.height-70
+        case .ended:model.controls=false}
+      }
+    }.frame(minWidth:900,minHeight:620)
+  }
+}
+
+@MainActor final class RecordingDelegate:NSObject,NSApplicationDelegate,NSWindowDelegate {
+  let model=RecordingModel()
+  var window:NSWindow?
+  func applicationDidFinishLaunching(_ notification:Notification) {
+    let window=NSWindow(contentRect:NSRect(x:0,y:0,width:1200,height:780),styleMask:[.titled,.closable,.miniaturizable,.resizable,.fullSizeContentView],backing:.buffered,defer:false)
+    window.title="DSH Notch · Demo"
+    window.titleVisibility = .hidden;window.titlebarAppearsTransparent=true
+    window.contentView=NSHostingView(rootView:RecordingView(model:model))
+    window.backgroundColor=NSColor(white:0.965,alpha:1)
+    window.isReleasedWhenClosed=false;window.delegate=self
+    window.collectionBehavior=[.fullScreenPrimary]
+    window.center();window.makeKeyAndOrderFront(nil);self.window=window
+    NSApp.activate(ignoringOtherApps:true);model.replay()
+  }
+  func windowWillClose(_ notification:Notification) {model.stop();NSApp.terminate(nil)}
+  func applicationShouldTerminateAfterLastWindowClosed(_ sender:NSApplication)->Bool {true}
+}
+
+@main enum RecordingMain {
+  @MainActor static func main() {
+    let app=NSApplication.shared;app.setActivationPolicy(.regular)
+    let menu=NSMenu(),item=NSMenuItem(),sub=NSMenu()
+    sub.addItem(withTitle:"退出演示",action:#selector(NSApplication.terminate(_:)),keyEquivalent:"q")
+    item.submenu=sub;menu.addItem(item);app.mainMenu=menu
+    let delegate=RecordingDelegate();app.delegate=delegate
+    withExtendedLifetime(delegate) {app.run()}
+  }
+}

package/tools/review/ReviewStudio.swift

@@ -0,0 +1,236 @@
+import AppKit
+import SwiftUI
+
+/// Earlier recording-stage reference. The supported recorder is in tools/recording.
+@MainActor
+final class DemoStudio: ObservableObject {
+  @Published var board = BoardModel()
+  @Published var caption = "按「开始」再录"
+  @Published var playing = false
+  private var job: Task<Void, Never>?
+  private var generation = 0
+
+  init() { resetBoard() }
+
+  func reset() {
+    job?.cancel()
+    job = nil
+    playing = false
+    generation += 1
+    caption = "按「开始」再录"
+    resetBoard()
+    IdleDirector.previewInstance?.automaticActions = false
+  }
+
+  func start() {
+    job?.cancel()
+    generation += 1
+    let token = generation
+    resetBoard()
+    playing = true
+    job = Task { @MainActor in
+      await runScript(token)
+    }
+  }
+
+  private func resetBoard() {
+    board = BoardModel()
+    board.previewMode = true
+    board.maximumExpandedHeight = 460
+    board.expanded = false
+  }
+
+  private func snap(_ rows: [NotchRow]) {
+    board.applySnapshot(NotchSnapshot(ok: true, generatedAt: Date().timeIntervalSince1970, origin: "demo", rows: rows))
+  }
+
+  private func busy(_ n: Int) -> [NotchRow] {
+    (0..<n).map { i in
+      NotchRow(id: "demo-\(i)", title: "任务 \(i + 1)", child: false, busy: true, unread: false, lastTurn: nil, approval: nil, ask: nil)
+    }
+  }
+
+  private func mixed() -> [NotchRow] {
+    [
+      NotchRow(id: "demo-0", title: "任务 1", child: false, busy: false, unread: true, lastTurn: nil, approval: nil, ask: nil),
+      NotchRow(
+        id: "demo-1",
+        title: "任务 2",
+        child: false,
+        busy: false,
+        unread: true,
+        lastTurn: NotchLastTurn(at: Date().timeIntervalSince1970, kind: "error", failed: true),
+        approval: nil,
+        ask: nil
+      ),
+      NotchRow(
+        id: "demo-2",
+        title: "任务 3",
+        child: false,
+        busy: false,
+        unread: false,
+        lastTurn: nil,
+        approval: nil,
+        ask: NotchAsk(id: "demo-ask", questions: [
+          NotchQuestion(
+            id: "q1",
+            question: "这条任务下一步怎么走？",
+            detail: "录屏用的假问题，点任意一项即可。",
+            header: nil,
+            options: [
+              NotchOption(label: "先改动画", description: "收起和展开再顺一点"),
+              NotchOption(label: "先改文案", description: "字幕再短一点"),
+              NotchOption(label: "都行", description: "你选就好"),
+            ],
+            multiSelect: false
+          )
+        ])
+      ),
+      NotchRow(id: "demo-3", title: "任务 4", child: false, busy: true, unread: false, lastTurn: nil, approval: nil, ask: nil),
+    ]
+  }
+
+  private func runScript(_ token: Int) async {
+    func alive() -> Bool { token == generation && !Task.isCancelled }
+
+    try? await Task.sleep(for: .milliseconds(400))
+    guard alive() else { return }
+    IdleDirector.previewInstance?.automaticActions = false
+    let tour = IdleDirector.basics + ["dance"]
+    for id in tour {
+      guard alive() else { return }
+      caption = "待机 · \(id)"
+      IdleDirector.previewInstance?.play(id)
+      let wait = IdleDirector.previewInstance?.currentDuration ?? 7
+      try? await Task.sleep(for: .seconds(wait))
+    }
+
+    guard alive() else { return }
+    caption = "4 个任务开始运行"
+    snap(busy(4))
+    try? await Task.sleep(for: .seconds(2.2))
+
+    guard alive() else { return }
+    caption = "请把鼠标移到黄点上，点一个选项"
+    snap(mixed())
+
+    while alive() && board.needsAction {
+      try? await Task.sleep(for: .milliseconds(120))
+    }
+    guard alive() else { return }
+    caption = "请点红点"
+
+    while alive() && !board.failedRows.isEmpty {
+      try? await Task.sleep(for: .milliseconds(120))
+    }
+    guard alive() else { return }
+    caption = "蓝灯即将结束"
+    try? await Task.sleep(for: .seconds(2.6))
+    guard alive() else { return }
+    snap(board.rows.filter { !$0.busy })
+    caption = "请点绿点"
+
+    while alive() && board.completedUnreadCount > 0 {
+      try? await Task.sleep(for: .milliseconds(120))
+    }
+    guard alive() else { return }
+    caption = "结束 · 可按「重来」"
+    playing = false
+  }
+}
+
+struct DemoStudioView: View {
+  @ObservedObject var studio: DemoStudio
+  @State private var hoverNotch = false
+
+  private var previewWidth: CGFloat {
+    studio.board.expanded ? 320 : (studio.board.isPillHovered ? 42 : 38)
+  }
+  private var previewHeight: CGFloat {
+    if studio.board.expanded {
+      return min(max(studio.board.measuredContentHeight, studio.board.needsAction ? 280 : 160), 420)
+    }
+    return max(44, studio.board.orbitLayout.height + 24)
+  }
+
+  var body: some View {
+    HStack(alignment: .top, spacing: 24) {
+      VStack(alignment: .leading, spacing: 12) {
+        Text("录屏模拟台").font(.system(size: 18, weight: .semibold))
+        Text(studio.caption)
+          .font(.system(size: 13))
+          .foregroundStyle(.secondary)
+          .frame(minHeight: 36, alignment: .topLeading)
+        ZStack(alignment: .topTrailing) {
+          RoundedRectangle(cornerRadius: 16, style: .continuous)
+            .fill(Color(red: 0.07, green: 0.07, blue: 0.08))
+          RootView(
+            model: studio.board,
+            panelSize: CGSize(width: 320, height: 460),
+            restSize: CGSize(width: 38, height: 44)
+          )
+          .frame(width: previewWidth, height: previewHeight)
+          .clipped()
+          .onHover { hovering in
+            hoverNotch = hovering
+            if hovering && studio.board.needsAction {
+              studio.board.expanded = true
+            } else if !hovering {
+              DispatchQueue.main.asyncAfter(deadline: .now() + 0.38) {
+                if !hoverNotch { studio.board.expanded = false }
+              }
+            }
+          }
+        }
+        .frame(width: 360, height: 440, alignment: .topTrailing)
+        .clipShape(RoundedRectangle(cornerRadius: 16, style: .continuous))
+      }
+      VStack(alignment: .leading, spacing: 10) {
+        Button(studio.playing ? "进行中…" : "开始") { studio.start() }
+          .disabled(studio.playing)
+          .keyboardShortcut(.defaultAction)
+        Button("重来") { studio.reset() }
+        Text("不接 Host，不影响正在跑的 notch。\n黄 / 红 / 绿需要你点。")
+          .font(.system(size: 11))
+          .foregroundStyle(.secondary)
+          .padding(.top, 8)
+        Spacer()
+      }
+      .frame(width: 180)
+    }
+    .padding(24)
+    .frame(minWidth: 640, minHeight: 520)
+  }
+}
+
+@MainActor
+final class DemoStudioDelegate: NSObject, NSApplicationDelegate, NSWindowDelegate {
+  let studio = DemoStudio()
+  var window: NSWindow?
+  func applicationDidFinishLaunching(_ notification: Notification) {
+    setbuf(stdout, nil)
+    let window = NSPanel(
+      contentRect: NSRect(x: 0, y: 0, width: 720, height: 560),
+      styleMask: [.titled, .closable, .resizable, .nonactivatingPanel, .hudWindow],
+      backing: .buffered,
+      defer: false
+    )
+    window.title = "dsh-notch 录屏模拟台"
+    window.delegate = self
+    window.isReleasedWhenClosed = false
+    window.isFloatingPanel = true
+    window.hidesOnDeactivate = false
+    window.level = .floating
+    window.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary]
+    window.contentView = NSHostingView(rootView: DemoStudioView(studio: studio))
+    let screen = NSScreen.screens.first { abs($0.frame.minX) < 1 && abs($0.frame.minY) < 1 } ?? NSScreen.main
+    if let vis = screen?.visibleFrame {
+      window.setFrame(NSRect(x: vis.midX - 360, y: vis.maxY - 620, width: 720, height: 560), display: true)
+    }
+    window.orderFrontRegardless()
+    NSApplication.shared.activate(ignoringOtherApps: true)
+    self.window = window
+    print("DEMO_STUDIO ready")
+  }
+  func windowWillClose(_ notification: Notification) { NSApplication.shared.terminate(nil) }
+}

package/tools/review/audit.sh

@@ -0,0 +1,19 @@
+#!/bin/sh
+set -eu
+repo=$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)
+work=$(mktemp -d "${TMPDIR:-/tmp}/notch-audit.XXXXXX")
+output=${1:-"$work/frames"}
+mkdir -p "$output"
+cp "$repo/macos/Package.swift" "$work/Package.swift"
+cp -R "$repo/macos/Sources" "$work/Sources"
+python3 - "$repo" "$work" <<'PYTHON'
+from pathlib import Path
+import sys
+repo,work=map(Path,sys.argv[1:])
+s=(repo/'tools/review/main.swift').read_text().split('@main enum LoopMain')[0]
+s+=(repo/'tools/review/render-audit.swift').read_text()
+(work/'Sources/main.swift').write_text(s)
+p=work/'Sources/IdleRobot.swift';s=p.read_text().replace('final class IdleDirector: ObservableObject {','final class IdleDirector: ObservableObject {\n  static weak var previewInstance: IdleDirector?').replace('  func start(playImmediately: Bool = true) {','  func start(playImmediately: Bool = true) {\n    Self.previewInstance=self');p.write_text(s)
+PYTHON
+swift build --package-path "$work" -c release -j 2
+NOTCH_AUDIT_OUTPUT="$output" "$work/.build/release/dsh-notch"