csm-cli 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
csm_cli/ui.py ADDED
@@ -0,0 +1,727 @@
1
+ """csm_ui — prompt_toolkit 交互式会话选择器。
2
+
3
+ 结构:header(统计/键位提示)/ 搜索 Buffer / 会话列表(自管可见窗口)/ footer(选中项详情)。
4
+ 列表用 FormattedTextControl 渲染切片——它没有光标,prompt_toolkit 不会自动滚动,
5
+ 因此由我们自己根据 selected 调整 offset(fzf 的做法)。
6
+
7
+ 后台 daemon 线程负责 light_scan 补漏与 full_scan(消息数),完成后 app.invalidate()
8
+ (官方支持的跨线程刷新通道)驱动界面更新。
9
+ """
10
+
11
+ from __future__ import annotations
12
+
13
+ import shutil
14
+ import threading
15
+ import time
16
+
17
+ from prompt_toolkit.application import Application
18
+ from prompt_toolkit.buffer import Buffer
19
+ from prompt_toolkit.filters import Condition
20
+ from prompt_toolkit.formatted_text import StyleAndTextTuples
21
+ from prompt_toolkit.key_binding import KeyBindings, KeyPressEvent
22
+ from prompt_toolkit.layout import BufferControl, ConditionalContainer, FormattedTextControl, HSplit, Layout, Window
23
+ from prompt_toolkit.styles import Style
24
+
25
+ from csm_cli import fmt as csm_fmt
26
+ from csm_cli import scanner
27
+ from csm_cli.scanner import SessionEntry
28
+
29
+ # 选中项匹配高亮的最大字段宽度(防 footer 超宽)
30
+ _FOOTER_MAX = 160
31
+
32
+ # TUI 预览取最近 N 条消息
33
+ PREVIEW_N = 50
34
+
35
+ # 30s 静默自动重扫间隔
36
+ AUTO_REFRESH_SECS = 30.0
37
+
38
+ # 过滤器中文标签(顺序与 scanner.FILTER_NAMES 一致,数字键 1-6)
39
+ _FILTER_LABELS = {"all": "全部", "running": "运行中", "current": "本终端",
40
+ "starred": "收藏", "closed": "已关闭", "once": "单轮"}
41
+
42
+
43
+ def _time_text(mtime: float) -> str:
44
+ try:
45
+ return csm_fmt.rel_time(mtime)
46
+ except NotImplementedError:
47
+ return time.strftime("%H:%M", time.localtime(mtime))
48
+
49
+
50
+ def _token_score(token: str, text: str) -> float | None:
51
+ """单 token 对单字段打分。query 含 / 或 CJK 时退化为子串匹配;否则 fuzzy。"""
52
+ text = text.lower()
53
+ token = token.lower()
54
+ if not token:
55
+ return 0.0
56
+ if any("/" in ch or ord(ch) > 0x2E7F for ch in token): # 路径/CJK → 精确子串
57
+ return 1000.0 if token in text else None
58
+ try:
59
+ return csm_fmt.fuzzy_score(token, text)
60
+ except NotImplementedError:
61
+ return 1000.0 if token in text else None
62
+
63
+
64
+ def score_entry(entry: SessionEntry, tokens: list[str]) -> float | None:
65
+ """多字段加权(标题×3 首输入×2 项目×1.5 SID×1),token 间 AND,不匹配返回 None。"""
66
+ fields = [
67
+ (entry.title or "", 3.0),
68
+ (entry.first_input or "", 2.0),
69
+ (entry.project_path or "", 1.5),
70
+ (entry.session_id, 1.0),
71
+ ]
72
+ total = 0.0
73
+ for token in tokens:
74
+ best: float | None = None
75
+ for text, weight in fields:
76
+ s = _token_score(token, text)
77
+ if s is not None:
78
+ v = s * weight
79
+ if best is None or v > best:
80
+ best = v
81
+ if best is None:
82
+ return None
83
+ total += best
84
+ return total
85
+
86
+
87
+ class SessionPicker:
88
+ def __init__(self, entries: list[SessionEntry], args) -> None:
89
+ self.entries = entries
90
+ self.args = args
91
+ self.selected = 0
92
+ self.offset = 0
93
+ self._scores: list[float] | None = None # 非 None = 按相关度排序的结果
94
+
95
+ # ---- 预览视图状态(Tab 切换)----
96
+ self.view: str = "list" # "list" | "preview"
97
+ self.preview_sid: str | None = None # 防竞态:加载返回时校验
98
+ self.preview_messages: list[scanner.Message] | None = None
99
+ self.preview_error: str | None = None
100
+ self.preview_offset: int = 0
101
+ self._in_list = Condition(lambda: self.view == "list")
102
+ self._in_preview = Condition(lambda: self.view == "preview")
103
+
104
+ self.query = Buffer(on_text_changed=lambda _: self._refilter())
105
+ self._filtered_idx: list[int] = list(range(len(entries)))
106
+ self._match_scores: dict[int, float] = {}
107
+
108
+ # ---- 分类过滤器(数字键 1-6)----
109
+ self.filter_name = "all"
110
+ self._current_tty = scanner.current_terminal_tty() # 进程生命周期内不变
111
+ self._notice_until = 0.0 # header 临时提示截止时间
112
+
113
+ kb = self._build_keybindings()
114
+ style = Style.from_dict({
115
+ "header": "bold",
116
+ "query": "bold",
117
+ "row-selected": "reverse",
118
+ "sid": "#666666",
119
+ "running": "bold green",
120
+ "idle": "yellow",
121
+ "waiting": "cyan",
122
+ "star": "bold yellow",
123
+ "notice": "yellow",
124
+ "path": "cyan",
125
+ "title": "bold",
126
+ "dim": "#888888",
127
+ "footer": "",
128
+ "user": "cyan",
129
+ "tool": "#888888",
130
+ "error": "red",
131
+ })
132
+
133
+ from prompt_toolkit.layout import VSplit
134
+
135
+ self.app: Application[SessionEntry | None] = Application(
136
+ layout=Layout(
137
+ HSplit([
138
+ Window(FormattedTextControl(self._header_fragments), height=1, style="class:header"),
139
+ VSplit([
140
+ Window(FormattedTextControl(lambda: [("class:query", "❯ ")]), width=2, dont_extend_width=True),
141
+ Window(BufferControl(self.query), height=1, style="class:query"),
142
+ ]),
143
+ ConditionalContainer(
144
+ Window(
145
+ FormattedTextControl(self._row_fragments, show_cursor=False),
146
+ wrap_lines=False,
147
+ height=self._list_height, # callable → 布局时动态求值
148
+ ),
149
+ filter=self._in_list,
150
+ ),
151
+ ConditionalContainer(
152
+ Window(
153
+ FormattedTextControl(self._preview_fragments, show_cursor=False),
154
+ wrap_lines=False,
155
+ height=lambda: max(1, self._visible_rows()),
156
+ ),
157
+ filter=self._in_preview,
158
+ ),
159
+ Window(FormattedTextControl(self._footer_fragments), height=3, style="class:footer", wrap_lines=False),
160
+ ])
161
+ ),
162
+ key_bindings=kb,
163
+ style=style,
164
+ full_screen=False,
165
+ )
166
+ self._bg_stop = threading.Event()
167
+ self._bg = threading.Thread(target=self._background_scan, daemon=True)
168
+ self._auto: threading.Thread | None = None
169
+
170
+ # ------------------------------------------------------------------ 过滤
171
+
172
+ def _notice(self, text: str) -> None:
173
+ """header 临时提示(2s 后消失)。"""
174
+ self._notice_text = text
175
+ self._notice_until = time.time() + 2.0
176
+ self.app.invalidate()
177
+
178
+ def _set_filter(self, name: str) -> None:
179
+ if name == "current" and self._current_tty is None:
180
+ self._notice("本终端不可用(无法识别 tty)")
181
+ return
182
+ self.filter_name = name
183
+ self._refilter()
184
+
185
+ def _refilter(self) -> None:
186
+ """过滤器(数字键)AND #tags AND query;query 有值时按分数序,否则保序(=置顶序)。"""
187
+ plain, tag_tokens = csm_fmt.parse_query(self.query.text)
188
+ base = [i for i, e in enumerate(self.entries)
189
+ if scanner.match_filter(e, self.filter_name)]
190
+ if tag_tokens:
191
+ base = [i for i in base
192
+ if all(t in {x.lower() for x in self.entries[i].tags} for t in tag_tokens)]
193
+ if plain:
194
+ scored: list[tuple[float, int]] = []
195
+ for i in base:
196
+ sc = score_entry(self.entries[i], plain)
197
+ if sc is not None:
198
+ scored.append((sc, i))
199
+ scored.sort(key=lambda t: -t[0])
200
+ self._filtered_idx = [i for _, i in scored]
201
+ self._match_scores = {i: sc for sc, i in scored}
202
+ else:
203
+ self._filtered_idx = base # entries 已是 sort_pinned 序,原样保序
204
+ self._match_scores = {}
205
+ self._scores = None
206
+ self.selected = 0
207
+ self.offset = 0
208
+ self.app.invalidate()
209
+
210
+ def _refilter_keep_sid(self, sid: str) -> None:
211
+ """重过滤后把选择定位到 sid(找不到归 0)——星标行跳转后跟随。"""
212
+ self._refilter()
213
+ for row, i in enumerate(self._filtered_idx):
214
+ if self.entries[i].session_id == sid:
215
+ self.selected = row
216
+ break
217
+ else:
218
+ self.selected = 0
219
+ self._clamp_view()
220
+ self.app.invalidate()
221
+
222
+ # ------------------------------------------------------------------ 滚动
223
+
224
+ def _visible_rows(self) -> int:
225
+ rows = shutil.get_terminal_size().lines - 5 # header+query+footer(3)+1
226
+ return max(rows, 3)
227
+
228
+ def _list_height(self) -> int:
229
+ return max(1, min(len(self._filtered_idx), self._visible_rows()))
230
+
231
+ def _clamp_view(self) -> None:
232
+ n = len(self._filtered_idx)
233
+ if n == 0:
234
+ self.selected = 0
235
+ self.offset = 0
236
+ return
237
+ self.selected = max(0, min(self.selected, n - 1))
238
+ vr = self._visible_rows()
239
+ if self.selected < self.offset:
240
+ self.offset = self.selected
241
+ elif self.selected >= self.offset + vr:
242
+ self.offset = self.selected - vr + 1
243
+
244
+ def _move(self, delta: int) -> None:
245
+ self.selected += delta
246
+ self._clamp_view()
247
+ self.app.invalidate()
248
+
249
+ # ------------------------------------------------------------------ 键位
250
+
251
+ def _build_keybindings(self) -> KeyBindings:
252
+ kb = KeyBindings()
253
+ # vim 导航键仅在无输入时生效,避免劫持打字(fzf 惯例)
254
+ _empty_query = Condition(lambda: not self.query.text)
255
+
256
+ # ---- 列表视图键位 ----
257
+
258
+ @kb.add("up", filter=self._in_list)
259
+ @kb.add("k", filter=self._in_list & _empty_query)
260
+ def _up(event: KeyPressEvent) -> None:
261
+ self._move(-1)
262
+
263
+ @kb.add("down", filter=self._in_list)
264
+ @kb.add("j", filter=self._in_list & _empty_query)
265
+ def _down(event: KeyPressEvent) -> None:
266
+ self._move(1)
267
+
268
+ @kb.add("pageup", filter=self._in_list)
269
+ def _pgup(event: KeyPressEvent) -> None:
270
+ self._move(-self._visible_rows())
271
+
272
+ @kb.add("pagedown", filter=self._in_list)
273
+ def _pgdn(event: KeyPressEvent) -> None:
274
+ self._move(self._visible_rows())
275
+
276
+ @kb.add("home", filter=self._in_list)
277
+ def _home(event: KeyPressEvent) -> None:
278
+ self.selected = 0
279
+ self._clamp_view()
280
+ self.app.invalidate()
281
+
282
+ @kb.add("end", filter=self._in_list)
283
+ def _end(event: KeyPressEvent) -> None:
284
+ self.selected = len(self._filtered_idx) - 1
285
+ self._clamp_view()
286
+ self.app.invalidate()
287
+
288
+ @kb.add("enter", filter=self._in_list)
289
+ def _enter(event: KeyPressEvent) -> None:
290
+ if self._filtered_idx:
291
+ event.app.exit(result=self.entries[self._filtered_idx[self.selected]])
292
+ else:
293
+ event.app.exit(result=None)
294
+
295
+ @kb.add("escape", filter=self._in_list)
296
+ def _esc_list(event: KeyPressEvent) -> None:
297
+ event.app.exit(result=None)
298
+
299
+ @kb.add("c-l", filter=self._in_list)
300
+ def _clear(event: KeyPressEvent) -> None:
301
+ self.query.reset()
302
+
303
+ @kb.add("c-r", filter=self._in_list)
304
+ def _rescan(event: KeyPressEvent) -> None:
305
+ self.refresh_entries()
306
+
307
+ @kb.add("tab", filter=self._in_list)
308
+ def _to_preview(event: KeyPressEvent) -> None:
309
+ self._enter_preview()
310
+
311
+ @kb.add("s", filter=self._in_list & _empty_query)
312
+ def _star(event: KeyPressEvent) -> None:
313
+ if not self._filtered_idx:
314
+ return
315
+ e = self.entries[self._filtered_idx[self.selected]]
316
+ try:
317
+ rec = scanner.update_favorite(e.session_id, star=(e.star + 1) % 3)
318
+ except (OSError, ValueError):
319
+ self._notice("收藏写入失败")
320
+ return
321
+ e.star, e.tags = rec.get("star", 0), list(rec.get("tags", []))
322
+ scanner.sort_pinned(self.entries)
323
+ # 选择必须跟随行跳转(s 是三态循环,行跳到置顶段后才能连按)
324
+ self._refilter_keep_sid(e.session_id)
325
+
326
+ for digit, name in zip("123456", scanner.FILTER_NAMES):
327
+ @kb.add(digit, filter=self._in_list & _empty_query)
328
+ def _switch(event: KeyPressEvent, name: str = name) -> None:
329
+ self._set_filter(name)
330
+
331
+ # ---- 预览视图键位 ----
332
+
333
+ @kb.add("tab", filter=self._in_preview)
334
+ @kb.add("escape", filter=self._in_preview)
335
+ def _back_list(event: KeyPressEvent) -> None:
336
+ self._exit_preview()
337
+
338
+ @kb.add("up", filter=self._in_preview)
339
+ @kb.add("k", filter=self._in_preview & _empty_query)
340
+ def _p_up(event: KeyPressEvent) -> None:
341
+ self._move_preview(-1)
342
+
343
+ @kb.add("down", filter=self._in_preview)
344
+ @kb.add("j", filter=self._in_preview & _empty_query)
345
+ def _p_down(event: KeyPressEvent) -> None:
346
+ self._move_preview(1)
347
+
348
+ @kb.add("pageup", filter=self._in_preview)
349
+ def _p_pgup(event: KeyPressEvent) -> None:
350
+ self._move_preview(-self._visible_rows())
351
+
352
+ @kb.add("pagedown", filter=self._in_preview)
353
+ def _p_pgdn(event: KeyPressEvent) -> None:
354
+ self._move_preview(self._visible_rows())
355
+
356
+ @kb.add("home", filter=self._in_preview)
357
+ def _p_home(event: KeyPressEvent) -> None:
358
+ self.preview_offset = 0
359
+ self.app.invalidate()
360
+
361
+ @kb.add("end", filter=self._in_preview)
362
+ def _p_end(event: KeyPressEvent) -> None:
363
+ self.preview_offset = max(0, self._preview_total() - 1)
364
+ self._clamp_preview()
365
+ self.app.invalidate()
366
+
367
+ @kb.add("enter", filter=self._in_preview)
368
+ def _p_enter(event: KeyPressEvent) -> None:
369
+ # resume 预览中的会话(回到列表语义的选中项)
370
+ if self._filtered_idx:
371
+ event.app.exit(result=self.entries[self._filtered_idx[self.selected]])
372
+
373
+ @kb.add("c-r", filter=self._in_preview)
374
+ def _p_reload(event: KeyPressEvent) -> None:
375
+ self._enter_preview() # 重进即重读(mtime 变化自动失效缓存)
376
+
377
+ # ---- 两视图通用 ----
378
+
379
+ @kb.add("c-c")
380
+ @kb.add("c-g")
381
+ def _cancel(event: KeyPressEvent) -> None:
382
+ event.app.exit(result=None)
383
+
384
+ return kb
385
+
386
+ # ------------------------------------------------------------------ 预览视图(Tab)
387
+
388
+ def _enter_preview(self) -> None:
389
+ if not self._filtered_idx:
390
+ return
391
+ e = self.entries[self._filtered_idx[self.selected]]
392
+ self.view, self.preview_sid = "preview", e.session_id
393
+ self.preview_messages, self.preview_error, self.preview_offset = None, None, 0
394
+ self.app.invalidate()
395
+ threading.Thread(target=self._load_preview, args=(e.file_path, e.session_id), daemon=True).start()
396
+
397
+ def _load_preview(self, path: str, sid: str) -> None:
398
+ msgs = scanner.read_session_messages(path)
399
+ if self.preview_sid != sid:
400
+ return # 竞态:用户已切走,丢弃
401
+ if msgs is None:
402
+ self.preview_error = "会话文件不可读(可能已删除)"
403
+ else:
404
+ self.preview_messages = msgs[-PREVIEW_N:]
405
+ self.app.invalidate()
406
+
407
+ def _exit_preview(self) -> None:
408
+ # selected/offset/_filtered_idx 原样不动 → 返回时保持原选择
409
+ self.view = "list"
410
+ self.app.invalidate()
411
+
412
+ def _preview_total(self) -> int:
413
+ return len(self.preview_messages) if self.preview_messages else 0
414
+
415
+ def _clamp_preview(self) -> None:
416
+ n = self._preview_total()
417
+ if n == 0:
418
+ self.preview_offset = 0
419
+ return
420
+ vr = self._visible_rows()
421
+ self.preview_offset = max(0, min(self.preview_offset, n - 1))
422
+ if self.preview_offset + vr > n:
423
+ self.preview_offset = max(0, n - vr)
424
+
425
+ def _move_preview(self, delta: int) -> None:
426
+ self.preview_offset += delta
427
+ self._clamp_preview()
428
+ self.app.invalidate()
429
+
430
+ def _preview_fragments(self) -> StyleAndTextTuples:
431
+ if self.preview_error:
432
+ return [("class:dim", f" {self.preview_error}")]
433
+ if self.preview_messages is None:
434
+ return [("class:dim", " 解析中…(大文件首次约 1s,实际通常 <100ms)")]
435
+ frags: StyleAndTextTuples = []
436
+ width = shutil.get_terminal_size().columns
437
+ vr = self._visible_rows()
438
+ visible = self.preview_messages[self.preview_offset : self.preview_offset + vr]
439
+ for m in visible:
440
+ hhmm = (m.ts or "")[11:16]
441
+ if m.kind == "input":
442
+ frags.append(("class:user", f"{hhmm} ❯ "))
443
+ frags.append(("", csm_fmt.truncate_cjk(m.text or "", width - 10)))
444
+ elif m.kind == "text":
445
+ frags.append(("class:dim", f"{hhmm} "))
446
+ frags.append(("", csm_fmt.truncate_cjk(m.text or "", width - 10)))
447
+ else: # tool_use
448
+ mark = "✗" if m.tool_error else "🔧"
449
+ line = f"{scanner.short_tool_name(m.tool_name or '?')}: {m.tool_brief or ''}"
450
+ frags.append(("class:error" if m.tool_error else "class:tool", f"{hhmm} {mark} "))
451
+ frags.append(("class:dim", csm_fmt.truncate_cjk(line, width - 12)))
452
+ frags.append(("", "\n"))
453
+ # 滚动指示(顶行)
454
+ head: StyleAndTextTuples = []
455
+ if self.preview_offset > 0 or self._preview_total() > vr:
456
+ head.append(("class:dim", f" ↑ 更多 {max(self._preview_total() - self.preview_offset - vr, 0)} 条在下方 / 共 {self._preview_total()} 条(最近 {PREVIEW_N})\n"))
457
+ return head + frags
458
+
459
+ # ------------------------------------------------------------------ 渲染
460
+
461
+ def _header_fragments(self) -> StyleAndTextTuples:
462
+ matched = len(self._filtered_idx)
463
+ total = len(self.entries)
464
+ running = sum(1 for e in self.entries if e.running_status)
465
+ starred = sum(1 for e in self.entries if e.star)
466
+ if self.view == "preview":
467
+ e = (self.entries[self._filtered_idx[self.selected]]
468
+ if self._filtered_idx else None)
469
+ title = csm_fmt.truncate_cjk(e.display_title, 40) if e else ""
470
+ return [
471
+ ("", f"预览: {title}"),
472
+ ("class:dim", " ↑↓滚动 ⏎resume Tab/Esc返回 ^R刷新"),
473
+ ]
474
+ frags: StyleAndTextTuples = [
475
+ ("", f"csm — {total} 会话"),
476
+ ("class:dim", f" ({running} 运行中)"),
477
+ ("class:star", f" ★{sum(1 for e in self.entries if e.star == 2)}"
478
+ f" ⭐{sum(1 for e in self.entries if e.star == 1)}"),
479
+ ("class:dim", f" 过滤:{_FILTER_LABELS.get(self.filter_name, self.filter_name)}"),
480
+ ("", f" {matched}/{total}"),
481
+ ("class:dim", " 1-6过滤 s星标 Tab预览 ^L清空 ^R重扫 esc退出"),
482
+ ]
483
+ if starred == 0:
484
+ # 无收藏时省略星标统计
485
+ frags[2] = ("class:dim", "")
486
+ if time.time() < self._notice_until:
487
+ frags.append(("class:notice", f" ⚠ {getattr(self, '_notice_text', '')}"))
488
+ return frags
489
+
490
+ def _row_fragments(self) -> StyleAndTextTuples:
491
+ frags: StyleAndTextTuples = []
492
+ width = shutil.get_terminal_size().columns
493
+ vr = self._visible_rows()
494
+ visible = self._filtered_idx[self.offset : self.offset + vr]
495
+
496
+ mark_w, time_w, st_w, turns_w, sid_w = 2, 5, 6, 3, 36
497
+ rest = max(width - (mark_w + time_w + st_w + turns_w + sid_w + 7), 20)
498
+ title_w = int(rest * 0.55)
499
+ proj_w = rest - title_w
500
+
501
+ for row, idx in enumerate(visible):
502
+ e = self.entries[idx]
503
+ sel = row + self.offset == self.selected
504
+ cls = "class:row-selected" if sel else ""
505
+
506
+ frags.append((cls, " ")) # 统一前导空格,选中行由反色样式覆盖
507
+ # 标记列:◉本终端 + ★/⭐收藏(CJK 宽度感知对齐到 2)
508
+ mark = ("◉" if e.is_current else " ") + ("★" if e.star == 2 else "⭐" if e.star == 1 else " ")
509
+ frags.append((cls if sel else "class:star" if e.star else "class:dim",
510
+ csm_fmt.pad_to_width(mark, mark_w)))
511
+ if e.running_status == "busy":
512
+ status_style = "class:running"
513
+ elif e.running_status == "waiting":
514
+ status_style = "class:waiting"
515
+ elif e.running_status:
516
+ status_style = "class:idle"
517
+ else:
518
+ status_style = "class:dim"
519
+ if e.running_status:
520
+ status_txt = f"●{e.running_status}"[:st_w]
521
+ elif e.entrypoint == "sdk-cli":
522
+ status_txt = "sdk" # 闭会话的 SDK 标记(运行状态优先)
523
+ else:
524
+ status_txt = ""
525
+ frags.extend([
526
+ (cls if sel else "class:dim", csm_fmt.pad_to_width(_time_text(e.mtime), time_w)),
527
+ ("", " "),
528
+ (cls if sel else status_style, csm_fmt.pad_to_width(status_txt, st_w)),
529
+ ("", " "),
530
+ ])
531
+ title = e.title or e.first_input or "(无用户输入)"
532
+ if e.tags:
533
+ title = f"{title} {' '.join('#' + t for t in e.tags[:3])}"
534
+ tstyle = cls if sel else ("class:title" if e.title else "class:dim")
535
+ frags.append((tstyle, csm_fmt.pad_to_width(csm_fmt.truncate_cjk(title, title_w), title_w)))
536
+ frags.append(("", " "))
537
+ if e.wt_name:
538
+ proj = f"{e.wt_repo or '?'}/{e.wt_name}" # worktree:主仓库/名(分支在 footer)
539
+ else:
540
+ proj = csm_fmt.shorten_path(e.project_path or "?", proj_w)
541
+ frags.append((cls if sel else "class:path", csm_fmt.pad_to_width(proj, proj_w)))
542
+ frags.append(("", " "))
543
+ turns = str(e.msg_count) if e.msg_count is not None else "·"
544
+ frags.append((cls if sel else "class:dim", csm_fmt.pad_to_width(turns, turns_w)))
545
+ frags.append(("", " "))
546
+ frags.append((cls if sel else "class:sid", e.session_id))
547
+ frags.append(("", "\n"))
548
+ if not visible:
549
+ frags.append(("class:dim", " (无匹配会话)"))
550
+ return frags
551
+
552
+ def _footer_fragments(self) -> StyleAndTextTuples:
553
+ if not self._filtered_idx:
554
+ return [("", ""), ("", "\n"), ("", "")]
555
+ e = self.entries[self._filtered_idx[self.selected]]
556
+ turns = (
557
+ f"用户 {e.msg_count} / 回复 {e.assistant_count}"
558
+ if e.msg_count is not None
559
+ else "统计中…"
560
+ )
561
+ running = f" ●{e.running_status}" if e.running_status else ""
562
+ name = f" [{e.session_name}]" if e.session_name else ""
563
+ star = " ★" if e.star == 2 else " ⭐" if e.star == 1 else ""
564
+ cur = " ◉本终端" if e.is_current else ""
565
+ sdk = " SDK" if e.entrypoint == "sdk-cli" else ""
566
+ tags = f" {' '.join('#' + t for t in e.tags)}" if e.tags else ""
567
+ if e.wt_branch:
568
+ ahead = f"+{e.wt_ahead}" if e.wt_ahead is not None else ""
569
+ wt = f" ⎇{e.wt_branch}{ahead}"
570
+ else:
571
+ wt = ""
572
+ line3 = e.first_input or "(无用户输入)"
573
+ path_len = len(e.project_path or "?") + len(wt)
574
+ return [
575
+ ("class:dim", "─" * min(shutil.get_terminal_size().columns, _FOOTER_MAX)),
576
+ ("", "\n"),
577
+ ("class:sid", e.session_id),
578
+ ("class:dim", f" {turns}{running}{name}"),
579
+ ("class:star", star),
580
+ ("class:dim", f"{sdk}{cur}"),
581
+ ("class:path", tags),
582
+ ("", "\n"),
583
+ ("class:path", e.project_path or "?"),
584
+ ("class:tool", wt),
585
+ ("class:dim", " "),
586
+ ("", csm_fmt.truncate_cjk(line3, max(shutil.get_terminal_size().columns - path_len - 4, 10))),
587
+ ]
588
+
589
+ # ------------------------------------------------------------------ 后台扫描
590
+
591
+ def _background_scan(self) -> None:
592
+ """daemon 线程:轻扫补漏 + 全扫补消息数,逐条 invalidate。
593
+
594
+ 开头捕获 stop 事件引用——Ctrl-R 重扫会替换 self._bg_stop 启动新线程,
595
+ 旧线程靠捕获的旧事件退出,不受新事件影响。
596
+ """
597
+ stop = self._bg_stop
598
+ for e in list(self.entries):
599
+ if stop.is_set():
600
+ return
601
+ if not e.light_scanned:
602
+ scanner.light_scan(e)
603
+ scanner.worktree_scan(e) # light 出 cwd 即检(纯文件读)
604
+ self.app.invalidate()
605
+ for e in list(self.entries):
606
+ if stop.is_set():
607
+ return
608
+ if not e.full_scanned:
609
+ scanner.full_scan(e)
610
+ self.app.invalidate()
611
+ # worktree 分支的未合并提交数(subprocess,2s 超时;放全扫后不挡首屏)
612
+ for e in list(self.entries):
613
+ if stop.is_set():
614
+ return
615
+ if e.wt_branch and not e.wt_deep_scanned:
616
+ scanner.worktree_ahead(e)
617
+ self.app.invalidate()
618
+ # 全扫后仍无首输入的,查全局历史
619
+ history = scanner.load_history_index()
620
+ for e in self.entries:
621
+ if stop.is_set():
622
+ return
623
+ if e.first_input is None:
624
+ e.first_input = scanner.first_input_from_history(e.session_id, history)
625
+ self.app.invalidate()
626
+
627
+ def refresh_entries(self) -> None:
628
+ """Ctrl-R:重新发现并轻扫,原地替换列表。"""
629
+ entries = scanner.discover_sessions(limit=self.args.limit, project_filter=self.args.project)
630
+ if not entries:
631
+ return
632
+ self._bg_stop.set() # 停旧线程(旧线程已捕获旧事件)
633
+ self._bg_stop = threading.Event()
634
+ scanner.apply_registry(entries, scanner.load_running_registry(),
635
+ current_tty=self._current_tty)
636
+ scanner.apply_favorites(entries, scanner.load_favorites())
637
+ scanner.sort_pinned(entries)
638
+ for e in entries[:40]:
639
+ scanner.light_scan(e)
640
+ scanner.worktree_scan(e)
641
+ self.entries = entries
642
+ self.selected = 0
643
+ self.offset = 0
644
+ self._refilter()
645
+ self._bg = threading.Thread(target=self._background_scan, daemon=True)
646
+ self._bg.start()
647
+ self._auto = threading.Thread(target=self._auto_refresh_loop, daemon=True)
648
+ self._auto.start() # 旧 _auto 线程因旧 stop 事件被置而自然退出
649
+
650
+ # ------------------------------------------------------------------ 30s 自动重扫
651
+
652
+ def _auto_refresh_loop(self) -> None:
653
+ """30s 静默重扫:发现新会话/更新 mtime;绝不动 selected/offset/过滤状态(sid 桥接恢复)。
654
+
655
+ 输入活动(query 非空)时跳过本轮:终端 app 感知不到窗口失焦,
656
+ 「正在打字」是唯一可靠的在场信号——省掉一轮 stat+轻扫 IO。
657
+ """
658
+ stop = self._bg_stop # 与 _background_scan 共用停止事件(Ctrl-R 重扫会换新事件)
659
+ while not stop.wait(AUTO_REFRESH_SECS):
660
+ if self.query.text:
661
+ continue
662
+ try:
663
+ if self._merge_refresh():
664
+ self.app.invalidate()
665
+ except Exception:
666
+ pass # 后台线程永不冒泡
667
+
668
+ def _merge_refresh(self) -> bool:
669
+ """增量合并新扫描结果到列表,返回是否有变化。
670
+
671
+ 核心问题:_filtered_idx 存的是 self.entries 下标,整体替换 entries 会失效,
672
+ 用 sid 桥接恢复过滤结果与选中项。自动重扫只做 stat+轻扫,永不自动 full_scan
673
+ (运行中会话 mtime 持续变,反复全扫 14MB 太贵;msg_count 允许陈旧)。
674
+ """
675
+ fresh = scanner.discover_sessions(limit=self.args.limit, project_filter=self.args.project)
676
+ if not fresh:
677
+ return False
678
+ old_by_sid = {e.session_id: e for e in self.entries}
679
+ changed = False
680
+ for ne in fresh:
681
+ oe = old_by_sid.get(ne.session_id)
682
+ if oe is None or (ne.mtime, ne.size) != (oe.mtime, oe.size):
683
+ scanner.light_scan(ne)
684
+ scanner.worktree_scan(ne) # 新对象无旧 wt 成果,重检(会话可能 cd 进了 worktree)
685
+ changed = True
686
+ elif oe is not None:
687
+ ne.__dict__.update(oe.__dict__) # 复用旧扫描成果
688
+ scanner.apply_registry(fresh, scanner.load_running_registry(),
689
+ current_tty=self._current_tty)
690
+ scanner.apply_favorites(fresh, scanner.load_favorites())
691
+ scanner.sort_pinned(fresh)
692
+
693
+ # ---- sid 桥接恢复过滤结果与选中项 ----
694
+ was_filtering = bool(self.query.text)
695
+ old_filtered_sids = {self.entries[i].session_id for i in self._filtered_idx}
696
+ cur_sid = (self.entries[self._filtered_idx[self.selected]].session_id
697
+ if self._filtered_idx else None)
698
+ self.entries = fresh # 原子引用赋值,渲染线程不撕裂
699
+ if was_filtering:
700
+ # 过滤中:新会话不进过滤结果 → 列表完全不跳
701
+ self._filtered_idx = [i for i, e in enumerate(fresh) if e.session_id in old_filtered_sids]
702
+ else:
703
+ self._filtered_idx = list(range(len(fresh)))
704
+ # 新会话按 mtime 自然 prepend;selected 保持指向同一 sid
705
+ if cur_sid:
706
+ for i, e in enumerate(fresh):
707
+ if e.session_id == cur_sid:
708
+ self.selected = i
709
+ break
710
+ self._clamp_view()
711
+ return changed
712
+
713
+ # ------------------------------------------------------------------ 入口
714
+
715
+ def run(self) -> SessionEntry | None:
716
+ self._bg.start()
717
+ if self._auto is None:
718
+ self._auto = threading.Thread(target=self._auto_refresh_loop, daemon=True)
719
+ self._auto.start()
720
+ try:
721
+ return self.app.run()
722
+ finally:
723
+ self._bg_stop.set()
724
+
725
+
726
+ def run(entries: list[SessionEntry], args) -> SessionEntry | None:
727
+ return SessionPicker(entries, args).run()