tagword-codeagent 1.1.6__py3-none-any.whl

codeagent/web/static/05-chat-p2.css

@@ -0,0 +1 @@
+/* ============ Tool trace inside bubble ============ */.bubble-agent .oa-tool-trace {  margin-top: var(--sp-3);  font-size: 12px;  border: 1px solid var(--border);  border-radius: var(--r-md);  background: var(--bg-subtle);  overflow: hidden;}.bubble-agent .oa-tool-trace > summary {  cursor: pointer;  padding: 6px 10px;  font-weight: 550;  color: var(--text-secondary);  user-select: none;  list-style: none;  font-size: 11.5px;  display: flex;  align-items: center;  gap: 6px;}.bubble-agent .oa-tool-trace > summary::-webkit-details-marker { display: none; }.bubble-agent .oa-tool-trace > summary::before {  content: '';  display: inline-block;  width: 0; height: 0;  border-left: 4px solid var(--text-muted);  border-top: 3px solid transparent;  border-bottom: 3px solid transparent;  transition: transform 0.15s ease;}.bubble-agent .oa-tool-trace[open] > summary::before { transform: rotate(90deg); }.bubble-agent .oa-tool-trace-pre {  margin: 0;  padding: 10px 12px;  max-height: 40vh;  overflow: auto;  font-size: 11.5px;  line-height: 1.5;  white-space: pre-wrap;  word-break: break-word;  border-top: 1px solid var(--border);  background: var(--bg-panel);  font-family: var(--font-mono);}/* ============ Live tool call card ============ */details.oa-live-tool {  display: block;  position: relative;  overflow: visible;}details.oa-live-tool > summary {  list-style: none;  cursor: pointer;  user-select: none;  display: flex;  align-items: center;  gap: 8px;  padding: 4px 6px;  margin: 0;  border-radius: var(--r-sm);  transition: background-color 0.15s ease;}details.oa-live-tool > summary::-webkit-details-marker { display: none; }details.oa-live-tool > summary::after {  content: '';  width: 0; height: 0;  margin-left: auto;  border-left: 4px solid var(--text-muted);  border-top: 3px solid transparent;  border-bottom: 3px solid transparent;  transition: transform 0.15s ease;  flex: 0 0 auto;}details.oa-live-tool[open] > summary::after { transform: rotate(90deg); }details.oa-live-tool > summary:hover { background: var(--bg-panel); }details.oa-live-tool .oa-live-tool-label {  flex: 1 1 auto;  min-width: 0;  overflow: hidden;  text-overflow: ellipsis;  white-space: nowrap;}details.oa-live-tool .oa-live-tool-spinner {  flex: 0 0 auto;  width: 10px;  height: 10px;  border-radius: 50%;  background: var(--accent, #4f46e5);  box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent, #4f46e5) 55%, transparent);  transition: background-color 0.2s ease, box-shadow 0.2s ease;}details.oa-live-tool.is-running .oa-live-tool-spinner {  animation: oa-pulse 1.15s ease-in-out infinite;}details.oa-live-tool.is-running > summary {  background: linear-gradient(90deg,    color-mix(in srgb, var(--accent, #4f46e5) 7%, transparent) 0%,    color-mix(in srgb, var(--accent, #4f46e5) 14%, transparent) 40%,    color-mix(in srgb, var(--accent, #4f46e5) 7%, transparent) 100%);  background-size: 200% 100%;  animation: oa-shimmer 2.2s linear infinite;}details.oa-live-tool:not(.is-running) .oa-live-tool-spinner {  background: color-mix(in srgb, var(--text-muted) 60%, transparent);  box-shadow: none;}details.oa-live-tool .oa-tool-trace-pre {  margin: 8px 0 0;  background: var(--bg-panel);  border: 1px solid var(--border);  border-radius: var(--r-sm);  padding: 8px 10px;  font-family: var(--font-mono);  font-size: 11.5px;  line-height: 1.45;  white-space: pre-wrap;  word-break: break-word;  max-height: 40vh;  overflow: auto;}

codeagent/web/static/05-chat-p3.css

@@ -0,0 +1,295 @@
+/* ============ Compose ============ */.compose {  flex-shrink: 0;  padding: var(--sp-3) var(--sp-8) var(--sp-5);  background: linear-gradient(to top, var(--bg) 78%, transparent);}.compose__box {  max-width: 820px;  margin: 0 auto;  background: var(--bg-panel);  border: 1px solid var(--border);  border-radius: var(--r-2xl);  box-shadow: var(--shadow-sm);  transition: border-color 0.15s ease, box-shadow 0.2s ease;  display: flex;  flex-direction: column;  overflow: hidden;}#msg {  width: 100%;  min-height: 44px;  max-height: 220px;  border: none;  background: transparent;  color: var(--text);  font-size: 13.5px;  font-family: inherit;  line-height: 1.55;  resize: none;  outline: none;}#msg::placeholder { color: var(--text-subtle); }.compose__hint {  margin-right: auto;  font-size: 11px;  color: var(--text-subtle);  font-family: var(--font-mono);  padding-left: 6px;  letter-spacing: 0.02em;  white-space: nowrap;  overflow: hidden;  text-overflow: ellipsis;}.compose__hint kbd {  display: inline-block;  padding: 1px 5px;  border-radius: var(--r-xs);  border: 1px solid var(--border);  background: var(--bg-subtle);  font-size: 10px;  font-family: inherit;  color: var(--text-muted);  line-height: 1.4;}.compose__model-select {  font-size: inherit;  font-family: inherit;  background: transparent;  color: var(--text-secondary);  border: none;  cursor: pointer;  max-width: 120px;  vertical-align: baseline;  padding: 0; margin: 0;  appearance: auto;  -webkit-appearance: auto;}.compose__model-select:hover { color: var(--text); }.compose__model-select option { background: var(--bg-panel); color: var(--text); }/* ============ Session running state indicator ============ */
+
+/* 通道指示点 — 基础样式 */
+.sess-item__channel-dot {
+  display: inline-block;
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--border-strong);
+  flex-shrink: 0;
+  transition: background 0.2s ease, box-shadow 0.2s ease;
+}
+
+/* 会话列表行 — 运行中状态 */
+.sess-row.is-running {
+  position: relative;
+}
+.sess-row.is-running .sess-item-main {
+  background: var(--accent-softer);
+}
+.sess-row.is-running .sess-item__channel-dot {
+  background: var(--success);
+  box-shadow: 0 0 0 0 rgba(22, 163, 74, 0.5);
+  animation: sess-running-pulse 1.4s ease-in-out infinite;
+}
+.sess-row.is-running .sess-item__title {
+  color: var(--accent);
+  font-weight: 600;
+}
+/* ============ 会话「已完成」状态（刚结束运行，绿色实心不闪烁） ============ */
+.sess-row.is-completed .sess-item__channel-dot {
+  background: var(--success);
+  box-shadow: 0 0 0 2px rgba(22, 163, 74, 0.18);
+  animation: none;
+}
+.sess-row.is-completed .sess-item__title {
+  color: var(--success);
+  font-weight: 600;
+}
+.sess-row.is-completed .sess-item-main {
+  background: color-mix(in srgb, var(--success) 6%, transparent);
+}
+/* 树状视图 — 已完成状态 */
+.tree-session.is-completed .tree-session__indicator {
+  background: var(--success);
+  box-shadow: 0 0 0 2px rgba(22, 163, 74, 0.18);
+  animation: none;
+}
+.tree-session.is-completed .tree-session__title {
+  color: var(--success);
+  font-weight: 600;
+}
+
+/* 树状视图 — 运行中状态 */
+.tree-session.is-running .tree-session__row {
+  background: var(--accent-softer);
+}
+.tree-session.is-running .tree-session__indicator {
+  background: var(--success);
+  box-shadow: 0 0 0 0 rgba(22, 163, 74, 0.5);
+  animation: sess-running-pulse 1.4s ease-in-out infinite;
+}
+.tree-session.is-running .tree-session__title {
+  color: var(--accent);
+  font-weight: 600;
+}
+@keyframes sess-running-pulse {
+  0% { box-shadow: 0 0 0 0 rgba(22, 163, 74, 0.45); }
+  50% { box-shadow: 0 0 0 6px rgba(22, 163, 74, 0); }
+  100% { box-shadow: 0 0 0 0 rgba(22, 163, 74, 0); }
+}
+
+/* topbar session-id-chip 运行态 */
+.chat-running .session-id-chip::before {
+  background: var(--success);
+  animation: sess-running-pulse 1.4s ease-in-out infinite;
+}
+
+/* ============ Token / 上下文占用指示器 ============ */
+.token-usage {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  font-family: var(--font-mono);
+  color: var(--text-subtle);
+  padding: 3px 8px 3px 6px;
+  border-radius: var(--r-sm);
+  border: 1px solid var(--border);
+  background: var(--bg-subtle);
+  cursor: default;
+  white-space: nowrap;
+  user-select: none;
+  -webkit-user-select: none;
+  transition: border-color 0.25s ease, background 0.25s ease;
+}
+.token-usage:hover {
+  background: var(--bg-hover);
+  border-color: var(--border-strong);
+}
+.token-usage__icon {
+  flex-shrink: 0;
+  color: var(--text-muted);
+}
+.token-usage--seg {
+  gap: 6px;
+}
+.token-usage__segs {
+  display: inline-flex;
+  align-items: center;
+  gap: 2px;
+  flex-shrink: 0;
+}
+.token-usage__seg {
+  display: block;
+  width: 10px;
+  height: 8px;
+  border-radius: 2px;
+  background: var(--border);
+  transition: background-color 0.25s ease, transform 0.2s ease;
+}
+.token-usage__seg.is-on {
+  background: var(--accent);
+}
+.token-usage__pct {
+  min-width: 28px;
+  font-size: 10.5px;
+  font-weight: 500;
+  font-variant-numeric: tabular-nums;
+  text-align: right;
+  color: var(--text-secondary);
+  line-height: 1;
+}
+.token-usage.is-warm .token-usage__seg.is-on {
+  background: #d97706;
+}
+.token-usage.is-warm .token-usage__pct,
+.token-usage.is-warm .token-usage__icon {
+  color: #d97706;
+}
+.token-usage.is-hot {
+  border-color: rgba(220, 38, 38, 0.35);
+  background: var(--danger-soft);
+}
+.token-usage.is-hot .token-usage__seg.is-on {
+  background: #dc2626;
+}
+.token-usage.is-hot .token-usage__pct,
+.token-usage.is-hot .token-usage__icon {
+  color: #dc2626;
+}
+
+/* ============ New message floating button ============ */.new-msg-btn {  position: sticky;  bottom: 0;  align-self: center;  z-index: 20;  display: inline-flex;  align-items: center;  gap: 6px;  padding: 7px 16px;  margin: -38px 0 4px;  border: 1px solid var(--border-strong);  border-radius: 20px;  background: var(--bg-panel);  color: var(--accent);  font-size: 12.5px;  font-weight: 500;  cursor: pointer;  box-shadow: 0 2px 10px rgba(0,0,0,0.12);  transition: opacity 0.2s ease, transform 0.2s ease;  user-select: none;  -webkit-user-select: none;}.new-msg-btn:hover {  background: var(--bg-hover);  box-shadow: 0 3px 14px rgba(0,0,0,0.18);  transform: translateY(-1px);}.new-msg-btn:active {  transform: translateY(0);}.new-msg-btn__dot {  width: 8px;  height: 8px;  border-radius: 50%;  background: var(--accent);  flex-shrink: 0;}
+/* ============ Camera modal (real-time camera + recorder) ============ */
+.camera-modal__dialog {
+  max-width: 720px;
+  width: min(720px, 92vw);
+}
+.camera-modal__body {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 12px 16px 0;
+}
+.camera-modal__mode {
+  display: inline-flex;
+  align-self: flex-start;
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  padding: 2px;
+  background: var(--bg-panel);
+  gap: 2px;
+}
+.camera-modal__mode-btn {
+  border: 0;
+  background: transparent;
+  color: var(--text-muted, #9ca3af);
+  padding: 4px 14px;
+  font-size: 12.5px;
+  border-radius: 999px;
+  cursor: pointer;
+  transition: background 0.15s ease, color 0.15s ease;
+}
+.camera-modal__mode-btn:hover { color: var(--text); }
+.camera-modal__mode-btn.is-active {
+  background: var(--accent, #6366f1);
+  color: #fff;
+}
+.camera-modal__stage {
+  position: relative;
+  background: #000;
+  border-radius: 8px;
+  overflow: hidden;
+  min-height: 280px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.camera-modal__video {
+  width: 100%;
+  max-height: 60vh;
+  object-fit: contain;
+  background: #000;
+  display: block;
+}
+.camera-modal__video--mirror {
+  transform: scaleX(-1);
+}
+.camera-modal__footer[hidden] {
+  display: none !important;
+}
+.camera-modal__status {
+  position: absolute;
+  left: 0; right: 0; bottom: 0;
+  margin: 0;
+  padding: 6px 12px;
+  background: rgba(0,0,0,0.55);
+  color: #fff;
+  font-size: 12px;
+  text-align: center;
+}
+.camera-modal__fallback {
+  position: absolute;
+  left: 50%;
+  bottom: 36px;
+  transform: translateX(-50%);
+  z-index: 2;
+}
+.camera-modal__rec-indicator {
+  position: absolute;
+  top: 10px;
+  left: 10px;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 10px;
+  border-radius: 999px;
+  background: rgba(0,0,0,0.6);
+  color: #fff;
+  font-size: 12px;
+  font-variant-numeric: tabular-nums;
+}
+.camera-modal__rec-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: #ef4444;
+  animation: camera-rec-pulse 1s ease-in-out infinite;
+}
+@keyframes camera-rec-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.35; }
+}
+
+/* ==============================
+ * 上下文历史面板 (ctx-history)
+ * ============================== */
+.ctx-history {
+  margin: 10px 16px;
+  border: 1px solid var(--border, #ddd);
+  border-radius: 6px;
+  background: var(--bg-secondary, #fafafa);
+  font-size: 12px;
+  overflow: hidden;
+}
+.ctx-history__header {
+  padding: 6px 10px;
+  cursor: pointer;
+  user-select: none;
+  font-weight: 500;
+  color: var(--text-primary, #333);
+}
+.ctx-history__header:hover {
+  background: var(--bg-hover, #f0f0f0);
+}
+.ctx-history__table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 11px;
+}
+.ctx-history__table th,
+.ctx-history__table td {
+  padding: 4px 8px;
+  text-align: right;
+  border-top: 1px solid var(--border, #eee);
+}
+.ctx-history__table th {
+  background: var(--bg-tertiary, #f0f0f0);
+  font-weight: 600;
+  color: var(--text-secondary, #666);
+  text-align: right;
+}
+.ctx-history__table th:first-child,
+.ctx-history__table td:first-child {
+  text-align: center;
+}

codeagent/web/static/05a-session-history.js

@@ -0,0 +1,176 @@
+/* ================================================================
+ * 05a-session-history.js
+ *   - Session history loading (loadSessionHistoryIntoLog)
+ *   - Older history paging (loadOlderSessionHistoryChunk)
+ *   - Session list fetch / refresh (refreshSessionList)
+ *   - Session list bindings (bindSessListOnce)
+ *   - Web UI sessions initialization (initWebUiSessions)
+ *   - Logout
+ * ================================================================ */
+
+(function () {
+  const btn = document.getElementById('btnLogout');
+  if (!btn) return;
+  btn.addEventListener('click', async () => {
+    try { await fetch('/api/ui/auth/logout', { method: 'POST', credentials: 'same-origin' }); } catch (_) {}
+    tryRemoveSS(STORAGE_KEYS.WS_TOKEN);
+    location.href = '/';
+  });
+})();
+
+// ---------------- Session history loading ----------------
+
+function bindHistoryPagingOnce() {
+  if (historyPagingBound || !log) return;
+  historyPagingBound = true;
+  log.addEventListener('scroll', () => {
+    if (!historyHasMoreOlder || historyLoadingOlder) return;
+    if (log.scrollTop > 120) return;
+    if (historyScrollTimer) return;
+    historyScrollTimer = setTimeout(() => {
+      historyScrollTimer = null;
+      if (!historyHasMoreOlder || historyLoadingOlder) return;
+      if (log.scrollTop > 120) return;
+      loadOlderSessionHistoryChunk();
+    }, 120);
+  }, { passive: true });
+}
+
+async function parseJsonResponse(r) {
+  const text = await r.text();
+  if (!text) return {};
+  try {
+    return JSON.parse(text);
+  } catch (e) {
+    var hint = (text || '').replace(/\s+/g, ' ').trim().slice(0, 240);
+    throw new SyntaxError('响应不是 JSON（HTTP ' + r.status + '）：' + hint);
+  }
+}
+
+async function loadOlderSessionHistoryChunk() {
+  if (!webuiSessionsEnabled || !historyHasMoreOlder || historyLoadingOlder ||
+      historyFirstBlockIndex == null || historyFirstBlockIndex <= 0) return;
+  historyLoadingOlder = true;
+  const oldH = log.scrollHeight;
+  const oldT = log.scrollTop;
+  try {
+    const r = await fetch('/api/ui/session/history?session_id=' + encodeURIComponent(sessionId) +
+      '&agent_id=' + encodeURIComponent(agentId) + projectQuerySuffix() +
+      '&before_block_index=' + encodeURIComponent(String(historyFirstBlockIndex)));
+    const j = await parseJsonResponse(r);
+    if (!r.ok) throw new Error(j.detail || r.statusText);
+    const rows = j.messages || [];
+    rows.slice().reverse().forEach((m) => {
+      const ts = m.ts;
+      const idx = m.idx;
+      const o = { at: ts, prepend: true, idx: idx };
+      if (m.role === 'user') bubble('user', m.content || m.text || '', Object.assign(o, { attachments: m.attachments || [] }));
+      else {
+        // 拆分渲染：工具链各自独立展示，保持与实时执行一致的样式
+        var fn = (typeof bubbleAgentWithSplitToolTrace === 'function')
+          ? bubbleAgentWithSplitToolTrace : bubble;
+        if (fn !== bubble) {
+          fn(m.content || '', m.tool_trace || [], o);
+        } else {
+          bubble('agent', m.content || '', Object.assign({ toolTrace: m.tool_trace || [] }, o));
+        }
+      }
+    });
+    if (j.first_block_index != null) historyFirstBlockIndex = j.first_block_index;
+    historyHasMoreOlder = !!j.has_more_older;
+    const fixTop = () => { log.scrollTop = oldT + (log.scrollHeight - oldH); };
+    fixTop();
+    requestAnimationFrame(() => { requestAnimationFrame(fixTop); });
+  } catch (e) { systemMsg('err', '加载更早记录失败：' + String(e)); }
+  finally { historyLoadingOlder = false; }
+}
+
+async function loadSessionHistoryIntoLog(skipTreeRefresh) {
+  try {
+    if (typeof resetTokenUsageCache === 'function') resetTokenUsageCache();
+    // 立即用持久化的 context_usage 恢复指示器，避免在历史加载完成前变成 1% 误显示
+    try {
+      const cuRow = (lastSessionsCache || []).find((r) => r.session_id === sessionId);
+      const cu = cuRow && cuRow.context_usage;
+      if (cu && typeof updateTokenUsage === 'function') {
+        var cuPt = (typeof pickContextUsageTokens === 'function')
+          ? pickContextUsageTokens(cu) : (Number(cu.prompt_tokens) || 0);
+        if (cuPt > 0) {
+          updateTokenUsage({ prompt_tokens: cuPt, peak_prompt_tokens: cu.peak_prompt_tokens });
+        }
+      }
+    } catch (_) {}
+    const r = await fetch('/api/ui/session/history?session_id=' + encodeURIComponent(sessionId) +
+      '&agent_id=' + encodeURIComponent(agentId) + projectQuerySuffix());
+    const j = await parseJsonResponse(r);
+    if (!r.ok) throw new Error(j.detail || r.statusText);
+    log.innerHTML = '';
+    resetAgentReplyDedupe();
+    historyFirstBlockIndex = j.first_block_index != null ? j.first_block_index : null;
+    historyHasMoreOlder = !!j.has_more_older;
+    bindHistoryPagingOnce();
+    if (j.truncated_start || j.has_more_older) {
+      systemMsg('info', '历史较长：默认只载入最近若干轮对话；上滑到顶部可继续加载更早内容。', { skipScroll: true });
+    }
+    const rows = j.messages || [];
+    rows.forEach((m) => {
+      const ts = m.ts;
+      const idx = m.idx;
+      const skip = { skipScroll: true, at: ts, idx: idx };
+      if (m.role === 'user') bubble('user', m.content || m.text || '', Object.assign(skip, { attachments: m.attachments || [] }));
+      else {
+        // 拆分渲染：工具链各自独立展示
+        var fn2 = (typeof bubbleAgentWithSplitToolTrace === 'function')
+          ? bubbleAgentWithSplitToolTrace : bubble;
+        if (fn2 !== bubble) {
+          fn2(m.content || '', m.tool_trace || [], skip);
+        } else {
+          bubble('agent', m.content || '', Object.assign({ toolTrace: m.tool_trace || [] }, skip));
+        }
+      }
+    });
+    // 滚动到底部：双重 rAF 确保 DOM 渲染完成后滚动，再加 setTimeout 兜底（图片等异步渲染可能延迟布局）
+    (function scrollLogAfterRender() {
+      requestAnimationFrame(() => {
+        requestAnimationFrame(() => {
+          scrollLogForce();
+          setTimeout(scrollLogForce, 80);
+        });
+      });
+    })();
+    // 历史加载完成后用持久化的 context_usage 校正指示器
+    try {
+      const cu = j && j.context_usage;
+      if (cu && typeof updateTokenUsage === 'function') {
+        var histPt = (typeof pickContextUsageTokens === 'function')
+          ? pickContextUsageTokens(cu) : (Number(cu.prompt_tokens) || 0);
+        if (histPt > 0) {
+          updateTokenUsage({ prompt_tokens: histPt, peak_prompt_tokens: cu.peak_prompt_tokens });
+        }
+      } else if (typeof recalcTokenUsageFromDom === 'function') {
+        setTimeout(recalcTokenUsageFromDom, 100);
+      }
+    } catch (_) {}
+    // 加载侧边栏费用汇总
+    if (j.accumulated_usage && typeof updateSidebarCost === 'function') {
+      updateSidebarCost(j.accumulated_usage);
+    }
+    await refreshSessionList();
+    if (!skipTreeRefresh && typeof refreshSessionsUnderProject === 'function') {
+      refreshSessionsUnderProject(projectId);
+    }
+    const row = lastSessionsCache.find((r) => r.session_id === sessionId);
+    markSessionReadByCount(sessionId, row ? (row.message_count || 0) : 0);
+  } catch (e) {
+    historyFirstBlockIndex = null;
+    historyHasMoreOlder = false;
+    systemMsg('err', '载入会话记录失败：' + String(e));
+  }
+}
+
+// ---------------- Session list fetch / sync ----------------
+
+async function refreshSessionList() {
+  const listEl = document.getElementById('sessList');
+  try {
+    const r = await fetch('/api/ui/sessions?limit=80&agent_id=' + encodeURIComponent(agentId) + projectQuerySuffix());

codeagent/web/static/05b-session-list.js

@@ -0,0 +1,114 @@
+    if (!r.ok) throw new Error((await r.json()).detail || r.statusText);
+    const j = await r.json();
+    const cur = sessionId;
+    lastSessionsCache = j.sessions || [];
+    ensureReadBaseline(lastSessionsCache);
+    if (listEl) {
+      listEl.innerHTML = '';
+      const pin = pinSessionToTopOnce;
+      let rows = orderSessionsWithPinFirst(lastSessionsCache, pin);
+      if (!rows.some((x) => x.session_id === cur)) {
+        rows = [{ session_id: cur, message_count: 0, display_title: '新对话', channel: 'Web 聊天', preview: '' }].concat(rows);
+      }
+      rows.forEach((row) => listEl.appendChild(buildSessListItem(row)));
+      highlightSessList(cur);
+    }
+    pinSessionToTopOnce = '';
+    updateMainHeaderForSession(cur);
+    // DOM 重建后重新应用每个会话的运行/已完成状态（避免 restoreRunningSessions 时序竞争）
+    requestAnimationFrame(function() {
+      (lastSessionsCache || []).forEach(function(r) {
+        if (typeof applySessionRunningState === 'function') applySessionRunningState(r.session_id);
+        if (typeof applySessionCompletedState === 'function') applySessionCompletedState(r.session_id);
+      });
+    });
+  } catch (e) {
+  }
+}
+
+
+// ---------------- Session list event binding ----------------
+
+function bindSessListOnce() {
+  const listEl = document.getElementById('sessList');
+  if (!listEl || listEl.dataset.bound === '1') return;
+  listEl.dataset.bound = '1';
+  listEl.addEventListener('click', async (ev) => {
+    const actBtn = ev.target.closest('[data-sess-act]');
+    if (actBtn) {
+      ev.preventDefault(); ev.stopPropagation();
+      const rowEl = actBtn.closest('.sess-row');
+      const sid = rowEl && rowEl.getAttribute('data-session-id');
+      const act = actBtn.getAttribute('data-sess-act');
+      if (!sid || !act) return;
+      const titleHint = (rowEl.querySelector('.sess-item__title') && rowEl.querySelector('.sess-item__title').textContent) || sid;
+      try {
+        if (act === 'archive') {
+          if (!confirm('确定归档「' + titleHint + '」？文件将移到 sessions/archived/。')) return;
+          const r = await fetch('/api/ui/session/archive', {
+            method: 'POST', headers: { 'Content-Type': 'application/json' }, credentials: 'same-origin',
+            body: JSON.stringify({ session_id: sid, agent_id: agentId })
+          });
+          const j = await r.json().catch(() => ({}));
+          if (!r.ok) throw new Error(j.detail || r.statusText);
+        } else if (act === 'delete') {
+          if (!confirm('确定删除「' + titleHint + '」？此操作不可恢复。')) return;
+          const r = await fetch('/api/ui/session/delete', {
+            method: 'POST', headers: { 'Content-Type': 'application/json' }, credentials: 'same-origin',
+            body: JSON.stringify({ session_id: sid, agent_id: agentId })
+          });
+          const j = await r.json().catch(() => ({}));
+          if (!r.ok) throw new Error(j.detail || r.statusText);
+        } else if (act === 'copy-id') {
+          try { await navigator.clipboard.writeText(sid); systemMsg('info', '已复制会话 ID：' + sid); }
+          catch (_) {
+            const ta = document.createElement('textarea');
+            ta.value = sid; ta.style.position = 'fixed'; ta.style.opacity = '0';
+            document.body.appendChild(ta); ta.select(); document.execCommand('copy');
+            document.body.removeChild(ta); systemMsg('info', '已复制会话 ID：' + sid);
+          }
+          return;
+        }
+      } catch (e) { alert(String(e)); return; }
+      removeSessionReadBaseline(sid);
+      // 存档/删除旧会话时：保存当前草稿，新建会话后清空输入
+      if (sessionId === sid) {
+        if (typeof saveMsgDraft === 'function') saveMsgDraft();
+        sessionId = oaRandomUUID();
+        localStorage.setItem(_sidStorageKey(agentId, projectId), sessionId);
+        updateComposerButtons(); log.innerHTML = ''; resetAgentReplyDedupe(); reconnectWsForSession();
+        if (typeof msg !== 'undefined' && msg) msg.value = '';
+      }
+      await refreshSessionList();
+      highlightSessList(sessionId);
+      updateMainHeaderForSession(sessionId);
+      await loadSessionHistoryIntoLog(true);
+      if (typeof activatePage === 'function') activatePage('chat');
+      return;
+    }
+    const btn = ev.target.closest('.sess-item-main');
+    if (!btn) return;
+    const sid = btn.getAttribute('data-session-id');
+    if (!sid) return;
+    // 切换会话：保存当前草稿，恢复目标会话草稿
+    if (typeof saveMsgDraft === 'function') saveMsgDraft();
+    sessionId = sid;
+    localStorage.setItem(_sidStorageKey(agentId, projectId), sessionId);
+    updateComposerButtons();
+    if (typeof restoreMsgDraft === 'function') restoreMsgDraft(sid);
+    const row = lastSessionsCache.find((r) => r.session_id === sid);
+    markSessionReadByCount(sid, row ? (row.message_count || 0) : 0);
+    reconnectWsForSession(); resetAgentReplyDedupe();
+    highlightSessList(sid); updateMainHeaderForSession(sid);
+    refreshSessionList().catch(() => {});
+    if (typeof activatePage === 'function') activatePage('chat');
+  });
+}
+
+// ---------------- Web UI sessions initialization ----------------
+
+async function initWebUiSessions() {
+  // 页面刷新后先恢复正在运行中的会话状态（心跳指示）
+  await restoreRunningSessions();
+  const sidebar = document.getElementById('chatSidebar');
+  const fs = document.getElementById('fieldsetChatSessions');