Files
UHD_Media_Tool/apps/web/app/lib/labels.ts
T
rootandClaude Opus 5.5 4480fc346d refactor(copy): 术语统一——收录版本、模型服务、智能体等(DEAI-2)
- 版本目标 → 收录版本(前后端用户可见字符串、能力描述、给模型的提示)
- Agent 上游 / 上游 → 模型服务;界面上的 Agent / Agent 会话 → 智能体 / 智能体会话
- 身份歧义 / 识别有歧义 / 无法确定作品 → 没识别出作品;待识别(池) → 未识别
- 建档 → 加入媒体库;资产 → 文件;库根 → 媒体库目录;纳管 → 本工具 / 外部任务;
  哨兵 → 标记文件 / 检查目录;站点快照 → 抓取;Feed / RSS 订阅 / 来源健康 → RSS
- 代码标识符、API 字段名、迁移文件不改;glossary.md 同步;smoke 选择器跟随

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-29 20:35:43 +08:00

159 lines
6.8 KiB
TypeScript

import type { StatusTone } from "~/components/console/status-badge.tsx";
// 状态值 → 中文文案 + 语气。状态徽章必须带文字,这里集中维护常用的几组。
export type Labeled = { label: string; tone: StatusTone };
const pick = (map: Record<string, Labeled>, v: string | null | undefined): Labeled =>
(v && map[v]) || { label: v || "未知", tone: "neutral" };
const HEALTH: Record<string, Labeled> = {
healthy: { label: "正常", tone: "success" },
ok: { label: "正常", tone: "success" },
degraded: { label: "降级", tone: "warning" },
failing: { label: "连续失败", tone: "destructive" },
offline: { label: "离线", tone: "destructive" },
circuit_open: { label: "已熔断", tone: "destructive" },
disabled: { label: "已停用", tone: "neutral" },
unknown: { label: "未检测", tone: "neutral" },
unverified: { label: "未校验", tone: "neutral" },
failed: { label: "失败", tone: "destructive" },
};
export const healthLabel = (v: string | null | undefined) => pick(HEALTH, v);
const DOWNLOAD: Record<string, Labeled> = {
queued: { label: "排队", tone: "neutral" },
submitting: { label: "提交中", tone: "neutral" },
downloading: { label: "下载中", tone: "neutral" },
paused: { label: "已暂停", tone: "warning" },
stalled: { label: "无进展", tone: "warning" },
completed: { label: "下载完成", tone: "success" },
importing: { label: "入库中", tone: "neutral" },
imported: { label: "已入库", tone: "success" },
failed: { label: "失败", tone: "destructive" },
removed: { label: "已移除", tone: "neutral" },
missing: { label: "丢失", tone: "destructive" },
};
export const downloadLabel = (v: string | null | undefined) => pick(DOWNLOAD, v);
const DECISION_KIND: Record<string, string> = {
identity_ambiguous: "没识别出作品",
identity_unresolved: "未识别",
download_stalled: "下载无进展",
download_failed: "下载失败",
path_conflict: "路径冲突",
space_insufficient: "空间不足",
approval_required: "待审批",
metadata_conflict: "元数据冲突",
source_unreachable: "来源不可达",
other: "其它",
};
export const decisionKindLabel = (v: string) => DECISION_KIND[v] ?? v;
const ORG: Record<string, Labeled> = {
queued: { label: "排队", tone: "neutral" },
running: { label: "进行中", tone: "neutral" },
succeeded: { label: "成功", tone: "success" },
partial: { label: "部分成功", tone: "warning" },
failed: { label: "失败", tone: "destructive" },
cancelled: { label: "已取消", tone: "neutral" },
};
export const organizationLabel = (v: string | null | undefined) => pick(ORG, v);
const ORG_ACTION: Record<string, string> = {
copy: "复制",
move: "移动",
rename: "重命名",
relocate: "目录调整",
hardlink: "硬链接",
trash: "移入回收站",
delete: "永久删除",
restore: "还原",
};
export const organizationActionLabel = (v: string) => ORG_ACTION[v] ?? v;
const AGENT_RUN: Record<string, Labeled> = {
queued: { label: "排队中", tone: "neutral" },
running: { label: "运行中", tone: "neutral" },
waiting: { label: "等待中", tone: "warning" },
succeeded: { label: "已完成", tone: "success" },
failed: { label: "失败", tone: "destructive" },
cancelled: { label: "已停止", tone: "neutral" },
budget_exceeded: { label: "超出预算", tone: "warning" },
};
export const agentRunLabel = (v: string | null | undefined) => pick(AGENT_RUN, v);
const ENGINE_RUN: Record<string, Labeled> = {
pending: { label: "待执行", tone: "neutral" },
running: { label: "运行中", tone: "neutral" },
sleeping: { label: "休眠(旧)", tone: "neutral" },
succeeded: { label: "完成(旧)", tone: "success" },
completed: { label: "完成", tone: "success" },
failed: { label: "失败", tone: "destructive" },
canceled: { label: "已取消", tone: "warning" },
};
export const engineRunLabel = (v: string | null | undefined) => pick(ENGINE_RUN, v);
/** 相对时长:秒 → "3 分钟" */
export function formatDuration(sec: number | null | undefined): string {
if (sec === null || sec === undefined || Number.isNaN(sec)) return "—";
if (sec < 1) return `${Math.round(sec * 1000)} 毫秒`;
if (sec < 60) return `${Math.round(sec)} 秒`;
if (sec < 3600) return `${Math.floor(sec / 60)} 分 ${Math.round(sec % 60)} 秒`;
if (sec < 86400) return `${Math.floor(sec / 3600)} 小时 ${Math.floor((sec % 3600) / 60)} 分`;
return `${Math.floor(sec / 86400)} 天 ${Math.floor((sec % 86400) / 3600)} 小时`;
}
/** 相对现在:"3 分钟前" */
export function formatRelative(iso: string | null | undefined): string {
if (!iso) return "—";
const t = new Date(iso).getTime();
if (Number.isNaN(t)) return iso;
const diff = (Date.now() - t) / 1000;
const abs = Math.abs(diff);
const suffix = diff >= 0 ? "前" : "后";
if (abs < 45) return diff >= 0 ? "刚刚" : "马上";
if (abs < 3600) return `${Math.round(abs / 60)} 分钟${suffix}`;
if (abs < 86400) return `${Math.round(abs / 3600)} 小时${suffix}`;
return `${Math.round(abs / 86400)} 天${suffix}`;
}
/** startedAt → finishedAt(未结束取现在)的秒数;未开始为 null */
export function spanSec(r: { startedAt: string | null; finishedAt: string | null }): number | null {
if (!r.startedAt) return null;
const end = r.finishedAt ? new Date(r.finishedAt).getTime() : Date.now();
return (end - new Date(r.startedAt).getTime()) / 1000;
}
/** 服务端记录的操作者串(`admin_session:<id>` / `api_key:<id>` / `policy:<key>` / `system`)→ 界面文字,不露内部 ID */
export function actorText(v: string | null | undefined): string {
if (!v) return "—";
const i = v.indexOf(":");
const kind = i < 0 ? v : v.slice(0, i);
const rest = i < 0 ? "" : v.slice(i + 1);
if (kind === "admin_session" || kind === "dev_admin" || kind === "user") return "管理员";
if (kind === "agent" || kind === "agent_run") return "智能体";
if (kind === "schedule" || kind === "scheduler") return "定时任务";
if (kind === "api_key") return "API Key";
if (kind === "policy") return `收录策略 ${rest}`;
if (v === "system") return "系统";
return v;
}
export const ACTOR_TYPES = [
{ value: "user", label: "管理员" },
{ value: "api_key", label: "API Key" },
{ value: "agent", label: "智能体" },
{ value: "system", label: "系统" },
];
export const actorTypeLabel = (t: string) => ACTOR_TYPES.find((a) => a.value === t)?.label ?? t;
/** 下载计划 statusReason(`added`、`organize:succeeded` 等)→ 中文;不认识的原样显示 */
const PLAN_REASON: Record<string, string> = {
added: "已添加到下载器",
"organize:succeeded": "整理成功",
"organize:partial": "部分整理成功",
"organize:failed": "整理失败",
};
export const planReasonText = (v: string | null | undefined) => (v ? (PLAN_REASON[v] ?? v) : null);