"
+ * (hook / import creation paths). A suffix that is a real title — or the
+ * user's own rename — makes the name non-auto and it is never overwritten.
+ */
+function isAutoMainAgentName(name, sessionId, cwd) {
+ if (!name || !name.trim()) return true;
+ if (name === "Main Agent") return true;
+ const prefix = "Main Agent - ";
+ if (name.startsWith(prefix)) return isAutoSessionName(name.slice(prefix.length), sessionId, cwd);
+ return false;
+}
+
/**
* Keep sessions.name in sync with the transcript's human-readable title.
* Source of truth lives in the JSONL as `custom-title` (explicit /rename,
@@ -164,8 +190,12 @@ function isAutoSessionName(name, sessionId, cwd) {
* the TranscriptCache surfaces on every extract. Precedence: an explicit
* custom title always wins; an ai-title only fills in when the current name is
* still an auto/placeholder label (so a name the user set in the dashboard or
- * via /rename is never clobbered by the auto-generated title). Broadcasts
- * session_updated only on a real change so the UI updates in real time.
+ * via /rename is never clobbered by the auto-generated title). A name that
+ * equals the first-user-prompt descriptor (applied by
+ * applyFirstUserDescriptor when no title existed yet) counts as replaceable
+ * too — the descriptor sits BELOW both title kinds, so a later ai-title must
+ * still be able to take over. Broadcasts session_updated only on a real
+ * change so the UI updates in real time.
*/
function syncSessionName(session, result) {
if (!session || !result) return;
@@ -173,7 +203,10 @@ function syncSessionName(session, result) {
const ai = result.aiTitle && result.aiTitle.trim();
const desired = custom || ai || null;
if (!desired) return;
- if (!custom && !isAutoSessionName(session.name, session.id, session.cwd)) return;
+ const replaceable =
+ isAutoSessionName(session.name, session.id, session.cwd) ||
+ session.name === firstUserLabel(result);
+ if (!custom && !replaceable) return;
const upd = stmts.updateSessionName.run(desired, session.id, desired);
if (upd.changes > 0) {
const refreshed = stmts.getSession.get(session.id);
@@ -181,6 +214,52 @@ function syncSessionName(session, result) {
}
}
+/**
+ * Fallback descriptor from the session's first user prompt (issue #201).
+ * Fills sessions.name and the main agent's name/task ONLY while those fields
+ * still hold their auto-generated placeholders, so a custom-title, ai-title,
+ * or user-set name is never clobbered. Must run strictly AFTER
+ * syncSessionName within the same pass: title sync gets first claim on the
+ * name, and this helper re-reads the rows so it sees the result. Idempotent —
+ * once applied (or once real names exist), every subsequent call is a no-op
+ * with no broadcast.
+ */
+function applyFirstUserDescriptor(sessionId, result) {
+ const label = firstUserLabel(result);
+ if (!label) return;
+
+ const session = stmts.getSession.get(sessionId);
+ if (session && isAutoSessionName(session.name, session.id, session.cwd)) {
+ const upd = stmts.updateSessionName.run(label, session.id, label);
+ if (upd.changes > 0) {
+ const refreshed = stmts.getSession.get(session.id);
+ if (refreshed) broadcast("session_updated", refreshed);
+ }
+ }
+
+ const mainAgent = getMainAgent(sessionId);
+ if (!mainAgent) return;
+ const desiredName = `Main Agent - ${label}`;
+ const fillName =
+ isAutoMainAgentName(mainAgent.name, sessionId, session?.cwd) && mainAgent.name !== desiredName;
+ const fillTask = !mainAgent.task || !String(mainAgent.task).trim();
+ if (!fillName && !fillTask) return;
+ // updateAgent writes current_tool VERBATIM (no COALESCE) — pass the
+ // existing value through, or this out-of-band update would wipe an
+ // in-flight tool mid-turn.
+ stmts.updateAgent.run(
+ fillName ? desiredName : null,
+ null,
+ fillTask ? result.firstUserMessage : null,
+ mainAgent.current_tool,
+ null,
+ null,
+ mainAgent.id
+ );
+ const refreshedAgent = stmts.getAgent.get(mainAgent.id);
+ if (refreshedAgent) broadcast("agent_updated", refreshedAgent);
+}
+
const processEvent = db.transaction((hookType, data) => {
const sessionId = data.session_id;
if (!sessionId) return null;
@@ -602,6 +681,12 @@ const processEvent = db.transaction((hookType, data) => {
// so we see any name set earlier in this same transaction.
syncSessionName(stmts.getSession.get(sessionId), result);
+ // Then let the first user prompt fill whatever placeholders remain
+ // (session name, main agent name/task). Runs on every transcript-bearing
+ // event — live on UserPromptSubmit, and as backfill for sessions that
+ // never get a title (including imported ones) on any later event.
+ applyFirstUserDescriptor(sessionId, result);
+
// Register compaction agents and events.
// Each isCompactSummary entry in the JSONL = one compaction that occurred.
// Deduplicate by uuid so we only create once per compaction.
@@ -1032,9 +1117,14 @@ function watchdogCheck() {
// Pick up a /rename or fresh ai-title even when no hook fired for it —
// a session left idle right after /rename has no further events, so the
- // watchdog is the path that surfaces the new name within ~15s.
+ // watchdog is the path that surfaces the new name within ~15s. The
+ // first-user-prompt descriptor backfills remaining placeholders here for
+ // the same reason (idle sessions get no further hook events).
const fullSess = stmts.getSession.get(sess.id);
- if (fullSess) syncSessionName(fullSess, result);
+ if (fullSess) {
+ syncSessionName(fullSess, result);
+ applyFirstUserDescriptor(sess.id, result);
+ }
const mainAgent = db
.prepare("SELECT * FROM agents WHERE session_id = ? AND type = 'main' LIMIT 1")
diff --git a/wiki/i18n-content.js b/wiki/i18n-content.js
index 2eb2a1f6..00a3b2a0 100644
--- a/wiki/i18n-content.js
+++ b/wiki/i18n-content.js
@@ -18,8 +18,8 @@ window.__WIKI_CONTENT_I18N = {
"两个标签页：Monitor 显示概览统计、带可折叠 subagent 层级的活动 agent 卡片，以及一个其条目数量会填满可用视口高度的最近活动流。Health 渲染一个综合系统健康评分环、存储引擎环形图、缓存/错误/成功仪表盘、工具调用条形图、subagent 有效性比率、模型 token 分布以及压缩统计。两个标签页都通过 WebSocket 推送每 5 秒自动刷新一次，因此无需手动重新加载视图始终保持最新。",
"Toggle between Agents (Working / Waiting / Completed / Error) and Sessions (Active / Waiting / Completed / Error / Abandoned) swim lanes. A yellow Waiting column flags items sitting on the user — fresh prompt, between turns, or permission gate. Hover any column header for lifecycle tooltips explaining each state transition. Cards surface model name, cumulative cost, and the current tool being called. Counts update in real time via WebSocket so the board is always in sync with the live event store.":
"在 Agents（Working / Waiting / Completed / Error）和 Sessions（Active / Waiting / Completed / Error / Abandoned）泳道之间切换。黄色的 Waiting 列标记出等待用户的条目——刚收到的提示、回合之间，或权限关卡。将鼠标悬停在任意列标题上可查看解释每次状态转换的生命周期提示。卡片会展示模型名称、累计成本以及当前正在调用的工具。计数通过 WebSocket 实时更新，因此看板始终与实时事件存储保持同步。",
- "Server-paginated table of every recorded session — each page fetches only its slice so cost computation stays bounded no matter how many sessions exist. Case-insensitive search across id, name, and cwd runs server-side with a 300 ms debounce; the status filter composes with search for precise narrowing. Each row shows the session's real name (synced live from the transcript — a /rename or claude -n title, else the auto title, with a short-ID fallback), status badge, agent count, duration, model, and estimated cost. Click any row to drill into the full session detail view with conversation transcript and agent hierarchy.":
- "服务端分页的表格，列出每一个已记录的会话——每一页只获取它对应的那一段数据，因此无论存在多少会话，成本计算都保持有界。针对 id、name 和 cwd 的不区分大小写搜索在服务端运行，并带有 300 ms 防抖；状态过滤器可与搜索组合以实现精确缩小范围。每一行显示会话的真实名称（从 transcript 实时同步——/rename 或 claude -n 标题，否则使用自动标题，并回退到短 ID）、状态徽章、agent 数量、时长、模型和预估成本。点击任意行即可深入查看完整的会话详情视图，包含对话记录和 agent 层级。",
+ "Server-paginated table of every recorded session — each page fetches only its slice so cost computation stays bounded no matter how many sessions exist. Case-insensitive search across id, name, and cwd runs server-side with a 300 ms debounce; the status filter composes with search for precise narrowing. Each row shows the session's real name (synced live from the transcript — a /rename or claude -n title, else the auto title, else the first user prompt, with a short-ID fallback), status badge, agent count, duration, model, and estimated cost. Click any row to drill into the full session detail view with conversation transcript and agent hierarchy.":
+ "服务端分页的表格，列出每一个已记录的会话——每一页只获取它对应的那一段数据，因此无论存在多少会话，成本计算都保持有界。针对 id、name 和 cwd 的不区分大小写搜索在服务端运行，并带有 300 ms 防抖；状态过滤器可与搜索组合以实现精确缩小范围。每一行显示会话的真实名称（从 transcript 实时同步——/rename 或 claude -n 标题，否则使用自动标题，再否则使用首条用户 prompt，并回退到短 ID）、状态徽章、agent 数量、时长、模型和预估成本。点击任意行即可深入查看完整的会话详情视图，包含对话记录和 agent 层级。",
"Per-session deep dive with a collapsible agent hierarchy tree and a full chronological event timeline showing every tool call name and summary. An overview panel at the top surfaces tile counters for events, tool calls, subagents, compactions, errors, and duration. Top-tool usage bars and a subagent type breakdown give quick distribution reads. The conversation viewer renders markdown with syntax highlighting, per-tool styled blocks, slash-command pills with their captured TUI output, and inline session-rename markers. Export the entire session as JSON or share the permalink for async review.":
"针对单个会话的深入剖析，配有可折叠的 agent 层级树和一条完整的按时间排序的事件时间线，显示每一次工具调用的名称和摘要。顶部的概览面板展示事件、工具调用、subagent、压缩、错误和时长的磁贴计数器。顶部工具使用条形图和 subagent 类型细分让你快速读取分布情况。对话查看器渲染带语法高亮的 markdown、按工具分类的样式化代码块、带其捕获的 TUI 输出的斜杠命令气泡，以及内联的会话重命名标记。可将整个会话导出为 JSON，或分享永久链接以供异步审阅。",
"A rules-based alerting engine evaluates the live event stream server-side: event pattern (match event type / tool / summary text, optionally N matches within a time window), inactivity, stuck agent, and token threshold — each with per-(rule, session, agent) cooldown dedup. Fired alerts surface in a live feed and fan out to 14 first-class webhook providers — Slack, Discord, Teams, Google Chat, Mattermost, Rocket.Chat, Telegram, PagerDuty, Opsgenie, Splunk On-Call, Zapier, Make, n8n, Pipedream — plus any generic JSON endpoint (with optional HMAC-SHA256 signing and custom headers). Delivery is detached and fail-safe with a request timeout, bounded retry/backoff, secret redaction, a one-click test probe, and a per-target delivery log. Rules and channels are managed together in Settings → Alerts.":
@@ -38,8 +38,8 @@ window.__WIKI_CONTENT_I18N = {
"可从三种来源导入已有的 Claude Code 会话——重新扫描默认的 ~/.claude/projects 文件夹、扫描磁盘上的任意绝对路径，或通过 Settings → Import History 拖放 .jsonl、.zip、.tar.gz 和 .gz 归档文件。所有路径都汇入服务器用于实时 hook 的同一条摄取管道，因此导入的 token 和按模型计的成本与实时捕获完全一致。通过会话 ID 去重，重复导入是幂等的；归档解压则会防范路径遍历与 zip 炸弹膨胀。",
"The startup auto-import of ~/.claude/projects is one-time and marker-gated, so a project folder created after first launch — whose sessions never flow through hooks (for example with host-only hooks disabled) — would stay invisible until a manual rescan. A background sync closes that gap with three triggers sharing one mtime cache and a single coalesced sweep: an immediate sweep at startup, a debounced fs.watch (recursive on macOS and Windows; root plus immediate child folders on Linux to avoid the userland recursive-watcher hazard) that fires the moment a new session file or project folder appears, and a periodic safety-net poll tunable via DASHBOARD_SESSION_SYNC_MS (default 30000 ms; 0 disables the poll while leaving the watcher running). Each sweep re-parses only files whose mtime advanced and broadcasts session_created / session_updated (plus the main agent) so the UI refreshes live, while an already-imported unchanged session is skipped without re-parsing.":
"对 ~/.claude/projects 的启动时自动导入是一次性的，并由标记控制，因此首次启动之后创建的项目文件夹——其会话从不经由 hook 流入（例如禁用了仅主机的 hook）——在手动重新扫描之前都不会显示。一个后台同步通过三个共享同一个 mtime 缓存和单次合并扫描的触发器弥补这一缺口：启动时的一次立即扫描、一个去抖动的 fs.watch（在 macOS 和 Windows 上递归；在 Linux 上监听根目录加各个直接子文件夹，以规避用户态递归监听器的隐患），它会在出现新的会话文件或项目文件夹的那一刻触发，以及一个可通过 DASHBOARD_SESSION_SYNC_MS 调节的周期性安全网轮询（默认 30000 ms；0 会禁用轮询但保留监听器）。每次扫描仅重新解析 mtime 已推进的文件，并广播 session_created / session_updated（外加主 agent），从而让 UI 实时刷新；而对于已导入且未变更的会话则会被跳过，不再重新解析。",
- "Incremental JSONL reader shared across the hook handler, compaction scanner, conversation viewer, and import pipeline. Byte-offset tracking skips already-parsed content; cache hits short-circuit disk I/O so even sessions with tens of thousands of turns stay fast. It also extracts the live session title (custom-title / ai-title) so renames surface in real time.":
- "增量式 JSONL 读取器，在 hook 处理器、压缩扫描器、对话查看器和导入管道之间共享。字节偏移跟踪会跳过已解析的内容；缓存命中会短路磁盘 I/O，因此即便是有数万个回合的会话也能保持快速。它还会提取实时的会话标题（custom-title / ai-title），使重命名能实时呈现。",
+ "Incremental JSONL reader shared across the hook handler, compaction scanner, conversation viewer, and import pipeline. Byte-offset tracking skips already-parsed content; cache hits short-circuit disk I/O so even sessions with tens of thousands of turns stay fast. It also extracts the live session title (custom-title / ai-title) so renames surface in real time, plus the first user prompt as a fallback descriptor for placeholder-named sessions and agents.":
+ "增量式 JSONL 读取器，在 hook 处理器、压缩扫描器、对话查看器和导入管道之间共享。字节偏移跟踪会跳过已解析的内容；缓存命中会短路磁盘 I/O，因此即便是有数万个回合的会话也能保持快速。它还会提取实时的会话标题（custom-title / ai-title），使重命名能实时呈现，并提取首条用户 prompt，作为占位命名的会话与 agent 的后备描述符。",
"LRU eviction of cold session buffers plus a tail-cap on per-entry growable arrays (turn durations, API errors, compaction entries). A session that runs for days cannot grow a single cache entry without bound, and each entry stores its parsed result only once — no shadow copy.":
"对冷会话缓冲区进行 LRU 淘汰，并对每个条目的可增长数组（回合时长、API 错误、压缩条目）设置尾部上限。运行数天的会话也无法让任何单个缓存条目无限增长，而且每个条目只存储一次其解析结果——没有影子副本。",
"The periodic compaction sweep reads each active session's transcript path directly from sessions.transcript_path (a partial index covers exactly those rows), so the work is O(active sessions) instead of a json_extract scan over the whole events table.":
@@ -1213,8 +1213,8 @@ window.__WIKI_CONTENT_I18N = {
"Hai tab: Monitor hiển thị số liệu tổng quan, các thẻ agent đang hoạt động với cây phân cấp subagent có thể thu gọn, và một luồng hoạt động gần đây có số lượng mục lấp đầy chiều cao viewport khả dụng. Health hiển thị một vòng điểm sức khỏe hệ thống tổng hợp, biểu đồ vành khuyên về storage engine, các đồng hồ đo cache/lỗi/thành công, các thanh lời gọi công cụ, tỷ lệ hiệu quả của subagent, phân bố token theo mô hình, và số liệu thống kê nén. Cả hai tab tự động làm mới mỗi 5 giây qua WebSocket push nên chế độ xem luôn cập nhật mà không cần tải lại thủ công.",
"Toggle between Agents (Working / Waiting / Completed / Error) and Sessions (Active / Waiting / Completed / Error / Abandoned) swim lanes. A yellow Waiting column flags items sitting on the user — fresh prompt, between turns, or permission gate. Hover any column header for lifecycle tooltips explaining each state transition. Cards surface model name, cumulative cost, and the current tool being called. Counts update in real time via WebSocket so the board is always in sync with the live event store.":
"Chuyển đổi giữa các làn Agents (Working / Waiting / Completed / Error) và Sessions (Active / Waiting / Completed / Error / Abandoned). Một cột Waiting màu vàng đánh dấu các mục đang chờ người dùng — lời nhắc mới, giữa các lượt, hoặc cổng cấp quyền. Di chuột qua bất kỳ tiêu đề cột nào để xem các chú giải về vòng đời giải thích từng lần chuyển trạng thái. Các thẻ hiển thị tên mô hình, chi phí tích lũy, và công cụ đang được gọi hiện tại. Số đếm cập nhật theo thời gian thực qua WebSocket nên bảng luôn đồng bộ với kho sự kiện trực tiếp.",
- "Server-paginated table of every recorded session — each page fetches only its slice so cost computation stays bounded no matter how many sessions exist. Case-insensitive search across id, name, and cwd runs server-side with a 300 ms debounce; the status filter composes with search for precise narrowing. Each row shows the session's real name (synced live from the transcript — a /rename or claude -n title, else the auto title, with a short-ID fallback), status badge, agent count, duration, model, and estimated cost. Click any row to drill into the full session detail view with conversation transcript and agent hierarchy.":
- "Bảng phân trang phía máy chủ của mọi phiên đã ghi — mỗi trang chỉ lấy phần dữ liệu của nó nên việc tính chi phí luôn bị giới hạn bất kể có bao nhiêu phiên tồn tại. Tìm kiếm không phân biệt hoa thường trên id, name và cwd chạy ở phía máy chủ với độ trễ chống dội 300 ms; bộ lọc trạng thái kết hợp với tìm kiếm để thu hẹp chính xác. Mỗi hàng hiển thị tên thật của phiên (đồng bộ trực tiếp từ bản ghi — tiêu đề /rename hoặc claude -n, nếu không thì dùng tiêu đề tự động, với dự phòng là ID ngắn), huy hiệu trạng thái, số lượng agent, thời lượng, mô hình và chi phí ước tính. Nhấp vào bất kỳ hàng nào để đi sâu vào chế độ xem chi tiết đầy đủ của phiên với bản ghi hội thoại và phân cấp agent.",
+ "Server-paginated table of every recorded session — each page fetches only its slice so cost computation stays bounded no matter how many sessions exist. Case-insensitive search across id, name, and cwd runs server-side with a 300 ms debounce; the status filter composes with search for precise narrowing. Each row shows the session's real name (synced live from the transcript — a /rename or claude -n title, else the auto title, else the first user prompt, with a short-ID fallback), status badge, agent count, duration, model, and estimated cost. Click any row to drill into the full session detail view with conversation transcript and agent hierarchy.":
+ "Bảng phân trang phía máy chủ của mọi phiên đã ghi — mỗi trang chỉ lấy phần dữ liệu của nó nên việc tính chi phí luôn bị giới hạn bất kể có bao nhiêu phiên tồn tại. Tìm kiếm không phân biệt hoa thường trên id, name và cwd chạy ở phía máy chủ với độ trễ chống dội 300 ms; bộ lọc trạng thái kết hợp với tìm kiếm để thu hẹp chính xác. Mỗi hàng hiển thị tên thật của phiên (đồng bộ trực tiếp từ bản ghi — tiêu đề /rename hoặc claude -n, nếu không thì dùng tiêu đề tự động, nếu vẫn không có thì prompt đầu tiên của người dùng, với dự phòng là ID ngắn), huy hiệu trạng thái, số lượng agent, thời lượng, mô hình và chi phí ước tính. Nhấp vào bất kỳ hàng nào để đi sâu vào chế độ xem chi tiết đầy đủ của phiên với bản ghi hội thoại và phân cấp agent.",
"Per-session deep dive with a collapsible agent hierarchy tree and a full chronological event timeline showing every tool call name and summary. An overview panel at the top surfaces tile counters for events, tool calls, subagents, compactions, errors, and duration. Top-tool usage bars and a subagent type breakdown give quick distribution reads. The conversation viewer renders markdown with syntax highlighting, per-tool styled blocks, slash-command pills with their captured TUI output, and inline session-rename markers. Export the entire session as JSON or share the permalink for async review.":
"Phân tích sâu theo từng phiên với một cây phân cấp agent có thể thu gọn và một dòng thời gian sự kiện đầy đủ theo trình tự thời gian, hiển thị tên và bản tóm tắt của mỗi lần gọi công cụ. Một bảng tổng quan ở trên cùng hiển thị các bộ đếm dạng ô cho sự kiện, lời gọi công cụ, subagent, lần nén, lỗi và thời lượng. Các thanh sử dụng công cụ hàng đầu và bảng phân tích theo loại subagent cho phép đọc nhanh phân bố. Trình xem hội thoại hiển thị markdown với tô sáng cú pháp, các khối có kiểu dáng riêng theo từng công cụ, pill lệnh gạch chéo kèm output TUI đã ghi lại, và chỉ báo đổi tên phiên nội tuyến. Xuất toàn bộ phiên dưới dạng JSON hoặc chia sẻ liên kết cố định để xem xét bất đồng bộ.",
"A rules-based alerting engine evaluates the live event stream server-side: event pattern (match event type / tool / summary text, optionally N matches within a time window), inactivity, stuck agent, and token threshold — each with per-(rule, session, agent) cooldown dedup. Fired alerts surface in a live feed and fan out to 14 first-class webhook providers — Slack, Discord, Teams, Google Chat, Mattermost, Rocket.Chat, Telegram, PagerDuty, Opsgenie, Splunk On-Call, Zapier, Make, n8n, Pipedream — plus any generic JSON endpoint (with optional HMAC-SHA256 signing and custom headers). Delivery is detached and fail-safe with a request timeout, bounded retry/backoff, secret redaction, a one-click test probe, and a per-target delivery log. Rules and channels are managed together in Settings → Alerts.":
@@ -1233,8 +1233,8 @@ window.__WIKI_CONTENT_I18N = {
"Nhập các phiên Claude Code hiện có từ ba nguồn — quét lại thư mục mặc định ~/.claude/projects, quét bất kỳ đường dẫn tuyệt đối nào trên đĩa, hoặc kéo-thả các tệp lưu trữ .jsonl, .zip, .tar.gz và .gz qua Settings → Import History. Tất cả các đường dẫn đều đổ vào cùng một đường ống nạp mà máy chủ dùng cho các hook trực tiếp, nên token đã nhập và chi phí theo từng model khớp chính xác với việc thu thập theo thời gian thực. Việc nhập lại là bất biến nhờ khử trùng lặp theo session-ID, và quá trình giải nén được bảo vệ chống path traversal cùng sự bùng nổ kiểu zip-bomb.",
"The startup auto-import of ~/.claude/projects is one-time and marker-gated, so a project folder created after first launch — whose sessions never flow through hooks (for example with host-only hooks disabled) — would stay invisible until a manual rescan. A background sync closes that gap with three triggers sharing one mtime cache and a single coalesced sweep: an immediate sweep at startup, a debounced fs.watch (recursive on macOS and Windows; root plus immediate child folders on Linux to avoid the userland recursive-watcher hazard) that fires the moment a new session file or project folder appears, and a periodic safety-net poll tunable via DASHBOARD_SESSION_SYNC_MS (default 30000 ms; 0 disables the poll while leaving the watcher running). Each sweep re-parses only files whose mtime advanced and broadcasts session_created / session_updated (plus the main agent) so the UI refreshes live, while an already-imported unchanged session is skipped without re-parsing.":
"Việc tự động nhập ~/.claude/projects lúc khởi động chỉ chạy một lần và được kiểm soát bằng marker, nên một thư mục dự án được tạo sau lần khởi chạy đầu tiên — mà các phiên của nó không bao giờ chảy qua hook (ví dụ khi đã tắt hook chỉ-dành-cho-máy-chủ) — sẽ không hiển thị cho tới khi quét lại thủ công. Một tiến trình đồng bộ nền lấp khoảng trống đó bằng ba trình kích hoạt cùng dùng chung một bộ nhớ đệm mtime và một lượt quét gộp duy nhất: một lượt quét tức thì lúc khởi động, một fs.watch có khử dội (đệ quy trên macOS và Windows; theo dõi thư mục gốc cộng từng thư mục con trực tiếp trên Linux để tránh hiểm họa của trình theo dõi đệ quy ở tầng người dùng) kích hoạt ngay khoảnh khắc một tệp phiên hoặc thư mục dự án mới xuất hiện, và một lượt thăm dò an toàn định kỳ có thể điều chỉnh qua DASHBOARD_SESSION_SYNC_MS (mặc định 30000 ms; 0 tắt thăm dò nhưng vẫn giữ trình theo dõi chạy). Mỗi lượt quét chỉ phân tích lại những tệp có mtime tiến lên và phát đi session_created / session_updated (cùng với agent chính) để UI làm mới trực tiếp, trong khi một phiên đã nhập và không thay đổi thì được bỏ qua mà không phân tích lại.",
- "Incremental JSONL reader shared across the hook handler, compaction scanner, conversation viewer, and import pipeline. Byte-offset tracking skips already-parsed content; cache hits short-circuit disk I/O so even sessions with tens of thousands of turns stay fast. It also extracts the live session title (custom-title / ai-title) so renames surface in real time.":
- "Trình đọc JSONL tăng dần được chia sẻ giữa trình xử lý hook, trình quét nén, trình xem hội thoại và đường ống nhập. Việc theo dõi byte-offset bỏ qua nội dung đã phân tích; các lần trúng cache rút ngắn I/O đĩa nên ngay cả những phiên có hàng chục nghìn lượt vẫn chạy nhanh. Nó cũng trích xuất tiêu đề phiên trực tiếp (custom-title / ai-title) để việc đổi tên hiển thị theo thời gian thực.",
+ "Incremental JSONL reader shared across the hook handler, compaction scanner, conversation viewer, and import pipeline. Byte-offset tracking skips already-parsed content; cache hits short-circuit disk I/O so even sessions with tens of thousands of turns stay fast. It also extracts the live session title (custom-title / ai-title) so renames surface in real time, plus the first user prompt as a fallback descriptor for placeholder-named sessions and agents.":
+ "Trình đọc JSONL tăng dần được chia sẻ giữa trình xử lý hook, trình quét nén, trình xem hội thoại và đường ống nhập. Việc theo dõi byte-offset bỏ qua nội dung đã phân tích; các lần trúng cache rút ngắn I/O đĩa nên ngay cả những phiên có hàng chục nghìn lượt vẫn chạy nhanh. Nó cũng trích xuất tiêu đề phiên trực tiếp (custom-title / ai-title) để việc đổi tên hiển thị theo thời gian thực, cùng prompt đầu tiên của người dùng làm mô tả dự phòng cho các phiên và agent còn mang tên placeholder.",
"LRU eviction of cold session buffers plus a tail-cap on per-entry growable arrays (turn durations, API errors, compaction entries). A session that runs for days cannot grow a single cache entry without bound, and each entry stores its parsed result only once — no shadow copy.":
"Loại bỏ theo LRU các bộ đệm phiên nguội cùng với một giới hạn đuôi trên các mảng có thể tăng trưởng theo từng mục (thời lượng lượt, lỗi API, mục nén). Một phiên chạy nhiều ngày cũng không thể làm một mục cache đơn lẻ tăng không giới hạn, và mỗi mục chỉ lưu kết quả đã phân tích của nó một lần — không có bản sao bóng.",
"The periodic compaction sweep reads each active session's transcript path directly from sessions.transcript_path (a partial index covers exactly those rows), so the work is O(active sessions) instead of a json_extract scan over the whole events table.":
diff --git a/wiki/index.html b/wiki/index.html
index 3024ff96..84aec91a 100644
--- a/wiki/index.html
+++ b/wiki/index.html
@@ -923,8 +923,9 @@ Sessions Table
name, and cwd runs server-side with a 300 ms
debounce; the status filter composes with search for precise narrowing.
Each row shows the session's real name (synced live from the transcript — a
- /rename or claude -n title, else the auto title, with
- a short-ID fallback), status badge, agent count, duration, model, and estimated
+ /rename or claude -n title, else the auto title,
+ else the first user prompt, with a short-ID fallback), status badge, agent
+ count, duration, model, and estimated
cost. Click any row to drill into the full session detail view with conversation
transcript and agent hierarchy.
@@ -1076,7 +1077,8 @@ Transcript Cache
already-parsed content; cache hits short-circuit disk I/O so even sessions
with tens of thousands of turns stay fast. It also extracts the live session
title (custom-title / ai-title) so renames surface in
- real time.
+ real time, plus the first user prompt as a fallback descriptor for
+ placeholder-named sessions and agents.
@@ -6073,7 +6075,7 @@
Technology Choices
-
+