Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import type { TFunction } from 'i18next';
import { formatSessionDuration } from '@/lib/sessionDurationFormat';
import { useEffect, useState } from 'react';
import { useTranslation } from 'react-i18next';
import type { BackgroundTaskOutputTailResult } from '../../../shared/backgroundTaskOutput';
import { readBackgroundTaskOutputTailFor } from '@/lib/makerTransport';
/** 运行中每秒刷新一次运行时长。 */
const ELAPSED_TICK_MS = 1000;
/** 展开区在任务运行中轮询输出文件的间隔。 */
const OUTPUT_TAIL_POLL_MS = 2000;
/** 展开区最多显示的输出行数。 */
export const OUTPUT_TAIL_MAX_LINES = 12;
/** 运行时长折算小时、天后保留分钟,低位补零以保持计时宽度稳定。 */
export function formatTaskElapsed(ms: number, t?: TFunction): string {
return formatSessionDuration(Math.floor(ms / 1000) * 1000, t, {
minimumSeconds: 0,
alwaysShowRemainder: true,
padRemainder: true,
});
}
export function parseTaskTimestamp(value: string | undefined): number | undefined {
if (!value) return undefined;
const ms = Date.parse(value);
return Number.isFinite(ms) ? ms : undefined;
}
/** enabled 时每 intervalMs 返回一次新的 Date.now();关闭时停在最后一次的值。 */
export function useNowTicker(enabled: boolean, intervalMs = ELAPSED_TICK_MS): number {
const [now, setNow] = useState(() => Date.now());
useEffect(() => {
if (!enabled) return;
setNow(Date.now());
const id = setInterval(() => setNow(Date.now()), intervalMs);
return () => clearInterval(id);
}, [enabled, intervalMs]);
return now;
}
/**
* 运行中任务的实时运行时长。单独成组件,每秒 tick 只重渲染这一小段文字,
* 不带动整张任务卡。
*/
export function RunningElapsed({ startedAtMs }: { startedAtMs: number }) {
const { t } = useTranslation();
const now = useNowTicker(true);
return (
<span data-agent-task-elapsed="running" className="tabular-nums">
{t('chat.agentTask.runningFor', { duration: formatTaskElapsed(now - startedAtMs, t) })}
</span>
);
}
/**
* 去掉终端控制序列并按回车折叠进度条式覆盖输出,取最后若干行。
* `\r` 覆盖写(进度条)只保留最后一次写入的内容。
*/
export function tailOutputLines(text: string, maxLines = OUTPUT_TAIL_MAX_LINES): string[] {
// eslint-disable-next-line no-control-regex
const withoutAnsi = text.replace(
/\u001b\[[0-?]*[ -/]*[@-~]|\u001b\][^\u0007]*(?:\u0007|\u001b\\)/g,
'',
);
const lines = withoutAnsi.split('\n').map((line) => {
const segments = line.split('\r').filter((segment) => segment.length > 0);
return segments.length > 0 ? segments[segments.length - 1] : '';
});
while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
return lines.slice(-maxLines);
}
export interface BackgroundTaskOutputTailSnapshot {
result: BackgroundTaskOutputTailResult;
/** 本机收到该结果的时间;与结果里读取端算出的 ageMs 相加得到当前距最后写入的时长。 */
receivedAtMs: number;
}
/**
* 轮询运行中后台命令的输出尾部:enabled 时立即读一次并按固定间隔刷新,关闭(收起 /
* 任务终态 / 卸载)即停止,不在后台空转。输出路径由主进程按 (会话, 任务) 解析。
*/
export function useBackgroundTaskOutputTail(
sessionId: string | undefined,
taskId: string | undefined,
enabled: boolean,
): BackgroundTaskOutputTailSnapshot | undefined {
const [snapshot, setSnapshot] = useState<BackgroundTaskOutputTailSnapshot | undefined>(undefined);
useEffect(() => {
if (!enabled || !sessionId || !taskId) return;
let disposed = false;
let inFlight = false;
const read = () => {
if (inFlight) return;
inFlight = true;
void readBackgroundTaskOutputTailFor(sessionId, taskId)
.then((next) => {
if (!disposed) setSnapshot({ result: next, receivedAtMs: Date.now() });
})
.finally(() => {
inFlight = false;
});
};
read();
const id = setInterval(read, OUTPUT_TAIL_POLL_MS);
return () => {
disposed = true;
clearInterval(id);
};
}, [enabled, sessionId, taskId]);
return snapshot;
}
interface BackgroundCommandDetailsProps {
sessionId?: string;
command?: string;
startedAtMs?: number;
taskId?: string;
running: boolean;
/** 展开区可见时才读取输出,收起即停止轮询。 */
expanded: boolean;
}
/**
* 后台命令卡展开区:实际命令、开始时间与输出文件末尾。运行中持续刷新最近输出和
* 「更新于 N 前」,让用户判断命令是否仍在推进,而不是只看一个转圈图标。任务结束后
* 不再显示最近输出(结果由卡片摘要呈现)。
*/
export function BackgroundCommandDetails({
sessionId,
command,
startedAtMs,
taskId,
running,
expanded,
}: BackgroundCommandDetailsProps) {
const { t } = useTranslation();
const live = expanded && running;
const snapshot = useBackgroundTaskOutputTail(sessionId, taskId, live);
const tail = snapshot?.result;
const now = useNowTicker(live);
const lines = tail?.ok ? tailOutputLines(tail.text) : [];
const startedAtLabel =
startedAtMs !== undefined
? new Date(startedAtMs).toLocaleTimeString(undefined, {
hour: '2-digit',
minute: '2-digit',
second: '2-digit',
})
: undefined;
return (
<div data-background-command-details="true" className="mb-1 flex flex-col gap-1.5">
{command && (
<pre className="max-h-24 overflow-auto whitespace-pre-wrap break-all rounded-lg bg-[var(--surface-chip)] px-2 py-1 font-mono text-12 leading-4 text-[var(--text-primary)]">
{command}
</pre>
)}
{startedAtLabel && (
<p className="text-12 leading-4 text-[var(--text-tertiary)]">
{t('chat.agentTask.startedAt', { time: startedAtLabel })}
</p>
)}
{running && snapshot && tail?.ok && (
<div data-background-command-output="true">
<p className="mb-0.5 text-12 leading-4 text-[var(--text-tertiary)]">
{lines.length === 0
? t('chat.agentTask.noOutputYet')
: t('chat.agentTask.recentOutput', {
// 读取端算的 ageMs + 本机收到之后经过的时间:两段各自同一时钟,不跨设备相减。
time: formatTaskElapsed(tail.ageMs + Math.max(0, now - snapshot.receivedAtMs), t),
})}
</p>
{lines.length > 0 && (
<pre className="max-h-60 overflow-auto whitespace-pre-wrap break-all rounded-lg bg-[var(--surface-chip)] px-2 py-1 font-mono text-12 leading-4 text-[var(--text-secondary)]">
{lines.join('\n')}
</pre>
)}
</div>
)}
</div>
);
}