dsh-activity-pane 0.11.0 → 0.12.0

package/.dsh-plugin/client.js

@@ -1538,7 +1538,7 @@ function mainTitle(byId, id) {
  * 把 sessions/workspaces 快照构建成窗格条目列表（有序、已含层级与显示过滤）。
  * 返回数组的每一项：
  *   { id, parentId?, depth, kind: 'running'|'awaiting'|'subagent', title, workspaceTitle, workspaceKey,
- *     isCurrent, pendingText?, descendantActive? }
+ *     isCurrent, pendingText?, descendantActive?, stateAt? }
  * kind 规则：
  *   - 主会话 running（且无 pending）或处于委托周期（含后代耗尽空窗）→ 'running'
  *   - 主会话 pendingInteraction / completed / errorReminder → 'awaiting'（等待用户行动）
@@ -1558,6 +1558,9 @@ function mainTitle(byId, id) {
  * 尚未结束、`lastTurnEnd` 仍是上一回合的旧时刻，不能作为等待进行中会话的排序键（T-141）；
  * 非 Map、缺失记录或值非有限数字（含 null/空串等 Number 归一为 0 的形状）均视为无数据，
  * 回落宿主列表时间。
+ * stateAt（进入当前等待行动状态的时刻，R-01-002/AC-14）：仅 awaiting 条目携带，与排序键
+ * 共用 enterStateAt 单点口径——pending 取 waitingStarts，完成/错误提醒取 completions.lastTurnEnd；
+ * 显示侧不回落宿主列表时间——排序键缺失时的回落仅用于排序，显示以 null（不显示）承载。
  */
 function buildEntries(snapshot, workspaceItems, detailsById = {}, completions = null, delegatingIds = null, archivedIds = [], waitingStarts = null) {
 	const byId = isRecord(snapshot) && isRecord(snapshot.byId) ? snapshot.byId : {};
@@ -1627,16 +1630,20 @@ function buildEntries(snapshot, workspaceItems, detailsById = {}, completions =
 		if (typeof value !== "number") return null;
 		return Number.isFinite(value) ? value : null;
 	};
+	// 进入状态时刻单点（R-01-002/AC-14，排序键 R-01-001/AC-07 同源）：阻塞等待取
+	// waitingStarts，完成/错误提醒取最近一次回合结束登记时刻；有效性口径单点收紧——
+	// 仅真实数字作数，Number(null)/Number("") 归一的 0 陷阱两侧同样不作数。
+	const enterStateAt = (id, pending) => {
+		if (pending) return waitingStartTime(id);
+		const end = completionFor(id, completions)?.lastTurnEnd;
+		return typeof end === "number" && Number.isFinite(end) ? end : null;
+	};
 	const sortTime = (id) => {
 		if (isRunningEntry(id)) return instructionTime(byId[id]);
 		const m = meta.get(id);
-		if (m !== undefined && m.pending) {
-			const start = waitingStartTime(id);
-			return start ?? instructionTime(byId[id]);
-		}
-		const record = completionFor(id, completions);
-		const end = isRecord(record) ? Number(record.lastTurnEnd) : NaN;
-		return Number.isFinite(end) ? end : instructionTime(byId[id]);
+		const entered = m !== undefined ? enterStateAt(id, m.pending) : null;
+		// 排序键缺失回落宿主列表时间；回落仅用于排序，显示侧以 null 承载（见 stateAt）。
+		return entered ?? instructionTime(byId[id]);
 	};
 	rootIds.sort((a, b) => {
 		const byGroup = Number(isRunningEntry(b)) - Number(isRunningEntry(a));
@@ -1670,6 +1677,10 @@ function buildEntries(snapshot, workspaceItems, detailsById = {}, completions =
 			const doneWait = !m.pending && m.done && !m.running && !m.delegating;
 			const errWait = !m.pending && m.err && !m.running && !m.delegating;
 			const errorNote = entryErrorNote(completionFor(id, completions));
+			// 进入状态时刻（R-01-002/AC-14）：仅 awaiting 条目携带，与排序键共用 enterStateAt
+			// 单点口径；显示侧不回落宿主列表时间，不可得即为 null（节点隐藏），避免把
+			// 回退值冒充真实进入时刻。
+			const stateAt = m.pending || doneWait || errWait ? enterStateAt(id, m.pending) : undefined;
 			const questionPreview =
 				m.pending && m.row.pendingInteraction === "question" ? timelineQuestionPreview(timeline) : undefined;
 			entries.push({
@@ -1714,6 +1725,7 @@ function buildEntries(snapshot, workspaceItems, detailsById = {}, completions =
 						: doneWait
 							? ROUND_DONE_NOTE
 							: undefined,
+				stateAt,
 				questionPreview: m.pending && m.row.pendingInteraction === "question" ? (questionPreview ?? null) : undefined,
 			});
 		}
@@ -1808,6 +1820,8 @@ function cardSignature(entries) {
 			entry.waitClass ?? null,
 			entry.noteText ?? null,
 			entry.questionPreview ?? null,
+			// 进入状态时刻参与签名（R-01-002/AC-14）：数据到达/更替（回填、SSE）驱动重绘。
+			entry.stateAt ?? null,
 			entry.activityAt ?? null,
 			entry.progress ?? null,
 			entry.loadingModel ?? null,
@@ -2674,7 +2688,7 @@ const CLOCK_MS = 1000;
  *  10Hz——事件率随宿主流式 chunk 数增长，显示粒度（秒级时长、块级时间线）无感，
  *  而渲染与 O(日志窗口) 派生不再随刷新率（移动端 120Hz）与事件率线性放大（T-127）。 */
 const SYNC_MIN_INTERVAL_MS = 100;
-/** 历史卡相对时间刷新周期；无需每秒重绘整列。 */
+/** 历史卡相对时间与等待卡状态年龄的刷新周期；无需每秒重绘整列。 */
 const RECENT_TIME_REFRESH_MS = 60_000;
 /** 冷数据读取并发池上限：慢网下避免几十张卡片的 models/history 一次性挤占通道。 */
 const LOAD_CONCURRENCY = 3;
@@ -3301,6 +3315,13 @@ body:not([data-ds-dark-theme]) [data-dsh-activity-pane] .dap-workspace {
 [data-dsh-activity-pane] .dap-await-head {
   display: flex; align-items: center; gap: 8px; align-self: stretch; min-width: 0;
 }
+/* 进入状态相对年龄（R-01-002/AC-14）：胶囊右侧裸相对时间，弱化色调不与胶囊争抢，
+   不参与等待脉冲；进入状态时刻不可得时隐藏节点，不以虚假时刻冒充。 */
+[data-dsh-activity-pane] .dap-await-age {
+  flex: none; font-size: 10px; line-height: 14px; white-space: nowrap;
+  color: color-mix(in srgb, currentColor 55%, transparent);
+}
+[data-dsh-activity-pane] .dap-await-age[hidden] { display: none; }
 [data-dsh-activity-pane] .dap-note-row {
   display: flex; align-items: center; gap: 6px; min-width: 0; align-self: stretch;
 }
@@ -3797,6 +3818,12 @@ function fmtRecentTime(ts, now = Date.now()) {
 	}
 }
 
+/** 等待卡状态年龄文案（R-01-002/AC-14）：进入状态时刻的裸相对时间，单点派生；
+ *  时刻不可得或差值为负（时钟偏差）返回空串（节点隐藏）。 */
+function awaitAgeText(entry, now = Date.now()) {
+	return Number.isFinite(entry?.stateAt) ? fmtRelativeAge(now - entry.stateAt) : "";
+}
+
 /** 读取持久化列宽：缺失/非法/越界值经 clampPaneWidth 归一；localStorage 不可用（隐私模式）静默回退默认（R-01-015/AC-04）。 */
 function readStoredPaneWidth() {
 	try {
@@ -4920,9 +4947,12 @@ function apply(ctx) {
 		noteRow.querySelector(".dap-badge")?.remove();
 		const capsule = makeEl("div", "dap-capsule");
 		capsule.append(makeEl("span", "dap-capsule-icon"), makeEl("span", "dap-capsule-text"));
+		// 与新版骨架同形：胶囊行含类型胶囊与状态年龄段（R-01-002/AC-14）。
+		const awaitHead = makeEl("div", "dap-await-head");
+		awaitHead.append(capsule, makeEl("span", "dap-await-age"));
 		const foot = makeEl("div", "dap-foot");
 		noteRow.replaceWith(foot);
-		foot.append(capsule, noteRow);
+		foot.append(awaitHead, noteRow);
 	}
 
 	/** 进度行骨架（运行卡与子代理卡共用，R-01-009/AC-06、AC-14）：可伸缩轨道 + 固定宽百分比。 */
@@ -4993,7 +5023,8 @@ function apply(ctx) {
 			const noteRow = makeEl("div", "dap-note-row");
 			noteRow.append(makeEl("div", "dap-note"), makeConfirmButton());
 			const awaitHead = makeEl("div", "dap-await-head");
-			awaitHead.append(capsule);
+			// 状态年龄（R-01-002/AC-14）：进入状态时刻的裸相对时间，胶囊右侧静态显示。
+			awaitHead.append(capsule, makeEl("span", "dap-await-age"));
 			const foot = makeEl("div", "dap-foot");
 			foot.append(awaitHead, noteRow);
 			return [head, row, makeEl("div", "dap-trace"), makeStatsRow(), foot];
@@ -5575,6 +5606,21 @@ function apply(ctx) {
 				iconHolder.dataset.kind = iconKind;
 				iconHolder.replaceChildren(...(iconKind === "" ? [] : [createCapsuleIcon(iconKind)]));
 			}
+			// 状态年龄（R-01-002/AC-14）：进入状态时刻的裸相对时间，紧随胶囊之后；文案由
+			// 帧内 enrichment 单点派生（entry.awaitAge，与签名同时钟源）。陈旧骨架就地
+			// 补建年龄节点（C-043 热装兼容同惯例）。
+			const capsuleEl = el.querySelector(".dap-capsule");
+			if (capsuleEl !== null) {
+				let ageEl = capsuleEl.nextElementSibling;
+				if (ageEl === null || !ageEl.classList.contains("dap-await-age")) {
+					ageEl = makeEl("span", "dap-await-age");
+					capsuleEl.insertAdjacentElement("afterend", ageEl);
+				}
+				const ageText = entry.awaitAge ?? "";
+				if (ageEl.textContent !== ageText) ageEl.textContent = ageText;
+				const ageHidden = ageText === "";
+				if (ageEl.hidden !== ageHidden) ageEl.hidden = ageHidden;
+			}
 		}
 
 		if (entry.kind === "running") {
@@ -5739,7 +5785,7 @@ function apply(ctx) {
 		}
 	}
 
-	/** 历史卡相对时间只需分钟级刷新；无历史卡时停止定时器，避免空窗格常驻唤醒。 */
+	/** 历史卡相对时间与等待卡状态年龄只需分钟级刷新；两者皆无时停止定时器，避免空窗格常驻唤醒。 */
 	function syncRecentTimeClock(wanted) {
 		if (wanted && recentTimeTimer === null) {
 			recentTimeTimer = setInterval(() => queueSync(), RECENT_TIME_REFRESH_MS);
@@ -6327,6 +6373,8 @@ function apply(ctx) {
 			if (entry.kind === "awaiting" && detail) {
 				entry.elapsedMs = memoTurnDuration(detail);
 			}
+			// 状态年龄（R-01-002/AC-14）：帧内单点派生一次，渲染与签名共用同一文案与时钟源。
+			if (entry.kind === "awaiting") entry.awaitAge = awaitAgeText(entry, now);
 			if (detail?.model) {
 				entry.model = detail.model.model;
 				entry.reasoning = detail.model.reasoning;
@@ -6439,7 +6487,8 @@ function apply(ctx) {
 			} : null);
 			if (elapsedMs === null) recentDurationFallbackIds.add(entry.id);
 		}
-		syncRecentTimeClock(recent.length > 0);
+		// 状态年龄（R-01-002/AC-14）与历史卡相对时间同为分钟级：任一存在即保持定时器。
+		syncRecentTimeClock(recent.length > 0 || active.some((entry) => entry.kind === "awaiting" && entry.awaitAge));
 		// 预览只对当前显示的 recent 卡计算（活动卡不显示预览）；快照/历史引用不变时命中缓存。
 		// 完成瞬间的窗口快照可能先有用户消息、后到 agent reply；缺任一预览时补读一次 history。
 		const previewFallbackIds = new Set();
@@ -6502,9 +6551,12 @@ function apply(ctx) {
 		// listState 参与签名：空列表从 pending/error → ready 时卡集合不变，若只比较卡片
 		// 会被提前返回冻结在「加载中」/「列表加载失败」；数量胶囊可见面变化同样需要
 		// 进入渲染，以便与当前可见等待卡末行重新对相（R-01-002/AC-07）。
-		// 历史卡的相对活动时间随分钟级时钟变化，纳入签名后只在文案实际变化时重绘。
+		// 历史卡的相对活动时间与等待卡状态年龄随分钟级时钟变化，纳入签名后只在文案实际变化时重绘。
 		const recentTimeSignature = recent.map((entry) => fmtRecentTime(entry.activityAt));
-		const sig = JSON.stringify([listState, cardSignature(visibleEntries), pulseSurface, recentTimeSignature, densityLevel]);
+		const awaitAgeSignature = active
+			.filter((entry) => entry.kind === "awaiting")
+			.map((entry) => entry.awaitAge ?? "");
+		const sig = JSON.stringify([listState, cardSignature(visibleEntries), pulseSurface, recentTimeSignature, awaitAgeSignature, densityLevel]);
 		if (sig === lastSig) return;
 		const colorByWorkspace = resolveWorkspaceColors(visibleEntries.map((entry) => entry.workspaceKey));
 		// 跨区迁移（双向，R-01-010/AC-07）：DOM 写入前量取旧卡矩形并克隆 ghost。

package/README.md

@@ -21,7 +21,7 @@ This plugin attempts to answer these questions by providing an **activity sessio
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/screenshot-desktop-dark.png">
-    <img src="assets/screenshot-desktop-light.png" width="1000" alt="Activity session overview pane in an isolated demo environment: showing run stats, sub-agent hierarchy, question prompts, completion reminders, error reminders, and recent history">
+    <img src="assets/screenshot-desktop-light.png" width="1000" alt="Activity session overview pane in an isolated demo environment at the default medium display tier: showing live session status with sub-agent hierarchy, question prompts, completion reminders, error reminders, and recent history">
   </picture>
 </p>
 <p align="center"><sub>Mobile <a href="assets/screenshot-mobile-dark.png">dark drawer</a> · <a href="assets/screenshot-mobile-light.png">light drawer</a> of the same clean isolated environment running a simulated coding task</sub></p>
@@ -53,11 +53,14 @@ The npm package ships prebuilt, so no local build step is needed. If the pane do
 - [x] **From floating overlay to docked pane**: on desktop, a persistent edge-docked column is added to the right of the left-sidebar workspaces; on mobile, a fixed drawer hidden by default is expanded via the "Activity" button in the session header, without squeezing the main conversation layout.
 - [x] **No pet icon features**: pet-related features are not supported; the UI focuses on session activity itself.
 - [x] **Native data-source subscription**: directly subscribes to the push snapshots of DSH's native `sessions` / `workspaces` services; the timeline shows at most 4 collapsed work-item rows, keeping the latest user instruction and the work item actually being executed.
-- [x] **Recent session list**: the pane is split into "Active sessions" and "Recent history" areas; inactive main sessions are shown in activity-time batches, and a "Load more..." button at the bottom lets users explicitly reveal older sessions.
-- [x] **Stronger waiting-for-action reminders**: blocked waits, completion reminders, and error reminders are marked with gold, green, and red cards respectively; questions are previewed directly as a question list, and completion reminders are explicitly acknowledged via the "Move to history" button on the card; the state is persisted on the host side and synced across all clients, so refreshing the page or opening another window never loses unacknowledged completion reminders or error reminders not yet overwritten by a new round.
-- [x] **Sub/grandchild session hierarchy**: sub-agents are nested under their parent session with connector lines and compact cards; a parent whose own round has ended but that still has active descendants keeps rendering as running, and disappears from the active area once its sub-agents have ended and no active descendants remain; the history area keeps main sessions only.
-- [x] **Workspace names displayed and factored into ordering**: session cards show a workspace badge with a stable color, and session ordering follows the workspace order in the left sidebar.
-- [x] **Current work and run stats**: active cards show the latest instruction, thinking, and tool calls in a collapsed timeline of at most 4 rows; running cards also show round progress, output rate, cache hit rate, input/output tokens, and run duration, while completed, blocked, and error waits retain the previous round's duration at the end of the token stats row alongside last-known output stats; recent history cards retain the latest completed round's available stats between the reply preview and activity time.
+- [x] **Recent session list**: the pane is split into "Active sessions" and "Recent history" areas; inactive main sessions are shown in activity-time batches with both the absolute date-time and the relative activity time, and a "Load more..." button at the bottom lets users explicitly reveal older sessions.
+- [x] **Stronger waiting-for-action reminders**: blocked waits, completion reminders, and error reminders are marked with gold, green, and red cards respectively; questions are previewed directly as a question list, and completion reminders are explicitly acknowledged via the "Move to history" button on the card; the state is persisted on the host side and synced across all clients, so refreshing the page or opening another window never loses unacknowledged completion reminders or error reminders not yet overwritten by a new round. Each waiting card also shows the relative age of its current state (e.g. "5 min ago") to the right of the status pill, refreshed every minute and hidden when the entry time is unavailable.
+- [x] **Sub/grandchild session hierarchy**: sub-agents are nested under their parent session with connector lines and compact cards; a parent whose own round has ended but that still has active descendants keeps rendering as running, and disappears from the active area once its sub-agents have ended and no active descendants remain; the history area keeps main sessions only. Sub-agent cards show model provenance, the reasoning effort, and round progress.
+- [x] **Workspace badges with stable identity colors**: session cards show a workspace badge whose foreground/background color pair is derived from the workspace identity — adding, removing, or changing other workspaces or refreshing the page never reshuffles existing colors.
+- [x] **Recency-first activity ordering**: running sessions are pinned to the top and sorted by the time of the latest user instruction (newest first); waiting-for-action sessions are sorted by when they entered their waiting state (newest first).
+- [x] **Current work and run stats**: active cards show the latest instruction, thinking, and tool calls in a collapsed timeline of at most 4 rows, with the cumulative run duration on the title row; running cards in the full tier also show round progress, output rate, cache hit rate, and input/output tokens, while completed, blocked, and error waits retain the previous round's duration at the end of the token stats row alongside last-known output stats; recent history cards retain the latest completed round's available stats between the reply preview and activity time.
+- [x] **Three-tier display density**: the toggle in the title-bar tool area cycles every card through compact → medium → full (ascending information density), defaulting to medium — medium keeps the title, workspace badge, the latest timeline row (live for running sessions), and waiting bodies (completion reminders collapse to a single row), while compact keeps title rows only; switching anchors the selected card in place, and the choice persists across refreshes.
+- [x] **Redesigned title bar**: the GitHub repo entry sits in its own area at the far left (hover tip: "Report issues, star & fork"), the collapse-hint icon appears on hover at the right end of the title area, and the display-density toggle lives in the tool area on the right — the two buttons are placed at opposite ends of the title bar to prevent touch mis-taps.
 - [x] **Session navigation**: clicking or keyboard-activating a session card jumps to that session's page, the current session stays highlighted, and selecting a session from DSH's native sidebar brings its pane card fully into view without forced centering.
 - [x] **Session metadata**: session cards show the current model name and reasoning level.
 - [x] **Polished desktop & mobile interactions**: the desktop pane can collapse, be resized by dragging, and remember its width; mobile uses a fixed drawer that does not squeeze the main conversation layout; long lists get independent scrolling and a back-to-top button.

package/README.zh-CN.md

@@ -21,7 +21,7 @@ DSH (DeepSeek Harness) 一大痛点是缺少活动会话与历史会话的管理
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/screenshot-desktop-dark.png">
-    <img src="assets/screenshot-desktop-light.png" width="1000" alt="隔离演示环境中的活动会话总览窗格：展示运行统计、子代理层级、提问等待、完成提醒、错误提醒和最近历史">
+    <img src="assets/screenshot-desktop-light.png" width="1000" alt="隔离演示环境中的活动会话总览窗格（默认中间显示档）：展示实时会话状态、子代理层级、提问等待、完成提醒、错误提醒和最近历史">
   </picture>
 </p>
 <p align="center"><sub>同一干净隔离环境中模拟编程任务的 <a href="assets/screenshot-mobile-dark.png">移动端深色抽屉</a> · <a href="assets/screenshot-mobile-light.png">移动端浅色抽屉</a></sub></p>
@@ -54,10 +54,13 @@ npm 包内置预构建产物，无需本地构建步骤。安装后如窗格未
 - [x] **去除宠物图标功能**：不支持宠物相关功能，界面聚焦于会话活动本身。
 - [x] **原生数据源订阅**：直接订阅 DSH 原生 `sessions` / `workspaces` 服务的推送式快照；时间线最多显示 4 个折叠工作项行，保留最近用户指令与真实执行中的工作项。
 - [x] **增加历史会话列表**：窗格分为「活动会话」和「最近历史」两个区域，非活动主会话按最近活动时间分批呈现；历史区底部提供「加载更多...」按钮，点击后才继续找回更早会话；卡片同时显示绝对日期时间与相对活动时间。
-- [x] **强化等待行动提醒**：阻塞等待、完成提醒与错误提醒分别以金色、绿色和红色卡片标识；提问直接预览问题列表，完成提醒经卡片上的「移入历史」按钮显式确认；状态由宿主侧持久化并在所有客户端间同步，刷新页面或另开窗口不会丢失未确认的完成提醒和尚未被新回合覆盖的错误提醒。
-- [x] **显示子/孙会话层级**：子代理以连接线和紧凑卡片嵌套在母会话下；母会话自身回合结束但仍有活动后代时继续按运行中呈现，子代理结束且没有活动后代后从活动区消失；历史区只保留主会话。
-- [x] **显示工作区名称并参与排序**：会话卡片显示带稳定色彩的工作区徽标，会话排序与左侧边栏中的工作区顺序保持一致。
-- [x] **展示当前工作与运行统计**：活动卡以最多 4 行折叠时间线展示最近指令、思考与工具调用；运行中卡片还显示回合进度、输出速率、缓存命中率、输入/输出 token 与运行时长，进入完成、阻塞或错误等待后在统计行末尾与 tok/s 等内容并列保留上一轮耗时及最后已知统计；迁入最近历史后，历史卡在助手预览与活动时间之间继续保留最后一轮的可用统计。
+- [x] **强化等待行动提醒**：阻塞等待、完成提醒与错误提醒分别以金色、绿色和红色卡片标识；提问直接预览问题列表，完成提醒经卡片上的「移入历史」按钮显式确认；状态由宿主侧持久化并在所有客户端间同步，刷新页面或另开窗口不会丢失未确认的完成提醒和尚未被新回合覆盖的错误提醒。状态胶囊右侧还会显示进入当前状态的相对时间（如「5 分钟前」），随分钟级时钟更新，进入时刻不可得时不显示。
+- [x] **显示子/孙会话层级**：子代理以连接线和紧凑卡片嵌套在母会话下；母会话自身回合结束但仍有活动后代时继续按运行中呈现，子代理结束且没有活动后代后从活动区消失；历史区只保留主会话。子代理卡显示模型溯源、reasoning effort 与回合进度。
+- [x] **工作区徽标稳定配色**：会话卡片显示工作区徽标，前景/背景颜色按工作区身份稳定派生——增删或变更其它工作区、页面刷新均不改变既有配色。
+- [x] **活动会话新近度排序**：运行中会话置顶并按最后用户指令时间从新到旧排列；等待行动会话按进入等待状态的时刻从新到旧排列。
+- [x] **展示当前工作与运行统计**：活动卡以最多 4 行折叠时间线展示最近指令、思考与工具调用，标题行显示累计运行时长（超一小时按时分秒显示）；完整呈现档的运行中卡片还显示回合进度、输出速率、缓存命中率、输入/输出 token 与运行时长，进入完成、阻塞或错误等待后在统计行末尾与 tok/s 等内容并列保留上一轮耗时及最后已知统计；迁入最近历史后，历史卡在助手预览与活动时间之间继续保留最后一轮的可用统计。
+- [x] **三档显示密度一键切换**：标题行工具区的切换按钮按紧凑→中间→完整循环切换全部卡片的呈现密度，默认中间档——中间档保留标题、工作区徽标、时间线最新一行（运行中实时更新）与等待正文（完成提醒收合为单行），紧凑档仅保留标题行；切换时滚动锚定当前卡片，档位持久化、刷新后恢复。
+- [x] **标题行三区布局**：最左独立区常显 GitHub 仓库入口（悬停提示「报告问题，点赞收藏」），中部标题区悬停显现收起方向图标，右侧工具区常显档位切换按钮——两按钮分处标题行两端，消除触屏误触。
 - [x] **加入会话导航跳转**：点击或键盘激活会话卡片可跳转到对应会话页面，当前会话保持高亮；从 DSH 原生左侧栏选择会话时，对应窗格卡片会滚动到完整可见，不强制居中。
 - [x] **增加会话元信息**：会话卡片中显示当前使用的模型名称和推理级别。
 - [x] **完善桌面与移动交互**：桌面窗格可折叠、拖拽调宽并记忆宽度；移动端使用不挤压主会话布局的固定抽屉；长列表提供独立滚动与回到顶部按钮。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-activity-pane",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "packageManager": "pnpm@11.5.0",
   "engines": {
     "node": ">=20"

package/scripts/check.mjs

@@ -936,6 +936,47 @@ assert.deepEqual(
 	buildEntries(mixedActivity, mixedWorkspace, {}, mixedCompletions).map((entry) => [entry.id, entry.kind]),
 	"waitingStarts 非法值（null/空串）不作数、回落宿主列表时间，不误判为最旧时刻 0（R-01-001/AC-07，T-141 复审）",
 );
+// ---- R-01-002/AC-14 等待卡状态年龄：awaiting 条目携带进入状态时刻 stateAt ----
+// 与排序键共用 enterStateAt 单点口径：阻塞等待取 waitingStarts（openWaitStart），
+// 完成/错误提醒取 completions.lastTurnEnd；显示口径不回落宿主列表时间，
+// 缺失/非法为 null（节点隐藏）。
+{
+	const stateEntries = buildEntries(mixedActivity, mixedWorkspace, {}, mixedCompletions, null, [], mixedWaitingStarts);
+	const stateById = new Map(stateEntries.map((entry) => [entry.id, entry]));
+	assert.equal(stateById.get("sWait").stateAt, 9_000, "阻塞等待条目 stateAt 取等待边界开启时刻，与排序键同源（R-01-002/AC-14）");
+	assert.equal(stateById.get("sWaitNoRec").stateAt, null, "waitingStarts 缺失的阻塞等待条目 stateAt 为 null，不回落宿主列表时间（R-01-002/AC-14）");
+	assert.equal(stateById.get("sDone1").stateAt, 4_000, "完成提醒条目 stateAt 取回合结束登记时刻（R-01-002/AC-14）");
+	assert.equal(stateById.get("sRunOld").stateAt, undefined, "运行中条目不携带 stateAt（R-01-002/AC-14）");
+}
+assert.equal(
+	buildEntries(
+		{ ids: ["sErr"], byId: { sErr: { id: "sErr", displayTitle: "错误提醒", running: false, updatedAt: 500 } }, current: null },
+		[],
+		{},
+		new Map([["sErr", { lastTurnEnd: 12_345, lastTurnEndKind: "error", lastTurnEndError: "boom", ackedAt: null }]]),
+	)[0].stateAt,
+	12_345,
+	"错误提醒条目 stateAt 取回合结束登记时刻（R-01-002/AC-14）",
+);
+// 子代理条目不携带 stateAt（R-01-002/AC-14）：状态年龄仅主会话等待卡承载。
+{
+	const subStateActivity = {
+		ids: ["sParent", "sSub"],
+		byId: {
+			sParent: { id: "sParent", displayTitle: "母会话", running: false, updatedAt: 500 },
+			sSub: { id: "sSub", parentId: "sParent", origin: "subagent", running: true, updatedAt: 600 },
+		},
+		current: null,
+	};
+	const subEntry = buildEntries(subStateActivity, [], {}, null).find((entry) => entry.id === "sSub");
+	assert.equal(subEntry?.kind, "subagent", "前置：运行中子代理为 subagent 条目");
+	assert.equal(subEntry?.stateAt, undefined, "子代理条目不携带 stateAt（R-01-002/AC-14）");
+}
+assert.notEqual(
+	cardSignature(buildEntries(mixedActivity, mixedWorkspace, {}, mixedCompletions, null, [], mixedWaitingStarts)),
+	cardSignature(buildEntries(mixedActivity, mixedWorkspace, {}, mixedCompletions, null, [], null)),
+	"stateAt 到达/更替驱动渲染签名（R-01-002/AC-14）",
+);
 assert.deepEqual(trackRuns([{ kind: "subagent", parentId: "p", depth: 1 }]), [], "无 id 条目不产生轨道");
 assert.deepEqual(
 	trackRuns([...hierarchyEntries, { id: "X", kind: "subagent", parentId: "root", depth: 3 }]),
@@ -3597,8 +3638,8 @@ assert.ok(bundle.includes("notifyLayoutChange"), "布局变化通知 sibling ove
 assert.ok(bundle.includes('window.dispatchEvent(new Event("resize"))'), "布局变化派发标准 resize 通知");
 assert.ok(bundle.includes("pane !== renderedPane"), "新窗格实例必须重置渲染签名");
 assert.ok(
-	clientSource.includes("const sig = JSON.stringify([listState, cardSignature(visibleEntries), pulseSurface, recentTimeSignature, densityLevel]);"),
-	"列表 phase、历史时间文案与显示档位必须参与结构化渲染签名，空列表不得冻结在加载/失败状态（T-087），档位切换触发时间线按新档位重建（R-01-021/AC-08）",
+	clientSource.includes("const sig = JSON.stringify([listState, cardSignature(visibleEntries), pulseSurface, recentTimeSignature, awaitAgeSignature, densityLevel]);"),
+	"列表 phase、历史时间文案、等待卡状态年龄与显示档位必须参与结构化渲染签名，空列表不得冻结在加载/失败状态（T-087），档位切换触发时间线按新档位重建（R-01-021/AC-08），状态年龄随分钟级时钟重绘（R-01-002/AC-14）",
 );
 assert.ok(
 	clientSource.includes("scroll?.querySelector?.(`.${LIST_CLASS} .${CARD_CLASS}[data-current]`)") &&
@@ -3680,8 +3721,8 @@ assert.ok(
 	"等待卡复用统计行并清理胶囊同行的旧耗时节点（R-01-009/AC-12、AC-13）",
 );
 assert.ok(
-	bundle.includes("function removeAwaitingHeadDuration") && bundle.includes("awaitHead.append(capsule);"),
-	"等待类型胶囊独立成行，固定耗时回到统计行（R-01-009/AC-12）",
+	bundle.includes("function removeAwaitingHeadDuration") && bundle.includes('awaitHead.append(capsule, makeEl("span", "dap-await-age"));'),
+	"等待类型胶囊独立成行且右侧携带状态年龄（R-01-002/AC-14），固定耗时回到统计行（R-01-009/AC-12）",
 );
 assert.ok(bundle.includes("lastTurnDuration({"), "等待卡耗时由最近完整回合边界派生（R-01-009/AC-12）");
 assert.ok(bundle.includes("`输入 ${fmtTokens("), "统计行含输入/输出中文短标签（R-01-009/AC-05）");
@@ -3768,9 +3809,9 @@ assert.ok(
 assert.ok(bundle.includes("function activeSessionIds(byId = {})"), "活动子代理沿 parentId 链补齐活动祖先");
 // ---- R-01-016/AC-01 等待卡保留最近工作项时间线 ----
 assert.ok(
-	bundle.includes("awaitHead.append(capsule);") &&
+	bundle.includes('awaitHead.append(capsule, makeEl("span", "dap-await-age"));') &&
 		bundle.includes('return [head, row, makeEl("div", "dap-trace"), makeStatsRow(), foot];'),
-	"awaiting 骨架在标题行与统计行、末行两段（胶囊+正文）之间含时间线，固定耗时由统计行承载（R-01-016/AC-01、R-01-009/AC-12，C-043）",
+	"awaiting 骨架在标题行与统计行、末行两段（胶囊+正文）之间含时间线，末行首行胶囊右侧携带状态年龄（R-01-002/AC-14），固定耗时由统计行承载（R-01-016/AC-01、R-01-009/AC-12，C-043）",
 );
 // ---- R-01-002/AC-10 完成提醒卡「移入历史」按钮 ----
 assert.ok(

package/src/client.mjs

@@ -45,7 +45,7 @@ const CLOCK_MS = 1000;
  *  10Hz——事件率随宿主流式 chunk 数增长，显示粒度（秒级时长、块级时间线）无感，
  *  而渲染与 O(日志窗口) 派生不再随刷新率（移动端 120Hz）与事件率线性放大（T-127）。 */
 const SYNC_MIN_INTERVAL_MS = 100;
-/** 历史卡相对时间刷新周期；无需每秒重绘整列。 */
+/** 历史卡相对时间与等待卡状态年龄的刷新周期；无需每秒重绘整列。 */
 const RECENT_TIME_REFRESH_MS = 60_000;
 /** 冷数据读取并发池上限：慢网下避免几十张卡片的 models/history 一次性挤占通道。 */
 const LOAD_CONCURRENCY = 3;
@@ -672,6 +672,13 @@ body:not([data-ds-dark-theme]) [data-dsh-activity-pane] .dap-workspace {
 [data-dsh-activity-pane] .dap-await-head {
   display: flex; align-items: center; gap: 8px; align-self: stretch; min-width: 0;
 }
+/* 进入状态相对年龄（R-01-002/AC-14）：胶囊右侧裸相对时间，弱化色调不与胶囊争抢，
+   不参与等待脉冲；进入状态时刻不可得时隐藏节点，不以虚假时刻冒充。 */
+[data-dsh-activity-pane] .dap-await-age {
+  flex: none; font-size: 10px; line-height: 14px; white-space: nowrap;
+  color: color-mix(in srgb, currentColor 55%, transparent);
+}
+[data-dsh-activity-pane] .dap-await-age[hidden] { display: none; }
 [data-dsh-activity-pane] .dap-note-row {
   display: flex; align-items: center; gap: 6px; min-width: 0; align-self: stretch;
 }
@@ -1168,6 +1175,12 @@ function fmtRecentTime(ts, now = Date.now()) {
 	}
 }
 
+/** 等待卡状态年龄文案（R-01-002/AC-14）：进入状态时刻的裸相对时间，单点派生；
+ *  时刻不可得或差值为负（时钟偏差）返回空串（节点隐藏）。 */
+function awaitAgeText(entry, now = Date.now()) {
+	return Number.isFinite(entry?.stateAt) ? fmtRelativeAge(now - entry.stateAt) : "";
+}
+
 /** 读取持久化列宽：缺失/非法/越界值经 clampPaneWidth 归一；localStorage 不可用（隐私模式）静默回退默认（R-01-015/AC-04）。 */
 function readStoredPaneWidth() {
 	try {
@@ -2291,9 +2304,12 @@ function apply(ctx) {
 		noteRow.querySelector(".dap-badge")?.remove();
 		const capsule = makeEl("div", "dap-capsule");
 		capsule.append(makeEl("span", "dap-capsule-icon"), makeEl("span", "dap-capsule-text"));
+		// 与新版骨架同形：胶囊行含类型胶囊与状态年龄段（R-01-002/AC-14）。
+		const awaitHead = makeEl("div", "dap-await-head");
+		awaitHead.append(capsule, makeEl("span", "dap-await-age"));
 		const foot = makeEl("div", "dap-foot");
 		noteRow.replaceWith(foot);
-		foot.append(capsule, noteRow);
+		foot.append(awaitHead, noteRow);
 	}
 
 	/** 进度行骨架（运行卡与子代理卡共用，R-01-009/AC-06、AC-14）：可伸缩轨道 + 固定宽百分比。 */
@@ -2364,7 +2380,8 @@ function apply(ctx) {
 			const noteRow = makeEl("div", "dap-note-row");
 			noteRow.append(makeEl("div", "dap-note"), makeConfirmButton());
 			const awaitHead = makeEl("div", "dap-await-head");
-			awaitHead.append(capsule);
+			// 状态年龄（R-01-002/AC-14）：进入状态时刻的裸相对时间，胶囊右侧静态显示。
+			awaitHead.append(capsule, makeEl("span", "dap-await-age"));
 			const foot = makeEl("div", "dap-foot");
 			foot.append(awaitHead, noteRow);
 			return [head, row, makeEl("div", "dap-trace"), makeStatsRow(), foot];
@@ -2946,6 +2963,21 @@ function apply(ctx) {
 				iconHolder.dataset.kind = iconKind;
 				iconHolder.replaceChildren(...(iconKind === "" ? [] : [createCapsuleIcon(iconKind)]));
 			}
+			// 状态年龄（R-01-002/AC-14）：进入状态时刻的裸相对时间，紧随胶囊之后；文案由
+			// 帧内 enrichment 单点派生（entry.awaitAge，与签名同时钟源）。陈旧骨架就地
+			// 补建年龄节点（C-043 热装兼容同惯例）。
+			const capsuleEl = el.querySelector(".dap-capsule");
+			if (capsuleEl !== null) {
+				let ageEl = capsuleEl.nextElementSibling;
+				if (ageEl === null || !ageEl.classList.contains("dap-await-age")) {
+					ageEl = makeEl("span", "dap-await-age");
+					capsuleEl.insertAdjacentElement("afterend", ageEl);
+				}
+				const ageText = entry.awaitAge ?? "";
+				if (ageEl.textContent !== ageText) ageEl.textContent = ageText;
+				const ageHidden = ageText === "";
+				if (ageEl.hidden !== ageHidden) ageEl.hidden = ageHidden;
+			}
 		}
 
 		if (entry.kind === "running") {
@@ -3110,7 +3142,7 @@ function apply(ctx) {
 		}
 	}
 
-	/** 历史卡相对时间只需分钟级刷新；无历史卡时停止定时器，避免空窗格常驻唤醒。 */
+	/** 历史卡相对时间与等待卡状态年龄只需分钟级刷新；两者皆无时停止定时器，避免空窗格常驻唤醒。 */
 	function syncRecentTimeClock(wanted) {
 		if (wanted && recentTimeTimer === null) {
 			recentTimeTimer = setInterval(() => queueSync(), RECENT_TIME_REFRESH_MS);
@@ -3698,6 +3730,8 @@ function apply(ctx) {
 			if (entry.kind === "awaiting" && detail) {
 				entry.elapsedMs = memoTurnDuration(detail);
 			}
+			// 状态年龄（R-01-002/AC-14）：帧内单点派生一次，渲染与签名共用同一文案与时钟源。
+			if (entry.kind === "awaiting") entry.awaitAge = awaitAgeText(entry, now);
 			if (detail?.model) {
 				entry.model = detail.model.model;
 				entry.reasoning = detail.model.reasoning;
@@ -3810,7 +3844,8 @@ function apply(ctx) {
 			} : null);
 			if (elapsedMs === null) recentDurationFallbackIds.add(entry.id);
 		}
-		syncRecentTimeClock(recent.length > 0);
+		// 状态年龄（R-01-002/AC-14）与历史卡相对时间同为分钟级：任一存在即保持定时器。
+		syncRecentTimeClock(recent.length > 0 || active.some((entry) => entry.kind === "awaiting" && entry.awaitAge));
 		// 预览只对当前显示的 recent 卡计算（活动卡不显示预览）；快照/历史引用不变时命中缓存。
 		// 完成瞬间的窗口快照可能先有用户消息、后到 agent reply；缺任一预览时补读一次 history。
 		const previewFallbackIds = new Set();
@@ -3873,9 +3908,12 @@ function apply(ctx) {
 		// listState 参与签名：空列表从 pending/error → ready 时卡集合不变，若只比较卡片
 		// 会被提前返回冻结在「加载中」/「列表加载失败」；数量胶囊可见面变化同样需要
 		// 进入渲染，以便与当前可见等待卡末行重新对相（R-01-002/AC-07）。
-		// 历史卡的相对活动时间随分钟级时钟变化，纳入签名后只在文案实际变化时重绘。
+		// 历史卡的相对活动时间与等待卡状态年龄随分钟级时钟变化，纳入签名后只在文案实际变化时重绘。
 		const recentTimeSignature = recent.map((entry) => fmtRecentTime(entry.activityAt));
-		const sig = JSON.stringify([listState, cardSignature(visibleEntries), pulseSurface, recentTimeSignature, densityLevel]);
+		const awaitAgeSignature = active
+			.filter((entry) => entry.kind === "awaiting")
+			.map((entry) => entry.awaitAge ?? "");
+		const sig = JSON.stringify([listState, cardSignature(visibleEntries), pulseSurface, recentTimeSignature, awaitAgeSignature, densityLevel]);
 		if (sig === lastSig) return;
 		const colorByWorkspace = resolveWorkspaceColors(visibleEntries.map((entry) => entry.workspaceKey));
 		// 跨区迁移（双向，R-01-010/AC-07）：DOM 写入前量取旧卡矩形并克隆 ghost。

package/src/core.mjs

@@ -1532,7 +1532,7 @@ export function mainTitle(byId, id) {
  * 把 sessions/workspaces 快照构建成窗格条目列表（有序、已含层级与显示过滤）。
  * 返回数组的每一项：
  *   { id, parentId?, depth, kind: 'running'|'awaiting'|'subagent', title, workspaceTitle, workspaceKey,
- *     isCurrent, pendingText?, descendantActive? }
+ *     isCurrent, pendingText?, descendantActive?, stateAt? }
  * kind 规则：
  *   - 主会话 running（且无 pending）或处于委托周期（含后代耗尽空窗）→ 'running'
  *   - 主会话 pendingInteraction / completed / errorReminder → 'awaiting'（等待用户行动）
@@ -1552,6 +1552,9 @@ export function mainTitle(byId, id) {
  * 尚未结束、`lastTurnEnd` 仍是上一回合的旧时刻，不能作为等待进行中会话的排序键（T-141）；
  * 非 Map、缺失记录或值非有限数字（含 null/空串等 Number 归一为 0 的形状）均视为无数据，
  * 回落宿主列表时间。
+ * stateAt（进入当前等待行动状态的时刻，R-01-002/AC-14）：仅 awaiting 条目携带，与排序键
+ * 共用 enterStateAt 单点口径——pending 取 waitingStarts，完成/错误提醒取 completions.lastTurnEnd；
+ * 显示侧不回落宿主列表时间——排序键缺失时的回落仅用于排序，显示以 null（不显示）承载。
  */
 export function buildEntries(snapshot, workspaceItems, detailsById = {}, completions = null, delegatingIds = null, archivedIds = [], waitingStarts = null) {
 	const byId = isRecord(snapshot) && isRecord(snapshot.byId) ? snapshot.byId : {};
@@ -1621,16 +1624,20 @@ export function buildEntries(snapshot, workspaceItems, detailsById = {}, complet
 		if (typeof value !== "number") return null;
 		return Number.isFinite(value) ? value : null;
 	};
+	// 进入状态时刻单点（R-01-002/AC-14，排序键 R-01-001/AC-07 同源）：阻塞等待取
+	// waitingStarts，完成/错误提醒取最近一次回合结束登记时刻；有效性口径单点收紧——
+	// 仅真实数字作数，Number(null)/Number("") 归一的 0 陷阱两侧同样不作数。
+	const enterStateAt = (id, pending) => {
+		if (pending) return waitingStartTime(id);
+		const end = completionFor(id, completions)?.lastTurnEnd;
+		return typeof end === "number" && Number.isFinite(end) ? end : null;
+	};
 	const sortTime = (id) => {
 		if (isRunningEntry(id)) return instructionTime(byId[id]);
 		const m = meta.get(id);
-		if (m !== undefined && m.pending) {
-			const start = waitingStartTime(id);
-			return start ?? instructionTime(byId[id]);
-		}
-		const record = completionFor(id, completions);
-		const end = isRecord(record) ? Number(record.lastTurnEnd) : NaN;
-		return Number.isFinite(end) ? end : instructionTime(byId[id]);
+		const entered = m !== undefined ? enterStateAt(id, m.pending) : null;
+		// 排序键缺失回落宿主列表时间；回落仅用于排序，显示侧以 null 承载（见 stateAt）。
+		return entered ?? instructionTime(byId[id]);
 	};
 	rootIds.sort((a, b) => {
 		const byGroup = Number(isRunningEntry(b)) - Number(isRunningEntry(a));
@@ -1664,6 +1671,10 @@ export function buildEntries(snapshot, workspaceItems, detailsById = {}, complet
 			const doneWait = !m.pending && m.done && !m.running && !m.delegating;
 			const errWait = !m.pending && m.err && !m.running && !m.delegating;
 			const errorNote = entryErrorNote(completionFor(id, completions));
+			// 进入状态时刻（R-01-002/AC-14）：仅 awaiting 条目携带，与排序键共用 enterStateAt
+			// 单点口径；显示侧不回落宿主列表时间，不可得即为 null（节点隐藏），避免把
+			// 回退值冒充真实进入时刻。
+			const stateAt = m.pending || doneWait || errWait ? enterStateAt(id, m.pending) : undefined;
 			const questionPreview =
 				m.pending && m.row.pendingInteraction === "question" ? timelineQuestionPreview(timeline) : undefined;
 			entries.push({
@@ -1708,6 +1719,7 @@ export function buildEntries(snapshot, workspaceItems, detailsById = {}, complet
 						: doneWait
 							? ROUND_DONE_NOTE
 							: undefined,
+				stateAt,
 				questionPreview: m.pending && m.row.pendingInteraction === "question" ? (questionPreview ?? null) : undefined,
 			});
 		}
@@ -1802,6 +1814,8 @@ export function cardSignature(entries) {
 			entry.waitClass ?? null,
 			entry.noteText ?? null,
 			entry.questionPreview ?? null,
+			// 进入状态时刻参与签名（R-01-002/AC-14）：数据到达/更替（回填、SSE）驱动重绘。
+			entry.stateAt ?? null,
 			entry.activityAt ?? null,
 			entry.progress ?? null,
 			entry.loadingModel ?? null,